Praxis CI
bdcf793db2
Phase 2 (Integration + Tech-Debt + NFR Measurement) complete. 4 slices, 2 waves, 9 tasks. 4 REQs covered. 60 new tests (469 total). 8 v0.4 P1+ tech-debt findings addressed. Verify: APPROVE_WITH_NOTES. NFR measurement (p95 latency + guardrail FP/FN), cohort aggregation assist metrics (5 new metrics, no schema change), assist cost tracking + C-3 budget check, tech-debt wave (argon2id offload, cookie-secret validation, credential enum, f-string SQL, cache persistence, zoneinfo, audit log, 429 mock). ---ci--- project: praxis phase: 2 milestone: v0.5 status: complete requirements: covered: [REQ-NFR-ASSIST-01, REQ-IDEATE-04, REQ-IDEATE-06, REQ-IDEATE-07] partial: [] ---/ci---
53 lines
1.8 KiB
Python
53 lines
1.8 KiB
Python
"""GET /api/operator/cohort — practice + assist volume view (TASK-08-01, TASK-10-02, D-053, D-057).
|
|
|
|
Auth-gated (Depends(current_operator)). Returns k-anonymized practice + assist
|
|
volume aggregates from cohort_aggregates: sessions_count + active_learners_count
|
|
(practice) + assist_shifts_count + assist_turns_count (assist) 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).
|
|
|
|
D-062: assist metrics are new metric strings in the same cohort_aggregates
|
|
table (no schema change). The view returns practice + assist volume
|
|
side-by-side so operators see both modes per path.
|
|
"""
|
|
|
|
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 volume metrics (v0.4) + assist volume metrics (v0.5 — TASK-10-02).
|
|
PRACTICE_METRICS = {
|
|
"sessions_count",
|
|
"active_learners_count",
|
|
"assist_shifts_count",
|
|
"assist_turns_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"] |