Files
clinicpro/assets/admin/hooks/useResourceBooking.ts
T
hamedandClaude Opus 5 4049daf071 feat: close the last four domain events, and the panel paths they describe
Every one of the fourteen named events now has an emit point. The four that
were missing all sat on paths owned by earlier tasks:

- AppointmentCompleted fires from both status-change routes, after the row is
  saved. A rejected transition or a version conflict leaves no event; otherwise
  the completed count runs ahead of the appointments themselves.
- AppointmentRescheduled is a third event, not a replacement. A rebook is a
  confirm plus a cancel, and a consumer that only hears the cancel messages a
  patient who still has an appointment.
- ResourceBlocked / ResourceReleased are a pair. Capacity coming back has to be
  as audible as capacity going away, or the resource reads as permanently taken.

Publishing is now on the scheduler rather than an unregistered command: the
logic moved out of PublishDomainEventsCommand into OutboxPublisher so the
recurring message and the manual command share it, and the existing
worker-scheduler container consumes it. The scheduler message carries no data
on purpose — what to publish is read from the table, so an event recorded
between two ticks is not skipped. DomainEventMessage routes to async, since a
slow consumer was otherwise slowing the drain itself and its failure marked a
row failed that had in fact been delivered.

Panel work that these paths made reachable:

- Cancelling from the appointment page now goes through the policy-aware
  endpoint and shows the penalty preview before the confirm, so the operator
  does not discover the patient's penalty after the fact. The cancellation
  service writes the timeline entry itself and accepts a reason, which that
  path previously dropped on the floor.
- Rescheduling reuses the booking page under ?rebook=<uuid> — the search and
  hold steps are identical and only the final step differs. The doctor picker
  is hidden there: a reschedule is not an invitation to change doctors.
- A new GET /appointment/{uuid}/segments exposes the recorded plan. An empty
  list is not an error, it means the appointment is slot-based, and that is
  exactly what gates the resource-mode reschedule button.

AppointmentInvoiceCard no longer crashes the whole detail page when an older
invoice has no discount breakdown.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-07-31 21:27:55 +03:30

153 lines
5.5 KiB
TypeScript

