Vertical do produto Maia · educação pública municipal

O que existe, o que ela já faz, e o que vem.

Uma frente da Maia feita só para educação pública municipal. O cliente é a secretaria: quem assina é o secretário, quem usa são professores e diretores. Duas frentes num produto só, dois canais.

1

São três bases de código, todas verdes hoje: 375 + 223 + 26 = 624 testes passando (medido nesta máquina, 10/08).

2

A Maia Docente (WhatsApp do professor) gera plano de aula, prova e relatório de Ed. Infantil, com validação da BNCC código a código.

3

A Maia Gestora (Telegram do secretário/diretor) já responde as três perguntas de dinheiro e prioridade, mas só sobre rede sintética de demonstração.

4

O ciclo do WhatsApp real fechou uma vez (mensagem entrou, resposta saiu) e está desligado desde 07/08, à espera de número novo de teste.

5

Nenhuma professora real usou o produto ainda. Essa é a distância que separa a Maia de "funcional", e não é código faltando.

6

O que entra de novo: Painel do Gestor, ciclo de avaliação diagnóstica e integrações de leitura (Educacenso e frequência).

O sistema de status

Três marcadores, uma regra de honestidade

O projeto separa três coisas que é fácil confundir, e a confusão entre elas é o que faz um produto parecer pronto e falhar na frente do cliente. Todo item deste painel carrega um destes selos.

PROVADO

Rodou de verdade, com comando e saída real registrados.

EXISTE, NÃO PROVADO EM CAMPO

O código está lá e os testes passam, mas nenhum usuário real usou.

NÃO EXISTE (plano)

É plano, não é código.

Parte I · O que já existe

As três bases de código, todas verdes

Comando exato: python -m pytest -q em cada pasta, sem nenhuma variável de ambiente, no Windows. Os 2 skipped são os testes que chamam o claude de verdade e queimam cota.

375
docente-gateway/: a Maia Docente (FastAPI + WhatsApp)
Provado
223
gestora/: motor determinístico do secretário
Provado
26
bncc-data/: base BNCC homologada + validador
Provado
624total
testes passando · 2 skipped (assinatura real)
O alicerce anti-alucinação

A base BNCC provada contra material humano real

1.397 códigos oficiais

1.304 do Ensino Fundamental + 93 da Educação Infantil. Cobertura de 14 de 14: os 9 componentes do Fundamental e os 5 campos de experiência da Infantil.

  • Código e descrição conferidos integralmente contra o PDF homologado do MEC.
  • O metadado de agrupamento é rebaixado a "auxiliar" de propósito: está medido em 99,23%, e afirmar mais do que se prova é o que o projeto proíbe.

Teste contra 12 planos reais

Rodado contra 12 planos de ensino de uma rede municipal, com 90 códigos citados por professores.

90/90válidos
zero falso positivo. A única parte deste produto testada contra material humano de verdade.
Maia Docente · WhatsApp do professor

O que ela já é capaz de fazer Existe, não provado em campo

As três skills pedagógicas

1
Plano de aulaPlano completo pronto pra protocolar: identificação, objetivos, habilidades BNCC, metodologia passo a passo com tempo, avaliação, referências.
2
Prova / avaliaçãoProva + gabarito comentado + matriz de referência questão × habilidade BNCC.
3
Relatório de Ed. InfantilRelatório descritivo, com a trava legal: proibido nota ou conceito (LDB art. 31, I; DCNEI).

Tudo sai em DOCX com cabeçalho e rodapé da secretaria, entregue como documento no WhatsApp.

As proteções: onde mora o diferencial

  • Recusa código inexistente. Código inventado dispara regeneração; código real de fora da base sai com aviso honesto, nunca trocado.
  • Recusa do modelo não vira material. Quando ele não pode produzir, marca nao-produzido: sem DOCX, sem consumir quota, com explicação ao professor.
  • Ensino Médio é recusado explicitamente, a base não cobre, inclui a armadilha do "1ª série" em anos finais.
  • Faixa etária da Ed. Infantil pela correspondência mais longa, "crianças bem pequenas" não vira mais pré-escola.
  • Nenhum campo identifica criança. Filtro de PII no que é gravado; nome do arquivo sem identificação.
  • Indicador de integridade apurável: a consulta SQL é entregue à auditoria do Município para chegar ao mesmo número.

A infraestrutura

  • Fila com pool de workers · quota mensal por professor · allowlist de piloto.
  • Freio de laço entre bots (30 msgs / 10 min).
  • Webhook que recusa tudo por padrão sem token/HMAC.
  • Motor por assinatura (claude -p, sem chave de API) que falha alto e nunca cai em resposta simulada.
  • Tolerância ao nono dígito do telefone brasileiro.
