Navegador de Rastro de Funcionalidade (Ação do Usuário → Grafo de Chamadas → Análise de Código)
Rastreie uma funcionalidade única desde a entrada na interface ou API, passando por controladores, serviços e camadas de dados, para gerar um grafo de chamadas e uma análise anotada.
Visão geral do prompt
Dicas para você
- Forneça logs ou nomes de testes para identificar caminhos reais de execução. - Inclua código de tratamento de erros para capturar fluxos alternativos. - Adicione um exemplo curto de payload usado em produção.
Da equipe de operaçõesNexusAi TechnologyProblema que resolve
Encontrar o caminho completo de uma funcionalidade através das camadas é propenso a erros. Isso gera um grafo de chamadas confiável e destaca onde investigar a seguir.
Clareza do Caminho de Ponta a Ponta
Mostra exatamente como os dados se movem pelas camadas.
Anotações Práticas
Cada etapa inclui propósito, entradas/saídas e efeitos colaterais.
Detector de Lacunas de Testes
Destaca testes faltantes ou frágeis ao longo do caminho.
Orientação para Próximo Arquivo
Indica o que ler a seguir e por quê.
Instruções do prompt de IA
Atue como um engenheiro full-stack sênior e cartógrafo de código.
Por que essa tarefa é importante:
Rastros de ponta a ponta revelam como os dados fluem, onde ocorrem efeitos colaterais e quais componentes são críticos para manutenção e testes.
Limites importantes:
- Trabalhe apenas com as rotas, controladores, serviços e trechos de modelo fornecidos.
- Se existirem múltiplas variantes, priorize o caminho de produção.
Entradas do usuário:
- Descrição da funcionalidade (ex.: “Criar Tarefa” via POST /tasks).
- Arquivos relevantes: manipuladores de rotas, controladores, serviços, modelos, middleware.
- Quaisquer logs ou nomes de testes que cubram esse caminho.
Objetivos:
1) Produzir um grafo de chamadas claro desde a entrada até a persistência.
2) Anotar funções-chave com propósito, entradas/saídas e efeitos colaterais.
3) Identificar riscos, testes faltantes e lacunas de observabilidade.
4) Recomendar a ordem dos próximos arquivos a serem lidos.
Fluxo de análise:
1) Comece pela rota; localize chamadas a controladores e serviços.
2) Acompanhe transformações de dados e validações.
3) Observe chamadas externas (banco de dados, filas, HTTP) e tratamento de erros.
4) Faça referência cruzada com testes existentes.
5) Resuma preocupações sobre desempenho, confiabilidade e legibilidade.
Formato de saída requerido:
- Grafo de chamadas em texto (lista indentada) para copiar/colar.
- Anotações por etapa: propósito, parâmetros, saída, efeitos colaterais.
- Testes faltantes e casos de teste sugeridos.
- Próximos 5 arquivos para revisão.
Controles de qualidade:
- Inclua nomes exatos de funções e caminhos de arquivos.
- Diferencie afirmações de suposições; marque claramente as suposições.
Checklist de verificação:
- Todas as camadas representadas (rota → controlador → serviço → modelo).
- Integrações externas identificadas.
Instrução final:
Forneça um rastreamento que um novo engenheiro possa seguir para implementar uma correção de bug com confiança.
Resultado esperado
Grafo de Chamadas: POST /tasks → routes/tasks.js:createTask → controllers/taskController.js:create → services/taskService.js:createTask → models/task.js:Task.create Anotações: - createTask (rota): Valida esquema do corpo; encaminha para o controlador - controller.create: Mapeia DTO, trata try/catch - service.createTask: Aplica regras de negócio, remove títulos duplicados - Task.create: Persiste, retorna id Testes Faltantes: Rejeição de título duplicado; payload inválido 400. Próximos Arquivos: middleware/validateBody.js, services/notifications.js
Jornada de implementação
Construa o rastreamento com Codex
Abra o Codex. Cole os trechos de rota, controlador, serviço e modelo para a funcionalidade escolhida. Solicite um grafo de chamadas e uma análise anotada usando este prompt. Espere um rastreamento em camadas com nomes de funções e caminhos.
12 minValide as chamadas no VS Code
Navegue até cada função no VS Code e confirme parâmetros, retornos e efeitos colaterais. Adicione ou corrija etapas faltantes (filas, cache, chamadas HTTP).
10 minConverta em checklist de testes
Transforme a lista de testes faltantes em nomes de testes no seu executor de testes e crie placeholders. Compartilhe o rastreamento e checklist na documentação do seu repositório para orientar o próximo PR.
8 min
