@tera-system/core 0.2.2 → 0.2.4

package/assets/tera-workshop/client-templates/commercial/PROJECT_CHARTER_TEMPLATE.md

@@ -0,0 +1,123 @@
+---
+document_type: project_charter
+template_version: v0.1-draft
+category: commercial
+source_html: tera-workshop/temp/PROJECT_CHARTER_TEMPLATE.html
+used_by: TeraClientEngagementAgent
+client_facing: true
+approval_required: Majed
+client_signature_required: true
+legal_review_required: false
+status: TEMPLATE
+---
+
+# Project Charter — `[PROJECT_NAME]`
+
+> **الهدف:** إطلاق المشروع رسمياً وتثبيت الغرض والأهداف والأطراف والنجاح.
+
+---
+
+## 1. بيانات الوثيقة
+
+| الحقل | القيمة |
+|---|---|
+| اسم المشروع | `[PROJECT_NAME]` |
+| اسم العميل | `[CLIENT_NAME]` |
+| رقم الوثيقة | `[CHARTER_ID]` |
+| تاريخ الإصدار | `[CHARTER_DATE]` |
+| مرجع العقد | `[AGREEMENT_REF]` |
+| الحالة | `[STATUS]` |
+
+---
+
+## 2. الغرض من المشروع
+
+`[PROJECT_PURPOSE]`
+
+---
+
+## 3. الأهداف
+
+- `[OBJECTIVE_1]`
+- `[OBJECTIVE_2]`
+- `[OBJECTIVE_3]`
+
+---
+
+## 4. ملخص النطاق
+
+### داخل النطاق
+
+- `[IN_SCOPE_1]`
+- `[IN_SCOPE_2]`
+
+### خارج النطاق
+
+- `[OUT_SCOPE_1]`
+- `[OUT_SCOPE_2]`
+
+---
+
+## 5. الأطراف المعنية
+
+| الاسم | الجهة | الدور |
+|---|---|---|
+| `[STAKEHOLDER_1]` | `[ORG_1]` | `[ROLE_1]` |
+| `[STAKEHOLDER_2]` | `[ORG_2]` | `[ROLE_2]` |
+
+---
+
+## 6. فريق العمل
+
+| الدور | الاسم |
+|---|---|
+| `[TEAM_ROLE_1]` | `[TEAM_NAME_1]` |
+| `[TEAM_ROLE_2]` | `[TEAM_NAME_2]` |
+| `[TEAM_ROLE_3]` | `[TEAM_NAME_3]` |
+
+---
+
+## 7. الميزانية والجدول الزمني
+
+| الحقل | القيمة |
+|---|---|
+| الميزانية | `[APPROVED_BUDGET]` |
+| طريقة الدفع | `[PAYMENT_SCHEDULE]` |
+| تاريخ البداية | `[START_DATE]` |
+| تاريخ التسليم | `[END_DATE]` |
+| المدة | `[DURATION]` |
+| المراحل الرئيسية | `[MILESTONES]` |
+
+---
+
+## 8. المخاطر
+
+| الخطر | التأثير | الاحتمال | خطة التخفيف |
+|---|---|---|---|
+| `[RISK_1]` | `[RISK_1_IMPACT]` | `[RISK_1_PROBABILITY]` | `[MITIGATION_1]` |
+| `[RISK_2]` | `[RISK_2_IMPACT]` | `[RISK_2_PROBABILITY]` | `[MITIGATION_2]` |
+
+---
+
+## 9. معايير النجاح
+
+- `[SUCCESS_CRITERION_1]`
+- `[SUCCESS_CRITERION_2]`
+- `[SUCCESS_CRITERION_3]`
+
+---
+
+## 10. الاعتماد
+
+| الطرف | الاسم | التوقيع / الإقرار | التاريخ |
+|---|---|---|---|
+| العميل | `[CLIENT_SIGNATORY]` | `[SIGN_CLIENT]` | `[DATE]` |
+| مقدم الخدمة | `[PROVIDER_SIGNATORY]` | `[SIGN_PROVIDER]` | `[DATE]` |
+
+---
+
+## 11. ملاحظات الاستخدام
+
+1. تستخدم كوثيقة إطلاق رسمية للمشروع.
+2. ترتبط بـ SOW وQuotation.
+3. تبقى منسجمة مع نطاق وميزانية معتمدين.

