7المواصفات للتنفيذ (للوكيل)

مبني على الإطار الموجود في Moon Clinic (نوع التخصص على القسم + محرك الحقول الديناميكية) — مش بناء من الصفر. الجديد الجوهري: المنطق الشرطي، والمجموعات المتكررة، والحسابات، والكيانات اللي محتاجة جداول خاصة.

٧.١ · المبدأ المعماري: الـ Schema هي المصدر الوحيد

الـ MODULES اللي في الصفحة دي (قسم ٨) هي نفسها اللي بتتنزل في الباك إند كـ definitions وبتتعرض في الفرونت بـ renderer واحد. إضافة Module جديد أو حقل جديد = صف في الـ definitions، مش شاشة جديدة.

القسم: departments.clinical_type = gyn_ob (الإطار موجود: enum + registry في الفرونت). الزيارة اللي خدمتها في قسم نوعه gyn_ob بتفتح الـ workspace ده بدل شاشة الكشف العامة.
محرك الحقول: تمديد history_questions الموجود (CRUD + Resource + Seeder + renderer) بالأعمدة: module_key · section · show_if (JSON) · repeat_group · repeat_of · field_type (chips/seg/sel/num/date/text/area/bool/score/calc/table) · unit · options (JSON أو lookup_key) · computed_key · scope (patient|episode|encounter) · is_private · sort_order. ده بالظبط الفجوة اللي اتسجّلت في clinic-dynamic-fields.md: «المنطق الشرطي مش موجود».
القيم: جدول واحد clinical_field_values: record_type/record_id (episode · encounter · operation · cycle · pregnancy…) · field_code · repeat_index · value_num · value_text · value_json · recorded_by · recorded_at · version. الأرقام في value_num علشان البحث والإحصاء والـ trend.
show_if بصيغة واحدة: {"k":"field","eq":"x"} · {"k":"field","in":[..]} · {"k":"field","gt":n} · {"any":[..]} · {"all":[..]} · {"cat":"infertility"}. نفس المفسّر في PHP (للتحقق والـ summary) وفي TS (للعرض).
القوائم (lookups): كل قايمة اختيار ليها lookup_key؛ القيم مبذورة من الـ Schema + إضافة inline من الشاشة بتترسّخ للعيادة (نمط الجينا) + favorites لكل دكتور.
Presets: حزمة packs/gyn_ob.json بتتبذر بـ updateOrCreate مفتاحها (company_id, code) — نفس آلية PresentHistoryQuestionSeeder؛ العيادة تعدّل من غير ما التحديث يدهس تعديلها.

٧.٢ · الكيانات اللي ليها جداول خاصة (مش EAV)

ده لأنها بتتعرض كـ cards/جداول، وبيتبحث فيها، وبيتعمل عليها dashboards:

