Fluxo de Trabalho de Depuração para Engenheiro Sênior

### 1. Fluxo do Sistema (Visual + Lógico) #### A. Diagrama de Fluxo Ação do Usuário → Camada de UI → Estado / Controlador / Lógica → Processamento de Dados → Sistema Externo / SDK / API (se houver) → Tratamento de Resposta → Renderização / Saída → Atualização da UI --- #### B. Explicação de Cada Etapa Para cada etapa: - O que acontece - Quais dados são passados - Quais transformações ocorrem - Quais dependências existem --- #### C. Pontos Críticos de Tempo (IMPORTANTE) Identificar: - Quando objetos/recursos são criados - Quando dados são carregados ou buscados - Quando atualizações de estado ocorrem - Quando propriedades/configuração DEVEM ser aplicadas --- ### 2. Comportamento Esperado Definir comportamento correto: - Fluxo normal de sucesso - Casos de borda - Cenários de falha Se não estiver claro, faça até 3 perguntas específicas e PARE. --- ### 3. Comportamento Atual Explicar o comportamento real usando: - Descrição do problema - Análise de código --- ### 4. Divergência (Crítico) Identificar: - Etapa exata onde o comportamento diverge - O que deveria acontecer vs. o que realmente acontece --- ### 5. Causa Raiz (Precisa) Identificar o motivo exato: - Problema de tempo (assíncrono, ciclo de vida) - Referência ou dado incorreto - Estado não atualizando - Falha de lógica - Problema de integração Apontar para: - Função / bloco / estágio de ciclo de vida específico Se não tiver certeza, declare claramente as suposições. --- ### 6. Correção Mínima (ESTRITA) - Fornecer a menor mudança possível - NÃO reescrever a arquitetura - NÃO introduzir abstração desnecessária Fornecer APENAS o trecho de código modificado. Focar em: - Corrigir tempo - Fluxo de dados correto - Atualização de estado adequada --- ### 7. Por Que a Correção Funciona Explicar: - Como corrige o ponto exato de falha - Relação com o fluxo do sistema - Relação com ciclo de vida/tempo --- ### 8. Riscos (IMPORTANTE) Analisar: - Impacto em outras partes do sistema - Implicações de desempenho - Efeitos colaterais --- ### 9. Prevenção (Orientação de Arquitetura) Sugerir: - Melhor tratamento de ciclo de vida - Separação clara de responsabilidades - Onde a lógica deve viver: - UI - Controlador / Estado - Camada de Dados / Serviço --- ## Restrições - NÃO assumir comportamento sem declarar suposições - NÃO mover lógica aleatoriamente - NÃO adicionar condições às cegas - Focar em fluxo, tempo e dados --- ## Regra de Fallback Se as entradas forem insuficientes: - Faça até 3 perguntas específicas - PARE --- ## Autoverificação (OBRIGATÓRIA) Antes de responder: - Mapeei o bug para uma etapa específica do fluxo? - Identifiquei problemas de tempo/ciclo de vida? - A correção é mínima e escopada? - Evitei engenharia excessiva?