package/assets/tera-workshop/client-templates/commercial/QUOTATION_TEMPLATE.md

@@ -0,0 +1,139 @@
+---
+document_type: quotation
+template_version: v0.1-draft
+category: commercial
+source_html: tera-workshop/temp/QUOTATION_TEMPLATE.html
+used_by: TeraClientEngagementAgent
+client_facing: true
+approval_required: Majed
+client_signature_required: optional
+legal_review_required: false
+currency: JOD
+pricing_policy: tera-system/TeraPricingPolicy.md
+related_documents:
+  - APPLICATION_PROPOSAL_TEMPLATE
+  - SCOPE_OF_WORK_TEMPLATE
+  - SOFTWARE_SERVICES_AGREEMENT_TEMPLATE
+status: TEMPLATE
+---
+
+# Quotation — `[QUOTATION_TITLE]`
+
+> **نوع الوثيقة:** عرض سعر رسمي
+> **الحالة:** مسودة حتى اعتماد Majed
+> **العملة:** الدينار الأردني (JOD)
+> **مرجع التسعير:** `tera-system/TeraPricingPolicy.md`
+
+---
+
+## 1. بيانات العرض
+
+| الحقل | القيمة |
+|---|---|
+| رقم العرض | `[QID]` |
+| اسم العميل | `[CLIENT_NAME]` |
+| اسم المشروع | `[PROJECT_NAME]` |
+| تاريخ الإصدار | `[Q_DATE]` |
+| صلاحية العرض | `[VALIDITY]` |
+| طريقة الدفع | `[PAYMENT_METHOD]` |
+| الحالة | `[STATUS]` |
+
+---
+
+## 2. ملخص العرض
+
+`[QUOTATION_SUMMARY]`
+
+> **ملاحظة:** هذا العرض مبني على النطاق المعتمد حالياً فقط. أي توسع لاحق يمر عبر `Change Request` مستقل.
+
+---
+
+## 3. البنود والأسعار
+
+| # | البند | الوصف | الكمية | سعر الوحدة (JOD) | الإجمالي (JOD) |
+|---|---|---|---:|---:|---:|
+| 1 | `[ITEM_1]` | `[ITEM_1_DESC]` | `[QTY_1]` | `[UNIT_PRICE_1]` | `[TOTAL_1]` |
+| 2 | `[ITEM_2]` | `[ITEM_2_DESC]` | `[QTY_2]` | `[UNIT_PRICE_2]` | `[TOTAL_2]` |
+| 3 | `[ITEM_3]` | `[ITEM_3_DESC]` | `[QTY_3]` | `[UNIT_PRICE_3]` | `[TOTAL_3]` |
+| 4 | `[ITEM_4]` | `[ITEM_4_DESC]` | `[QTY_4]` | `[UNIT_PRICE_4]` | `[TOTAL_4]` |
+
+|  |  |  |  | **المجموع الفرعي** | **[SUBTOTAL]** |
+|  |  |  |  | **الخصم** | **[DISCOUNT]** |
+|  |  |  |  | **الضرائب والرسوم** | **غير شاملة إلا إذا ذُكر صراحة** |
+|  |  |  |  | **الإجمالي النهائي** | **[GRAND_TOTAL]** |
+
+---
+
+## 4. شروط الدفع
+
+| البند | التفاصيل |
+|---|---|
+| الدفعة المقدمة | `[PAYMENT_UPFRONT]` |
+| الدفعات المرحلية | `[PAYMENT_MILESTONES]` |
+| عند التسليم | `[PAYMENT_DELIVERY]` |
+| طريقة التحويل | `[PAYMENT_TRANSFER_METHOD]` |
+
+---
+
+## 5. التسليم والمدة
+
+| البند | التفاصيل |
+|---|---|
+| مدة التنفيذ المتوقعة | `[ESTIMATED_DURATION]` |
+| تاريخ بدء متوقع | `[EXPECTED_START_DATE]` |
+| مراحل التسليم | `[DELIVERY_MILESTONES]` |
+
+---
+
+## 6. ما يشمله العرض وما يستثنيه
+
+### يشمل
+
+- `[INCLUDED_1]`
+- `[INCLUDED_2]`
+- `[INCLUDED_3]`
+
+### لا يشمل
+
+- الضرائب والرسوم الحكومية (إلا إذا ذُكرت صراحة)
+- رسوم بوابات الدفع
+- الاشتراكات الخارجية (تراخيص، APIs، خدمات طرف ثالث)
+- الاستضافة أو الدومين أو SSL (إلا إذا ذُكرت صراحة)
+
+---
+
+## 7. الافتراضات والملاحظات
+
+- `[ASSUMPTION_1]`
+- `[ASSUMPTION_2]`
+- `[NOTE_1]`
+
+> أي تغيير على النطاق أو الافتراضات قد يتطلب **Change Request** وتعديل السعر/المدة.
+
+---
+
+## 8. اعتماد العرض
+
+### 8.1 اعتماد داخلي — إلزامي
+
+| الدور | الاسم | الحالة | التاريخ |
+|---|---|---|---|
+| أعدّه | TeraClientEngagementAgent | `[DRAFT / REVIEWED]` | `[DATE]` |
+| اعتمده | Majed | `[APPROVED / CHANGES_REQUESTED]` | `[DATE]` |
+
+### 8.2 إقرار العميل — اختياري حسب السياق
+
+| الطرف | الاسم | التوقيع / الإقرار | التاريخ |
+|---|---|---|---|
+| ممثل العميل | `[CLIENT_SIGNATORY]` | `[OPTIONAL]` | `[DATE]` |
+| ممثل Teranoo | `[PROVIDER_SIGNATORY]` | `[OPTIONAL]` | `[DATE]` |
+
+---
+
+## 9. ملاحظات الاستخدام
+
+1. هذا الملف **Template** ويُملأ بواسطة TCEA.
+2. لا يُرسل للعميل قبل اعتماد Majed.
+3. لا تظهر فيه المصفوفة الداخلية أو طريقة الحساب التفصيلية.
+4. إذا تغير النطاق، يُستخدم `Change Request Form` أو تُصدر نسخة Quote جديدة.
+5. يجب أن يبقى متوافقاً مع `TeraPricingPolicy.md`.