الجدول	الأعمدة الأساسية	ليه جدول
gyn_episodes	patient_id · type (gyn/fertility/pregnancy/urogyn/sexual/operation) · categories (JSON) · opened_at · closed_at · status · primary_doctor_id · team (JSON)	حلقة الـ Timeline وتسلسل الحالة من العقم للحمل للولادة
patient_alerts	patient_id · code (drug_allergy/dvt_pe/thrombophilia/anticoag/transfusion/airway/custom) · label · severity · source_field · active · set_by	شريط التنبيهات الثابت فوق كل الشاشات
obstetric_history_rows	patient_id · year · ga_weeks · outcome (SVD/CS/instrumental/abortion/ectopic/molar/stillbirth/NND) · cs_indication · birth_weight · neonatal_outcome · nicu · pph (JSON: cause/treatment/products) · sepsis (JSON) · transfusion · notes	G/P/A/L بتتحسب منه، وبيظهر في header كل الشاشات
pregnancies + antenatal_visits	lmp · edd · dating_method · risk_level · categories · conditions (JSON) · status / visit: ga · bp · weight · fhr · fh · urine · symptoms · plan · next_visit	EDD/GA، جدول متابعة ديناميكي، تقرير المواليد المتوقعة (زي الجينا)
treatment_cycles + cycle_visits + follicles	cycle_no · kind (OI/IUI/IVF/ICSI/FET) · cd1 · protocol · meds (JSON) · trigger (JSON) · luteal (JSON) · outcome / visit: cd · et_mm · decision / follicle: side · size_mm	كارت لكل دورة + timeline + إحصائيات IVF
operations + operation_procedures	episode_id · date · indication · approach · anesthesia · surgeon/assistant/anesthetist · ebl · blood_products (JSON) · complications (JSON, Clavien) · specimens (JSON) · postop_plan · status / procedure: code · side · fields (JSON)	تقرير عملية، سجل العمليات اليومي، PROMs قبل/بعد
popq_measurements	patient_id · episode_id · phase (pre/post) · aa ba c d ap bp tvl gh pb · stage (محسوب) · measured_at	مقارنة قبل/بعد بالأرقام
prom_scores	patient_id · instrument (ICIQ-UI-SF/UDI-6/PGI-I/FSFI/FSDS-R/OAB-q) · items (JSON) · total · domains (JSON) · phase · scored_at	baseline vs follow-up، نسبة التحسن
urodynamic_studies	pretest (JSON) · filling (JSON) · stress (JSON) · pressure_flow (JSON) · urethral (JSON) · diagnoses (JSON) · interpretation · report_status	تقرير UDS مولّد + قابل للتعديل قبل الاعتماد
team_referrals	episode_id · team · reason · requested_at · status (requested/seen/opinion/joint/back) · member · plan	يظهر في الـ Timeline والـ dashboard
follow_up_tasks	patient_id · source (operation/cycle/pregnancy/urogyn/sexual) · due_at · template (JSON) · status (due_soon/overdue/done) · done_encounter_id	بتتعمل تلقائي حسب العملية/العلاج وتتعدّل
clinical_notes	record_type/id · module_key · body · is_private · author_id · created_at (immutable, addendum فقط)	بوكس الـ Notes لكل Module + Private clinical note
media (موجود: attachments)	+ record_type/id · module_key · kind (photo/video/link/pdf) · external_url · is_private · access_level	مربوطة بالعملية/الـ Module، مفيش public link
access_audit	user_id · patient_id · action (view/export/download/upload/share/print) · record_type/id · ip · at	Audit للاطلاع — ناقص في النظام دلوقتي

٧.٣ · الصلاحيات والأدوار (gyn.*)

gyn.file.view · gyn.file.edit · gyn.file.delete (محدود: مسودة بس) · gyn.history.view/edit · gyn.operations.view/edit/sign · gyn.cycles.view/edit · gyn.pregnancy.view/edit · gyn.urogyn.view/edit · gyn.urodynamics.view/edit/sign
gyn.sexual.view · gyn.sexual.edit · gyn.private_notes.view/edit — منفصلة، والافتراضي: الطبيبة المعالجة بس.
gyn.media.upload · gyn.media.download · gyn.media.share · gyn.export.identified · gyn.export.deidentified · gyn.summary.generate · gyn.alerts.manage · gyn.lookups.manage
Data scope: نفس آلية ResourceScope الموجودة: assigned (حالاته المسندة له في الـ team) / branch / all. الاستقبال: شاشات الحجز والكاشير بس، ومفيش gyn.*.
أدوار افتراضية مبذورة: gyn_consultant · gyn_doctor · gyn_team_member · gyn_nurse · gyn_sonographer · gyn_reception (= reception الحالي).

٧.٤ · الـ API (REST) — نفس أنماط الموديولات الحالية

