تحليل وخطة workflow التأجيل والرفض

وحدة: المختبر (LIS) — Moon ERP | التاريخ: 2026-05-25 | نطاق: التجميع → الاستلام → الطلبات (٣ شاشات) + شاشة جديدة لإدارة الأسباب

workflows جدد

شاشات متأثرة

تاسكات باك اند

تاسكات فرونت

~٦ س

تقدير الشغل

الفكرة في صورة سريعة

التأجيل (Defer) في التجميع: لو المريض مش جاهز أو محتاج رجوع، الموظف يأجل العينة بسبب معين. تتولد عينة "مؤجلة" ببارود منفصل، تظهر في تب جديد، ومن صفحة الطلبات يقدر يرجع لها بضغطة واحدة.

الرفض (Reject) في الاستلام: لو العينة وصلت معطوبة، تترفض بسبب معين. تظهر في تب "العينات المرفوضة"، ومن صفحة الطلبات يقدر يعيد جمعها (كلها أو واحد منها).

إدارة الأسباب: شاشة منفصلة بـ ٢ تابات (Deferral / Rejection) — الأسباب بالإنجليزي فقط — CRUD كامل (إضافة، تعديل، حذف).

الـ Audit Trail: كل تأجيل/رفض/إعادة جمع يتسجل بتاريخ ووقت — لكن دائماً تحت نفس request_id، فالطلب الواحد يقدر يكون فيه عدة محاولات جمع.

الوضع الحالي — ما هو موجود فعلاً

📌 قاعدة التسمية (مؤكدة من العميل):

في شاشة التجميع (Collection): الإجراء اسمه "تأجيل" (Defer) فقط — لا يوجد "رفض" هنا.
في شاشة الاستلام (Receiving): الإجراء اسمه "رفض" (Reject) فقط — لا يوجد "تأجيل" هنا.
السبب المنطقي: التأجيل يحدث لما المريض يصل لكن مش جاهز يدّي عينة (مش صائم، حالة صحية...). الرفض يحدث للعينة المجموعة فعلاً لكن وصلت معطوبة (هيمولايز، كمية قليلة...).

اكتشافات مهمة (يوفر شغل كبير):

جدول lab_rejection_reasons موجود بالفعل فيه: code, name_ar, name_en, category, is_active, sort_order.
الـ category field يقدر يفرّق بين أسباب التأجيل والرفض بدون جدول جديد.
موديل LabSample فيه الحقول جاهزة: is_deferred (bool), deferred_reason, deferred_investigation_ids (array), rejected_at, rejected_by, rejection_reason.
SampleStatus enum فيه Rejected case.
الـ Rejection في الاستلام موجود وشغّال — هنحدّث الـ dialog فقط ليستخدم dropdown أسباب.
زر "Refer" موجود (للمعمل خارجي) — لا يتغير.

ما يحتاج تنفيذ:

التجميع: إزالة زر "Reject" الموجود حالياً واستبداله بزر "Defer" جديد + dialog يطلب سبب تأجيل من dropdown
الاستلام: الـ Reject الموجود — تحديث الـ dialog ليستخدم dropdown أسباب رفض بدل textarea نصي حر
API endpoint POST /samples/{id}/defer
API endpoint POST /requests/{id}/recollect يقبل investigation_ids
أيقونات في صفحة الطلبات: 🕐 للمؤجل + 🖨️ لطباعة بارود المؤجل + ⚠️ للمرفوض
Recollect Dialog مشترك (مؤجل/مرفوض) — checkboxes لاختيار التحاليل
شاشة CRUD لإدارة الأسباب (بتابين: Deferral / Rejection)

الـ Workflow التفصيلي

سيناريو ١: التأجيل (Defer)

١- المريض موجود لكن محتاج رجوع لاحقاً (مثلاً: مش صائم، أو دواء معين، أو غير قابل للحقن).

٢- الموظف في شاشة التجميع يضغط زر "Defer" بجوار المجموعة (Specimen Group).

