Feat/issue 151 correlation

[NdondaDaniel2020]

📌 Contexto & Motivação

Adiciona suporte a rastreamento distribuído de ponta a ponta através do padrão Correlation ID (X-Request-ID) e identificação do usuário (user_id). Permite correlacionar e auditar o ciclo completo de vida de uma requisição em ferramentas como Grafana Loki e Jaeger, desde a camada HTTP até a mensageria assíncrona.

Closes #151

---

🛠️ Alterações Realizadas

• Gerenciador de Contexto (contextvars): Criado app/core/observability/context.py para isolamento de request_id e user_id por contexto assíncrono.
• Middleware HTTP: setup_correlation_id_middleware extrai ou gera o X-Request-ID e garante o retorno no header da resposta HTTP.
• Logs JSON Estruturados: JSONFormatter enriquecido para injetar automaticamente request_id e user_id em todos os registros de log.
• Identidade do Usuário: Dependência get_current_user vincula o user_id autenticado ao contexto assíncrono.
• Propagação no EventBus: A classe base Event herda o correlation_id do contexto ativo e o InMemoryEventBus restaura o contexto durante a execução dos handlers/consumers.
• Testes Automatizados: Criado tests/test_correlation_id.py cobrindo o fluxo completo (HTTP, logs, mensageria e contexto).

---

🧪 Validação

uv run pytest tests/test_correlation_id.py
uv run ruff check

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
auth	Ready	Preview	Aug 30, 2026 12:03am