@tera-system/pro 0.1.4 → 0.2.0

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

@@ -1,376 +0,0 @@
-# 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 |
-```