🔬 LIS Master Blueprint — Sample × Investigation Lifecycle

١. الـ Data Model الموحَّد

الجدول المحوري الجديد: lab_sample_investigations

lab_sample_investigations
├── id
├── lab_sample_id              FK → lab_samples (الـ sample الحالي)
├── lab_investigation_id       FK → lab_investigations (التحليل الفردي — لو panel member، ده الـ member ID)
├── lab_request_investigation_id  FK → lab_request_investigations (الـ pivot الأصلي)
├── lab_request_id             FK → lab_requests (denormalized for fast queries)
├── status                     ENUM (state machine بالأسفل)
├── lab_external_lab_id        FK → lab_external_labs (للـ outsourced فقط)
├── external_send_at           TIMESTAMP NULL
├── external_received_at       TIMESTAMP NULL
├── assigned_to_user_id        FK → users NULL (مسؤول عن الـ outsourced)
├── retest_count               INT DEFAULT 0
├── created_at, updated_at, deleted_at
└── UNIQUE(lab_sample_id, lab_investigation_id, deleted_at)

جدول السجل (audit trail): lab_sample_investigation_logs

lab_sample_investigation_logs
├── id
├── lab_sample_investigation_id  FK
├── lab_sample_id, lab_investigation_id  (denormalized)
├── action                       ENUM('created','collected','received','rejected',
│                                  'deferred','cancelled','outsourced','received_back',
│                                  'result_entered','rerun','retracted','released',
│                                  'printed','published')
├── from_status, to_status       ENUM
├── reason_code                  STRING NULL (e.g. NOT_FAST, HEMOLYZED)
├── reason_text                  TEXT NULL (سبب نصي للـ defer/cancel/reject)
├── result_value_before          TEXT NULL (للـ rerun — قيمة قبل المسح)
├── meta                         JSON NULL
├── user_id                      FK → users
├── ip_address, user_agent
└── created_at

تعديلات على جداول قائمة

٢. الـ State Machine الموحَّد (لكل تحليل)

الـ Actions ↔ Status Transitions

٣. الشاشات (Mockups + Logic)

٣.١ شاشة Collection /lab/samples

الـ Logic

• الـ tube بيعرض الـ test codes الفردية (من sample.investigations) — لا panel parent ولا inference.
• التحاليل deferred/cancelled/outsourced على نفس الـ request مش بتظهر هنا (في تاباتهم).
• كل عملية (Defer/Cancel/Send Out) بتفتح dialog فيه قائمة الـ tests بـ panel structure (parent header + members).
• الـ Cancel والـ Send Out كل واحد بياخد سبب + comment داخلي.
• الـ "Sent Out" tab هو نفس الـ referrals لكن فلتر بـ status outsourced.

٣.٢ شاشة Reception /lab/reception (جديدة)

الـ Logic

• الصفحة بتجمع كل الـ samples اللي status=collected في المعمل (بانتظار الاستقبال).
• Scan barcode → يلاقي الـ sample → يـ highlight ويعرض الـ tests.
• زر Reject يفتح dialog مشابه للـ defer dialog: select الـ tests + reason. ينقل الـ rows لـ status=rejected (مش sample جديد — على نفس الـ sample، لأن الـ sample اترفض جزئياً أو كلياً).
• الـ "Rejected" tab هي اللي بتطلع منها الـ tests للـ recollect (تظهر في صفحة الـ requests بأيقونة).

٣.٣ شاشة Workflow /lab/worklist (الكان بان للمعمل الداخلي)

الـ Logic الجديدة

• Per-test actions: الكان بان بيعرض الـ tests الفردية مش الـ samples. كل test بيتم تتبعه بـ status فرديًا.
• Rerun (إعادة التست):
  1. الـ status الحالي ينخزن في lab_sample_investigation_logs مع action=rerun و result_value_before
  2. الـ lab_result الحالي بـ is_retracted=true (أو ينقل لـ history table)
  3. تنشأ lab_result جديدة فاضية
  4. retest_count++ على الـ sample_investigation
  5. الـ test بترجع لـ in_progress لحد إدخال النتيجة الجديدة
  6. علامة ↻×N بتظهر في الكارد
• Cancel/Defer/Send Out: نفس الـ logic بتاع الـ collection لكن من الكان بان.
• Panel: ممكن defer/reject/send-out كل البنل أو member واحد. الـ dialog بيعرضها بـ parent header + members.

٣.٤ شاشة Validation /lab/validation (superset من Workflow)

الـ Logic

• الصفحة بتعرض الـ tests اللي في status: result_entered أو validated.
• عمودين منفصلين للـ history:
  • Sample History — rerun count + previous values على نفس الـ sample (من logs)
  • Patient History — نتائج المريض السابقة لنفس التحليل في requests قديمة
• التحاليل الخارجية تظهر بلون مميز (EXT).
• التحاليل المؤجلة تظهر بـ Deferred.
• كل الـ actions موجودة هنا أيضاً (rerun, cancel, send out) لو احتيج للإعادة بعد إدخال النتيجة.

٣.٥ شاشة Referrals /lab/referrals

الـ Logic

• الـ referrals بتطلع لما يحصل Send Out من أي شاشة (collection/kanban/validation).
• الـ TAT بييجي من lab_external_lab_pricing.tat_hours (أو الافتراضي من lab_investigations.tat_hours).
• الـ Assigned To — حقل جديد يحدد المسؤول الفني عن الإرسال/الاستقبال.
• كل مرحلة (Send/Receive/Enter Result) بتسجل وقت ومين عمل + log.
• بعد إدخال النتيجة هنا، الـ test بيظهر في الـ Validation screen عادي.

٣.٦ مصادر النتائج (Result Entry Sources)

الفلسفة: Machine = Manual + Metadata

٣.٧ Smart Search + Bulk Operations

الـ Mockup

الـ Use Cases الفعلية

الـ Backend

POST /lis/sample-investigations/bulk-action
{
  action: "validate" | "release" | "print" | "publish" | "unpublish" |
          "rerun" | "send_out" | "cancel" | "defer",
  sample_investigation_ids: [123, 124, 125, ...],
  reason: "..." (للـ cancel/defer/send_out)
  external_lab_id: 5  (للـ send_out)
}

QC / Precision Check Mode

٤. الـ Comments Architecture

٥. الـ Audit Trail

٦. خطة التنفيذ (5 Phases)

٧. اللي هنستفيد منه من الموجود (لا نعيد كتابته)

٨. ميزات هنحصل عليها مجاناً

1. Audit شامل: كل تحليل عنده سجل كامل بكل عملياته
2. Reports جديدة: "كم تحليل اتأجل اليوم"، "متوسط زمن الاستقبال"، "TAT الفعلي vs الافتراضي"
3. Per-test SLA tracking: ممكن تقول "ده تحليل تأخر عن الـ TAT بتاعه"
4. Sample history: ممكن ترجع لأي sample وتشوف رحلتها كاملة
5. Patient longitudinal: نتائج المريض عبر الزمن لنفس التحليل
6. No more "panel as one test": كل member يتم تتبعه بشكل مستقل

٩. اللي محتاج تأكيدك عليه