Uma operação fragmentada pode caber em um fluxo único?
Unificar jornadas de matrícula, contrato e cobrança sem acoplar a operação às particularidades de cada provedor.
CASE FILE. 02 / OPERAÇÕES / SAAS
ERP
Gestão para escolas, academias e operações esportivas: alunos, matrículas, contratos e cobrança. Integra assinatura, pagamentos e WhatsApp num fluxo único.
- React
- Vite
- Firebase
- Asaas
- ZapSign
BRIEF. 01 / PROBLEMA E FRONTEIRA
O produto em uma leitura.
Um recorte deliberado do estado atual. Métricas e hipótese continuam editoriais até que exista evidência pública para substituí-las.
- NÚCLEO
- ALUNOS + MATRÍCULAS RÓTULO EDITORIAL
- INTEGRAÇÕES
- PAGAR + ASSINAR RÓTULO EDITORIAL
- CAPACIDADES
- 5 frontend / backend / data / ai / integrations
- PORTA PÚBLICA
- NÃO SUPERFÍCIE PRIVADA
SYSTEM TRACE. 02 / FLUXO PRINCIPAL
Fronteiras antes de frameworks.
SPA operacional → serviços Firebase → adaptadores de cobrança, assinatura e WhatsApp.
- 01OPS→
Console operacional
React / jornadas por papel
- 02DOMAIN→
Fluxo do negócio
Alunos, matrícula e contrato
- 03ADAPTERS→
Serviços externos
Asaas, ZapSign e comunicação
- 04AUDIT
Estado e conciliação
Firebase / histórico operacional
intent → policy → authoritative state → observable effectEXECUTION TRACE / ILLUSTRATIVE
Um caminho. Cada decisão à vista.
Sequência editorial para discutir contrato, autoridade e efeito. Não representa telemetria real de produção.
- OPS
Valida campos, papel do operador e contexto da unidade.
enrollment.requested - DOMAIN
Persiste a matrícula pendente e cria intenções do fluxo.
workflow.committed - ADAPTERS
Despacha contrato e cobrança com chaves idempotentes.
provider.references - AUDIT
Reconcilia retornos e expõe pendências sem colapsar estados.
operation.visible
DECISION LOG. 03 / TRADE-OFFS
Toda escolha cobra algo.
Modelar o fluxo do negócio primeiro e tratar pagamentos, assinatura e comunicação como integrações substituíveis.
- 01 / DOMÍNIO
Jornada antes do fornecedor
- GANHO
- O produto continua legível mesmo quando uma integração muda.
- CUSTO
- Adaptadores e estados intermediários exigem modelagem adicional.
- 02 / ENTREGA
Vertical operacional em Firebase
- GANHO
- Autenticação, dados e interface chegam cedo ao contexto real.
- CUSTO
- Auditoria e consultas analíticas pedem limites bem definidos.
- 03 / AUTOMAÇÃO
WhatsApp e IA como borda
- GANHO
- Comunicação acelera sem virar fonte autoritativa do contrato.
- CUSTO
- Contexto, consentimento e handoff precisam atravessar o fluxo.
RELIABILITY. 04 / FALHAR COM CONTEXTO
Modo de falha. Sinal de volta.
Não são métricas de produção publicadas. São os riscos que o desenho precisa tornar observáveis e os sinais candidatos para a próxima rodada.
- 01
Webhook de pagamento duplicado ou recebido fora de ordem.
- 02
Contrato assinado enquanto a cobrança permanece inconclusiva.
- 03
Permissão ampla demais revela ou altera uma operação indevida.
- 01
Tempo e abandono entre matrícula, assinatura e primeira cobrança.
- 02
Itens presos na fila de conciliação entre provedores.
- 03
Ações administrativas recuperáveis pela trilha de auditoria.
INCIDENT DRILL. 05 / CONTENÇÃO → RECUPERAÇÃO → PROVA
Quando a hipótese quebra.
Exercícios editoriais de resiliência, não incidentes reais nem runbooks de produção. Cada drill transforma um modo de falha em uma resposta discutível e testável.
DRILL-01Webhook de pagamento duplicado ou recebido fora de ordem.SIMULATION / NATIVE
Resposta para: Webhook de pagamento duplicado ou recebido fora de ordem.
- CONTAIN
- Persistir o recibo do provedor e rejeitar qualquer transição que viole a versão atual da cobrança.
- RECOVER
- Reprocessar eventos idempotentes pela ordem causal e consultar o provedor quando a sequência permanecer ambígua.
- PROVE
- Conciliar valor, referência externa e estado interno sem duplicar baixa, comissão ou comunicação ao aluno.
DRILL-02Contrato assinado enquanto a cobrança permanece inconclusiva.SIMULATION / NATIVE
Resposta para: Contrato assinado enquanto a cobrança permanece inconclusiva.
- CONTAIN
- Preservar assinatura e cobrança como estados independentes e manter a matrícula numa pendência explícita.
- RECOVER
- Retomar somente a etapa financeira, oferecendo ao operador ação segura de cobrança, espera ou cancelamento.
- PROVE
- Exibir a jornada composta, a próxima ação e a trilha que comprova que nenhum estado intermediário foi apagado.
DRILL-03Permissão ampla demais revela ou altera uma operação indevida.SIMULATION / NATIVE
Resposta para: Permissão ampla demais revela ou altera uma operação indevida.
- CONTAIN
- Revogar a sessão afetada, negar a ação por padrão e preservar o registro para investigação de escopo.
- RECOVER
- Corrigir a política por papel e unidade, recalcular autorizações e exigir nova autenticação do operador.
- PROVE
- Executar a matriz de acesso e confirmar no audit log que leitura e mutação respeitam o menor privilégio.
DESIGN EXERCISE / REVISAR CONTRA TELEMETRIA E RUNBOOKS REAIS ANTES DE OPERAR
EVIDENCE. 06 / O QUE PODE SER DEFENDIDO
Fato à vista. Lacuna também.
Consolidar trilha de auditoria, permissões por papel e tratamento de falhas entre provedores.
- React + Vite + Firebase
- Asaas + ZapSign
- WhatsApp + IA
- Operação para dança e esportes
Nenhuma captura foi publicada para este corte. O portfólio preserva a lacuna em vez de fabricar uma evidência visual.
INTERVIEW MODE. 07 / APROFUNDE A CONVERSA
Três pontos para abrir no quadro.
Perguntas que conectam o case a system design, produto e operação sem transformar uma decisão contextual em regra universal.
- 01
Como modelar uma saga sem esconder estados intermediários do operador.
↗ - 02
Quando trocar conveniência de backend gerenciado por serviços próprios.
↗ - 03
Como tornar permissões e auditoria parte da experiência, não um remendo.
↗
CASE FILE / 02