# Roteiro de Implantacao - Sistema Escolar (base i-Educar)

Data de atualizacao: 2026-01-29

Objetivo: servir como guia unico de implantacao e desenvolvimento. Qualquer equipe/IA deve conseguir ler este arquivo e saber o que ja foi feito e o que falta.

## Referencia (i-Educar)
Funcionalidades alvo (espelho do i-Educar):
- Cadastro unico e estrutura da rede.
- Gestao academica (matriculas, calendario, avaliacoes, boletins).
- Gestao de servidores/RH (alocacoes, afastamentos, substituicoes, faltas).
- Quadro de horarios.
- Transporte escolar.
- Biblioteca.
- Educacenso/INEP.
- Relatorios e indicadores.
- Permissoes por niveis (secretaria x escola).
- Pre-matricula digital.

## Status atual do sistema
Ultima fase concluida: Item 7 - Acesso por escola e vinculo de usuarios.
Item 8 concluido: RH e quadro de horarios (CRUDs, validacoes, auditoria basica e relatorios).
Paridade (i-Educar): referencia atual 61,6% (alvo 90%+).

Funcionalidades ja implementadas (principais):
- Cadastro de escolas, alunos, turmas, professores, disciplinas, etapas.
- Matriculas (com validacao de turma x escola).
- Diario de classe: frequencia, conteudo e avaliacoes.
- Boletins (tela + PDF simples).
- Calendario letivo + eventos (importacao de feriados nacionais).
- Transporte escolar (rotas, paradas, vinculo alunos x paradas).
- Merenda (estoque, movimentos, alertas, relatorios).
- Biblioteca (acervo e emprestimos).
- Comunicados.
- Relatorios (alunos, turmas, matriculas, frequencia, alertas, avaliacoes, transporte, estoque, RH e horarios).
- Fechamento mensal (cadastro, checklist, exportacao CSV).
- Suporte (chamados).
- Usuarios e permissoes (roles admin/secretaria/escola + permissao por modulo).
- Escopo por escola para perfil Escola (filtro automatico por school_id).
- Padroes de formulario: datepicker global e CEP autofill.
- Portal do aluno/responsavel (login, painel e paginas base: boletins, frequencia, avisos, historico).
- Documentacao de implantacoes em `escolar/versao/`.

Pendencias estruturais (ainda nao implementado):
- Gestao de servidores/RH (substituicoes e integracoes).
- Quadro de horarios (otimizacao automatica).
- Educacenso/INEP (exportacao/importacao oficial).
- Pre-matricula digital (fila de vagas e transparencias).
- Portal do aluno/responsavel (melhorias de fluxo e dados reais).
- Auditoria e logs (trilha de alteracoes).
- Integracoes externas (SMS/WhatsApp/Email) quando houver provedor.

## Roteiro de implantacao (fases)

### 1) Diagnostico e escopo (concluido)
- Mapear rede: escolas, alunos, servidores, processos atuais.
- Definir prioridades municipais e requisitos legais.

### 2) Infraestrutura e seguranca (concluido)
- Ambiente configurado (SSL, banco, backups, permissoes).
- Politica de acessos e perfis definida.

### 3) Cadastros base (concluido)
- Pessoas, enderecos, escolas, etapas e estruturas basicas.

### 4) Usuarios e permissoes (concluido)
- Perfis admin/secretaria/escola + permissoes por modulo.
- Vinculo de usuario com escola (school_id).

### 5) Ano letivo e matriculas (concluido)
- Calendario letivo, turmas, matriculas e transferencias.

### 6) Operacao pedagogica (concluido)
- Diario de classe: frequencia, conteudo e avaliacoes.
- Boletins e relatorios iniciais.

### 7) Modulos complementares (concluido)
- Transporte, biblioteca, merenda, comunicados, suporte.
- Relatorios e indicadores (inclui alertas e fechamento mensal).

### 8) Gestao institucional avancada (concluido)
- Gestao de servidores/RH (cadastro, afastamentos, indicadores e relatorios).
- Quadro de horarios (cadastro, validacao de conflito, indicadores, conflitos e calendario associado).
- Auditoria (logs de alteracao) - basico implementado.

### 9) Integracoes oficiais e canais digitais (concluido - aguardando integracoes)
- Educacenso/INEP (checklist basico + exportacao oficial 2025).
- Educacenso/INEP (importacao com validacao inicial).
- Pre-matricula digital (gestao interna + formulario publico e consulta por protocolo).
- Portal do aluno/responsavel (login, painel e consultas basicas).
- Portal do aluno (login e painel).
- Acesso ao portal criado nos cadastros de Responsável e Aluno (email/senha).
- Portal com controle de acesso ativo/inativo e reset de senha.
- Integracoes: SMTP/WhatsApp/SMS quando disponivel.
- Caminho para integracoes: Configuracoes do municipio (card \"Integrações\").

### 10) Operacao administrativa e financeira (em andamento)
- Almoxarifado e patrimonio escolar (materiais, consumo por escola, inventario) - iniciado (itens e movimentos).
- Matricula/transferencia avancada (historico completo, documentos e anexos).
- Indicadores gerenciais (evasao, desempenho, frequencia e comparativos).

### 11) Paridade 90%+ (prioridade alta)
- Regras de avaliacao (formulas customizaveis, pesos, medias por etapa/ano).
- Notas descritivas (parecer pedagogo por disciplina e periodo).
- Fechamento de ano e historico consolidado (tabelas definitivas).
- Documentos oficiais (ata de resultado final, ficha individual, declaracoes).
- Infraestrutura completa (predios e salas fisicas).
Status: fase 3 concluida (QR/validacao publica, ata final em PDF, ficha individual em PDF e bloqueio do checklist).

## Proximo item sugerido (Item 11)
Paridade 90%+ (regras de avaliacao, notas descritivas, fechamento, documentos e infraestrutura).

## Cronograma de paridade
Ver `CRONOGRAMA_PARIDADE_90.md`.

## Como continuar quando perder o contexto
1) Leia este arquivo.
2) Verifique os ultimos arquivos em `escolar/versao/`.
3) Siga a proxima fase pendente (Item 11).