Complete Tier-1 closure follow-through by wiring docs governance gates, RC release readiness checks, source-of-truth enforcement, executive weekly contract surface, and go-live severity notes. Add full go-live revenue execution documentation set (production activation, real production playbook, trust expansion, first 3 clients, live deployment, and automated revenue engine) and register all canonical paths. Made-with: Cursor
2.3 KiB
Golden path — Partner intake → Executive surface (Tier-1)
Canonical runbook for the first end-to-end governed path. APIs are under /api/v1/ in salesflow-saas/backend.
Preconditions
cwd= repo root for scripts; backend tests fromsalesflow-saas/backend.- CI:
Dealix CI+Docs governancegreen (seeenterprise-readiness.md§8).
Sequence (v1 — demo-backed where DB is empty)
-
Class B bundle (Decision plane)
GET /api/v1/approval-center/class-b-decision-bundle
→ Full bundle (memo_json,evidence_pack_json,approval_packet_json,execution_intent_json,risk_register_json). -
Runtime validation gate
POST /api/v1/approval-center/validate-class-b-bundlewith JSON body = response from step 1.
→200+{"status":"valid","correlation_id":"..."}.
Mutateexecution_intent_json.correlation_idto empty whilerequested_side_effect_classstaysexternal_*→ expect422. -
HITL (approve with bundle)
POST /api/v1/approval-center/{approval_id}/approvewith body:{ "hitl": "approve", "decision_bundle": { ... same bundle ... } }Invalid bundle →
422. -
Executive snapshot (Operating / Executive plane)
GET /api/v1/executive-room/snapshot
→ Includestier1_exec_surfacekeyed off the same demo bundle (correlation_id,pending_decisions, etc.). -
Evidence viewer (Trust)
GET /api/v1/evidence-packs/tier1-demo
→ Structured fields:verification_status, sources, assumptions. -
Connector governance
GET /api/v1/connectors/governance
→ Includestier1_connector_surfacepolicy hooks. -
Saudi-sensitive proposal send (Data / compliance)
POST /api/v1/proposals/{id}/sendwithexternal_company_contacts: truerequirespdpl_processing_classandowasp_surface_refor422(FastAPI validation).
Automated proof
- Pytest:
tests/test_tier1_golden_path_partner.py(name may vary) exercises steps 1–4 (and optionally 5–7 where auth/DB fixtures exist).
Ownership
| Step | Owner |
|---|---|
| Bundle + validation | Backend / Governance |
| Executive + evidence UI | Product + Frontend |
| Saudi fields on send | Compliance + Backend |