@tera-system/core 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (161) hide show
  1. package/LICENSE.md +13 -0
  2. package/MANIFEST.json +24 -0
  3. package/README.md +67 -0
  4. package/RELEASES.md +28 -0
  5. package/WELCOME.md +35 -0
  6. package/agents/application-blueprint.md +407 -0
  7. package/agents/auditor.md +665 -0
  8. package/agents/design-reviewer.md +392 -0
  9. package/agents/domain-expert-agent.md +510 -0
  10. package/agents/domain-research-agent.md +360 -0
  11. package/agents/engineering-agent-dotnet.md +218 -0
  12. package/agents/engineering-agent-phaser.md +275 -0
  13. package/agents/engineering-agent-typescript.md +300 -0
  14. package/agents/engineering-agent.md +143 -0
  15. package/agents/monitor.md +395 -0
  16. package/agents/production-erp-expert.md +506 -0
  17. package/agents/project-knowledge-agent.md +271 -0
  18. package/agents/qa-agent.md +498 -0
  19. package/agents/tera-business-transformation-consultant.md +290 -0
  20. package/agents/tera-client-engagement.md +891 -0
  21. package/agents/tera-software-designer.md +237 -0
  22. package/agents/tera-strategic-advisor.md +325 -0
  23. package/agents/tera-system-evolution.md +759 -0
  24. package/agents/tera.md +520 -0
  25. package/agents/ui-designer.md +426 -0
  26. package/commands/tera-approve.md +34 -0
  27. package/commands/tera-diagnose.md +47 -0
  28. package/commands/tera-gate.md +40 -0
  29. package/commands/tera-help.md +41 -0
  30. package/commands/tera-new-project.md +35 -0
  31. package/commands/tera-plan.md +34 -0
  32. package/commands/tera-request-build.md +45 -0
  33. package/commands/tera-resume.md +34 -0
  34. package/commands/tera-review.md +52 -0
  35. package/commands/tera-status.md +38 -0
  36. package/commands/tera-update.md +48 -0
  37. package/core/project-control/templates/TASK_TEMPLATE.md +146 -0
  38. package/core/tera-system/AGENT_ACTIVATION_MATRIX.md +285 -0
  39. package/core/tera-system/AGENT_DEPENDENCY_MAP.md +117 -0
  40. package/core/tera-system/AGENT_GENERATION_TEMPLATE.md +312 -0
  41. package/core/tera-system/AGENT_PERMISSION_MODEL.md +343 -0
  42. package/core/tera-system/AIS_PROTOCOL.md +191 -0
  43. package/core/tera-system/TERA_AGENT_CONDUCT.md +102 -0
  44. package/core/tera-system/TERA_CONTINUOUS_IMPROVEMENT_POLICY.md +111 -0
  45. package/core/tera-system/TERA_DISTRIBUTION_POLICY.md +291 -0
  46. package/core/tera-system/TERA_PROJECT_DECISION.md +281 -0
  47. package/core/tera-system/TERA_USER_GUIDE.md +462 -0
  48. package/core/tera-system/TOOLING_AND_MCP_POLICY.md +285 -0
  49. package/core/tera-system/TeraApplicationQuestionBank.md +362 -0
  50. package/core/tera-system/TeraArchitectureMap.md +91 -0
  51. package/core/tera-system/TeraClientPolicy.md +366 -0
  52. package/core/tera-system/TeraHelperAgents.md +970 -0
  53. package/core/tera-system/TeraPolicyMap.md +131 -0
  54. package/core/tera-system/TeraPreExecutionGate.md +818 -0
  55. package/core/tera-system/TeraPreparationDocumentationGovernance.md +370 -0
  56. package/core/tera-system/TeraPricingPolicy.md +674 -0
  57. package/core/tera-system/TeraProjectIntakePolicy.md +164 -0
  58. package/core/tera-system/TeraScenarioStressTests.md +168 -0
  59. package/core/tera-system/TeraSubAgents.md +854 -0
  60. package/core/tera-system/TeraSystemMaintenanceChecklist.md +80 -0
  61. package/core/tera-system/TeraTokenPolicy.md +362 -0
  62. package/core/tera-system/Tera_Project_Preparation_Files.md +1045 -0
  63. package/core/tera-system/agent-helpers/application-blueprint-details.md +177 -0
  64. package/core/tera-system/client-helpers/tera-client-engagement-discovery-domains.md +99 -0
  65. package/core/tera-system/client-helpers/tera-client-engagement-gates.md +258 -0
  66. package/core/tera-system/client-helpers/tera-client-engagement-pricing.md +341 -0
  67. package/core/tera-system/client-helpers/tera-client-engagement-protocols.md +692 -0
  68. package/core/tera-system/consulting-helpers/BTCA_METHODOLOGY_FRAMEWORK.md +195 -0
  69. package/core/tera-system/consulting-helpers/BTCA_REPORT_TEMPLATES.md +266 -0
  70. package/core/tera-system/design-system/ACCESSIBILITY_RULES.md +31 -0
  71. package/core/tera-system/design-system/COMPONENT_LIBRARY_SCHEMA.md +46 -0
  72. package/core/tera-system/design-system/DESIGN_MD_INTEGRATION.md +59 -0
  73. package/core/tera-system/design-system/DESIGN_REVIEW_STANDARDS.md +241 -0
  74. package/core/tera-system/design-system/DESIGN_SOURCE_PROTOCOL.md +61 -0
  75. package/core/tera-system/design-system/DESIGN_SYSTEM_OVERVIEW.md +66 -0
  76. package/core/tera-system/design-system/DESIGN_TOKENS_SCHEMA.md +66 -0
  77. package/core/tera-system/design-system/EXTERNAL_REFERENCE_ANALYSIS.md +52 -0
  78. package/core/tera-system/design-system/FIGMA_INTEGRATION.md +138 -0
  79. package/core/tera-system/design-system/INTERNAL_KITS_INDEX.md +26 -0
  80. package/core/tera-system/design-system/LAYOUT_PATTERNS.md +52 -0
  81. package/core/tera-system/design-system/MOBILE_UI_UX_STANDARDS.md +342 -0
  82. package/core/tera-system/design-system/RTL_LTR_RULES.md +39 -0
  83. package/core/tera-system/design-system/UI_ACCEPTANCE_GATE.md +80 -0
  84. package/core/tera-system/design-system/kits/KIT_ADMIN_DASHBOARD.md +102 -0
  85. package/core/tera-system/engineering-governance/ENGINEERING_AGENT_RESPONSIBILITIES.md +210 -0
  86. package/core/tera-system/engineering-governance/ENGINEERING_BEST_PRACTICES.md +468 -0
  87. package/core/tera-system/engineering-governance/ENGINEERING_GOVERNANCE_GATE.md +131 -0
  88. package/core/tera-system/engineering-governance/ENGINEERING_REVIEW_CHECKLIST.md +129 -0
  89. package/core/tera-system/engineering-governance/QUALITY_GATE_THRESHOLDS.md +159 -0
  90. package/core/tera-system/engineering-helpers/engineering-agent-core.md +171 -0
  91. package/core/tera-system/knowledge-base/OPENHANDS_ARCHITECTURE_REFERENCE.md +243 -0
  92. package/core/tera-system/knowledge-base/manufacturing/00_INDEX.md +32 -0
  93. package/core/tera-system/knowledge-base/manufacturing/01_MANUFACTURING_ERP_CORE_CONCEPTS.md +7 -0
  94. package/core/tera-system/knowledge-base/manufacturing/02_SAP_MANUFACTURING_RESEARCH.md +7 -0
  95. package/core/tera-system/knowledge-base/manufacturing/03_DYNAMICS_365_MANUFACTURING_RESEARCH.md +7 -0
  96. package/core/tera-system/knowledge-base/manufacturing/04_ORACLE_MANUFACTURING_RESEARCH.md +7 -0
  97. package/core/tera-system/knowledge-base/manufacturing/05_ODOO_MANUFACTURING_RESEARCH.md +7 -0
  98. package/core/tera-system/knowledge-base/manufacturing/06_ERPNEXT_MANUFACTURING_RESEARCH.md +7 -0
  99. package/core/tera-system/knowledge-base/manufacturing/07_MANUFACTURING_COSTING_GUIDE.md +7 -0
  100. package/core/tera-system/knowledge-base/manufacturing/08_PRODUCTION_DISCOVERY_QUESTIONS.md +7 -0
  101. package/core/tera-system/knowledge-base/manufacturing/09_MANUFACTURING_BLUEPRINT_CHECKLIST.md +7 -0
  102. package/core/tera-system/knowledge-base/manufacturing/10_PRODUCTION_TEST_SCENARIOS.md +7 -0
  103. package/core/tera-system/knowledge-base/manufacturing/11_QUALITY_REWORK_AND_SCRAP_GUIDE.md +7 -0
  104. package/core/tera-system/knowledge-base/manufacturing/12_MRP_AND_PLANNING_GUIDE.md +7 -0
  105. package/core/tera-system/knowledge-base/manufacturing/13_LOCAL_AND_REGIONAL_MANUFACTURING_CONTEXT.md +7 -0
  106. package/core/tera-system/knowledge-base/manufacturing/14_VENDOR_COMPARISON_MATRIX.md +7 -0
  107. package/core/tera-system/product-standards/maintenance-apps/BEST_PRACTICES_DOMAIN.md +325 -0
  108. package/core/tera-system/product-standards/maintenance-apps/STANDARD_DEFINITION.md +142 -0
  109. package/core/tera-system/profiles/PROFILES_INDEX.md +57 -0
  110. package/core/tera-system/profiles/TEMPLATE.md +47 -0
  111. package/core/tera-system/profiles/dotnet-blazor-ef.md +76 -0
  112. package/core/tera-system/profiles/dotnet-razorpages-adonet.md +137 -0
  113. package/core/tera-system/profiles/dotnet-wpf-sqlite.md +159 -0
  114. package/core/tera-system/profiles/effect-bun-opencode.md +109 -0
  115. package/core/tera-system/profiles/flutter-mobile.md +369 -0
  116. package/core/tera-system/profiles/nextjs-prisma.md +110 -0
  117. package/core/tera-system/profiles/phaser-react-node.md +302 -0
  118. package/core/tera-system/profiles/react-pwa.md +97 -0
  119. package/core/tera-system/runtime/CLIENT_DISCOVERY_PROTOCOL.md +145 -0
  120. package/core/tera-system/runtime/DOMAIN_INTELLIGENCE_PROTOCOL.md +124 -0
  121. package/core/tera-system/runtime/MVP_DEFINITION_PROTOCOL.md +176 -0
  122. package/core/tera-system/runtime/TERA_RUNTIME_CHECKLISTS.md +646 -0
  123. package/core/tera-system/runtime/TERA_RUNTIME_PROTOCOLS.md +50 -0
  124. package/core/tera-system/runtime/TERA_RUNTIME_PROTOCOLS_CLIENT.md +355 -0
  125. package/core/tera-system/runtime/TERA_RUNTIME_PROTOCOLS_CORE.md +799 -0
  126. package/core/tera-system/runtime/TERA_RUNTIME_TEMPLATES.md +908 -0
  127. package/core/tera-system/runtime/TERA_RUNTIME_TEMPLATES_DELIVERY.md +584 -0
  128. package/core/tera-system/runtime/TERA_RUNTIME_TEMPLATES_PREPARATION.md +376 -0
  129. package/core/tera-system/runtime/TERA_SOLUTION_PREPARATION_PROTOCOL.md +335 -0
  130. package/core/tera-system/runtime/TERA_SOLUTION_PREPARATION_TEMPLATES.md +397 -0
  131. package/core/tera-system/runtime/VERSION_LIFECYCLE_PROTOCOL.md +296 -0
  132. package/core/tera-system/semgrep-rules/README.md +32 -0
  133. package/core/tera-system/semgrep-rules/tera-security.yml +66 -0
  134. package/core/tera-system/semgrep-rules/tera-standards.yml +49 -0
  135. package/core/tera-system/teranoo-ui/README.md +48 -0
  136. package/core/tera-system/teranoo-ui/components/button.tsx +51 -0
  137. package/core/tera-system/teranoo-ui/components/card.tsx +49 -0
  138. package/core/tera-system/teranoo-ui/components/dashboard-layout.tsx +36 -0
  139. package/core/tera-system/teranoo-ui/components/data-table.tsx +146 -0
  140. package/core/tera-system/teranoo-ui/components/empty-state.tsx +31 -0
  141. package/core/tera-system/teranoo-ui/components/kpi-card.tsx +42 -0
  142. package/core/tera-system/teranoo-ui/components/page-header.tsx +25 -0
  143. package/core/tera-system/teranoo-ui/components/search-input.tsx +40 -0
  144. package/core/tera-system/teranoo-ui/components/sidebar.tsx +66 -0
  145. package/core/tera-system/teranoo-ui/components/stats-card.tsx +37 -0
  146. package/core/tera-system/teranoo-ui/registry.json +77 -0
  147. package/core/tera-system/teranoo-ui/styles/teranoo-theme.css +61 -0
  148. package/opencode.tera.example.json +30 -0
  149. package/package.json +37 -0
  150. package/scripts/build.mjs +110 -0
  151. package/scripts/install.js +244 -0
  152. package/scripts/lib/license.mjs +90 -0
  153. package/scripts/lib/public-key.pem +3 -0
  154. package/scripts/tera-license.mjs +63 -0
  155. package/tools/tera-clean.ps1 +97 -0
  156. package/tools/tera-fetch.ps1 +165 -0
  157. package/tools/tera-release.ps1 +96 -0
  158. package/tools/tera-schedule.ps1 +59 -0
  159. package/tools/tera-update.ps1 +472 -0
  160. package/tools/tera-watch.ps1 +154 -0
  161. package/tools/update-client-repositories.ps1 +92 -0