٣- Dialog يفتح: قائمة أسباب التأجيل (من جدول الأسباب، category=deferral) + ملاحظات اختيارية.

٤- الموظف يختار السبب ويؤكد.

٥- يتولد sample جديد بـ:
   is_deferred = true
   status = pending (مش collected)
   deferred_reason = <reason_code>
   deferred_investigation_ids = [...] (التحاليل المؤجلة)
   barcode = <serial جديد>

٦- العينة تختفي من المجموعات الجارية، وتظهر في تب جديد "Deferred Samples" فوق.

٧- في صفحة الطلبات، الطلب يكتسب أيقونة 🕐 جديدة "Has deferred samples".

٨- لما المريض يرجع، الموظف يضغط على الأيقونة → ينقله لشاشة التجميع → التب المؤجلة → يضغط "Collect" → العينة تتحول من pending إلى collected (نفس flow التجميع العادي).

سيناريو ٢: الرفض (Reject) — في الاستلام فقط

١- العينة وصلت لشاشة الاستلام بعد التجميع، وبتم اكتشاف إنها معطوبة (هيمولايز / كمية قليلة / حاوية غلط / barcode تالف).

٢- Dialog (محدّث): dropdown أسباب الرفض من جدول الأسباب (category=rejection) — بدل التكست بوكس الحرة.

٣- العينة تتحول إلى status = rejected مع rejected_at + rejected_by + rejection_reason.

٤- في صفحة الطلبات، الطلب يكتسب أيقونة ⚠️ جديدة "Has rejected samples".

٥- لما يضغط على الأيقونة → Dialog يعرض التحاليل المرفوضة كـ checkboxes:

"Select All" checkbox فوق
checkbox لكل تحليل (الكل مختار افتراضياً)
"Recollect" button

٦- بعد التأكيد، عينة جديدة واحدة تتولّد بالتحاليل المختارة فقط (نفس الطلب، بارود جديد) — تروح لشاشة التجميع.

سيناريو ٣: إعادة الجمع المتعددة في نفس الموعد

المريض ممكن يكون عنده عدة تحاليل مؤجلة ويرجع جميعها في نفس اليوم.

في صفحة الطلبات يضغط 🕐 → Dialog يعرض كل التحاليل المؤجلة (من كل العينات المؤجلة) كـ checkboxes.

يختار "Select All" أو يختار تحاليل معينة فقط (مثلاً يرجع لجزء منها بس).

يضغط "Recollect" → عينة جديدة بالتحاليل المختارة تظهر في شاشة التجميع.

باقي التحاليل (لو مختارش الكل) تفضل في التب "Deferred" لحين رجوعها.

سيناريو ٤: طباعة بارود العينة المؤجلة من صفحة الطلبات

جنب أيقونة 🕐 (المؤجلة) في صفحة الطلبات، أيقونة 🖨️ "Print deferred barcode".

الضغط عليها يطبع labels للعينات المؤجلة فقط (50×25mm زي العادي) لو فيه عينات مؤجلة معاها بارود متولد.

المستخدم يلصقها على الـ tube ويأخذها مع المريض لما يرجع.

تصميم الـ UI الجديد

شاشة التجميع — التابات الجديدة

┌────────────────────────────────────────────────────────────┐
│ Collection Worklist  [Active 8]  [Deferred 3]  [Rejected 1]│  ← tabs
├────────────────────────────────────────────────────────────┤
│                                                            │
│  Active tab:  (السلوك الحالي بدون تغيير)                    │
│  Deferred tab:  جدول بكل المؤجلات                          │
│    - barcode + تحاليل + سبب التأجيل + تاريخ + Recollect btn │
│  Rejected tab:  جدول بكل المرفوضات                         │
│    - barcode + سبب الرفض + تاريخ + Recollect btn           │
└────────────────────────────────────────────────────────────┘

أزرار الـ Specimen Group في التجميع (محدّث)

