Feat/issue 152 liveness probe

[NdondaDaniel2020]

📌 Contexto & Motivação

Adiciona um endpoint raso (shallow check) dedicado para atuar como Liveness Probe, desassociando a verificação de vivacidade do processo das checagens profundas de banco de dados/Redis (/api/health). Isso evita que instabilidades temporárias no PostgreSQL causem o reinício em massa dos contêineres (Thundering Herd).

Closes #152

---

🛠️ Alterações Realizadas

• Novo Endpoint: Adicionado GET /api/live em app/main.py retornando imediatamente {"status": "alive"} com HTTP 200 OK sem realizar chamadas I/O ou consultas ao banco.
• Documentação de Arquitetura: Atualizado docs/observability-health.md com as diretrizes recomendadas:
  • Liveness Probe: GET /api/live (reinicia o contêiner apenas se a thread principal do FastAPI travar).
  • Readiness Probe: GET /api/health (remove o contêiner do pool de tráfego se o DB estiver fora, sem matar a aplicação).
• Testes Unitários: Criado tests/test_health.py validando o comportamento de /api/live e /api/health.

---

🧪 Validação

uv run pytest tests/test_health.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:16am