system-prompts-and-models-o.../salesflow-saas/docs/governance/executive-board-os.md
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

196 lines
6.7 KiB
Markdown

# Executive & Board OS — Decision Surface Framework
> **Parent**: [`MASTER_OPERATING_PROMPT.md`](../../MASTER_OPERATING_PROMPT.md)
> **Plane**: Decision | **Tracks**: All
> **Version**: 1.0 | **Status**: Canonical
---
## Overview
The Executive & Board OS defines what leadership sees, how decisions are escalated, and what constitutes a complete board pack. The goal is to make Dealix **Board-usable** — executives can make informed decisions from system-generated surfaces.
---
## Executive Surfaces
### 1. Executive Room
**Purpose**: Single view of everything an executive needs to know right now.
| Section | Data Source | Refresh |
|---------|-----------|---------|
| Revenue Overview | `analytics_service.py` | Real-time |
| Actual vs Forecast | `forecast_control_center.py` | Daily |
| Pipeline Health | `deal_service.py` | Real-time |
| Approval Queue | `ApprovalRequest` model | Real-time |
| Connector Health | `connector_governance.py` | 5 min |
| Compliance Posture | `saudi_compliance_matrix.py` | Daily |
| Active Contradictions | `contradiction_engine.py` | Real-time |
| Strategic Deals | `strategic_deals/` services | Real-time |
| Risk Summary | Aggregated | Daily |
**API**: `GET /api/v1/executive-room/snapshot`
### 2. Approval Center
**Purpose**: All pending approvals with SLA timers.
| Feature | Description |
|---------|------------|
| Queue | Filterable by category, priority, SLA status |
| SLA Timer | Color-coded countdown (green → yellow → red) |
| Bulk Actions | Approve/reject low-risk items in batch |
| History | Full approval history with audit trail |
**API**: `GET /api/v1/approval-center`
### 3. Evidence Pack Viewer
**Purpose**: Browse and review assembled evidence packs.
| Feature | Description |
|---------|------------|
| Pack List | By type (deal, compliance, board, incident) |
| Detail View | Expandable evidence items |
| Review Workflow | Mark reviewed, add notes |
| Integrity Check | SHA256 hash verification |
**API**: `GET /api/v1/evidence-packs`
### 4. Risk Heatmap
**Purpose**: Visual risk matrix across all domains.
| Axis | Categories |
|------|-----------|
| X (Category) | Revenue, Compliance, Technology, Operations, Partners, M&A |
| Y (Severity) | Critical, High, Medium, Low |
| Color | Red (active + unmitigated), Yellow (active + mitigated), Green (resolved) |
Data aggregated from: Compliance Matrix, Contradiction Engine, Connector Health, SLA Breaches.
### 5. Actual vs Forecast Dashboard
**Purpose**: Unified view across all tracks.
| Track | Actual | Forecast | Variance |
|-------|--------|----------|----------|
| Revenue | Live pipeline value | AI + manual forecast | Auto-calculated |
| Partnerships | Active partner count | Partner targets | Auto-calculated |
| M&A | Deals in progress | Pipeline target | Auto-calculated |
| Expansion | Markets launched | Launch plan | Auto-calculated |
**API**: `GET /api/v1/forecast-control/unified`
### 6. Next-Best-Action Board
**Purpose**: AI-recommended actions prioritized by impact.
| Source | Action Type |
|--------|------------|
| Revenue | Follow up on stale deals, upsell signals |
| Compliance | Controls needing attention |
| Operations | Connectors needing maintenance |
| Trust | Contradictions needing resolution |
### 7. Pipeline Boards
**Purpose**: Kanban views for strategic pipelines.
| Board | Stages |
|-------|--------|
| Partner Pipeline | Scout → Evaluate → Negotiate → Onboard → Active |
| M&A Pipeline | Source → Screen → Diligence → Negotiate → Close |
| Expansion Pipeline | Scan → Prioritize → Ready → Canary → Scale |
### 8. Policy Violations Board
**Purpose**: Active policy violations and contradictions.
| Column | Description |
|--------|------------|
| Violation | What was detected |
| Severity | Critical / High / Medium / Low |
| Source | Which system detected it |
| Status | Detected → Investigating → Resolved |
| Owner | Who is responsible for resolution |
---
## Board Pack Template
Produced quarterly (or on-demand for special meetings):
### Section 1: Executive Summary
- Overall business health (RAG status)
- Key achievements this period
- Key risks requiring board attention
### Section 2: Financial Performance
- Revenue actual vs forecast
- Customer acquisition metrics (CAC, LTV, payback)
- Runway / burn rate (if applicable)
### Section 3: Product & Technology
- Platform uptime and reliability
- AI agent performance metrics
- Technology radar changes
- Security posture summary
### Section 4: Compliance & Governance
- PDPL compliance status
- ZATCA compliance status
- Active audit findings
- Policy violations summary
### Section 5: Strategic Initiatives
- Partnership pipeline status
- M&A pipeline status
- Expansion roadmap progress
### Section 6: People & Culture
- Team size and Saudization ratio
- Key hires and departures
- Training and development
### Section 7: Risk Register
- Top 10 risks with mitigation status
- New risks identified this period
- Risk heatmap visualization
### Section 8: Decisions Required
- Items requiring board vote
- Recommendation for each item
- Supporting evidence packs
---
## Decision Escalation Matrix
| Decision Type | Operational | Manager | Director | VP | C-Level | Board |
|--------------|-------------|---------|----------|-----|---------|-------|
| Lead routing | x | | | | | |
| Message send | | x | | | | |
| Discount <10% | | x | | | | |
| Discount 10-25% | | | x | | | |
| Discount >25% | | | | x | | |
| New integration | | | x | | | |
| DB migration | | | | x | | |
| Partner activation | | | | x | | |
| M&A short list | | | | | x | |
| M&A offer | | | | | | x |
| Market launch | | | | | x | |
| Production deployment | | | | x | | |
| Policy change | | | | | x | |
| Budget >100K SAR | | | | | x | |
| Budget >1M SAR | | | | | | x |
---
## Code Mapping
| Surface | Backend | Frontend |
|---------|---------|----------|
| Executive Room | `services/executive_roi_service.py` (expanded) | `components/dealix/executive-room.tsx` |
| Approval Center | `api/v1/approval_center.py` | `components/dealix/approval-center.tsx` |
| Evidence Packs | `services/evidence_pack_service.py` | `components/dealix/evidence-pack-viewer.tsx` |
| Risk Heatmap | Aggregated service | `components/dealix/risk-heatmap.tsx` |
| Forecast Control | `services/forecast_control_center.py` | `components/dealix/actual-vs-forecast-dashboard.tsx` |
| Partner Pipeline | `api/v1/strategic_deals.py` | `components/dealix/partner-pipeline-board.tsx` |
| Policy Violations | `services/contradiction_engine.py` | `components/dealix/policy-violations-board.tsx` |
| Compliance Dashboard | `services/saudi_compliance_matrix.py` | `components/dealix/saudi-compliance-dashboard.tsx` |
| Connector Governance | `services/connector_governance.py` | `components/dealix/connector-governance-board.tsx` |