قبل:
┌─ Blood (Serum) ──────────────────────────────────┐
│  [📋 Collect]  [🚫 Reject]  [🏥 Refer]            │
└───────────────────────────────────────────────────┘

بعد:
┌─ Blood (Serum) ──────────────────────────────────┐
│  [📋 Collect]  [🕐 Defer]  [🏥 Refer]             │
│                  ↑                                 │
│              زر جديد (بديل الـ Reject)             │
└───────────────────────────────────────────────────┘

(الـ Reject الموجود حالياً في التجميع يتشال
 لأنه فعلياً غير منطقي — العينة لسه ما اتجمعتش)

أزرار شاشة الاستلام (تحديث dialog فقط)

قبل (الاستلام):
┌─ Scan & Receive ─────────────────────────────────┐
│  [✓ Accept]    [✗ Reject (textarea للسبب)]       │
└───────────────────────────────────────────────────┘

بعد:
┌─ Scan & Receive ─────────────────────────────────┐
│  [✓ Accept]    [✗ Reject (dropdown من الأسباب)] │
└───────────────────────────────────────────────────┘

(الزر نفسه ما يتغير — بس الـ dialog يستخدم dropdown
 بدل textarea حرة)

صفحة الطلبات — الأيقونات الجديدة

┌─ Lab Requests ─────────────────────────────────────────────────┐
│ #     | Patient    | Status     | Indicators                    │
│ R-001 | Ahmed Ali  | pending    | 🕐(2) 🖨️  ⚠️(1)              │  ← icons
│ R-002 | Sara Mahmd | in_progress|                                │
└────────────────────────────────────────────────────────────────┘

🕐 = has deferred samples (count badge) → opens Recollect Dialog
🖨️ = print deferred barcodes only (visible only when 🕐 > 0)
⚠️ = has rejected samples (count badge) → opens Recollect Dialog

Recollect Dialog (المؤجل أو المرفوض)

┌─ Recollect Deferred Investigations ─────────────────┐
│  Patient: Ahmed Ali  |  Request: R-001               │
│  ───────────────────────────────────────────────────  │
│  ☑ Select All                                        │
│                                                       │
│  ☑ Glucose     (deferred: Patient not fasting)       │
│  ☑ HbA1c       (deferred: Patient not fasting)       │
│  ☐ Cholesterol (deferred: Awaiting medication)       │
│                                                       │
│  Patient appointment: [date+time] (optional)         │
│  ───────────────────────────────────────────────────  │
│              [Cancel]    [Recollect Selected (2)]    │
└──────────────────────────────────────────────────────┘

(الشكل نفسه للمرفوضات مع تغيير العنوان فقط)

شاشة إدارة الأسباب (جديدة)

┌─ Sample Reasons ──────────────────────────────────────────┐
│  [Deferral Reasons]  [Rejection Reasons]                  │  ← tabs
├───────────────────────────────────────────────────────────┤
│  + New Reason                                              │
│                                                            │
│  ┌──────┬─────────────────────┬─────┬────────┐           │
│  │ Code │ Name (English)      │Sort │ Active │           │
│  ├──────┼─────────────────────┼─────┼────────┤           │
│  │ DEF1 │ Patient not fasting │  1  │   ✓   │           │
│  │ DEF2 │ Awaiting medication │  2  │   ✓   │           │
│  │ DEF3 │ Patient ill         │  3  │   ✓   │           │
│  └──────┴─────────────────────┴─────┴────────┘           │
└───────────────────────────────────────────────────────────┘

تغييرات الباك اند

B-1: قاعدة البيانات

لا نحتاج جدول جديد! جدول lab_rejection_reasons موجود فيه category field. هنستخدمه:

category = 'rejection' → سبب رفض
category = 'deferral' → سبب تأجيل

مهاجرة بسيطة لو محتاج: نضيف category default value أو نتأكد من إنه nullable.

B-2: Endpoint للتأجيل

