🧭 المفقود في المنظومة

• صيدلية واحدة (مجمع مكة الطبي) — لا يوجد pharmacyId على أي مستند.
• الموظفون يُمنحون أدواراً عبر AuthGuard + customer-project Firebase: warehouse, pharmacist, admin, owner.
• السائق صنف واحد عام: لا يوجد ربط بصيدلية، ولا قائمة أوامر مخصّصة له.
• إعدادات الدفع/التوصيل/الاستوديو عامّة على مستوى التطبيق، لا تنتمي لصيدلية بعينها.

أ. لوحة مالك المنصّة ناقص

• إنشاء صيدلية جديدة (اسم، فرع رئيسي، رخصة SFDA، عنوان، شعار).
• تعيين مالك صيدلية (Pharmacy Owner) بإيميل دعوة.
• تفعيل/تعطيل الصيدلية (suspend/resume).
• إدارة الاشتراك والحالة (trial/active/past_due/cancelled).
• عرض صحة المنصّة الكلية (عدد الصيدليات، الطلبات اليوم، الفشل).

ب. لوحة مالك الصيدلية جزئي

• إدارة الموظفين (يوجد جزئياً عبر AuthGuard لكن بلا واجهة منظّمة).
• إدارة السائقين (لا توجد إدارة ضمن الصيدلية).
• إدارة الكاشير / موظف الطلبات (دور غير موجود).
• مناطق التوصيل (لا يوجد).
• وسائل الدفع للصيدلية (إعداد عام فقط، لا per-pharmacy).
• فتح/إغلاق المتجر (يوجد عبر sales-frozen flag عالمي — يحتاج per-pharmacy).

ج. إدارة السائقين ناقص

• سجل سائق (اسم، جوّال، واتساب، حالة التوفّر، pharmacyId).
• قائمة الطلبات النشطة للسائق.
• رابط بوابة سائق آمن (driver portal token).

د. توزيع الطلبات على السائق ناقص

• زر "إسناد لسائق" في صفحة طلبات المخزن.
• إرسال الطلب إلى بوابة السائق + رابط واتساب جاهز + نسخ الرابط.

هـ. بوابة السائق جزئي

• موجودة كصفحة driver.html لكنها لا تفلتر حسب driverId.
• تحديث الحالة (مقبول / تم الالتقاط / في الطريق / تم التسليم / فشل) ناقص.

و. نموذج الصلاحيات جزئي

• يوجد: warehouse / pharmacist / admin / owner.
• ناقص: platform_owner (فوق owner)، pharmacy_manager، driver، cashier.

ز. نموذج البيانات ناقص

• كل المستندات تحتاج pharmacyId (المنتجات، الدفعات، الطلبات، السائقين، الموظفين، الإعدادات).
• لا توجد عزل بيانات بين الصيدليات حالياً (لأنه لا توجد إلا واحدة).

ح. الأمان وعزل البيانات ناقص

• يحتاج middleware يضيف req.access.pharmacyId وكل قراءة/كتابة تتحقق من المساواة.
• السائق يرى فقط الطلبات المسنَدة إليه (وليس كل طلبات الصيدلية).
• Platform Owner فوق الجميع لأغراض الدعم.

platform/
  pharmacies/{pharmacyId}                     ← السجل الرئيسي للصيدلية
    name, brandLogo, sfdaLicenseNumber, address,
    status: 'trial'|'active'|'suspended'|'cancelled',
    subscription: { plan, renewsAt, billingEmail },
    ownerUid, createdAt, createdBy, settings.{...}
  pharmacy_users/{uid}                        ← ربط مستخدم بصيدلية + دور
    pharmacyId, role, email, displayName, status,
    grantedAt, grantedBy
  pharmacy_invites/{inviteId}                 ← دعوات قيد القبول
    pharmacyId, email, role, token, expiresAt
  platform_admins/{uid}                       ← Platform Owner allowlist
    email, addedAt

per-pharmacy collections (every doc carries pharmacyId at top level):
  pharmacy_warehouse_products/{sku}           ← pharmacyId
  pharmacy_warehouse_batches/{batchId}        ← pharmacyId
  pharmacy_orders/{orderId}                   ← pharmacyId
  pharmacy_drivers/{driverId}                 ← pharmacyId
  pharmacy_delivery_zones/{zoneId}            ← pharmacyId
  pharmacy_payment_configs/{pharmacyId}       ← single doc per pharmacy
  pharmacy_storefront_settings/{pharmacyId}   ← single doc per pharmacy
  pharmacy_audit_log/{eventId}                ← pharmacyId

