ترجمة آلية — لم يراجعها أي شخص

تُرجمت هذه الصفحة آليًا. لم يراجع أي شخص هذه الترجمة أو يعتمدها، وقد تحتوي على أخطاء. الصفحة بلغة المصدر هي النص المرجعي. اقرأ النص الأصلي (بالإنجليزية)

Machine translation — not reviewed by a person. Read the original (English)

الحالة: تقرّر في 2026-10-23: الخيار B، على مراحل، مع مكتبة Rust/wasm للويب في الأثناء (memory/dir-app-platform.md). أُجري البحث في 2026-10-23. السؤال: على أي أساس يُبنى تطبيق J1–J4، بحيث يشغّل مكتبة HCERT بلغة Kotlin على Android (وعلى الويب، في الحالة المثلى) على أحدث إصدار من Open Health Stack وأكثره أصالةً في Kotlin؟

1. ما هو Open Health Stack اليوم

بدأ Open Health Stack (OHS) مجموعةً من المكونات بقيادة Google، وهو الآن مؤسسة OHS للبرمجيات، وهي مشروع مجتمعي تحت مظلة Linux Foundation، انضمت إليه منظمة الصحة العالمية (WHO) في يوليو 2026. تقع شيفرته في github.com/ohs-foundation (28 مستودعًا). وهناك جيلان من مكتبات العميل:

الجيل المكتبات المنصات التوزيع الحالة
android-fhir (الجيل الأول) com.google.android.fhir:engine، data-capture (SDC)، workflow، knowledge Android فقط Google Maven «قيد الصيانة»؛ آخر إيداع في فبراير–مارس 2026. تشغّل مكتبة Workflow لغة CQL (مبنية على HAPI، وثقيلة).
Kotlin Multiplatform (الحالي) dev.ohs.fhir:fhir-model-r4 1.0.0-rc03، fhir-path-r4، fhir-engine 2.0.0-alpha04، fhir-data-capture 2.0.0-alpha04، fhir-workflow 2.0.0-alpha01؛ dev.ohs.player:client 1.0.0-alpha03 Android، وJVM لسطح المكتب، وiOS، والويب (wasmJs، وJS لبعضها) Maven Central نشط (إيداعات هذا الأسبوع)؛ واجهات برمجية في مرحلة ألفا. تنفّذ Workflow PlanDefinition/$apply؛ أما CQL فـ«لم تأتِ بعد».

فوق جيل KMP يقع OHS Player، الذي تصفه المؤسسة بأنه مجموعة أدوات مرجعية عابرة للطبقات، «مرجع، لا منتج»:

لذلك فإن الخيار الأحدث والأكثر أصالةً في Kotlin هو جيل KMP، مع قالب Player أو دونه.

2. القيود التي يجب أن يستوفيها كل خيار

  1. يجب أن يعمل اختبار المحاكي Android لمكتبة HCERT (STT-GEN-004) في CI على بيئة تشغيل Android، بما في ذلك تشفير المنصة. وهو مستقل عن التطبيق: إنه وحدة اختبار Android صغيرة لا تعتمد إلا على ملف jar الخاص بـ HCERT (الخطوة 4 من الخطة). ويمكن إدماجه قبل قرار التطبيق.
  2. عرض توضيحي دون اتصال ودون خادم. فالرحلة J2 دون اتصال بطبيعتها، ولا يستطيع CI إقامة مزوّد OIDC وخادم FHIR لتشغيل المحاكي بتكلفة زهيدة. لذا يحتاج التطبيق إلى وضع للبيانات المضمَّنة.
  3. سلسلة الإمداد. كل عنصر مُثبَّت ببصمة sha256، والإصدارات عمرها ≥ 14 يومًا، ولا نصوص تثبيت. وكلما قلّت التبعيات كان أفضل.
  4. تأتي مكتبة HCERT من إيداع مُثبَّت في smart-trust-tools بصيغة jar لـ JVM (اختيار المالك). على Android يعمل ملف jar لـ JVM كما هو. أما على الويب فلا يعمل بعد: هدف Kotlin/JS في hcert-core يستخدم node:crypto وnode:zlib، فيعمل على Node لا في المتصفح، ولا يوجد هدف wasmJs. وأي واجهة أمامية للويب تحتاج إما إلى هدف للمتصفح في hcert-core (WebCrypto، CompressionStream)، أو إلى تغيير في المكتبة في smart-trust-tools، أو إلى مكتبة Rust/wasm التي تعمل في المتصفح بالفعل بمفاتيح WebCrypto.

3. الخيارات

الخيار A — اشتقاق نسخة من التطبيق المرجعي OHS Player

إنشاء التطبيق من قالب player-reference؛ وإضافة وضع عرض توضيحي دون اتصال (حزمة FHIR مضمَّنة، دون تسجيل دخول)، وشاشات J1–J4، واستدعاءات HCERT.

الإيجابيات السلبيات
إنه OHS Player: النتيجة الأوضح انتماءً إلى «OHS»، والأقرب إلى ما سيبدأ منه منفّذو OHS. يتطلب مزوّد OIDC وخادم FHIR للبدء؛ والوضع دون اتصال علينا كتابته ومواصلة دمجه مع قالب يتغير أسبوعيًا.
Android وiOS وسطح المكتب والويب من شجرة واحدة؛ شاشات مُقادة بالإعدادات؛ واستبيانات SDC للتسجيل (J2) والاستيراد (J3) موصولة جاهزةً. نحو 57 مكتبة و8 مكونات إضافية في فهرسه (Koin وKtor CIO/Darwin وKermit وksafe وkotlinpoet وBigNum وCompose adaptive …)، وعدة منها في مرحلة ألفا، إضافةً إلى رسمها البياني المتعدي: أكبر عبء تثبيت وتحقق بين جميع الخيارات.
قابل للرفع إلى المصدر الأصلي: يمكن أن تصبح الرحلات لاحقًا متغيرًا في player-reference-examples. Kotlin 2.3 / AGP 8.11 / JDK 21؛ ومنطق البناء وتوليد الشيفرة فيه (ig-codegen) علينا تدقيقهما.
  كثير من القالب (المصادقة، والمزامنة، وسجلات القوى العاملة) لا صلة له بالرحلات، وهو ضجيج في تطبيق توضيحي.

