141 lines
5.2 KiB
Python
141 lines
5.2 KiB
Python
from __future__ import annotations
|
|
|
|
from datetime import UTC, date, datetime
|
|
from typing import Literal
|
|
|
|
from fastapi import APIRouter, Depends
|
|
from sqlalchemy import select
|
|
from sqlalchemy.orm import Session
|
|
|
|
from app.api.deps import get_current_user, get_db
|
|
from app.core.config import get_settings
|
|
from app.models.booking import Booking
|
|
from app.models.customer import Customer
|
|
from app.models.data_quality import DataQualityIssue
|
|
from app.models.outbox import OutboxEvent
|
|
from app.models.vehicle import Vehicle
|
|
from app.schemas import (
|
|
AttentionItem,
|
|
AutomationRunOut,
|
|
CurrentUser,
|
|
DashboardOut,
|
|
EvidenceSignalOut,
|
|
TodayItem,
|
|
)
|
|
from app.services.operations import compute_metrics
|
|
|
|
router = APIRouter(prefix="/api/v1/dashboard", tags=["dashboard"])
|
|
settings = get_settings()
|
|
|
|
_SEVERITY_ORDER = {"high": 0, "medium": 1, "low": 2}
|
|
|
|
|
|
def _today() -> date:
|
|
# Seeded dates are shifted to the real reset moment by `seed_loader.py`'s anchor
|
|
# shift, so "today" must be real wall-clock time, not the frozen `demo_today` setting.
|
|
return datetime.now(UTC).date()
|
|
|
|
|
|
@router.get("", response_model=DashboardOut)
|
|
def get_dashboard(
|
|
db: Session = Depends(get_db),
|
|
_user: CurrentUser = Depends(get_current_user),
|
|
) -> DashboardOut:
|
|
metrics = compute_metrics(db)
|
|
|
|
vehicles_by_id = {v.id: v for v in db.scalars(select(Vehicle)).all()}
|
|
customers_by_id = {c.id: c for c in db.scalars(select(Customer)).all()}
|
|
|
|
issues = db.scalars(
|
|
select(DataQualityIssue)
|
|
.where(DataQualityIssue.status == "open")
|
|
.order_by(DataQualityIssue.detected_at.asc())
|
|
).all()
|
|
attention_items = []
|
|
for issue in issues:
|
|
entity: Vehicle | Customer | None
|
|
link_type: Literal["vehicle", "customer"]
|
|
if issue.entity_type == "vehicle":
|
|
entity = vehicles_by_id.get(issue.entity_id)
|
|
link_type = "vehicle"
|
|
else:
|
|
entity = customers_by_id.get(issue.entity_id)
|
|
link_type = "customer"
|
|
link_ref = entity.public_ref if entity else ""
|
|
# The backend never emits prose for the attention queue -- only stable signal
|
|
# codes + raw data params, exactly like the issue detail page's evidence list
|
|
# (see app/services/data_quality.py::_open_issue). The frontend is the one place
|
|
# that turns these into the operator's selected language; `evidence_json["summary"]`
|
|
# is a technical fallback only, never rendered here.
|
|
signals = [
|
|
EvidenceSignalOut(code=s["code"], params=s.get("params", {}))
|
|
for s in issue.evidence_json.get("signals", [])
|
|
]
|
|
attention_items.append(
|
|
AttentionItem(
|
|
kind="quality_issue",
|
|
severity=issue.severity,
|
|
rule_type=issue.rule_type,
|
|
evidence_signals=signals,
|
|
link_type=link_type,
|
|
link_ref=link_ref,
|
|
issue_ref=issue.public_ref,
|
|
)
|
|
)
|
|
# Curate a credible severity mix instead of letting `high` dominate every slot:
|
|
# each item's real severity is unchanged, only the display selection is capped per
|
|
# tier (a handful of "now", then "today", then "later") so a heavy day of high-severity
|
|
# issues doesn't crowd out medium/low ones the operator should still see.
|
|
high_items = [i for i in attention_items if i.severity == "high"]
|
|
medium_items = [i for i in attention_items if i.severity == "medium"]
|
|
low_items = [i for i in attention_items if i.severity == "low"]
|
|
attention_items = (high_items[:3] + medium_items[:3] + low_items[:2])[:8]
|
|
|
|
today = _today()
|
|
bookings = db.scalars(select(Booking)).all()
|
|
today_items: list[TodayItem] = []
|
|
for b in bookings:
|
|
vehicle = vehicles_by_id.get(b.vehicle_id)
|
|
vehicle_ref = vehicle.public_ref if vehicle else ""
|
|
if b.starts_at.date() == today and b.status in ("reserved", "active"):
|
|
today_items.append(
|
|
TodayItem(
|
|
kind="departure",
|
|
booking_ref=b.public_ref,
|
|
vehicle_ref=vehicle_ref,
|
|
scheduled_at=b.starts_at,
|
|
)
|
|
)
|
|
if b.ends_at.date() == today and b.status in ("active", "returned"):
|
|
today_items.append(
|
|
TodayItem(
|
|
kind="return",
|
|
booking_ref=b.public_ref,
|
|
vehicle_ref=vehicle_ref,
|
|
scheduled_at=b.ends_at,
|
|
)
|
|
)
|
|
today_items.sort(key=lambda item: item.scheduled_at)
|
|
|
|
recent = db.scalars(select(OutboxEvent).order_by(OutboxEvent.occurred_at.desc()).limit(5)).all()
|
|
recent_automation = [
|
|
AutomationRunOut(
|
|
event_id=str(r.event_id),
|
|
event_type=r.event_type,
|
|
aggregate_ref=r.payload_json.get("aggregate_ref", ""),
|
|
status=r.delivery_status,
|
|
attempts=r.attempts,
|
|
last_error=r.last_error,
|
|
last_error_code=r.last_error_code,
|
|
occurred_at=r.occurred_at,
|
|
)
|
|
for r in recent
|
|
]
|
|
|
|
return DashboardOut(
|
|
metrics=metrics,
|
|
attention_items=attention_items,
|
|
today=today_items,
|
|
recent_automation=recent_automation,
|
|
)
|