iscc-app / sinetti_api /routers /data_access_admin.py
Couscouskabyle's picture
Squash historical storage before approved Sinetti release ea8677e4
2b8ea89
Raw History Blame
5.39 kB
"""Admin data-access API: org/user limits, usage overview, export audit.
Thin router over `sinetti_services.data_access_meter`. Mounted with
`dependencies=[Depends(require_admin)]` in sinetti_api/app.py (same pattern as
billing_admin). Validation ValueErrors return a graceful `{ok: false, message}`
envelope; unknown orgs 404.
"""
from __future__ import annotations
from dataclasses import asdict
from datetime import datetime
from fastapi import APIRouter, Depends, HTTPException, Query
from pydantic import BaseModel
import store_billing
from sinetti_api.deps import require_admin
from sinetti_services import data_access_meter as meter
from sinetti_services.user_directory import User
router = APIRouter(prefix="/api/admin/data-access", tags=["data_access_admin"])
class LimitsPayload(BaseModel):
requests_per_window: int | None = None
daily_export_rows: int | None = None
monthly_export_rows: int | None = None
periodic_unlimited: bool | None = None
def _limits_ok(limits: meter.EffectiveLimits) -> dict:
return {"ok": True, "limits": asdict(limits)}
def _parse_optional_dt(value: str | None, field: str) -> datetime | None:
if value is None or value == "":
return None
text = value.strip()
if text.endswith("Z"):
text = text[:-1] + "+00:00"
try:
parsed = datetime.fromisoformat(text)
except ValueError as exc:
raise ValueError(f"{field} must be an ISO-8601 datetime") from exc
if parsed.tzinfo is None:
raise ValueError(f"{field} must be timezone-aware")
return parsed
@router.get("/orgs/{org_id}")
def get_org_data_access(org_id: str) -> dict:
org = store_billing.get_org(org_id)
if org is None:
raise HTTPException(status_code=404, detail=f"Unknown org {org_id!r}")
overview = meter.org_usage_overview(org_id)
member_ids = [m["user_id"] for m in store_billing.org_members(org_id)]
members = meter.usage_overview(member_ids) if member_ids else []
return {
"org_id": overview["org_id"],
"name": org["name"],
"limits": overview["limits"],
"requests_in_window": overview["requests_in_window"],
"daily_export_rows_used": overview["daily_export_rows_used"],
"monthly_export_rows_used": overview["monthly_export_rows_used"],
"members": members,
}
@router.put("/orgs/{org_id}/limits")
def put_org_limits(org_id: str, body: LimitsPayload, admin: User = Depends(require_admin)) -> dict:
if store_billing.get_org(org_id) is None:
raise HTTPException(status_code=404, detail=f"Unknown org {org_id!r}")
try:
limits = meter.set_org_limits(
org_id,
requests_per_window=body.requests_per_window,
daily_export_rows=body.daily_export_rows,
monthly_export_rows=body.monthly_export_rows,
periodic_unlimited=body.periodic_unlimited,
updated_by=admin.user_id,
)
except ValueError as exc:
return {"ok": False, "message": str(exc)}
return _limits_ok(limits)
@router.delete("/orgs/{org_id}/limits")
def delete_org_limits(org_id: str, admin: User = Depends(require_admin)) -> dict:
if store_billing.get_org(org_id) is None:
raise HTTPException(status_code=404, detail=f"Unknown org {org_id!r}")
try:
limits = meter.reset_org_limits(org_id, updated_by=admin.user_id)
except ValueError as exc:
return {"ok": False, "message": str(exc)}
return _limits_ok(limits)
@router.put("/users/{user_id}/limits")
def put_user_limits(user_id: str, body: LimitsPayload, admin: User = Depends(require_admin)) -> dict:
try:
limits = meter.set_limits(
user_id,
requests_per_window=body.requests_per_window,
daily_export_rows=body.daily_export_rows,
monthly_export_rows=body.monthly_export_rows,
periodic_unlimited=body.periodic_unlimited,
updated_by=admin.user_id,
)
except ValueError as exc:
return {"ok": False, "message": str(exc)}
return _limits_ok(limits)
@router.delete("/users/{user_id}/limits")
def delete_user_limits(user_id: str, admin: User = Depends(require_admin)) -> dict:
try:
limits = meter.reset_limits(user_id, updated_by=admin.user_id)
except ValueError as exc:
return {"ok": False, "message": str(exc)}
return _limits_ok(limits)
@router.get("/export-audit")
def get_export_audit(
org_id: str | None = None,
user_id: str | None = None,
outcome: str | None = None,
date_from: str | None = None,
date_to: str | None = None,
limit: int = Query(default=100, ge=1, le=1000),
offset: int = Query(default=0, ge=0),
) -> dict:
try:
parsed_from = _parse_optional_dt(date_from, "date_from")
parsed_to = _parse_optional_dt(date_to, "date_to")
items, total = meter.list_export_audit(
org_id=org_id,
user_id=user_id,
outcome=outcome,
date_from=parsed_from,
date_to=parsed_to,
limit=limit,
offset=offset,
)
except ValueError as exc:
return {"ok": False, "message": str(exc)}
return {"items": items, "total": total}