truthound-dashboard 1.0.0__py3-none-any.whl

truthound_dashboard/api/health.py

@@ -0,0 +1,78 @@
+"""Health check endpoint.
+
+This module provides health and readiness endpoints for
+monitoring and orchestration systems.
+"""
+
+from __future__ import annotations
+
+from datetime import datetime
+from typing import Any
+
+from fastapi import APIRouter
+
+from truthound_dashboard import __version__
+from truthound_dashboard.schemas import BaseSchema
+
+router = APIRouter()
+
+
+class HealthResponse(BaseSchema):
+    """Health check response schema."""
+
+    status: str
+    version: str
+    timestamp: str
+    checks: dict[str, Any] | None = None
+
+
+@router.get(
+    "/health",
+    response_model=HealthResponse,
+    summary="Health check",
+    description="Check if the server is healthy and responding",
+)
+async def health_check() -> HealthResponse:
+    """Check server health.
+
+    Returns basic health information including version and timestamp.
+    """
+    return HealthResponse(
+        status="ok",
+        version=__version__,
+        timestamp=datetime.utcnow().isoformat(),
+    )
+
+
+@router.get(
+    "/ready",
+    response_model=HealthResponse,
+    summary="Readiness check",
+    description="Check if the server is ready to accept requests",
+)
+async def readiness_check() -> HealthResponse:
+    """Check server readiness.
+
+    Performs deeper health checks including database connectivity.
+    """
+    checks: dict[str, Any] = {}
+
+    # Check database
+    try:
+        from truthound_dashboard.db import get_session
+
+        async with get_session() as session:
+            await session.execute("SELECT 1")
+        checks["database"] = {"status": "ok"}
+    except Exception as e:
+        checks["database"] = {"status": "error", "message": str(e)}
+
+    # Determine overall status
+    all_ok = all(c.get("status") == "ok" for c in checks.values())
+
+    return HealthResponse(
+        status="ok" if all_ok else "degraded",
+        version=__version__,
+        timestamp=datetime.utcnow().isoformat(),
+        checks=checks,
+    )

truthound_dashboard/api/history.py

@@ -0,0 +1,62 @@
+"""Validation history API endpoints.
+
+Provides endpoints for validation history and trend analysis.
+"""
+
+from __future__ import annotations
+
+from typing import Annotated, Literal
+
+from fastapi import APIRouter, Depends, HTTPException, Query
+
+from truthound_dashboard.core import HistoryService
+
+from .deps import SessionDep
+
+router = APIRouter()
+
+
+async def get_history_service(session: SessionDep) -> HistoryService:
+    """Get history service dependency."""
+    return HistoryService(session)
+
+
+HistoryServiceDep = Annotated[HistoryService, Depends(get_history_service)]
+
+
+@router.get(
+    "/sources/{source_id}/history",
+    response_model=dict,
+    summary="Get validation history",
+    description="Get validation history with trend analysis for a source.",
+)
+async def get_validation_history(
+    source_id: str,
+    service: HistoryServiceDep,
+    period: Literal["7d", "30d", "90d"] = Query("30d", description="Time period"),
+    granularity: Literal["hourly", "daily", "weekly"] = Query(
+        "daily", description="Aggregation granularity"
+    ),
+) -> dict:
+    """Get validation history with trend data.
+
+    Args:
+        source_id: Source ID.
+        service: History service.
+        period: Time period to analyze (7d, 30d, 90d).
+        granularity: Aggregation granularity (hourly, daily, weekly).
+
+    Returns:
+        Dictionary with summary, trend, failure_frequency, and recent_validations.
+    """
+    try:
+        data = await service.get_history(
+            source_id,
+            period=period,
+            granularity=granularity,
+        )
+        return {"success": True, "data": data}
+    except ValueError as e:
+        raise HTTPException(status_code=404, detail=str(e))
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=str(e))