Novo em 10/08

Fim do "bot de URA": modo conversa. O professor escreve como gente ("me monta um plano de matemática sobre frações pro 6º ano, 1 aula, só tenho quadro") e a Maia entende tudo numa mensagem, sem menu numerado. E a sessão sobrevive à recusa: a resposta do professor retoma a geração em vez de cair no menu.

O marco PROVADO em produção (07/08)

1 ciclo real de WhatsApp
  • Mensagem real de WhatsApp entrou (POST /webhook/evolution 200) e a Maia respondeu (sendText 201), sem exposição pública e sem túnel.
  • Geração real com LLM: 19s, 6.236 tokens in / 1.590 out, 2 códigos BNCC, 2 válidos, desfecho limpo, DOCX correto sem pipe cru.
O que NÃO foi provado: o DOCX nunca foi entregue como documento no WhatsApp por esse caminho (o gate de envio nunca chegou a ser ligado). E, dito com todas as letras: nenhuma professora real usou ainda.
Maia Gestora · Telegram do secretário

As três perguntas do secretário Existe, não provado em campo

Motor determinístico (sem rede, sem modelo, o número não é gerado por IA). 12 comandos de CLI, 7 skills conversacionais. O modelo só narra; o motor calcula.

1. "Quanto estou perdendo de repasse?"

A ponte com VAAR/FUNDEB (Lei 14.113/2020, art. 14) e ICMS Educacional. Fato de fonte primária separado de estimativa, sempre rotulado.

2. "Quem está puxando pra baixo?"

Ranking do pior ao melhor, com nome de escola e turma, por componente.

3. "O que eu faço na segunda-feira?"

Plano de ação priorizado: turmas de maior impacto, o que fazer, quem responde, prazo, e as habilidades BNCC prioritárias já conferidas.

O que a torna diferente de uma planilha

  • Autoconfiguração por código IBGE (não pelo nome, há homônimos): busca IDEB, população, escolas e FUNDEB em fonte pública. Hoje 2 municípios: Barreirinhas/MA e São Miguel do Tapuio/PI.
  • Rede de demonstração 100% sintética, zero dado real de criança, sem exceção.
  • Trava de narrativa (guardas.py): a frase "elevamos o IDEB" não sai daqui.

O limite honesto, vale pra Gestora e pro produto inteiro

Ela nunca recebeu dado real de rede. É motor provado sobre dado sintético. E nenhuma professora real usou a Maia Docente ainda. Quem escrever "piloto em andamento" ou "validado em campo" em qualquer peça está inventando: não existe um único número de campo deste produto.

Parte II · O que vai entrar Não existe (plano)

A camada de inteligência sobre o registro que o município já tem

A decisão-mestra que ordena tudo: a Maia é a camada de inteligência pedagógica. Ela não é, e não vai ser, o sistema de registro. O MEC entrega gestão escolar de graça; nos buracos que valem dinheiro o placar dos 16 concorrentes é 0/16.

Painel do Gestor, o dashboard que não existe

Não existe

5 telas HTML estáticas, geradas do banco da própria instância, sem servidor novo, sem login no MVP, enviadas pelo mesmo caminho já provado do DOCX. Um comando: cli painel --municipio <ibge>.

Panorama da rede"Como está a rede, por escola/ano/componente?"
Repasse em risco"Quanto dinheiro está em jogo?"
Ranking de prioridade"Que turmas atacar primeiro?"
Controle de recebimento"Quem ainda não devolveu as provas?"
Evolução entre ondas"Melhorou da 1ª pra 2ª aplicação?"

Regras duras: zero dado de criança (o menor grão é a TURMA, não existe tela de aluno) · desempenho por HABILIDADE, não só nota · nenhuma tela promete IDEB · selo em toda página: "N códigos BNCC citados, N verificados".

Ciclo de avaliação diagnóstica, em 3 fases

É o que tira a Gestora da demonstração e a coloca em operação.

ABanco de questões e prova de redezero dado de criança

Banco de itens por habilidade BNCC + descritor SAEB, validado código a código (0/16 concorrentes têm). Skill de avaliação diagnóstica de rede com gabarito comentado e matriz questão×habilidade. Folha de resposta padronizada com marcas fiduciais.

As 220 questões do acervo só entram com autorização ou parceria, é IP de terceiro. Sem acordo, a Maia gera itens novos.
BResultado agregado entra pela conversaainda zero criança

A coordenadora digita no WhatsApp o agregado por turma; quem tabula é a escola, o que trafega é turma. Isso alimenta o banco da Gestora, o painel ganha dado real e o controle de recebimento passa a funcionar de verdade.

