ترجمة آلية — لم يراجعها أي شخص
تُرجمت هذه الصفحة آليًا. لم يراجع أي شخص هذه الترجمة أو يعتمدها، وقد تحتوي على أخطاء. الصفحة بلغة المصدر هي النص المرجعي. اقرأ النص الأصلي (بالإنجليزية)
Machine translation — not reviewed by a person. Read the original (English)
كل خطوة هي طلب سحب واحد، يُدمَج عندما يكون CI ناجحًا. والقرارات التي تعود إلى المالك تُطرح عليه قبل الخطوة التي تحتاج إليها وتُسجَّل في memory/.
القرارات حتى الآن (2026-10-23)
| القرار | الخيار | السجل |
|---|---|---|
| استهلاك المكتبة | بناء ملفات JVM jar في CI من إيداع مُثبَّت لـ smart-trust-tools | memory/dir-library-consumption.md |
| الإطار (Harness) | مشروع تابع كامل لـ cat-harness ضمن smart-trust-tools | memory/dir-downstream.md |
| البلد الأم (J2–J4) | مشارك خيالي في GDHCN DEV؛ وتبقى الجهة المُصدِرة في J1 هي XXR |
memory/dir-journeys-demo.md |
| قاعدة OHS للتطبيق | الخيار B، على مراحل؛ وRust/wasm للويب في الأثناء (proposals/app-platform.md) | memory/dir-app-platform.md |
| هوية IG | smart.who.int.trust-demo, http://smart.who.int/trust-demo |
memory/dir-ig-identity.md |
الخطوات
1. الخطة والهيكل الأولي (طلب السحب PR هذا)
README (بما في ذلك ملاحظة المنبع smart-trust-phw)، وAGENTS.md، وهذه الخطة، ومقترح منصة التطبيق، وتوجيهات المالك في memory/، وسجل التبعيات، ومهمة CI تتحقق من أن كل GitHub Action مُثبَّت بـ SHA الإيداع وأن كل ملف JSON قابل للتحليل.
2. الرحلات بوصفها محتوى cat-harness
- (مُنجَز) إعلان
smart-trust-demo.jsonوindex.config.jsonلتثبيت طبقات الإطار (harness) التي يُثبّتها smart-trust-tools (fhir-harness وما دونها) إضافةً إلى smart-trust-tools نفسه، بحيث تُحَل معرِّفاتreq:؛index.lock.json. scenarios/: الجهات الفاعلة (بإعادة استخدام VHL Holder وSharer وReceiver وTrust Network Participant من smart-trust-tools)، والأدوار التي تشغل المسارات، والشخصيات الافتراضية: الأم والمولود (مثال IG في J1)، وممرضة عيادة J1، وعامل الصحة المجتمعي (CHW) (J2)، ومقدِّم الخدمة في عيادة البلد الأم (J3)، والبوابة الوطنية والجهة المُستقبِلة عند الحدود أو في العيادة بالخارج (J4).processes/content/: ملف BPMN واحد لكل رحلة (أُنجز في الخطوة 2a؛ وقوائم التحقق وتركيب الإطار في 2b) (الإصدار في J1، والاكتشاف والإحالة من قِبل عامل الصحة المجتمعي (CHW) في J2، والتحقق والاستيراد ووضع الجدول في J3، وإصدار الروابط الصحية القابلة للتحقق (VHL) إلى هاتف مشترك في J4.0، وجلب الرابط الصحي القابل للتحقق (VHL) في نقطة تقديم الرعاية في J4.1)، مع مسارات تُسمّي الأدوار، ومهام تُسمّي مهارات smart-trust-tools؛ وتُولَّد قوائم التحقق.- User scenarios: one per journey, each step tracing to
req:nodes (e.g. J2 → STT-VER-011, J3 → STT-VER-001…, J4 → the VHL requirements). - Beans للثغرات المكتشفة في الطريق (في هذا المستودع، أو موسومة للمنبع لـ smart-trust-tools أو smart-trust أو smart-trust-phw).
2c. مجموعة أدوات التكيُّف الرقمي (DAK) من المستوى L2 ودليل تنفيذ FHIR IG من المستوى L3
الرحلات بوصفها مجموعة أدوات التكيُّف الرقمي (DAK) لإرشادات SMART لمنظمة الصحة العالمية (WHO) ودليل تنفيذ FHIR IG، بالبنية نفسها لـ litlfred/smart-immunizations (sushi-config.yaml، ig.ini، ومجموعة DAK في index.config.json (contentTypes.dak)، input/). ويُولَّد محتوى المستوى L2 من مصادر الإطار بواسطة tools/ig-gen/ig_gen.py: تصبح الأدوار موارد ActorDefinition، ويُنسخ BPMN إلى input/business-processes/، وتصبح القصص والسيناريوهات صفحات. ويتحقق CI من أن الملفات المولَّدة محدَّثة وأن SUSHI يبني دون أخطاء. ثم: نشر IG على gh-pages وإضافة موارد أمثلة لكل رحلة (bean IG-01).
3. مكتبة HCERT عند إيداع مُثبَّت
lib/hcert/: برنامج نصي وتوصيلات Gradle تسحب smart-trust-tools عند SHA مُثبَّت، وتبني hcert-api وhcert-core (JVM) باستخدام Gradle الخاص بذلك المستودع وverification-metadata.xml، وتنسخ ملفات jar إلى lib/hcert/build/libs/، وتُخفق إذا اختلف sha256 لأي ملف jar عن القيمة المسجّلة في lib/hcert/hcert.lock.json (البناء قابل لإعادة الإنتاج). ويعتمد التطبيق واختبارات Android على هذه الملفات. وتحديث المكتبة هو الإيداع في ملف القفل إضافةً إلى build.py --update.
4. اختبار المكتبة على محاكي Android (STT-GEN-004)
(قيد التنفيذ: android-test/ و.github/workflows/android.yml. تُكتب بيانات التحقق الوصفية لـ Gradle على مُشغِّل GitHub، لأن هذه الجلسة لا تستطيع الوصول إلى Google Maven.)
android-test/: وحدة مكتبة Android تُشغَّل اختباراتها المُجهَّزة على محاكٍ في CI (مستويات Android API لم تُحدَّد بعد: مستوى حديث، وآخر قديم بما يكفي ليكون مهمًا للعيادات، مثل 26 و35):
- التحقق من مثال §12 في IG مقابل مستند DID لشهادة موقِّع المستندات (DSC) الخاصة بـ XXR (قائمة الثقة DEV)، باستخدام موفّرات منصة Android؛
readUnverifiedلرمز QR نفسه (J2)؛- الإصدار بمفتاح Android Keystore (التحضير ← التوقيع عبر Keystore ← الإنهاء) والتحقق منه، باستخدام ES256، وPS256 حيثما توفّره المنصة؛
- VHL: بناء
vhlink:/وقراءته، وفك تشفير ملف JWE الاختباري.
تُبلَّغ النتائج إلى smart-trust-tools بوصفها دليلًا على STT-GEN-004 (وبوصفها beans هناك لكل ما يرفضه Android، مثل أسماء الخوارزميات). وتُثبَّت عناصر Google Maven (AGP، وAndroidX test) بـ sha256 مثل غيرها. وتستخدم مهمة المحاكي إجراءً مُثبَّتًا بـ SHA ولا تُخزِّن مؤقتًا أي عناصر غير مُتحقَّق منها.
5. التطبيق
(بدأ: app/، والقراءة دون اتصال في J2، والتحقق في J3 من شهادات التطعيم الرقمية (DVCs) الواردة في الدليل واستيرادها على Android، سير العمل app.yml. وتصبح شهادة التطعيم الرقمية المُتحقَّق منها Immunization في FHIR R4 مع Provenance الخاص بها (dev.ohs.fhir:fhir-model-r4)؛ أما غير المُتحقَّق منها فلا تُستورد. التالي: جدول التطعيم في J3، ثم الإصدار في J1.)
على القاعدة التي يختارها المالك من المقترح (الموصى به: تطبيق Compose Multiplatform خفيف مبني على مكتبات OHS KMP، مع البدء بـ Android):
- J1: تُصدر العيادة شهادة التطعيم الرقمية (DVC) للمولود (مفتاح اختبار مُضمَّن يقوم مقام شهادة موقِّع المستندات (DSC) للعيادة، أو Keystore)، وتطبع رمز QR أو تعرضه.
- J2: يمسح عامل الصحة المجتمعي (CHW) رمز QR الورقي دون اتصال (
readUnverified)، ويسجّل الرضيع (استبيان SDC)، وينشئ إحالة (ServiceRequest). - J3: تتحقق العيادة مقابل قائمة الثقة DEV المُضمَّنة، وتستورد موارد
Immunizationإلى محرك FHIR على الجهاز، وتُقيِّم جدول التطعيم (PlanDefinition/$apply)، وتعرض الجرعات التالية. - J4: تُصدر البوابة رموز QR للروابط الصحية القابلة للتحقق (VHL) لكل فرد إلى الهاتف المشترك؛ وتجلب جهة مُستقبِلة البيان (ITI-YY5) من جهة مُشارِكة اختبارية محلية وتفك تشفيره.
يُشغِّل اختبار واجهة مستخدم (UI) على المحاكي الرحلات الأربع من البداية إلى النهاية.
6. الويب والنشر
هدف الويب (بمجرد أن يعمل hcert-core في المتصفح، أو عبر مكتبة Rust/wasm في الأثناء)، وموقع gh-pages (يُنشَر بواسطة وكيل): الرحلات، وعارضات BPMN، والشخصيات الافتراضية وأدلة الاختبار.
البنود المفتوحة
- الشبكة: لا تستطيع هذه الجلسة الوصول إلى
dl.google.com(Google Maven، وAndroid SDK). وتحتاج الخطوتان 4–5 إليه محليًا لكتابة بيانات التحقق الوصفية؛ ويمكن للمالك السماح به في إعدادات الشبكة للبيئة. - بناء hcert-core للمتصفح (لهدف الويب): ستُثار المسألة في smart-trust-tools.
- أسماء الخوارزميات في Android: تطلب شيفرة JVM في hcert-core الاسم
RSASSA-PSS، الذي قد لا تقدّمه موفّرات Android بهذا الاسم؛ وستكشف الخطوة 4 ذلك.