GET /gyn/definitions?company → الـ Schema كاملة (modules/sections/fields/show_if/options) — بتتكاش في الفرونت.
GET /gyn/patients/{id}/record → endpoint واحد بيرجّع: profile + alerts + obstetric rows + G/P/A/L + episodes + active cycle + pregnancy + follow-ups + teams (نفس نموذج nutrition record).
PUT /gyn/records/{type}/{id}/values (bulk upsert، autosave بـ debounce) · POST /gyn/episodes · POST /gyn/cycles + /visits · POST /gyn/operations + /sign · POST /gyn/pregnancies + /visits · POST /gyn/popq · POST /gyn/proms · POST /gyn/urodynamics + /report · POST /gyn/referrals · POST /gyn/notes · POST /gyn/media (private disk، signed URL قصيرة العمر، كل تحميل بيتسجل).
POST /gyn/summary {type, episode_id, include_private:false} → نص مولّد من templates لكل Module (PHP) — نفس القواعد اللي في الصفحة دي.
POST /gyn/export {deidentified:true} → يشيل الاسم/التليفون/الرقم القومي/العنوان/التواريخ الدقيقة (تتحوّل لسنة) ويسجّل في access_audit.
التوقيع: الكشف/العملية بعد sign بتتقفل، وأي تعديل = addendum باسم وتاريخ (موجود في الكلينك).

٧.٦ · الربط بالعمليات والمستشفى — نظام واحد للعيادة والمركز والمستشفى

المبدأ: السجل السريري للعملية (ليه · لقينا إيه · عملنا إيه · النتيجة) كيان واحد في الكور اسمه clinical_procedures — مش جزء من موديول المستشفى. موديول المستشفى (hospital_surgeries: الجدول، الغرفة، الفريق، الأتعاب، المستهلكات، الفاتورة) اختياري بيتربط بيه لو موجود. كده نفس الشاشة ونفس البيانات بتشتغل في الثلاث حالات من غير ما نغيّر كود لكل عميل — الفرق بإعداد.

الإعداد clinic.procedures.mode	عيادة (العمليات في مستشفى بره)	مركز (يوم واحد / منظار)	مستشفى كامل
الحجز	تاريخ + اسم المستشفى + الجرّاح (نص) — مفيش جدول غرف	حجز في جدول غرف المركز (hospital_surgeries بدون إقامة، needs_admission=false)	حجز + إقامة + سرير (الموجود)
السجل السريري	واحد: clinical_procedures + حقول الإجراء من الـ Schema (findings منظّمة · حقول خاصة لكل إجراء · Clavien · عيّنات/histopath · ميديا · خطة ما بعد العملية)
الفريق والأتعاب	أسماء بس (لا أتعاب)	الموجود: hospital_surgery_team + FeeCalculator (6 طرق)
المستهلكات والزرعات	نص (نوع الـ mesh مثلاً)	الموجود: hospital_surgery_items بـ lot / serial / expiry + صرف من المخزن
WHO checklist · الأوقات	اختياري (مخفي افتراضياً)	الموجود
الفاتورة	كشف/خدمة في العيادة	الموجود: باكدج / باكدج دكتور / itemized / تأمين + preauth
الخروج والمتابعة	واحد: Discharge template + follow_up_tasks تلقائي + Operative summary + Timeline

جدول clinical_procedures: patient_id · episode_id · performed_at · place (internal / external + hospital_name) · status (planned / done / cancelled) · procedure_codes (JSON من المكتبة) · approach · anesthesia · surgeon_id أو surgeon_name · hospital_surgery_id (nullable) · signed_at / signed_by. الحقول السريرية التفصيلية في clinical_field_values بـ record_type = clinical_procedure.
مكتبة الإجراءات واحدة: hospital_operations هي الكتالوج (موجودة وليها شاشة إعداد). يتضاف عليها عمود clinical_template (مثلاً gyn_tlh / gyn_mus / gyn_cs) يحدد الحقول الخاصة اللي تفتح. العيادة بتستخدم نفس الكتالوج حتى لو مفيش مستشفى.
من الكشف: زرار «حجز عملية» في كشف النساء بيعمل clinical_procedure (مخطط) + — لو الوضع مركز/مستشفى — حجز في hospital_surgeries بالمريضة والإجراء والتشخيص قبل العملية والجهة. الاتنين مربوطين بـ id.
من المستشفى: لما حالة العملية تبقى done أو الجرّاح يفتح تاب «التقرير»: لو الإجراء ليه clinical_template يتفتح الـ renderer بتاع الـ Schema بدل التقرير الحر الحالي (procedure/findings/complications/blood_loss/drains/closure/specimens نص). لو مفيش template، التقرير الحر زي ما هو — صفر كسر للعملاء الحاليين.
إضافات صغيرة على المستشفى: clinical_template على الكتالوج · complication_grade (Clavien-Dindo) · ربط الميديا بالعملية · histopathology من قايمة بدل نص · الزرعات (mesh/sling) تتسجل كـ items بـ lot/serial.
التبديل بين الأوضاع: عيادة بدأت بـ external وبعدين فتحت مركز: الإعداد يتغيّر، السجلات القديمة تفضل زي ما هي (hospital_surgery_id فاضي)، والجديدة تتربط بالجدول. مفيش migration ولا كود.

