Merge pull request #365 from bg-playground/copilot/quality-kpi-dashboard-v1

Add project-wide Quality KPI Dashboard at /quality-dashboard

Author: bg-playground

README.md

@@ -127,6 +127,7 @@ docker compose logs -f   # view logs   (or: docker-compose logs -f)
 4. **Implement**: Apply the framework to your testing processes
 5. **Build (Optional)**: Use as foundation for custom testing tools
 6. **Release Readiness**: Use the [Release Readiness Dashboard](docs/features/release-readiness-dashboard.md) for Go/Caution/No-Go checks
+7. **Quality Trends**: Use the [Quality KPI Dashboard](docs/features/quality-kpi-dashboard.md) for defect, pass-rate, module, and automation trend visuals
 
 ## 🛠️ Manual Setup
 
@@ -259,6 +260,7 @@ docker compose -f docker-compose.test.yml down -v
 | `rbac.spec.ts` | Role-based access: viewer, reviewer, admin |
 | `notifications.spec.ts` | Notification bell, mark-as-read, lifecycle |
 | `release-readiness.spec.ts` | Release readiness status banner, sign-off, and markdown export |
+| `quality-dashboard.spec.ts` | Quality KPI charts, window toggle, and release-readiness cross-link |
 
 **Useful commands:**
 

backend/app/api/__init__.py

@@ -1,10 +1,11 @@
 """API routers for BGSTM AI Traceability"""
 
-from . import links, release_readiness, requirements, test_cases
+from . import links, quality_metrics, release_readiness, requirements, test_cases
 
 __all__ = [
     "requirements",
     "test_cases",
     "links",
+    "quality_metrics",
     "release_readiness",
 ]

backend/app/api/quality_metrics.py

@@ -0,0 +1,79 @@
+from typing import Literal
+
+from fastapi import APIRouter, Depends, Query
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from app.auth.dependencies import get_current_user
+from app.crud import quality_metrics as crud
+from app.db.session import get_db
+from app.models.user import User
+from app.schemas.quality_metrics import (
+    AutomationCoverageResponse,
+    DefectsByModuleResponse,
+    DefectTrendResponse,
+    PassRateTrendResponse,
+    QualityDashboardSnapshot,
+    SummaryStatsResponse,
+)
+
+router = APIRouter(prefix="/quality-metrics")
+
+WindowParam = Literal[7, 30, 90]
+
+
+@router.get("/", response_model=QualityDashboardSnapshot)
+async def get_quality_dashboard(
+    db: AsyncSession = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+) -> QualityDashboardSnapshot:
+    _ = current_user
+    return await crud.get_quality_dashboard_snapshot(db, 30)
+
+
+@router.get("/defect-trend", response_model=DefectTrendResponse)
+async def get_defect_trend(
+    window: WindowParam = Query(30),
+    db: AsyncSession = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+) -> DefectTrendResponse:
+    _ = current_user
+    return await crud.get_defect_trend(db, window)
+
+
+@router.get("/pass-rate-trend", response_model=PassRateTrendResponse)
+async def get_pass_rate_trend(
+    window: WindowParam = Query(30),
+    db: AsyncSession = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+) -> PassRateTrendResponse:
+    _ = current_user
+    return await crud.get_pass_rate_trend(db, window)
+
+
+@router.get("/defects-by-module", response_model=DefectsByModuleResponse)
+async def get_defects_by_module(
+    window: WindowParam = Query(30),
+    top_n: int = Query(10, ge=1, le=50),
+    db: AsyncSession = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+) -> DefectsByModuleResponse:
+    _ = current_user
+    return await crud.get_defects_by_module(db, window, top_n)
+
+
+@router.get("/automation-coverage", response_model=AutomationCoverageResponse)
+async def get_automation_coverage(
+    db: AsyncSession = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+) -> AutomationCoverageResponse:
+    _ = current_user
+    return await crud.get_automation_coverage(db)
+
+
+@router.get("/summary-stats", response_model=SummaryStatsResponse)
+async def get_summary_stats(
+    db: AsyncSession = Depends(get_db),
+    current_user: User = Depends(get_current_user),
+) -> SummaryStatsResponse:
+    _ = current_user
+    return await crud.get_summary_stats(db)

backend/app/crud/__init__.py

@@ -1,10 +1,11 @@
 """CRUD operations for BGSTM AI Traceability"""
 
-from . import link, release_readiness, requirement, test_case
+from . import link, quality_metrics, release_readiness, requirement, test_case
 
 __all__ = [
     "requirement",
     "test_case",
     "link",
+    "quality_metrics",
     "release_readiness",
 ]