# المعمارية التقنية — المرحلة 1

## تعريف المرحلة

- **اسم المرحلة:** الاستكشاف + المعمارية + UI/UX + الأساس التقني
- **الأولوية:** حرجة — لا يبدأ البناء الوظيفي قبل اعتمادها
- **المدة التقديرية:** الشهور 1–4 (16 أسبوعًا)
- **هدف المرحلة:** تحويل الرؤية إلى منتج قابل للتنفيذ وتسليم نسخة Alpha مرئية وعاملة تشمل الموقع وتطبيق Android/iOS وBackend Laravel ولوحة إدارة أولية.
- **بوابة الخروج:** نسخة Alpha على Staging يمكن للعميل تجربتها: تسجيل ودخول، ملف شخصي، تغذية، منشورات نص/صورة، إعجاب وتعليق أساسي، مع تصميم معتمد وبنية واختبارات وتسليم عرض رسمي.

## التفاصيل

- اعتماد Modular Monolith في Laravel بحدود واضحة لوحدات الهوية، المستخدمين، المحتوى، العلاقات، الإشعارات والإدارة.
- قناة REST API بإصدار /api/v1، مع WebSocket للأحداث الفورية وعقود أحداث قابلة للفصل لاحقًا.
- PostgreSQL للبيانات الأساسية، Redis للكاش والجلسات والصفوف، وتخزين كائنات S3-compatible للصور والفيديو.
- فصل معالجة الوسائط والبحث والمكالمات كقدرات خارجية الحدود منذ التصميم ولو لم تُفعّل بالكامل الآن.
- توثيق قرارات الاستضافة، المناطق، التعافي، مزودي الرسائل القصيرة والبريد وCDN على شكل ADRs قابلة للمراجعة.

## ضوابط التنفيذ

- توثق القرارات الجوهرية في ADR مع البدائل والأثر وقابلية الرجوع.
- يمنع إدخال خدمة مستقلة أو مزود جديد دون حاجة قابلة للقياس وخطة فشل.

## آلية العمل والتتبع

1. تحويل البنود إلى Epics وStories لها مالك ومعيار قبول واعتماديات.
2. مراجعة أسبوعية للتقدم والمخاطر والقرارات والتغييرات، وتحديث الوثائق مع الكود.
3. عرض دوري على العميل في بيئة مشتركة، ثم توثيق الملاحظات وقرار القبول أو الإرجاع.
4. منع إغلاق أي بند دون اختبار وأثر موثقين حسب طبيعته.

## أدلة الإنجاز المطلوبة

- مخططات C4/تدفق، ADRs، NFR matrix ونتيجة مراجعة معمارية.
- نسخة مرقمة بتاريخ التسليم ومذكور فيها البيئة والإصدار.
- ربط العيوب أو الاستثناءات المفتوحة بمالك وموعد مستهدف.

## الاعتماديات والانتقال

- **قبل البدء:** اعتماد ميثاق المشروع وتوفر أصحاب القرار.
- **بعد الإنجاز:** توفير مدخلات مستقرة للمرحلة 2 دون نقل دين حرج غير معلن.

## المسؤوليات

- **مالك المنتج:** اعتماد الأولوية والسلوك ومعايير القبول.
- **القائد التقني:** اعتماد التصميم الفني والمخاطر وقابلية التشغيل.
- **الجودة والأمن:** تقديم أدلة الاختبار وعدم وجود موانع إصدار.
- **العميل:** توفير القرارات والحسابات والمحتوى والموافقات في المواعيد المتفق عليها.