مستندات المواصفات
مرجع كامل لجميع وثائق المشروع. كل مستند يقدم تفاصيل معمقة حول موضوعه.
من أين تبدأ: ابدأ بمتطلبات الأعمال (
brd/BRD-v3.md) للسياق التجاري، ثم اقرأ مستند التصميم المتعلق بمجال عملك الحالي. مواصفات النطاق توفر أعمق التفاصيل حول الميزات الفردية.
ملفات مشروع المطور:
CLAUDE.md (تهيئة Claude Code) |
spec.md (القواعد التجارية للباكإند) |
fm-app-spec.md (مواصفات تطبيق مدير الملعب Flutter)
— أضفها إلى جذور مشاريعك.
متطلبات الأعمال والمنتج
| المستند | المسار | ما يغطيه |
|---|---|---|
| متطلبات الأعمال | brd/BRD-v3.md |
تحديد أولويات MoSCoW كامل (36 عنصراً)، مقاييس النجاح، مؤشرات الأداء الرئيسية، 62 مشكلة موثقة |
| متطلبات المنتج | prd/PRD-v3.md |
قصص المستخدمين، الشخصيات، متطلبات تجربة المستخدم، خطة التحليلات |
البنية والتصميم
| المستند | المسار | ما يغطيه |
|---|---|---|
| بنية النظام | design/ARCHITECTURE.md |
قرارات البنية، مسار الطلبات، مبررات المكدس التقني |
| مخطط قاعدة البيانات | design/SCHEMA.md |
مخطط ERD، جميع الـ 26 جدولاً، القيود، التعدادات، SQL الترحيل |
| تصميم الـ API | design/API.md |
مواصفات JSON:API، جميع نقاط النهاية، معالجة الأخطاء، التصفح |
| المصادقة | design/AUTH.md |
مسار OTP، PIN، JWT، استراتيجية الجلسة، تحديد المعدل |
| هيكل الملفات | design/FILE-STRUCTURE.md |
هيكل المشروع الأصلي (كيّفه لمكدسك) |
| تصميم الواجهة الأمامية | design/FRONTEND.md |
تصميم Vue 3 + Inertia (لسياق لوحة الإدارة) |
| تكامل واتساب | design/WHATSAPP.md |
إعداد WAHA، القوالب، الاحتياطي، webhooks |
| استراتيجية الاختبار | design/TESTING.md |
هرم الاختبار، أهداف التغطية، مصانع بيانات الاختبار |
| النشر | design/DEPLOYMENT.md |
Docker Compose، VPS، النسخ الاحتياطي/الاسترداد |
| خطة الترحيل | design/MIGRATION.md |
استراتيجية ترحيل البيانات من v2 إلى v3، التحقق |
| تصميم جاهزية الذكاء الاصطناعي | design/AI-READY.md |
واجهات خدمات مصممة لدمج ميزات الذكاء الاصطناعي المستقبلية |
مواصفات النطاق
| المستند | المسار | ما يغطيه |
|---|---|---|
| مواصفات الحجوزات | prd/booking-spec.md |
دورة حياة الحجز الكاملة، آلة الحالة، الحجز المؤقت، التعارضات |
| مواصفات المنشآت | prd/facility-spec.md |
الملاعب، المواقع، المدن، ملفات الجدولة |
| مواصفات الدفع | prd/payments-spec.md |
تسجيل المدفوعات، الاسترداد، حسابات ضريبة القيمة المضافة |
| مواصفات الإشعارات | prd/notifications-spec.md |
قوالب واتساب، التسليم، الرسائل الواردة |
| مواصفات المصادقة | prd/auth-spec.md |
مسار OTP، إدارة PIN، معالجة الجلسات |
| مواصفات الإدارة | prd/admin-spec.md |
لوحة الإدارة، شبكة الحجوزات، عروض التحليلات |
| مواصفات أدوات مدير الملعب | prd/fm-tools-spec.md |
مواصفات الويب والموبايل لمدير الملعب |
| مواصفات API الموبايل | prd/mobile-api-spec.md |
تصميم REST API لتطبيقات Flutter |
| مواصفات جاهزية الذكاء الاصطناعي | prd/ai-ready-spec.md |
واجهات الخدمات لميزات الذكاء الاصطناعي المستقبلية |
| مواصفات الكابتن | prd/captain-spec.md |
ميزة الكابتن (مؤجلة، مخطط فقط) |
تقارير التدقيق والتحليل
| المستند | المسار | ما يغطيه |
|---|---|---|
| خريطة الهيكل | audit/01-structure-map.md |
هيكل قاعدة الكود الحالية v2 |
| جرد الميزات | audit/02-feature-inventory.md |
43 ميزة مفهرسة مع تقييمات التعقيد |
| تحليل Git الجنائي | audit/03-git-forensics.md |
1,291 commit، 7 تحولات معمارية |
| تقرير التطور | audit/04-evolution-report.md |
18 مرحلة تطوير |
| نقاط الألم | audit/05-pain-points-registry.md |
35 نقطة ألم (7 حرجة، 18 رئيسية، 10 ثانوية) |
| فجوات الاختبار | audit/06-testing-gaps.md |
تغطية 14%، 19 ميزة بدون اختبارات |
| مخطط العلاقات | audit/07-er-diagram.md |
مخطط علاقات الكيانات لقاعدة البيانات |
البيانات والتحليلات
| المستند | المسار | ما يغطيه |
|---|---|---|
| تحليل المستخدمين والحجوزات | data/01-user-booking-analysis.md |
2,667 حجز، تقسيم المستخدمين |
| مقاييس الأعمال | data/02-business-metrics.md |
تحليل الإيرادات، تركز العملاء |
| شذوذ البيانات | data/03-data-anomalies.md |
58.3% أسعار مفقودة، 34.8% حالات قديمة |
| خريطة رحلة المستخدم | data/04-user-journey-map.md |
قمع الحجز، اكتساب العملاء |
تحليلات PostHog
| المستند | المسار | ما يغطيه |
|---|---|---|
| تحليل حركة المرور | analytics/PH-01-traffic-analysis.md |
أنماط حركة المرور، المصادر، توزيع الأجهزة |
| تحليل القمع | analytics/PH-02-funnel-analysis.md |
قمع التحويل، نقاط الانسحاب |
| استخدام الميزات | analytics/PH-03-feature-usage.md |
تبني الميزات وأنماط الاستخدام |
| النقاط العمياء في التتبع | analytics/PH-04-tracking-blind-spots.md |
فجوات في تغطية التحليلات |
التوليف
| المستند | المسار | ما يغطيه |
|---|---|---|
| ملخص الفهم | synthesis/SYNTH-01-understanding-summary.md |
تحليل متكامل (43 ميزة، 62 مشكلة، 14 حرجة) |
| أسئلة الأعمال | synthesis/SYNTH-02-business-questions.md |
45 سؤالاً مستهدفاً (24 إلزامي الإجابة) |
| قائمة تحقق المراحل | synthesis/SYNTH-03-gate-checklist.md |
معايير إتمام المراحل |
ترتيب القراءة الموصى لمطور خلفي جديد: 1) هذا الملخص (أنت هنا)، 2) BRD-v3.md، 3) SCHEMA.md، 4) API.md، 5) booking-spec.md، 6) AUTH.md. هذه الـ 6 مستندات تغطي ~80% مما تحتاجه لبدء البرمجة.