@@ -0,0 +1,341 @@
1
+ ---
2
+ description: TCEA pricing workflow, tools, reference sources, and client document library.
3
+ ---
4
+ # TCEA Pricing & Operations — ملف المساعد التسعيري والمرجعي
5
+
6
+ > **اقرأني فقط عندما:** تحتاج تنفيذ تسعير (Level 1/Level 2)، أو التحقق من أداة/قالب/مصدر مرجعي، أو إدارة وثائق العميل.
7
+ >
8
+ > **لا تقرأني:** في بداية Session أو أثناء Discovery.
9
+ >
10
+ > **إظهار تأكيد القراءة:** فقط إذا كانت الجلسة Audit/Debug، أو طلب Majed ذلك صراحة، أو كان القرار عالي الأثر. مثال عند الحاجة فقط: "📖 قرأت pricing.md — القسم [اسم القسم]"
11
+
12
+ ---
13
+
14
+ ## A.8 سير عمل التسعير (Pricing Workflow) — إلزامي لكل مشروع
15
+
16
+ ### ⚠️ تنبيه إلزامي — اقرأ قبل كل استخدام
17
+
18
+ ```text
19
+ قبل إنتاج أي سعر لمشروع جديد، يجب عليك:
20
+ 1. تأكد أنك قرأت TeraPricingPolicy.md في هذه Session (راجع C.4 في الملف الرئيسي — Runtime Load Order)
21
+ 2. اقرأ المثال التطبيقي لـ Scorecard (يُنشأ عند أول عميل فعلي — أُزيل مثال العملاء التجريبيين 2026-08-15)
22
+ 3. استخدم حاسبة Excel: project-control/TeraPricingCalculator.xlsx
23
+ 4. طبّق قائمة الاعتماد (14 سؤالاً) من المصدر الأصلي في TeraPricingPolicy.md §29
24
+ 5. اقرأ TRAINING_GUIDE_TCEA.md فقط عند ظهور تحذير Proportion Check — وإلا لا تقرأه (الخطوات العشر موجودة أدناه في Level 2)
25
+
26
+ إذا لم تقم بهذه الخطوات، فأنت تخالف سياسة التسعير المعتمدة.
27
+ ```
28
+
29
+ ### A.8.1 المبادئ — حدود دورك
30
+
31
+ - **أنت تنتج مسودات فقط.** Majed يعتمد السعر النهائي.
32
+ - **3 مستويات** للإخراج (انظر A.8.2). لا يصدر عرض سعر رسمي من أول مقابلة أبداً.
33
+ - **TeraPricingPolicy.md** هي السياسة الوحيدة المعتمدة. **الحاسبة** (Excel) هي الأداة الوحيدة المعتمدة — لا تحسب يدوياً.
34
+
35
+ ### A.8.2 مراحل إخراج السعر
36
+
37
+ | المستوى | المسمى | الصلاحية | متى |
38
+ |---------|--------|---------|-----|
39
+ | **Level 1** | تقدير مبدئي (Preliminary Estimate) | غير ملزم — نطاق سعري تقريبي فقط، وليس عرض سعر | بعد أول مقابلة أو Discovery أولي |
40
+ | **Level 2** | مسودة عرض سعر (Draft Quotation) | مسودة — يحتاج اعتماد Majed | بعد توثيق النطاق + استخدام الحاسبة |
41
+ | **Level 3** | عرض سعر رسمي (Official Quotation) | ملزم بعد اعتماد Majed | بعد اعتماد Level 2 |
42
+
43
+ ### A.8.3 شروط البدء والمنع — متى تسعر ومتى لا
44
+
45
+ #### شروط Level 1 — التقدير المبدئي غير الملزم
46
+
47
+ 1. ✅ توجد معلومات أولية كافية من Majed لفهم نوع المشروع وحجمه التقريبي
48
+ 2. ✅ يُذكر صراحة أن الناتج **Range تقريبي فقط** وليس عرض سعر أو التزاماً مالياً
49
+ 3. ✅ لا يُستخدم Level 1 كبديل عن Discovery الكامل أو عن DRAFT_QUOTATION
50
+
51
+ **Level 1 لا يحتاج:** B.1 / B.2 / B.3 / B.4 / الحاسبة
52
+
53
+ #### شروط Level 2 — مسودة عرض السعر
54
+
55
+ 1. ✅ قرأت `TeraPricingPolicy.md` في هذه الـ Session (إلزامي — C.4)
56
+ 2. ✅ توفرت المعلومات المطلوبة حسب `TeraPricingPolicy.md §2` (10 بنود)
57
+ 3. ✅ اكتمل Discovery Coverage Gate (B.1) بدرجة PASS
58
+ 4. ✅ اكتمل Budget-to-Scope Control Rule (B.2)
59
+ 5. ✅ اكتمل Final Scope Reconciliation Gate (B.3)
60
+ 6. ✅ اكتمل Quotation Readiness Gate (B.4)
61
+ 7. ✅ الأداة الوحيدة المعتمدة للتسعير: `TeraPricingCalculator.xlsx`
62
+
63
+ #### شروط المنع — متى لا تنتج Level 1 أو Level 2
64
+
65
+ 1. ❌ إذا كانت المعلومات الأولية ضعيفة جداً حتى على مستوى Range تقريبي → **لا تنتج Level 1**. اطلب Clarifications أولاً.
66
+ 2. ❌ نقص أي بند من الـ 10 بنود في السياسة §2 → **لا تنتج Level 2**. اعرض تحليلاً مدفوعاً أو اطلب استكمال المعلومات.
67
+ 3. ❌ Discovery Gate لم يمر (B.1) → **لا تنتج Level 2**. أكمل الاستكشاف أولاً.
68
+ 4. ❌ Budget-to-Scope غير موثق (B.2) → **لا تنتج Level 2**. وثّق قرار الميزانية مع Majed.
69
+ 5. ❌ Final Scope Reconciliation لم يمر (B.3) → **لا تنتج Level 2**.
70
+ 6. ❌ Quotation Readiness لم يمر (B.4) → **لا تنتج Level 2**.
71
+ 7. ❌ لم تقرأ السياسة في هذه الـ Session → **لا تنتج Level 2**. اقرأ `TeraPricingPolicy.md` أولاً.
72
+ 8. ❌ أي جواب بـ "لا" في قائمة الاعتماد (السياسة §29) → **لا ترسل العرض**.
73
+
74
+ ### A.8.4 المخرجات المطلوبة لكل Level
75
+
76
+ #### Level 1 — تقدير مبدئي (غير ملزم)
77
+
78
+ ```
79
+ 1. اجمع المعلومات الأساسية من Majed (فكرة التطبيق، نوعه، عدد الشاشات، المستخدمون، التكاملات)
80
+ 2. صنّف المشروع (صغير/متوسط/معقد/غامض)
81
+ 3. أنتج تقديراً مبدئياً غير ملزم (نطاق سعري، ليس سعراً محدداً)
82
+ ```
83
+
84
+ **تحذير إلزامي في Level 1:**
85
+ > هذا **تقدير مبدئي غير ملزم** وليس عرض سعر. لا يعتمد على Discovery مكتمل أو الحاسبة أو B.1/B.2/B.4، وقد يتغير بعد التحليل الكامل.
86
+
87
+ **مثال صحيح:**
88
+ > "حسب المعلومات الأولية، المشروع يبدو ضمن نطاق 400 إلى 700 دينار، لكن السعر النهائي يحتاج تحليل نطاق واستخدام الحاسبة."
89
+
90
+ #### Level 2 — مسودة عرض سعر ← خطوة إلزامية
91
+
92
+ ⚠️ **اتبع هذه الخطوات العشر بالترتيب عند إنتاج Level 2 Draft Quotation — لا تبتكر خطوات إضافية ولا تتخطَ خطوة:**
93
+
94
+ 1. **تأكد من توفر المعلومات** — راجع TeraPricingPolicy.md §2 (10 بنود). أي بند ناقص؟ لا تسعر.
95
+ 2. **افتح حاسبة Excel** — `project-control/TeraPricingCalculator.xlsx`
96
+ 3. **املأ معلومات المشروع** — اسم المشروع، اسم العميل، التاريخ
97
+ 4. **قيّم العوامل 12** — استخدم Rubric التقييم (TeraPricingPolicy.md §5). أدخل الدرجات 0–5 لكل عامل. أي عامل بدرجة 5 يتطلب مراجعة إلزامية.
98
+ 5. **اختر المضاعفات** — المنصة (Web/Mobile/PWA)، اللغة، هامش المخاطر، بدل الاستعجال
99
+ 6. **أضف الإضافات** — حدد مستوى كل Add-on. ⚠️ قاعدة التناسب: مجموع Add-ons ≤ 50% من Base Price
100
+ 7. **أدخل الساعات المقدرة** — السعر المعتمد لا يقل عن: الساعات × 4 JOD
101
+ 8. **اقرأ النتيجة** — السعر المعتمد النهائي + فحص التناسب + تصنيف السعر
102
+ 9. **استخدم قائمة الاعتماد** — TeraPricingPolicy.md §29 (14 سؤالاً) — جميع الإجابات "نعم" إلزامياً
103
+ 10. **املأ قالب الخطاب الرسمي** — `letterhead-master-fixed-print.html` معبأ ببيانات المشروع والسعر
104
+
105
+ ⚠️ لا تحاول حساب السعر يدوياً — الحاسبة هي الأداة الوحيدة المعتمدة.
106
+
107
+ المخرجات الإلزامية لـ Level 2:
108
+
109
+ | # | المخرج | الوصف |
110
+ |:-:|--------|-------|
111
+ | 1 | `DRAFT_QUOTATION.md` في `client-engagement/<CLIENT>/` | مسودة عرض السعر كاملة |
112
+ | 2 | قائمة الاعتماد (14 سؤالاً) | املأها من `TeraPricingPolicy.md §29` — **يجب أن تكون جميع الإجابات "نعم"** قبل الرفع لـ Majed |
113
+ | 3 | قالب الخطاب الرسمي | `letterhead-master-fixed-print.html` — معبأ ببيانات العرض |
114
+ | 4 | الحاسبة | `TeraPricingCalculator.xlsx` — محدثة ومرفقة مع العرض |
115
+
116
+ **تحذير:** لا تحاول حساب السعر يدوياً. الحاسبة هي الأداة الوحيدة المعتمدة.
117
+
118
+ #### Level 3 — عرض سعر رسمي
119
+
120
+ ```
121
+ 1. بعد اعتماد Majed لـ Level 2
122
+ 2. أنتج العرض الرسمي النهائي في قالب الخطاب الرسمي: letterhead-master-fixed-print.html
123
+ 3. سجّل السعر النهائي في CLIENT_DECISION_LOG.md
124
+ 4. أرسل للعميل عبر Majed
125
+ ```
126
+
127
+ ### A.8.5 الأدوات والملفات المرجعية
128
+
129
+ | الأداة | الموقع | الاستخدام |
130
+ |--------|--------|-----------|
131
+ | حاسبة Excel | `project-control/TeraPricingCalculator.xlsx` | إلزامي — حساب السعر (تدخل الدرجات ويطلع السعر) |
132
+ | قالب الخطاب الرسمي | `tera-workshop/client-templates/branding/letterhead-master-fixed-print.html` | **إلزامي — لكل مراسلة رسمية للزبون (عروض، عقود، خطابات)** |
133
+ | دليل التدريب | `project-control/TRAINING_GUIDE_TCEA.md` | مرجع تدريب فقط — لا يُقرأ افتراضياً. يُستدعى فقط عند تحذير Proportion Check |
134
+ | مثال تطبيقي | (يُنشأ عند أول عميل فعلي — أُزيل مثال العملاء التجريبيين 2026-08-15) | عند الحاجة يُنشأ مثال Scorecard تطبيقي جديد |
135
+
136
+ ---
137
+
138
+ ## C.1 الملفات التي تديرها
139
+
140
+ ```text
141
+ clients/CLIENT-*/applications/APP-*/client-engagement/
142
+ ├── CLIENT_INTAKE.md ← معلومات الزبون الأساسية + حالة تأكيد الفهم
143
+ ├── DISCOVERY_COVERAGE_SUMMARY.md ← تغطية المجالات الـ 13 + قرار الجاهزية (استخدم القالب §35 من TERA_RUNTIME_TEMPLATES.md)
144
+ ├── CLIENT_BRIEF.md ← ملخص المشروع (للمشاريع الصغيرة)
145
+ ├── SCOPE_SUMMARY.md ← ملخص النطاق (للمشاريع المتوسطة)
146
+ ├── FEATURE_LIST.md ← قائمة الميزات (للمشاريع المتوسطة+)
147
+ ├── DRAFT_QUOTATION.md ← مسودة عرض السعر (Level 2)
148
+ ├── TERA_HANDOFF_PACKAGE.md ← حزمة التسليم لـ Tera
149
+ ├── CLIENT_DECISION_LOG.md ← سجل القرارات
150
+ └── CHANGE_REQUEST_LOG.md ← سجل طلبات التغيير
151
+ ```
152
+
153
+ - مجلد `client-engagement/` يُنشأ فقط عند وجود تطبيق عميل فعلي أو بطلب صريح من Majed
154
+ - مجلد `client-documents/` داخل التطبيق للنسخ المعبأة من وثائق الزبون (يُنشأ عند الحاجة)
155
+ - كل الوثائق مسودات (Draft-only) حتى موافقة Majed
156
+ - إذا كانت حالة فهم المشروع غير مؤكدة، تبقى كل ملفات النطاق غير قابلة للاعتماد حتى بعد إنشائها كمسودات.
157
+ - إذا لم يوجد `DISCOVERY_COVERAGE_SUMMARY.md` مع قرار معتمد، لا تعتبر ملفات النطاق أو التسعير أو الهاندوف baseline.
158
+ - **قاعدة اتساق الاعتماد:** `TERA_HANDOFF_PACKAGE.md` تأخذ حالة أقل ملف مصدر. لا يمكن أن تكون `Approved` إذا أي ملف من (CLIENT_INTAKE.md, SCOPE_SUMMARY.md, FEATURE_LIST.md, DRAFT_QUOTATION.md, CLIENT_DECISION_LOG.md) لا يزال `Draft` أو `Pending Approval`.
159
+
160
+ ---
161
+
162
+ ## C.2 مصدر الأسئلة
163
+
164
+ استخدم `tera-system/TeraApplicationQuestionBank.md` كمرجع أساسي للأسئلة، وأضف أسئلة استشارية/تجارية إضافية حسب الموقف.
165
+
166
+ ---
167
+
168
+ ## C.3 المصادر المرجعية
169
+
170
+ ### إلزامي — اقرأ عند كل Session من TCEA
171
+
172
+ - هذا الملف (`.opencode/agents/tera-client-engagement.md`) — مصدر الحقيقة لدورك — اقرأه في أول رد بعد التشغيل
173
+ - `tera-system/TeraPricingPolicy.md` — سياسة التسعير v4.2 — اقرأه في أول مهمة Pricing داخل كل Session
174
+ - `tera-system/TERA_CONTINUOUS_IMPROVEMENT_POLICY.md` — سياسة التحسين المستمر — اقرأه في أول Session
175
+
176
+ ### للتسعير — عند بدء أول مهمة Pricing داخل Session (إلزامي)
177
+
178
+ - `project-control/TeraPricingCalculator.xlsx` — حاسبة التسعير (Excel) — الأداة الوحيدة المعتمدة — افتحه عند Level 2
179
+ - (مثال Scorecard التطبيقي أُزيل مع العملاء التجريبيين 2026-08-15) — عند أول عميل فعلي يُنشأ مثال جديد
180
+ - `project-control/TRAINING_GUIDE_TCEA.md` — دليل التدريب — مرجع تدريب فقط، لا يُقرأ افتراضياً. يُستدعى فقط عند خطأ في الحاسبة أو تحذير Proportion Check (الخطوات العشر موجودة في هذا الملف — pricing.md — Level 2)
181
+
182
+ ### مرجعي — يُفتح فقط عند الوصول إلى Trigger محدد
183
+
184
+ | الملف | متى يُقرأ |
185
+ |-------|-----------|
186
+ | `tera-system/TeraApplicationQuestionBank.md` | عند بدء Discovery — اقرأه قبل صياغة أول سؤال لـ Majed |
187
+ | `tera-system/TeraClientPolicy.md` | عند أول تعامل مع عميل جديد في Session — اقرأه قبل إنتاج CLIENT_INTAKE.md |
188
+ | `tera-system/runtime/TERA_RUNTIME_TEMPLATES.md` | عند إنتاج DISCOVERY_COVERAGE_SUMMARY.md — اقرأ §35 فقط |
189
+
190
+ ### قوالب — للمراسلات والوثائق
191
+
192
+ - `tera-workshop/client-templates/branding/letterhead-master-fixed-print.html` — قالب الخطاب الرسمي (إلزامي لكل مراسلة للزبون)
193
+ - `tera-workshop/client-templates/branding/` — قوالب العلامة التجارية (شعارات، هيدر، فوتر)
194
+ - `tera-workshop/` — قوالب الوثائق الأخرى (للقراءة فقط)
195
+
196
+ ---
197
+
198
+ ## C.6 مكتبة وثائق الزبون (Client Document Library)
199
+
200
+ ### C.6.1 المبادئ
201
+
202
+ - **مكتبة وثائق رسمية** — ليست قائمة إلزامية لكل مشروع.
203
+ - **كل نموذج له Trigger** — يُستخدم عند الحاجة، ليس تلقائياً.
204
+ - **TCEA يملأ المسودات** — Majed يعتمد النهائي.
205
+ - **الوثائق القانونية** تحتاج مراجعة قانونية عند الاستخدام الرسمي.
206
+ - القوالب المصدرية موجودة في `tera-workshop/client-templates/`.
207
+
208
+ ### C.6.2 التصنيف والمجلدات
209
+
210
+ | الفئة | المسار | الوصف |
211
+ |-------|--------|-------|
212
+ | ما قبل التعاقد | `client-templates/pre-contract/` | نماذج فهم العميل والتطبيق قبل السعر والعقد |
213
+ | العروض التجارية والفنية | `client-templates/commercial/` | نماذج العرض والسعر والنطاق |
214
+ | التعاقد والتنفيذ | `client-templates/contractual/` | العقود واتفاقيات الدعم وإدارة التغيير |
215
+ | التسليم والإغلاق | `client-templates/handover/` | نماذج التسليم والإغلاق ورضا العميل |
216
+
217
+ ### C.6.3 مصفوفة تفعيل النماذج (Activation Matrix)
218
+
219
+ #### أ. ما قبل التعاقد
220
+
221
+ | النموذج | Trigger | يملؤه | يعتمده | داخلي/خارجي | توقيع؟ | مراجعة قانونية؟ |
222
+ |---------|---------|-------|--------|:-----------:|:------:|:---------------:|
223
+ | `CLIENT_INTAKE_FORM` | بداية أي علاقة | TCEA | Majed | داخلي | لا | لا |
224
+ | `MEETING_REPORT_TEMPLATE` | بعد الاجتماعات المهمة | TCEA | Majed (أو تلقائي) | داخلي | لا | لا |
225
+ | `NDA_TEMPLATE` | قبل مشاركة معلومات حساسة | TCEA | Majed + عميل | خارجي | نعم | نعم |
226
+ | `GAP_ANALYSIS_TEMPLATE` | تطوير نظام قائم أو ERP | TCEA | Majed | داخلي/خارجي | لا | لا |
227
+ | `RISK_REGISTER_TEMPLATE` | مشاريع معقدة | TCEA | Majed | داخلي | لا | لا |
228
+ | `USER_PERSONA_MATRIX_TEMPLATE` | عدة أنواع مستخدمين | TCEA | Majed | داخلي | لا | لا |
229
+
230
+ #### ب. العروض التجارية والفنية
231
+
232
+ | النموذج | Trigger | يملؤه | يعتمده | داخلي/خارجي | توقيع؟ | مراجعة قانونية؟ |
233
+ |---------|---------|-------|--------|:-----------:|:------:|:---------------:|
234
+ | `APPLICATION_PROPOSAL_TEMPLATE` | بعد الفهم الأولي — يحتاج العميل Proposal | TCEA | Majed | خارجي | لا | لا |
235
+ | `TECHNICAL_PROPOSAL_TEMPLATE` | مشاريع متوسطة/كبيرة | TCEA + Tera | Majed | خارجي | لا | لا |
236
+ | `QUOTATION_TEMPLATE` | أي مشروع | TCEA | Majed **إلزامي** | خارجي | لا | لا |
237
+ | `SCOPE_OF_WORK_TEMPLATE` | أي مشروع | TCEA + Tera | Majed | خارجي | نعم | مستحسن |
238
+ | `PROJECT_CHARTER_TEMPLATE` | مشاريع متوسطة/كبيرة | TCEA | Majed | داخلي | لا | لا |
239
+
240
+ #### ج. التعاقد والتنفيذ
241
+
242
+ | النموذج | Trigger | يملؤه | يعتمده | داخلي/خارجي | توقيع؟ | مراجعة قانونية؟ |
243
+ |---------|---------|-------|--------|:-----------:|:------:|:---------------:|
244
+ | `SOFTWARE_SERVICES_AGREEMENT_TEMPLATE` | عند التعاقد | TCEA (بيانات) | Majed + مختص قانوني | خارجي | نعم | **نعم** |
245
+ | `SLA_TEMPLATE` | عند وجود دعم/استضافة/صيانة | TCEA | Majed | خارجي | نعم | مستحسن |
246
+ | `CHANGE_REQUEST_FORM` | عند أي تغيير مؤثر في النطاق | TCEA | Majed + عميل | خارجي | نعم | لا |
247
+ | `STATUS_REPORT_TEMPLATE` | مشاريع متوسطة/كبيرة — دوري | TCEA | Majed | خارجي | لا | لا |
248
+
249
+ #### د. التسليم والإغلاق
250
+
251
+ | النموذج | Trigger | يملؤه | يعتمده | داخلي/خارجي | توقيع؟ | مراجعة قانونية؟ |
252
+ |---------|---------|-------|--------|:-----------:|:------:|:---------------:|
253
+ | `HANDOVER_REPORT_TEMPLATE` | عند التسليم | TCEA | Majed | خارجي | نعم | لا |
254
+ | `COMPLETION_CERTIFICATE_TEMPLATE` | عند إغلاق المشروع | TCEA | Majed + عميل | خارجي | نعم | لا |
255
+ | `CLIENT_SATISFACTION_SURVEY_TEMPLATE` | بعد التسليم | العميل يعبئها | — | خارجي | لا | لا |
256
+
257
+ ### C.6.4 القواعد
258
+
259
+ 1. **لا يُستخدم نموذج دون Trigger واضح** — النماذج ليست إلزامية تلقائياً لكل مشروع.
260
+ 2. **TCEA يملأ المسودات فقط** — أي نموذج يخرج للعميل يعتمده Majed أولاً.
261
+ 3. **النماذج القانونية الحساسة** (العقد، NDA، SLA): تمر على مختص قانوني قبل الاعتماد النهائي.
262
+ 4. **صيغة العمل:**
263
+ - القالب المصدر: HTML (عند Majed) أو MD (في `tera-workshop/client-templates/`)
264
+ - مسودة TCEA: **Markdown**
265
+ - العرض الرسمي: **PDF** (يولّده Majed من HTML أو غيره)
266
+ 5. **النسخة المعبأة** تحفظ في `clients/CLIENT-*/applications/APP-*/client-documents/` داخل المشروع.
267
+ 6. أي إضافة أو تعديل على النماذج يتطلب موافقة Majed.
268
+
269
+ ---
270
+
271
+ ## 🅱️ Track B: Product Pricing Models — نماذج تسعير المنتجات الجاهزة
272
+
273
+ > **الغرض:** هذه النماذج خاصة بـ **Track B (Product Implementation)** فقط. لا تُستخدم في Track A.
274
+ > **اقرأني:** عند بدء Pricing في Track B — بعد Fit-Gap Analysis وقبل إنتاج PRODUCT_QUOTATION.md.
275
+
276
+ ### المبادئ
277
+
278
+ 1. Track B Pricing يتكون من **3 مكونات أساسية**:
279
+ - **Product License/Subscription** — سعر المنتج نفسه (يُزوّده Majed)
280
+ - **Implementation Services** — خدمات التكوين والتهيئة (تقدير TCEA)
281
+ - **Ongoing Support (Retainer)** — دعم وصيانة دورية (تقدير TCEA)
282
+ 2. عناصر `Gap-Custom` (التخصيصات خارج المنتج) تُسعّر منفصلة بـ T&M.
283
+ 3. **النماذج ليست بديلاً عن TeraPricingPolicy.md** — السياسة العامة تبقى مرجع التسعير الأساسي.
284
+
285
+ ### نماذج التسعير لـ Track B
286
+
287
+ | النموذج | الوصف | متى يُستخدم | مسؤولية TCEA |
288
+ |---------|-------|:-----------:|:------------:|
289
+ | **Product License/Subscription** | سعر ترخيص أو اشتراك المنتج — يحدده Majed | كل مشروع Track B | يستلم السعر من Majed ويدرجه في PRODUCT_QUOTATION.md |
290
+ | **Implementation Fixed Price** | سعر ثابت لخدمات التكوين والتهيئة — يقدره TCEA بناءً على FIT_GAP_MATRIX.md | عندما يكون النطاق واضحاً (عدد Gap-Config معروف) | 🟢 يقدره TCEA بناءً على الجهد في Fit-Gap |
291
+ | **T&M (Time & Material)** | سعر بالساعة/اليوم للتخصيصات Gap-Custom | مشاريع مع Gap-Custom غير واضح النطاق | 🟢 يقدره TCEA ويضعه كبند منفصل |
292
+ | **Retainer (دوري)** | رسوم شهرية/سنوية للدعم والصيانة | مشاريع تحتاج دعم مستمر | 🟢 يقترحه TCEA ويقدره حسب مستوى الدعم |
293
+ | **Hybrid (مختلط)** | مزيج من Fixed + Retainer + T&M | الأكثر شيوعاً | 🟢 يصممه TCEA حسب طبيعة المشروع |
294
+
295
+ ### هيكل PRODUCT_QUOTATION.md لـ Track B
296
+
297
+ ```
298
+ # PRODUCT_QUOTATION — [اسم العميل]
299
+ ## 1. Product License/Subscription
300
+ | البند | المدة | السعر (JOD) |
301
+ |-------|:----:|:-----------:|
302
+ | [اسم المنتج] — ترخيص Enterprise | سنوي | [من Majed] |
303
+ | [عدد المستخدمين] × سعر المستخدم | سنوي | [من Majed] |
304
+
305
+ ## 2. Implementation Services (Fixed Price)
306
+ | البند | الجهد (أيام) | السعر (JOD) |
307
+ |-------|:-----------:|:-----------:|
308
+ | Phase B1 — Pre-Sales & Discovery | [عدد] | [السعر] |
309
+ | Phase B2 — Fit-Gap Analysis | [عدد] | [السعر] |
310
+ | Phase B3 — Solution Blueprint | [عدد] | [السعر] |
311
+ | Phase B4 — Build & Configure | [عدد] | [السعر] |
312
+ | الإجمالي | [عدد] | [السعر] |
313
+
314
+ ## 3. Custom Development (إن وُجد)
315
+ | RICEFW Item | الجهد (أيام) | النموذج | السعر (JOD) |
316
+ |:-----------:|:-----------:|:-------:|:-----------:|
317
+ | [اسم العنصر] | [عدد] | T&M / Fixed | [السعر] |
318
+
319
+ ## 4. Ongoing Support (Retainer)
320
+ | الخدمة | المدة | السعر الشهري (JOD) |
321
+ |-------|:----:|:-----------------:|
322
+ | دعم فني — [مستوى الدعم] | شهري | [السعر] |
323
+
324
+ ## 5. الإجمالي التقديري
325
+ | البند | الإجمالي (JOD) |
326
+ |-------|:--------------:|
327
+ | Product License | [من Majed] |
328
+ | Implementation Services | [تقدير TCEA] |
329
+ | Custom Development | [تقدير TCEA] |
330
+ | Retainer (شهري) | [تقدير TCEA] |
331
+ | **الإجمالي التقديري** | **[احسب] هذا تقدير غير ملزم حتى اعتماد Majed** |
332
+ ```
333
+
334
+ ### القواعد
335
+
336
+ 1. **جميع أسعار المنتج تأتي من Majed فقط** — لا تقدر سعر ترخيص المنتج بنفسك
337
+ 2. **Implementation Services** = خدمات TCEA (Discovery, Fit-Gap, Design, Configuration) — تُقدر بناءً على الجهد في FIT_GAP_MATRIX.md
338
+ 3. **Gap-Custom** = يُسعّر منفصلاً — لا يُخلط مع Fixed Price
339
+ 4. **الـ Retainer** = اختياري — يُعرض فقط إذا احتاجه العميل
340
+ 5. **جميع الأسعار بـ JOD** ما لم يحدد Majed غير ذلك
341
+ 6. **الضرائب والرسوم** لا تُدرج في PRODUCT_QUOTATION.md — يُضيفها Majed عند اعتماد السعر النهائي