🗑️ إلغاء طلب B2B قبل استلامه في المعمل — التحليل والخطة

وقت ما المعمل الخارجي بيعمل Request من البورتال، الـ store() بيعمل كل ده في transaction واحدة وخطوة واحدة — مفيش خطوة تجميع منفصلة:

الـ Receive (LabSampleService::deliver()) بيعمل: العينة → delivered، الـ pivots → received، وبيطلق LabSampleReceived اللي بينشئ الـ LabResult ويدخّل التحاليل الكانبان. قبل الـ Receive: صفر نتائج، صفر بنود مرحّلة، مفيش قيد محاسبي. عشان كده الإلغاء قبل الاستلام «نظيف» تمامًا.

المعيار مش على request.status (لأنه بيفضل pending بعد الإنشاء ومش موثوق) — المعيار على الحقيقة الفعلية للعينات والنتائج:

• ✅ مفيش أي عينة حالتها delivered أو received — كل العينات لسه collected.
• ✅ مفيش أي LabResult للطلب (النتائج بتتولد وقت الاستلام بس).
• ✅ (احتياطي) request.status ≠ cancelled — منع الإلغاء المزدوج (idempotent).

اتأكدت من الكود إن في تلتين فجوة لازم نسدّهم وإلا الإلغاء هيبقى ناقص:

• الفجوة أ: deliver() بيتحقق بس من sample->status->canDeliver() (= collected). مابيبصش على حالة الطلب → يعني عينة طلب ملغي تفضل قابلة للاستلام.
• الفجوة ب: شاشة الاستقبال بتفلتر العينات بالـ status بس → عينة collected لطلب ملغي هتفضل ظاهرة.

الحل (أنظف خيار): نضيف حالة جديدة SampleStatus::Cancelled = 'cancelled' ونحوّل عينات الطلب الملغي ليها:

• canDeliver() بترجع false تلقائيًا لأي حالة غير collected → الاستلام يتمنع من غير أي تعديل تاني. ✅
• الفلتر status=collected في الاستقبال مش هيجيبها. ✅
• تعديل صغير: إضافة الـ case في الـ label() match (exhaustive) + مفتاح ترجمة sample_statuses.cancelled.

الـ LabRequestService::cancel() الحالي بيغيّر الـ status بس (مايلمسش الفاتورة) → مش كفاية للـ B2B. نعمل دالة واحدة فيها الـ reversal الكامل، يستدعيها البورتال والموظف — بدون تكرار:

// Modules/LIS/app/Services/ExternalLabPortalRequestService.php (أو Billing/Request service)
public function cancelB2bRequest(LabRequest $req, ?string $reason): LabRequest
{
    // idempotent
    if ($req->status === RequestStatus::Cancelled) return $req;

    // GUARD — حقيقة العينات/النتائج، مش الـ status
    $hasReceived = $req->samples()
        ->whereIn('status', [SampleStatus::Delivered, SampleStatus::Received])->exists();
    $hasResults  = LabResult::where('lab_request_id', $req->id)->exists();
    if ($hasReceived || $hasResults) {
        throw ValidationException::withMessages([
            'status' => [__('lis::lis.b2b_request_already_received')],
        ]);
    }

    return DB::transaction(function () use ($req, $reason) {
        $req->update([
            'status' => RequestStatus::Cancelled,
            'cancelled_at' => now(),
            'cancellation_reason' => $reason,
        ]);

        // العينات → cancelled (يمنع deliver + يختفي من الاستقبال)
        $req->samples()->update(['status' => SampleStatus::Cancelled]);

        // الـ pivots → cancelled + soft delete + log
        $pivots = LabSampleInvestigation::where('lab_request_id', $req->id)->get();
        foreach ($pivots as $p) { /* log(cancelled) ثم */ $p->update(['status'=>...Cancelled]); $p->delete(); }

        // الفاتورة → cancelled (تتحرر من كشف الحساب)
        LabInvoice::where('lab_request_id', $req->id)
            ->where('invoice_type', LabInvoiceType::ExternalLabReceivable)
            ->whereNotIn('status', [LabInvoiceStatus::Paid, LabInvoiceStatus::Cancelled])
            ->update(['status' => LabInvoiceStatus::Cancelled]);

        return $req->fresh();
    });
}

الـ Endpoints

• طلب متعدد العينات، بعضها اتستلم: الـ guard بيمنع الإلغاء كله (أي عينة delivered = ممنوع). صح — الطلب «دخل المعمل».
• استلام يحصل وقت الدايلوج مفتوح: الـ guard في الباك إند هو الحَكَم — يرجّع 422 ويتعامل الـ FE بأمان.
• إلغاء مزدوج: idempotent — لو ملغي بالفعل يرجّع الحالة من غير خطأ.
• فاتورة مدفوعة جزئيًا: مستحيل قبل الاستلام (الدفع بيتعلّق بالمطالبة بعد الـ Release) — ومع ذلك الشرط whereNotIn(Paid) بيحميها.

• أنشئ طلب B2B (curl بتوكن البورتال) → سجّل request_id + invoice + collectibleBalance قبل وبعد.
• POST …/{id}/cancel → 200 · الطلب cancelled · العينات cancelled · الـ pivots اختفت · الفاتورة cancelled · collectibleBalance رجع نقص.
• الطلب الملغي اختفى من شاشة الاستقبال ومن الورك ليست/الفليديشن.
• جرّب deliver على عينة الطلب الملغي → مرفوض (422).
• اعمل Receive لطلب تاني الأول ثم cancel → 422 «اتستلم خلاص».
• FE: الزر يظهر/يختفي صح · الدايلوج · رسائل النجاح/الخطأ · RTL.