Middleware متعدد الفروع والأجهزة — التحليل المعماري

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

1 الصورة الكاملة (Topology)

┌─────────────────────────────┐ │ Moon ERP (السحابة) │ │ سجل واحد لكل الأجهزة │ │ ┌─────────────────────┐ │ │ │ DH36-A (id 3) │ │ │ │ DH36-B (id 7) │ │ ← كل الأجهزة (كل الفروع) │ │ Maglumi (id 2) │ │ code فريد لكل واحد │ │ CBC-Lab2 (id 9) ... │ │ │ └─────────────────────┘ │ └───────┬───────────┬─────────┘ مزامنة (كل الأجهزة)│ │(كل الأجهزة) ┌────────────────────┘ └────────────────────┐ ┌────────▼─────────┐ ┌─────────────▼────────┐ │ فرع 1 — محطة A │ │ فرع 2 — محطة B │ │ Middleware #1 │ │ Middleware #2 │ │ يشوف الكل، يفعّل: │ │ يشوف الكل، يفعّل: │ │ ✅ DH36-A :5600 │ │ ✅ CBC-Lab2 :5600 │ │ ⬜ DH36-B │ │ ✅ DH36-B :5601 │ │ ⬜ Maglumi ... │ │ ⬜ الباقي ... │ └────────┬─────────┘ └──────────┬───────────┘ │ TCP/HL7 │ TCP/HL7 ┌─────▼─────┐ ┌─────▼─────┐ │ جهاز DH36-A│ │ جهازين │ └───────────┘ └───────────┘

القاعدة الأساسية

الكلود = سجل واحد لكل الأجهزة (كل الفروع). كل محطة middleware بتسحب القائمة كاملة، لكن بتفعّل محلياً الجهاز/الاتنين المتوصّلين عندها فقط. قرار «التفعيل» قرار محلي لكل محطة — مش في الكلود.

2 الهوية الفريدة لكل جهاز

ممكن يكون في أكتر من جهاز من نفس الموديل (٢ × DH36)، وفرع واحد فيه أكتر من جهاز. فلازم كل جهاز يتميّز بهوية فريدة:

الحقل	الدور	الحالة
`id` (machine_id)	المعرّف الرقمي الفريد — يتبعت مع كل نتيجة	موجود
`code`	كود فريد للجهاز (UNIQUE في DB) — مثلاً `DH36-A`، `DH36-B`	موجود + UNIQUE
`name`	اسم مقروء يميّز الجهاز للمستخدم	موجود
`branch_id`	الفرع التابع له الجهاز	غير موجود — يُضاف

توصية: نضيف `branch_id` للأجهزة

دلوقتي الأجهزة مربوطة بالشركة بس (company_id) من غير فرع. عشان تعرف كل جهاز في أي فرع (وتفلتر المزامنة لاحقاً)، نضيف branch_id على الجهاز في الكلود. مش شرط للـMVP لكنه الأنضف للتوسّع.

3 منطق التفعيل: «محلي» مش «تلقائي»

⚠️ تصحيح للمنطق اللي بنيته أول

النسخة الأولى من المزامنة كانت بتفعّل أي جهاز active — ده غلط هنا، لأن كل الأجهزة active في الكلود، فكل محطة كانت هتحاول تفعّل الكل → تعارض بورتات + استقبال غلط.

المنطق الصحيح

المزامنة بتجيب كل الأجهزة كـ«معروفة»، بس التفعيل افتراضياً OFF للأجهزة الجديدة.
المستخدم على المحطة يفعّل يدوياً الجهاز/الاتنين المتوصّلين فعلياً عنده.
حالة «مُفعّل» بتتخزّن محلياً في config.json بتاع المحطة (مش في الكلود) — فكل محطة ليها مجموعتها.
المزامنة التالية بتحافظ على التفعيل المحلي (بالـmachine_id)، وتحدّث الأسماء/البورتات من الكلود.

4 إدارة البورتات

كل جهاز مُفعّل على محطة لازم يكون له بورت فريد على المحطة دي. بما إن المحطة بتفعّل ١–٢ بس، التفرّد مطلوب بين المُفعّلين عندها فقط.

connection_settings.port في الكلود = البورت المقترح الافتراضي.
لو محطة عندها جهازين بنفس البورت المقترح → المستخدم يغيّر بورت واحد منهم محلياً (override).
الـmiddleware بيكشف تعارض البورت ويبيّنه (bind error) في الواجهة بوضوح.

5 هوية المحطة (Workstation)

عشان نعرف أي محطة شغّالة وأي أجهزة عليها، كل نسخة middleware ليها اسم محطة:

إعداد محلي جديد workstation_name (مثلاً «فرع المعادي — محطة 1») يظهر في الواجهة.
يتبعت مع الـheartbeat للكلود → الكلود يعرف «الجهاز X آخر مرة اتشاف على محطة Y».
(مستقبلاً) لو ضفنا workstation_key على الجهاز في الكلود، المزامنة تقدر تفعّل تلقائياً أجهزة المحطة دي من غير تدخّل يدوي.

6 تدفق المزامنة (المصحّح)

#	الخطوة
1	المحطة تنادي `GET /lis/machines` → كل أجهزة الشركة.
2	تفلتر: `interface ∈ {tcp, hl7}` + `connection_settings.port` موجود.
3	لكل جهاز (بالـmachine_id): تحدّث الاسم/البورت/الدرايفر من الكلود، وتحافظ على enabled المحلي.
4	الأجهزة الجديدة → enabled = false (المستخدم يفعّلها).
5	تحفظ `config.json` وتعيد تشغيل المستمعين للأجهزة المُفعّلة فقط.
6	الواجهة تعرض: كل الأجهزة (الكل)، مع توجل تفعيل + الحالة الحية لكل واحد.

7 اللي اتعمل واللي ناقص

العنصر	الحالة
تثبيت Python على المحطة + الـmiddleware شغّال	تم
واجهة ويب (config + حالة حية + log)	تم
اتصال الكلود (login admin@moonerp.com) + رفع النتائج	تم ومُختبر
سحب الأجهزة من الكلود (sync) + `connection_settings`	مبني — يحتاج تصحيح التفعيل
تفعيل محلي (preserve enabled، جديد=OFF)	يُعدّل
اسم المحطة + إرساله في heartbeat	يُضاف
كشف تعارض البورت في الواجهة	يُحسّن
`branch_id` على الجهاز (كلود + فورم LIS Machines)	قرار

8 قرارات محتاجينها

التفعيل التلقائي: نكتفي بالتفعيل اليدوي على كل محطة (MVP بسيط)، ولا نضيف workstation_key على الجهاز في الكلود عشان كل محطة تفعّل أجهزتها أوتوماتيك؟
الفروع: نضيف branch_id للأجهزة دلوقتي (وفورم LIS Machines يبقى فيه اختيار الفرع)، ولا نأجّله؟
فورم الأجهزة في الكلود: نظبّط فورم LIS Machines يبقى فيه حقول الربط (port / driver / barcode fields) بشكل واضح بدل JSON خام في connection_settings؟
الدرايفرات: دلوقتي عندنا dymind_hl7 بس. الأجهزة التانية (Maglumi…) محتاجة درايفرات — نبنيها دلوقتي ولا نركّز على الـCBC أول؟