البنية التقنية
نظرة عامة
شام باص هي منصة B2B2C لحجز تذاكر الباصات بين المدن في سوريا.
┌─────────────────────────────────────────────────────────────────┐
│ العملاء │
├──────────────┬──────────────┬──────────────┬───────────────────┤
│ تطبيق الجوال │ بوابة الحجز │ لوحة الشركات │ لوحة الإدارة │
│ (Flutter) │ (Next.js) │ (Next.js) │ (Next.js) │
└──────────────┴──────────────┴──────────────┴───────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ REST API │
│ (Next.js) │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ Supabase │
│ PostgreSQL + Auth + Storage + Realtime │
└─────────────────────────────────────────────────────────────────┘
التقنيات المستخدمة
| المكون | التقنية |
|---|---|
| تطبيقات الجوال | Flutter 3.16+, Riverpod |
| تطبيقات الويب | Next.js 15, React 19, TypeScript |
| إدارة المشروع | Turborepo + pnpm workspaces |
| قاعدة البيانات | PostgreSQL (Supabase) |
| المصادقة | Supabase Auth + OTP |
| التخزين | Supabase Storage |
هيكل المشروع
shambus/
├── apps/
│ ├── customer/ # بوابة الحجز (Port 3000)
│ ├── dashboard/ # لوحة الشركات (Port 3001)
│ ├── admin/ # لوحة الإدارة (Port 3002)
│ ├── docs/ # التوثيق (Docusaurus)
│ └── mobile/
│ ├── customer/ # تطبيق العميل
│ └── driver/ # تطبيق السائق
│
├── packages/
│ ├── ui/ # مكونات مشتركة
│ ├── types/ # أنواع TypeScript
│ ├── services/ # خدمات الأعمال
│ └── database/ # عميل Supabase
│
└── infrastructure/
└── supabase/ # ملفات الترحيل
الأقسام
- نظرة عامة
- أنماط API للتطبيقات
- تعريب وترجمة تجربة العميل
- Global product standards audit
- Connected operations model
- Company-controlled booking confirmation
- Enterprise feature traceability
- Generated ecosystem surface inventory
- Enterprise transport capability research
- Canonical brand system
- الإشعارات المعاملاتية
- المستندات وملفات PDF
- مخطط قاعدة البيانات
- المصادقة