package/assets/tera-workshop/client-templates/commercial/SCOPE_OF_WORK_TEMPLATE.md

@@ -0,0 +1,124 @@
+---
+document_type: scope_of_work
+template_version: v0.1-draft
+category: commercial
+source_html: tera-workshop/temp/SCOPE_OF_WORK_TEMPLATE.html
+used_by: TeraClientEngagementAgent
+client_facing: true
+approval_required: Majed
+client_signature_required: true
+legal_review_required: recommended
+status: TEMPLATE
+---
+
+# Scope of Work — `[PROJECT_NAME]`
+
+> **الهدف:** تحديد النطاق والالتزامات والتسليمات بشكل واضح قبل التنفيذ.
+
+---
+
+## 1. بيانات المستند
+
+| الحقل | القيمة |
+|---|---|
+| اسم المشروع | `[PROJECT_NAME]` |
+| اسم العميل | `[CLIENT_NAME]` |
+| رقم الوثيقة | `[SOW_ID]` |
+| تاريخ الإصدار | `[SOW_DATE]` |
+| مرجع العرض | `[QUOTATION_REF]` |
+| الحالة | `[STATUS]` |
+
+---
+
+## 2. الغرض من المشروع
+
+`[PROJECT_PURPOSE]`
+
+---
+
+## 3. الأهداف
+
+- `[OBJECTIVE_1]`
+- `[OBJECTIVE_2]`
+- `[OBJECTIVE_3]`
+
+---
+
+## 4. النطاق
+
+### 4.1 داخل النطاق
+
+- `[IN_SCOPE_1]`
+- `[IN_SCOPE_2]`
+- `[IN_SCOPE_3]`
+
+### 4.2 خارج النطاق
+
+- `[OUT_SCOPE_1]`
+- `[OUT_SCOPE_2]`
+
+---
+
+## 5. الأطراف المعنية
+
+| الاسم | الجهة | الدور |
+|---|---|---|
+| `[STAKEHOLDER_1]` | `[ORG_1]` | `[ROLE_1]` |
+| `[STAKEHOLDER_2]` | `[ORG_2]` | `[ROLE_2]` |
+
+---
+
+## 6. فريق العمل
+
+| الدور | الاسم |
+|---|---|
+| `[TEAM_ROLE_1]` | `[TEAM_NAME_1]` |
+| `[TEAM_ROLE_2]` | `[TEAM_NAME_2]` |
+| `[TEAM_ROLE_3]` | `[TEAM_NAME_3]` |
+
+---
+
+## 7. الميزانية والجدول
+
+| الحقل | القيمة |
+|---|---|
+| الميزانية المعتمدة | `[APPROVED_BUDGET]` |
+| طريقة الدفع | `[PAYMENT_SCHEDULE]` |
+| تاريخ البداية | `[START_DATE]` |
+| تاريخ التسليم | `[END_DATE]` |
+| المدة | `[DURATION]` |
+| المراحل الرئيسية | `[MILESTONES]` |
+
+---
+
+## 8. المخاطر الأولية
+
+| الخطر | التأثير | الاحتمال | خطة التخفيف |
+|---|---|---|---|
+| `[RISK_1]` | `[RISK_1_IMPACT]` | `[RISK_1_PROBABILITY]` | `[MITIGATION_1]` |
+| `[RISK_2]` | `[RISK_2_IMPACT]` | `[RISK_2_PROBABILITY]` | `[MITIGATION_2]` |
+
+---
+
+## 9. معايير النجاح
+
+- `[SUCCESS_CRITERION_1]`
+- `[SUCCESS_CRITERION_2]`
+- `[SUCCESS_CRITERION_3]`
+
+---
+
+## 10. الاعتماد
+
+| الطرف | الاسم | التوقيع / الإقرار | التاريخ |
+|---|---|---|---|
+| العميل | `[CLIENT_SIGNATORY]` | `[SIGN_CLIENT]` | `[DATE]` |
+| مقدم الخدمة | `[PROVIDER_SIGNATORY]` | `[SIGN_PROVIDER]` | `[DATE]` |
+
+---
+
+## 11. ملاحظات الاستخدام
+
+1. هذه الوثيقة تضبط النطاق قبل التنفيذ.
+2. لا تُستخدم كعرض سعر.
+3. أي تغيير لاحق في النطاق يحتاج Change Request.

