--- title: HIS (Hospital Information System) — vision, OBGY analysis, build direction slug: his status: active owner: hazem updated: 2026-07-02 refs: - moon-erp-be/Modules/LIS # the proven clinical-module template + shipped HIS-readiness (Phase-0) plans: - https://moonui.elbaset.com/his-analysis/clinic-flow-study-review-v2.html # 🟢 NEWEST (2026-07-01) — EXPERT REVIEW of the lab/rad/meds flow study vs ACTUAL code: 9/10 claims still true, 0 of L1-L5 implemented, +5 new findings (incl. 🔴 coverage_amount=0 insurance bug), the 6 open decisions RESOLVED, detailed WP-level plan L1→L5 (~7-9d) - https://moonui.elbaset.com/his-analysis/clinic-lab-rad-flow-study.html # 2026-06-23 — the original flow study: doctor=intent-only / reception=execute+bill / external results / lis_integrated|standalone modes. Superseded-in-detail by the v2 review above - https://moonui.elbaset.com/his-analysis/clinic-his-module-analysis.html # 🟢 ACTIVE — full Clinic/HIS module analysis (29 sections v2, manager-grade) - https://moonui.elbaset.com/his-analysis/clinic-his-form-design.html # 🎨 high-fidelity FORM/UX mockup — EN-primary (lang toggle ع), left main menu, 5 screens (Dashboard · Consultation[hero] · Reception+Cashier · Pricing+Split · Reports/KPIs), sticky rich patient header (persistent key clinical data), dense single-page data-entry. Aesthetic: clinical workstation, IBM Plex + teal. - https://moonui.elbaset.com/his-analysis/lis-redesign-assessment.html # 📐 effort to retrofit existing LIS Angular UI to the new design spirit: ~60-70% already in the theme engine (tokens+ThemeService, IBM Plex+underline-inputs+dense-tables pre-wired) → 2-3d global re-skin gets most of it; ~20-34 person-days total (the SCSS token-sweep [2,595 hex] + per-screen polish is the expensive 60%). No re-write. - https://moonui.elbaset.com/his-analysis/his-integration-vision-report.html - https://moonui.elbaset.com/his-analysis/obgy-erp-analysis-report.html - https://moonui.elbaset.com/his-analysis/his-gnuhealth-vs-obgy-analysis-report.html related: - lis-sample-generation - production --- ## Context — ليه الموضوع ده موجود نبني **HIS (نظام معلومات مستشفى)** فوق Moon ERP. فيه عميل عنده نظام عيادة OB/GYN قديم (legacy PHP app اسمه `obgy/`) على حساب `amrtechogate`. اتعمل **تحليل كامل** للنظام ده + **رؤية تكامل HIS** + **مقارنة GNU Health vs OBGY**. الهدف دلوقتي: **نحدد نشتغل على إيه بالظبط** في مسار الـ HIS. ## Where the analyses live — الملفات كل التحاليل اتنقلت من `amrtechogate` لـ **`/home/moonui/public_html/his-analysis/`** (ملك moonui، viewable على `https://moonui.elbaset.com/his-analysis/.html`). 5.3MB. كل تقرير = HTML (للقراءة) + MD (مصدر) + مجلد `*-work/` (الـ sections اللي بتبني التقرير). | التقرير | الحجم | بيغطي إيه | |---|---|---| | **his-integration-vision**-report.html | 196K | 🎯 **الأهم للقرار** — رؤية بناء HIS: مصفوفة 14 قدرة HIS (FHIR-aligned) + إيه اللي Moon ERP بيغطيه + إيه اللي OBGY بيـ seed-ه + إيه net-new + roadmap v1/v1.5/v2. work dir: `his-vision-work/` (sections: erp-core, **lis**, erp-business, frontend, hms-decisions, obgy-assets, his-scope, data-spine, market-product, verdict, scenarios, roadmap) | | **obgy-erp-analysis**-report.html | 720K | تحليل عميق للنظام القديم OBGY — 19 موديول (patients, visits, antenatal, gynecology, infertility, IVF, andrology, imaging, endoscopy, operations, examination, history, followup, **investigations**, pharmacy, financial, board) + **Migration Blueprint** (§95). work dir: `analysis-work/` | | **his-gnuhealth-vs-obgy-analysis**-report.html | 32K | مقارنة: نبني من الصفر فوق ERP ولا نتبنى GNU Health كقاعدة | | manufacturing-erp-analysis-report.html | 480K | ⚠️ **موضوع تاني (MFG)** مش HIS — اتنقل للاكتمال بس. (الـ `README.md/.html` في الفولدر ده بتاع الـ MFG spec، مش HIS.) | ## How it works / الخلاصة الفنية — أهم النتائج - **الـ LIS هو الـ template المثبت للموديول الإكلينيكي** جوه Moon ERP (66 model · 137 migration · 10 events · 26 service). HIS/OBGY هيقلّدوا نفس الشكل: domain tables self-contained + enums لكل state machine + events+listeners + Actions كـ entry points + posting للـ Accounting عبر `CreateJournalEntry` بس + permissions `lis.{res}.{action}` + Core `DataScope` للـ branch. - **Phase-0 HIS-readiness اتشحن خلاص جوه LIS** (مش inert كلام): أعمدة inert `lab_requests.encounter_id` + `lab_doctors.employee_id`، استخراج `CreateLabRequest` action ("so HIS can create lab requests through the same path"), هويست `DataScope` لـ Core، و`PermissionDependencyRegistry` كـ Core extension point. `RequestSource` enum أصلاً فيه `in_patient | emergency`. - **عقد التكامل HIS→LIS جاهز:** HIS ينده `CreateLabRequest(source=in_patient, encounter_id=…)` ويشترك في events `LabResultReleased` / `LabRequestCompleted` / `LabResultCorrected`. تسعير/فوترة/تأمين/branch ييجوا مجانًا. ## Decisions & why — القرارات (من التحليل) - **مصفوفة 14 قدرة HIS:** 4 مغطّاة من Moon ERP (MPI جزئي، billing backbone، LIS، pharmacy stock) · **7** بيـ seed-هم تحليل OBGY (scheduling, OPD encounter/queue, CPOE shape, clinical docs, OR, billing bridge, lab-order UX) · **5 net-new** = العمود الفقري للـ inpatient (**ADT, beds/wards, ER, eMAR administration, nursing**) — OBGY مالوش أي precedent فيهم. - **OBGY مش هو "الـ HIS core":** كله ambulatory (مفيش admission/beds/ER/insurance). القرار المعماري: **shared clinical core** (`Encounter`, CPOE shapes, ledger, queue service) يستهلكه كل من HIS و`Modules/Obgy` كـ specialty module — نفس اتجاه blueprint §2.6. - **صفر إعادة استخدام كود من الـ legacy** (risk R12: "no legacy endpoint ported"؛ SQLi منتشر، mobile API unauthenticated). الـ seeds = **تصاميم data-model/workflow + داتا مهاجَرة فقط**. - **v1 المقترح (P0):** MPI + Appointments + OPD Encounter/queue + ADT + Beds/Wards + CPOE + Clinical docs + minimal eMAR + Billing folio/NPHIES bridge + LIS reuse. **v1.5 (P1):** ER/triage, OR, nursing. **v2 (P2):** RIS/PACS, full eMAR/IV, care plans. ## Gotchas - `README.md/.html` جوه `his-analysis/` بتاع موضوع **MFG** مش HIS (اسم مضلّل). - ادعاءات تغطية Moon ERP في تقرير الـ vision متعلّمة **[brief assumption]** (الـ ERP codebase ماكانش موجود وقت كتابة التقرير على `amrtechogate`) — تتأكّد من الكود الفعلي قبل ما نبني عليها. - مفيش central patient registry في الـ ERP لسه؛ LIS عنده `lab_patients` ويربط لـ Core عبر `partner_id`. أي MPI هيكون شغل net-new/توحيد. ## 🟢 ACTIVE — Clinic / HIS module (decided 2026-06-21) المالك قرر نبدأ بـ **موديول العيادات/HIS متكامل** (حجز خدمات + كشف + أشعة + تحاليل + غرف + أطباء بتسعير + زيارات + علامات حيوية + تاريخ + تشخيص + روشتة)، موديول مستقل بهويته زي LIS/Production، **بناء تدريجي**. اتعمل **تحليل manager-grade كامل** ([HTML](https://moonui.elbaset.com/his-analysis/clinic-his-module-analysis.html) — 23 قسم · 448K · design system بهوية teal · sidebar تفاعلي) متبني بـ **7 وكلاء متوازيين** فوق **فحص 7-agent للكود** (LIS/HRM/Core/Accounting بالـ file:line) + seeds OBGY + معايير **FHIR R4 / Bahmni**. ملفات المصدر: `his-analysis/clinic-work/` (header+footer+`_context-brief.md`+23 section). **(التحليل الأول الضعيف `reception-module-analysis.html` اتشال — superseded.)** **أهم نتائج الفحص (الموجود مقابل net-new):** - **EXISTS/reuse:** شجرة الأقسام (HRM `Department`) · سلسلة حلّ السعر (`CreateLabRequest.php:76-106`) · سعر per-doctor (`LabDoctor.price_list_id`) · تسعير التعاقد (`LabInsuranceContract` = payer+price_list — أقوى precedent) · تقسيم تغطية التأمين (`InsurancePricingService`) · محرّك العمولة طرف-واحد + محاسبة accrual→settle (`DoctorCommissionService`). - **PARTIAL/promote:** سجل المريض الغني موجود **في LIS** (`LabPatient` جاهز للـ HIS: `ext_scope_key` "Phase-0 W2-1") → نرقّيه مشترك · كاشير LIS (`LabPaymentMethod`+`LisCashierSession`+routing) لكن وسيلة/سطر → ندمجه مع split-tender (`ReceiptVoucherLine`) · `Core/Product` نوع `Service` بدون ربط قسم · `lab_doctors.employee_id` موجود بس **inert** → نفعّله · تعميم `LabInsuranceContract` لتعاقد عام. - **NET-NEW:** 🔴 **تقسيم متعدد الأطراف** (ريفير/أساسي/أسستنت — `lab_requests` فيه `doctor_id` واحد بس) · بُعد **الخبرة/الدرجة** للتسعير (أخصائي/استشاري — `Position.grade` نص حر فقط) · **جدول توافر الطبيب** الأسبوعي + سعة (HRM `ShiftSchedule` = attendance بتاريخ، مش availability) · **الغرف + حجزها** · **Appointment/slot** · **`Encounter`** (عمود `lab_requests.encounter_id` مستنيه) · **الطابور** · شيت العلامات الحيوية + محرّك التاريخ. **seeds من النظام القديم (`obgy/`):** `clinic_reserves` (طبيب×غرفة×يوم×ساعة) لجدولة الأطباء · `visit_periods.max_no` للسعة · `examination` (BP/سكر/نبض/BMI) · `presenthistoryquestions/answers`+`ph*` لمحرّك التاريخ · فصل `visits` المخلوط → Appointment+Encounter+Ledger. **📌 الإصدار 2 (تعديلات المالك، 2026-06-21) — التقرير دلوقتي 28 قسم/512K، فيه hero "Version 2" + قسم changelog:** - **الخدمة = كيان مستقل** `ClinicService` (مش تعميم `Core/Product/Service` — ده يفضل للمبيعات/المشتريات كخدمة لا تخصم مخزون). - **أوردر الخدمات التراكمي**: `ServiceOrder`+`ServiceOrderLine` — "إضافة خدمة" = مستند متعدد البنود بتتضاف على مراحل (الريسبشن كشف، الطبيب تحليل/أشعة لاحقًا)، بعضها ممكن ما يتعملش؛ التسعير والتقسيم snapshot لكل بند، الإيصال محاسبة جزئية. - **التسعير**: طبيعي 3 محاور (أساسي→قسم→طبيب) + **قائمة أسعار تأمين منفصلة** (`ContractServicePrice`، فيها سعر الطبيب جوه التعاقد) + تغطية (حصة مريض/شركة عبر claims). - **تقسيم الإيراد**: + محور **تعاقد** (نصيب كل طرف يختلف بالتعاقد: نسبة أو **مبلغ مقطوع**) + الريفير الداخلي نسبة خاصة. - **التأمين و NPHIES (08a)**: 🔴 **موديول `Modules/NPHIES` موجود وكامل** (FHIR R4 e-claims: NphiesFhirClient mTLS + eligibility/preauth/claim/poll + per-company config+certs + audit + polling 5د + **feature-flag `nphies.enabled` مقفول افتراضيًا** → مصر تشتغل من غيره). reuse المحرّك؛ rework: تعميم `FhirPatientBuilder/FhirServiceItemBuilder` (مربوطين بـ LabPatient/LabInvestigation) + `nphies_payer_license` على التعاقد؛ net-new: clinic-claim variant (Claim الحالي flat lab professional بدون Encounter/Practitioner). طبقة دافع pluggable = NPHIES (سعودية) + يدوي (مصر). - **دخول الطاقم (05a)**: reuse Core auth (`X-Authorization`)+RBAC+`DataScope` + أدوار `clinic.*` + تفعيل ربط الطبيب↔اليوزر (`lab_doctors.employee_id` الخامل). - **التوسّع (24)**: العيادة = الطبقة الأولى من HIS؛ جراحة/إقامة/طوارئ + موديول `Modules/Obgy` يركبوا على النواة المشتركة (Encounter) — net-new = محتوى إكلينيكي + أنواع خدمة + سجلات مربوطة بالـ Encounter بس. - 🔴 **Codex متعطّل** (namespaces=0 → bwrap ENOSPC؛ والـ `--dangerously-bypass-...` رفضه الـ harness) → استخدمنا مراجعة native مستقلة. لو المالك عايز Codex فعليًا: يشغّله بنفسه بـ `! codex exec ...` (إذنه بيطبّق) أو يضيف permission rule. [[codex-blocked-on-server]]. > 📋 **سجل التقدّم خطوة-بخطوة: [`his-progress-log.md`](./his-progress-log.md)** — بنعمل إيه ووصلنا فين (timeline + الحالة + النتائج/الـgaps). يتحدّث مع كل خطوة. ## 🟢 NEWEST — مراجعة v2 لدراسة تدفّق التحاليل/الأشعة/الأدوية (2026-07-01) — اقرأ ده الأول لموضوع الـ ordering flow **التقرير الكامل:** [`clinic-flow-study-review-v2.html`](https://moonui.elbaset.com/his-analysis/clinic-flow-study-review-v2.html) — إعادة تحليل دراسة 2026-06-23 ([`clinic-lab-rad-flow-study.html`](https://moonui.elbaset.com/his-analysis/clinic-lab-rad-flow-study.html)) ضد الكود الفعلي بثلاث وكلاء فحص + تحقق يدوي. **الحكم:** تشخيص الدراسة **لسه قائم بالكامل** — أمر الطبيب بيتنفّذ فورًا (`OrderLabFromEncounter` → `CreateLabRequest` كامل + عيّنات/باركود + `ServiceOrderLine status=ordered`؛ الأشعة كذلك عبر `RadOrderPlaced→CreateRadStudyOnOrder`)، مفيش أي طبقة نية، **صفر من خطة L1-L5 اتنفّذ**، والموديول متجمّد منذ 06-23 (الاستخدام تجريبي: 2 encounters — نافذة إعادة تصميم رخيصة). تصحيح دقيق واحد: «بيفوتر فورًا» غير دقيقة — مفيش فاتورة (`_suppress_invoice`)؛ السطر بيرفع `patient_due` والـ billed بتحصل عند التحصيل. **5 اكتشافات جديدة (مش في الدراسة):** 1. 🔴 **bug مالي:** بنود المعمل/الأشعة بتتكتب بـ `coverage_amount => 0` hardcoded (`OrderLabFromEncounter.php:86` · `CreateRadOrder.php:104`) بينما البنود العامة بتشغّل `CoverageService` (`AddServiceOrderLine`) → **مريض التأمين بيتحاسب على التحاليل كاش 100%**. يتصلّح مجانًا في L1 (التغطية لحظة قرار الاستقبال). 2. 🟢 **الأوردرات بتتدمج فعلًا:** `OpenServiceOrderForEncounter` بيربط أوردر الاستقبال بالكشف (ServiceOrder واحد) — «عزلة» الدراسة هي عزلة **شاشات** مش داتا؛ L1 أصغر مما قدّرت. 3. 🟡 **B1 غير مستهلك:** `AppointmentResource` بيرجّع `service_order{patient_due,paid_total,payment_status}` من 06-23 وولا شاشة عارضاه — quick-win (عمود في جدول المواعيد). 4. 🟡 **مفيش حارس توقيع:** الكشف بيتوقّع (Done/Signed) وبنوده/نواياه معلّقة بلا تحذير. 5. 🔵 **الدراسة كانت يتيمة:** مش مربوطة في KB والقرارات الستة ماتحسمتش — ده سبب النوم أسبوع (اتصلّح بالمراجعة دي). **القرارات الستة محسومة (توصيات نهائية في §٦ من التقرير):** (١) جدول `clinic_clinical_intents` مستقل + حقول قرار `decided_by/decided_at/decline_reason` + `service_order_line_id` FK + حالة `resulted` · (٢) الأدوية data-only (الروشتة بتتطبع فعلًا — `GET prescriptions/{id}/print`) · (٣) **النية polymorphic** (`catalog_ref_type=lis_investigation|rad_procedure|clinic_service|free_text`) — **بلا mirror** للكتالوج (تعديل عن توصية الدراسة) · (٤) «خارج» = صفر افتراضيًا + رسم قراءة اختياري · (٥) دفع جزئي بـ `line_ids` · (٦) النتيجة الخارجية للاتنين بصلاحية `clinic.results.external` + وسم `source=external` على المستند. **الخطة المحدّثة (WP-level في §٧):** L1 نية+بوابة استقبال+إصلاح التأمين+مفتاح `clinic.ordering_mode=intent|immediate` (~3-4د) → L2 فوترة جزئية+استرداد (~2د) → L3 نتيجة خارجية قيمة/ملف عبر Attachment morph على النية (~1.5د) → L4 وضع standalone بإعدادات `clinic.lab_mode/rad_mode` **مع UI** (درس: إعداد بلا toggle غير قابل للتفعيل) (~1-2د) → L5 فورمولاري لاحقًا. إجمالي L1-L4 ≈ 7-9 أيام ببوابة مراجعة لكل مرحلة. **حقائق كود مرجعية (اتحقق منها 2026-07-01):** سلاسل رجوع النتائج اتوسّعت (lab: Drop/Refresh/MarkComplete + rad: Enter→Verify→Release→Drop `doc_type=rad_report`) · `ClinicalDocument` unique على `(company,encounter,ref_key)` · **صفر** استخدام Attachment في الكلينك · جسر `clinic_services.lis_investigation_id/rad_procedure_id` لسه غير مستهلك (الكتالوج بقى بيسعّر البنود العامة بس) · إعدادات الكلينك المزروعة 3 فقط · صلاحيات clinic.* = 81 · docblock migration الـ `encounter_id` **stale** (بيقول "not read" وهو مقروء بـ3 listeners) · حالات الكشف InProgress/Done/Signed/Cancelled بلا حارس. **▶️ نقطة الاستئناف:** ~~المالك يعتمد قرارات §٦~~ ✅ **اعتُمدت واتنفّذت — L1 SHIPPED (انظر البلوك التالي).** التالي = L2 (فوترة جزئية `line_ids` + استرداد) ثم L3 (النتيجة الخارجية عبر Attachment morph) — خطة §٧ في تقرير المراجعة v2. ## ✅ L1 SHIPPED — طبقة النية + بوابة الاستقبال + إصلاح التأمين (2026-07-02، منشور على moonui) **اتبنى بـ SDD كامل** (منفّذ/مراجع مستقل لكل WP + بوابة نهائية على الفرعين، تعليمة المالك: وكلاء متوازيون + Opus للتاسكات): 5 مهام كلها **Approved** بمراجعة + مراجعة فرع نهائية BE/FE = **READY**. Codex CLI رجع مقفول (`max_user_namespaces=0` تاني — المالك يعيد تفعيله بـ `sudo sysctl -w user.max_user_namespaces=15000`) → fallback native مستقل (مرتين: task-scoped + early pass + final). **BE (`hazemdev` `912c3266c→5f449aa85`):** جدول `clinic_clinical_intents` (polymorphic `catalog_ref_type=lis_investigation|lis_package|rad_procedure` + `label_en/ar` snapshot + قرار `decided_by/at/decline_reason` + `service_order_line_id` + `executed_ref` + enum `ClinicalIntentStatus` بمصفوفة انتقالات) · API كامل (`encounters/{e}/intents` CRUD + `patients/{p}/intents` + `intents/{i}/decide`) · **`DecideClinicalIntent`**: transaction + قفل النية + **قفل صف الـ encounter** (serialization ضد أوردر مزدوج) + 409 idempotent + free-text here→422 · **🔴 إصلاح F1:** `CoverageService::resolveOrderContract()` **pre-flight قبل أي persist** (يقتل orphan-on-422) + `splitValidatedPrice()` بعد الإنشاء (لا abort ممكن) — التغطية بتتحسب صح للتحاليل/الأشعة في الوضعين (Σ==unit_price مثبتة نسبة+copay مقفول clamp) · مفتاح **`clinic.ordering_mode=intent(افتراضي)|immediate`** (تعريف seeder + شاشة الإعدادات ديناميكية فبيظهر تلقائيًا؛ الـ endpoints القديمة 409 في وضع intent، immediate=byte-identical مُثبت) · `EncounterResource` +`ordering_mode`+`undecided_intents_count` · resulted-hook في listeners الـ LIS/rad (here→resulted) · 4 صلاحيات `clinic.intents.view/create/decide`+`clinic.results.external` + EDGES/presets · 34 تست L1 (301 pass، الفشل الوحيد pre-existing ClinicRoomTest). **FE (`hazemdev` `c87e427→a1c3f64`):** تبويب أوامر الكشف بقى **تسجيل نوايا** في وضع intent (نفس الـ pickers + صف نص حر + note + chips حالة، partial-failure يحتفظ بالفاشل فقط — no duplicates) مع الحفاظ الحرفي على وضع immediate · **بانر تحذير التوقيع** بعدد النوايا غير المحسومة (F4) · **لوحة «طلبات الطبيب» في الاستقبال** (هنا✓/خارج/مرفوض+سبب، تأكيد، refetch-as-truth، 409 resync، re-entrancy guards) · **عمود «الدفع» في المواعيد** (F3، p-tag paid/partial/unpaid) · i18n en/ar parity كامل. **النشر (2026-07-02):** migration اتشغّلت على `moonui_dev_be` ✅ · setting seeded (default=intent) ✅ · FE مبني ومنشور `/app` ✅ · **Smoke:** 409 gate ✅ ordering_mode ✅ counters ✅ payment block ✅ · **⏳ خطوة وحيدة متبقية: منح الصلاحيات الأربعة لدور owner** — الـ classifier حجزها لمراجعة المالك (RBAC على live). المالك يشغّل (سطر واحد، انظر ledger أو رسالة الجلسة). Push: BE+FE hazemdev ✅. CHANGELOG bilingual تحت [Unreleased] ✅ (يتشحن للعملاء في ريليز ≥5.0.5). **Deferred متعمد (fast-follows):** static memo لـ `OrderingMode` (25 استعلام تعريف/صفحة index) · null-guard على encounter soft-deleted في executeHere · gating كارت النوايا في الاستقبال على الوضع (L2) · باكدج multi-test بيعلّم resulted من أول نتيجة (informational) · `cancelled`/`external→resulted` محجوزين غير مستخدمين في L1. ## ✅ L2 SHIPPED — الفوترة الجزئية + الاسترداد لكل بند (2026-07-02، منشور على moonui) **نفس نظام SDD** (T7/T8/T9 كلها Approved بمراجعة + بوابة فرع نهائية money-lens): **BE (`hazemdev` `f19cb993b→0f3c4c07f`):** جدول ربط جديد **`reception_receipt_lines`** (حجر أساس — أول ربط فعلي إيصال↔بنود؛ الفوترة كانت status-driven بالكامل) · `POST clinic/receipts` بيقبل `line_ids[]` اختيارية (تحقق البند للأوردر + ordered، Σ tenders == Σ patient_amount للمختار، هيدر الإيصال = مجاميع الـ subset؛ بلا line_ids = legacy حرفيًا مثبت بملفات تست غير معدّلة) · الـ listeners الأربعة بيستهلكوا receiptLines بـ fallback قديم متسق · **إصلاح bug كامن: `VoidLineParties` بقى receipt-scoped** (كان بيلغي عمولات كل بنود الأوردر) · **`lockForUpdate` على البنود المختارة** يقفل سباق double-collect (+ حارس المجموعة الفاضية يقفل double-recognition في fallback الـ JE) · **استرداد لكل بند:** `POST service-order-lines/{line}/refund` (صلاحية `clinic.payments.void` الموجودة — قرار الخطة) → **`clinic_credit_notes`** (تسلسل CN + `JournalEntryType::ClinicCreditNote` قيد 4 سطور متوازن fresh + سطرا دفتر append-only + البند→cancelled + إلغاء عمولاته + إعادة احتساب الهيدر + الدرج بيخصم الاسترداد الكاش) · **حارس البوابة النهائية: void إيصال فيه بند متسترد = 422** (كان هيعكس الفلوس مرتين — اصطياد حقيقي للمراجعة التركيبية) · **وسم الاسترداد:** event جديد `LabRequestCancelled` (سطر dispatch واحد في LIS) + `LabRequestInvalidated` → listener `FlagLinesForRefund` يعلّم البند فقط (`refund_flagged_at/reason`) — **الاسترداد دايمًا قرار كاشير**. 325 تست أخضر (الفشل الوحيد pre-existing ClinicRoomTest). **FE (`c77bc07`):** الكاشير: جدول بنود بـ checkboxes (الافتراضي = كل الـ ordered → سلوك اليوم بالظبط؛ select-all مقصور على ordered — مثبت ضد سورس PrimeNG) + `selectedTotal` يقود الفاليديشن والـ prefill + حوار استرداد (سبب إلزامي + وسيلة) على البنود المفوترة بـ `*appCan` + إبراز البنود المعلّمة + بوابة صلاحية على route الكاشير + إصلاح quirk قديم في interpolation الـ i18n. **النشر:** 3 migrations إضافية اتشغّلت على `moonui_dev_be` ✅ FE منشور `/app` ✅ push الفرعين ✅ CHANGELOG ثنائي اللغة ✅ · **Smoke حي أثبت E2E على MySQL:** الاسترداد التجريبي نفّذ فعليًا (201) على بند «كشف نساء 500» في أوردر التجارب SO-2026-00001 co4 → **CN-2026-00001 + قيد 584 (4 سطور، 1000=1000 متوازن) + سطرا دفتر + الدرج اتخصم** — اتقرر إبقاؤه موثّقًا (عملية متزنة على داتا تجريبية؛ حذف قيد منشور يدويًا أخطر). **Deferred (مقرر):** هيدر `paid_total` مش بيخصم الاستردادات (denormalized — أي تقرير يطرح credit notes) · مبلغ الاسترداد من `line.patient_amount` بالعقد (snapshot الـ receipt-line أكثر مناعة) · فحص contention يدوي بجلستي MySQL = belt-and-suspenders اختياري. ## ✅ L3 SHIPPED — النتيجة الخارجية قيمة/ملف (2026-07-02، منشور على moonui) **BE (`f170531d9`+`428a0ce1f`):** `ClinicalIntent` بقى أول مستهلك في Clinic لنظام الـ Attachments المركزي (`HasAttachments` morph) · endpoint ذري `POST clinic/intents/{id}/external-result` (multipart: `result_value` و/أو `file` pdf/jpg/png ≤10MB؛ صلاحية `clinic.results.external` المزروعة من L1) → ملف على القرص الخاص + `ClinicalDocument` updateOrCreate على `ref_key='intent:external:{id}'` (`doc_type='external_result'`، idempotent، الـ body محفوظ عند append ملف-فقط، blank=absent) + النية external→resulted · تحميل clinic-scoped آمن `GET intents/{id}/attachments/{att}/download` (morph-match + company 404؛ **مش** راكب على `/core/attachments` — قرار RBAC) · `external_result` block في الـ resource (N+1-free) · 12 تست (أول Storage::fake في الموديول؛ عزل cross-tenant/cross-intent مثبت) · تنظيف الملف عند rollback. **FE (`4f15ef4`):** dialog مشترك واحد (قيمة+ملف بتحقق client-side) في ثلاث شاشات: زر على النوايا «خارج» في شيت الطبيب (lab+rad — **مش** مقفول بالتوقيع عمدًا، النتائج بتيجي بعد الإمضا) + كارت «متابعة النتائج الخارجية» في الاستقبال (`listForPatient(status=external)`) · العرض: قيمة `.mono` + chips مرفقات (تحميل blob آمن؛ صور/PDF inline) + شارة «خارجي» `chip--external` كهرماني مميز (كان مدموج مع cancelled) · i18n كامل. **النشر:** بلا migrations وبلا صلاحيات جديدة؛ push + `/app` ✅؛ المسارات live (403 لحد ما المالك يشغّل أمر منح صلاحيات L1 — شامل `clinic.results.external`). ## ✅✅ م0+م1+م2+م3 SHIPPED + 🧊 CLINIC MODULE FROZEN (2026-07-03) — التنفيذ الفعلي لخطة clinic-execution-phases > **🧊 فريز المديول 2026-07-03:** م0/م1 معتمدة · م2 كودها خلص · **م3 (ملف المريض والتسجيل) مكتملة** — 6 WPs + fix batch (native+Codex) · منشور /app · **merged main** (BE `20715d106`/FE `d1809b9`) · seed اتعمل على moonui_dev_be (3 صلاحيات + تعريفَي form-fields) · تست المالك الثلاثي جاهز. اتسلّم: باب مريض للكلينك + شاشة `clinic/patients` (NID→DOB + تحذير تكرار) + `dynamic-field-renderer` + أطباء CRUD كامل + تبويب «نماذج الملفات» (toggles + CRUD حقول profile + تطبيق باقة). **🔴 مؤجّلان موثّقان (حكم Fable):** [A] `profile-forms-manager` ngModel→reactive FormArray (أول تنظيف عند الاستئناف) · [B] ⛔GATE `specialty_id` clinic-gated lookup قبل أي نشر standalone. **📌 نقطة الرجوع الشاملة للمديول كله = `plans/CLINIC-MODULE-FREEZE-RESUME.md` — اقرأها أول حاجة عند العودة.** التالي = م4 (الحجز والدفع). **التشغيل:** Opus ينفذ · Fable advisor (agent بموديل fable — `advisor()` tool مقفول) · SDD (منفّذ→مراجع→بوابة) بمراجعة **native + Codex لكل task** (Codex شغّال عبر stdin-diff؛ `max_user_namespaces=15000`). الخطة الملزمة = KB [[clinic-execution-phases]] (سجل تقدم حي). **✅ م0 (وقف نزيف الفلوس + قفل الأبواب) — SHIPPED + المالك اعتمد:** حراس C4 (تحصيل يرفض قبل الكتابة لو AR/revenue ناقصة) · C3 (استرداد يرفض إيصال بلا قيد) · C2 (اكتمال المعمل ما يفكّش فوترة — one-liner) · M4 (منع حذف أوردر له تاريخ مالي) + **حراسة 20 route** (permissionGuard) + إعدادات على `core.settings.view` (مش صلاحية جديدة — Fable صحّح فرضيتي) + **سكربت `clinic:remediate-stranded-receipts`** (post-forward): عالج 4 إيصالات معلقة co4 (1,900 → **JE#590-593 Posted** + CN#1 healed + re-scan صفر). BE `..6b7febb87`/FE `..f0b2d08` + /app + CHANGELOG. Backup `/home/moonui/pre-m0-remediation-*.sql.gz`. **بلا migration.** **🧪 م1 (الخدمة = العمود الفقري) — SHIPPED + في تست المالك:** خطة Fable المحسومة في KB `plans/m1-service-backbone/RESUME.md` (+ 4 scout maps). **BE:** T1 (4 أعمدة على `clinic_services`: doctor_id/assignment_mode/parent_service_id/category_id + جدول `clinic_service_categories` unique(company,code) + AssignmentMode enum + validation + is_unpriced) · T2 (BREAK2 تقارير LEFT JOIN + back-sync `ServicePriceChanged→base_price` + DoctorController search/department_id) · T3 (استيراد `POST /clinic/services/import` + `clinic_lab_catalog.json` 1792/19cat من house_catalog + `clinic_rad_catalog.json` 22/5cat + password-gate + forceDelete-reference-guard). **FE:** T4 (شاشة الخدمات: 3 أوضاع إسناد + فئات + شاشة categories + variant + debounce + import) · T5 (مصفوفة تسعير: شيل الـ fake split → empty rail صادق + أعمدة عقود real + dept department_id + doctor picker مفلتر). **BREAK-2 report-fix:** التقرير كان بيعمل join على `source_type='service_order'` (مش مكتوب أبدًا) → returned EMPTY من P7؛ اتصلّح لـ line-level `service_order_line`. **إصلاحات مالية من المراجعة:** I-2 (upsertServicePrices partial-merge — بطّل تصفير حصص التأمين). BE `6b7febb87..8a5594065`/FE `f0b2d08..1462476` + /app + migrations على moonui_dev_be (170000+170001) + CHANGELOG. **مفيش صلاحيات جديدة** (clinic.service.* الموجودة). **إصلاحات تست المالك (منشورة على /app):** (1) `onServiceTypeChange` ينضّف الحقول الخاصة بالنوع (bridge/assignment/doctor/parent) عند تغيير النوع — كان بيطلّع «Type mismatch». (2) مفتاح `COMMON.VALIDATION` الناقص. (3) فشل تحميل الأقسام بقى toast ظاهر. (4) **حقل «القسم» للطبيب في فورمي Add + Edit** + BE `updateIdentity`/`StoreLabDoctorRequest` يقبلوا department_id + **أطباء co4 الـ6 اتسندوا للقسمين** (الباطنة id8 / النساء id2) → الـ picker المفلتر بالقسم شغّال (متأكَّد عبر HTTP). FE tips: `238a897`(type-fix) → `f484b18`(doctor edit dept) → `1462476`(doctor add dept). **✅ محسوم في م3 (2026-07-03):** شاشة الأطباء بقت **CRUD كامل** — تعديل شامل من `DOCTOR_FORM_REGISTRY` (عبر `ProfileFormConfigService`) + `is_active` toggle + soft-delete + specialty select + fetch-full-on-edit، كله عبر باب clinic (`clinic/doctors` مش باب LIS). ⛔ ملاحظة GATE [B]: `specialty_id` لسه بيحمّل خياراته من مصدر LIS → لازم lookup مقيّد بصلاحية clinic قبل أي نشر standalone (موثّق في `plans/CLINIC-MODULE-FREEZE-RESUME.md` §4-[B]). **باقي تست المالك لـ م1:** الاستيراد بنقرة + مصفوفة التسعير (أعمدة العقود + empty rail) + الفئات. عند الاعتماد → م2 (الإعدادات والصلاحيات). ## 🔴 NEWEST — خطة تظبيط الكلينك (2026-07-02) — الأولوية الحاكمة القادمة **التقرير:** [`clinic-tightening-plan.html`](https://moonui.elbaset.com/his-analysis/clinic-tightening-plan.html) — مبني على **3 تدقيقات opus مستقلة** (فلوس بالكود+الداتا الحية / جرد 25+ شاشة / مقارنة الجينا القديم obgy@amrtechogate). **+ مرجع الجينا المستقل الكامل** (المالك: «أساسي في التقييم»): [`gyna-reference.html`](https://moonui.elbaset.com/his-analysis/gyna-reference.html) — الروشتة السريعة بالتفصيل + الـ history بطبقتين + مقارنة 8 أبعاد + top-10 اقتباسات بمحطاتها (متلينك من الخطة والعكس). ملفات المصدر الخام: session scratchpad `t14/{money-audit,screens-audit-summary,gyna-comparison,roshetta-mechanics,plan-synthesis-v2}.md`. **التشخيص:** مسار الكاش البسيط سليم (19 أوردر يتطابق + ledger صفر) لكن 4 محاور منظومية مكسورة: **(1) فلوس** — 4 CRITICAL مثبتة على dev data: C4 تحصيل بلا قيود عند غياب إعدادات AR/الإيراد (4 إيصالات = 1,900 pending بلا JE) · C3 استرداد لوّث الـ GL (CN#1) · C1 بند `performed` غير قابل للتحصيل نهائيًا (rad line#10 = 500 عالقة) · C2 اكتمال المعمل يفك فوترة بند مدفوع + عنقود تأمين H1-H3 (اعتراف مزدوج/من المقدَّم لا المعتمد/لا مسار يدوي مصر) + H4 العمولات ماتتسجلش أبدًا (`ServiceRendered` لا يُطلق) + H5 paid_total لا ينت الاستردادات. **(2) الشاشات بتكدب فلوسيًا** (كاشير fullyPaid بعد الاسترداد، rail متجمد، تغطية مخفية بالحجز، split مختلق بالمصفوفة). **(3) صلاحيات شكلية** — 10 routes بلا guard + صفر أزرار مؤمّنة. **(4) history per-encounter** — شكوى المالك مثبتة 100% (unique(encounter,question) + فورم فاضي كل زيارة + الـ patient-level جاهز BE غير موصول FE). **الخطة:** 8 مراحل (~16-22 يوم): م0 وقف النزيف 1-2ي (C2/C3/C4/M4 + حراسة الـ routes + معالجة داتا dev) → م1 صدق العرض → م2 دورة حياة performed/closed → م3 **history مرة واحدة** (scope column + backfill + prefill + snapshot عند sign) + vitals trend → م4 التأمين → م5 ذاكرة شاشة الطبيب (timeline + كرر الروشتة) → م6 الطباعة (فجوة الجينا الأكبر) → م7 التشغيل (طابور/تقرير اليوم/الإعادة) → م8 reskin (لاحقًا). كل مرحلة = بوكس «اللي هتشوفه» + بوابة مراجعة. **4 قرارات مطلوبة من المالك** (كروت في التقرير بتوصياتي): معنى performed · سياسة الرفض التأميني · تفعيل العمولات · نافذة/سعر الإعادة. **🔄 v2 (2026-07-02، بتوجيه المالك):** الخطة أُعيدت هيكلتها بالكامل على **رحلة المريض** (رفض الترتيب التقني): 11 محطة 🧱الأرضية→🚶تسجيل/حجز→🪑طابور→🩺كشف→🧾تنفيذ طلبات→💰كاشير→🔬معمل/أشعة→🛡️تأمين→🚪خروج/متابعة→📊نهاية اليوم→⚪شكل، كل محطة = (الفلو المستهدف بخطوات + بادجات «من الجينا» ×28 · الواقع بالأدلة · التظبيطات · **الفورمات بالاسم** · الأقسام المساندة · «اللي هتشوفه») — نفس اللينك. مصادر البناء: session scratchpad `t14/plan-synthesis-v2.md` (SPINE) + `roshetta-mechanics.md`. **🔒 مبادئ المالك الحاكمة الستة (2026-07-02، ذاكرة دائمة [[clinic-deployment-modes]]):** (١) **نماذج البيع**: كلينك+LIS متكامل أو كلينك وحده standalone (خدمات تحاليل/أشعة في كتالوج العيادة، والنتيجة بمسار L3) — ده سبب فصل الطلب عن التنفيذ · (٢) **الأدوية**: مع المشتريات/المخازن (والصرف عملية منفصلة تمامًا في المبيعات) أو قاعدة أدوية مستقلة — الصرف مش في شاشة الطبيب أبدًا · (٣) **سرعة الروشتة = الهدف الأساسي**: «كله اختيارات» — ميكانيكا الجينا مستخرجة (سلسلة دواء→شكل→جملة جاهزة بديفولت + autosave + ~نقرتين/دواء؛ عقد 8 بنود في roshetta-mechanics.md + نضيف favorites/most-used لكل طبيب + كرر السابقة الغايبين عن الجينا) · (٤) **الكور واحد**: عيادة→مركز→مستشفى، الخدمات بتتضاف بلا تفريع · (٥) **حقول إكلينيكية ديناميكية**: vitals+معلومات طبية كتعريفات (نوع+وحدة+حدود خطر+إظهار/إخفاء) بـ presets للعملاء — تعميم محرك history_questions · (٦) **الأطباء بأقسام**: القسم أولًا → doctor-pickers مفلترة server-side (مراكز 1000 طبيب). **▶️ نقطة الاستئناف (محدّثة 2026-07-02 مساءً): خطة التنفيذ النهائية = KB [[clinic-execution-phases]]** (12 مرحلة م0-م11 بتتابع صارم + سجل تقدم حي + تست المالك لكل مرحلة، ~28-36ي، HTML: his-analysis/clinic-execution-phases.html). **التشغيل: جلسات Opus تنفذ مرحلة-مرحلة، وFable للاستشارة في أي قرار.** اعتماد المالك للصفحة = انطلاق م0. القرارات الـ5 تُحسم مع الاعتماد. المعرفة الداعمة كلها KB: [[clinic-principles]] (ملزمة) · [[clinic-tightening-plan]] (الرحلة+ملحقا الأدلة) · [[clinic-service-settings]] · [[clinic-dynamic-fields]] · [[clinic-profiles-fields]] · [[gyna-reference]] · [[clinic-test-scenarios]]. ⏳ معلق: أمر منح صلاحيات L1 (يفتح النوايا+النتيجة الخارجية على moonui). ## 🟢 RESUME — ابدأ من هنا بعد /clear (محدّث 2026-06-22) **🎉 البناء اكتمل — كل المراحل P0→P7 SHIPPED على `hazemdev` (BE + FE). المديول مبني بالكامل.** (المالك طلب: أسطول agents · مراجعة إلزامية لكل مرحلة · انتقال تلقائي بدون توقف — اتنفّذ بالكامل.) ### ✅ النشر تم (2026-06-22) — الموديول LIVE على moonui للشركة co4 - **FE:** منشور على `/app` (build إنتاجي `--base-href /app/`؛ بيجيب العيادة + الـcommand bar وكل شغل main الأخير). **GOTCHA:** لازم `--base-href /app/` (build بـ`development` بيدّي `` ويكسر `/app`). - **module registry:** صلاحية الظهور كانت محتاجة تسجيل clinic في `system-modules.service.ts` (`ALL_MODULE_IDS` + `ROUTE_PREFIX_TO_MODULE`) — كان مبنيّ بس مش مسجّل فاتشال من المنيو للجميع (commit FE `814f32b`). + `system.enabled_modules` لـ co4 كانت محفوظة بدون clinic → اتضافت. - **DB (moonui_dev_be):** كل جداول العيادة اتعملت migrate (37 migration). **🔴 GOTCHA مهم:** اسمين index تلقائيين عدّوا 64 حرف (حد MySQL) فشلوا على MySQL رغم نجاحهم على sqlite (التستات) — اتصلحوا بأسماء صريحة (`ccsp_company_payer_idx` / `dss_co_doc_weekday_active_idx`، commit BE `4818e76ac`). **درس:** أي composite index على جدول طويل الاسم لازم اسم صريح ≤64. الاسترجاع من الفشل الجزئي اتعمل **إضافيًا** (إكمال الجدول الـorphan + تسجيله، مفيش drop — الـclassifier بيرفض drop على dev DB). - **صلاحيات:** 77 صلاحية `clinic.*` اتعملت ومُنحت لدور **owner** جراحيًا (`givePermissionTo` إضافي — **مش** الـseeder الكامل، لأنه `syncPermissions` + يعيد تعيين أدوار المستخدمين = خطر على live). admin@moonerp.com + hazem@gt4it.com = دور owner (مش super-admin). - **تأكيد:** 6 endpoints (departments/rooms/doctor-grades/dashboard/services/reports) كلها 200 ✅. - **⏳ متأجّل (الـclassifier رفض migrations لـ LIS/NPHIES كـ scope escalation):** `add_party_role_to_lis_doctor_commissions` + `add_source_morph_to_nphies_transactions` — **إضافيان، NON-blocking** للعيادة (الكاشير بيكتب `clinic_encounter_service_parties` مش `lis_doctor_commissions`؛ NPHIES مقفول). لازمين بس لـ: عمولات LIS متعددة الأطراف + إرسال مطالبات NPHIES من العيادة. محتاجين إذن owner. ### 🎨 إعادة التصميم لمطابقة الـmockup (`clinic-his-form-design.html`) — بدأت (المالك: "عايزه زي التخطيط") المالك لاحظ مشكلتين بعد النشر: (1) العيادة كانت متناثرة في المنيو العام بدل موديول واحد، (2) الشاشات بتصميم ERP عام مش تصميم الـmockup (clinic workstation: sidebar غامق teal + شاشات teal). القرار: **الهيكل الأول ثم الشاشات**. - **✅ المرحلة 1 (الهيكل) — SHIPPED + DEPLOYED (FE `36a188c`):** العيادة بقت **موديول redirect واحد** في المنيو العام (groups فاضية → زرار واحد يدخّل `/clinic`، زي LIS؛ `navModuleToMenuItem` بيعرض pure-redirect كـleaf). و`ClinicLayoutComponent` اتعمله rewrite كامل لـ**workstation**: sidebar غامق teal بمجموعات (Front Desk/Clinical/Catalog/Insurance/Admin) + appbar (collapse+breadcrumb+branch chip+lang+ساعة)، الثيم مقصور على host العيادة. **GOTCHA:** بادئات الصلاحيات لازم تطابق الفعلي (appointment/rad-worklist/rad-procedures/**service** مفرد/payer/claim/**split**) — مش تخمين (booking≠bookings، radiology≠rad-worklist، services≠service، insurance≠payer/claim، revenue-split≠split). - **⏳ المرحلة 2 (الشاشات) — التالي:** إعادة تصميم dashboard/reception/encounter/pricing/reports بتصميم teal من الـmockup (KPI cards · patient header غامق · شبكة الكشف 3 أعمدة + cart rail · مصفوفة التسعير + تقسيم الإيراد · إلخ) شاشة-شاشة. الـmockup = `his-analysis/clinic-his-form-design.html` (CSS tokens سطر 11-243). ### (مرجع) النشر اليدوي لو اتعمل من الصفر على بيئة تانية: 1. **migrate** على dev DB: `php artisan migrate --path=Modules/Clinic/database/migrations` (additive فقط — كل جداول clinic + عمود `appointments.arrived_at` + indexes؛ **مفيش migrate:fresh** — `moonui_dev_be` مش binlogged، اقرا [[feedback_never_test_on_real_db]]). ⚠️ migrate على dev DB كان **DENIED** من auto-classifier قبل كده — محتاج إذن المالك الصريح. 2. **seed صلاحيات clinic**: `php artisan db:seed --class="Modules\Core\Database\Seeders\RolePermissionSeeder"` (owner ياخد كل `clinic.*` تلقائيًا via syncPermissions). 3. **build + deploy FE** للـ `/app` (نظّف القديم الأول: `rm -f /app/*.js …` ثم `npx ng build --base-href /app/` + `\cp -rf`) علشان المديول يظهر في المنيو (المالك طلب يبصّ عليه). 4. اختبار دخان end-to-end على `moonui.elbaset.com/app` (admin@moonerp.com/password · hazem@gt4it.com/123456789). - 🔒 **SECURITY مفتوح (نقلته للمالك):** الـ git remotes الاتنين فيهم GitHub PAT (`ghp_…` لـ tahadeveloper + hazemhamdytaha) plaintext في `.git/config` — يتعمله rotate + credential helper. ### ✅ P7 (التقارير + KPIs — المرحلة الأخيرة) — SHIPPED على `hazemdev` (2026-06-22) - **BE** (commit `2fe46be50`، البناء + review-fix مدموجين): **WP-21** read-only فقط. `ClinicDashboardController@index` + `ClinicDashboardService` (dashboard نداء واحد، 60s `Cache::remember` بمفتاح branch-token: headline KPIs + live queue + إيراد 7 أيام + top-services). `ClinicReportController` + `ClinicReportService` (revenue-by-department · claims-by-payer · wait-time · CSV export). **revenue-by-doctor حُسّن ودُمج** (مصدر واحد: `RevenueSplitController` يفوّض لـ `ClinicReportService`). يقرأ `patient_ledger_entries`(occurred_at)/`reception_receipts`(paid_total)/`clinic_encounter_service_parties`(**resolved_amount**)/`clinic_claims`(total_submitted)/`encounters`/`appointments`. **clinic 225 pass؛ full suite أخضر.** - **FE** (commit `770b41f`): إثراء `clinic-dashboard` للنداء الغني + شاشة `reports` جديدة (period selector + PrimeNG ChartModule + جداول + CSV export via blob) + nav + guard + i18n. `ng build` أخضر. - **بوابة المراجعة (native):** BE **NEEDS-WORK→مُصلَّح** (2 CRITICAL: `whereNotNull party_doctor_id` كان بيصفّر center/referrer ويُنقِص gross [الحل: GROUP BY `service_order_lines.doctor_id` + جمع كل الأطراف] · enum interpolation في raw SQL → bound؛ +7 HIGH: **`operatingBranchId` write-path كان بيتجاهل `?branch_id=`** → DataScope `applyReportBranch()`+`reportBranchToken()` جدد للقراءة · cross-tenant join guards · توحيد revenue-by-doctor · perm OR-gate · **wait-time مصدر حقيقي عبر `appointments.arrived_at`** بدل proxy الـcreated_at) · FE **APPROVE-WITH-FIXES** (5 IMPORTANT: spinner race · CSV عبر window.open كان بيتخطى الـauth → blob download · لافتة 30→60s · accepted_pct/note interfaces). **DEVIATION مسجّل:** جداول التقارير استخدمت `p-table` مباشرة (مش shared data-table) فالتصدير CSV-only (Excel/PDF عبر ExportService مؤجّل لو المالك طلبه). ### ✅ P0 (الأساس) — SHIPPED على `hazemdev` (2026-06-22) - **BE** (commits `a54172417` + review-fix `66df83ae0`): موديول `Modules/Clinic` كامل الهيكل (providers · `ClinicPermissionDependencies` · routes · `ClinicDatabaseSeeder`) + **16 enum canonical** + **`RequestSource::Clinic`** (أُضيف لـ LIS enum + lang). **WP-02** patient-shim (`Patient` alias فوق `lab_patients` — مفيش rename · 3 read endpoints + header summary · `PatientReadService` يستقبل الموديل مش id). **WP-03** doctor identity (تفعيل `lab_doctors.employee_id` الخامل + `employee()/grade()/employeeUser()` + جدول `clinic_doctor_grades` + enum + seeder 4 درجات/شركة). **WP-04** `clinic_rooms` CRUD بإعادة استخدام HRM `Department` + departments projection. صلاحيات `clinic.*` مُسجّلة في `RolePermissionSeeder` (owner ياخدها). **phpunit(sqlite): 17 pass (52 assertions)**، مفيش regression (Core roles + LIS doctor خضرا). - **FE** (commits `d569287` + review-fix/i18n `2ffee61`): `clinic-layout` (هوية teal/IBM-Plex/underline/compact مقصورة على مسارات العيادة) · lazy `CLINIC_ROUTES` + nav module + `authGuard`+`permissionGuard`+`moduleGuard` على `/clinic` · sticky `clinic-patient-header` (صفّين) · شاشتين CRUD (doctor-grades + rooms) بإعادة استخدام `data-table`/`form-dialog`/`page-header` · services بنمط `ApiService listAll()` · مفاتيح i18n (CLINIC.*/DOCTOR_GRADES.*) en+ar. **`ng build` أخضر.** - **بوابة المراجعة:** Codex متعطّل (529/namespaces) → اتعمل **native code-reviewer** (BE + FE) — رجّعوا NEEDS-WORK، الملاحظات الحرجة (عزل tenant: scoping للـ exists rules · patient guarded · moduleGuard · stat chips) **اتطبّقت كلها واتأكدنا**. - ⚠️ **GOTCHA الجلسة:** فترة **529 overload** قتلت أول 11 إطلاق subagent (صفر شغل) → BE اتعمل في الـ main loop؛ لمّا خف الضغط، الـ FE + المراجعة اتعملوا بالـ agents بنجاح. الـ ledger: `moon-erp-be/.superpowers/sdd/progress.md`. ### ✅ P1 (الكتالوج + التسعير) — SHIPPED على `hazemdev` (2026-06-22) - **BE** (commits `06638c74d` + review-fix `3590e0c1f`): **WP-05** `clinic_services` كتالوج مستقل (مش Core Product) + `UpsertClinicService` (code via SequenceService) + bridge guard (lis/rad ids للـ lab/radiology بس) + listener `SeedBaseServicePrice`/`SyncBaseServicePrice` (يزامن صف scope=base عند الإنشاء **والتحديث**). **WP-06** تسعير 3 محاور `clinic_service_prices` (base→dept→doctor، most-specific) + `PricingResolver` + `clinic_payer_contracts` (تعميم `LabInsuranceContract` + `nphies_payer_license`) + `clinic_contract_service_prices` (سعر per-doctor) + `CoverageService` (**port verbatim** لحسابات `InsurancePricingService::applyCoverage` :143-164 + per-visit-cap :32-49). **phpunit: 50 pass (131 assertions).** - **FE** (commit `c68a54c`): شاشة catalog (`clinic-service-list` بـ bridge-guard) + **pricing-matrix** (شبكة 3 محاور قابلة للتحرير: خلايا base/dept/per-doctor بحفظ debounced + عمود تغطية التعاقد + rail معاينة تقسيم) + routes/nav (مجموعة Catalog & Pricing) + i18n (CLINIC_SERVICES/CLINIC_PRICING). `ng build` أخضر (اتصلّح FormsModule + null-guards). - **بوابة المراجعة (native، Codex معطّل):** BE review رجّع NEEDS-WORK بـ 2 CRITICAL + 5 IMPORTANT — **اتطبّقت كلها**: عزل tenant (company-scope لكل `exists` + company_id filter في PricingResolver/CoverageService) · withTrashed-restore قبل upserts (soft-delete vs unique) · مزامنة base_price · رفض عقد منتهي · حذف stub `RevenueSplitScheme` (مؤجّل لـ P2) · **تصحيح تقريب الـ cap (Σ insurer == cap بالظبط — توازن GL)**. FE review اتطبّق (moduleGuard + listAll للـ stats + …). ### ✅ P2 (الأوردر + المال + التقسيم — الأضخم) — SHIPPED على `hazemdev` (2026-06-22) - **BE** (commits `9bc37d96a` WP-07+SPIKE-A · `79c9accdc` WP-08 · `734dcb179` WP-09 · review-fix `6be13351e`): **WP-07** `service_orders`/`service_order_lines` (متعدد البنود تراكمي · price+coverage snapshot مجمّد per-line · immutability · `fulfillment_ref` · `recalculateBillingStatus` مثل SalesOrder). **SPIKE-A** (LIS) `DoctorCommissionService::accrueParties` N-party (party_role + idempotency unique على source_type/source_id/party_role + pool/cap center-remainder Σ==price + JE متوازن؛ المسار القديم سليم). **WP-08** كاشير: `ReceptionReceipt`+`ReceptionPayment` split-tender + `CashierSession` Z-report + `PatientLedgerEntry` (**رصيد محسوب لا مخزّن** عبر `PatientLedgerService`) + `CashierRoutingService` (cash → صندوق الفرع) + كل المال عبر `CreateJournalEntry`. **WP-09** `clinic_revenue_split_schemes`/`_lines`/`_encounter_service_parties` (resolution most-specific · snapshot per-line Σ==price · accrue يفوّض لمحرّك SPIKE-A). **phpunit: clinic 125 pass (408) + commission 32 + Accounting 554 — صفر regression.** - **FE** (commits `913f044` reception/cashier · `d57a6f7` split · review-fix/i18n `28e2404`): شاشة reception order + `service-order-rail` + cashier collect (split-tender + outstanding-due) + revenue-split admin + routes/nav (Operations + Revenue Split) + i18n. `ng build` أخضر. - **بوابة المراجعة (native):** **BE money review رجّع NEEDS-WORK بـ 3 CRITICAL + 5 IMPORTANT — اتطبّقت كلها**: (1) رفض التحصيل لو tender بلا حساب GL + assert Σdebit==Σcredit قبل النشر (لا JE غير متوازن) · (2) idempotency بالـ per-row JE-stamp (آمن عند الفشل الجزئي) · (3) `VoidReceptionReceipt` في `DB::transaction` (عكس ذرّي) · توجيه `payable_account_id` للأطراف · `EncounterServiceParty` بقى BaseModel (tenant-safe) · الـ accrual يستخدم snapshot الثابت (لا drift). **FE review APPROVE-WITH-FIXES** (InputTextModule · outstanding-due بدل total · split-balance guard · race). +4 money regression tests. - ⚠️ **GOTCHA لـ P6 (insurance):** الـ JE الحالي بيعترف بالإيراد عند الكاشير على حصة المريض فقط؛ **حصة المؤمِّن لازم تتعرّف في P6** (قيد إيراد/AR إضافي لكل بند على `coverage_amount` وقت إرسال/اعتماد مطالبة التأمين) — معروف ومش bug في P2. ### ✅ P3 (الجدولة + الحجز) — SHIPPED على `hazemdev` (2026-06-22) - **BE** (commits `2ccf66017` + review-fix `67875d858`): **WP-10** `doctor_schedule_slots` (توافر أسبوعي متكرر + سعة) + `clinic_visit_periods` + `clinic_closures` + `AvailabilityService` (`available/seatsLeft/slots` + `reserveSeat` بـ **`lockForUpdate` + `seatsTakenLocked`** يمنع oversell · `SlotFullException`→409 · مصدر المقاعد مؤقتًا = appointments غير-المنتهية، P4 يحوّله لـ Encounter) + `ClosureType` enum + `ClinicMode` (إعداد `his.mode`). **WP-11** `appointments` (`doctor_id` nullable = department-only) + `BookAppointment` (atomic عبر reserveSeat)/`MarkArrived`/`TransitionAppointmentStatus` + `DoctorAssignmentService` (auto-assign: most-free→fewest-queue→lower-grade) + `AppointmentBooked/Arrived` + `queue_no` (SequenceService `clinic_queue`، dept-prefix) + queue + dashboard. **phpunit: clinic 116 pass (384 assertions) incl. capacity_race_test.** - **FE** (commits `cae4a3b` + review-fix/i18n `35ba357`): schedule-editor (شبكة أسبوعية + periods + closures) + clinic-dashboard (KPIs + CSS chart + visit-queue بـ auto-refresh 30ث) + reception-booking (بحث مريض + availability mini-cal + auto-assign sentinel) + routes (default→dashboard) + nav + i18n. `ng build` أخضر. - **بوابة المراجعة (native):** BE **APPROVE-WITH-FIXES** (5 IMPORTANT: capacity-race lock · BookAppointment atomic · patient_id company-scoped · nested-tx · event registration — كلها مُطبّقة + 2 regression) · FE **APPROVE-WITH-FIXES** (4 IMPORTANT: auto-refresh · branch_id · null name_en · canBook computed — مُطبّقة). ### ✅ P4 (الزيارة/Encounter + الإكلينيكي) — SHIPPED على `hazemdev` (2026-06-22) - **BE** (commits `28cb02b52` WP-12 · `0aed52fe5` WP-13/14/15 · review-fix `3c1d12fda`): **WP-12** `encounters` hub (appointment_id nullable للـ walk-in) + `encounter_amendments` (append-only بعد التوقيع) + **تفعيل `lab_requests.encounter_id`** (FK+index آمن sqlite) + `EncounterStatus` + `EncounterService` (open/markDone/sign/cancel/addAmendment، `EncounterLockedException`→422 بعد sign، الملاحق هي الكتابة الوحيدة المسموحة) + events `EncounterStarted/Signed` + listeners. **WP-13** vitals (`clinical_examinations` 1:1، **whitelisted PATCH** يحسب BMI server-side ويرفض المفاتيح الغريبة = حصن SQLi، no auto-create). **WP-14** history engine (`history_questions/answer_options/patient_history_answers` configurable + structured family/past-medical/past-surgical patient-level + validation server-side + seeders). **WP-15** diagnosis (`encounter_diagnoses` + `icd10_codes` global + single-primary invariant + ICD search + **بوابة ICD-للمؤمَّن في `sign()`** → 422 لو insured بلا primary مكوّد). **phpunit: clinic 165 pass (523 assertions).** - **FE** (commits `6a74df6` + review-fix/i18n `b81613d`): consultation workspace (hero: sticky patient-header + chief-complaint auto-save + 3 panels صفحة واحدة + service-order rail + sign/cancel/addendum، read-only بعد التوقيع) + vitals-panel (merge-and-flush debounced PATCH، abnormal highlight) + history-panel (controls حسب input_type) + diagnosis-panel (ICD typeahead + single-primary + insured badge). route `/clinic/encounter/:id`. i18n. `ng build` أخضر. - **بوابة المراجعة (native):** BE **APPROVE-WITH-FIXES** (5 IMPORTANT: company_id على الاستعلامات الداخلية · {code:null} يمسح ICD · BMI fallback عند null · department_id company-scoped — كلها مُطبّقة +2 regression) · FE **APPROVE-WITH-FIXES** (4 IMPORTANT: vitals data-loss [switchMap→merge] · sign-block للمؤمَّن بلا primary · ICD subscription leak · icdLoading stranded — مُطبّقة). ### ✅ P5 (الطلبات الإكلينيكية — lab/radiology/prescription) — SHIPPED على `hazemdev` (2026-06-22) - **BE** (commits `c39e5997a` + review-fix `4824c7f60`): **WP-16** lab — `OrderLabFromEncounter` يلفّ LIS `CreateLabRequest` (أُضيف `handleFromArray()` adapter + sentinel `_suppress_invoice` → **لا فاتورة LIS** للأوامر النابعة من العيادة حتى لو `lis.auto_generate_invoice=true` — قرار #1 ملكية المال). 3 listeners على events LIS (`LabResultReleased/Completed/Corrected`) تسقط `ClinicalDocument` على الـ encounter (idempotent على company+encounter+ref_key) — read-only على LIS. **WP-17** radiology **مدموج في Clinic** (rad_procedures/orders/studies/reports · `clinic.rad-*`): `CreateRadOrder(source=clinic, لا فاتورة)` + state machine `pending→entered→verified→released` + auto-study-on-order + drop-report. **WP-18** prescription (Prescription/PrescriptionItem · drug_id→Core Product company-scoped + print). جدول مشترك `clinical_documents`. **phpunit: clinic 194 pass (599 assertions); LIS smoke 39 (لا regression من adapter).** - **FE** (commits `77603e2` + review-fix `e7345c9`): consultation Orders panel (tabs lab/radiology + prescription، read-only بعد التوقيع) + radiology back-office (worklist + report-editor state-machine + procedures CRUD) + routes/nav + i18n. `ng build` أخضر. - **بوابة المراجعة (native):** BE **APPROVE-WITH-FIXES** (4 IMPORTANT: audit trail [previous_value] · company_id في listeners التحويل · RadStudy show+acquire-validation · LIS adapter مؤكّد سليم) · FE **NEEDS-WORK→مُصلَّح** (1 CRITICAL: rad-worklist filter كان signal مربوط بـ ngModel بيكسره؛ + 5 IMPORTANT: search misattribution · report-editor scan · dead pending · scheduled→report nav). **مهم:** أُضيفت علاقات `Encounter::prescriptions()/radOrders()/clinicalDocuments()` تحضيرًا لـ P6. - ⚠️ **DEVIATION مسجّل:** radiology اتعمل **داخل `Modules/Clinic`** (مش `Modules/Radiology` منفصل زي ما الخطة اقترحت) — أبسط، نفس suite + صلاحيات `clinic.rad-*`. لو احتجنا فصله مستقبلًا = نقل + permission-prefix جديد. ### ✅ P6 (التأمين + NPHIES) — SHIPPED على `hazemdev` (2026-06-22) - **BE** (commits `c0c4a2baf` + review-fix `d573f67ad`): **WP-19** طبقة المطالبات — `Claim`/`ClaimLine` + `ClaimAssembler` (حارس ICD-10 إلزامي) + `CoverageService` يحسب تقسيم insurer/patient لكل بند ويكتبه على `service_order_lines` (`coverage_amount`/`patient_amount`) + caps (per-visit + `max_coverage_per_year`) + **طبقة دافع pluggable**: `ClaimSubmissionAdapter` interface مربوط في `ClinicServiceProvider::register()` بـ closure → `NphiesClaimAdapter` لو `nphies.enabled` وإلا `ManualClaimAdapter` (مصر يدوي). اعتراف الإيراد على حصة المؤمِّن عند الاعتماد عبر `ApplyAdjudicationToLedger` (CreateJournalEntry فقط). **SPIKE-B (GATE GREEN):** عُمِّمت بُناة FHIR خلف interfaces `FhirPatientSource`/`FhirServiceItemSource` (LabPatient/LabInvestigation implements — byte-equivalent، صفر regression على 55 NPHIES test). **WP-20** `ClinicNphiesClaimService` (Encounter + careTeam multi-party + multi-diagnosis) + `NphiesClaimAdapter` + writeback polymorphic (`source_type/source_id` على `nphies_transactions`؛ مسار LIS untouched). **الكل: 301 pass (900 assertions) — clinic 217 + NPHIES 55 صفر regression + LIS.** - **FE** (commits `a28406f` + review-fix `081d12d`): محرّر عقود الدافع (`payer-contracts` مع AR receivable account picker + caps) + قائمة المطالبات (`claims-list` مع KPIs + إرسال NPHIES) + routes/nav/i18n. `ng build` أخضر. - **بوابة المراجعة (native):** BE **APPROVE-WITH-FIXES** (0 CRITICAL · 4 HIGH مُطبّقة: IDOR على `Claim::show/submitNphies`+`Coverage::compute` [حارس company_id 404] · null-contract TypeError في NPHIES submit [ValidationException] · حذف `TmpDebugTest` · silent GL catch→Log::error؛ +LOW-2/5/6) · FE **NEEDS-WORK→مُصلَّح** (2 CRITICAL: `annual_cap`→`max_coverage_per_year` + حذف `discount_percent` غير الموجود في BE [كان بيضيّع إدخال المستخدم بصمت]؛ +4 IMPORTANT). **GOTCHA P2 المعروف انحلّ هنا:** حصة المؤمِّن دلوقتي بتتعرّف في P6 (مش bug). **ملاحظة معمارية:** `EncounterServiceParty` بيستخدم عمود `resolved_amount` (مش `share_amount`) — مهم لـ P7. **▶️ ~~ابدأ P7~~ — ✅ P7 خلص (SHIPPED 2026-06-22، commits BE `2fe46be50` + FE `770b41f`). كل المراحل P0→P7 اكتملت.** التفاصيل في بلوك P7 SHIPPED أعلى الملف. **نقطة الاستئناف الحقيقية دلوقتي = النشر (deploy)** — انظر القسم "▶️ نقطة الاستئناف التالية = النشر" في أعلى RESUME. ### (الخطة الأصلية — مرجع) **الحالة وقت كتابة الخطة:** التحليل (29 قسم v2 + مراجعة نقدية مطبَّقة) ✅ · التصميم البصري **معتمد من المالك** ✅ · **خطة التنفيذ الكاملة (MD، build-ready) مكتوبة** ✅. **الـ deliverables (كلها في `/home/moonui/public_html/his-analysis/`، servedعلى `moonui.elbaset.com/his-analysis/`):** 1. `clinic-his-module-analysis.html` — التحليل الكامل 29 قسم v2 (+ قسم مراجعة وتصحيحات). 2. `clinic-his-form-design.html` — **التصميم المعتمد** (mockup تفاعلي EN-primary + toggle ع · منيو رئيسي · 5 شاشات: Dashboard/Consultation[hero]/Reception+Cashier/Pricing+Split/Reports · شريط مريض غني ثابت). الهوية: clinical workstation · IBM Plex · teal. 3. `lis-redesign-assessment.html` — تحديث واجهة LIS لنفس الروح: ~60-70% موجود في الـ theme engine؛ re-skin 2-3 أيام؛ الإجمالي ~20-34 يوم. 4. **`clinic-impl/`** — 🟢 **خطة التنفيذ:** `00-master-plan.md` (skeleton · 16 enum canonical · data-model · خريطة الأجزاء/التوازي · بوابة المراجعة) + 8 ملفات مراحل **P0–P7** (build-ready WPs بالـ file:line + migrations + API + شاشة + reuse-vs-build + acceptance + phpunit). **القرارات المُلزِمة (من المراجعة النقدية — تُطبَّق في التنفيذ):** - ملكية الفلوس = **الكلينك يملك الفوترة+التقسيم**؛ LIS/RIS تنفيذ+نتائج فقط؛ فاتورة LIS تُكبَت (`auto_generate_invoice=false`) للأوامر النابعة من العيادة. - **`RequestSource::clinic`** قيمة جديدة (مش `in_patient`). - enums موحّدة: `AppointmentStatus{booked,arrived,in_consultation,done,cancelled,no_show}` · `EncounterStatus{in_progress,done,signed,cancelled}`. - ICD-10 **إلزامي** على مسار NPHIES. - الـ reuse الكبير = **refactors-with-migrations** (محرّك العمولة لـ N أطراف · سلسلة السعر · NPHIES builders · ترقية المريض) مش drop-in. - المريض = **shim/indirection مش big-bang rename** لـ `lab_patients`. **خطة التنفيذ — 8 أجزاء + بوابة مراجعة لكل جزء:** P0 الأساس → P1 الكتالوج/التسعير → P2 الأوردر/المال/التقسيم → P3 الجدولة/الحجز → P4 الزيارة/الإكلينيكي → P5 الطلبات → P6 التأمين/NPHIES → P7 التقارير. **التوازي:** P0 أول، وبعده P1/P2/P3 متوازيين؛ التفاصيل + الـ spikes (SPIKE-A قبل تقسيم الإيراد، SPIKE-B قبل NPHIES) في `00-master-plan.md §5`. **🔴 بوابة كل جزء (إلزامي):** build على `hazemdev` → phpunit(sqlite)+FE build → **مراجعة Codex + Claude code-reviewer** → تطبيق الملاحظات → **تسجيل في KB** → الجزء التالي. (Codex متعطّل على السيرفر؛ المالك يشغّله بـ `! codex exec ...` أو native fallback.) **▶️ نقطة الاستئناف:** ابدأ **P0 (الأساس)** — اقرا `clinic-impl/00-master-plan.md` ثم `P0-foundation.md`، نفّذ WP-01..04 على `hazemdev`، اتبع بوابة المراجعة. (أو استنى الـ go-ahead من المالك للبدء في الكود.) **(مؤجّل):** التوسّع الأوسع (جراحة/إقامة/طوارئ + `Modules/Obgy`) — القسم 24 في التحليل. ## Links - كل المخرجات: `/home/moonui/public_html/his-analysis/` (+ `clinic-work/` مصادر التحليل · `clinic-impl/` خطة التنفيذ) - LIS template deep-map: `his-analysis/his-vision-work/md/02-lis.md` · HIS scope matrix: `…/md/07-his-scope.md` - الكود: `moon-erp-be/Modules/{LIS,NPHIES}` · Phase-0 readiness migrations `2026_06_10_15/160000_*` · `Modules/LIS/app/Actions/CreateLabRequest.php` - النظام القديم (seeds فقط): `/home/amrtechogate/public_html/obgy/`