Platform owner

• POST /api/v2/platform/pharmacies — create pharmacy
• GET /api/v2/platform/pharmacies — list
• PATCH /api/v2/platform/pharmacies/{id} — enable/disable, subscription
• POST /api/v2/platform/pharmacies/{id}/owner — assign owner by email/invite
• GET /api/v2/platform/health — global KPIs

Pharmacy owner

• GET/POST/PATCH/DELETE /api/v2/pharmacy/staff
• GET/POST/PATCH/DELETE /api/v2/pharmacy/drivers
• POST /api/v2/pharmacy/drivers/{id}/portal-link — mint signed link
• GET/PUT /api/v2/pharmacy/delivery-zones
• GET/PUT /api/v2/pharmacy/payment-config
• POST /api/v2/pharmacy/storefront/open / /close

Driver

• GET /api/v2/driver/orders — filter by driverId
• POST /api/v2/driver/orders/{id}/status — accepted / picked_up / on_the_way / delivered / failed

Order ↔ driver

• POST /api/v2/pharmacy/orders/{id}/assign-driver — body: { driverId, channel: 'portal'|'whatsapp'|'copy' }

• /v2/platform/dashboard.html — لوحة مالك المنصّة
• /v2/platform/pharmacies.html — قائمة الصيدليات + بطاقات اشتراك
• /v2/platform/pharmacy-edit.html — تفاصيل صيدلية واحدة
• /v2/pharmacy/owner-dashboard.html — لوحة مالك الصيدلية (موجودة لكن لكلينيك، نحتاج نسخة pharmacy)
• /v2/pharmacy/staff.html — إدارة الموظفين
• /v2/pharmacy/drivers.html — إدارة السائقين + إنشاء روابط واتساب
• /v2/pharmacy/delivery-zones.html — مناطق التوصيل
• /v2/pharmacy/payment-config.html — إعدادات Moyasar/كاش/تحويل لكل صيدلية
• /v2/pharmacy/driver.html — موجودة، تحتاج فلتر driverId + شاشة تحديث الحالة

1. إنشاء أول صيدلية (PHM-MAKKAH-01) كمستند في platform/pharmacies بنفس البيانات الحالية.
2. سكربت ترحيل: إضافة حقل pharmacyId='PHM-MAKKAH-01' لكل مستند موجود في:
   • pharmacy_warehouse_products, pharmacy_warehouse_batches, pharmacy_orders, pharmacy_audit_log.
   • كل سجلات Storage تحت مسار pharmacy/warehouse-images/... تظل كما هي (يضاف pharmacyId ضمن metadata).
3. تفعيل middleware يضيف req.access.pharmacyId من pharmacy_users/{uid} أو من claim مخصّص.
4. تعديل كل endpoint موجود: قبل الكتابة/القراءة يفلتر where('pharmacyId', '==', req.access.pharmacyId). Platform owner يتجاوز الفلتر.
5. إضافة مجموعات جديدة: pharmacy_users, pharmacy_drivers, pharmacy_delivery_zones, pharmacy_payment_configs, pharmacy_storefront_settings, platform_admins.
6. إطلاق Platform Dashboard ودعوة أول صيدليتين تجريبيتين.
7. تنظيف: إزالة الإعدادات العامّة (مثل sales-frozen العامّ) وتحويلها لكل صيدلية.

• لا نلمس checkout / prescription / payment / image generation / sales sync / opening inventory في هذه المرحلة (التزام بقاعدتك الدائمة).
• الدفع per-pharmacy: pharmacy_payment_configs/{pharmacyId} يحتفظ بمراجع لـ Moyasar keys؛ مفاتيح Vercel العامّة تبقى كاحتياط للصيدلية الأم.
• الأيقونة الحالية في portal.html (هذه الصفحة) دلالية — ستُحجب بعد المرحلة D خلف platform_owner.
• كل التغييرات قابلة للترحيل بدون توقّف؛ pharmacyId يُضاف كحقل اختياري أولاً ثم يصبح إجبارياً بعد ترحيل البيانات.