٧.٥ · اللي موجود وبيتعاد استخدامه vs الجديد

الجزء	موجود في Moon Clinic	جديد في الموديول ده
المريض والحجز والكاشير والباكدج	✓ كما هو	حقول: الزوج (اسم/سن/تليفون/وظيفة)، الزواج (أول/تاني + مدة)، زواج سابق للطرفين، Rh
الزيارة (encounter) + التوقيع + addendum	✓	workspace لنوع gyn_ob بدل الشاشة العامة
محرك الحقول (history_questions)	✓ CRUD/renderer/seeder	show_if · repeat · calc · module/section · private · lookups بإضافة inline + favorites
الروشتة والطلبات والتحاليل والأشعة	✓	Subject toggle (المريضة/الزوج) على الروشتة والطلب · Discharge template بأدوية جاهزة · شبكة اختيار قصوى للتحاليل بفئات ANC/ICSI/ذكورة
المرفقات + activity log	✓	ربط بالـ Module/العملية · video/link · access audit للاطلاع والتحميل · private
الأدوار والصلاحيات وData scope	✓	gyn.* · assigned-team scope · صلاحيات upload/download/export منفصلة
Timeline · Summary generator · Follow-up tasks · Alerts · PROMs · Cycles · Operations · Pregnancy · UDS	—	كله جديد (جدول ٧.٢)

9الأمان والخصوصية

إجابة على كل نقطة في رسالة الدكتورة: متوفر شغال في النظام دلوقتي، وقبل التشغيل هيتعمل كجزء من المشروع قبل ما تدخل بيانات مرضى.

الخيار 1: على سيرفر العيادة مُوصى به

البرنامج بيتنصّب على سيرفر خاص بالعيادة، والداتا ملك العيادة ومكانها عندها.
شركتنا مالهاش دخول على الداتا. التحديثات بتوصل كحزم موقّعة (MoonStack).
الدعم الفني بيدخل بس بطلب منكم، لوقت محدد، وبيتسجل.

الخيار 2: مستضاف عندنا (Private server)

سيرفر مخصص للعيادة، ومش مشترك مع عملاء تانيين.
الدخول التقني محصور في عدد محدد ومتفق عليه بالاسم، وبيتسجل.
الحقول الحساسة والميديا والنسخ الاحتياطية متشفرة.

