PUIUX Client Template

Template repo لمشاريع العملاء - كل عميل جديد يُنشأ من هذا القالب.

---

📋 استخدام هذا Template:

إنشاء عميل جديد:

# على GitHub:
1. اضغط "Use this template"
2. سمّي الـ Repo: client-{slug}
   مثال: client-alfa-fashion

# أو عبر CLI:
gh repo create puiux-cloud/client-{slug} --template=client-template --private

تخصيص للعميل:

1. افتح client.json
2. عدّل:
   • id → رقم تسلسلي فريد
   • slug → اسم قصير بالإنجليزي
   • name → اسم العميل
   • pod → نوع المشروع
   • stack → التقنية المستخدمة
   • domains.production → دومين العميل الفعلي
3. Save & commit

---

📁 الهيكل:

docs/presales/ - مرحلة ما قبل التعاقد

lead-brief.md              (PS0: معلومات أولية)
discovery-notes.md         (PS1: احتياجات تفصيلية)
proposal-financial.md      (PS2: العرض المالي)
proposal-technical.md      (PS2: العرض التقني)
proposal-script.md         (PS3: نص الشرح الصوتي)
proposal-acceptance.md     (PS3.5: موافقة العميل الصريحة) 🔒
proposal-interactive.html  (PS3: الصفحة التفاعلية)
timeline.md                (PS2: الجدول الزمني)

docs/legal/ - العقود والاتفاقيات

nda.md                 (NDA إذا لزم)
contract.md            (العقد الرسمي)
contract.pdf           (نسخة PDF موقعة)

docs/billing/ - الفواتير والمدفوعات

invoice-0001.md        (الفاتورة الأولى)
invoice-0001.pdf       (PDF)
payments.log           (سجل المدفوعات)
payment-proofs/        (إثباتات التحويل من العميل)

docs/artifacts/ - مخرجات التنفيذ

requirements.md        (Stage 1: المتطلبات)
architecture.md        (Stage 3: المعمارية)
ux-flows.md            (Stage 2: User flows)
ui-kit.md              (Stage 2: التصميم)
api-contracts.md       (Stage 3: API docs)
test-plan.md           (Stage 4: خطة الاختبار)
release-checklist.md   (Stage 5: Release)
decisions.log          (القرارات المهمة)

docs/ops/ - العمليات والنشر

dns.md                 (إعداد DNS)
deploy-notes.md        (ملاحظات النشر)
access.log             (سجل الوصول)

src/ - الكود

(يُنشأ حسب الـ stack)

---

🔒 Gates (البوابات):

payment_verified

• ❌ false → Delivery stages مقفولة
• ✅ true → يُفتح التنفيذ

dns_verified

• ❌ false → Production deploy ممنوع
• ✅ true → Production deploy مسموح

القاعدة:

لا نشر على Production إلا بعد: payment_verified=true AND dns_verified=true

---

🚀 Workflows:

deploy-staging.yml

• Trigger: Push to develop
• Deploy to: staging.{slug}.puiux.cloud
• Condition: None (يعمل دايماً)

deploy-production.yml

• Trigger: Push to main
• Deploy to: {domains.production}
• Conditions:
  1. ✅ payment_verified = true
  2. ✅ dns_verified = true
  3. ✅ PR approved
  4. ✅ CI green

---

📊 Domains Strategy:

Beta/Testing (على puiux.cloud):

Beta:    {slug}.puiux.cloud
Staging: staging.{slug}.puiux.cloud

Production (على دومين العميل):

Production: client-domain.com
            www.client-domain.com

---

📝 Workflow للعميل الجديد:

1. Presales:

PS0 → Lead qualification
PS1 → Discovery
PS2 → Proposal preparation
PS3 → Proposal delivery (interactive + voice)
PS3.5 → Explicit acceptance 🔒
PS4 → Contract
PS5 → Invoice + Payment verification 🔒

2. DNS Setup:

- العميل يضيف DNS records
- التحقق من DNS
- dns_verified = true ✅

3. Delivery:

Stage 0 → Kickoff
Stage 1 → Requirements
Stage 2 → Design
Stage 3 → Build
Stage 4 → QA
Stage 5 → Release

---

⚠️ ملاحظات مهمة:

1. لا تعدّل الهيكل - الـ structure موحد لجميع العملاء
2. املأ الـ Artifacts - كل stage ينتج artifacts واضحة
3. التزم بالـ Gates - لا تخطي القواعد
4. وثّق القرارات - اكتب في decisions.log

---

هذا القالب يضمن تنظيم موحد واحترافي لكل عميل - من أول استفسار لحد التسليم.