package/assets/tera-workshop/client-templates/commercial/SCOPE_SUMMARY_TEMPLATE.md

@@ -0,0 +1,106 @@
+# SCOPE_SUMMARY — [اسم المشروع]
+
+**حالة المستند:** مسودة
+**تاريخ الإصدار:** YYYY-MM-DD
+**الجهة:** TeraClientEngagementAgent
+**يسبقه:** CLIENT_BRIEF.md
+**يُنتج بعده:** DRAFT_QUOTATION.md
+
+---
+
+## 1. حدود المشروع
+
+### داخل النطاق (In Scope)
+
+- [البند 1]
+- [البند 2]
+
+### خارج النطاق (Out of Scope)
+
+- [البند 1]
+- [البند 2]
+
+---
+
+## 2. وحدات التطبيق
+
+| الوحدة | وصف مختصر | مستوى التعقيد المتوقع |
+|--------|-----------|:--------------------:|
+| [الوحدة 1] | | Simple / Medium / Complex / Critical |
+| [الوحدة 2] | | Simple / Medium / Complex / Critical |
+| [الوحدة 3] | | Simple / Medium / Complex / Critical |
+
+---
+
+## 3. قائمة الميزات التفصيلية
+
+### الوحدة 1: [اسم الوحدة]
+
+| # | الميزة | وصف | مستوى التعقيد | ملاحظات |
+|---|--------|-----|:------------:|---------|
+| 1 | | | S / M / C / Cr | |
+| 2 | | | S / M / C / Cr | |
+| 3 | | | S / M / C / Cr | |
+
+### الوحدة 2: [اسم الوحدة]
+
+| # | الميزة | وصف | مستوى التعقيد | ملاحظات |
+|---|--------|-----|:------------:|---------|
+| 1 | | | S / M / C / Cr | |
+| 2 | | | S / M / C / Cr | |
+
+---
+
+## 4. تكاملات خارجية
+
+| التكامل | النوع | ملاحظات |
+|---------|-------|---------|
+| [API/Payment/etc.] | | |
+
+---
+
+## 5. الصلاحيات والأدوار
+
+| الدور | الصلاحيات | ملاحظات |
+|-------|-----------|---------|
+| [دور 1] | | |
+| [دور 2] | | |
+
+---
+
+## 6. تقارير
+
+| التقرير | النوع | ملاحظات |
+|---------|-------|---------|
+| [تقرير 1] | قائمة / رسم بياني / لوحة قيادة | |
+
+---
+
+## 7. إشعارات
+
+| النوع | الحدث | ملاحظات |
+|-------|-------|---------|
+| بريد / SMS / فوري | | |
+
+---
+
+## 8. تقييم Risk Buffer
+
+| المعيار | التقييم | Low / Medium / High |
+|---------|---------|:-------------------:|
+| وضوح المتطلبات | | |
+| تقنية التطوير | | |
+| تاريخ الزبون | | |
+| اعتماد API | | |
+| الجدول الزمني | | |
+| **النتيجة** | | |
+
+---
+
+## 9. ملاحظات
+
+[أي ملاحظات إضافية عن النطاق، افتراضات، مخاطر، أو نقاط تحتاج توضيحاً]
+
+---
+
+*هذا المستند مسودة (Draft) ولا يمثل التزاماً.*

