منصة متعددة الأدوار لمرافقة المرضى والرعاية المنزلية

منصة بنمط الخادم الأحادي المعياري (modular monolith) لطلبات مرافقة المرضى في المستشفيات ومقدمي الرعاية والخدمات المنزلية. تضم برنامجًا مصغّرًا للمرضى، وبرنامجًا مصغّرًا وتطبيقًا لمقدمي الرعاية، ولوحتي تحكم للمستشفى والمشغّل، ونطاق دفتر حسابات منفصلًا لتقسيم المدفوعات والتسوية.

باختصار: بنينا خادمًا واحدًا بنمط الخادم الأحادي المعياري يخدم المرضى ومقدمي الرعاية والمستشفيات والمشغّل في طلبات المرافقة والرعاية المنزلية، وأبقينا حركة الأموال في مخطط دفتر حسابات منفصل، وقصرنا التوزيع والتتبع على ما تستطيعه البرامج المصغّرة على الهاتف.

نظرة عامة

يطلب المرضى وذووهم الخدمة عبر برنامج مصغّر. ويستلم مقدمو الرعاية المهام وينجزونها عبر برنامج مصغّر آخر وتطبيق Flutter. وتستخدم المستشفيات والمشغّل لوحات تحكم على الويب. بدأ البناء بمراجعة بنية منظمة قدّمت مخاطر الامتثال وتقسيم المدفوعات على اختيار إطار العمل.

بنية منصة خدمات الرعاية: البرنامج المصغّر للمرضى، والبرنامج المصغّر والتطبيق لمقدمي الرعاية، ولوحة تحكم المستشفى ولوحة تحكم المشغّل تستدعي خادمًا بنمط الخادم الأحادي المعياري مع وحدات أعمال ومخطط دفتر حسابات منفصل على PostgreSQL؛ ومزود الدفع وقنوات الإشعارات خارجها.

المشكلة

تشمل خدمات المرافقة والرعاية عدة أطراف: المريض، والأسرة، ومقدم الرعاية، والمستشفى، والمشغّل. ولكل طرف واجهة مختلفة. ويجب تقسيم الدفعة بين المنصة ومقدمي الخدمة ضمن قواعد قناة الدفع. كما يجب أن تعمل ميزات الموقع وتوزيع المهام في حدود ما تستطيعه البرامج المصغّرة فعلًا على الهاتف.

القيود

  • وصول المرضى عبر برنامج مصغّر على منصة مراسلة فقط. ويحتاج جانب مقدمي الرعاية إلى هوية تطبيق منفصلة لأن الجانبين يحتاجان إلى صلاحيات مختلفة.
  • البرامج المصغّرة تتوقف مؤقتًا في الخلفية، فلم يكن التتبع الحي المستمر وعدًا يمكن الاعتماد عليه. وتغيرت صياغة المنتج إلى “كل خطوة من خطوات الخدمة مسجّلة”.
  • تحدّ قناة الدفع من الجزء الذي يمكن تقسيمه من الدفعة. وكان على قواعد التسوية أن تلتزم بهذا الحد.
  • أُرجئ التمريض المنزلي من المرحلة الأولى إلى أن يمكن استيفاء متطلبات الترخيص وأجهزة التسجيل بموجب معيار إقليمي لخدمات التمريض.

البنية

الجزءالتنفيذ
الخادمJava 21، وSpring Boot 4.1؛ كتلة Maven واحدة متعددة الوحدات تضم 15 وحدة، منها order وstaff وhospital وmarket وpay وsettle وnotify
البياناتPostgreSQL 17 بمخططين منفصلين للأعمال ولدفتر الحسابات؛ jOOQ في نطاق الدفتر، وSpring Data JDBC في نطاق الأعمال؛ وكل تغيير في المخطط ترحيل Flyway بإصدار
العملاءبرنامجان مصغّران بإطار العمل الأصلي للمنصة، وتطبيق Flutter لمقدمي الرعاية، ولوحتا تحكم للمستشفى والمشغّل بـ Vue 3
البيئة المحليةDocker Compose مع خدمة محاكاة لمنصة المراسلة، فتعمل مسارات تسجيل الدخول والدفع دون بيانات اعتماد حقيقية

القرارات الرئيسية

  1. كتلة واحدة مقسّمة إلى وحدات، لا خدمات مصغّرة. الطلب والتوزيع والتسوية تتشارك وحدة نشر واحدة، فتبقى معاملاتها محلية؛ وتُفرض حدود الوحدات في الشيفرة بدلًا من الشبكة.
  2. نطاق دفتر حسابات منفصل. التسوية والتقسيم مكتوبان بـ SQL صريح في مخططهما الخاص، ولا يكتب نطاق الأعمال السجلات المالية مباشرة أبدًا، فيمكن تتبع كل حركة مالية إلى وحدة واحدة.
  3. لا وعود لا تستطيع المنصة الوفاء بها. بدلًا من بث الطلبات ليلتقطها الأسرع، يعتمد التوزيع على الإسناد الموجّه، ومهلة تأكيد تتصاعد عند انقضائها، ومكالمات صوتية آلية.
  4. العقود قبل الشيفرة. كُتبت عقود API وقاعدة البيانات والسمات والبيئات والاختبارات أولًا، وسجلت مراجعة البنية البنود التي لا يقررها إلا مالك المشروع.

الأدلة

  • 287 صنف اختبار Java و156 ملف ترحيل بإصدارات في الخادم.
  • تشمل وثائق المستودع تقرير تدقيق كاملًا (2026-09-17) ومراجعة تسليم (2026-09-19).

الحدود

لا تُنشر أحجام الطلبات ولا حالة التشغيل الحالية ولا المؤسسات الشريكة ولا الشروط المالية. تفسير اللوائح في هذه الحالة مدخل هندسي، وليس استشارة قانونية.

الأسئلة الشائعة

لماذا برامج مصغّرة بدلًا من تطبيق أصلي للمرضى؟

يدخل المرضى بمسح رمز في المستشفى. وخلصت مراجعة البنية إلى أن البرامج المصغّرة تناسب نقطة الدخول هذه وقنوات الدفع، فلن يضيف تطبيق أصلي منفصل الكثير للمرضى.

كيف يُدار المال؟

لنطاق دفتر الحسابات مخططه الخاص، وهو وحده الذي يكتب السجلات المالية. وقواعد التقسيم مصممة ضمن حدود قناة الدفع.

هل يدعم النظام تتبع مقدمي الرعاية في الزمن الحقيقي؟

تسجّل المنصة كل خطوة من خطوات الخدمة. ولا تعد بتتبع حي مستمر، لأن البرامج المصغّرة لا تستطيع مواصلة الإبلاغ عن الموقع في الخلفية.