🔬 ربط جهاز VITROS بالـ LIS — فهم المنظومة + خطة الدرايفر والميدل-وير

مبني على: دليل VITROS LIS (ASTM/HL7) + كود الـ LIS الفعلي + جهاز الميدل-وير الويندوز (DESKTOP-0J1HSJM)

1. الجهاز الجديد

VITROS (Ortho Clinical Diagnostics) — الموديلات: 5600 Integrated · 4600 Chemistry · 3600 Immunodiagnostic · XT 7600 · XT 3400. بيتكلّم ASTM (E1381/E1394) و HL7 (MLLP) عبر Ethernet أو Serial. الدليل فيه كل سجلات ASTM (H/P/O/R/C/Q) ورسائل HL7 (OML/OUL/ORL) + أكواد التحاليل (Appendix B) وأكواد النتائج. الـ VITROS بيرفع النتائج للـ host (الميدل-وير) ويقدر يستقبل الطلبات منه.

2. المنظومة — 3 طبقات

جهاز VITROSASTM/HL7 عبر TCP/Serial

الميدل-وير (Python)DESKTOP-0J1HSJM · يستقبل + يـ parse

الـ LIS السحابي/lis/machine-results · مطابقة + إدخال

نتيجة التحليلتتعبّى تلقائيًا على الطلب

أ) الميدل-وير (Python)

⭐ مصدر الحقيقة = moon-erp-be/lis-middleware/ (مُتحكَّم بالإصدار، شوف DEPLOY.md). تركيب الويندوز C:\Users\HP\lis-middleware = نسخة منشورة منه. نعدّل في السورس + commit → ننسخ lis_middleware/+run.py للويندوز (نسيب config.json المحلي) → نعيد التشغيل. اتأكّد النهاردة: نسخة الويندوز **متطابقة 100%** مع السورس (19/19 ملف). دليل شامل: moon-erp-be/docs/lis/analyzer-middleware-guide.md.

يشتغل بـ run.py --config config.json · بيرفع لـ moonui.elbaset.com/moon-erp-be/api · workstation = DESKTOP-0J1HSJM · دخول: ssh -p 2222 hp@localhost.

registry الدرايفرات: lis_middleware/drivers/__init__.py → DRIVERS = {"dymind_hl7":…, "maglumi_astm":…, "mispa_astm":…, "udichem_astm":…}.
أساس ASTM: drivers/astm_base.py (مشترك لكل درايفرات ASTM) · HL7: drivers/dymind_hl7.py (parse + build_ack).
النقل: astm_tcp_server.py / serial_server.py (ASTM) · mllp.py (HL7) · cloud.py (الرفع + login + buffer أوفلاين في buffer.sqlite3).
الأجهزة الشغّالة حاليًا (في config.json → devices[]): Dymind DH36 (dymind_hl7, port 5600, machine_id 3) · Maglumi 800 (maglumi_astm, port 15001, machine_id 6). كل device فيه: driver · listen_port · barcode_fields · send_ack · إعدادات serial.

ب) الـ LIS السحابي (Moon ERP)

الكيان	الدور
LabDeviceModel (كاتالوج)	name/manufacturer/model + `driver` (نص، مثل `vitros_astm`) + protocols + barcode_fields + قائمة تحاليل الجهاز (analyzer_code/unit/ranges)
LabMachine (نسخة)	device_model_id + interface_type (tcp/serial/hl7) + `connection_settings` (driver/host/port/serial) + `workstation` + الحالة
LabMachineTestMapping	ربط `machine_test_code` (كود الجهاز) ↔ `investigation_id` (تحليلك)
الاستقبال: `POST /lis/machine-results`	مطابقة بالباركود → عينة → تحليل، وتعبئة النتيجة تلقائيًا (+ auto-verify لو مفعّل) + `/communication-logs` للأرشفة
`GET /lis/machines/agent-config?workstation=`	الميدل-وير بيسحب منه إعداد الأجهزة (اختياري — حاليًا الأجهزة في config.json المحلي)

3. وصفة ربط VITROS (الخطوات)

① الميدل-وير جديد

درايفر جديد drivers/vitros_astm.py — مبني على astm_base.py (لأن VITROS بيستخدم ASTM E1394 قياسي)، مع خصوصيات سجلات/أكواد VITROS من الدليل. (لو هنستخدم HL7 بدل ASTM → vitros_hl7.py على نمط dymind_hl7.py.)
تسجيله في drivers/__init__.py → DRIVERS["vitros_astm"] + إضافته لـ KNOWN_DRIVERS.
إضافة device في config.json: {name, machine_id, driver:"vitros_astm", listen_port:<منفذ حر>, barcode_fields, send_ack}.
التحقق: نلتقط رسالة ASTM حقيقية من الجهاز (capture) ونتأكد البارسر بيطلّع barcode + test_code + value صح.

② الـ LIS السحابي جديد

LabDeviceModel "VITROS <الموديل>": driver=vitros_astm، protocols=["astm"]، + تحاليل الجهاز بأكوادها (Appendix B).
LabMachine نسخة: device_model + connection (host/port)، workstation=DESKTOP-0J1HSJM، machine_id (نفس اللي في config.json).
ربط التحاليل: كل analyzer_code ↔ التحليل المقابل عندك.

③ التشغيل

الجهاز يبعت → الميدل-وير يستقبل على المنفذ → vitros_astm.parse → POST نتائج → تتطابق وتتعبّى على الطلب. نتابع في lis-middleware.log + شاشة نتائج الأجهزة + سجل الاتصالات.

4. محتاج منك (قبل ما أبني) قرار

أنهي موديل VITROS؟ (5600 / 4600 / 3600 / XT 7600 / XT 3400) — بيحدّد التحاليل (كيمياء/مناعة).
ASTM ولا HL7؟ (الجهاز بيدعم الاتنين — أنهي مفعّل/مظبوط عندك؟). الافتراضي ASTM زي ما الدليل بيركّز.
التوصيل: Ethernet (IP الجهاز + المنفذ اللي بيتصل بيه على الميدل-وير) ولا Serial (COM)؟ ونحجز منفذ listen (مثلاً 15002).
التحاليل: أنهي تحاليل بيعملها الجهاز، وإزاي أكواده تتطابق مع تحاليلك (أو سيبها لي أطابقها بالكود/الاسم وتراجع)؟
عيّنة رسالة: لو فيه capture لرسالة من الجهاز (ASTM/HL7) يكون مثالي لمعايرة البارسر — أو نلتقطها وقت التوصيل.

التوصية

أبدأ بدرايفر vitros_astm على نمط maglumi_astm/astm_base + تعريف الجهاز في الـ LIS، ونعاير البارسر على أول capture. جاوب على الأسئلة وأبدأ.