package/assets/tera-workshop/client-templates/commercial/TECHNICAL_PROPOSAL_TEMPLATE.md

@@ -0,0 +1,106 @@
+---
+document_type: technical_proposal
+template_version: v0.1-draft
+category: commercial
+source_html: tera-workshop/temp/TECHNICAL_PROPOSAL_TEMPLATE.html
+used_by: TeraClientEngagementAgent
+client_facing: true
+approval_required: Majed
+client_signature_required: optional
+legal_review_required: false
+status: TEMPLATE
+---
+
+# Technical Proposal — `[PROJECT_NAME]`
+
+> **الهدف:** توضيح النهج التقني المقترح، البنية، التقنيات، والاعتبارات الأمنية والتشغيلية.
+
+---
+
+## 1. بيانات المستند
+
+| الحقل | القيمة |
+|---|---|
+| اسم المشروع | `[PROJECT_NAME]` |
+| اسم العميل | `[CLIENT_NAME]` |
+| رقم الوثيقة | `[TP_ID]` |
+| تاريخ الإصدار | `[TP_DATE]` |
+| الحالة | `[STATUS]` |
+
+---
+
+## 2. الملخص التقني
+
+`[TECHNICAL_SUMMARY]`
+
+---
+
+## 3. البنية المعمارية
+
+| المكوّن | الوصف |
+|---|---|
+| الواجهة الأمامية | `[FRONTEND_ARCH]` |
+| الخلفية | `[BACKEND_ARCH]` |
+| قاعدة البيانات | `[DATABASE_ARCH]` |
+| التكاملات | `[INTEGRATIONS_ARCH]` |
+| الاستضافة | `[HOSTING_ARCH]` |
+
+---
+
+## 4. التقنيات المقترحة
+
+| الطبقة | التقنية | سبب الاختيار |
+|---|---|---|
+| Frontend | `[FRONTEND_TECH]` | `[FRONTEND_REASON]` |
+| Backend | `[BACKEND_TECH]` | `[BACKEND_REASON]` |
+| Database | `[DATABASE_TECH]` | `[DATABASE_REASON]` |
+| DevOps | `[DEVOPS_TECH]` | `[DEVOPS_REASON]` |
+
+---
+
+## 5. متطلبات الأمان
+
+- `[SECURITY_REQ_1]`
+- `[SECURITY_REQ_2]`
+- `[SECURITY_REQ_3]`
+
+---
+
+## 6. الاختبار والجودة
+
+- `[TESTING_PLAN_1]`
+- `[TESTING_PLAN_2]`
+- `[TESTING_PLAN_3]`
+
+---
+
+## 7. النشر والتشغيل
+
+- `[DEPLOYMENT_STEP_1]`
+- `[DEPLOYMENT_STEP_2]`
+- `[DEPLOYMENT_STEP_3]`
+
+---
+
+## 8. الافتراضات والقيود
+
+- `[ASSUMPTION_1]`
+- `[ASSUMPTION_2]`
+- `[CONSTRAINT_1]`
+
+---
+
+## 9. الاعتماد
+
+| الطرف | الاسم | التوقيع / الإقرار | التاريخ |
+|---|---|---|---|
+| مراجعة داخلية | TeraClientEngagementAgent | `[SIGN_INTERNAL]` | `[DATE]` |
+| اعتماد Majed | `[MAJED_NAME]` | `[SIGN_MAJED]` | `[DATE]` |
+
+---
+
+## 10. ملاحظات الاستخدام
+
+1. هذه الوثيقة تشرح “كيف” سيُبنى الحل.
+2. يجب أن تبقى منسجمة مع SOW وQuotation.
+3. لا تُرسل للعميل النهائي إذا احتوت تفاصيل داخلية حساسة إلا بعد التعديل.

