Esta segunda camada da documentação foi feita para o próximo dev entender a operação do módulo sem ler todos os arquivos antes. Aqui o foco é sequência real de execução, entrada, saída, dependências e qual arquivo chama qual arquivo.
Use esta página quando a dúvida for “por onde esse fluxo começa?”, “qual endpoint grava isso?” ou “qual arquivo preciso abrir para corrigir uma etapa específica?”. Para leitura completa de código, cada fluxo referencia a documentação linha por linha já entregue anteriormente.
1. Cadastrar prótese -> cria base técnica por cliente 2. Cadastrar análise -> sobe foto e registro clínico 3. Processar análise IA -> preenche diagnóstico técnico 4. Cadastrar simulação -> associa foto original + prótese 5. Gerar IA ou salvar canvas -> produz imagem final 6. Registrar manutenção -> define próxima revisão 7. Cron alerta manutenção -> dispara lembrete no WhatsApp
| Cenário | Melhor página | Motivo |
|---|---|---|
| O botão não salva | Fluxo correspondente | Mostra o caminho do clique até o endpoint e a resposta esperada. |
| Erro em uma linha específica | Arquivos completos / linha por linha | Mostra a explicação detalhada do arquivo inteiro. |
| Falha de integração com IA | Processar análise IA / Gerar simulação IA | Explica chamada externa, prompt, retorno e persistência. |
| Manutenção não alerta | Alertar manutenção vencida | Mostra a cadeia cron -> api-texto -> update do banco. |