CCorreção por foto ("Gabarito IA") congelada

A especificação é nossa, e o WhatsApp substituiria o Streamlit. Mas exige a produção do aluno, o que o MVP deixou deliberadamente de fora. Se entrar: código anônimo no payload, nunca nome ou CPF, prefeitura como controladora, DPA assinado.

Depende de decisão do dono.

Integrações de leitura, e a resposta sobre frequência

GERIR frequência

Fora, em definitivo. Chamada, diário eletrônico: é o núcleo do GPE gratuito do MEC e de 15/16 concorrentes. O Pé-de-Meia já é pago em cima do GPE, essa guerra está perdida antes de começar.

LER frequência

Dentro, como inteligência. O .txt do Sistema Presença vira alerta de evasão com nome de escola e turma. Frequência baixa derruba a condicionalidade de participação (≥80%) do VAAR, ou seja, vira dinheiro na mesa do secretário.

Validador do Educacenso

Valida o arquivo antes do envio (0/16 fazem; o Inep não tem API, então não promete integração inexistente). Protege a cadeia Censo → condicionalidades → VAAR.

Exportação em formato aberto

A cláusula de saída que ataca a ferida nº 1 do mercado ("seguraram meus dados quando quis sair"). Custo zero, e nenhum concorrente copia sem se acusar.

Skills pedagógicas novas (fila contínua): atividade por hipótese de escrita, kit de jogos impressos (funciona sem tablet e sem internet, serve na zona rural), plano de recomposição, sequência didática, PEI / atividade adaptada, parecer descritivo com histórico e banco de frases.

Progresso por frente

Onde cada frente está, sem inflar

A barra mede construção de código, não validação em campo. O produto inteiro trava no item 0 da fila: ninguém real usou ainda.

Base BNCC + validador100%
Provado contra material humano real (90/90). O único trecho do produto validado com dado de verdade.
Maia Docente (código)95%
375 testes verdes, modo conversa novo (10/08). Falta: DOCX chegando no WhatsApp e uso real de professora.
Maia Gestora (código)90%
223 testes verdes sobre rede sintética. Falta: dado real de rede entrando (vem pelo ciclo de avaliação).
Painel do Gestor0%
Plano fechado (5 telas), ~3-5 dias. Ainda não é código.
Ciclo de avaliação diagnóstica0%
Fases A/B por construir; Fase C congelada por decisão do dono.
Integrações de leitura0%
Validador do Educacenso · Sistema Presença → evasão · exportação aberta.
Parte III · A fila

A ordem de execução, item 0 vem antes de tudo

O item 0 não é formalidade. O sistema do terceiro é mais robusto hoje por um motivo só: uso diário real. Painel bonito com Maia não validada não vende.

0
Validar em campo o que já existeReligar com número novo, medir o modo conversa real, provar o DOCX chegando no WhatsApp.
1 sessão
1
Painel do Gestor MVP5 telas HTML estáticas geradas do SQLite.
~3-5 dias
2
Skill de avaliação diagnóstica de redeProva + gabarito + matriz questão×habilidade, itens novos.
~2-3 dias
3
Entrada agregada por turma + recebimento vivoAgregado digitado numa conversa aparece no painel.
~2-3 dias
4
Validador do EducacensoValida o .txt e lista erros por linha/campo antes do envio.
~2 dias
5
Alerta de evasão (Sistema Presença).txt bimestral entra, alerta nominal por escola/turma sai.
~1-2 dias
6
Skills pedagógicas de alfabetizaçãoHipótese de escrita, jogos impressos, recomposição.
contínuo
7
Dossiê LGPD infantil + cláusula de saídaPeça de venda no comercial/.
~1 dia
Só o dono destrava

4 decisões que estão na sua mesa, Salatiel

Estas quatro não são técnicas: dependem de você. Cada uma trava uma parte do roadmap ou do comercial.

1

As 220 questões do acervo

Parceria com a consultoria (eles têm acesso e material, nós temos a IA) ou geramos tudo novo? É IP de terceiro.

Decide o custo da Fase A.
2

Fase C (correção por foto) entra no roadmap?

Exige a produção do aluno. Se entrar, muda o desenho de LGPD do produto inteiro.

Hoje está congelada, aguardando seu go.
3

O preço

O R$ 90.200 da proposta continua fora da faixa medida no Piauí (R$ 17k–62k/ano por sistema completo) e continua sem revisão.

Revisar preço x faixa de mercado.
4

Número de teste novo

Para religar o piloto. Não o da esposa, não a linha da instância, número novo, conferindo a whitelist do SDR antes.

Destrava o item 0 da fila.