دعم Serial + ASTM للأجهزة (Maglumi / Mispa)

أجهزة كتير (مجلومي، ميسبا) بتشتغل Serial على منفذ COM ببروتوكول ASTM — مش شبكة/HL7 زي DH36. الخطة دي بتضيف دعم serial+ASTM للميدل وير والكاتالوج. (بحث + تصميم قبل التنفيذ.)

1 نتيجة البحث على الأجهزة

الجهاز	التوصيل	البروتوكول	الإعدادات
Maglumi (Snibe) مناعي/هرمونات	RS-232 (COM) أو TCP/IP	ASTM E1394 (بعضها HL7)	9600 / 8 / N / 1 · null-modem
Mispa (Agappe) كيمياء/دم	RS-232 (COM) غالباً	ASTM (E1381+E1394)	9600 / 8 / N أو odd / 1
DH36 (الموجود)	TCP (شبكة)	HL7 (MLLP)	مدعوم بالفعل

المصادر: Maglumi 800 LIS · Maglumi 2000 (ASTM/HL7, COM/TCP) · ASTM E1381/E1394 (9600-8-N-1)

2 الفرق عن DH36 (ليه محتاج بناء جديد)

DH36 (موجود): جهاز ──TCP/شبكة──► listener على بورت ──HL7/MLLP──► parse Maglumi/Mispa: جهاز ──كابل COM──► منفذ COM (COM3) ──ASTM frames──► parse

Transport مختلف: منفذ COM فيزيائي (مش بورت شبكة) — محتاج مكتبة pyserial (صغيرة).
Framing مختلف: ASTM E1381 = ENQ/ACK/NAK/EOT + إطارات STX..ETX+checksum (مش MLLP).
Records مختلفة: ASTM E1394 = سجلات H/P/O/R/L (Header/Patient/Order/Result/Terminator) — مش OBX بتاع HL7.

3 اللي يتبني في الميدل وير

أ. Transport serial (جديد)

serial_server.py: يفتح منفذ COM بـpyserial (port/baud/bytesize/parity/stopbits من الإعدادات) ويقرا بايتات باستمرار.
بديل لـDeviceServer (TCP) — الـapp يختار transport حسب نوع الاتصال.

ب. ASTM framing + parser (جديد)

astm.py: handshake (ENQ→ACK, إطار→ACK, EOT) + تجميع الإطارات + تحقّق checksum.
drivers/astm_generic.py: يقرا سجلات H/P/O/R → باركود (من O) + نتائج (من R: كود، قيمة، وحدة، فلاج).

ج. تكامل

نفس الـoutbox + الرفع للسحابة + الواجهة (الجهاز يظهر «يستمع على COM3»).
المزامنة تشمل أجهزة الـserial (interface=serial + com_port) — مش هتتخطّاها بعد كده.
pyserial يتثبّت على الجهاز (pip install pyserial).

ثنائي الاتجاه (Bidirectional) — مرحلة لاحقة

ASTM بيدعم إن الجهاز يستعلم عن أوردرات العينة من الـLIS. نبدأ باستقبال النتائج بس (أبسط ويغطي 90%)، ونضيف الرد على الاستعلام بعدين لو محتاجين.

4 الكاتالوج: Maglumi + Mispa كأنواع

نضيف نوع Maglumi: driver=astm_serial، protocols=[astm, serial]، + تحاليله (هرمونات: TSH, T3, T4, FSH, LH…) ورنجاتها.
نضيف نوع Mispa: driver=astm_serial، + تحاليله (كيمياء أو دم حسب الموديل).
حقول الإعداد للـserial (com_port/baud/parity) موجودة بالفعل في connection_settings — نظهرها في فورم الكاتالوج/النسخة لما النوع serial.
العميل يعمل نسخة من النوع → يحط منفذ الـCOM بتاعه (COM3) بدل البورت.

محتاج منك للأكواد والرنجات

زي DH36 — لو بعتّلي عينة ASTM حقيقية من Maglumi/Mispa (أو قائمة تحاليلها وأكوادها)، أعبّي الكاتالوج صح. ولو مش متاح دلوقتي، أبني الأنواع فاضية وتتعبّى بعدين.

5 فورم الإعداد (serial)

لما يكون النوع serial، فورم النسخة يعرض حقول الـCOM بدل البورت:

الحقل	مثال
منفذ COM	COM3
Baud rate	9600
Data bits / Parity / Stop bits	8 / None / 1

6 خطة التنفيذ

1Middleware — ASTM framing + parser. astm.py + drivers/astm_generic.py + اختبار بعينة ASTM وهمية.
2Middleware — Serial transport. serial_server.py بـpyserial + اختيار transport حسب الاتصال + تثبيت pyserial على الجهاز.
3المزامنة + الواجهة. تشمل أجهزة serial؛ الواجهة تعرض «COM3» + حالة المنفذ.
4الكاتالوج. أنواع Maglumi + Mispa (driver astm، تحاليل + رنجات) + فورم serial.
5اختبار حقيقي. توصيل جهاز فعلي على COM + التأكد إن النتائج بتوصل.

7 قرارات قبل التنفيذ

الأولوية: أبني استقبال النتائج فقط (أبسط، يغطي المعظم)، ولا أعمل ثنائي الاتجاه (استعلام أوردرات) من الأول؟
الدرايفر: driver واحد عام astm_serial يخدم Maglumi و Mispa (ASTM قياسي)، ولا driver منفصل لكل جهاز؟
أكواد/رنجات Maglumi & Mispa: تبعتلي عينة ASTM/قائمة تحاليل وأعبّيها، ولا أبني الأنواع فاضية دلوقتي؟
الاختبار: فيه جهاز Maglumi/Mispa متوصّل على COM دلوقتي نقدر نجرّب عليه، ولا لسه؟