Centro de documentação

Esta página é o ponto de entrada da documentação do PESA: use os links abaixo para abrir cada guia. O item Documentação no menu do sistema traz você até aqui.

Documentos principais

• Arquitetura e fluxos Visão geral da arquitetura (front-end, armazenamento local, APIs) e fluxos de uso entre páginas.
• Páginas e responsabilidades Inventário das páginas HTML, objetivo de cada uma e dados consumidos.
• Modelos e score Modelos de dados (estudante, intervenção, regras) e regras de risco/score.
• Funções principais Mapa das funções por arquivo e pontos de extensão/manutenção.
• Manual do usuário Guia operacional por perfil (Coordenação, NAP e Gestão) e rotinas comuns.
• Documentação da API Endpoints do backend, payloads e exemplos de request/response.
• Conectores multi-fontes (P2-008) Contrato LMS/ERP/CRM: payload, frequência, reconciliação e alertas.
• Efetividade causal Outcomes O1–O3, matching e recomendações operacionais.
• Troubleshooting Erros comuns, causa provável e resolução rápida.

Guias rápidos e indicadores

• Guia rápido Referência curta para operação do dia a dia.
• Guia rápido (1 página) Versão condensada em uma página.
• Indicadores do Centro de Alertas Definição dos indicadores usados no painel de alertas.
• Efetividade causal (P2 gate) Aprovada v0.1 — outcomes O1/O2/O3 e coortes tratado vs comparação.
• Plano executável P2 Trilha pós-P1: causal, integrações e MLOps.
• Organograma Visão organizacional em diagrama.

Setup e manutenção

• Setup completo do ambiente Entrypoint oficial: uvicorn backend.app:app. app_main.py é legado.
• Setup banco e usuários Schema e usuário admin inicial.
• Tokens CSS: assets/pesa-tokens.css · Admin UI: assets/admin-ui.css · Export: pesa-export.js

Ordem sugerida de leitura

1. Arquitetura e fluxos
2. Modelos e score
3. Páginas e responsabilidades
4. Funções principais
5. Manual do usuário
6. Documentação da API
7. Troubleshooting

Observações

O sistema é majoritariamente front-end, com persistência em localStorage e base compartilhada via /api/estudantes-data. Backend canônico: backend.app:app. A documentação acompanha o estado atual do código.