Card 32 [M7] Testes de Aceitação (UAT)

📥 Itens herdados do M2 (realocados em 03/08/2026)

Ao executar este card, incluir nos testes de aceitação:

Testar instalação PWA iOS — Add to Home Screen em iPhone real (Safari)
Testar instalação PWA Android — Add to Home Screen em Android real (Chrome)
Testar push notification iOS — receber push com app instalado
Testar push notification Android — receber push com app instalado

Ver detalhes: docs/execucao/_m2-pendencias-reallocadas.md

🎯 Objetivo

Executar UAT (User Acceptance Testing) com usuários reais da ANIK (direção, professor, responsável, aluno, atendente) em ambiente de homologação (sistemaescolar.wellka.com.br) antes da migração de dados. Validar todos os fluxos críticos por role, registrar bugs em planilha/Trello, corrigir bloqueantes. Critério de saída: 100% dos fluxos críticos aprovados, 0 blocker aberto.

📋 Especificação técnica

Entregáveis de teste (documentos, não código)

docs/uat/PLANO-UAT.md — matriz de casos de teste por role × fluxo
docs/uat/ROTEIROS-*.md — roteiros executáveis por perfil (LOCAL, PROFESSOR, PARENT, STUDENT, MASTER, SUPERVISOR, Atendente)
docs/uat/BUG-TRACKER.md — log de bugs (severidade, status, responsável)
docs/uat/RELATORIO-FINAL-UAT.md — sumário + aprovação do cliente

Fluxos críticos por role

STUDENT (M1): login, materiais, notas/frequência, tarefas, gamificação
PARENT (M2): login PWA, acompanhamento, financeiro PIX, chat
PROFESSOR (M3): diário de notas, chamada (um por um), tarefas, plano de aula, comunicados (com aprovação)
LOCAL (M4): dashboard, matrículas, turmas, financeiro, comunicados + aprovações, avisos automáticos
MASTER/SUPERVISOR (M5): dashboard rede, filiais, marca, usuários RBAC, auditoria, relatórios
Atendimento (M6): WhatsApp, bot handoff, CRM funil, workflows de e-mail

Casos de teste (exemplos)

Matrícula completa (Lead → Visita → Documentação → Pagamento → Contrato → Ativo)
Chamada digital SEM "marcar todos" (decisão)
Desconto de pontualidade aplicado, SEM juros de mora
Aprovação prévia de comunicados de professor pela direção
Aviso de falta em lote às 20:00 (Job Bull)
Conversão de lead sem aprovação + motivo obrigatório na perda
Bot WhatsApp responde e faz handoff no "falar com secretaria"
2FA obrigatório para MASTER/LOCAL/SUPERVISOR

Automação (suporte)

Suíte Vitest/E2E (Playwright) para regressão dos fluxos críticos
Rodar em CI antes do Go-Live

🎨 UX (processo)

┌─────────────────────────────────────────────────────┐
│  UAT — Semana 1 do M7                               │
├─────────────────────────────────────────────────────┤
│  D1-D2:  Treinar roteiros + smoke test por role     │
│  D3-D5:  Execução pelos usuários da ANIK            │
│  D6-D7:  Correção de bugs + reteste                 │
│  D8:     Relatório final + sign-off do cliente      │
│                                                      │
│  Status: 0 blocker · 3 medium · 12 low              │
│  Fluxos aprovados: 47/52 (90%)                      │
└─────────────────────────────────────────────────────┘

🔌 Dependências

Cards 4-31 (M1-M6): todas as funcionalidades prontas em homologação
Cliente ANIK: disponibilar usuários para testar (direção, professores, pais)
decisoes.md: todas as regras de negócio (critérios de aceite derivam daqui)

📦 Entregáveis

Plano UAT (matriz role × fluxo × caso de teste)
Roteiros executáveis por perfil
Execução com usuários reais da ANIK
Bug tracker (severidade/status/responsável)
Correção de todos os blockers
Suíte E2E (Playwright) para regressão
Relatório final + sign-off do cliente

✅ Critérios de aceite

Plano UAT cobre 100% dos fluxos críticos por role
Usuários da ANIK executam os roteiros em homologação
Todos os bugs BLOCKER corrigidos e retestados
Regras de negócio validadas (sem "marcar todos", sem juros, aprovação prévia, motivo perda, etc.)
Suíte E2E verde no CI
Cliente assina sign-off de aprovação
Documentação entregue ao cliente

🔗 Links

Trello: https://trello.com/c/GAxMjaPx
Decisões relevantes: decisoes.md (todas as seções — critérios derivam das decisões)
Doc anterior: 31-m6-email-workflows.md
Próximo: Card 33 (Migração de Dados & Carga Inicial)