Guia de Projeto FastAPI

Use este guia para serviços FastAPI com processamento assíncrono e dependências injetadas.

Escopo de Arquitetura

• Endpoints e grafo de dependências.
• Chamadas assíncronas de DB e tasks.
• Tratamento de exceções e serialização de resposta.

Setup Recomendado

1. Inicialize SDK no evento de startup.
2. Instrumente middleware de tempo/status de requisição.
3. Envolva chamadas outbound com spans.
4. Faça flush no evento de shutdown.

Contrato Mínimo de Dados

• service, env, version em todos os sinais.
• Contexto de request e sessão quando política permitir.
• Tipo de erro e stack para triagem.

Lista de Verificação

• Requisição sintética gera log + span + métrica.
• Respostas de erro incluem contexto de trace.
• Shutdown finaliza envio da fila.

Fortalecimento de Produção

1. Remova campos sensíveis antes de emitir.
2. Ajuste queue/flush para workload assíncrono.
3. Revalide hooks de ciclo de vida após upgrades.

Solução de Problemas

• Startup ok sem dados: revise ordem de middleware.
• Queda sob carga: ajuste backpressure de fila.
• Lacunas de trace: adicione spans manuais em fronteiras async.