efetividade-coorte,
P2-005 painel em efetividade.html,
P2-006 RBAC por curso no endpoint — entregues.
P2-007 relatório mensal + recomendação escalar/manter/pausar — entregue.
P2-008 contrato de conectores multi-fontes —
APROVADO v0.1.
P2-009 conector LMS incremental + job tick + log/alerta — entregue.
P2-010 registro de modelos/scores (versão, features, owner) — entregue.
P2-011 monitor de drift (lift + calibração) — entregue.
Backlog P2 S1–S4 desta trilha concluído; extensão de conectores: LMS + ERP financeiro + ERP acadêmico + SIS.
| Sprint | Objetivo | Entrega | Prazo |
|---|---|---|---|
| S1 | Efetividade causal (MVP) | Definição de outcome, coortes tratado/controle, API e painel before/after + retenção incremental. | Semanas 1-3 |
| S2 | Relatório mensal acionável | Efetividade por tipo de ação/playbook com recomendação do que escalar; exportação. | Semanas 4-5 |
| S3 | Integrações multi-fontes (base) | Contrato de conectores + 1 ingestão incremental (LMS ou financeiro) com logs e alerta de falha. | Semanas 6-8 |
| S4 | MLOps inicial | Versionamento do score heurístico/ML, monitoramento de drift simples e política de recalibração. | Semanas 9-10 |
| ID | Tarefa | Escopo | Arquivos alvo | Critério de aceite | Prioridade |
|---|---|---|---|---|---|
| P2-001 | Definir outcomes e janelas de observação | Formalizar outcomes mínimos: (a) melhora de risco 30/60 dias; (b) rematrícula/permanência no semestre alvo; (c) conclusão de campanha. Definir janela before/after e exclusões. Spec: efetividade-causal.html (APROVADA v0.1). | docs/efetividade-causal.md, docs/indicadores-centro-alertas.html, docs/modelos-e-score.html |
Documento aprovado por gestão acadêmica + NAP + TI (gate S1). | Alta |
| P2-002 | Desenhar coorte tratado vs comparação | Regras para grupo tratado (fila/campanha concluída) e grupo de comparação (elegível não atendido ou matching por score/curso/risco). Sem RCT: matching/heurística documentada e honestidade analítica. Spec: efetividade-causal.html (APROVADA v0.1). | docs/efetividade-causal.md, docs/documentacao-api.html |
Especificação com exemplos e limitações explícitas (não causalidade perfeita). | Alta |
| P2-003 | Persistir snapshots de baseline |
Ao abrir caso/campanha/intervenção, gravar snapshot de risco/score/features
para before/after auditável. Entregue
(app_baseline_snapshot).
|
backend/db.py, backend/services/baseline_snapshot.py,
backend/routers/rematricula.py, campanhas.py, intervencoes.py |
Todo t0 gera baseline imutável; reenvio não sobrescreve. | Alta |
| P2-004 | API de efetividade por coorte | Endpoint agregando tratados vs comparação: n, taxa de melhora, retenção/rematrícula incremental, IC quando n permitir. | backend/routers/metricas.py (ou novo efetividade.py) |
GET /api/metricas/efetividade-coorte retorna séries por tipo de ação. |
Alta |
| P2-005 | Painel causal em efetividade.html | Substituir/complementar “taxa de melhora bruta” por visão coorte: before/after, grupo de comparação e retenção incremental. | efetividade.html, CSS associado |
Analista vê impacto incremental por playbook/tipo sem inventar métricas. | Alta |
| P2-006 | RBAC + honestidade analítica | Filtrar por cursos/perfil; rotular método (matching/heurística); n mínimo para exibir IC; zero inventado quando sem dados. | auth-guard.js, backend/rbac_helpers.py, docs API |
Perfis restritos sem vazamento; labels honestos na UI. | Alta |
| ID | Sprint | Tarefa | Critério de aceite | Prioridade |
|---|---|---|---|---|
| P2-007 | S2 | Relatório mensal por tipo de ação + recomendação “escalar / pausar” | Entregue: GET /api/metricas/efetividade-mensal + painel/export em efetividade.html. | Média |
| P2-008 | S3 | Contrato de conectores multi-fontes (LMS/ERP/CRM) | Entregue: conectores-multi-fontes.html (payload, frequência, reconciliação, alertas). | Alta |
| P2-009 | S3 | Primeiro conector incremental com job agendado + log | Entregue: LMS via /api/conectores, app_conector_run, job /jobs/tick, UI admin-conectores.html. | Alta |
| P2-010 | S4 | Versionamento e registro de modelo/score | Entregue: GET /api/modelos, tabela app_modelo_registro, UI admin-modelos.html + badges nas páginas de risco. | Média |
| P2-011 | S4 | Monitoramento de drift / queda de desempenho | Entregue: /api/drift, app_drift_alerta, job tick, UI admin-drift.html. | Média |
| Issue base | Desbloqueia |
|---|---|
| P2-001 | P2-002, P2-003, P2-004 |
| P2-002 | P2-004, P2-005 |
| P2-003 | P2-004 |
| P2-004 | P2-005, P2-007 |
| P2-006 | Gate obrigatório antes de publicar painel causal |
| Dimensão | Condição para concluído |
|---|---|
| Método | Outcomes e regras de coorte documentados e aprovados (gate P2-001/002). |
| Dados | Baseline snapshot nos casos/campanhas; sem métrica inventada. |
| API | Endpoint de coorte versionado e testado. |
| UI | Painel em efetividade.html com tratado vs comparação. |
| Segurança | RBAC de cursos/funções respeitado. |