system-prompts-and-models-o.../salesflow-saas/backend/app/api/v1/forecast_control.py
Claude a319feb6d7
feat(dealix): complete Tier-1 Sovereign Enterprise Growth OS
Governance layer (14 docs):
- MASTER_OPERATING_PROMPT.md — operating constitution (five planes, six tracks, policy classes)
- docs/ai-operating-model.md — five-plane architecture (Decision/Execution/Trust/Data/Operating)
- docs/dealix-six-tracks.md — six strategic tracks (Revenue/Intelligence/Compliance/Expansion/Operations/Trust)
- docs/governance/execution-fabric.md — OpenClaw execution plane deep dive
- docs/governance/trust-fabric.md — trust plane with contradiction engine + evidence packs
- docs/governance/saudi-compliance-and-ai-governance.md — PDPL/ZATCA/SDAIA/NCA live controls
- docs/governance/technology-radar-tier1.md — Core/Strong/Pilot/Watch/Hold classification
- docs/governance/partnership-os.md — alliance lifecycle management
- docs/governance/ma-os.md — M&A corporate development lifecycle
- docs/governance/expansion-os.md — geographic and vertical growth
- docs/governance/pmi-os.md — post-merger integration framework
- docs/governance/executive-board-os.md — executive decision surfaces
- docs/execution-matrix-90d-tier1.md — 90-day sprint execution plan
- docs/adr/0001-tier1-execution-policy-spikes.md — 8 architectural decisions

Backend (3 models, 6 services, 8 API routes):
- Contradiction Engine — detect/track system conflicts
- Evidence Pack System — tamper-evident audit proof with SHA256
- Saudi Compliance Matrix — live PDPL/ZATCA/SDAIA/NCA controls
- Executive Room — unified executive decision surface
- Connector Governance — integration health monitoring
- Model Routing Dashboard — LLM provider metrics
- Forecast Control Center — actual vs forecast across tracks
- Approval Center — enhanced approval queue with SLA

Frontend (9 components):
- Executive Room, Evidence Pack Viewer, Approval Center
- Connector Governance Board, Saudi Compliance Dashboard
- Actual vs Forecast Dashboard, Risk Heatmap
- Policy Violations Board, Partner Pipeline Board

Tooling:
- scripts/architecture_brief.py — preflight validation (40/40 checks pass)
- Updated CLAUDE.md and AGENTS.md with governance references

https://claude.ai/code/session_01W1rJthWDkasijTdXCfxVHs
2026-04-16 12:48:13 +00:00

39 lines
1.2 KiB
Python

"""Forecast Control API — unified actual vs forecast."""
from fastapi import APIRouter
from typing import Any, Dict
from app.services.forecast_control_center import forecast_control_center
router = APIRouter(prefix="/forecast-control", tags=["Forecast Control"])
@router.get("/unified")
async def unified_view() -> Dict[str, Any]:
"""Get unified actual vs forecast across all tracks."""
return forecast_control_center.get_unified_view("system")
@router.get("/variance")
async def variance_analysis() -> Dict[str, Any]:
"""Get variance analysis."""
return forecast_control_center.get_variance_analysis("system")
@router.post("/recalibrate")
async def recalibrate_forecast() -> Dict[str, Any]:
"""Trigger AI re-forecast with latest actuals."""
return {"status": "recalibration_triggered"}
@router.get("/accuracy")
async def forecast_accuracy() -> Dict[str, Any]:
"""Get deal-level forecast accuracy."""
return {"deals": [], "overall_accuracy_percent": 0.0}
@router.get("/trends")
async def accuracy_trends(periods: int = 6) -> Dict[str, Any]:
"""Get multi-period forecast accuracy trend."""
return forecast_control_center.get_accuracy_trend("system", periods)