شفى (Shefa) — الوثيقة التقنية الأساسية
Nov 14, 2026 · @Elias
نظرة عامة
شفى منصة Self-hosted لإدارة المنظومة الدوائية والطبية في سوريا، مقسّمة حسب المدن، وتبدأ من الدواء والصيدلية ثم تتوسع نحو الطبيب والمركز الطبي. المرحلة الأولى (MVP) تغطي ثلاثة أطراف: الصيدلية، المستودع الدوائي، والمريض.
الوثيقة قسمان: الشق الأول يحدد الأدوار ومنطق العمل، والشق الثاني يحدد المعمارية والتقنيات.
القرارات المعتمدة
| القرار | المعتمد |
|---|---|
| نطاق MVP | صيدلية + مستودع + مريض. الطبيب وشركات الأدوية والمركز الطبي والتوصيل مراحل لاحقة |
| العمل دون اتصال | شاشة البيع في الصيدلية فقط تعمل أوفلاين وتتزامن لاحقاً. باقي الشاشات أونلاين |
| دليل الأدوية | دليل مركزي تديره المنصة، والمنشآت تقترح الأصناف الناقصة |
| هوية المريض | رقم الموبايل + معرّف شفى ثابت. الرقم الوطني اختياري للتوثيق |
| الوصول للسجل الطبي | بإذن مؤقت من المريض عبر QR أو رمز، وكل وصول مسجّل |
| المعمارية | Monolith معياري (Modular Monolith) قابل للتقسيم لاحقاً |
| التقنيات | NestJS للباكند، React للويب، PostgreSQL لقاعدة البيانات، Flutter للموبايل في مرحلة لاحقة |
| الاستضافة | Self-hosted كامل دون اعتماد على خدمات سحابية مُدارة |
الشق الأول: الأدوار ومنطق العمل
الهوية والأدوار والصلاحيات
كل شخص له حساب واحد ومعرّف شفى واحد، والأدوار تُمنح عبر عضويات تربط الحساب بمنشأة ودور. نفس الشخص يمكن أن يكون مريضاً، وصيدلياً في صيدلية، ومديراً في أخرى، ويبدّل بين السياقات بعد تسجيل الدخول.
المفاهيم الأساسية
- المستخدم (User): الشخص. يدخل برقم الموبايل ورمز OTP، وللموظفين كلمة مرور إضافية.
- المنشأة (Organization): صيدلية، مستودع، شركة أدوية، مركز طبي، أو عيادة. تتبع مدينة واحدة ولها موقع جغرافي.
- العضوية (Membership): مستخدم + منشأة + دور. المنشأة تقبل أكثر من مدير وأكثر من صيدلي.
- الصلاحية (Permission): إذن دقيق مثل
inventory.adjustأوpricing.bulk_update. الأدوار مجموعات جاهزة من الصلاحيات، والمدير يستطيع تخصيصها.
الأدوار
| النطاق | الدور | أهم ما يستطيعه | المرحلة |
|---|---|---|---|
| المنصة | مدير النظام | صلاحية كاملة: إعدادات النظام، حسابات فريق المنصة وأدوارهم، المدن، تعطيل أي حساب أو منشأة، سجل التدقيق | MVP |
| المنصة | مدير العمليات | الإشراف على توثيق المنشآت ومشرفي المدن، متابعة مؤشرات التشغيل، حل النزاعات بين المنشآت، الإعلانات العامة | MVP |
| المنصة | مدير الدعم | إدارة فريق الدعم وتوزيع التذاكر، اعتماد الإجراءات الحساسة، تقارير جودة الدعم | MVP |
| المنصة | موظف دعم | الرد على التذاكر، مساعدة المنشآت في الإعداد، استعادة الوصول للحسابات. لا يعدّل بيانات مالية أو مخزنية | MVP |
| المنصة | مشرف دليل الأدوية | إضافة الأصناف ومراجعة الاقتراحات ودمج المكرر | MVP |
| المنصة | مشرف مدينة | توثيق المنشآت ومراجعة تراخيصها ضمن مدينته | MVP |
| الصيدلية | مدير الصيدلية | كل شيء: الموظفون، الأسعار، المشتريات، الحسابات، اعتماد الجرد، الإحصائيات | MVP |
| الصيدلية | صيدلي | البيع بكل أنواعه، الاستلام، الجرد، الاطلاع على سجل المريض بإذنه | MVP |
| الصيدلية | متدرب / مساعد | بيع الأصناف غير المقيّدة والعدّ في الجرد. لا يعدّل أسعاراً ولا يرى أسعار الشراء ولا سجلات المرضى | MVP |
| المستودع | مدير المستودع | كل شيء ضمن المستودع ومخازنه الفرعية | MVP |
| المستودع | أمين مستودع | الاستلام، التجهيز، التحويل بين المخازن، الجرد | MVP |
| المستودع | مندوب مستودع | زيارة الصيدليات، تقديم العروض وأخذ الطلبات، تحصيل الدفعات، تسليم الأدوية من عهدته | MVP |
| المستودع | محاسب | الفواتير، الدفعات، كشوف الحسابات | MVP |
| شركة الأدوية | مدير الشركة | المكاتب العلمية، المندوبون ومناطقهم، خطط التوزيع، التقارير | لاحقاً |
| شركة الأدوية | أمين مكتب علمي | مخزون العينات في المكتب، صرف العينات للمندوبين، الجرد | لاحقاً |
| شركة الأدوية | مندوب علمي | استلام العينات من المكتب العلمي وتوزيعها مجاناً على الأطباء في جولات منتظمة | لاحقاً |
| المريض | مريض | سجله، تذكيراته، الخريطة، منح وسحب أذونات الوصول | MVP |
| المريض | تابع | ملف طفل أو كبير سن يديره صاحب الحساب الوصي | MVP |
| العيادة | طبيب، سكرتير | السجل بإذن، الوصفات، المواعيد. السكرتير للمواعيد فقط | لاحقاً |
| المركز الطبي | مدير مركز، طبيب مناوب | الخدمات والشيفتات | لاحقاً |
| التوصيل | مندوب توصيل | توصيل الأدوية والخدمات للمنزل | لاحقاً |
توثيق المنشآت
- صاحب المنشأة يسجّل ويدخل البيانات والموقع ويرفع صورة الترخيص.
- مشرف المدينة يراجع ويوافق أو يرفض مع السبب.
- بعد الموافقة تظهر المنشأة على الخريطة وفي كتالوج المستودعات.
إذن الوصول إلى السجل الطبي
- المريض يولّد من تطبيقه QR أو رمزاً قصيراً، والصيدلي أو الطبيب يمسحه.
- الإذن له نطاق (الأدوية والحساسية فقط، أو السجل الكامل) ومدة تنتهي تلقائياً. المقترح: 30 دقيقة للصيدلي، ومدة يختارها المريض للطبيب المعالج.
- المريض يرى قائمة من اطّلع على سجله ومتى، ويسحب أي إذن في أي وقت.
- المتدرب والسكرتير لا يستقبلان أذونات سجل طبي.
إدارة المنصة: النظام والعمليات والدعم
فريق المنصة ثلاثة مستويات منفصلة الصلاحيات: مدير النظام يملك الإعدادات والصلاحيات، مدير العمليات يملك سير العمل اليومي للمنشآت، ومدير الدعم يملك علاقة المستخدمين. لا أحد منهم يقرأ سجلاً طبياً، وكل ما يفعلونه يُكتب في سجل التدقيق.
مدير النظام
- ينشئ حسابات فريق المنصة ويحدد أدوارهم، وهو الوحيد الذي يمنح دور مدير نظام آخر.
- يدير إعدادات النظام العامة: المدن والمحافظات، أنواع المنشآت، القيم الافتراضية للتنبيهات، قوالب الرسائل، مفاتيح الخدمات الخارجية.
- يعطّل أو يعيد تفعيل أي حساب أو منشأة، مع سبب مسجّل.
- يطّلع على سجل التدقيق الكامل وعلى حالة النظام والمراقبة.
- حسابه محمي بتحقق بخطوتين إلزامي، وعدد مدراء النظام محدود ومراجَع دورياً.
مدير العمليات
- يشرف على مشرفي المدن ومشرفي دليل الأدوية، ويعتمد أو يراجع قراراتهم عند الاعتراض.
- يتابع طابور توثيق المنشآت الجديدة ومدة الانتظار فيه.
- يرى لوحة تشغيل: المنشآت النشطة لكل مدينة، الطلبات بين المستودعات والصيدليات، المنشآت المتوقفة عن الاستخدام، اقتراحات الدليل المعلّقة.
- يفصل في النزاعات بين منشأتين، مثل خلاف على استلام طلب أو على دفعة غير مؤكدة، ويرى لذلك مستندات الطرفين المتعلقة بالنزاع فقط.
- ينشر الإعلانات والتنبيهات العامة للمنشآت أو لمدينة محددة.
- يرى أرقاماً مجمّعة، ولا يرى أسعار منشأة أو مبيعاتها التفصيلية خارج نزاع مفتوح.
الدعم
- كل مستخدم أو منشأة يفتح تذكرة من داخل التطبيق، وتُصنّف حسب النوع والأولوية وتُسند لموظف دعم.
- موظف الدعم يرى بيانات الحساب الأساسية وحالة المنشأة وسجل التذاكر، ويستعيد الوصول للحساب بعد التحقق من صاحبه.
- الدخول بالنيابة: لمعاينة مشكلة داخل منشأة، الدعم يطلب جلسة مساعدة يوافق عليها مدير المنشأة. الجلسة للقراءة فقط افتراضياً، محددة المدة، مسجّلة بالكامل، وتظهر للمنشأة في سجلها.
- تصحيح بيانات مالية أو مخزنية لا ينفّذه الدعم مباشرة: يُرفع كطلب تصحيح يعتمده مدير الدعم وتنفّذه المنشأة أو يُنفّذ بحركة عكسية موثّقة.
- مدير الدعم يوزّع التذاكر، يتابع زمن الاستجابة والحل، ويصعّد لمدير العمليات أو للفريق التقني.
فصل الصلاحيات
| الإجراء | مدير النظام | مدير العمليات | مدير الدعم | موظف دعم |
|---|---|---|---|---|
| إدارة فريق المنصة وأدواره | نعم | لا | لا | لا |
| إعدادات النظام | نعم | لا | لا | لا |
| توثيق منشأة أو تعليقها | نعم | نعم | لا | لا |
| الفصل في نزاع بين منشأتين | نعم | نعم | لا | لا |
| إدارة التذاكر وتوزيعها | نعم | اطلاع | نعم | تذاكره فقط |
| استعادة وصول حساب | نعم | لا | نعم | نعم |
| جلسة مساعدة داخل منشأة بموافقتها | نعم | لا | نعم | نعم |
| اعتماد طلب تصحيح بيانات | نعم | نعم | نعم | لا |
| قراءة سجل طبي لمريض | لا | لا | لا | لا |
دليل الأدوية المركزي
الدليل مرجع واحد لكل المنصة، وكل مخزون وعرض ووصفة يشير إلى صنف فيه. هذا ما يجعل البحث عن دواء بين الصيدليات، واقتراح البدائل، وكشف التداخلات ممكناً.
الهيكل
- المادة الفعالة: الاسم العلمي والتصنيف العلاجي (ATC).
- الشركة المصنّعة: جدول مركزي، والصيدلية تحدد الشركات التي تتعامل معها.
- المنتج: الاسم التجاري (عربي وإنكليزي)، الشركة، الشكل الصيدلاني، العيار، حجم العبوة، وحدات البيع الفرعية (علبة، شريط، حبة)، باركود واحد أو أكثر.
- التركيب: ربط المنتج بمواده الفعالة مع تركيز كل مادة.
- قيود الصرف: دون وصفة، بوصفة، بوصفة مختومة، أو مراقَب (مخدر أو نفسي).
- النوع: دواء، مستلزم طبي، أداة طبية، مكمّل، تجميلي.
البدائل والتداخلات
- البديل يُحسب تلقائياً: منتجات بنفس المادة الفعالة والعيار والشكل الصيدلاني.
- التداخلات تُخزّن بين المواد الفعالة مع درجة الشدة ونص التحذير. في MVP الجدول جاهز والتنبيه بسيط عند توفر البيانات، والمحرك الذكي مرحلة لاحقة.
اقتراح صنف ناقص
- الصيدلية أو المستودع لا يجد الصنف فيقترحه باسمه وباركوده وشركته.
- النظام ينشئ صنفاً مؤقتاً خاصاً بالمنشأة، فتستخدمه فوراً دون انتظار.
- مشرف الدليل يوافق، أو يدمجه مع صنف موجود، أو يرفضه.
- عند الموافقة أو الدمج تنتقل كل حركات الصنف المؤقت إلى الصنف المركزي. الصنف المؤقت لا يظهر في بحث المرضى قبل ذلك.
الأسعار
الدليل يحمل سعراً مرجعياً اختيارياً (السعر النظامي إن وُجد). سعر البيع الفعلي وسعر الشراء يُحفظان لكل منشأة على حدة.
الصيدلية
الصيدلية هي مركز النظام: تدير مخزونها على مستوى التشغيلة، تبيع، تشتري من المستودعات، وتظهر للمرضى على الخريطة.
الملف والظهور العام
- الموقع الجغرافي، العنوان، الهاتف، ومعلومات الصيدلي المسؤول.
- مواعيد الفتح والإغلاق لكل يوم، مع استثناءات العطل.
- جدول المناوبات (ليلية وعطل) بالتاريخ، ويظهر للمرضى كـ«صيدلية مناوبة».
- الخدمات التي يحددها الصيدلي: قياس الضغط، قياس السكر، الحقن، وغيرها، مع سعر اختياري.
- التحكم بما يُعرض: المريض يرى «متوفر» أو «غير متوفر» دون الكميات، والصيدلي يستطيع إخفاء أصناف أو فئات. الأصناف المراقَبة لا تظهر للعامة أبداً.
المخزون
- كل كمية مرتبطة بتشغيلة: رقم التشغيلة، تاريخ الانتهاء، سعر الشراء، المصدر.
- البيع يسحب من الأقرب انتهاءً أولاً (FEFO)، ويمنع بيع المنتهي.
- البيع بالعلبة أو بالوحدة الفرعية (شريط، حبة) مع تحويل تلقائي للكميات.
- حد أدنى لكل صنف، وتنبيه عند النزول تحته، وقائمة نواقص تتحول بنقرة إلى طلب شراء.
- تنبيهات الانتهاء قبل 90 و60 و30 يوماً (قابلة للضبط)، وإجراء إتلاف أو إرجاع للمنتهي.
- كل تغيير في الكمية يُسجّل كحركة لا تُعدّل ولا تُحذف: شراء، بيع، مرتجع، تسوية جرد، إتلاف. الرصيد هو مجموع الحركات.
- استيراد المخزون الأولي من ملف Excel عند بدء الاستخدام.
البيع
- إضافة الأصناف بالباركود أو البحث بالاسم التجاري أو المادة الفعالة، مع اقتراح البدائل المتوفرة.
- ربط اختياري بمريض عبر معرّف شفى أو QR، فيُضاف الصرف إلى سجله تلقائياً.
- الصنف المقيّد بوصفة يطلب تأكيد صيدلي وربطاً بالوصفة. الصنف المراقَب يُقيّد في سجل خاص باسم المريض والطبيب والكمية.
- استبدال دواء الوصفة ببديل يُسجّل مع السبب ويظهر في سجل المريض.
- الخصم، المرتجع، البيع بالدين مع دفتر ديون للزبائن، وإغلاق الوردية مع مطابقة الصندوق.
- طباعة إيصال وملصقات باركود.
- شاشة البيع تعمل دون اتصال (التفاصيل في قسم المزامنة).
المشتريات والحسابات مع المستودعات
- تصفّح كتالوج كل مستودع في المدينة: الأصناف، الأسعار، العروض، التوفر، ومقارنة سعر الصنف بين المستودعات.
- طلب شراء من مستودع أو أكثر، ومتابعة حالته.
- استلام مع مطابقة: الكميات، التشغيلات، تواريخ الانتهاء. الفروقات تُسجّل وتُبلّغ للمستودع.
- مرتجع إلى المستودع، وشراء من مصدر خارج النظام بإدخال يدوي.
- كشف حساب مع كل مستودع: الفواتير، الدفعات المالية، المرتجعات، والرصيد المستحق.
التسعير
- تحديث فوري بنسبة مئوية على كل الأصناف، أو شركة، أو فئة، أو مجموعة مختارة.
- معاينة الأسعار الجديدة قبل التطبيق، مع قاعدة تقريب.
- سجل لكل تغيير سعر: من غيّره، متى، والقيمة السابقة، مع إمكانية التراجع عن آخر تحديث جماعي.
- الصلاحية للمدير افتراضياً، ويمكن منحها للصيدلي.
الجرد والمراجعة
- فتح جرد كامل أو جزئي (رف، شركة، فئة).
- العدّ بالباركود من أكثر من جهاز في الوقت نفسه.
- النظام يعرض الفروقات بين المعدود والمسجّل بالكمية والقيمة.
- المدير يعتمد، فتُنشأ حركات تسوية مع السبب.
مناوبات الموظفين
كالندر يوزّع فيه المدير شيفتات الصيادلة والمساعدين، وكل موظف يرى شيفتاته. المبيعات تُنسب للموظف والوردية.
الإحصائيات
- المبيعات والربح حسب اليوم، الصنف، الشركة، والموظف.
- الأكثر مبيعاً، والراكد، ومعدل دوران المخزون.
- قيمة المخزون الحالية، وقيمة ما سينتهي خلال 90 يوماً.
- عدد المرضى لكل دواء ولكل مادة فعالة، ومرضى الأدوية المزمنة المتوقّع عودتهم هذا الشهر.
- الطلب غير الملبّى: أدوية بحث عنها المرضى في المنطقة ولم تكن متوفرة.
- المديونية للمستودعات وديون الزبائن.
المستودع الدوائي
المستودع يبيع للصيدليات فقط، ويستخدم نفس محرك المخزون الذي تستخدمه الصيدلية مع إضافة المخازن الفرعية والعروض والحسابات الجارية. هو طرف مختلف عن شركة الأدوية المصنّعة، والشركة لها قسمها بعد هذا القسم.
المخزون
- مستودع رئيسي ومخازن فرعية، لكل مخزن رصيده، مع تحويل موثّق بين المخازن.
- تشغيلات وتواريخ انتهاء وFEFO وتنبيهات انتهاء وحد أدنى، كما في الصيدلية.
- إدخال الاستلام من شركات الأدوية يدوياً أو من ملف Excel.
- جرد دوري بنفس دورة العدّ والاعتماد.
الكتالوج والعروض
- المستودع يحدد ما يعرضه للصيدليات: الصنف، السعر، الحد الأدنى للطلب، وحالة التوفر.
- العرض على كمية: خصم بنسبة، أو بونص مثل 10 + 2.
- الباكج: عدة أصناف بكميات محددة بسعر واحد.
- لكل عرض مدة صلاحية، وكمية إجمالية محدودة اختيارية، واستهداف اختياري لصيدليات أو مدن محددة.
- إشعار للصيدليات عند نشر عرض جديد، وعرض تصريف للأصناف القريبة الانتهاء.
دورة الطلب
- مسودة: الصيدلية تبني السلة من الكتالوج أو من قائمة النواقص.
- مُرسل: يصل الطلب إلى المستودع.
- مؤكّد: المستودع يؤكد كلياً أو جزئياً، وتُحجز الكميات. أو يرفض مع السبب.
- مجهّز: أمين المستودع يجهّز ويحدد التشغيلات، وتصدر الفاتورة.
- مُسلّم: البضاعة خرجت من المستودع.
- مُستلم: الصيدلية تطابق وتستلم، فيدخل المخزون إليها بتشغيلاته وتواريخه دون إعادة إدخال.
- مغلق: بعد تسوية أي فروقات أو مرتجعات.
الحسابات والدفعات
- حساب جارٍ واحد بين كل مستودع وكل صيدلية، يراه الطرفان بنفس الأرقام.
- الفاتورة تزيد المديونية. الدفعة المالية (نقداً أو حوالة) والدفعة الدوائية (مرتجع بضاعة) تنقصانها.
- الدفعة يسجّلها طرف ويؤكدها الطرف الآخر، والنظام يسجّل فقط ولا ينفّذ دفعاً إلكترونياً.
- حد ائتمان لكل صيدلية يحدده المستودع، وتنبيه عند تجاوزه.
- كشف حساب بالفترة، وأعمار الديون، وتصدير PDF وExcel.
مندوب المستودع
المندوب يمثّل المستودع في الميدان: يمرّ على الصيدليات، يعرض، يأخذ الطلبات، يحصّل الأموال، ويسلّم الأدوية. كل ما يفعله يُسجّل على حساب الصيدلية الجاري نفسه، فلا يوجد دفتر جانبي.
- الجولات: لكل مندوب قائمة صيدليات ومنطقة، وخطة زيارات دورية. الزيارة تُسجّل بالوقت والموقع والنتيجة.
- العروض والطلبات: المندوب يعرض عروض المستودع السارية وينشئ الطلب باسم الصيدلية من موبايله، والصيدلية تؤكده من حسابها أو برمز تأكيد.
- عهدة الأدوية: المندوب يستلم كمية من المستودع فتنتقل إلى مخزن متنقل باسمه، ثم يسلّم منها للصيدليات. كل تسليم يصدر فاتورة ويدخل مخزون الصيدلية بتشغيلاته، وما لم يُسلَّم يعود للمستودع بمطابقة.
- التحصيل: المندوب يسجّل الدفعة التي قبضها ويصدر إيصالاً، والصيدلية تؤكدها. المبلغ يبقى عهدة نقدية على المندوب حتى يورّده للمحاسب ويطابقه.
- المرتجعات: يستلم المرتجع من الصيدلية فيدخل عهدته ثم المستودع.
- الرقابة: المدير يرى لكل مندوب عهدته من الأدوية والنقد، زياراته، مبيعاته، وتحصيلاته. فرق العهدة عند المطابقة يُسجّل على المندوب.
الإحصائيات
المبيعات حسب الصيدلية والصنف والمدينة، أداء العروض، المديونية المستحقة، الراكد، وقيمة ما سينتهي قريباً. المستودع لا يرى مبيعات الصيدليات ولا مخزونها.
شركة الأدوية والمكتب العلمي
شركة الأدوية طرف مستقل عن المستودع: لا تبيع للصيدليات عبر النظام، ودورها هنا هو التعريف بأدويتها عبر توزيع عينات مجانية على الأطباء. تدخل مع مرحلة الطبيب لأن التوزيع يحتاج حسابات الأطباء.
المكتب العلمي
- الشركة تملك مكتباً علمياً أو أكثر، كل مكتب في مدينة، وهو مخزن صغير للعينات فقط.
- مخزون العينات يُدار بنفس محرك المخزون: تشغيلات، تواريخ انتهاء، تنبيهات، جرد. العينة صنف من الدليل المركزي معلَّم «عينة مجانية غير مخصصة للبيع».
- العينات لا تظهر للمرضى ولا تدخل مخزون أي صيدلية، والنظام يمنع بيعها.
المندوب العلمي
- أمين المكتب يصرف للمندوب كمية عينات، فتنتقل إلى عهدته.
- المندوب يزور الأطباء ضمن منطقته واختصاصاتهم حسب خطة زيارات دورية تضعها الشركة.
- في كل زيارة يسجّل الطبيب والعينات المسلَّمة وكمياتها، والطبيب يؤكد الاستلام من حسابه أو برمز.
- ما بقي في العهدة يُرحّل للجولة التالية أو يعود للمكتب بمطابقة.
ما تراه الشركة
- تغطية الأطباء: من زِير ومتى، ومن لم يُزَر ضمن الدورة.
- العينات الموزعة حسب الصنف والمندوب والمدينة والاختصاص، وعهدة كل مندوب.
- الشركة لا ترى سجلات المرضى ولا وصفات طبيب بعينه. أي إحصاء عن وصف أدويتها يكون مجمّعاً دون أسماء، وإتاحته قرار مفتوح.
حدود الطبيب
الطبيب يحدد إن كان يستقبل مندوبين وفي أي أوقات، ويرى سجل العينات التي استلمها. إعطاء عينة لمريض يُسجّل اختيارياً في سجل المريض كدواء مصروف من الطبيب.
المريض
المريض يملك سجله الطبي ويتحكم بمن يراه، ويستخدم النظام لثلاثة أشياء في MVP: متابعة أدويته، إيجاد الدواء، وإيجاد أقرب صيدلية.
الحساب والمعرّف
- التسجيل برقم الموبايل ورمز OTP. الرقم الوطني اختياري لتوثيق الحساب.
- معرّف شفى ثابت لا يتغير بتغيّر رقم الموبايل، قصير وقابل للإملاء مع خانة تحقق، ويظهر كـQR في التطبيق.
- التابعون: صاحب الحساب ينشئ ملفات لأطفاله أو لكبار السن، لكل ملف معرّف شفى خاص.
- ملف دون تطبيق: الصيدلي ينشئ ملفاً لمريض برقم موبايله، والمريض يستلمه لاحقاً عند تسجيله بنفس الرقم.
السجل الطبي في MVP
- الأمراض المزمنة والحساسية، يدخلها المريض.
- الأدوية الحالية: الدواء من الدليل، الجرعة، المواعيد، تاريخ البدء والانتهاء.
- الوصفات: صورة يرفعها المريض في MVP، وتصبح رقمية من الطبيب في المرحلة التالية.
- سجل الصرف: يُضاف تلقائياً عندما تبيع صيدلية للمريض بعد مسح معرّفه، مع تسجيل أي استبدال.
- هيكل السجل مصمم من الآن ليستقبل زيارات الأطباء والعمليات والتقارير لاحقاً دون إعادة بناء.
التذكيرات
- تذكير الجرعة في موعدها، مع تأكيد «أخذتها» أو «تخطيتها» وسجل التزام.
- تذكير إعادة الشراء: يُحسب من الكمية المصروفة والجرعة اليومية، وينبّه قبل النفاد بأيام.
- في تطبيق Flutter تُجدول التذكيرات محلياً على الجهاز فتعمل دون إنترنت. قبل صدور التطبيق تعمل عبر إشعارات الويب وهي أقل موثوقية.
الخريطة والبحث
- الصيدليات القريبة مرتبة بالمسافة، مع فلتر «مفتوحة الآن» و«مناوبة».
- البحث عن دواء يعرض الصيدليات التي يتوفر فيها، ويقترح البدائل إن لم يتوفر.
- صفحة الصيدلية: الأصناف المعروضة، الأدوات والمستلزمات الطبية، الخدمات، الدوام، الهاتف.
- طلب حجز دواء: المريض يطلب والصيدلي يؤكد ويحجز الكمية لمدة محددة.
الحالة الإسعافية
- زر واحد يعرض أقرب الصيدليات المفتوحة أو المناوبة الآن، مع اتصال مباشر واتجاهات.
- المريض يستطيع إرسال اسم الدواء المطلوب للصيدليات القريبة، وأول من يؤكد التوفر يظهر له.
- الشاشة تعرض أرقام الطوارئ وتوضّح أن الخدمة لا تغني عن الإسعاف.
الطبيب والمركز الطبي والتوصيل (مراحل لاحقة)
هذه الأدوار خارج MVP، لكن نموذج البيانات والصلاحيات يُبنى من الآن ليستوعبها.
الطبيب
- يطّلع على سجل المريض بإذنه فقط: الأمراض، الزيارات، العمليات الجراحية، الأدوية وكمياتها ومواعيدها، وأي استبدال دواء، مرتبة زمنياً.
- أسماء الأطباء الآخرين لا تظهر. يظهر الاختصاص والتاريخ فقط، والإخفاء يُطبّق في الـAPI لا في الواجهة.
- نموذج تقرير موحّد لكل الاختصاصات (الزيارة): الشكوى، التشخيص بترميز ICD-10، الإجراءات، الوصفة، المرفقات. الحقول الخاصة بكل اختصاص تُضاف كقالب مرن فوق الجزء الموحّد.
- الوصفة الرقمية تُحفظ في النظام وتُطبع للختم، وتحمل QR يتحقق منه الصيدلي. الصيدلي يصرف عليها فتُعلّم مصروفة كلياً أو جزئياً.
- كالندر المواعيد بأسماء المرضى، والنقر على الموعد يفتح السجل إن وُجد إذن.
- المريض يرى الأوقات المتاحة ويحجز. السكرتير يدير المواعيد والدور دون أي وصول للسجل الطبي.
المركز الطبي أو المستوصف
- يظهر على الخريطة مع قائمة خدماته ومواعيدها.
- الطبيب يأخذ شيفتات في أكثر من مركز بنفس حسابه.
- مدير المركز يدير الشيفتات من كالندر مطابق لكالندر مناوبات الصيدلية، وهو نفس الموديول.
التوصيل والتداخلات الذكية
- دور مندوب توصيل للأدوية والخدمات المنزلية، يُبنى فوق طلب حجز الدواء الموجود في MVP.
- محرك تداخلات دوائية وتوصيات يقرأ أدوية المريض الحالية ويحذّر الطبيب عند الوصف والصيدلي عند الصرف. يُربط كموديول مستقل خلف واجهة ثابتة، والقرار النهائي للطبيب أو الصيدلي.
خارطة المراحل
المراحل مرتبة بحيث تعتمد كل واحدة على ما قبلها، والمدد الزمنية تُحدد بعد معرفة حجم الفريق.
- الأساس: الهوية والأدوار، المدن والمنشآت والتوثيق، دليل الأدوية ولوحة إدارته، لوحة فريق المنصة (النظام والعمليات والدعم)، البنية التحتية والنشر.
- MVP — الصيدلية: المخزون، البيع مع الأوفلاين، التسعير، الجرد، المناوبات، الإحصائيات.
- MVP — المستودع: المخزون والمخازن الفرعية، الكتالوج والعروض، دورة الطلب، الحسابات والدفعات، مندوب المستودع الميداني.
- MVP — المريض: الحساب والمعرّف، السجل الأساسي، الخريطة والبحث، الحالة الإسعافية، التذكيرات، أذونات الوصول.
- الموبايل والطبيب: تطبيق Flutter للمريض، ثم الطبيب والسكرتير، الوصفة الرقمية، حجز المواعيد، ثم شركات الأدوية والمكاتب العلمية وتوزيع العينات.
- المركز الطبي: الخدمات وشيفتات الأطباء.
- التوسع: التوصيل المنزلي، محرك التداخلات والتوصيات.
المرحلتان 2 و3 تُبنيان معاً لأنهما تتشاركان محرك المخزون. المرحلة 4 تبدأ بعد أن يصبح في النظام مخزون حقيقي لصيدليات في مدينة واحدة على الأقل، وإلا يبحث المريض فلا يجد شيئاً.
الشق الثاني: المعمارية والتقنيات
المعمارية العامة والموديولات
النظام تطبيق NestJS واحد يُنشر كوحدة واحدة، مقسّم داخلياً إلى موديولات يملك كل منها بياناته وواجهته. هذا يعطي بساطة التشغيل الآن، ويسمح بفصل أي موديول إلى خدمة مستقلة لاحقاً دون إعادة كتابة.
flowchart TB
web["React web app (PWA)"]
mobile["Flutter mobile app (later)"]
admin["Platform admin console"]
proxy["Caddy reverse proxy: TLS, REST /v1, WebSocket"]
web --> proxy
mobile --> proxy
admin --> proxy
subgraph mono["NestJS modular monolith (one deployable)"]
direction TB
identity
organizations
catalog
inventory
sales["sales (POS)"]
procurement
accounting
patients
notifications
search["search and map"]
analytics
audit["audit and sync"]
backoffice
bus["Public interfaces + domain events (outbox)"]
worker["Background worker: reminders, expiry alerts, reports"]
end
proxy --> mono
mono --> pg[("PostgreSQL + PostGIS: one schema per module, RLS")]
mono --> redis[("Redis: cache, BullMQ job queues")]
mono --> s3[("S3-compatible storage: prescriptions, licences, files")]
كل العملاء يمرّون عبر بوابة واحدة إلى تطبيق واحد، والموديولات داخله لا تتشارك الجداول. موديولات المراحل اللاحقة (clinical، appointments، samples، delivery) تُضاف بجانب هذه دون تغييرها.
قواعد الموديولات
- كل موديول يملك جداوله ضمن schema خاص به في PostgreSQL، ولا يقرأ موديول جداول غيره مباشرة.
- التواصل بين الموديولات عبر واجهة عامة معلنة أو عبر أحداث النطاق (Domain Events) فقط.
- الحدث يُكتب في جدول outbox ضمن نفس معاملة قاعدة البيانات ثم يُنشر، فلا يضيع عند انقطاع أو إعادة تشغيل.
- قاعدة فحص آلية في الـCI تمنع الاستيراد من داخل موديول آخر.
- داخل كل موديول أربع طبقات: API، حالات الاستخدام، النطاق، البنية التحتية.
الموديولات
| الموديول | المسؤولية | المرحلة |
|---|---|---|
| identity | الحسابات، OTP، الجلسات، العضويات، الأدوار والصلاحيات | MVP |
| organizations | المنشآت، المدن، التوثيق، الدوام، المناوبات، شيفتات الموظفين، الخدمات | MVP |
| catalog | دليل الأدوية، المواد الفعالة، الشركات، الباركودات، الاقتراحات، التداخلات | MVP |
| inventory | التشغيلات، حركات المخزون، المخازن الفرعية وعهدة المندوبين، الجرد، تنبيهات النقص والانتهاء. مشترك بين الصيدلية والمستودع | MVP |
| sales | البيع، المرتجعات، الورديات، ديون الزبائن، التسعير | MVP |
| procurement | كتالوج المستودعات، العروض، الطلبات، الاستلام، جولات المندوبين وزياراتهم | MVP |
| accounting | الحسابات الجارية بين المنشآت، الفواتير، الدفعات، كشوف الحساب | MVP |
| patients | ملف المريض، السجل الطبي، الأدوية والجرعات، أذونات الوصول وسجلها | MVP |
| notifications | الإشعارات، SMS، التذكيرات المجدولة | MVP |
| search | البحث الجغرافي، توفر الدواء، الحالة الإسعافية | MVP |
| analytics | الإحصائيات والتقارير، تُبنى من الأحداث في جداول تجميعية | MVP |
| audit | سجل التدقيق غير القابل للتعديل | MVP |
| sync | استقبال عمليات البيع الأوفلاين وتسويتها | MVP |
| clinical | الزيارات، التقارير الموحّدة، الوصفة الرقمية | لاحقاً |
| appointments | المواعيد والحجز والدور | لاحقاً |
| delivery | التوصيل المنزلي | لاحقاً |
| samples | المكاتب العلمية، صرف العينات، زيارات الأطباء، تقارير التغطية. يعتمد على inventory للمخزون والعهدة | لاحقاً |
| backoffice | لوحة فريق المنصة: التذاكر، جلسات المساعدة، النزاعات، طلبات التصحيح، الإعلانات، لوحة العمليات | MVP |
تعدد المنشآت
- قاعدة بيانات واحدة مشتركة، وكل صف تشغيلي يحمل
organization_id. - العزل بطبقتين: فحص الصلاحية في التطبيق، وRow-Level Security في PostgreSQL كشبكة أمان إن أخطأ الكود.
- الدليل والمدن بيانات مشتركة. سجل المريض ملك المريض لا المنشأة، والوصول إليه عبر الأذونات فقط.
الواجهات
- REST موثّق بـOpenAPI تحت
/v1، ونفس الـAPI يخدم الويب وتطبيق Flutter. - WebSocket للأحداث الحية: طلب جديد للمستودع، تأكيد توفر في الحالة الإسعافية، تنبيهات.
- كل عملية كتابة حساسة تحمل مفتاح idempotency، فإعادة الإرسال على شبكة ضعيفة لا تكرر العملية.
مسار التوسع
- خادم واحد أو اثنان بـDocker Compose.
- فصل الـworker، وإضافة نسخة قراءة من PostgreSQL للتقارير والبحث.
- أكثر من نسخة API خلف الموازن، فالتطبيق لا يحفظ حالة في الذاكرة.
- استخراج موديول إلى خدمة مستقلة عند الحاجة الفعلية، والمرشحان الأولان هما البحث والإشعارات.
الستاك التقني
كل المكونات مفتوحة المصدر وتعمل على خوادمنا، واللغة الموحّدة TypeScript في الباكند والويب. الإصدارات تُثبّت على أحدث LTS عند بدء التنفيذ.
| الطبقة | الاختيار | السبب |
|---|---|---|
| الباكند | NestJS على Node.js LTS | مطلوب، ونظام الموديولات فيه يناسب المعمارية المعيارية |
| قاعدة البيانات | PostgreSQL مع PostGIS وpg_trgm | مطلوب. PostGIS للبحث بالمسافة، وpg_trgm للبحث التقريبي بالأسماء العربية والإنكليزية |
| الوصول للبيانات | Drizzle ORM مع ملفات migration بـSQL | قريب من SQL، فيتعامل بسهولة مع RLS وPostGIS والـschemas المتعددة. البديل: Prisma |
| الكاش والطوابير | Redis مع BullMQ | المهام الخلفية: التذكيرات، تنبيهات الانتهاء، التقارير، نشر الـoutbox |
| البحث | PostgreSQL في MVP | يكفي للحجم الأولي. Meilisearch يُضاف إن احتاج البحث سرعة أعلى |
| الملفات | تخزين متوافق مع S3 (Garage أو SeaweedFS أو MinIO) | صور الوصفات والتراخيص والمرفقات. الاختيار النهائي بعد مراجعة الترخيص وحالة الصيانة |
| الويب | React + TypeScript + Vite | مطلوب. تطبيق واحد بمساحات لكل دور، أو تطبيقان: المنشآت والمريض |
| حالة البيانات في الويب | TanStack Query | كاش وإعادة محاولة تناسب الشبكة الضعيفة |
| واجهة المستخدم | Tailwind CSS مع مكونات shadcn/ui | دعم RTL كامل للعربية، مع بنية ترجمة جاهزة للغة ثانية |
| الأوفلاين | PWA بـService Worker وIndexedDB عبر Dexie | شاشة البيع تعمل دون اتصال ودون تثبيت برنامج |
| الخرائط | MapLibre GL مع بلاطات OpenStreetMap مستضافة ذاتياً | لا اعتماد على مزوّد خرائط خارجي ولا مفاتيح API مدفوعة |
| الموبايل | Flutter، مرحلة لاحقة | مطلوب. يستهلك نفس الـAPI، وعميله يُولّد من OpenAPI |
| المصادقة | OTP عبر SMS، JWT قصير العمر مع refresh token متجدد، Argon2 لكلمات المرور | منفّذة داخل النظام دون مزوّد هوية خارجي |
| الزمن الحقيقي | WebSocket عبر NestJS Gateway | إشعارات حية داخل التطبيق |
| الطباعة والملفات | توليد PDF في الخادم بمحرك يدعم العربية، وطباعة المتصفح للإيصالات | الفواتير، كشوف الحساب، الوصفات، ملصقات الباركود |
| المستودع البرمجي | Monorepo بـpnpm workspaces | الباكند والويب وحزمة الأنواع المشتركة في مكان واحد |
| الاختبارات | Vitest أو Jest، Testcontainers، Playwright | اختبار على PostgreSQL حقيقي، واختبار شاشة البيع مع قطع الشبكة |
| الحاويات | Docker مع Docker Compose | نشر بسيط يناسب فريقاً صغيراً. Kubernetes غير مطلوب في البداية |
| البوابة | Caddy | TLS تلقائي وإعداد قصير. البديل: Nginx |
| CI/CD | Gitea أو GitLab مستضاف ذاتياً مع runners | الكود والبناء والنشر على خوادمنا |
| المراقبة | Prometheus، Grafana، Loki، وGlitchTip للأخطاء | مقاييس وسجلات وتتبع أخطاء دون خدمات خارجية |
ثلاث خدمات لا يمكن استضافتها ذاتياً بالكامل وتحتاج قراراً: بوابة SMS، وإشعارات الموبايل (Push)، ونشر التطبيق على المتاجر. هي مدرجة في الأسئلة المفتوحة.
نموذج البيانات الأساسي
النموذج مبني على ثلاثة سجلات لا تُعدّل بعد الكتابة: حركات المخزون، القيود المالية، وسجل التدقيق. الأرصدة تُشتق منها، فكل رقم في النظام يمكن تفسيره ومراجعته.
الكيانات حسب الموديول
| الموديول | الجداول الرئيسية |
|---|---|
| identity | users، memberships، roles، permissions، sessions، otp_codes |
| organizations | governorates، cities، organizations، working_hours، duty_shifts، staff_shifts، services |
| catalog | substances، manufacturers، products، product_substances، barcodes، product_proposals، interactions |
| inventory | storage_locations، stock_items، batches، stock_movements، stocktakes، stocktake_lines |
| sales | sales، sale_lines، returns، cash_sessions، customer_debts، price_changes، controlled_register |
| procurement | listings، offers، offer_items، orders، order_lines، receipts، rep_routes، rep_visits |
| accounting | accounts، invoices، payments، ledger_entries، cash_custody |
| patients | patients، conditions، allergies، medications، dose_schedules، prescriptions، dispensings، access_grants، access_logs |
| notifications | devices، notifications، reminders |
| audit و sync | audit_log، outbox، client_operations |
| samples (لاحقاً) | territories، visit_plans، doctor_visits، sample_handouts |
| backoffice | tickets، ticket_messages، support_sessions، disputes، correction_requests، announcements |
العلاقات المهمة
stock_itemsيربط منشأة بمنتج: سعر البيع، الحد الأدنى، الظهور للعامة.batchesتحمل التشغيلة والانتهاء وسعر الشراء والكمية لكل مخزن.stock_movementsسطر لكل تغيير كمية: النوع، التشغيلة، الكمية بالموجب أو السالب، المستند المصدر، الموظف. كمية التشغيلة المخزّنة تُحدّث في نفس المعاملة.- استلام الصيدلية لطلب مستودع ينشئ حركة خروج عند المستودع وحركة دخول عند الصيدلية بنفس بيانات التشغيلة.
accountsحساب واحد لكل زوج (مستودع، صيدلية).ledger_entriesقيد لكل فاتورة أو دفعة أو مرتجع، والرصيد مجموعها.patientsمنفصل عنusers: الملف قد يوجد دون حساب (تابع، أو ملف أنشأه صيدلي) ويُربط بحساب لاحقاً. معرّف شفى عمود فريد فيه.access_grants: المريض، المستفيد (عضوية)، النطاق، وقت الانتهاء، وقت السحب. كل قراءة للسجل تكتب سطراً فيaccess_logs.
عهدة المندوب، سواء مندوب مستودع أو مندوب علمي، هي storage_location من نوع «متنقل» مرتبطة بعضويته. الصرف له والتسليم منه والإرجاع كلها حركات مخزون عادية، فلا يحتاج منطقاً خاصاً ويظهر في الجرد. النقد المحصَّل يُسجّل في cash_custody حتى توريده.
اصطلاحات
- المفاتيح UUID v7، وهذا يسمح لشاشة البيع بتوليد معرّفات العمليات أوفلاين.
- المبالغ
numericمع عمود عملة، ولا تُستخدم الأرقام العشرية العائمة. الكميات تُخزّن بأصغر وحدة بيع كعدد صحيح. - الأوقات تُخزّن UTC وتُعرض بتوقيت دمشق.
- الموقع الجغرافي عمود
geographyمع فهرس GiST. stock_movementsوaudit_logوaccess_logsتُقسّم شهرياً (partitioning) لأنها الأسرع نمواً.- الحذف منطقي (soft delete) للبيانات المرجعية، والسجلات المالية والمخزنية تُصحّح بحركة عكسية لا بالحذف.
البيع أوفلاين والمزامنة
شاشة البيع في الصيدلية تستمر بالعمل عند انقطاع الإنترنت، والخادم يقبل كل عملية بيع تمت أوفلاين دون رفض. البيع حصل فعلاً والدواء خرج من الرف، فالنظام يسجّل الواقع ثم يعلّم التعارضات للمراجعة.
ما يعمل أوفلاين وما لا يعمل
| العملية | أوفلاين |
|---|---|
| البيع والمرتجع ومسح الباركود وطباعة الإيصال | نعم |
| البحث في أصناف الصيدلية وأسعارها وبدائلها | نعم، من النسخة المحلية |
| إغلاق الوردية | نعم، ويُعتمد بعد المزامنة |
| فتح سجل مريض | لا |
| المشتريات والاستلام والجرد وتعديل الأسعار | لا |
الآلية
- عند الاتصال، الجهاز يحفظ في IndexedDB نسخة من أصناف الصيدلية وتشغيلاتها وأسعارها، ويحدّثها بالفروقات فقط.
- كل عملية بيع تُكتب فوراً في طابور محلي بمعرّف يولّده الجهاز، مع معرّف الجهاز والموظف والوقت المحلي. الكتابة تسبق طباعة الإيصال، فانقطاع الكهرباء لا يضيّع عملية.
- عند عودة الاتصال، الطابور يُرسل بالترتيب إلى موديول sync. المعرّف يمنع تسجيل العملية مرتين مهما تكرر الإرسال.
- الخادم يحوّل كل عملية إلى حركات مخزون ويرجع نتيجة التسوية، ثم يسحب الجهاز النسخة المحدّثة.
قواعد التسوية
- السعر: يُعتمد السعر الذي بِيع به فعلاً، حتى لو تغيّر على الخادم خلال الانقطاع.
- التشغيلة: إن نفدت التشغيلة التي اختارها الجهاز، يسحب الخادم من التشغيلة التالية حسب FEFO ويسجّل ذلك.
- الرصيد السالب: مسموح مؤقتاً. الصنف يُعلّم ويظهر في تقرير فروقات يراجعه المدير ويسوّيه بجرد جزئي.
- أكثر من جهاز: كل جهاز يبيع من نسخته، والتعارض بينها يُحل بنفس القواعد عند المزامنة.
- الأصناف المقيّدة: تُباع أوفلاين مع إدخال بيانات الوصفة يدوياً، وتُعلّم للمراجعة.
الحدود والأمان
- الجلسة تبقى صالحة أوفلاين مع قفل بـPIN لكل موظف.
- بعد مدة قصوى دون مزامنة (المقترح 72 ساعة) تتوقف الشاشة عن البيع حتى تتصل.
- الواجهة تعرض دائماً حالة الاتصال وعدد العمليات غير المزامَنة.
- النسخة المحلية لا تحوي بيانات مرضى ولا أسعار شراء لمن لا يملك صلاحيتها.
الأمن والخصوصية
النظام يحمل بيانات صحية، فالقاعدة أن لا أحد يقرأ سجل مريض دون إذن سارٍ منه، وكل قراءة تترك أثراً يراه المريض.
- العزل: صلاحيات على مستوى العملية في التطبيق، وRow-Level Security في قاعدة البيانات لكل جدول يحمل
organization_id. - السجل الطبي: الوصول عبر
access_grantsفقط، بنطاق ومدة، مع سجل قراءة لا يُعدّل. مدير النظام وفريق العمليات والدعم لا يقرؤون السجلات من لوحة الإدارة. - التشفير: TLS لكل اتصال، تشفير الأقراص على الخوادم، وتشفير إضافي على مستوى الحقل للبيانات الأشد حساسية (الرقم الوطني، التشخيصات).
- المصادقة: تحديد معدل لطلبات OTP ومحاولات الدخول، جلسات مرتبطة بالجهاز مع إمكانية إنهائها، وتحقق بخطوتين لمدراء المنشآت ومشرفي المنصة.
- التدقيق: كل تعديل سعر أو تسوية مخزون أو دفعة أو تغيير صلاحية يُكتب في
audit_logبالفاعل والوقت والقيمة السابقة. - الملفات: صور الوصفات والتراخيص تُخدّم بروابط موقّعة قصيرة العمر، لا بروابط عامة.
- حقوق المريض: تصدير سجله، سحب الأذونات، وطلب حذف حسابه ضمن ما يسمح به القانون.
- التشغيل: الأسرار خارج الكود، وصول الخوادم بمفاتيح SSH فقط، نسخ احتياطية مشفّرة، وتحديثات أمنية دورية للحاويات والحزم.
البنية التحتية والتشغيل
البداية بخادمين وموقع نسخ احتياطي منفصل، وكل شيء يُنشر بـDocker Compose من مستودع واحد.
التوزيع الأولي
| الخادم | ما يعمل عليه |
|---|---|
| التطبيق | Caddy، حاوية API، حاوية worker، ملفات الويب الثابتة، Redis، خادم بلاطات الخرائط |
| البيانات | PostgreSQL، تخزين الملفات |
| النسخ الاحتياطي | موقع مختلف جغرافياً: نسخ قاعدة البيانات والملفات وأرشيف WAL |
| الأدوات | Git وCI والمراقبة، على خادم صغير مستقل أو مع خادم التطبيق في البداية |
النسخ الاحتياطي والاسترجاع
- pgBackRest: نسخة كاملة يومية وأرشفة مستمرة للـWAL، تسمح بالاسترجاع إلى أي لحظة.
- الهدف المقترح: فقد بيانات لا يتجاوز 15 دقيقة، وعودة الخدمة خلال 4 ساعات.
- اختبار استرجاع شهري فعلي على بيئة staging، فالنسخة التي لم تُجرّب لا يُعتمد عليها.
- نسخة قراءة (replica) تُضاف في الخطوة التالية وتصلح بديلاً عند تعطل الخادم الرئيسي.
النشر والبيئات
- ثلاث بيئات: تطوير محلي، staging، إنتاج.
- خط CI: فحص الأنواع وحدود الموديولات، الاختبارات، بناء الصور، نشر إلى staging، ثم نشر يدوي التأكيد إلى الإنتاج.
- الـmigrations متوافقة مع النسخة السابقة من الكود، فالنشر لا يوقف الخدمة والتراجع ممكن.
- نسخة PWA القديمة على جهاز أوفلاين تبقى متوافقة مع الـAPI، لذلك نقطة المزامنة تحمل رقم إصدار وتدعم الإصدار السابق.
الشبكة الضعيفة
- ضغط الاستجابات، ترقيم الصفحات، واستجابات صغيرة بالحقول المطلوبة فقط.
- ملفات الواجهة تُخزّن في المتصفح، فالفتح الثاني لا يحمّل شيئاً من الشبكة.
- الصور تُضغط على الجهاز قبل الرفع.
- إعادة المحاولة التلقائية آمنة لأن عمليات الكتابة تحمل مفتاح idempotency.
المراقبة
تنبيهات على توقف الخدمة، امتلاء القرص، فشل النسخ الاحتياطي، تراكم طابور المهام، وارتفاع نسبة الأخطاء أو زمن الاستجابة.
افتراضات وأسئلة مفتوحة
الافتراضات التالية بُنيت عليها الوثيقة دون أن تُسأل، والأسئلة بعدها تحتاج جواباً قبل بدء التنفيذ.
افتراضات
- النظام يسجّل الدفعات ولا ينفّذ دفعاً إلكترونياً.
- الواجهة عربية RTL أولاً، وبنية الترجمة جاهزة للإنكليزية.
- المريض يستخدم واجهة ويب متجاوبة (PWA) في MVP إلى أن يصدر تطبيق Flutter.
- المريض يرى توفر الدواء دون الكميات.
- المستودع لا يرى مخزون الصيدليات ولا مبيعاتها.
- مندوب المستودع ضمن MVP. شركات الأدوية والمكاتب العلمية تدخل مع مرحلة الطبيب، والشركة لا تبيع عبر النظام.
- قاعدة بيانات واحدة مشتركة لكل المدن والمنشآت.
أسئلة مفتوحة
- العملة: هل الأسعار بالليرة السورية فقط، أم تُحفظ أسعار الشراء بالدولار مع سعر صرف؟ الجواب يغيّر التسعير والحسابات والتقارير.
- بوابة SMS: ما المزوّد المتاح لإرسال OTP داخل سوريا، وهل واتساب بديل مقبول؟
- إشعارات الموبايل: هل خدمات Push المعتادة ونشر التطبيق على المتاجر متاحة للمستخدمين في سوريا؟ إن لا، نحتاج بديلاً مستضافاً ذاتياً وتوزيع APK مباشر.
- مكان الاستضافة: خوادم داخل سوريا أم خارجها؟ يؤثر على السرعة والموثوقية والوضع القانوني للبيانات الصحية.
- مصدر دليل الأدوية: هل توجد قائمة رسمية أو نقابية بالأدوية المسجّلة وباركوداتها نبدأ منها، أم يُبنى الدليل يدوياً مع أول الصيدليات؟
- المتطلبات القانونية: ما الذي تفرضه وزارة الصحة ونقابة الصيادلة على سجل الأدوية المراقَبة، الوصفة المختومة، وحفظ البيانات الصحية؟ يحتاج مراجعة مختص.
- التسعير النظامي: هل يوجد سعر رسمي ملزم للدواء، وهل يُسمح للصيدلية بتجاوزه؟
- نموذج الربح: اشتراك شهري للمنشآت، عمولة على الطلبات، أم مجاني في البداية؟ يحدد إن كنا نحتاج موديول اشتراكات.
- أسعار الصيدلية للمريض: هل يرى المريض سعر الدواء في كل صيدلية أم التوفر فقط؟
- الأجهزة: ما المتوفر في الصيدليات من قارئات باركود وطابعات إيصالات، وهل الاستخدام الغالب كمبيوتر أم تابلت أم موبايل؟
- الفريق والمدة: عدد المطورين والموعد المستهدف لأول إطلاق، لتحويل خارطة المراحل إلى جدول زمني.
- شركات الأدوية: هل تدخل مع مرحلة الطبيب كما افترضنا أم قبلها؟ وهل تبيع الشركة للمستودعات عبر النظام لاحقاً؟
- بيانات الوصف للشركات: هل يُتاح للشركة إحصاء مجمّع دون أسماء عن وصف أدويتها، أم لا يُتاح أبداً؟
- تسليم المندوب: هل يسلّم مندوب المستودع أدوية من عهدته مباشرة دون طلب مسبق، أم التسليم دائماً مقابل طلب مؤكد؟