system-prompts-and-models-o.../docs/governance/operational-severity-model.md
Sami Assiri 1ceeea9004 feat(tier1): finalize production activation and revenue execution pack
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
2026-04-17 14:13:57 +03:00

28 lines
3.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Operational severity model (V0V3)
**Canonical:** [`MASTER_OPERATING_PROMPT.md`](../../MASTER_OPERATING_PROMPT.md).
**Related:** [approval-policy.md](approval-policy.md) (A/R/S), [`RELEASE_READINESS_MATRIX_AR.md`](../RELEASE_READINESS_MATRIX_AR.md).
Use this scale for **policy violations**, **ledger contradictions**, **connector health**, **workflow failures**, and **release gate** items so dashboards and runbooks speak one language.
| Level | Name (EN) | تعريف مختصر (AR) | أمثلة | تأثير على الإصدار |
|-------|-----------|------------------|--------|---------------------|
| **V0** | Informational | ملاحظة تشغيلية بلا تأثير مباشر على العميل | تحذيرات deprecated، drift توثيقي | لا يعطل RC |
| **V1** | Operational | يتطلب إجراءًا داخليًا في SLA قصير | فشل مهمة خلفية مع إعادة محاولة، انحراف مقياس داخلي | لا يعطل RC إن وُجدت آلية تعويض |
| **V2** | Customer-impacting | يؤثر على تجربة عميل أو بيانات حساسة | فشل موصل حرج، تأخير موافقة Class B، تعارض أدلة جزئي | **يمنع** ترقية canary→prod حتى التخفيف أو الاستثناء المسجل |
| **V3** | Regulatory / release-blocking | يعطل الإصدار أو يرفع مخاطر امتثال | تسريب محتمل، تعارض أدلة على مسار R2/R3، غياب بوابة أمان | **Stop ship**؛ راجع [`trust-fabric.md`](trust-fabric.md) و[`github-and-release.md`](github-and-release.md) |
## Wiring (target)
- اربط كل حدث حوكمة بـ `severity` (V0V3) في السجلات واللوحات.
- صفوف [`RELEASE_READINESS_MATRIX_AR.md`](../RELEASE_READINESS_MATRIX_AR.md) تلخص أعلى خطورة مفتوحة لكل مرشح إصدار.
## V2 / V3 وعلاقتها ببوابة الإطلاق (`go-live-gate`)
- **V2 (Customer-impacting):** يجب أن يوقف ترقية **canary → prod** (أو يفرض استثناءً مسجّلًا) حتى يُخفّف الخطر؛ لا يكفي تسجيل الحدث في لوحة فقط.
- **V3 (Regulatory / release-blocking):** **Stop ship** لمرشحي الإصدار؛ لا يُعتبر RC enterprise جاهزًا مع تعارضات V3 مفتوحة — انظر [`enterprise-readiness.md`](../enterprise-readiness.md) §8 و[`trust-fabric.md`](trust-fabric.md).
**تنفيذ API اليوم:** استجابة `GET /api/v1/autonomous-foundation/integrations/go-live-gate` تعكس أساسًا **جاهزية التكامل/البيئة** (`build_go_live_readiness_report` + [`go_live_matrix.py`](../../salesflow-saas/backend/app/services/go_live_matrix.py)). سياسة **V3 على مسار التعارضات** تبقى بوابة ثقة منفصلة في الوثائق وفي اختبارات `POST /api/v1/contradictions/` حتى تُربَط قائمة التعارضات المفتوحة بذات التقرير؛ عندها يمكن دمج `launch_allowed=false` أو إثراء `blocked_reasons` دون تغيير معنى فحوص البيئة الحالية.
**عقد الاستجابة:** يُنصح بإرجاع حقل توضيحي (مثل `trust_severity_note`) يربط المستهلك بـ operational-severity وenterprise-readiness حتى لا يُخلط بين «تكامل الإنتاج جاهز» و«لم يبقَ خطر V3 في سجل الثقة».