system-prompts-and-models-o.../salesflow-saas/docs/dealix-six-tracks.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

226 lines
7.9 KiB
Markdown

# Dealix Six-Track Framework
> **Parent**: [`MASTER_OPERATING_PROMPT.md`](../MASTER_OPERATING_PROMPT.md)
> **Version**: 1.0 | **Status**: Canonical
---
## Overview
All strategic and operational work in Dealix is organized into six tracks. Each track has defined KPIs, current maturity, target maturity, and maps to specific code components.
---
## Track 1: Revenue
**Domain**: Lead capture → qualification → deal pipeline → closing → post-sale → renewal
### Scope
- Intake (website, WhatsApp, email, referrals, forms)
- Enrichment and entity linking
- Qualification / scoring / routing
- Multi-channel outreach
- Meeting orchestration
- Proposal / CPQ / pricing governance
- Contract handoff
- Onboarding handoff
- Renewal / upsell / cross-sell
- Account expansion intelligence
- Actual vs forecast
- Churn / expansion signals
### Code Mapping
| Component | File |
|-----------|------|
| Lead Service | `services/lead_service.py` |
| Deal Service | `services/deal_service.py` |
| Sales OS Service | `services/sales_os_service.py` |
| Revenue Room API | `api/v1/revenue_room.py` |
| Lead Qualification Agent | `ai-agents/prompts/lead-qualification-agent.md` |
| Outreach Writer Agent | `ai-agents/prompts/outreach-message-writer.md` |
| Closer Agent | `ai-agents/prompts/closer-agent.md` (backend/app/ai/prompts/) |
| Meeting Booking Agent | `ai-agents/prompts/meeting-booking-agent.md` |
| Proposal Drafting Agent | `ai-agents/prompts/proposal-drafting-agent.md` |
| Sequence Engine | `services/sequence_engine.py` |
| Auto Pipeline | `services/auto_pipeline.py` |
| Predictive Revenue | `services/predictive_revenue_service.py` |
| CPQ Service | `services/cpq/` |
| Signal Selling | `services/signal_selling_service.py` |
### Structured Outputs
- `LeadScoreCard` — score 0-100, signals, recommendation
- `QualificationMemo` — structured deal qualification
- `ProposalPack` — pricing + terms + value proposition
- `PricingDecisionRecord` — pricing rationale + approval status
- `HandoffChecklist` — sales-to-onboarding transition
### KPIs
- Pipeline velocity (days)
- Win rate (%)
- Revenue lift vs baseline (%)
- CAC payback (months)
- Forecast accuracy (%)
### Maturity: **Strong** — Core pipeline live, CPQ exists, need unified actual-vs-forecast
---
## Track 2: Intelligence
**Domain**: Signal detection, behavior analysis, AI agents, forecasting
### Code Mapping
| Component | File |
|-----------|------|
| Signal Intelligence | `services/signal_intelligence.py` |
| Behavior Intelligence | `services/behavior_intelligence.py` |
| Meeting Intelligence | `services/meeting_intelligence.py` |
| Model Router | `services/model_router.py` |
| Arabic NLP | `services/ai/arabic_nlp.py` |
| Knowledge Brain | `services/knowledge_brain.py` |
| WhatsApp Brain | `services/whatsapp_brain.py` |
| Email Brain | `services/email_brain.py` |
| LinkedIn Brain | `services/linkedin_brain.py` |
| Social Media Brain | `services/social_media_brain.py` |
| Comparison Engine | `services/comparison_engine.py` |
| Company Research | `services/company_research.py` |
| OSINT Service | `services/osint_service.py` |
### KPIs
- Model latency p95 (ms)
- Schema adherence rate (%)
- Arabic memo quality score
- Tool-call reliability (%)
- Cost per successful workflow (SAR)
### Maturity: **Strong** — Multi-model routing live, Arabic NLP live, need model routing dashboard
---
## Track 3: Compliance
**Domain**: PDPL, ZATCA, SDAIA, sector regulations, audit trails
### Code Mapping
| Component | File |
|-----------|------|
| PDPL Consent Manager | `services/pdpl/consent_manager.py` |
| PDPL Data Rights | `services/pdpl/data_rights.py` |
| ZATCA Compliance | `services/zatca_compliance.py` |
| Compliance API | `api/v1/compliance.py` |
| Consent API | `api/v1/consents.py` |
| Audit Service | `services/audit_service.py` |
| Audit Log Model | `models/audit_log.py` |
| Complaint Model | `models/compliance.py` |
| PDPL Consent Model | `models/consent.py` |
| Compliance Reviewer Agent | `ai-agents/prompts/compliance-reviewer.md` |
| Shannon Security | `services/shannon_security.py` |
### Compliance Controls
- **PDPL**: Consent lifecycle, data subject rights, cross-border, retention, breach notification
- **ZATCA**: E-invoicing Phase 2, VAT 15%, SAR formatting
- **SDAIA**: AI governance registration, explainability
- **NCA**: Cybersecurity controls, data residency
- **Sector**: Real estate brokerage, healthcare data, financial services
### KPIs
- Consent coverage rate (%)
- Compliance control pass rate (%)
- Mean time to resolve complaints (hours)
- Audit trail completeness (%)
### Maturity: **Moderate** — PDPL engine live, ZATCA basic, need Saudi Compliance Matrix (live controls)
---
## Track 4: Expansion
**Domain**: Strategic deals, M&A, partnerships, geographic expansion
### Code Mapping
| Component | File |
|-----------|------|
| Acquisition Scouting | `services/strategic_deals/acquisition_scouting.py` |
| Deal Matcher | `services/strategic_deals/deal_matcher.py` |
| Deal Negotiator | `services/strategic_deals/deal_negotiator.py` |
| Deal Room | `services/strategic_deals/deal_room.py` |
| Ecosystem Mapper | `services/strategic_deals/ecosystem_mapper.py` |
| Portfolio Intelligence | `services/strategic_deals/portfolio_intelligence.py` |
| Strategic Simulator | `services/strategic_deals/strategic_simulator.py` |
| ROI Engine | `services/strategic_deals/roi_engine.py` |
| Company Profiler | `services/strategic_deals/company_profiler.py` |
| Company Twin | `services/strategic_deals/company_twin.py` |
| Deal Taxonomy | `services/strategic_deals/deal_taxonomy.py` |
| Channel Compliance | `services/strategic_deals/channel_compliance.py` |
| Territory Manager | `services/territory_manager.py` |
### KPIs
- Strategic pipeline value (SAR)
- Time-to-close for partnerships (days)
- Partner-sourced revenue (%)
- Geographic coverage (markets)
### Maturity: **Moderate** — 15 strategic deal services live, need governance docs and pipeline board
---
## Track 5: Operations
**Domain**: Deployment, monitoring, connectors, infrastructure
### Code Mapping
| Component | File |
|-----------|------|
| Operations Hub | `services/operations_hub.py` |
| Go-Live Matrix | `services/go_live_matrix.py` |
| Observability | `services/observability.py` |
| Self-Improvement | `services/self_improvement.py` |
| Feature Flags | `services/feature_flags.py` |
| Execution Router | `services/execution_router.py` |
| Integration Sync State | `models/operations.py` |
| Operations API | `api/v1/operations.py` |
| Docker Compose | `docker-compose.yml` |
| CI/CD | `.github/workflows/dealix-ci.yml` |
| Hermes Orchestrator | `services/hermes_orchestrator.py` |
| Channel Orchestrator | `services/channel_orchestrator.py` |
### KPIs
- System uptime (%)
- API p95 latency (ms)
- Connector health rate (%)
- Deployment frequency (per week)
- Mean time to recovery (minutes)
### Maturity: **Moderate** — Docker + CI live, need connector governance + model routing dashboard
---
## Track 6: Trust
**Domain**: Policy gates, approval SLAs, evidence packs, contradiction detection
### Code Mapping
| Component | File |
|-----------|------|
| Policy Engine | `openclaw/policy.py` |
| Approval Bridge | `openclaw/approval_bridge.py` |
| Trust Score Service | `services/trust_score_service.py` |
| Security Gate | `services/security_gate.py` |
| SLA Escalation | `services/sla_escalation_alerts.py` |
| Tool Verification | `services/tool_verification.py` |
| Tool Receipts | `services/tool_receipts.py` |
| Skill Governance | `services/skill_governance.py` |
| Outbound Governance | `services/outbound_governance.py` |
| Approval Request Model | `models/operations.py` |
| Trust Score Model | `models/advanced.py` |
| Domain Event Model | `models/operations.py` |
### KPIs
- Approval SLA compliance (%)
- Active contradictions count
- Evidence pack coverage (%)
- Policy violation rate (%)
- Mean time to resolve contradictions (hours)
### Maturity: **Moderate** — Policy engine + approval bridge live, need contradiction engine + evidence packs