Files
praxis/server/operator/cohort.py
T
Praxis CI ec6fcc64bc feat(milestone): merge phase/02 cohort-dashboard → milestone/v0.4-operator-tier
Phase 2 complete — Cohort Dashboard + Aggregation:
- Cohort aggregation pipeline (k-anon ≥10 write-time suppression, async hook, nightly 03:00 CT reconcile)
- 4 auth-gated operator API endpoints (cohort, mastery, failure-patterns, credentials)
- React cohort dashboard (BrowserRouter, login, 3 views, inline SVG sparklines, auth gate)
- SPA fallback via SpaStaticFiles subclass (G-041 — NOT catch-all route)
- G-038 differencing-attack test (unit + API e2e)
- 317 pytest pass, 36 skip, 0 fail; 17/17 vitest pass; npm build + typecheck clean

---ci---
project: praxis
phase: 2
milestone: v0.4
status: complete
requirements:
  covered: [REQ-DASH-01, REQ-NFR-DASH-01, REQ-NFR-DASH-02, REQ-MT-02]
  partial: []
---/ci---
2026-08-04 11:43:34 +00:00

42 lines
1.4 KiB
Python

"""GET /api/operator/cohort — practice volume view (TASK-08-01, D-053, D-057).
Auth-gated (Depends(current_operator)). Returns k-anonymized practice-volume
aggregates from cohort_aggregates: sessions_count + active_learners_count per
path. Suppressed cells have value=null + cell_suppressed=true; the frontend
renders \"— (<10 learners)\". No per-learner drill-down (R-DASH-02).
last_updated = max(updated_at) for freshness (REQ-NFR-DASH-02).
"""
from __future__ import annotations
import datetime as _dt
from fastapi import APIRouter, Depends, Request
from server.auth.dependencies import current_operator
from server.auth.models import Operator
from server.operator._common import (
ViewResponse,
all_recent_aggregates,
group_by_path,
require_pg_store,
)
router = APIRouter(prefix="/api/operator", tags=["operator-cohort"])
PRACTICE_METRICS = {"sessions_count", "active_learners_count"}
@router.get("/cohort", response_model=ViewResponse)
async def cohort_view(
request: Request,
op: Operator = Depends(current_operator),
) -> ViewResponse:
pg_store = await require_pg_store(request)
since = _dt.date.today() - _dt.timedelta(days=30)
rows = await all_recent_aggregates(pg_store, since)
views, last_updated = group_by_path(rows, PRACTICE_METRICS)
return ViewResponse(views=views, last_updated=last_updated)
__all__ = ["router"]