المطلوب	الحل	الحالة
Roles & Permissions	صلاحية لكل شاشة ولكل إجراء (View / Add / Edit / Delete)، والدور بيتظبط حسب العيادة	متوفر
Export / Download / Upload / Share media	صلاحيات منفصلة لكل واحدة (gyn.media.* · gyn.export.*)	قبل التشغيل
نطاق البيانات	كل دور ليه نطاق: اللي سجّله / الفرع / الكل	متوفر
الفريق يشوف حالاته بس	الحالة بتتسند لفريق (team_referrals)، وكل عضو بيشوف الحالات المسندة ليه	قبل التشغيل
Reception بدون تفاصيل طبية	دور الاستقبال مالوش أي صلاحية gyn.*	متوفر
Sexual health module	صلاحية منفصلة + Private clinical note لا تظهر في أي Summary/Export إلا بإذن الطبيبة	قبل التشغيل
Audit log للتعديلات	مين ضاف أو عدّل وإمتى، والقيمة قبل وبعد	متوفر
Audit log للاطلاع	مين فتح ملف المريضة، ومين حمّل ميديا، ومين عمل Export/Share/Print (access_audit)	قبل التشغيل
الـ History ماتختفيش	الكشف بعد الاعتماد بيتقفل، وأي إضافة بتبقى Addendum بتاريخها واسمها؛ القيم بـ version	متوفر
Login	اسم مستخدم وباسورد، وقفل الحساب مؤقتاً بعد محاولات غلط	متوفر
MFA / Two-factor	كود من تطبيق Authenticator للحسابات اللي ليها وصول طبي	قبل التشغيل
Automatic logout	خروج تلقائي بعد مدة عدم استخدام (افتراضي 15 دقيقة على الموبايل)، وانتهاء للـ token	قبل التشغيل
Staff مشي	إيقاف الحساب فوراً مع قفل كل جلساته، والسجلات تفضل باسمه وتاريخها (مفيش حذف مستخدمين)	قبل التشغيل
Encryption أثناء النقل	HTTPS / TLS بين الجهاز والسيرفر	متوفر
Encryption وهي متخزنة	تشفير الحقول الحساسة (اسم/تليفون/رقم قومي/Private notes) والميديا والنسخ الاحتياطية	قبل التشغيل
الصور والفيديو	تخزين خاص، ومفيش Public link، والفتح بعد تسجيل الدخول وبالصلاحية وبرابط مؤقت	متوفر
فيديو العمليات و Links خارجية	رفع فيديو، وربط Link خارجي بالعملية؛ التحميل بالصلاحية وبيتسجل	قبل التشغيل
Backup	نسخ يومية تلقائية، ونسخة خارج السيرفر	متوفر
Backup كامل ومتشفر + الاسترجاع	النسخة تشمل الميديا ومتشفرة، وفيه خطة استرجاع مجرّبة (RPO يوم · RTO 4 ساعات)	قبل التشغيل
Export بدون هوية	De-identified export للـ Audit والـ Research والـ Teaching	قبل التشغيل
الموبايل	Web app على المتصفح، ومفيش بيانات مرضى بتتخزن على الجهاز (لا offline cache للملف الطبي)	متوفر
لو الموبايل اتسرق	قفل جلسة الجهاز ده من حساب تاني، وانتهاء تلقائي للجلسات، و MFA	قبل التشغيل
اللي بيوصل للشركة	بيانات تشغيل تقنية بس (رقم النسخة وعدد المستخدمين)، ومن غير أي بيانات مرضى، وممكن تتقفل	متوفر
ملكية البيانات	بيانات المرضى ملك العيادة والطبيب؛ الشركة خدمة تقنية بس — بتتكتب في اتفاقية حماية بيانات (DPA)	متوفر

مثال للأدوارالعيادة بتعدّله

الدور	View	Add / Edit	Delete	Export	Download media	Upload media	Sexual module	Private notes
Consultant / Doctor	✓	✓	مسودة	✓	✓	✓	✓	✓
Clinical team	حالاته	حالاته	—	—	حالاته	✓	بإسناد	—
Nurse / Assistant	قياسات	قياسات	—	—	—	—	—	—
Sonographer	أشعة	تقرير US	—	—	—	صور US	—	—
Reception	إداري	حجز	—	—	—	—	—	—
الدعم الفني (الشركة)	—	—	—	—	—	—	—	—

لو حصل Security incident

1عزل الحساب أو الجهاز وقفل الجلسات

2تحديد اللي حصل من الـ Audit log

3إبلاغ العيادة خلال 24 ساعة

4إصلاح واسترجاع من نسخة سليمة

5تقرير مكتوب وإجراءات منع التكرار

10اللي اتاخد من برنامج الجينا القديم ومن السوق