POST /api/lis/samples/{id}/defer
Body: {
  reason_code: string,    // من lab_rejection_reasons (category=deferral)
  notes?: string,
  investigation_ids: int[] // التحاليل المراد تأجيلها
}

Behavior:
- لو الـ sample الأصلي عنده تحاليل كثيرة وبس بعضهم اتأجل:
  · ينشئ sample جديد بـ is_deferred=true يحوي التحاليل المؤجلة فقط
  · الـ sample الأصلي يفضل بتحاليله المتبقية (إن وجدت)
- لو كل التحاليل اتأجلت: الـ sample الأصلي يتحوّل لـ is_deferred=true بدلاً من جديد

B-3: Endpoint للـ Recollect

// نسخة per-request (للـ icon في صفحة الطلبات)
POST /api/lis/requests/{requestId}/recollect
Body: {
  source: 'deferred' | 'rejected',
  investigation_ids: int[]  // التحاليل المراد إعادة جمعها (لازم على الأقل واحد)
}

Behavior:
- ينشئ sample جديد واحد للـ request نفسه بكل التحاليل المختارة
- barcode جديد، status=pending، collected_at=null، is_deferred=false
- التحاليل المختارة "تتحرك" من العينات المؤجلة/المرفوضة لعينة جديدة جاهزة للجمع
- باقي التحاليل في العينات المؤجلة/المرفوضة تفضل كما هي (لو ما اخترتش الكل)
- التواريخ القديمة محفوظة (audit) — الـ samples الأصلية مش بتتمسح

B-4: List + Filter Endpoints

GET /api/lis/samples?is_deferred=true&status=pending
GET /api/lis/samples?status=rejected
GET /api/lis/requests?has_deferred=true
GET /api/lis/requests?has_rejected=true

B-5: CRUD لأسباب التأجيل والرفض

الـ LabRejectionReasonController موجود غالباً (لأن الـ rejection شغّال). محتاج نضيف category filter في الـ index:

GET /api/lis/rejection-reasons?category=deferral
GET /api/lis/rejection-reasons?category=rejection
POST /api/lis/rejection-reasons    (body فيه category)
PUT /api/lis/rejection-reasons/{id}
DELETE /api/lis/rejection-reasons/{id}

B-6: تحديث الـ Resource للطلب

// LabRequestResource: إضافة counters
'deferred_samples_count' => $this->samples()->where('is_deferred', true)->where('status', 'pending')->count(),
'rejected_samples_count' => $this->samples()->where('status', 'rejected')->count(),

تغييرات الفرونت اند

F-1: شاشة إدارة الأسباب (جديدة)

المسار: /lab/sample-reasons

tabs: Deferral Reasons / Rejection Reasons
كل تب فيه table بـ CRUD: code, name (English required), sort_order, active
عند الـ create/update: category يتعين تلقائياً حسب الـ tab المختار
إضافة الرابط في sidebar تحت "Catalog" → "Sample Reasons"

F-2: في التجميع — استبدال Reject بـ Defer

src/app/features/lis/samples/lis-samples.component.html + .ts

إزالة زر "Reject" الحالي من الـ specimen group (هو فعلياً غير منطقي في مرحلة التجميع)
إزالة الـ rejectDialog و openRejectDialog و confirmReject methods
إضافة زر "Defer" جديد مكان زر الـ Reject
Defer dialog جديد: dropdown أسباب التأجيل من /lis/rejection-reasons?category=deferral + textarea ملاحظات + checkbox-list للتحاليل (لو الـ group فيه أكتر من واحد ومش عاوز يأجلهم كلهم)
عند الحفظ: POST /samples/{id}/defer
refresh للقائمة + تحديث الـ counters

F-10: في الاستلام — تحديث Reject dialog فقط

src/app/features/lis/specimen-receiving/specimen-receiving.component.html + .ts

