Efetividade causal — especificação v0.1

Gate P2-001 / P2-002 · Plano: pesa-p2-plano-executavel.html · Fonte MD: efetividade-causal.md

1. Objetivo (P2-001)

Evoluir a taxa bruta de “melhora” para medição por coorte: before/after no tratado, grupo de comparação e retenção/rematrícula incremental (US-04).

2. Outcomes oficiais v0.1

2.1 Uso

• Tático: O1 (30d) + O3.
• Executivo de impacto: O2 quando a janela de rematrícula estiver fechada; senão pendente_janela.
• O3 não substitui impacto acadêmico (O1/O2).

2.2 Classes O1

2.3 Censura (fora do denominador de impacto)

Conclusão/colação, trancamento formal, transferência externa, óbito, remoção do dataset sem baseline — contados em n_censurados.

3. Tempo zero (t0) e baseline

1. 1ª mudança de fila para em_atendimento (preferencial fila).
2. Inclusão como participante de campanha (preferencial playbook).
3. 1º registro de intervenção com data (fallback).

Baseline: snapshot em t0 (score, nível, score rematrícula, curso, features mínimas). Sem snapshot → fora da coorte causal v0.1.

4. Coortes (P2-002)

4.1 Tratado (T)

Elegível com t0 no período, baseline presente, não censurado. Subtipos: T_fila, T_campanha, T_intervencao.

4.2 Comparação (C) — matching heurístico v0.1

• Mesmo curso (obrigatório se perfil não global).
• Score ±10 pontos ou mesmo nível se score ausente.
• Ativo no semestre S; sem t0 no período ampliado; não censurado.
• Matching 1:k (k padrão 1, máx. 3), sem reposição no corte mensal.
• Sem par → T_sem_par; reportar cobertura de matching (não forçar).

5. Métricas

Publicação: %/lift se n_T ≥ 10 e n_C ≥ 10; 5–9 só taxa sem IC; <5 só contagens. IC Wilson 95% quando aplicável.

6. Recomendação (P2-007 — entregue)

Heurística com n≥10: escalar (lift≥0,10 estável em 2 cortes), manter (|lift|<0,05), pausar (lift≤−0,05). API GET /api/metricas/efetividade-mensal; painel em efetividade.html.

7. API (P2-004 — entregue)

GET /api/metricas/efetividade-coorte — exemplo:

{
  "status": "ok",
  "metodo": "matching_heuristico_v0.1",
  "outcome": "O1",
  "janela_dias": 30,
  "tratado": { "n": 42, "sucessos": 18, "taxa": 0.429 },
  "comparacao": { "n": 42, "sucessos": 11, "taxa": 0.262 },
  "lift": 0.167,
  "cobertura_matching": 0.95,
  "n_censurados": 3
}

Serviço: backend/services/efetividade_coorte.py. Painel: efetividade.html.

8. Persistência (P2-003 — entregue)

Tabela app_baseline_snapshot, imutável por (estudante_id, origem, origem_ref).

• fila — 1ª transição para em_atendimento
• campanha — inclusão do participante
• intervencao — 1º registro (fallback)

Serviço: backend/services/baseline_snapshot.py.

9. DoD do gate

• Outcomes O1/O2/O3 e janelas assinados (gestão + NAP + TI).
• Regras tratado/comparação e matching aceitas, com limitações explícitas.
• Limiares de n / IC / “não inventar” aceitos.
• Plano P2 marcado como APROVADO v0.1 e liberação de P2-003+.

10. Limitações v0.1

• Viés de seleção residual após matching.
• Intervenções fora do sistema contaminam o controle.
• O2 depende da janela de rematrícula da IES.
• Δscore é proxy heurístico, não ground-truth calibrado.

Plano P2 · Indicadores · Modelos e score · Índice