PUIUX Knowledge Base

المرجع الرسمي لمعايير وأنماط ومعرفة شركة PUIUX.

📚 الهيكل:

knowledge/puiux/

المعرفة الأساسية لعمليات PUIUX:

• delivery-playbook.md - مراحل التسليم (Stages + Gates + Definition of Done)
• design-system.md - نظام التصميم (Tokens، Components، Handoff)
• engineering-standards.md - معايير البرمجة (Code standards، Security، Performance)
• qa-checklist.md - معايير الجودة (Testing gates، Release criteria)
• pods.md - قواعد اختيار Pod/Stack
• sales-playbook.md - دليل المبيعات (Presales workflow)
• discovery-template.md - قالب أسئلة Discovery
• proposal-templates.md - قوالب العروض المالية والتقنية
• contract-template.md - قالب العقد الرسمي
• invoice-template.md - قالب الفواتير
• pricing-models.md - نماذج التسعير

knowledge/puiux/inspirations/

أمثلة ملهمة ومراجع:

• corporate-sites.md - مواقع تعريفية احترافية
• ecommerce.md - متاجر إلكترونية
• saas-platforms.md - منصات SaaS
• marketplaces.md - منصات Multi-Vendor

knowledge/puiux/solutions/

حلول لمشاكل شائعة:

• حلول تقنية مجربة
• Packages موصى بها
• Best practices

knowledge/puiux/patterns/

أنماط معمارية:

• auth-patterns.md - أنماط المصادقة
• payment-patterns.md - أنماط الدفع
• multi-vendor-patterns.md - أنماط Multi-Vendor

knowledge/domains/

معرفة خاصة بمجالات أخرى:

• legal.md - المحاماة
• clinics.md - العيادات
• recruitment.md - التوظيف

templates/

قوالب جاهزة للاستخدام:

• Discovery templates
• BRD/SRS templates
• Contract templates
• Invoice templates

docs/ops/

توثيق العمليات:

• dns.md - إعداد DNS
• deployment.md - إعداد الـ Deployment

---

🔄 كيفية التحديث:

من WhatsApp Groups:

1. مشاركة في الجروب (مصدر، حل، pattern)
2. Curator يلتقط المفيد
3. يفتح GitHub Issue
4. Review → PR → Merge
5. Auto deploy للـ workspace

مباشرة من Agents:

1. Agent يكتشف معلومة مفيدة
2. يفتح PR تلقائياً
3. Review → Merge

---

📖 للـ Agents:

كل Agent يقرأ الملفات المتعلقة بتخصصه قبل بدء العمل:

• PM/BA Agent → delivery-playbook.md, discovery-template.md
• Sales Agent → sales-playbook.md, proposal-templates.md
• UX/UI Agent → design-system.md, inspirations/
• Engineering Agent → engineering-standards.md, solutions/, patterns/
• QA Agent → qa-checklist.md
• Legal Agent → contract-template.md
• Finance Agent → invoice-template.md, pricing-models.md

---

هذه القاعدة المعرفية تتطور باستمرار - كل تجربة ناجحة تتحول لمعيار.