@tera-system/core 0.1.0

package/core/tera-system/runtime/TERA_RUNTIME_TEMPLATES_PREPARATION.md

@@ -0,0 +1,376 @@
+# Tera Runtime Templates — Preparation & Blueprint Outputs
+
+These are the preparation-phase templates (Sections 35–40: TCEA outputs and ApplicationBlueprint outputs) split from TERA_RUNTIME_TEMPLATES.md via INSPECTION-2026-08-01 (INS-02).
+Main file: `tera-system/runtime/TERA_RUNTIME_TEMPLATES.md` (Sections 1–28).
+Delivery templates: `tera-system/runtime/TERA_RUNTIME_TEMPLATES_DELIVERY.md` (Sections 29–34).
+
+---
+
+## 35. Discovery Coverage Summary (TCEA — Phase 2 Mandatory Output)
+
+This template defines `client-engagement/DISCOVERY_COVERAGE_SUMMARY.md`.
+It is produced by TCEA after completing the 13-domain discovery and before any scope/quotation/handoff.
+
+```markdown
+# DISCOVERY_COVERAGE_SUMMARY.md
+
+## 1. Metadata
+
+| Field | Value |
+|---|---|
+| Client | [name] |
+| Application | [name] |
+| Prepared by | TCEA |
+| Date | YYYY-MM-DD |
+| Last Updated | YYYY-MM-DD |
+
+## 2. Domain Coverage Matrix
+
+> الترقيم والتسمية حسب المصدر الرسمي: `tera-system/client-helpers/tera-client-engagement-discovery-domains.md`
+
+| # | Domain | Status | Reason if not Complete | Impact | Risk | Blocks Pricing? | Blocks Handoff? | **Source of Info** | **Confirmed by Majed?** | **Risk if Wrong** |
+|---|--------|--------|----------------------|--------|------|----------------|-----------------|--------------------|-------------------------|-------------------|
+| 1 | Business & Goals | Complete / Partial / Missing / Deferred / N/A | ... | ... | L/M/H | Yes/No | Yes/No | Majed / Websearch / Inference / Unknown | Yes / No / Partially | L / M / H |
+| 2 | Users, Roles & Access | ... | ... | ... | ... | ... | ... | ... | ... | ... |
+| 3 | Process & Workflow | ... | ... | ... | ... | ... | ... | ... | ... | ... |
+| 4 | Data & Content | ... | ... | ... | ... | ... | ... | ... | ... | ... |
+| 5 | Scope & MVP | ... | ... | ... | ... | ... | ... | ... | ... | ... |
+| 6 | Screens & UX | ... | ... | ... | ... | ... | ... | ... | ... | ... |
+| 7 | Notifications Engine | ... | ... | ... | ... | ... | ... | ... | ... | ... |
+| 8 | Reports & Dashboards | ... | ... | ... | ... | ... | ... | ... | ... | ... |
+| 9 | Design & Branding | ... | ... | ... | ... | ... | ... | ... | ... | ... |
+| 10 | Technical, Hosting & Compliance | ... | ... | ... | ... | ... | ... | ... | ... | ... |
+| 11 | Security & Audit | ... | ... | ... | ... | ... | ... | ... | ... | ... |
+| 12 | Integrations & APIs | ... | ... | ... | ... | ... | ... | ... | ... | ... |
+| 13 | Acceptance, Commercials & Warranty | ... | ... | ... | ... | ... | ... | ... | ... | ... |
+
+> **ملاحظة المجال 13:** يحتاج تغطية 3 جوانب داخلية على الأقل: (أ) معايير القبول والاختبارات, (ب) الميزانية وخطة الدفع, (ج) الضمان والصيانة.
+
+## 3. Coverage Decision
+
+| Item | Value |
+|---|---|
+| Overall Status | Ready for Scope / Needs More Discovery / Ready for Quotation / Ready for Handoff / Blocked |
+| Missing Critical Domains | [list or none] |
+| Next Action | [explicit next step] |
+| Approved by Majed | Yes / No / Pending |
+
+---
+
+## 36. TERA_HANDOFF_PACKAGE.md — TCEA Output (Phase 3 Mandatory Output)
+
+This is the official template for `client-engagement/TERA_HANDOFF_PACKAGE.md`.
+It is produced by TCEA after scope/quotation approval, packaging everything for delivery to ApplicationBlueprintAgent → TeraAgent.
+
+**SCP-038 Compliance:** This template includes a dedicated compliance section (§1). Every handoff MUST include this section — do NOT remove it.
+
+```markdown
+# TERA_HANDOFF_PACKAGE.md
+
+> **حزمة التسليم الرسمية — متوافقة مع SCP-038**
+> **العميل:** [Client Name]
+> **التطبيق:** [Application Name]
+> **المرحلة:** Phase 1 (MVP) / Phase 2 / Phase 3
+> **تاريخ الإعداد:** YYYY-MM-DD
+> **الحالة:** [Draft / Approved]
+> **SCP-038 Compliance:** ✅ متوافقة — تم تطبيق القواعد الأربع (Reconciliation, Budget-to-Scope, Decision Register, Approval Consistency)
+> **إعداد:** TCEA
+
+---
+
+## فهرس المحتويات
+
+| القسم | المحتوى |
+|:------|:--------|
+| 1 | التوافق مع SCP-038 |
+| 2 | خلاصة تنفيذية |
+| 3 | معلومات العميل |
+| 4 | ملخص النطاق |
+| 5 | قائمة الميزات المعتمدة |
+| 6 | خارج النطاق + المؤجل |
+| 7 | ملخص التسعير والشروط التجارية |
+| 8 | ملخص سجل القرارات |
+| 9 | النقاط المفتوحة والمعلقة |
+| 10 | المراجع والملفات |
+| 11 | قرار الجاهزية للتسليم |
+
+---
+
+## 1. التوافق مع SCP-038
+
+تم تطبيق قواعد SCP-038 الأربع على حزمة التسليم:
+
+| القاعدة | الحالة | التفاصيل |
+|---------|:------:|----------|
+| **§3.3.1 Final Scope Reconciliation Gate** | ✅ مطبّق / ⚠️ غير مطبّق | [FEATURE_LIST.md: كل ميزة مصنفة بحالتها النهائية ✅ Included / ◉ Optional / ⏳ Phase 2 / ❌ Out of Scope] |
+| **§3.3.2 Budget-to-Scope Control Rule** | ✅ مطبّق / ⚠️ غير مطبّق | [كل ميزة مصنفة Essential/Important/Nice-to-have ضمن الميزانية المحددة] |
+| **§3.3.3 Client Decision Register** | ✅ مطبّق / ⚠️ غير مطبّق | [CLIENT_DECISION_LOG.md: جميع القرارات موثقة بحالات موحدة] |
+| **§3.6.1 Approval Consistency Rule** | ✅ مطبّق / ⚠️ غير مطبّق | [الحزمة متسقة مع أقل حالة مصدر — جميع المصادر معتمدة / بعضها Draft] |
+
+> **ملاحظة:** إذا كانت أي قاعدة غير مطبّقة، اذكر السبب والخطة لتفعيلها في قسم النقاط المفتوحة (§9).
+
+---
+
+## 2. خلاصة تنفيذية
+
+[2-3 جمل تلخص: من هو العميل، المشكلة التي يحلها التطبيق، الحل المقترح، وحالة التسليم]
+
+---
+
+## 3. معلومات العميل
+
+| الحقل | القيمة |
+|-------|--------|
+| **Client name** | [Full Name] |
+| **Application name** | [Full Name] |
+| **Business goal** | [Goal statement] |
+| **Problem statement** | [Problem statement] |
+| **Client approval status** | ✅ Approved / ⏳ Pending |
+| **SCP-038 Compliance** | ✅ متوافقة |
+
+---
+
+## 4. ملخص النطاق
+
+| الحقل | القيمة |
+|-------|--------|
+| **Approved scope** | [Core scope description] |
+| **MVP scope** | [Bullet list of MVP features] |
+| **Phase 2** | [Items for Phase 2] |
+| **Phase 3** | [Items for Phase 3] |
+| **Out of scope** | [Items explicitly out of scope] |
+
+---
+
+## 5. قائمة الميزات المعتمدة
+
+| # | الميزة | الحالة النهائية Stack | الأولوية للميزانية | ملاحظات |
+|---|--------|----------------------|-------------------|---------|
+| 1 | [Feature] | ✅ Included / ◉ Optional / ⏳ Phase 2 / ❌ Out of Scope | Essential / Important / Nice-to-have | [Notes] |
+
+> **المفتاح:** ✅ Included = مشمولة في هذه المرحلة · ◉ Optional = اختيارية · ⏳ Phase 2/3 = مؤجلة · ❌ Out of Scope = غير مشمولة أبداً
+
+---
+
+## 6. خارج النطاق + المؤجل
+
+| البند | الحالة | السبب | التاريخ المستهدف |
+|-------|--------|-------|:----------------:|
+| [Item] | خارج النطاق / مؤجل لـ Phase 2/3 | [Reason] | [Target date or TBD] |
+
+---
+
+## 7. ملخص التسعير والشروط التجارية
+
+| الحقل | القيمة |
+|-------|--------|
+| **السعر الإجمالي** | [Amount] JOD |
+| **سياسة التسعير** | [e.g. Tera Pricing Policy v4.2] |
+| **نطاق الدفع** | [Payment terms] |
+| **الضمان** | [Warranty terms] |
+| **المرجع** | DRAFT_QUOTATION.md |
+
+---
+
+## 8. ملخص سجل القرارات
+
+| # | التاريخ | القرار | الحالة |
+|---|---------|--------|:------:|
+| 1 | YYYY-MM-DD | [Decision description] | ✅ Approved / ⏳ Deferred / ⚠️ Conditional / ❓ Not Finalized |
+
+> **المرجع:** CLIENT_DECISION_LOG.md للتفاصيل الكاملة
+
+---
+
+## 9. النقاط المفتوحة والمعلقة
+
+| # | النقطة | التأثير | مطلوب من | التاريخ المستهدف |
+|---|--------|---------|----------|:----------------:|
+| 1 | [Description] | [Impact] | Majed / Client / TCEA | YYYY-MM-DD |
+
+---
+
+## 10. المراجع والملفات
+
+| الملف | المسار | الإصدار | ملاحظات |
+|-------|--------|:-------:|---------|
+| CLIENT_INTAKE.md | `client-engagement/` | v1.0 | [Notes] |
+| CLIENT_BRIEF.md | `client-engagement/` | v1.0 | [Notes] |
+| SCOPE_SUMMARY.md | `client-engagement/` | v1.0 | [Notes] |
+| FEATURE_LIST.md | `client-engagement/` | v1.0 | [Notes] |
+| DRAFT_QUOTATION.md | `client-engagement/` | v1.0 | [Notes] |
+| CLIENT_DECISION_LOG.md | `client-engagement/` | v1.0 | [Notes] |
+| DISCOVERY_COVERAGE_SUMMARY.md | `client-engagement/` | v1.0 | [Notes] |
+| GATE_COMPLIANCE_RECORD.md | `client-engagement/` | v1.0 | [Notes] |
+
+---
+
+## 11. قرار الجاهزية للتسليم
+
+| الحقل | القيمة |
+|-------|--------|
+| **Handoff Readiness Gate** | 🟢 جاهز / 🟡 جاهز مع ملاحظات / 🔴 غير جاهز |
+| ✅ | [Checklist item 1] |
+| ✅ | [Checklist item 2] |
+| **Final Consistency Check** | ✅ PASS — [عدد القرارات المطابق: N / تصنيف النطاق متسق / لا بقايا مصطلحات / المراجع سليمة] (SCP-2026-08-15-010) |
+| **الخطوة التالية:** | [Next step after handoff] |
+| **تاريخ التسليم:** | YYYY-MM-DD |
+
+---
+
+> **تم إعداد هذه الحزمة بواسطة:** TCEA
+> **تاريخ التحديث:** YYYY-MM-DD
+> **حالة الاعتماد:** Draft / Approved
+```
+```
+
+---
+
+## 37. Depth Assessment — قسم في APPLICATION_BLUEPRINT.md
+
+هذا القسم يُدرج في بداية `APPLICATION_BLUEPRINT.md` (قبل Blueprint Status) بعد تطبيق Depth Assessment في §5.5.1.
+
+```markdown
+### Depth Assessment
+
+| البعد | التقييم | السبب |
+|-------|---------|-------|
+| **Risk Level** | High / Medium / Low | [سبب التقييم] |
+| **Uncertainty Level** | High / Medium / Low | [سبب التقييم] |
+| **Domain Complexity** | High / Medium / Low | [سبب التقييم] |
+| **Selected Depth** | Core Only / Standard / Full | [سبب اختيار هذا المستوى] |
+```
+
+---
+
+## 38. C4 Architecture Diagrams — قسم في APPLICATION_BLUEPRINT.md
+
+هذا القسم يُدرج في `APPLICATION_BLUEPRINT.md` عند مستوى **Full** فقط.
+
+```markdown
+### C4 Architecture Diagrams
+
+#### Context Diagram (C1)
+[وصف النظام في محيطه — المستخدمون الخارجيون، الأنظمة المتكاملة]
+
+```structurizr
+!include https://raw.githubusercontent.com/structurizr/dsl/master/src/structurizr/dsl/structurizr.dsl
+
+workspace {
+    model {
+        user = person "مستخدم" "وصف المستخدم"
+        system = softwareSystem "النظام" "وصف النظام"
+
+        user -> system "يستخدم"
+    }
+    views {
+        systemContext system "SystemContext" {
+            include *
+            autolayout
+        }
+    }
+}
+```
+
+#### Container Diagram (C2)
+[المكونات الكبيرة — Web, API, Database, Workers]
+
+```structurizr
+workspace {
+    model {
+        // تعريف الـ Containers
+        webApp = container "Web App" "تطبيق الواجهة" "React/Blazor"
+        api = container "API" "واجهة الخدمات" "ASP.NET Core"
+        db = container "Database" "قاعدة البيانات" "SQL Server"
+
+        webApp -> api "يستدعي" "HTTP/REST"
+        api -> db "يقرأ/يكتب" "EF Core"
+    }
+    views {
+        container api "Containers" {
+            include *
+            autolayout
+        }
+    }
+}
+```
+
+#### Component Diagram (C3) — اختياري
+[للمكونات الحرجة فقط — يحددها Depth Assessment]
+```
+
+> **ملاحظة:** كود Structurizr DSL أعلاه هو示例 (illustrative). يكتب المُهندس الـ DSL الفعلي حسب كل مشروع. مصدر الحقيقة هو ملف `.dsl` وليس الـ diagram المُولّد.
+
+---
+
+## 39. Architecture Decision Seeds (ADR Seeds) — قسم في APPLICATION_BLUEPRINT.md
+
+هذا القسم يُدرج في `APPLICATION_BLUEPRINT.md` في جميع مستويات العمق.
+
+```markdown
+### Architecture Decision Seeds
+
+سجل القرارات المعمارية التي تم تحديدها خلال هذه المرحلة. هذه **بذور قرارات** وليست قرارات نهائية.
+
+| # | العنوان | السياق | الخيار المقترح | Tradeoffs | الحالة |
+|---|----------|--------|---------------|-----------|--------|
+| 1 | [Title] | [Context of the decision] | [Candidate option] | [Performance, maintainability, cost, ...] | `[ADR-Seed]` |
+| 2 | [Title] | [Context of the decision] | [Candidate option] | [Tradeoffs] | `[ADR-Seed]` |
+```
+
+---
+
+## 40. Domain Events Map — قسم في APPLICATION_BLUEPRINT.md
+
+هذا القسم اختياري، يُدرج في `APPLICATION_BLUEPRINT.md` عند `Domain Complexity ≥ High` أو `Uncertainty ≥ High`.
+
+```markdown
+### Domain Events Map / Event Storming Results
+
+#### Domain Events (الأحداث)
+| الحدث | المشغّل (Command) | الفاعل (Actor) | المصدر (Aggregate) | ملاحظات |
+|-------|-------------------|----------------|-------------------|---------|
+| [Event Name] | [Command that triggers it] | User / System / External | [Aggregate name] | [Notes] |
+
+#### Commands (الأوامر)
+| الأمر | النتيجة | الـ Actor المنفذ | صلاحية الوصول |
+|-------|---------|-----------------|--------------|
+| [Command] | [Resulting event(s)] | [Role] | [Permission level] |
+
+#### Key Aggregates (الكيانات الرئيسية)
+| الكيان | وصف | الأحداث المرتبطة |
+|--------|-----|------------------|
+| [Aggregate] | [Description] | [Events] |
+```
+
+---
+
+## 41. CONTENT_REQUIREMENTS.md — مخرج Content Confirmation Gate (SCP-2026-08-15-016)
+
+> **مشروط:** يُنتَج فقط عندما يكون Content Type = `User-Facing Content` / `Mixed` (موقع، صفحة هبوط، تسويق، محتوى).
+> **المالك:** مُهندس — بعد `07_SCREENS_AND_UI_STRUCTURE.md` وقبل التصميم النهائي (28) وقبل Phase 5.
+> **القاعدة:** لا يُخترع محتوى بدل المالك؛ كل قرار محتوى يُوثق في `CLIENT_DECISION_LOG.md`؛ الاعتراض يُعالج في الشاشة المعنية فقط.
+
+```markdown
+# CONTENT_REQUIREMENTS.md
+
+> **المشروع:** [Name]
+> **Content Type:** User-Facing Content / Mixed
+> **أعدّه:** مُهندس (Content Confirmation Gate)
+> **التاريخ:** YYYY-MM-DD
+> **الحالة:** [Draft / Approved]
+
+## لكل شاشة/صفحة
+
+| الشاشة | Purpose | Audience | Primary Message | Required Content | CTA | Forbidden | Claims المسموحة | Priorities | Content Owner |
+|--------|---------|----------|-----------------|------------------|-----|-----------|-----------------|------------|---------------|
+| S1 [Home] | [الغرض] | [الجمهور] | [الرسالة الأساسية] | [المحتوى المطلوب] | [CTA ووجهته] | [الممنوع — D-015] | [الادعاءات المسموحة] | [الأولويات] | [المالك] |
+| S2 [How It Works] | ... | ... | ... | ... | ... | ... | ... | ... | ... |
+| ... | ... | ... | ... | ... | ... | ... | ... | ... | ... |
+
+## قرارات المحتوى المعتمدة
+
+| # | الشاشة | القرار | المصدر | الحالة |
+|---|--------|--------|--------|--------|
+| 1 | [Screen] | [Decision] | `[Confirmed by Majed]` | Approved |
+```