feat: adiciona Dockerfile, docker-compose, /health e /metrics

Author: EricJoness

Dockerfile

@@ -0,0 +1,20 @@
+FROM python:3.12-slim
+
+LABEL maintainer="Eric Jones Silva <ericjonsilva@outlook.com>"
+LABEL description="Bot Report API — API REST para relatórios de execução de bots"
+
+WORKDIR /app
+
+# Instalar dependências primeiro (aproveita cache do Docker)
+COPY pyproject.toml ./
+RUN pip install --no-cache-dir -e "."
+
+# Copiar código
+COPY bot_report_api/ ./bot_report_api/
+
+EXPOSE 8000
+
+HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
+  CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:8000/health')"
+
+CMD ["uvicorn", "bot_report_api.main:app", "--host", "0.0.0.0", "--port", "8000"]

bot_report_api/main.py

@@ -4,11 +4,16 @@
 Desenvolvida com FastAPI e Pydantic v2.
 """
 
-from fastapi import FastAPI
+import time
 from contextlib import asynccontextmanager
 
+from fastapi import FastAPI
+
 from bot_report_api.routers import bots, execucoes, relatorios
-from bot_report_api.database import inicializar_db
+from bot_report_api.database import inicializar_db, listar_bots, listar_execucoes
+from bot_report_api.schemas import StatusExecucao
+
+_startup_time = time.time()
 
 
 @asynccontextmanager
@@ -22,7 +27,8 @@ async def lifespan(app: FastAPI):
     title="Bot Report API",
     description=(
         "API REST para cadastro de bots, registro de execuções e "
-        "consulta de relatórios de automação."
+        "consulta de relatórios de automação.\n\n"
+        "**Documentação:** `/docs` | **OpenAPI JSON:** `/openapi.json`"
     ),
     version="0.1.0",
     lifespan=lifespan,
@@ -33,7 +39,32 @@ async def lifespan(app: FastAPI):
 app.include_router(relatorios.router, prefix="/relatorios", tags=["Relatórios"])
 
 
-@app.get("/", tags=["Health"])
+@app.get("/health", tags=["Observabilidade"], summary="Health check")
 def health_check():
-    """Verifica se a API está no ar."""
-    return {"status": "ok", "versao": "0.1.0"}
+    """Verifica se a API está operacional — retorna status, versão e uptime."""
+    return {
+        "status": "ok",
+        "versao": "0.1.0",
+        "uptime_segundos": round(time.time() - _startup_time, 1),
+    }
+
+
+@app.get("/metrics", tags=["Observabilidade"], summary="Métricas da aplicação")
+def metricas():
+    """Retorna métricas operacionais em tempo real para monitoramento."""
+    todas_execucoes = listar_execucoes()
+    return {
+        "total_bots": len(listar_bots()),
+        "total_execucoes": len(todas_execucoes),
+        "execucoes_por_status": {
+            status.value: sum(1 for e in todas_execucoes if e.status == status)
+            for status in StatusExecucao
+        },
+        "uptime_segundos": round(time.time() - _startup_time, 1),
+        "versao": "0.1.0",
+    }
+
+
+@app.get("/", include_in_schema=False)
+def root():
+    return {"mensagem": "Bot Report API — acesse /docs para a documentação."}

docker-compose.yml

@@ -0,0 +1,15 @@
+services:
+  api:
+    build: .
+    container_name: bot-report-api
+    ports:
+      - "8000:8000"
+    environment:
+      - APP_ENV=development
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:8000/health')"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 10s

tests/test_api.py

@@ -20,9 +20,19 @@ def client():
 # ── Health ─────────────────────────────────────────────────────────────────
 
 def test_health_check(client):
-    response = client.get("/")
+    response = client.get("/health")
     assert response.status_code == 200
     assert response.json()["status"] == "ok"
+    assert "uptime_segundos" in response.json()
+
+
+def test_metrics(client):
+    response = client.get("/metrics")
+    assert response.status_code == 200
+    dados = response.json()
+    assert "total_bots" in dados
+    assert "total_execucoes" in dados
+    assert "execucoes_por_status" in dados
 
 
 # ── Bots ───────────────────────────────────────────────────────────────────