زر "Reject" يفضل زي ما هو
الـ dialog الحالي: استبدال الـ dropdown rejectReasonOptions الموجود (موجود فعلاً!) — يأكد إنه يقرأ من category=rejection فقط
الـ rejectionReasons signal الموجود يتفلتر على category

F-3: تبات Deferred / Rejected في شاشة التجميع

إضافة tabs في أعلى الـ left panel: "Active (n)" / "Deferred (n)" / "Rejected (n)"
كل تب يعرض list مختلفة بنفس layout
Deferred tab: عنصر فيه barcode + تحاليل + سبب التأجيل + تاريخ + زر "Recollect"
Rejected tab: نفس الشكل + سبب الرفض
زر Recollect → confirm dialog → POST /samples/{id}/recollect → refresh

F-4: أيقونات في صفحة الطلبات + Print Barcode

src/app/features/lis/requests/lis-requests.component.html

عمود "Indicators" جديد (أو inline في عمود Status)
أيقونة 🕐 برتقالية لو deferred_samples_count > 0 مع badge العدد → الضغط يفتح Recollect Dialog (مش navigate)
أيقونة 🖨️ صغيرة بجوار 🕐 (لو deferred_samples_count > 0) → طباعة بارود العينات المؤجلة فقط (50×25mm) — لاستخدامها على الـ tubes
أيقونة ⚠️ حمراء لو rejected_samples_count > 0 مع badge العدد → الضغط يفتح Recollect Dialog

F-5: deep-link في شاشة التجميع

قراءة query params عند الـ init
لو فيه request=X: نختار الطلب تلقائياً
لو فيه tab=deferred|rejected: نفتح التب المطلوب

F-6: Recollect Dialog مشترك (للمؤجل والمرفوض)

component واحد بـ input mode: 'deferred' | 'rejected'
عند الضغط على 🕐 يفتح بـ mode=deferred، وعلى ⚠️ بـ mode=rejected
يجلب التحاليل المؤجلة/المرفوضة للـ request المختار
كل تحليل في صف فيه: checkbox + اسم التحليل + سبب التأجيل/الرفض + تاريخ
"Select All" checkbox فوق (افتراضياً مختار)
زر "Recollect Selected (N)" → POST /requests/{id}/recollect
بعد التأكيد: dialog يقفل + رسالة نجاح + redirect لشاشة التجميع لو المستخدم عاوز

F-9: طباعة بارود العينات المؤجلة من صفحة الطلبات (جديد)

method جديد printDeferredBarcodes(request) في requests component
يجلب العينات المؤجلة للـ request (GET /samples?lab_request_id=X&is_deferred=true)
يستدعي LisBarcodeLabeService.printLabels() الموجود بالبيانات المناسبة
كل label يحوي: barcode + اسم المريض + التحاليل + tag "DEFERRED" أحمر للتمييز

F-7: تحديث خدمة الـ samples

src/app/core/services/lis-sample.service.ts

إضافة defer(id, payload)
إضافة recollect(id, payload)
إضافة listDeferred() و listRejected() (filter helpers)

F-8: i18n keys

LIS.SAMPLES.DEFER, DEFER_REASON, DEFERRED_SAMPLES
LIS.SAMPLES.REJECT_REASON, REJECTED_SAMPLES, RECOLLECT
LIS.REASONS.* (للشاشة الجديدة)
NAV.LIS_SAMPLE_REASONS

قائمة التاسكات بالتفصيل