الخيار B — تطبيق خاص خفيف بـ Compose Multiplatform على مكتبات OHS KMP (موصى به)

تطبيق صغير بـ Compose Multiplatform (Android أولًا، ومعه هدف للويب) مكتوب للرحلات الأربع، يستخدم المكتبات الأساسية نفسها التي يستخدمها Player — fhir-model-r4، وfhir-engine (مخزن على الجهاز)، وfhir-data-capture (استبيانات SDC للتسجيل في J2 والاستيراد في J3)، وfhir-workflow (PlanDefinition/$apply لجدول التطعيم في J3) — واختياريًا dev.ohs.player:client للعروض المُقادة بالإعدادات.

الإيجابيات السلبيات
مكتبات OHS الحالية نفسها التي يستخدمها Player، فيُظهر الطبقة التي تبنيها مؤسسة OHS، دون طبقة المصادقة/المزامنة/حقن التبعيات (DI) في القالب. ليس تطبيق Player نفسه؛ والشاشات من صنعنا.
دون اتصال ودون خادم منذ البداية؛ ويمكن لمهمة CI على المحاكي أن تقود الرحلات. مكتبات KMP في مرحلة ألفا: علينا استيعاب التغييرات الكاسرة في واجهات API بين إصدارات ألفا.
مجموعة التبعيات هي تقريبًا الرسم البياني للمكتبات نفسها (Compose MP وKtor client وRoom3/SQLite وkotlinx) — ولا تزال كبيرة، لكن كل إضافة مختارة ومدرجة في docs/dependencies.md. لا يدعم fhir-workflow لغة CQL بعد: يجب التعبير عن قواعد جدول التطعيم في J3 بوصفها شروط انطباق PlanDefinition بلغة FHIRPath (وهذا يكفي لجدول جرعة الولادة؛ أما CQL الخاصة بالتمنيع في SMART لدى منظمة الصحة العالمية (WHO) فتنتظر).
يشكّل الشيفرة بحيث يمكن لاحقًا عرض شاشات الرحلات على player-reference-examples بوصفها متغيرًا من Player.  

الخيار C — Android فقط، على android-fhir (الجيل الأول)

تطبيق Android بسيط على com.google.android.fhir Engine + SDC (+ Workflow).

الإيجابيات السلبيات
ناضج ومُثبَت في الإنتاج (OpenSRP وEmCare)؛ ولديه أكثر التوثيق والأمثلة. قيد الصيانة؛ وليس الاتجاه الذي تسير فيه OHS؛ وAndroid فقط (دون ويب).
مكتبة Workflow تشغّل CQL اليوم (محتوى إرشادات SMART لدى منظمة الصحة العالمية (WHO)). تجلب Workflow مكتبة HAPI FHIR + محرك CQL: رسم بياني ضخم جدًا للتبعيات، يعتمد بكثافة على JVM.
  عناصر Google Maven؛ تحجب سياسة الشبكة في الجلسة حاليًا dl.google.com (اللازم لهذا الخيار ولـ AGP/AndroidX في كل خيار).

الخيار D — الويب أولًا، دون تطبيق Android

صفحة ثابتة على gh-pages تشغّل J1–J4 في المتصفح بمكتبة Rust/wasm (أو بنسخة مستقبلية من hcert-core للمتصفح)، إضافةً إلى وحدة اختبار Android فقط من أجل STT-GEN-004.

الإيجابيات السلبيات
الأصغر: تبعيات شبه معدومة؛ والأسهل في عرضه على أي شخص عبر رابط. ليس OHS؛ ولا يُظهر مكتبة Kotlin داخل تطبيق OHS، وهو الهدف المعلن.
مكتبة Rust/wasm تعمل في المتصفح بالفعل. لا تُختبَر مكتبة Kotlin على Android إلا بالاختبارات، لا عبر رحلة.

4. التوصية

الخيار B، على مراحل:

  1. وحدة اختبار Android من أجل STT-GEN-004 أولًا (مستقلة عن هذا الاختيار).
  2. تطبيق B، بهدف Android، دون اتصال، J1–J4، على محرك dev.ohs.fhir + التقاط البيانات + سير العمل.
  3. هدف الويب للتطبيق نفسه متى صار لـ hcert-core هدف للمتصفح (يُطلَب في smart-trust-tools) — أو، في الأثناء، خطوات QR في الرحلات على الويب عبر مكتبة Rust/wasm.
  4. لاحقًا، اقتراح الرحلات على مؤسسة OHS بوصفها متغيرًا من player-reference-examples (القرار للمالك؛ ولا يُدفَع أبدًا من هنا).

إذا كان كون التطبيق هو OHS Player أهم من عدد التبعيات ومن العرض التوضيحي دون اتصال، فاختر A: تبقى الخطة نفسها، مع بدء الخطوة 2 من القالب وإضافة الوضع دون اتصال أولًا.

5. ما يحتاجه أي خيار من البيئة

المصادر

Edit this page on GitHub