New alert service

services/inventory/app/api/dashboard.py

@@ -30,6 +30,7 @@ from app.schemas.dashboard import (
     AlertSummary,
     RecentActivity
 )
+from app.utils.cache import get_cached, set_cached, make_cache_key
 
 logger = structlog.get_logger()
 
@@ -62,19 +63,34 @@ async def get_inventory_dashboard_summary(
     dashboard_service: DashboardService = Depends(get_dashboard_service),
     db: AsyncSession = Depends(get_db)
 ):
-    """Get comprehensive inventory dashboard summary"""
+    """Get comprehensive inventory dashboard summary with caching (30s TTL)"""
     try:
+        # PHASE 2: Check cache first (only if no filters applied)
+        cache_key = None
+        if filters is None:
+            cache_key = make_cache_key("inventory_dashboard", str(tenant_id))
+            cached_result = await get_cached(cache_key)
+            if cached_result is not None:
+                logger.debug("Cache hit for inventory dashboard", cache_key=cache_key, tenant_id=str(tenant_id))
+                return InventoryDashboardSummary(**cached_result)
+
+        # Cache miss or filters applied - fetch from database
         summary = await dashboard_service.get_inventory_dashboard_summary(db, tenant_id, filters)
-        
-        logger.info("Dashboard summary retrieved", 
+
+        # PHASE 2: Cache the result (30s TTL for inventory levels)
+        if cache_key:
+            await set_cached(cache_key, summary.model_dump(), ttl=30)
+            logger.debug("Cached inventory dashboard", cache_key=cache_key, ttl=30, tenant_id=str(tenant_id))
+
+        logger.info("Dashboard summary retrieved",
                    tenant_id=str(tenant_id),
                    total_ingredients=summary.total_ingredients)
-        
+
         return summary
-        
+
     except Exception as e:
-        logger.error("Error getting dashboard summary", 
-                    tenant_id=str(tenant_id), 
+        logger.error("Error getting dashboard summary",
+                    tenant_id=str(tenant_id),
                     error=str(e))
         raise HTTPException(
             status_code=status.HTTP_500_INTERNAL_SERVER_ERROR,
@@ -82,6 +98,41 @@ async def get_inventory_dashboard_summary(
         )
 
 
+@router.get(
+    route_builder.build_dashboard_route("overview")
+)
+async def get_inventory_dashboard_overview(
+    tenant_id: UUID = Path(...),
+    current_user: dict = Depends(get_current_user_dep),
+    dashboard_service: DashboardService = Depends(get_dashboard_service),
+    db: AsyncSession = Depends(get_db)
+):
+    """
+    Get lightweight inventory dashboard overview for health checks.
+
+    This endpoint is optimized for frequent polling by the orchestrator service
+    for dashboard health-status checks. It returns only essential metrics needed
+    to determine inventory health status.
+    """
+    try:
+        overview = await dashboard_service.get_inventory_overview(db, tenant_id)
+
+        logger.info("Inventory dashboard overview retrieved",
+                   tenant_id=str(tenant_id),
+                   out_of_stock_count=overview.get('out_of_stock_count', 0))
+
+        return overview
+
+    except Exception as e:
+        logger.error("Error getting inventory dashboard overview",
+                    tenant_id=str(tenant_id),
+                    error=str(e))
+        raise HTTPException(
+            status_code=status.HTTP_500_INTERNAL_SERVER_ERROR,
+            detail="Failed to retrieve inventory dashboard overview"
+        )
+
+
 @router.get(
     route_builder.build_dashboard_route("food-safety"),
     response_model=FoodSafetyDashboard