الترتيب	التاسك	الجانب	الأولوية	التقدير
B-1	تأكيد بنية `lab_rejection_reasons` + seed أسباب deferral الأساسية	باك	متوسط	٢٠ د
B-2	POST /samples/{id}/defer endpoint + service logic	باك	حرج	٣٠ د
B-3	POST /samples/{id}/recollect endpoint + service logic	باك	حرج	٤٠ د
B-4	تحديث LabRequestResource بالعدادات + filter في samples list	باك	عالٍ	٢٠ د
B-5	تحديث LabRejectionReasonController بالـ category filter + CRUD	باك	عالٍ	٢٠ د
B-6	i18n للـ messages + validation rules	باك	متوسط	١٠ د
F-1	شاشة إدارة الأسباب الجديدة (component + service + model + routes)	فرونت	عالٍ	٤٥ د
F-2	في التجميع: إزالة Reject + إضافة Defer (زر + dialog + dropdown أسباب)	فرونت	حرج	٣٠ د
F-3	تبات Deferred/Rejected/Active في شاشة التجميع	فرونت	حرج	٤٠ د
F-4	أيقونات الإشعار في صفحة الطلبات	فرونت	عالٍ	٢٥ د
F-5	deep-link query params في شاشة التجميع	فرونت	متوسط	١٥ د
F-6	Recollect Dialog مشترك (مؤجل/مرفوض) — checkboxes + select all + count	فرونت	عالٍ	٢٥ د
F-7	تحديث LisSampleService بـ defer + recollect + list helpers	فرونت	عالٍ	١٥ د
F-8	i18n keys (en + ar) لكل النصوص الجديدة	فرونت	متوسط	١٥ د
F-9	طباعة بارود العينات المؤجلة من صفحة الطلبات (button + print logic)	فرونت	متوسط	١٥ د
F-10	في الاستلام: تأكيد dropdown أسباب الرفض (مع filter category=rejection)	فرونت	متوسط	١٠ د

الإجمالي: ~٦-٧ ساعات شغل.

الأسئلة المحتاجة قرارك قبل البدء

عند التأجيل، الـ barcode يتعمل تلقائياً ولا الموظف يطبعه بإيده؟
الاقتراح: تلقائي (يتطبع label تلقائياً مع رسالة "Sample deferred — barcode XX-001-D"). لو المريض رجع نفس اليوم بسرعة، الـ recollect ينشئ barcode جديد جديد.
المؤجل في الـ Dashboard / KPIs: يحسب ضمن "Total Requests" ولا منفصل؟
الاقتراح: ضمن الإجمالي، لكن مع KPI منفصل "Deferred Today" + "Rejected Today" في الـ Dashboard.
هل التأجيل يحتاج تأكيد إضافي؟ (لأنه يعدّل في الـ workflow)
الاقتراح: dialog واحد بالـ reason + confirm، مفيش modal تأكيد إضافي.
الفاتورة (Invoice): لما العينة تتأجل أو ترفض، التحاليل تظل في فاتورة الطلب أم تنزل القيمة؟
الاقتراح: تظل في الفاتورة (المريض دفع للتحليل، إعادة الجمع بدون رسوم إضافية).
أيقونات في صفحة الطلبات: عمود منفصل ولا inline داخل عمود الـ status؟
الاقتراح: عمود "Indicators" منفصل علشان واضح وقابل للفلترة.
الـ Audit: لو نفس العينة اتأجلت ثم اتجمعت ثم اترفضت ثم اتجمعت تاني، نسجل كل ده؟
الاقتراح: نعم، لكن من خلال جدول samples (كل عملية = sample row جديد) — مش audit log منفصل. يكفي الدالة الموجودة.

الترتيب المقترح للتنفيذ

الفاز الأول — البنية (~٢ ساعة): B-1, B-2, B-3, B-4, B-5, B-6 + F-7 (service)
الفاز الثاني — شاشة الأسباب (~٤٥ دقيقة): F-1 (شاشة إدارة الـ Sample Reasons)
الفاز الثالث — التجميع (~٧٠ دقيقة): F-2 (زر Defer + dialog) + F-3 (التبات)
الفاز الرابع — صفحة الطلبات (~٤٥ دقيقة): F-4 (الأيقونات) + F-5 (deep-link) + F-6 (recollect dialog)
الفاز الخامس — الترجمة (~١٥ دقيقة): F-8

Moon ERP — LIS Module | Defer & Reject Workflow Plan | جاهز للمراجعة