برنامج الجينا (15 سنة استخدام، حساب amrtechogate) اتقرا جدول جدول، والمفردات الحقيقية بتاعته (HSG، منظار، سونار، histopath، placenta…) دخلت في القوائم هنا بعد تنضيفها.

من الجينا القديمة — بنعيد استخدامهمجرّب

«الدكتور يختار مش يكتب»: كتالوج lookup لكل قايمة + إضافة inline بتترسّخ + favorites (هنا لكل دكتور بدل global).
Subject toggle (المريضة/الزوج) على الروشتة وطلب التحاليل (forhusband) — بقى خاصية على كل أوردر.
G/P/A/L محسوبة من صفوف الحمل السابق + حالة الحمل الحالية، وبتظهر في header كل شاشة.
الـ EPC lookups (EPL / A T1 / A T2 / C VM / P VM / EP / PUL) + علاجها (conservative / miso / MTX / D&C / lap -otomy/-ectomy) — دخلت في صفوف الحمل السابق.
الزواج السابق للزوجة والزوج (مدة، ذكور/إناث) — مطلب الدكتورة في Infertility.
IVF sheet: شبكة التنشيط بأقطار البصيلات 10–20mm، OPU (MII/MI/GV)، التخصيب، ET fresh/frozen، التجميد، تحضير بطانة FET، النتيجة (hCG/sac/delivery) — كلها في Module الـ IVF هنا.
Andrology المتقدم: scrotal US، karyotype، Y microdeletion (AZF a/b/c)، SDF، TESE/micro-TESE، هرمونات الزوج.
HSG/SIS/TVS/Doppler بمفردات R/L tube (patent/block proximal-distal/hydrosalpinx/peritubal adhesions/delayed spill).
منظار البطن والرحم بـ findings + management لكل عضو (uterus/R tube/L tube/R ovary/L ovary/pelvis — cx/cavity/R ostium/L ostium).
4D/T1/T2 scan booking من ANC + تقرير المواليد المتوقعة بالتاريخ + كارت المتابعة المطبوع + مكتبة تعليمات المريضة + خطاب تحويل للمستشفى + تنسيق طباعة قابل للإعداد.
التحاليل: 276 تحليل في 20 فئة (منها ANC booking / ANC 27w / pre-op-ICSI / semen / genetics / aneuploidy) بشبكة اختيار قصوى + «حدد الفئة كلها».

من السوق والمعاييرbenchmark

BSUG database (جمعية Urogyn البريطانية): سجل عمليات بـ POP-Q قبل/بعد + PROMs (ICIQ, PGI-I) + complications — نفس نموذج Urogyn هنا.
BSGE endometriosis centres database: pain scores + سجل جراحي بالمواقع — نموذج الـ DIE sites و imaging-vs-operative.
Astraia / GE ViewPoint: تقرير سونار منظّم (biometry + anatomy survey + conclusion) — نموذج تقرير السونار التوليدي.
IDEAS/Meditex · BabySentry · ARTPro: دورة = كارت، monitoring grid، OPU/ET/cryo، إحصائيات — نموذج Treatment cycles.
Epic Stork / Oracle Health: antenatal flowsheet ديناميكي حسب الخطورة، partogram، تصنيف Robson للقيصرية.
WHO Labour Care Guide (2020) كمرجع لحقول المخاض، وRCOG GTG 37a للـ VTE score، وFIGO (PALM-COEIN، fibroids)، IOTA/O-RADS للأورام الملحقية، rASRM/#Enzian/EFI للبطانة المهاجرة، ICS POP-Q، IUGA/ICS للمصطلحات، Clavien-Dindo للمضاعفات.
ما لم نجده في أي منهم كوحدة واحدة: GYN + خصوبة + توليد + Urogyn + Sexual health في ملف واحد بـ Timeline واحدة و Summary تلقائي — ده الفرق اللي الدكتورة طالباه.

4الفلو بتاع كل Module

5مطابقة طلبات الدكتورة بالتحليل

6الحسابات والمعايير المدمجة