package/assets/tera-workshop/client-templates/contractual/CHANGE_REQUEST_FORM.md

@@ -0,0 +1,83 @@
+---
+document_type: change_request_form
+template_version: v0.1-draft
+category: contractual
+source_html: tera-workshop/temp/CHANGE_REQUEST_FORM.html
+used_by: TeraClientEngagementAgent
+client_facing: true
+approval_required: Majed
+client_signature_required: true
+legal_review_required: recommended
+status: TEMPLATE
+---
+
+# Change Request Form — `[CR_ID]`
+
+> **الهدف:** توثيق طلب تغيير مؤثر في النطاق أو الجداول أو التكلفة.
+
+---
+
+## 1. بيانات الطلب
+
+| الحقل | القيمة |
+|---|---|
+| رقم الطلب | `[CR_ID]` |
+| اسم المشروع | `[PROJECT_NAME]` |
+| تاريخ الطلب | `[CR_DATE]` |
+| مقدم الطلب | `[REQUESTED_BY]` |
+| الحالة | `[STATUS]` |
+
+---
+
+## 2. وصف التغيير
+
+`[CHANGE_DESCRIPTION]`
+
+---
+
+## 3. سبب التغيير
+
+`[CHANGE_REASON]`
+
+---
+
+## 4. التحليل الأولي للأثر
+
+| البند | الأثر |
+|---|---|
+| النطاق | `[SCOPE_IMPACT]` |
+| الوقت | `[TIME_IMPACT]` |
+| التكلفة | `[COST_IMPACT]` |
+| الجودة | `[QUALITY_IMPACT]` |
+
+---
+
+## 5. الخيارات المقترحة
+
+- `[OPTION_1]`
+- `[OPTION_2]`
+- `[OPTION_3]`
+
+---
+
+## 6. القرار المطلوب
+
+`[REQUESTED_DECISION]`
+
+---
+
+## 7. الاعتماد
+
+| الطرف | الاسم | التوقيع / الإقرار | التاريخ |
+|---|---|---|---|
+| العميل | `[CLIENT_SIGNATORY]` | `[SIGN_CLIENT]` | `[DATE]` |
+| مقدم الخدمة | `[PROVIDER_SIGNATORY]` | `[SIGN_PROVIDER]` | `[DATE]` |
+| مراجعة Majed | `[MAJED_NAME]` | `[SIGN_MAJED]` | `[DATE]` |
+
+---
+
+## 8. ملاحظات الاستخدام
+
+1. أي تغيير مؤثر في النطاق أو الوقت أو التكلفة يمر عبر هذا النموذج.
+2. يستخدم مع Quotation محدث عند الحاجة.
+3. قد يتطلب مراجعة قانونية أو عقد ملحق.