feat(phase-33): final polish V3 - navigation, performance, and documentation (T-238 to T-240)

backend/app/routers/operational_metrics.py

@@ -27,8 +27,10 @@ def operational_metrics(
     db: Session = Depends(get_db),
     current_user: User = Depends(get_current_user),
 ):
-    """Get all operational metrics (MTTD, MTTR, Detection Efficacy, etc.)."""
-    return get_all_operational_metrics(db)
+    """Get all operational metrics (MTTD, MTTR, etc.) — cached for 5 min."""
+    from app.services.score_cache import get_operational_metrics_cached
+
+    return get_operational_metrics_cached(db)
 
 
 # ── GET /metrics/operational/trend ────────────────────────────────────

backend/app/routers/scores.py

@@ -93,8 +93,10 @@ def score_organization(
     db: Session = Depends(get_db),
     current_user: User = Depends(get_current_user),
 ):
-    """Get the overall organization security score."""
-    return calculate_organization_score(db)
+    """Get the overall organization security score (cached for 5 min)."""
+    from app.services.score_cache import get_organization_score_cached
+
+    return get_organization_score_cached(db)
 
 
 # ── GET /scores/history ──────────────────────────────────────────────
@@ -170,6 +172,10 @@ def update_scoring_config(
     if payload.platform_diversity is not None:
         settings.SCORING_WEIGHT_PLATFORM_DIVERSITY = payload.platform_diversity
 
+    # Weights changed — bust the score cache
+    from app.services.score_cache import invalidate
+    invalidate()
+
     return {
         "message": "Scoring config updated",
         "weights": {