import { useMutation, useQuery } from '@tanstack/react-query';
import { toast } from 'sonner';
import { api, ApiError, type ApiResponse } from '../lib/api';
/**
* جستجوی وقت، رزرو موقت و ثبت نهایی در حالت منبع‌محور.
*
* سه عمل جدا هستند و باید جدا بمانند: بین «دیدن وقت» و «گرفتنش» صندلی هنوز آزاد است،
* و بین «گرفتن» و «ثبت» یک مهلت وجود دارد که اگر نگذرد، ظرفیت برای همیشه قفل می‌ماند.
*/
export interface ResourceRef {
uuid: string;
name: string;
}
export type SlotAssignment = Record<string, ResourceRef[]>;
export interface AvailableSlot {
start: number;
end: number;
assignment: SlotAssignment;
}
export interface PlanSegment {
sequence: number;
name: string;
offset_minutes: number;
duration_minutes: number;
patient_present: boolean;
requirements: { role: string; role_name: string; count: number }[];
}
export interface AvailabilityResult {
plan: { total_minutes: number; segments: PlanSegment[] };
slots: AvailableSlot[];
/** خالی بودن فهرست خطا نیست؛ این می‌گوید چرا خالی است. */
reason: string | null;
}
export interface HoldResult {
hold_uuid: string;
starts_at: number;
ends_at: number;
expires_at: number;
confirmed: boolean;
assignment: SlotAssignment;
}
export const REASON_LABELS: Record<string, string> = {
no_capacity_in_range: 'در این بازه هیچ ظرفیتی نیست — بازه را بزرگ‌تر کنید یا شعبهٔ دیگری را امتحان کنید.',
no_working_hours: 'شعبه در این بازه ساعت کاری ندارد.',
no_eligible_resource: 'هیچ منبعی شرایط بخش‌های این خدمت را ندارد.',
};
function fail(e: unknown, fallback: string) {
toast.error(e instanceof ApiError ? e.message : fallback);
}
export function useAvailabilitySearch(
params: { serviceUuid: string; branchUuid: string; from: number; to: number; stepMinutes?: number },
enabled: boolean,
) {
const query = useQuery({
queryKey: ['resource-availability', params],
queryFn: () =>
api.post<ApiResponse<AvailabilityResult>>('/api/v1/appointment-availability', {
service_uuid: params.serviceUuid,
branch_uuid: params.branchUuid,
from: params.from,
to: params.to,
...(params.stepMinutes ? { step_minutes: params.stepMinutes } : {}),
}),
enabled: enabled && !!params.serviceUuid && !!params.branchUuid,
retry: false,
});
return {
result: query.data?.data,
loading: query.isFetching,
error: query.error,
refetch: query.refetch,
};
}
export function useHold() {
const create = useMutation({
mutationFn: (body: {
service_uuid: string;
branch_uuid: string;
start: number;
assignment: Record<string, string[]>;
item_uuids?: string[];
patient_gender?: string;
}) => api.post<ApiResponse<HoldResult>>('/api/v1/appointment-hold', body),
// ۴۰۹ یعنی همین لحظه کس دیگری گرفت — پیام سرور دقیقاً همین را می‌گوید.
onError: (e) => fail(e, 'گرفتن این زمان ناموفق بود'),
});
const release = useMutation({
mutationFn: (uuid: string) => api.delete<ApiResponse<null>>(`/api/v1/appointment-hold/${uuid}`),
onSuccess: () => toast.success('رزرو موقت آزاد شد'),
onError: (e) => fail(e, 'آزادسازی ناموفق بود'),
});
const confirm = useMutation({
mutationFn: (body: { hold_uuid: string; doctor_uuid: string; patient_uuid?: string }) =>
api.post<ApiResponse<{ uuid: string }>>('/api/v1/appointment-confirm', body),
onSuccess: () => toast.success('نوبت ثبت شد'),
onError: (e) => fail(e, 'ثبت نهایی ناموفق بود'),
});
/**
* جابه‌جایی: رزرو موقتِ زمان تازه از قبل گرفته شده و اینجا فقط تأیید می‌شود.
*
* عمداً از `confirm` جداست — سرور در همین یک درخواست زمان قدیم را هم آزاد می‌کند، پس
* لغو دستی پیش از رزرو یعنی پنجره‌ای که در آن بیمار اصلاً نوبت ندارد.
*/
const rebook = useMutation({
mutationFn: ({ appointmentUuid, holdUuid }: { appointmentUuid: string; holdUuid: string }) =>
api.post<ApiResponse<{ appointment_uuid: string; starts_at: number }>>(
`/api/v1/appointment/${appointmentUuid}/rebook`,
{ hold_uuid: holdUuid },
),
onSuccess: () => toast.success('نوبت جابه‌جا شد'),
onError: (e) => fail(e, 'جابه‌جایی نوبت ناموفق بود'),
});
return { create, release, confirm, rebook };
}
export interface AppointmentSegmentRow {
sequence: number;
name: string;
starts_at: number;
ends_at: number;
duration_minutes: number;
patient_present: boolean;
}
/** فهرست خالی یعنی نوبت اسلاتی است، نه اینکه چیزی خراب باشد. */
export function useAppointmentSegments(uuid: string | undefined) {
const query = useQuery({
queryKey: ['appointment-segments', uuid],
queryFn: () =>
api.get<ApiResponse<AppointmentSegmentRow[]>>(`/api/v1/appointment/${uuid}/segments`),
enabled: !!uuid,
});
const rows = query.data?.data;
return { segments: Array.isArray(rows) ? rows : [], loading: query.isLoading };
}