البنية
الطبقات، وقاعدة الاعتماديات، والمبادئ غير القابلة للتفاوض، والشكل المشترك للتطبيق.
الطبقاترابط إلى هذا القسم: الطبقات
من الأعلى إلى الأسفل: نطاق المنتج، ثم المنظومة والذكاء الاصطناعي، ثم طبقة خط منتجات واحدة، ثم النواة ونظام التصميم. وتُربط محوّلات Firebase في جذر التركيب.
طبقة نطاق المنتج
الميزات الرأسية فقط، ضمن lib/features/<vertical>/ في مستودع كل منتج: المرآب، والمرضى، والرحلات الجوية. ولا توضع أبدًا في الحزم المشتركة.
طبقة المنظومة
After ID وAfter+ وناقل الأحداث وواجهات API بين المنتجات والخدمات المشتركة. تتواصل المنتجات فيما بينها عبر هذا النسيج — ولا تستورد أبدًا من منتجات شقيقة مباشرةً.
قدرات الذكاء الاصطناعي
منصة ذكاء اصطناعي واحدة بقدرات معيارية — المحادثة، والتعرّف الضوئي على النصوص، والرؤية، والتلخيص، واستدعاء الأدوات، وغيرها. تفعّل المنتجات القدرات أو تعطّلها؛ ولا تشحن مكدّسات ذكاء اصطناعي خاصة بها.
وحدات المستهلكين
طبقة B2C خفيفة: جسر العضوية، وكتالوج ميزات المستهلك، والخزنة الشخصية، وموافقة الإطلاق، والموقع الإقليمي. المرجع: SuperGarage.
وحدات المؤسسات
أربعة عشر منفذًا لقطاع الأعمال B2B — المؤسسة، وRBAC، وسير العمل، والمهام، والتقويم، والمستندات، والمراسلة، والتقارير، والتدقيق، والمزامنة دون اتصال — ولكلٍّ منها تنفيذ وهمي في الذاكرة. المرجع: SuperHospital.
النواة المشتركة
المصادقة، والشبكات المحصّنة، والتخزين، وحقن الاعتماديات عبر Riverpod، وأعلام الميزات، والإعداد عن بُعد، وحزمة SDK للذكاء الاصطناعي بنمط BYOK، واستحقاقات الاشتراك المميّز، والإشعارات، والروابط العميقة، ومحركات لوحة المعلومات والإضافات والبحث والإعدادات.
نظام التصميم
عائلة بصرية واحدة للمستهلكين والمؤسسات: رموز اللون والتباعد ونصف القطر والحركة والطباعة، إلى جانب مكوّنات مشتركة.
محوّلات Firebase
Firebase Auth، ومزامنة الكتل عبر Firestore، ومزامنة الوسائط عبر Storage، خلف منافذ after_core. تُربط في جذر التركيب فقط؛ ولا تستورد شيفرة النطاق Firebase أبدًا.
قاعدة الاعتمادياترابط إلى هذا القسم: قاعدة الاعتماديات
تتجه الاعتماديات نحو الأسفل فقط. وتتواصل المنتجات فيما بينها عبر الأحداث وواجهات API الآمنة في طبقة المنظومة. إضافة نطاق تعني إضافة وحدة في الطبقة العليا، ويبقى هذا المخطط دون تغيير.
المبادئرابط إلى هذا القسم: المبادئ
- SuperGarage هو المرجع الاستهلاكي؛ وSuperHospital هو المرجع المؤسسي.
- لا توجد الوحدات الصناعية والرأسية إلا في مستودعات المنتجات.
- لا توجد وحدات النظام المشتركة إلا في after_core وafter_consumer وafter_enterprise.
- التوليد بدل البدء من الصفر.
- المنافذ قبل حزم SDK.
- الطابع العائلي أولًا: الإطار، والحركة، والكثافة، وشاشة البداية، والغلاف متطابقة.
- يأتي كل منفذ مع تنفيذ وهمي.
الشكل المشترك للتطبيقرابط إلى هذا القسم: الشكل المشترك للتطبيق
كل منتج، للمستهلكين كان أو للمؤسسات، يقلع عبر التسلسل نفسه.
main.dart
→ PlatformConfig.current = manifest
→ ProviderScope(overrides: After*Overrides…)
→ ColdStart (OVERSTEIN splash)
→ AuthGate
→ ProductShell (tabs from platform + spec)
→ Home = Dashboard Engine (+ plugins)
→ OS modules = platform screens
→ Vertical = product feature modules onlyالمصدر supercore/docs/PLATFORM_DOCTRINE.md (يُفتح في علامة تبويب جديدة)