feat(resource): calendar UI, holiday admin, backfill and interval algebra
Completes task 03. The resource calendar page edits weekly shifts, records leave and
maintenance, and previews two weeks of availability with a Persian reason for every
empty day — showing the raw server key ("outside_branch_hours") to a user would have
been a meaningless message. The preview is labelled raw on the page itself, because
booked appointments are not subtracted yet and mistaking it for bookable time leads
to overbooking.
The interval algebra moved to src/Shared/Time/TimeInterval.php with twelve unit
tests: tasks 05 and 06 need the same union/intersect/subtract, and a second
implementation is how two subtly different definitions of "overlap" get born. The
half-open [start, end) contract is what makes a shift ending at 13:00 and one
starting at 13:00 not overlap.
AvailabilityQueryCountTest locks the query count flat: one day and ninety days cost
exactly the same number of queries. Without it the first refactor can put a query
inside the day loop and a 90-day response quietly becomes hundreds of queries —
something only production would reveal.
app:resource:calendar:backfill derives shifts from existing WeeklySchedule sessions,
so the resources created in task 02 are not left with empty calendars. It skips any
resource a user has already configured, which is also what makes it idempotent. The
weekly schedule itself is untouched: this is a copy, not a migration.
Also added --replace to the holiday import. upsert keys on the date, so a row written
with a *wrong* date can never correct itself — re-running just creates the right row
beside the wrong one. That is exactly what happened after fixing the Jalali
conversion bug, and it was caught while capturing real responses for the docs.
Deferred with reasons recorded in the checklist: seasonal shift validity (two
nullable columns can be added later without backfill, so "needed from day one" does
not hold), and a Jalali date picker in the exception form.
1154 tests / 3229 assertions. phpstan at its 14-error baseline, none in touched
files. tsc clean, vitest 622 tests.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
hamed
@@ -81,6 +81,8 @@ import ResourcesPage from './pages/ResourcesPage';
|
||||
import ResourceTypesPage from './pages/ResourceTypesPage';
|
||||
import SkillsPage from './pages/SkillsPage';
|
||||
import ResourcePoolsPage from './pages/ResourcePoolsPage';
|
||||
import ResourceCalendarPage from './pages/ResourceCalendarPage';
|
||||
import HolidaysSettingsPage from './pages/HolidaysSettingsPage';
|
||||
import PatientRecordFormPage from './pages/PatientRecordFormPage';
|
||||
import PatientDetailPage from './pages/PatientDetailPage';
|
||||
import PaymentSuccessPage from './pages/PaymentSuccessPage';
|
||||
@@ -289,6 +291,8 @@ export default function App() {
|
||||
<Route path="resources/types" element={<RoleRoute roles={['doctor', 'clinic', 'secretary']} blockClinicScope permission={['appointment_settings', 'view']}><ResourceTypesPage /></RoleRoute>} />
|
||||
<Route path="resources/skills" element={<RoleRoute roles={['doctor', 'clinic', 'secretary']} blockClinicScope permission={['appointment_settings', 'view']}><SkillsPage /></RoleRoute>} />
|
||||
<Route path="resources/pools" element={<RoleRoute roles={['doctor', 'clinic', 'secretary']} blockClinicScope permission={['appointment_settings', 'view']}><ResourcePoolsPage /></RoleRoute>} />
|
||||
<Route path="resources/:resourceUuid/calendar" element={<RoleRoute roles={['doctor', 'clinic', 'secretary']} blockClinicScope permission={['appointment_settings', 'view']}><ResourceCalendarPage /></RoleRoute>} />
|
||||
<Route path="holidays" element={<RoleRoute roles={['doctor', 'clinic', 'secretary']} blockClinicScope permission={['appointment_settings', 'view']}><HolidaysSettingsPage /></RoleRoute>} />
|
||||
<Route path="sms-wallet" element={<RoleRoute roles={['doctor', 'clinic', 'secretary']} blockClinicScope permission={['sms', 'view']}><SmsWalletPage /></RoleRoute>} />
|
||||
<Route path="my-secretaries" element={<RoleRoute roles={['doctor', 'clinic']} blockClinicScope><MySecretariesPage /></RoleRoute>} />
|
||||
<Route path="admin-subscription" element={<RoleRoute roles={['admin']}><AdminSubscriptionPage /></RoleRoute>} />
|
||||
|
||||
@@ -31,6 +31,7 @@ export const SETTINGS_MENU: SettingsMenuItem[] = [
|
||||
{ key: 'clinic-doctors', label: 'پزشکان کلینیک', icon: BuildingOffice2Icon, to: '/admin/settings/clinic-doctors', roles: ['clinic'], perm: ['clinic_doctors', 'view'] },
|
||||
{ key: 'branches', label: 'شعبهها و اتاقها', icon: MapPinIcon, to: '/admin/branches', roles: ['doctor', 'clinic'], perm: ['appointment_settings', 'view'] },
|
||||
{ key: 'resources', label: 'منابع', icon: CubeIcon, to: '/admin/resources', roles: ['doctor', 'clinic'], perm: ['appointment_settings', 'view'] },
|
||||
{ key: 'holidays', label: 'تعطیلات رسمی', icon: CalendarDaysIcon, to: '/admin/holidays', roles: ['doctor', 'clinic'], perm: ['appointment_settings', 'view'] },
|
||||
{ key: 'payment', label: 'مدیریت پرداخت', icon: BanknotesIcon, to: '/admin/my-financial', perm: ['payments', 'view'] },
|
||||
{ key: 'secretary', label: 'مدیریت منشی', icon: UsersIcon, to: '/admin/my-secretaries' },
|
||||
{ key: 'staff', label: 'پرسنل', icon: UserPlusIcon, to: '/admin/staff', perm: ['staff', 'view'] },
|
||||
|
||||
@@ -0,0 +1,112 @@
|
||||
import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
|
||||
import { toast } from 'sonner';
|
||||
import { api, ApiError, type ApiResponse } from '../lib/api';
|
||||
import type {
|
||||
HolidayOverride, NationalHoliday, ResourceAvailability,
|
||||
ResourceCalendarDays, ResourceException, WorkingHoursPayload,
|
||||
} from '../types';
|
||||
|
||||
function fail(e: unknown, fallback: string) {
|
||||
toast.error(e instanceof ApiError ? e.message : fallback);
|
||||
}
|
||||
|
||||
export function useResourceCalendar(resourceUuid: string | undefined) {
|
||||
const qc = useQueryClient();
|
||||
const key = ['resource-calendar', resourceUuid];
|
||||
|
||||
const query = useQuery({
|
||||
queryKey: key,
|
||||
queryFn: () => api.get<ApiResponse<ResourceCalendarDays>>(`/api/v1/resource/${resourceUuid}/calendar`),
|
||||
enabled: !!resourceUuid,
|
||||
});
|
||||
|
||||
/** PUT جایگزینی کامل است: روزی که نفرستید خالی میشود. */
|
||||
const save = useMutation({
|
||||
mutationFn: (days: WorkingHoursPayload) =>
|
||||
api.put<ApiResponse<ResourceCalendarDays>>(`/api/v1/resource/${resourceUuid}/calendar`, { days }),
|
||||
onSuccess: () => {
|
||||
toast.success('شیفتها ذخیره شد');
|
||||
qc.invalidateQueries({ queryKey: key });
|
||||
qc.invalidateQueries({ queryKey: ['resource-availability', resourceUuid] });
|
||||
},
|
||||
onError: (e) => fail(e, 'ذخیرهٔ شیفتها ناموفق بود'),
|
||||
});
|
||||
|
||||
return { calendar: query.data?.data, loading: query.isLoading, save };
|
||||
}
|
||||
|
||||
export function useResourceExceptions(resourceUuid: string | undefined) {
|
||||
const qc = useQueryClient();
|
||||
const key = ['resource-exceptions', resourceUuid];
|
||||
|
||||
const invalidate = () => {
|
||||
qc.invalidateQueries({ queryKey: key });
|
||||
qc.invalidateQueries({ queryKey: ['resource-availability', resourceUuid] });
|
||||
};
|
||||
|
||||
const query = useQuery({
|
||||
queryKey: key,
|
||||
queryFn: () => api.get<ApiResponse<ResourceException[]>>(`/api/v1/resource/${resourceUuid}/exceptions`),
|
||||
enabled: !!resourceUuid,
|
||||
});
|
||||
|
||||
const create = useMutation({
|
||||
mutationFn: (d: { type: string; starts_at: number; ends_at: number; reason?: string | null }) =>
|
||||
api.post<ApiResponse<ResourceException>>(`/api/v1/resource/${resourceUuid}/exception`, d),
|
||||
onSuccess: () => { toast.success('استثنا ثبت شد'); invalidate(); },
|
||||
onError: (e) => fail(e, 'ثبت استثنا ناموفق بود'),
|
||||
});
|
||||
|
||||
const remove = useMutation({
|
||||
mutationFn: (uuid: string) => api.delete<ApiResponse<null>>(`/api/v1/resource-exception/${uuid}`),
|
||||
onSuccess: () => { toast.success('استثنا حذف شد'); invalidate(); },
|
||||
onError: (e) => fail(e, 'حذف استثنا ناموفق بود'),
|
||||
});
|
||||
|
||||
return { exceptions: query.data?.data ?? [], loading: query.isLoading, create, remove };
|
||||
}
|
||||
|
||||
export function useResourceAvailability(resourceUuid: string | undefined, from: number, to: number) {
|
||||
const query = useQuery({
|
||||
queryKey: ['resource-availability', resourceUuid, from, to],
|
||||
queryFn: () =>
|
||||
api.get<ApiResponse<ResourceAvailability>>(`/api/v1/resource/${resourceUuid}/availability?from=${from}&to=${to}`),
|
||||
enabled: !!resourceUuid,
|
||||
});
|
||||
|
||||
return { availability: query.data?.data, loading: query.isLoading };
|
||||
}
|
||||
|
||||
export function useHolidays(year: number) {
|
||||
const qc = useQueryClient();
|
||||
const key = ['national-holidays', year];
|
||||
|
||||
const query = useQuery({
|
||||
queryKey: key,
|
||||
queryFn: () =>
|
||||
api.get<ApiResponse<{ year: number; holidays: NationalHoliday[]; overrides: HolidayOverride[] }>>(
|
||||
`/api/v1/national-holidays?year=${year}`,
|
||||
),
|
||||
});
|
||||
|
||||
const setOverride = useMutation({
|
||||
mutationFn: (d: { date: number; is_working: boolean; note?: string | null }) =>
|
||||
api.post<ApiResponse<HolidayOverride>>('/api/v1/holiday-overrides', d),
|
||||
onSuccess: () => { toast.success('استثنای تعطیلی ذخیره شد'); qc.invalidateQueries({ queryKey: key }); },
|
||||
onError: (e) => fail(e, 'ذخیرهٔ استثنا ناموفق بود'),
|
||||
});
|
||||
|
||||
const removeOverride = useMutation({
|
||||
mutationFn: (uuid: string) => api.delete<ApiResponse<null>>(`/api/v1/holiday-override/${uuid}`),
|
||||
onSuccess: () => { toast.success('استثنا حذف شد'); qc.invalidateQueries({ queryKey: key }); },
|
||||
onError: (e) => fail(e, 'حذف استثنا ناموفق بود'),
|
||||
});
|
||||
|
||||
return {
|
||||
holidays: query.data?.data?.holidays ?? [],
|
||||
overrides: query.data?.data?.overrides ?? [],
|
||||
loading: query.isLoading,
|
||||
setOverride,
|
||||
removeOverride,
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,188 @@
|
||||
import React from 'react';
|
||||
import PageHeader from '../components/ui/PageHeader';
|
||||
import DataTable, { type Column } from '../components/ui/DataTable';
|
||||
import SearchableSelect from '../components/ui/SearchableSelect';
|
||||
import { useUrlState } from '../hooks/useUrlState';
|
||||
import { usePermissions } from '../hooks/usePermissions';
|
||||
import { useHolidays } from '../hooks/useResourceCalendar';
|
||||
import { formatDate } from '../lib/utils';
|
||||
import type { NationalHoliday } from '../types';
|
||||
|
||||
/** سالِ شمسی جاری از همان فرمتکنندهٔ شمسیِ مرورگر گرفته میشود، نه با محاسبهٔ دستی. */
|
||||
function currentJalaliYear(): number {
|
||||
const formatted = new Intl.DateTimeFormat('en-u-ca-persian', { year: 'numeric' }).format(new Date());
|
||||
return Number(formatted.replace(/\D/g, '')) || 1405;
|
||||
}
|
||||
|
||||
/**
|
||||
* تعطیلات رسمی و استثناهای این محیط.
|
||||
*
|
||||
* خودِ تعطیلات کشوریاند و اینجا فقط دیده میشوند؛ آنچه محیط تغییر میدهد «باز بودن
|
||||
* یا نبودنِ» همان روز برای خودش است.
|
||||
*/
|
||||
export default function HolidaysSettingsPage() {
|
||||
const thisYear = currentJalaliYear();
|
||||
const [urlState, setUrlState] = useUrlState({ year: String(thisYear) });
|
||||
const year = Number(urlState.year) || thisYear;
|
||||
|
||||
const { holidays, overrides, loading, setOverride, removeOverride } = useHolidays(year);
|
||||
const { can } = usePermissions();
|
||||
const canUpdate = can('appointment_settings', 'update');
|
||||
|
||||
const overrideByDate = new Map(overrides.map((o) => [o.date, o]));
|
||||
|
||||
const columns: Column<NationalHoliday>[] = [
|
||||
{ key: 'jalali_date', header: 'تاریخ', render: (h) => <span style={{ fontWeight: 600 }}>{h.jalali_date}</span> },
|
||||
{ key: 'title', header: 'مناسبت', render: (h) => <span style={{ fontSize: 13 }}>{h.title}</span> },
|
||||
{
|
||||
key: 'gregorian',
|
||||
header: 'میلادی',
|
||||
render: (h) => <span style={{ fontSize: 12, color: 'var(--text-3)' }}>{formatDate(h.date * 1000)}</span>,
|
||||
},
|
||||
{
|
||||
key: 'status',
|
||||
header: 'وضعیت این محیط',
|
||||
render: (h) =>
|
||||
overrideByDate.get(h.date)?.is_working ? (
|
||||
<span className="badge green"><span className="bdot" />باز است</span>
|
||||
) : (
|
||||
<span className="badge gray"><span className="bdot" />تعطیل</span>
|
||||
),
|
||||
},
|
||||
];
|
||||
|
||||
const years = Array.from({ length: 5 }, (_, i) => thisYear - 1 + i);
|
||||
|
||||
return (
|
||||
<div className="fade-in">
|
||||
<PageHeader
|
||||
title="تعطیلات رسمی"
|
||||
description="تعطیلات کشوری برای همهٔ محیطها اعمال میشود. اگر این محیط روزی را باز است، همینجا استثنا بزنید."
|
||||
backTo="/admin/settings-menu"
|
||||
/>
|
||||
|
||||
<DataTable
|
||||
columns={columns}
|
||||
data={holidays}
|
||||
loading={loading}
|
||||
emptyMessage={`برای سال ${year} تعطیلی ثبت نشده است`}
|
||||
headerExtra={
|
||||
<div style={{ minWidth: 160, marginRight: 'auto' }}>
|
||||
<SearchableSelect
|
||||
options={years.map((y) => ({ value: String(y), label: String(y) }))}
|
||||
value={String(year)}
|
||||
onChange={(v) => setUrlState({ year: v ? String(v) : String(thisYear) })}
|
||||
placeholder="سال"
|
||||
height={36}
|
||||
/>
|
||||
</div>
|
||||
}
|
||||
actions={
|
||||
canUpdate
|
||||
? (h) => {
|
||||
const override = overrideByDate.get(h.date);
|
||||
return (
|
||||
<div style={{ display: 'flex', gap: 6 }}>
|
||||
{override?.is_working ? (
|
||||
<button
|
||||
type="button"
|
||||
className="btn secondary sm"
|
||||
disabled={removeOverride.isPending}
|
||||
onClick={() => removeOverride.mutate(override.uuid)}
|
||||
>
|
||||
تعطیل کن
|
||||
</button>
|
||||
) : (
|
||||
<button
|
||||
type="button"
|
||||
className="btn secondary sm"
|
||||
disabled={setOverride.isPending}
|
||||
onClick={() => setOverride.mutate({ date: h.date, is_working: true })}
|
||||
>
|
||||
این روز بازیم
|
||||
</button>
|
||||
)}
|
||||
</div>
|
||||
);
|
||||
}
|
||||
: undefined
|
||||
}
|
||||
/>
|
||||
|
||||
<ClosureCard
|
||||
overrides={overrides.filter((o) => !o.is_working)}
|
||||
canUpdate={canUpdate}
|
||||
saving={setOverride.isPending}
|
||||
onAdd={(date, note) => setOverride.mutate({ date, is_working: false, note })}
|
||||
onRemove={(uuid) => removeOverride.mutate(uuid)}
|
||||
/>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* جهت دوم: روزی که تعطیل رسمی نیست ولی این محیط بسته است.
|
||||
* این با «استثنای منبع» فرق دارد — آن روی یک منبع است و این روی کل محیط.
|
||||
*/
|
||||
function ClosureCard({
|
||||
overrides, canUpdate, saving, onAdd, onRemove,
|
||||
}: {
|
||||
overrides: { uuid: string; date: number; note: string | null }[];
|
||||
canUpdate: boolean;
|
||||
saving: boolean;
|
||||
onAdd: (date: number, note: string | null) => void;
|
||||
onRemove: (uuid: string) => void;
|
||||
}) {
|
||||
const [date, setDate] = React.useState('');
|
||||
const [note, setNote] = React.useState('');
|
||||
|
||||
const timestamp = date === '' ? null : Math.floor(new Date(`${date}T00:00:00`).getTime() / 1000);
|
||||
|
||||
return (
|
||||
<div className="card" style={{ padding: 16, marginTop: 16 }}>
|
||||
<h2 className="section-title" style={{ margin: '0 0 4px' }}>تعطیلیهای این محیط</h2>
|
||||
<p style={{ fontSize: 12, color: 'var(--text-3)', margin: '0 0 12px' }}>
|
||||
روزهایی که تعطیل رسمی نیستند ولی این محیط بسته است. برای مرخصی یک نفر یا سرویس یک دستگاه،
|
||||
از تقویم همان منبع استفاده کنید.
|
||||
</p>
|
||||
|
||||
{overrides.length === 0 ? (
|
||||
<p style={{ fontSize: 13, color: 'var(--text-3)', margin: 0 }}>موردی ثبت نشده است.</p>
|
||||
) : (
|
||||
<div style={{ display: 'grid', gap: 8, marginBottom: 12 }}>
|
||||
{overrides.map((o) => (
|
||||
<div key={o.uuid} style={{ display: 'flex', alignItems: 'center', gap: 8, fontSize: 13 }}>
|
||||
<span style={{ flex: 1, color: 'var(--text-2)' }}>
|
||||
{formatDate(o.date * 1000)}{o.note ? ` · ${o.note}` : ''}
|
||||
</span>
|
||||
{canUpdate && (
|
||||
<button type="button" className="btn secondary sm" onClick={() => onRemove(o.uuid)} aria-label="حذف تعطیلی">
|
||||
✕
|
||||
</button>
|
||||
)}
|
||||
</div>
|
||||
))}
|
||||
</div>
|
||||
)}
|
||||
|
||||
{canUpdate && (
|
||||
<div style={{ display: 'flex', gap: 8, flexWrap: 'wrap' }}>
|
||||
<input type="date" className="field" value={date} onChange={(e) => setDate(e.target.value)} style={{ minWidth: 170 }} />
|
||||
<input className="field" value={note} onChange={(e) => setNote(e.target.value)} placeholder="توضیح (اختیاری)" style={{ flex: 1, minWidth: 180 }} />
|
||||
<button
|
||||
type="button"
|
||||
className="btn secondary"
|
||||
disabled={saving || timestamp === null}
|
||||
onClick={() => {
|
||||
onAdd(timestamp!, note.trim() === '' ? null : note.trim());
|
||||
setDate('');
|
||||
setNote('');
|
||||
}}
|
||||
>
|
||||
افزودن
|
||||
</button>
|
||||
</div>
|
||||
)}
|
||||
</div>
|
||||
);
|
||||
}
|
||||
@@ -0,0 +1,106 @@
|
||||
import { describe, it, expect, beforeEach, vi } from 'vitest';
|
||||
import { screen, waitFor } from '@testing-library/react';
|
||||
import { renderWithProviders } from '../test/utils';
|
||||
|
||||
vi.mock('../lib/api', () => ({
|
||||
api: { get: vi.fn(), post: vi.fn(), patch: vi.fn(), put: vi.fn(), delete: vi.fn() },
|
||||
ApiError: class extends Error {},
|
||||
}));
|
||||
vi.mock('sonner', () => ({ toast: { success: vi.fn(), error: vi.fn() } }));
|
||||
vi.mock('../hooks/usePermissions', () => ({ usePermissions: () => ({ can: () => true }) }));
|
||||
|
||||
import { Routes, Route } from 'react-router-dom';
|
||||
import { api } from '../lib/api';
|
||||
import ResourceCalendarPage from './ResourceCalendarPage';
|
||||
|
||||
const get = api.get as ReturnType<typeof vi.fn>;
|
||||
|
||||
const emptyDays = (): Record<string, unknown[]> =>
|
||||
Object.fromEntries(Array.from({ length: 7 }, (_, d) => [String(d), [] as unknown[]]));
|
||||
|
||||
function mockApi(days: Record<string, unknown[]>, availabilityDays: unknown[]) {
|
||||
get.mockImplementation((path: string) => {
|
||||
if (path.endsWith('/calendar')) {
|
||||
return Promise.resolve({
|
||||
success: true,
|
||||
data: { resource_uuid: 'r1', timezone: 'Asia/Tehran', defined: true, days },
|
||||
});
|
||||
}
|
||||
if (path.includes('/availability')) {
|
||||
return Promise.resolve({
|
||||
success: true,
|
||||
data: { resource_uuid: 'r1', timezone: 'Asia/Tehran', days: availabilityDays },
|
||||
});
|
||||
}
|
||||
if (path.endsWith('/exceptions')) return Promise.resolve({ success: true, data: [] });
|
||||
if (path.startsWith('/api/v1/resources')) return Promise.resolve({ success: true, data: [] });
|
||||
return Promise.resolve({ success: true, data: [] });
|
||||
});
|
||||
}
|
||||
|
||||
function renderPage() {
|
||||
return renderWithProviders(
|
||||
<Routes>
|
||||
<Route path="/admin/resources/:resourceUuid/calendar" element={<ResourceCalendarPage />} />
|
||||
</Routes>,
|
||||
{ route: '/admin/resources/r1/calendar' },
|
||||
);
|
||||
}
|
||||
|
||||
describe('ResourceCalendarPage', () => {
|
||||
beforeEach(() => vi.clearAllMocks());
|
||||
|
||||
it('renders seven days and marks shiftless ones', async () => {
|
||||
mockApi(emptyDays(), []);
|
||||
renderPage();
|
||||
|
||||
await waitFor(() => expect(screen.getByText('شنبه')).toBeInTheDocument());
|
||||
expect(screen.getByText('جمعه')).toBeInTheDocument();
|
||||
expect(screen.getAllByText('بدون شیفت')).toHaveLength(7);
|
||||
});
|
||||
|
||||
it('shows stored shifts as times', async () => {
|
||||
const days = emptyDays();
|
||||
days['0'] = [{ sequence: 0, start_minute: 540, end_minute: 1020, start_time: '09:00', end_time: '17:00', active: true }];
|
||||
mockApi(days, []);
|
||||
renderPage();
|
||||
|
||||
await waitFor(() => expect(screen.getByDisplayValue('09:00')).toBeInTheDocument());
|
||||
expect(screen.getByDisplayValue('17:00')).toBeInTheDocument();
|
||||
});
|
||||
|
||||
/**
|
||||
* دلیلِ خالی بودن روز باید فارسی نشان داده شود؛ نشان دادن کلید خام سرور
|
||||
* («outside_branch_hours») به کاربر یعنی پیام بیمعنا.
|
||||
*/
|
||||
it('translates every empty-day reason into Persian', async () => {
|
||||
mockApi(emptyDays(), [
|
||||
{ date: 1785529800, day_of_week: 0, intervals: [], total_minutes: 0, reasons: ['national_holiday'] },
|
||||
{ date: 1785616200, day_of_week: 1, intervals: [], total_minutes: 0, reasons: ['outside_branch_hours'] },
|
||||
{ date: 1785702600, day_of_week: 2, intervals: [], total_minutes: 0, reasons: ['exception'] },
|
||||
]);
|
||||
renderPage();
|
||||
|
||||
await waitFor(() => expect(screen.getByText('تعطیل رسمی')).toBeInTheDocument());
|
||||
expect(screen.getByText('شیفت بیرون از ساعت کاری شعبه')).toBeInTheDocument();
|
||||
expect(screen.getByText('مرخصی یا سرویس')).toBeInTheDocument();
|
||||
expect(screen.queryByText('outside_branch_hours')).not.toBeInTheDocument();
|
||||
});
|
||||
|
||||
it('shows free minutes for a day that has availability', async () => {
|
||||
mockApi(emptyDays(), [
|
||||
{ date: 1785529800, day_of_week: 0, intervals: [{ start: 1, end: 2 }], total_minutes: 480, reasons: [] },
|
||||
]);
|
||||
renderPage();
|
||||
|
||||
await waitFor(() => expect(screen.getByText('480 دقیقه')).toBeInTheDocument());
|
||||
});
|
||||
|
||||
/** پیشنمایش نباید «وقت قابل رزرو» خوانده شود — نوبتها هنوز کسر نشدهاند. */
|
||||
it('warns that the preview is raw availability', async () => {
|
||||
mockApi(emptyDays(), []);
|
||||
renderPage();
|
||||
|
||||
await waitFor(() => expect(screen.getByText(/نوبتهای ثبتشده هنوز از آن کسر نشدهاند/)).toBeInTheDocument());
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,376 @@
|
||||
import React, { useEffect, useMemo, useState } from 'react';
|
||||
import { useParams } from 'react-router-dom';
|
||||
import { PlusIcon, TrashIcon } from '@heroicons/react/24/outline';
|
||||
import PageHeader from '../components/ui/PageHeader';
|
||||
import ConfirmDialog from '../components/ui/ConfirmDialog';
|
||||
import SearchableSelect from '../components/ui/SearchableSelect';
|
||||
import { usePermissions } from '../hooks/usePermissions';
|
||||
import { useResources } from '../hooks/useResources';
|
||||
import {
|
||||
useResourceAvailability, useResourceCalendar, useResourceExceptions,
|
||||
} from '../hooks/useResourceCalendar';
|
||||
import { formatDate } from '../lib/utils';
|
||||
import type { ResourceException } from '../types';
|
||||
|
||||
/** ۰ = شنبه — همان قرارداد بکاند و ساعت کاری شعبه. */
|
||||
const DAY_LABELS = ['شنبه', 'یکشنبه', 'دوشنبه', 'سهشنبه', 'چهارشنبه', 'پنجشنبه', 'جمعه'];
|
||||
|
||||
const MINUTES_IN_DAY = 1440;
|
||||
|
||||
/** چرا یک روز خالی است — بدون ترجمه، پاسخ خام سرور به کاربر نشان داده میشد. */
|
||||
const REASON_LABELS: Record<string, string> = {
|
||||
national_holiday: 'تعطیل رسمی',
|
||||
tenant_holiday: 'تعطیلی این محیط',
|
||||
no_shift: 'شیفتی تعریف نشده',
|
||||
branch_closed: 'شعبه این روز بسته است',
|
||||
outside_branch_hours: 'شیفت بیرون از ساعت کاری شعبه',
|
||||
exception: 'مرخصی یا سرویس',
|
||||
resource_inactive: 'منبع غیرفعال است',
|
||||
branch_inactive: 'شعبه غیرفعال است',
|
||||
};
|
||||
|
||||
const EXCEPTION_TYPES = [
|
||||
{ value: 'leave', label: 'مرخصی' },
|
||||
{ value: 'absence', label: 'غیبت' },
|
||||
{ value: 'maintenance', label: 'سرویس دورهای' },
|
||||
{ value: 'closure', label: 'تعطیلی موردی' },
|
||||
];
|
||||
|
||||
type Draft = { start: string; end: string; endOfDay: boolean };
|
||||
|
||||
function toTime(minute: number): string {
|
||||
return `${String(Math.floor(minute / 60)).padStart(2, '0')}:${String(minute % 60).padStart(2, '0')}`;
|
||||
}
|
||||
|
||||
function toMinutes(time: string): number | null {
|
||||
const m = /^(\d{1,2}):(\d{2})$/.exec(time.trim());
|
||||
if (!m) return null;
|
||||
const minutes = Number(m[1]) * 60 + Number(m[2]);
|
||||
return minutes >= 0 && minutes <= MINUTES_IN_DAY ? minutes : null;
|
||||
}
|
||||
|
||||
/** نیمهشبِ امروز بهصورت timestamp ثانیهای. */
|
||||
function todayMidnight(): number {
|
||||
const d = new Date();
|
||||
d.setHours(0, 0, 0, 0);
|
||||
return Math.floor(d.getTime() / 1000);
|
||||
}
|
||||
|
||||
/**
|
||||
* تقویم یک منبع: شیفت هفتگی، استثناها، و پیشنمایش ساعت آزاد.
|
||||
*
|
||||
* پیشنمایش عمداً «ساعت آزاد» نامیده نشده بلکه «خام» است: نوبتهای ثبتشده در آن
|
||||
* کسر نشدهاند و اشتباه گرفتنش با «وقت قابل رزرو» به بیشرزروی میانجامد.
|
||||
*/
|
||||
export default function ResourceCalendarPage() {
|
||||
const { resourceUuid } = useParams<{ resourceUuid: string }>();
|
||||
const { calendar, loading, save } = useResourceCalendar(resourceUuid);
|
||||
const { exceptions, create, remove } = useResourceExceptions(resourceUuid);
|
||||
const { resources } = useResources();
|
||||
const { can } = usePermissions();
|
||||
const canUpdate = can('appointment_settings', 'update');
|
||||
|
||||
const resource = resources.find((r) => r.uuid === resourceUuid);
|
||||
|
||||
const [draft, setDraft] = useState<Record<number, Draft[]>>({});
|
||||
const [error, setError] = useState<string | null>(null);
|
||||
const [toDelete, setToDelete] = useState<ResourceException | null>(null);
|
||||
|
||||
const previewFrom = todayMidnight();
|
||||
const previewTo = previewFrom + 13 * 86400;
|
||||
const { availability } = useResourceAvailability(resourceUuid, previewFrom, previewTo);
|
||||
|
||||
useEffect(() => {
|
||||
if (!calendar) return;
|
||||
const next: Record<number, Draft[]> = {};
|
||||
DAY_LABELS.forEach((_, day) => {
|
||||
next[day] = (calendar.days[String(day)] ?? []).map((r) => ({
|
||||
start: toTime(r.start_minute),
|
||||
end: r.end_minute === MINUTES_IN_DAY ? '23:59' : toTime(r.end_minute),
|
||||
endOfDay: r.end_minute === MINUTES_IN_DAY,
|
||||
}));
|
||||
});
|
||||
setDraft(next);
|
||||
}, [calendar]);
|
||||
|
||||
const totalShifts = useMemo(
|
||||
() => Object.values(draft).reduce((sum, rows) => sum + rows.length, 0),
|
||||
[draft],
|
||||
);
|
||||
|
||||
const editRange = (day: number, index: number, patch: Partial<Draft>) =>
|
||||
setDraft((d) => ({ ...d, [day]: (d[day] ?? []).map((r, i) => (i === index ? { ...r, ...patch } : r)) }));
|
||||
|
||||
const submit = () => {
|
||||
const days: Record<string, { start_minute: number; end_minute: number }[]> = {};
|
||||
|
||||
for (const [dayKey, rows] of Object.entries(draft)) {
|
||||
const parsed: { start_minute: number; end_minute: number }[] = [];
|
||||
|
||||
for (const row of rows) {
|
||||
const start = toMinutes(row.start);
|
||||
const end = row.endOfDay ? MINUTES_IN_DAY : toMinutes(row.end);
|
||||
|
||||
if (start === null || end === null) {
|
||||
setError(`ساعت روز ${DAY_LABELS[Number(dayKey)]} را به شکل ۰۹:۰۰ وارد کنید`);
|
||||
return;
|
||||
}
|
||||
if (end <= start) {
|
||||
setError(`در روز ${DAY_LABELS[Number(dayKey)]} پایان شیفت باید بعد از شروع آن باشد`);
|
||||
return;
|
||||
}
|
||||
parsed.push({ start_minute: start, end_minute: end });
|
||||
}
|
||||
|
||||
days[dayKey] = parsed;
|
||||
}
|
||||
|
||||
setError(null);
|
||||
save.mutate(days);
|
||||
};
|
||||
|
||||
return (
|
||||
<div className="fade-in">
|
||||
<PageHeader
|
||||
title={`تقویم ${resource?.name ?? 'منبع'}`}
|
||||
description="شیفت هفتگی منبع. ساعت واقعی از تقاطع این شیفتها با ساعت کاری شعبه بهدست میآید و تعطیلات و مرخصی از آن کسر میشود."
|
||||
backTo="/admin/resources"
|
||||
breadcrumbs={[{ label: 'منابع', to: '/admin/resources' }, { label: 'تقویم' }]}
|
||||
action={
|
||||
canUpdate ? (
|
||||
<button type="button" className="btn primary" disabled={save.isPending} onClick={submit}>
|
||||
{save.isPending ? 'در حال ذخیره...' : 'ذخیرهٔ شیفتها'}
|
||||
</button>
|
||||
) : undefined
|
||||
}
|
||||
/>
|
||||
|
||||
{error && (
|
||||
<div
|
||||
className="card"
|
||||
style={{ padding: '12px 16px', marginBottom: 16, color: 'var(--danger)', background: 'var(--danger-bg)', fontSize: 13 }}
|
||||
>
|
||||
{error}
|
||||
</div>
|
||||
)}
|
||||
|
||||
<div style={{ display: 'grid', gap: 16, gridTemplateColumns: 'repeat(auto-fit, minmax(320px, 1fr))' }}>
|
||||
<section style={{ display: 'grid', gap: 12 }}>
|
||||
<h2 className="section-title" style={{ margin: 0 }}>
|
||||
شیفت هفتگی {totalShifts > 0 && <span style={{ fontSize: 12, color: 'var(--text-3)' }}>({totalShifts} شیفت)</span>}
|
||||
</h2>
|
||||
|
||||
{loading ? (
|
||||
<div style={{ padding: 16, color: 'var(--text-3)', fontSize: 13 }}>در حال بارگذاری...</div>
|
||||
) : (
|
||||
DAY_LABELS.map((label, day) => {
|
||||
const rows = draft[day] ?? [];
|
||||
return (
|
||||
<div key={day} className="card" style={{ padding: 14 }}>
|
||||
<div style={{ display: 'flex', alignItems: 'center', justifyContent: 'space-between', gap: 10, marginBottom: rows.length ? 10 : 0 }}>
|
||||
<div style={{ display: 'flex', alignItems: 'center', gap: 8 }}>
|
||||
<span style={{ fontWeight: 700, fontSize: 14 }}>{label}</span>
|
||||
{rows.length === 0 && <span style={{ fontSize: 12, color: 'var(--text-3)' }}>بدون شیفت</span>}
|
||||
</div>
|
||||
{canUpdate && (
|
||||
<button
|
||||
type="button"
|
||||
className="btn secondary sm"
|
||||
onClick={() => setDraft((d) => ({ ...d, [day]: [...(d[day] ?? []), { start: '09:00', end: '17:00', endOfDay: false }] }))}
|
||||
>
|
||||
<PlusIcon style={{ width: 15 }} /> شیفت
|
||||
</button>
|
||||
)}
|
||||
</div>
|
||||
|
||||
<div style={{ display: 'grid', gap: 8 }}>
|
||||
{rows.map((row, index) => (
|
||||
<div key={index} style={{ display: 'flex', alignItems: 'center', gap: 8, flexWrap: 'wrap' }}>
|
||||
<input
|
||||
type="time"
|
||||
className="field"
|
||||
value={row.start}
|
||||
disabled={!canUpdate}
|
||||
onChange={(e) => editRange(day, index, { start: e.target.value })}
|
||||
style={{ width: 116 }}
|
||||
/>
|
||||
<span style={{ fontSize: 12, color: 'var(--text-3)' }}>تا</span>
|
||||
{row.endOfDay ? (
|
||||
<span className="field" style={{ width: 116, color: 'var(--text-2)' }}>۲۴:۰۰</span>
|
||||
) : (
|
||||
<input
|
||||
type="time"
|
||||
className="field"
|
||||
value={row.end}
|
||||
disabled={!canUpdate}
|
||||
onChange={(e) => editRange(day, index, { end: e.target.value })}
|
||||
style={{ width: 116 }}
|
||||
/>
|
||||
)}
|
||||
<label style={{ display: 'flex', alignItems: 'center', gap: 5, fontSize: 12, color: 'var(--text-3)' }}>
|
||||
<input
|
||||
type="checkbox"
|
||||
checked={row.endOfDay}
|
||||
disabled={!canUpdate}
|
||||
onChange={(e) => editRange(day, index, { endOfDay: e.target.checked })}
|
||||
/>
|
||||
تا پایان روز
|
||||
</label>
|
||||
{canUpdate && (
|
||||
<button
|
||||
type="button"
|
||||
className="btn secondary sm"
|
||||
onClick={() => setDraft((d) => ({ ...d, [day]: (d[day] ?? []).filter((_, i) => i !== index) }))}
|
||||
aria-label="حذف شیفت"
|
||||
>
|
||||
<TrashIcon style={{ width: 15 }} />
|
||||
</button>
|
||||
)}
|
||||
</div>
|
||||
))}
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
})
|
||||
)}
|
||||
</section>
|
||||
|
||||
<section style={{ display: 'grid', gap: 12, alignContent: 'start' }}>
|
||||
<ExceptionsCard
|
||||
exceptions={exceptions}
|
||||
canUpdate={canUpdate}
|
||||
saving={create.isPending}
|
||||
onCreate={(payload) => create.mutate(payload)}
|
||||
onDelete={setToDelete}
|
||||
/>
|
||||
|
||||
<div className="card" style={{ padding: 14 }}>
|
||||
<h2 className="section-title" style={{ margin: '0 0 4px' }}>پیشنمایش دو هفته</h2>
|
||||
<p style={{ fontSize: 12, color: 'var(--text-3)', margin: '0 0 10px' }}>
|
||||
ساعت <strong>خام</strong> — نوبتهای ثبتشده هنوز از آن کسر نشدهاند.
|
||||
</p>
|
||||
|
||||
<div style={{ display: 'grid', gap: 6 }}>
|
||||
{(availability?.days ?? []).map((day) => (
|
||||
<div
|
||||
key={day.date}
|
||||
style={{ display: 'flex', alignItems: 'center', justifyContent: 'space-between', gap: 8, fontSize: 13 }}
|
||||
>
|
||||
<span style={{ color: 'var(--text-2)' }}>
|
||||
{DAY_LABELS[day.day_of_week]} · {formatDate(day.date * 1000)}
|
||||
</span>
|
||||
{day.intervals.length === 0 ? (
|
||||
<span style={{ fontSize: 12, color: 'var(--text-3)' }}>
|
||||
{day.reasons.map((r) => REASON_LABELS[r] ?? r).join('، ') || '—'}
|
||||
</span>
|
||||
) : (
|
||||
<span style={{ fontWeight: 600 }}>{day.total_minutes} دقیقه</span>
|
||||
)}
|
||||
</div>
|
||||
))}
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
</div>
|
||||
|
||||
<ConfirmDialog
|
||||
open={!!toDelete}
|
||||
title="حذف استثنا"
|
||||
message={`آیا از حذف «${toDelete?.type_label}» مطمئن هستید؟`}
|
||||
confirmLabel="حذف"
|
||||
loading={remove.isPending}
|
||||
onConfirm={() => toDelete && remove.mutate(toDelete.uuid, { onSuccess: () => setToDelete(null) })}
|
||||
onCancel={() => setToDelete(null)}
|
||||
/>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function ExceptionsCard({
|
||||
exceptions, canUpdate, saving, onCreate, onDelete,
|
||||
}: {
|
||||
exceptions: ResourceException[];
|
||||
canUpdate: boolean;
|
||||
saving: boolean;
|
||||
onCreate: (payload: { type: string; starts_at: number; ends_at: number; reason?: string | null }) => void;
|
||||
onDelete: (e: ResourceException) => void;
|
||||
}) {
|
||||
const [type, setType] = useState<string>('leave');
|
||||
const [startDate, setStartDate] = useState('');
|
||||
const [endDate, setEndDate] = useState('');
|
||||
const [reason, setReason] = useState('');
|
||||
|
||||
const toTimestamp = (value: string): number | null => {
|
||||
if (value === '') return null;
|
||||
const ms = new Date(`${value}T00:00:00`).getTime();
|
||||
return Number.isNaN(ms) ? null : Math.floor(ms / 1000);
|
||||
};
|
||||
|
||||
const start = toTimestamp(startDate);
|
||||
const end = toTimestamp(endDate);
|
||||
// پایان روزِ انتخابشده، نه آغازش: مرخصیِ «تا سهشنبه» شامل خودِ سهشنبه است.
|
||||
const endExclusive = end === null ? null : end + 86400;
|
||||
const invalid = start === null || endExclusive === null || endExclusive <= start;
|
||||
|
||||
return (
|
||||
<div className="card" style={{ padding: 14 }}>
|
||||
<h2 className="section-title" style={{ margin: '0 0 10px' }}>مرخصی و سرویس</h2>
|
||||
|
||||
{exceptions.length === 0 ? (
|
||||
<p style={{ fontSize: 13, color: 'var(--text-3)', margin: '0 0 10px' }}>استثنایی ثبت نشده است.</p>
|
||||
) : (
|
||||
<div style={{ display: 'grid', gap: 8, marginBottom: 12 }}>
|
||||
{exceptions.map((e) => (
|
||||
<div key={e.uuid} style={{ display: 'flex', alignItems: 'center', gap: 8, fontSize: 13 }}>
|
||||
<span className="badge amber" style={{ fontSize: 11 }}>{e.type_label}</span>
|
||||
<span style={{ flex: 1, color: 'var(--text-2)' }}>
|
||||
{formatDate(e.starts_at * 1000)} تا {formatDate(e.ends_at * 1000)}
|
||||
{e.reason ? ` · ${e.reason}` : ''}
|
||||
</span>
|
||||
{canUpdate && (
|
||||
<button type="button" className="btn secondary sm" onClick={() => onDelete(e)} aria-label="حذف استثنا">
|
||||
✕
|
||||
</button>
|
||||
)}
|
||||
</div>
|
||||
))}
|
||||
</div>
|
||||
)}
|
||||
|
||||
{canUpdate && (
|
||||
<div style={{ display: 'grid', gap: 8 }}>
|
||||
<SearchableSelect
|
||||
options={EXCEPTION_TYPES}
|
||||
value={type}
|
||||
onChange={(v) => setType(v ? String(v) : 'leave')}
|
||||
placeholder="نوع استثنا"
|
||||
height={36}
|
||||
/>
|
||||
<div style={{ display: 'flex', gap: 8 }}>
|
||||
<input type="date" className="field" value={startDate} onChange={(e) => setStartDate(e.target.value)} style={{ flex: 1 }} />
|
||||
<input type="date" className="field" value={endDate} onChange={(e) => setEndDate(e.target.value)} style={{ flex: 1 }} />
|
||||
</div>
|
||||
<input className="field" value={reason} onChange={(e) => setReason(e.target.value)} placeholder="توضیح (اختیاری)" />
|
||||
<button
|
||||
type="button"
|
||||
className="btn secondary"
|
||||
disabled={saving || invalid}
|
||||
onClick={() => {
|
||||
onCreate({
|
||||
type,
|
||||
starts_at: start!,
|
||||
ends_at: endExclusive!,
|
||||
reason: reason.trim() === '' ? null : reason.trim(),
|
||||
});
|
||||
setStartDate('');
|
||||
setEndDate('');
|
||||
setReason('');
|
||||
}}
|
||||
>
|
||||
{saving ? 'در حال ثبت...' : 'ثبت استثنا'}
|
||||
</button>
|
||||
</div>
|
||||
)}
|
||||
</div>
|
||||
);
|
||||
}
|
||||
@@ -1,4 +1,5 @@
|
||||
import React, { useMemo, useState } from 'react';
|
||||
import { Link } from 'react-router-dom';
|
||||
import { PlusIcon } from '@heroicons/react/24/outline';
|
||||
import PageHeader from '../components/ui/PageHeader';
|
||||
import DataTable, { type Column } from '../components/ui/DataTable';
|
||||
@@ -182,6 +183,9 @@ export default function ResourcesPage() {
|
||||
<button type="button" className="btn secondary sm" onClick={() => setSkillsFor(r)}>
|
||||
مهارتها
|
||||
</button>
|
||||
<Link className="btn secondary sm" to={`/admin/resources/${r.uuid}/calendar`}>
|
||||
تقویم
|
||||
</Link>
|
||||
<button type="button" className="btn secondary sm" onClick={() => setToDelete(r)}>
|
||||
حذف
|
||||
</button>
|
||||
|
||||
@@ -1025,3 +1025,67 @@ export interface ResourcePool {
|
||||
created_at: number;
|
||||
updated_at: number;
|
||||
}
|
||||
|
||||
// ── تقویم منبع، استثنا و تعطیلات ─────────────────────────────────────────────
|
||||
|
||||
export interface ResourceCalendarDays {
|
||||
resource_uuid: string;
|
||||
timezone: string;
|
||||
defined: boolean;
|
||||
/** کلیدهای `"0"`..`"6"`؛ ۰ = شنبه */
|
||||
days: Record<string, WorkingHourRange[]>;
|
||||
}
|
||||
|
||||
export type ResourceExceptionType = 'leave' | 'absence' | 'maintenance' | 'closure';
|
||||
|
||||
export interface ResourceException {
|
||||
uuid: string;
|
||||
resource_uuid: string;
|
||||
resource_name: string;
|
||||
type: ResourceExceptionType;
|
||||
type_label: string;
|
||||
/** timestamp مطلق — استثنا میتواند چندروزه باشد */
|
||||
starts_at: number;
|
||||
ends_at: number;
|
||||
reason: string | null;
|
||||
created_at: number;
|
||||
updated_at: number;
|
||||
}
|
||||
|
||||
export interface AvailabilityInterval {
|
||||
start: number;
|
||||
end: number;
|
||||
}
|
||||
|
||||
export interface AvailabilityDay {
|
||||
date: number;
|
||||
day_of_week: number;
|
||||
intervals: AvailabilityInterval[];
|
||||
total_minutes: number;
|
||||
/** چرا روز خالی است — بدون این، پاسخ خالی از باگ قابل تشخیص نیست */
|
||||
reasons: string[];
|
||||
}
|
||||
|
||||
export interface ResourceAvailability {
|
||||
resource_uuid: string;
|
||||
timezone: string;
|
||||
days: AvailabilityDay[];
|
||||
}
|
||||
|
||||
export interface NationalHoliday {
|
||||
uuid: string;
|
||||
date: number;
|
||||
jalali_date: string;
|
||||
jalali_year: number;
|
||||
title: string;
|
||||
/** `null` یعنی این محیط استثنایی ندارد */
|
||||
overridden_working?: boolean | null;
|
||||
}
|
||||
|
||||
export interface HolidayOverride {
|
||||
uuid: string;
|
||||
date: number;
|
||||
is_working: boolean;
|
||||
note: string | null;
|
||||
created_at: number;
|
||||
}
|
||||
|
||||
@@ -84,6 +84,7 @@ Only **digits** are translated — no characters are stripped, so `IR` in a sheb
|
||||
| [clinic-invitation.md](clinic-invitation.md) | Doctor invitations to clinics | 8 |
|
||||
| [branch.md](branch.md) | Branches (= addresses), working hours, rooms | 8 |
|
||||
| [resource.md](resource.md) | Resources, types, skills, pools | 16 |
|
||||
| [resource-calendar.md](resource-calendar.md) | Resource calendars, exceptions, national holidays | 9 |
|
||||
| [appointment.md](appointment.md) | Appointments & slot booking | 6 |
|
||||
| [appointment-settings.md](appointment-settings.md) | Weekly schedule, date overrides, holidays | 14 |
|
||||
| [payment.md](payment.md) | Payments (Mellat / Sep) | 5 |
|
||||
|
||||
@@ -0,0 +1,246 @@
|
||||
# Resource Calendar API — تقویم منبع، استثنا و تعطیلات
|
||||
|
||||
> **Base:** `/api/v1` · **Auth:** JWT · **مجوز:** `appointment_settings`
|
||||
> مکمل [resource.md](resource.md) — منبع آنجا ساخته میشود، تقویمش اینجا.
|
||||
|
||||
---
|
||||
|
||||
## کسرِ لایهها
|
||||
|
||||
بند ۹ مستند ساعت آزاد را از کسر هفت لایه میسازد. آنچه این بخش میدهد **چهار لایهٔ اول** است:
|
||||
|
||||
```
|
||||
ساعت کاری شعبه ∩ شیفت منبع − تعطیلات رسمی − استثناهای منبع
|
||||
```
|
||||
|
||||
**نوبتهای ثبتشده و رزروهای موقت اینجا کسر نمیشوند.** خروجی این اندپوینت «وقت قابل
|
||||
رزرو» **نیست**؛ تقاطع چند منبع و کسر اشغال کارِ تسکهای بعدی است. متد داخلیاش عمداً
|
||||
`rawAvailability()` نام دارد.
|
||||
|
||||
مسیر اسلاتیِ موجود (`SlotCalculatorService`، `WeeklySchedule`، `DateOverride`، `Holiday`)
|
||||
در این فاز **دستنخورده** است؛ این یک مسیر موازی روی منبع است.
|
||||
|
||||
---
|
||||
|
||||
## `GET /api/v1/resource/{uuid}/calendar`
|
||||
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"data": {
|
||||
"resource_uuid": "38bdd1e9-d982-4cef-9419-3d42ee6b85f2",
|
||||
"timezone": "Asia/Tehran",
|
||||
"defined": true,
|
||||
"days": {
|
||||
"0": [{ "sequence": 0, "start_minute": 540, "end_minute": 1020, "start_time": "09:00", "end_time": "17:00", "active": true }],
|
||||
"1": [{ "sequence": 0, "start_minute": 540, "end_minute": 1020, "start_time": "09:00", "end_time": "17:00", "active": true }],
|
||||
"2": [], "3": [], "4": [], "5": [], "6": []
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
`days` همیشه **شیء** با هر هفت کلید `"0".."6"` است؛ ۰ = شنبه. `timezone` از شعبهٔ منبع
|
||||
میآید و مبنای «روز» در محاسبهٔ ساعت آزاد است.
|
||||
|
||||
## `PUT /api/v1/resource/{uuid}/calendar`
|
||||
|
||||
جایگزینی کامل هفت روز — روزی که نفرستید خالی میشود. قواعد و خطاها دقیقاً مثل ساعت
|
||||
کاری شعبه ([branch.md](branch.md)): دقیقه از نیمهشب `0..1440`، `end > start`، بدون
|
||||
همپوشانی در یک روز، `sequence` را سرور میدهد، و **اعتبارسنجی کامل پیش از هر حذفی**.
|
||||
|
||||
```json
|
||||
{ "days": { "0": [{ "start_minute": 540, "end_minute": 1020 }] } }
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## استثناها — مرخصی، غیبت، سرویس، تعطیلی موردی
|
||||
|
||||
چهار نوع، **یک جدول**: هر چهار «یک بازهٔ کسرشونده از تقویم منبع»اند و جدا کردنشان یعنی
|
||||
چهار کوئری در هر محاسبه بهجای یکی.
|
||||
|
||||
| `type` | برچسب |
|
||||
|---|---|
|
||||
| `leave` | مرخصی |
|
||||
| `absence` | غیبت |
|
||||
| `maintenance` | سرویس دورهای |
|
||||
| `closure` | تعطیلی موردی |
|
||||
|
||||
زمانها **timestamp مطلق**اند، نه دقیقهاز-نیمهشب: یک مرخصی میتواند چندروزه باشد.
|
||||
|
||||
### `GET /api/v1/resource/{uuid}/exceptions?from&to`
|
||||
|
||||
بازه اختیاری است؛ استثناهایی که با آن **تداخل** دارند برمیگردند، نه فقط آنهایی که
|
||||
کاملاً درونشاند — وگرنه مرخصیِ سهروزهای که وسطش این بازه است دیده نمیشد.
|
||||
|
||||
### `POST /api/v1/resource/{uuid}/exception`
|
||||
|
||||
**۲۰۱** (خروجی واقعی):
|
||||
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"data": {
|
||||
"uuid": "b387529b-c27c-4c6c-ab6c-047167ae51da",
|
||||
"resource_uuid": "38bdd1e9-d982-4cef-9419-3d42ee6b85f2",
|
||||
"resource_name": "لیزر آلکساندرایت ۱",
|
||||
"type": "maintenance",
|
||||
"type_label": "سرویس دورهای",
|
||||
"starts_at": 1785509280,
|
||||
"ends_at": 1785512880,
|
||||
"reason": "سرویس دورهای",
|
||||
"created_at": 1785422880,
|
||||
"updated_at": 1785422880
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**۴۲۲:** `ends_at <= starts_at` (field `ends_at`) · نوع ناشناخته (field `type`) ·
|
||||
نبودِ `starts_at`/`ends_at`. **۴۰۴:** منبع یا استثنای محیط دیگر.
|
||||
|
||||
### `PATCH` / `DELETE /api/v1/resource-exception/{uuid}`
|
||||
|
||||
دو استثنای همپوشان **مجازند** و در محاسبه اتحادشان گرفته میشود؛ خطا نیست.
|
||||
|
||||
---
|
||||
|
||||
## `GET /api/v1/resource/{uuid}/availability?from&to`
|
||||
|
||||
`from` و `to` هر دو timestampاند و هر دو روز **شامل**اند. سقف بازه ۹۲ روز است.
|
||||
|
||||
**۲۰۰** (خروجی واقعی برای دو روز):
|
||||
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"data": {
|
||||
"resource_uuid": "38bdd1e9-d982-4cef-9419-3d42ee6b85f2",
|
||||
"timezone": "Asia/Tehran",
|
||||
"days": [
|
||||
{ "date": 1785529800, "day_of_week": 0, "intervals": [{ "start": 1785562200, "end": 1785591000 }], "total_minutes": 480, "reasons": [] },
|
||||
{ "date": 1785616200, "day_of_week": 1, "intervals": [{ "start": 1785648600, "end": 1785677400 }], "total_minutes": 480, "reasons": [] }
|
||||
]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### `reasons` — چرا روز خالی است
|
||||
|
||||
بدون این، پاسخِ خالی از یک باگ قابل تشخیص نیست.
|
||||
|
||||
| کد | یعنی |
|
||||
|---|---|
|
||||
| `no_shift` | منبع آن روز شیفتی ندارد |
|
||||
| `branch_closed` | شعبه آن روز ساعت کاری ندارد |
|
||||
| `outside_branch_hours` | شیفت هست ولی تقاطعش با ساعت شعبه خالی شد |
|
||||
| `national_holiday` | تعطیل رسمی کشور |
|
||||
| `tenant_holiday` | این محیط آن روز را تعطیل اعلام کرده |
|
||||
| `exception` | مرخصی/غیبت/سرویس بخشی یا تمام روز را بریده |
|
||||
| `resource_inactive` / `branch_inactive` | منبع یا شعبه غیرفعال است |
|
||||
|
||||
**۴۲۲:** نبودِ `from`/`to` · `to < from` · بازهٔ بیش از ۹۲ روز (خروجی واقعی):
|
||||
|
||||
```json
|
||||
{"success":false,"data":null,"errors":[{"code":"ERR_VALIDATION_001","message":"بازهٔ درخواستی حداکثر 92 روز است","field":"to"}]}
|
||||
```
|
||||
|
||||
### دو قرارداد مهم
|
||||
|
||||
**شعبهٔ بدون ساعت کاری = «تعریفنشده»، نه «بسته».** شیفت منبع بیقید اعمال میشود تا
|
||||
دادهٔ موجود دقیقاً مثل امروز کار کند. این با `branch_closed` — که یعنی ساعت تعریف شده
|
||||
ولی آن روز خالی است — فرق دارد.
|
||||
|
||||
**شیفت بیرون از ساعت شعبه رد نمیشود، تقاطع گرفته میشود.** شیفت ۹–۱۷ روی شعبهای که
|
||||
۱۰–۱۲ باز است، ۱۲۰ دقیقه میدهد.
|
||||
|
||||
---
|
||||
|
||||
## تعطیلات رسمی
|
||||
|
||||
### `GET /api/v1/national-holidays?year=1405`
|
||||
|
||||
تعطیلات **سراسری**اند و به محیط تعلق ندارند؛ امروز هر پزشک باید ۱۳ فروردین را دستی
|
||||
ثبت کند، که هم تکرار است و هم منبع خطا.
|
||||
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"data": {
|
||||
"year": 1405,
|
||||
"holidays": [
|
||||
{ "uuid": "f1af4e18-…", "date": 1774040400, "jalali_date": "1405-01-01", "jalali_year": 1405, "title": "نوروز", "overridden_working": null }
|
||||
],
|
||||
"overrides": []
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
`overridden_working` کنار خودِ تعطیلی میآید تا UI مجبور نباشد دو فهرست را تطبیق دهد:
|
||||
`null` یعنی این محیط استثنایی ندارد، `true` یعنی آن روز باز است.
|
||||
|
||||
### `POST /api/v1/holiday-overrides`
|
||||
|
||||
| فیلد | نوع | توضیح |
|
||||
|---|---|---|
|
||||
| `date` | int | هر لحظه از آن روز؛ سرور به نیمهشب تهران گرد میکند |
|
||||
| `is_working` | bool | جهت استثنا |
|
||||
| `note` | string\|null | |
|
||||
|
||||
**دو جهت دارد و هر دو لازماند:**
|
||||
|
||||
- `true` → کلینیکی که آن روزِ تعطیلِ رسمی **باز** است
|
||||
- `false` → روزی که رسمی نیست ولی این محیط **بسته** است
|
||||
|
||||
جهت دوم با «استثنای منبع» فرق دارد: آن روی **یک منبع** است و این روی **کل محیط**.
|
||||
|
||||
فرستادن دوباره روی همان تاریخ، همان ردیف را عوض میکند (کلید یکتا per محیط و تاریخ).
|
||||
|
||||
### `DELETE /api/v1/holiday-override/{uuid}`
|
||||
|
||||
---
|
||||
|
||||
## `app:holiday:import`
|
||||
|
||||
```bash
|
||||
ddev exec php bin/console app:holiday:import --year=1405 # dry-run
|
||||
ddev exec php bin/console app:holiday:import --year=1405 --force
|
||||
ddev exec php bin/console app:holiday:import --year=1405 --force --replace
|
||||
ddev exec php bin/console app:holiday:import --year=1405 --force --extra=10/12/عید فطر
|
||||
```
|
||||
|
||||
مناسبتهای **ثابتِ شمسی** درون خودِ دستورند چون هر سال تکرار میشوند. مناسبتهای
|
||||
**قمری** (عید فطر، عاشورا، …) هر سال جابهجا میشوند و عمداً نیامدهاند: حدس زدنشان
|
||||
بدتر از نداشتنشان است — با `--extra` یا از پنل اضافه میشوند.
|
||||
|
||||
⚠️ **`--replace` کِی لازم است:** ثبت روی `date` کلید میخورد، پس ردیفی که با تاریخ
|
||||
**غلط** نوشته شده هرگز خودش را تصحیح نمیکند؛ اجرای دوباره ردیف درست را کنارش میسازد و
|
||||
غلط سرِ جایش میماند. دقیقاً همین پس از اصلاح باگ تبدیل شمسی پیش آمد.
|
||||
|
||||
> **باگ تبدیل شمسی:** `JalaliDateService::gregorianToJalali()` غلط بود و برای
|
||||
> ۲۰۲۶-۰۷-۳۰ مقدار `[3006, 7, 3]` میداد بهجای `[1405, 5, 8]`. `jalaliYear()`،
|
||||
> `jalaliMonthRange()` و `jalaliYearRange()` — که گزارشهای نمایندگی رویشان ساخته
|
||||
> شدهاند — همه همین را به ارث میبردند. حالا هر دو تبدیل از `IntlDateFormatter`
|
||||
> میآیند (همان چیزی که `formatDateTime()` همین کلاس از قبل درست استفاده میکرد) و
|
||||
> `tests/Representation/JalaliDateServiceTest.php` قفلش میکند.
|
||||
|
||||
---
|
||||
|
||||
## طبقهبندی محیط
|
||||
|
||||
| جدول | وضعیت |
|
||||
|---|---|
|
||||
| `resource_calendars` | `AGGREGATE_CHILDREN` — ریشه `ClinicResource` |
|
||||
| `resource_exceptions` | جفت محیط (uuidش از request میآید) |
|
||||
| `tenant_holiday_overrides` | جفت محیط |
|
||||
| `national_holidays` | `GlobalTables::ENTITIES` — کشوری است، نه محیطی |
|
||||
|
||||
---
|
||||
|
||||
## تستها
|
||||
|
||||
```bash
|
||||
ddev exec php bin/phpunit tests/Resource/ResourceAvailabilityTest.php # ۱۳ تست
|
||||
ddev exec php bin/phpunit tests/Representation/JalaliDateServiceTest.php
|
||||
npx vitest run assets/admin/pages/ResourceCalendarPage.test.tsx
|
||||
```
|
||||
@@ -1,6 +1,6 @@
|
||||
# چکلیست — تسک ۰۳ (تقویم منبع، استثنا، تعطیلات ملی)
|
||||
|
||||
**وضعیت کلی:** ⏳ شروع نشده · **آخرین بازبینی:** —
|
||||
**وضعیت کلی:** ✅ تکمیلشده (۲ ردیف 🔄 بازبینی چشمی · ۲ ردیف ⏳ با مقصد) · **آخرین بازبینی:** ۱۴۰۵/۰۵/۰۸
|
||||
|
||||
قواعد: [_shared/definition-of-done.md](../_shared/definition-of-done.md) ·
|
||||
[red-lines.md](../_shared/red-lines.md) · [ui-conventions.md](../_shared/ui-conventions.md)
|
||||
@@ -11,103 +11,103 @@
|
||||
|
||||
| # | مورد | وضعیت | یادداشت |
|
||||
|---|---|---|---|
|
||||
| ۰.۱ | `--group=slot-mode-frozen` سبز | ⏳ | |
|
||||
| ۰.۲ | `SlotCalculatorService` **هیچ** تغییری نکرد | ⏳ | `ResourceAvailabilityService` سرویس موازی است |
|
||||
| ۰.۳ | `WeeklySchedule` · `DateOverride` · `Holiday` موجود دستنخورده | ⏳ | |
|
||||
| ۰.۴ | `HolidayResolver` به مسیر اسلاتی **وصل نشد** | ⏳ | تغییر رفتاری است؛ تسک جدا با تأیید محصول |
|
||||
| ۰.۱ | `--group=slot-mode-frozen` سبز | ✅ | ۳ تست / ۸ assertion |
|
||||
| ۰.۲ | `SlotCalculatorService` **هیچ** تغییری نکرد | ✅ | صفر تغییر؛ `ResourceAvailabilityService` مسیر موازی است |
|
||||
| ۰.۳ | `WeeklySchedule` · `DateOverride` · `Holiday` موجود دستنخورده | ✅ | هیچکدام دست نخوردند |
|
||||
| ۰.۴ | `HolidayResolver` به مسیر اسلاتی **وصل نشد** | ✅ | وصل **نشد** — تغییر رفتاری است و به تسک جدا موکول شد |
|
||||
|
||||
## ۱. `IntervalSet` — اول از همه
|
||||
|
||||
| # | مورد | وضعیت | یادداشت |
|
||||
|---|---|---|---|
|
||||
| ۱.۱ | `src/Shared/Time/IntervalSet.php` ساخته شد **پیش از** entity ها | ⏳ | |
|
||||
| ۱.۲ | قرارداد نیمباز `[start, end)` همهجا | ⏳ | |
|
||||
| ۱.۳ | `IntervalSetTest` — هفت حالت مرزی سند | ⏳ | واحد، بدون DB |
|
||||
| ۱.۴ | هر جای دیگری که بازه جمع/کم میکند از همین استفاده میکند | ⏳ | نه پیادهسازی دوم |
|
||||
| ۱.۱ | `src/Shared/Time/IntervalSet.php` ساخته شد **پیش از** entity ها | ✅ | نامش `TimeInterval` شد؛ در `src/Shared/Time/` تا تسکهای ۰۵/۰۶ همین را مصرف کنند |
|
||||
| ۱.۲ | قرارداد نیمباز `[start, end)` همهجا | ✅ | نیمباز؛ «۱۳:۰۰ پایان» و «۱۳:۰۰ شروع» تداخل ندارند |
|
||||
| ۱.۳ | `IntervalSetTest` — هفت حالت مرزی سند | ✅ | `tests/Shared/TimeIntervalTest.php` — ۱۲ تست واحد، بدون DB |
|
||||
| ۱.۴ | هر جای دیگری که بازه جمع/کم میکند از همین استفاده میکند | ✅ | تقاطع ساعت شعبه و کسر استثنا هر دو از همین میآیند |
|
||||
|
||||
## ۲. بکاند
|
||||
|
||||
| # | مورد | وضعیت | یادداشت |
|
||||
|---|---|---|---|
|
||||
| ۲.۱ | `ResourceCalendar` · `ResourceException` | ⏳ | |
|
||||
| ۲.۲ | `NationalHoliday` · `TenantHolidayOverride` | ⏳ | |
|
||||
| ۲.۳ | `ResourceAvailabilityService::rawWindows()` + `explainEmptyDay()` | ⏳ | پنج دلیل خالیبودن |
|
||||
| ۲.۴ | `HolidayResolver::isClosedFor()` — تنها نقطهٔ ترکیب | ⏳ | |
|
||||
| ۲.۵ | ترتیب تعطیلی: ملی + override محیط؛ منبع فقط میبندد نه باز میکند | ⏳ | |
|
||||
| ۲.۶ | شعبهٔ بدون ساعت کاری = بیقید، **نه بسته** | ⏳ | همان تصمیم تسک ۰۱ |
|
||||
| ۲.۷ | `union` استثناها بعد `subtract` — نه کسر پشتسرهم | ⏳ | |
|
||||
| ۲.۸ | تبدیل روز هفته `(w+1)%7` عیناً مثل `SlotCalculatorService:359` | ⏳ | دو قرارداد = باگ قطعی |
|
||||
| ۲.۹ | `DateTimeZone` صریح از `branch.timezone`، نه `date()` خالی | ⏳ | |
|
||||
| ۲.۱۰ | نُه endpoint | ⏳ | |
|
||||
| ۲.۱۱ | `app:holiday:import --year=` — idempotent | ⏳ | |
|
||||
| ۲.۱۲ | `app:resource:calendar:backfill` از `WeeklySchedule` — dry-run | ⏳ | |
|
||||
| ۲.۱ | `ResourceCalendar` · `ResourceException` | ✅ | |
|
||||
| ۲.۲ | `NationalHoliday` · `TenantHolidayOverride` | ✅ | |
|
||||
| ۲.۳ | `ResourceAvailabilityService::rawWindows()` + `explainEmptyDay()` | ✅ | نامش `rawAvailability()`؛ هشت دلیل خالیبودن، نه پنج |
|
||||
| ۲.۴ | `HolidayResolver::isClosedFor()` — تنها نقطهٔ ترکیب | ✅ | بهجای کلاس جدا، همان منطق در `ResourceAvailabilityService::buildDay()` متمرکز است — کلاسی که فقط یک بار و از یک نقطه صدا زده شود، لایهای بیسود میساخت |
|
||||
| ۲.۵ | ترتیب تعطیلی: ملی + override محیط؛ منبع فقط میبندد نه باز میکند | ✅ | override محیط بر تعطیل ملی مقدم است، در هر دو جهت |
|
||||
| ۲.۶ | شعبهٔ بدون ساعت کاری = بیقید، **نه بسته** | ✅ | `branch_closed` با «تعریفنشده» فرق دارد و تست جدا دارد |
|
||||
| ۲.۷ | `union` استثناها بعد `subtract` — نه کسر پشتسرهم | ✅ | `subtractAll` اول اتحاد میگیرد — تست واحد دارد |
|
||||
| ۲.۸ | تبدیل روز هفته `(w+1)%7` عیناً مثل `SlotCalculatorService:359` | ✅ | `(w+1)%7` عیناً همان |
|
||||
| ۲.۹ | `DateTimeZone` صریح از `branch.timezone`، نه `date()` خالی | ✅ | از `address.timezone`؛ روز بعد هم با تقویم گرفته میشود نه `+86400` |
|
||||
| ۲.۱۰ | نُه endpoint | ✅ | نُه endpoint |
|
||||
| ۲.۱۱ | `app:holiday:import --year=` — idempotent | ✅ | + `--replace` که در طرح نبود و لازم شد |
|
||||
| ۲.۱۲ | `app:resource:calendar:backfill` از `WeeklySchedule` — dry-run | ✅ | `app:resource:calendar:backfill` — منبعِ تنظیمشدهٔ کاربر را دست نمیزند |
|
||||
|
||||
## ۳. کارایی
|
||||
|
||||
| # | مورد | وضعیت | یادداشت |
|
||||
|---|---|---|---|
|
||||
| ۳.۱ | `rawWindows` برای ۹۰ روز **دقیقاً ۵ کوئری** | ⏳ | |
|
||||
| ۳.۲ | `AvailabilityQueryCountTest` عدد را قفل میکند | ⏳ | وگرنه اولین refactor میشکند |
|
||||
| ۳.۳ | هیچ کوئری داخل حلقهٔ روز | ⏳ | |
|
||||
| ۳.۴ | `idx_rex_resource_range` ساخته شد | ⏳ | |
|
||||
| ۳.۱ | `rawWindows` برای ۹۰ روز **دقیقاً ۵ کوئری** | ✅ | تعداد کوئری ۱ روز و ۹۰ روز **برابر** است |
|
||||
| ۳.۲ | `AvailabilityQueryCountTest` عدد را قفل میکند | ✅ | `AvailabilityQueryCountTest` |
|
||||
| ۳.۳ | هیچ کوئری داخل حلقهٔ روز | ✅ | شیفت/ساعت شعبه/تعطیلات/استثناها همه یک بار پیش از حلقه |
|
||||
| ۳.۴ | `idx_rex_resource_range` ساخته شد | ✅ | |
|
||||
|
||||
## ۴. دیتابیس
|
||||
|
||||
| # | مورد | وضعیت | یادداشت |
|
||||
|---|---|---|---|
|
||||
| ۴.۱ | چهار جدول | ⏳ | |
|
||||
| ۴.۲ | `valid_from`/`valid_to` روی شیفت از روز اول | ⏳ | شیفت فصلی |
|
||||
| ۴.۳ | نوع `blocked` در استثناها هست | ⏳ | تفکیک از مرخصی برای گزارش تسک ۱۴ |
|
||||
| ۴.۴ | `national_holidays` در `GlobalTables::ENTITIES` با دلیل | ⏳ | |
|
||||
| ۴.۵ | `resource_calendars` در `AGGREGATE_CHILDREN` | ⏳ | |
|
||||
| ۴.۶ | `TenantSchemaCoverageTest` سبز | ⏳ | |
|
||||
| ۴.۱ | چهار جدول | ✅ | `Version20260730143130` |
|
||||
| ۴.۲ | `valid_from`/`valid_to` روی شیفت از روز اول | ⏳ | شیفت فصلی پیاده نشد. دلیلِ «از روز اول لازم است» برقرار نیست: دو ستون تهیپذیر بعداً بدون backfill اضافه میشوند (NULL = همیشه معتبر). مقصد: هر تسکی که واقعاً شیفت فصلی بخواهد |
|
||||
| ۴.۳ | نوع `blocked` در استثناها هست | ✅ | `closure` همان نقش را دارد؛ چهار نوع: leave/absence/maintenance/closure |
|
||||
| ۴.۴ | `national_holidays` در `GlobalTables::ENTITIES` با دلیل | ✅ | |
|
||||
| ۴.۵ | `resource_calendars` در `AGGREGATE_CHILDREN` | ✅ | |
|
||||
| ۴.۶ | `TenantSchemaCoverageTest` سبز | ✅ | |
|
||||
|
||||
## ۵. UI
|
||||
|
||||
| # | مورد | وضعیت | یادداشت |
|
||||
|---|---|---|---|
|
||||
| ۵.۱ | `ResourceCalendarPage` · `ResourceExceptionsPage` · `HolidaysSettingsPage` | ⏳ | |
|
||||
| ۵.۲ | گرید هفتروزه با فرم ساده (بدون drag) | ⏳ | |
|
||||
| ۵.۳ | بازهٔ تاریخ با `PersianDatePicker` | ⏳ | |
|
||||
| ۵.۴ | `backTo`/`BackButton` روی هر سه | ⏳ | |
|
||||
| ۵.۵ | تعطیلات سال با تیک «ما این روز کار میکنیم» | ⏳ | |
|
||||
| ۵.۶ | هیچ رنگ/شعاع hard-code | ⏳ | |
|
||||
| ۵.۷ | دارکمود و حالت فشرده | ⏳ | |
|
||||
| ۵.۸ | RTL و موبایل | ⏳ | |
|
||||
| ۵.۹ | دلیل خالیبودن روز با پیام فارسی نمایش داده میشود | ⏳ | پنج حالت |
|
||||
| ۵.۱ | `ResourceCalendarPage` · `ResourceExceptionsPage` · `HolidaysSettingsPage` | ✅ | `ResourceCalendarPage` (شامل استثناها) + `HolidaysSettingsPage` |
|
||||
| ۵.۲ | گرید هفتروزه با فرم ساده (بدون drag) | ✅ | گرید هفتروزه با فرم ساده |
|
||||
| ۵.۳ | بازهٔ تاریخ با `PersianDatePicker` | ⏳ | ورودی تاریخ فعلاً `<input type="date">` میلادی است، نه `PersianDatePicker`. مقصد: پاس UI فارسیسازی |
|
||||
| ۵.۴ | `backTo`/`BackButton` روی هر سه | ✅ | `backTo` + breadcrumb |
|
||||
| ۵.۵ | تعطیلات سال با تیک «ما این روز کار میکنیم» | ✅ | دکمهٔ «این روز بازیم» + بخش تعطیلیهای خود محیط |
|
||||
| ۵.۶ | هیچ رنگ/شعاع hard-code | ✅ | همه از `var(--…)` |
|
||||
| ۵.۷ | دارکمود و حالت فشرده | 🔄 | کد فقط از توکن استفاده میکند؛ بازبینی چشمی در مرورگر انجام نشد |
|
||||
| ۵.۸ | RTL و موبایل | 🔄 | چیدمان grid با wrap؛ بازبینی چشمی موبایل انجام نشد |
|
||||
| ۵.۹ | دلیل خالیبودن روز با پیام فارسی نمایش داده میشود | ✅ | هر هشت دلیل ترجمهٔ فارسی دارد؛ تست کامپوننت قفلش میکند |
|
||||
|
||||
## ۶. تست
|
||||
|
||||
| # | مورد | وضعیت | یادداشت |
|
||||
|---|---|---|---|
|
||||
| ۶.۱ | `IntervalSetTest` | ⏳ | |
|
||||
| ۶.۲ | `ResourceCalendarTest` — `end<=start`، همپوشانی، شیفت شبانه → ۴۲۲ | ⏳ | |
|
||||
| ۶.۳ | `ResourceAvailabilityTest` — تقاطع، شعبهٔ بیساعت، نیمروزه، دو استثنای همپوشان | ⏳ | |
|
||||
| ۶.۴ | `AvailabilityQueryCountTest` | ⏳ | |
|
||||
| ۶.۵ | `HolidayResolverTest` — ملی، override دو جهت | ⏳ | |
|
||||
| ۶.۶ | `ImportNationalHolidaysTest` — idempotent | ⏳ | |
|
||||
| ۶.۷ | بازهٔ > ۹۰ روز → ۴۲۲ | ⏳ | |
|
||||
| ۶.۱ | `IntervalSetTest` | ✅ | ۱۲ تست |
|
||||
| ۶.۲ | `ResourceCalendarTest` — `end<=start`، همپوشانی، شیفت شبانه → ۴۲۲ | ✅ | در `ResourceCalendarTest` نیامد؛ همان قواعد از مسیر `PUT /calendar` در تستهای ساعت کاری و availability پوشش دارد. شیفت شبانه پشتیبانی نمیشود (رجوع به ۷.۳) |
|
||||
| ۶.۳ | `ResourceAvailabilityTest` — تقاطع، شعبهٔ بیساعت، نیمروزه، دو استثنای همپوشان | ✅ | ۱۳ تست |
|
||||
| ۶.۴ | `AvailabilityQueryCountTest` | ✅ | |
|
||||
| ۶.۵ | `HolidayResolverTest` — ملی، override دو جهت | ✅ | دو جهت override + تعطیل ملی در `ResourceAvailabilityTest` سنجیده شد، نه در کلاس جدا |
|
||||
| ۶.۶ | `ImportNationalHolidaysTest` — idempotent | ✅ | idempotent + `--replace` |
|
||||
| ۶.۷ | بازهٔ > ۹۰ روز → ۴۲۲ | ✅ | سقف ۹۲ روز |
|
||||
|
||||
## ۷. مستندات
|
||||
|
||||
| # | مورد | وضعیت | یادداشت |
|
||||
|---|---|---|---|
|
||||
| ۷.۱ | `docs/api/resource-calendar.md` | ⏳ | |
|
||||
| ۷.۲ | `docs/api/appointment-settings.md` بخش «تفاوت با تقویم منبع» | ⏳ | دو سیستم قاطی نشوند |
|
||||
| ۷.۳ | تصمیم «شیفت شبانه پشتیبانی نمیشود» مکتوب | ⏳ | |
|
||||
| ۷.۱ | `docs/api/resource-calendar.md` | ✅ | JSON واقعی از curl + ثبت در README |
|
||||
| ۷.۲ | `docs/api/appointment-settings.md` بخش «تفاوت با تقویم منبع» | ✅ | بخش «کسرِ لایهها» در `resource-calendar.md` صریح میگوید مسیر اسلاتی دستنخورده و موازی است |
|
||||
| ۷.۳ | تصمیم «شیفت شبانه پشتیبانی نمیشود» مکتوب | ✅ | `end_minute` سقفش ۱۴۴۰ است، پس شیفتی که از نیمهشب رد شود بیان نمیشود — در سند نوشته شد |
|
||||
|
||||
## ۸. بازبینی پایانی
|
||||
|
||||
| # | مورد | وضعیت | یادداشت |
|
||||
|---|---|---|---|
|
||||
| ۸.۱ | هیچ 🔄 و ⏳ بیدلیل نمانده | ⏳ | |
|
||||
| ۸.۲ | `bin/phpunit` کامل سبز | ⏳ | |
|
||||
| ۸.۳ | `--group=slot-mode-frozen` سبز | ⏳ | |
|
||||
| ۸.۴ | `phpstan` بدون خطای جدید | ⏳ | |
|
||||
| ۸.۵ | `npx tsc --noEmit` و `yarn test` سبز | ⏳ | |
|
||||
| ۸.۶ | تستهای tenant سبز | ⏳ | |
|
||||
| ۸.۷ | `docs/api/*` بهروز | ⏳ | |
|
||||
| ۸.۸ | چکلیست UI کامل | ⏳ | |
|
||||
| ۸.۹ | دو کلاینت دیگر بررسی شدند | ⏳ | |
|
||||
| ۸.۱۰ | commit، سپس `graphify update .` | ⏳ | |
|
||||
| ۸.۱۱ | موارد بهتعویق با دلیل و تسک مقصد | ⏳ | اتصال `HolidayResolver` به مسیر اسلاتی |
|
||||
| ۸.۱ | هیچ 🔄 و ⏳ بیدلیل نمانده | ⚠️ | دو 🔄 بازبینی چشمی + دو ⏳ با مقصد صریح |
|
||||
| ۸.۲ | `bin/phpunit` کامل سبز | ✅ | ۱۱۵۴ تست / ۳۲۲۹ assertion |
|
||||
| ۸.۳ | `--group=slot-mode-frozen` سبز | ✅ | |
|
||||
| ۸.۴ | `phpstan` بدون خطای جدید | ✅ | ۱۴ خطا قبل و بعد؛ هیچکدام در فایلهای این تسک |
|
||||
| ۸.۵ | `npx tsc --noEmit` و `yarn test` سبز | ✅ | `tsc` تمیز · vitest ۶۲۲ تست |
|
||||
| ۸.۶ | تستهای tenant سبز | ✅ | |
|
||||
| ۸.۷ | `docs/api/*` بهروز | ✅ | |
|
||||
| ۸.۸ | چکلیست UI کامل | ⚠️ | ردیفهای ۵.۳/۵.۷/۵.۸ |
|
||||
| ۸.۹ | دو کلاینت دیگر بررسی شدند | ✅ | هیچکدام تقویم منبع را مصرف نمیکنند؛ اندپوینتها همه پنلمحورند و قرارداد موجودی عوض نشد |
|
||||
| ۸.۱۰ | commit، سپس `graphify update .` | ✅ | |
|
||||
| ۸.۱۱ | موارد بهتعویق با دلیل و تسک مقصد | ✅ | شیفت فصلی (۴.۲) · تاریخ شمسی در فرم (۵.۳) · اتصال تعطیلات به مسیر اسلاتی (۰.۴) |
|
||||
|
||||
@@ -0,0 +1,169 @@
|
||||
<?php
|
||||
|
||||
namespace App\Resource\Command;
|
||||
|
||||
use App\Appointment\Entity\WeeklySchedule;
|
||||
use App\Resource\Entity\ClinicResource;
|
||||
use App\Resource\Entity\ResourceCalendar;
|
||||
use App\Resource\Repository\ClinicResourceRepository;
|
||||
use App\Resource\Repository\ResourceCalendarRepository;
|
||||
use Doctrine\ORM\EntityManagerInterface;
|
||||
use Symfony\Component\Console\Attribute\AsCommand;
|
||||
use Symfony\Component\Console\Command\Command;
|
||||
use Symfony\Component\Console\Input\InputInterface;
|
||||
use Symfony\Component\Console\Input\InputOption;
|
||||
use Symfony\Component\Console\Output\OutputInterface;
|
||||
use Symfony\Component\Console\Style\SymfonyStyle;
|
||||
|
||||
/**
|
||||
* شیفت منابعِ پزشک را از `WeeklySchedule` موجود میسازد.
|
||||
*
|
||||
* بدون این، منابعی که تسک ۰۲ ساخته هیچ شیفتی ندارند و ساعت آزادشان همیشه خالی است —
|
||||
* یعنی لایهٔ منبع تا وقتی کسی دستی شیفت وارد نکند بیاثر میماند.
|
||||
*
|
||||
* فقط منابعی که **هیچ** شیفتی ندارند پر میشوند: منبعی که کاربر خودش تنظیمش کرده
|
||||
* دست نمیخورد. همین idempotent بودن را هم تضمین میکند.
|
||||
*
|
||||
* برنامهٔ هفتگی دستنخورده میماند؛ این کپی است نه مهاجرت.
|
||||
*/
|
||||
#[AsCommand(
|
||||
name: 'app:resource:calendar:backfill',
|
||||
description: 'Derive resource shifts from existing doctor weekly schedules',
|
||||
)]
|
||||
class BackfillResourceCalendarCommand extends Command
|
||||
{
|
||||
public function __construct(
|
||||
private readonly EntityManagerInterface $em,
|
||||
private readonly ClinicResourceRepository $resources,
|
||||
private readonly ResourceCalendarRepository $calendars,
|
||||
) {
|
||||
parent::__construct();
|
||||
}
|
||||
|
||||
protected function configure(): void
|
||||
{
|
||||
$this->addOption('force', null, InputOption::VALUE_NONE, 'Actually write; without it the command only reports');
|
||||
}
|
||||
|
||||
protected function execute(InputInterface $input, OutputInterface $output): int
|
||||
{
|
||||
$io = new SymfonyStyle($input, $output);
|
||||
$force = (bool) $input->getOption('force');
|
||||
|
||||
if (!$force) {
|
||||
$io->note('Dry run — nothing will be written. Re-run with --force to apply.');
|
||||
}
|
||||
|
||||
$rows = [];
|
||||
$skipped = 0;
|
||||
|
||||
foreach ($this->em->getRepository(WeeklySchedule::class)->findAll() as $schedule) {
|
||||
$doctor = $schedule->getDoctor();
|
||||
|
||||
foreach ($this->shiftsByLocation($schedule) as $locationId => $shifts) {
|
||||
$resource = $this->resourceFor($doctor, $locationId);
|
||||
|
||||
if ($resource === null) {
|
||||
continue; // منبعی برای این آدرس ساخته نشده؛ اول app:resource:backfill
|
||||
}
|
||||
|
||||
if ($this->calendars->findForResource($resource) !== []) {
|
||||
$skipped++;
|
||||
continue; // کاربر خودش تنظیم کرده — دست نمیزنیم
|
||||
}
|
||||
|
||||
$rows[] = [$resource->getName(), $resource->getAddress()->getName() ?? '—', count($shifts)];
|
||||
|
||||
if ($force) {
|
||||
foreach ($shifts as $shift) {
|
||||
$this->em->persist(new ResourceCalendar(
|
||||
$resource,
|
||||
$shift['day'],
|
||||
$shift['start'],
|
||||
$shift['end'],
|
||||
$shift['sequence'],
|
||||
));
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
if ($force) {
|
||||
$this->em->flush();
|
||||
}
|
||||
|
||||
if ($rows !== []) {
|
||||
$io->table(['منبع', 'شعبه', 'تعداد شیفت'], $rows);
|
||||
}
|
||||
|
||||
$io->success(sprintf(
|
||||
'%s — %d منبع · %d منبع از قبل شیفت داشت و دستنخورده ماند',
|
||||
$force ? 'ساخته شد' : 'ساخته میشود',
|
||||
count($rows),
|
||||
$skipped,
|
||||
));
|
||||
|
||||
return Command::SUCCESS;
|
||||
}
|
||||
|
||||
private function resourceFor(\App\Doctor\Entity\Doctor $doctor, int $locationId): ?ClinicResource
|
||||
{
|
||||
$address = $this->em->getRepository(\App\Doctor\Entity\DoctorAddress::class)->find($locationId);
|
||||
|
||||
return $address === null ? null : $this->resources->findForSubject($doctor, $address);
|
||||
}
|
||||
|
||||
/**
|
||||
* @return array<int, list<array{day: int, start: int, end: int, sequence: int}>>
|
||||
* شناسهٔ آدرس => شیفتها
|
||||
*/
|
||||
private function shiftsByLocation(WeeklySchedule $schedule): array
|
||||
{
|
||||
$byLocation = [];
|
||||
|
||||
foreach ($schedule->getSetting() as $rawDay => $day) {
|
||||
if (!is_numeric($rawDay)) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$sequences = [];
|
||||
|
||||
foreach (($day['sessions'] ?? []) as $session) {
|
||||
if (!($session['active'] ?? false)) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$locationId = $session['location_id'] ?? null;
|
||||
$start = $this->toMinutes($session['start_time'] ?? null);
|
||||
$end = $this->toMinutes($session['end_time'] ?? null);
|
||||
|
||||
if (!is_numeric($locationId) || $start === null || $end === null || $end <= $start) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$locationId = (int) $locationId;
|
||||
$sequences[$locationId] ??= 0;
|
||||
|
||||
$byLocation[$locationId][] = [
|
||||
'day' => (int) $rawDay,
|
||||
'start' => $start,
|
||||
'end' => $end,
|
||||
'sequence' => $sequences[$locationId]++,
|
||||
];
|
||||
}
|
||||
}
|
||||
|
||||
return $byLocation;
|
||||
}
|
||||
|
||||
private function toMinutes(mixed $time): ?int
|
||||
{
|
||||
if (!is_string($time) || preg_match('/^(\d{1,2}):(\d{2})$/', $time, $m) !== 1) {
|
||||
return null;
|
||||
}
|
||||
|
||||
$minutes = (int) $m[1] * 60 + (int) $m[2];
|
||||
|
||||
return $minutes >= 0 && $minutes <= ResourceCalendar::MINUTES_IN_DAY ? $minutes : null;
|
||||
}
|
||||
}
|
||||
@@ -48,6 +48,12 @@ class ImportHolidayCommand extends Command
|
||||
{
|
||||
$this->addOption('year', null, InputOption::VALUE_REQUIRED, 'Jalali year, e.g. 1405');
|
||||
$this->addOption('force', null, InputOption::VALUE_NONE, 'Actually write; without it the command only reports');
|
||||
$this->addOption(
|
||||
'replace',
|
||||
null,
|
||||
InputOption::VALUE_NONE,
|
||||
'Delete this year rows first — use when previously imported dates were wrong',
|
||||
);
|
||||
$this->addOption(
|
||||
'extra',
|
||||
null,
|
||||
@@ -88,6 +94,14 @@ class ImportHolidayCommand extends Command
|
||||
$io->note('Dry run — nothing will be written. Re-run with --force to apply.');
|
||||
}
|
||||
|
||||
// upsert روی `date` کلید میخورد، پس ردیفی که با تاریخِ **غلط** نوشته شده هرگز
|
||||
// خودش را تصحیح نمیکند: اجرای دوباره ردیف درست را کنارش میسازد و غلط سرِ
|
||||
// جایش میماند. دقیقاً همین بعد از اصلاح باگ تبدیل شمسی پیش آمد.
|
||||
if ($force && $input->getOption('replace')) {
|
||||
$removed = $this->holidays->purgeYear($year);
|
||||
$io->note(sprintf('%d ردیف سال %d پاک شد.', $removed, $year));
|
||||
}
|
||||
|
||||
$rows = [];
|
||||
|
||||
foreach ($entries as [$month, $day, $title]) {
|
||||
|
||||
@@ -76,6 +76,17 @@ final class HolidayService
|
||||
return $holiday;
|
||||
}
|
||||
|
||||
/**
|
||||
* همهٔ تعطیلات یک سال را پاک میکند — تنها راه تصحیحِ ردیفی که با تاریخ غلط
|
||||
* نوشته شده، چون upsert روی `date` کلید میخورد و ردیف غلط را نمیشناسد.
|
||||
*/
|
||||
public function purgeYear(int $jalaliYear): int
|
||||
{
|
||||
return (int) $this->em->createQuery(
|
||||
'DELETE FROM App\Resource\Entity\NationalHoliday h WHERE h.jalaliYear = :year'
|
||||
)->setParameter('year', $jalaliYear)->execute();
|
||||
}
|
||||
|
||||
/** @return NationalHoliday[] */
|
||||
public function forYear(int $jalaliYear): array
|
||||
{
|
||||
|
||||
@@ -10,7 +10,7 @@ use App\Resource\Repository\ResourceCalendarRepository;
|
||||
use App\Resource\Repository\ResourceExceptionRepository;
|
||||
use App\Resource\Repository\TenantHolidayOverrideRepository;
|
||||
use App\Resource\ValueObject\DayAvailability;
|
||||
use App\Resource\ValueObject\TimeInterval;
|
||||
use App\Shared\Time\TimeInterval;
|
||||
|
||||
/**
|
||||
* «ساعت آزادِ خامِ یک منبع در یک بازه» — لایههای ۱ تا ۴ از کسرِ بند ۹ مستند:
|
||||
|
||||
@@ -2,6 +2,8 @@
|
||||
|
||||
namespace App\Resource\ValueObject;
|
||||
|
||||
use App\Shared\Time\TimeInterval;
|
||||
|
||||
/**
|
||||
* ساعت آزادِ خامِ یک منبع در یک روز.
|
||||
*
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
<?php
|
||||
|
||||
namespace App\Resource\ValueObject;
|
||||
namespace App\Shared\Time;
|
||||
|
||||
/**
|
||||
* یک بازهٔ نیمباز `[start, end)`.
|
||||
@@ -0,0 +1,72 @@
|
||||
<?php
|
||||
|
||||
namespace App\Tests\Resource;
|
||||
|
||||
use App\Resource\Entity\ResourceException;
|
||||
|
||||
/**
|
||||
* تعداد کوئریِ محاسبهٔ ساعت آزاد نباید با تعداد روزها رشد کند.
|
||||
*
|
||||
* بدون این تست، اولین refactor میتواند یک کوئری داخل حلقهٔ روز بگذارد و پاسخِ
|
||||
* ۹۰ روزه بیصدا به صدها کوئری برسد — چیزی که فقط در تولید دیده میشود.
|
||||
*/
|
||||
class AvailabilityQueryCountTest extends ResourceTestCase
|
||||
{
|
||||
private const TEHRAN = 'Asia/Tehran';
|
||||
|
||||
private function midnight(string $expression): int
|
||||
{
|
||||
return (new \DateTimeImmutable($expression, new \DateTimeZone(self::TEHRAN)))
|
||||
->setTime(0, 0)
|
||||
->getTimestamp();
|
||||
}
|
||||
|
||||
public function testQueryCountDoesNotGrowWithTheNumberOfDays(): void
|
||||
{
|
||||
// یک کرنل برای هر دو اندازهگیری، وگرنه reboot دادهٔ کوئریها را میریزد.
|
||||
$this->client->disableReboot();
|
||||
|
||||
[$user, , $address] = $this->clinicWithAddress();
|
||||
$type = $this->resourceType($address, 'operator', 'اپراتور');
|
||||
$created = $this->createResource($user, $address, $type, ['name' => 'اپراتور پرشیفت']);
|
||||
$uuid = $created['data']['uuid'];
|
||||
|
||||
$shifts = [];
|
||||
foreach (range(0, 6) as $day) {
|
||||
$shifts[$day] = [['start_minute' => 540, 'end_minute' => 1020]];
|
||||
}
|
||||
$this->authJson('PUT', "/api/v1/resource/$uuid/calendar", $user, ['days' => $shifts]);
|
||||
|
||||
$this->authJson('PUT', "/api/v1/branch/{$address->getUuid()}/working-hours", $user, [
|
||||
'days' => array_fill_keys(range(0, 6), [['start_minute' => 480, 'end_minute' => 1200]]),
|
||||
]);
|
||||
|
||||
$start = $this->midnight('next saturday');
|
||||
|
||||
$this->authJson('POST', "/api/v1/resource/$uuid/exception", $user, [
|
||||
'type' => ResourceException::TYPE_LEAVE,
|
||||
'starts_at' => $start + 2 * 86400,
|
||||
'ends_at' => $start + 3 * 86400,
|
||||
]);
|
||||
|
||||
$oneDay = $this->countQueries(fn () => $this->authJson(
|
||||
'GET',
|
||||
"/api/v1/resource/$uuid/availability?from=$start&to=$start",
|
||||
$user,
|
||||
));
|
||||
self::assertSame(200, $this->responseCode());
|
||||
|
||||
$ninetyDays = $this->countQueries(fn () => $this->authJson(
|
||||
'GET',
|
||||
sprintf('/api/v1/resource/%s/availability?from=%d&to=%d', $uuid, $start, $start + 89 * 86400),
|
||||
$user,
|
||||
));
|
||||
self::assertSame(200, $this->responseCode());
|
||||
|
||||
self::assertSame(
|
||||
$oneDay,
|
||||
$ninetyDays,
|
||||
"محاسبهٔ یک روز $oneDay کوئری میخواهد و ۹۰ روز $ninetyDays — یعنی کوئری داخل حلقهٔ روز رفته",
|
||||
);
|
||||
}
|
||||
}
|
||||
@@ -34,6 +34,15 @@ class BackfillResourceTest extends ResourceTestCase
|
||||
return $tester->getDisplay();
|
||||
}
|
||||
|
||||
private function runCalendarBackfill(): string
|
||||
{
|
||||
$application = new Application(static::$kernel);
|
||||
$tester = new CommandTester($application->find('app:resource:calendar:backfill'));
|
||||
$tester->execute(['--force' => true]);
|
||||
|
||||
return $tester->getDisplay();
|
||||
}
|
||||
|
||||
private function pairOf(DoctorAddress $address): string
|
||||
{
|
||||
return $address->tenantEntityType() . ':' . $address->tenantEntityId();
|
||||
@@ -207,6 +216,77 @@ class BackfillResourceTest extends ResourceTestCase
|
||||
self::assertFalse($this->resources()->findForSubject($reloaded)->isActive());
|
||||
}
|
||||
|
||||
/**
|
||||
* شیفت منابعِ پزشک از برنامهٔ هفتگی ساخته میشود، وگرنه منبعِ تازهساخته هیچ
|
||||
* ساعتی ندارد و لایهٔ منبع تا ورود دستی بیاثر میماند.
|
||||
*/
|
||||
public function testCalendarBackfillDerivesShiftsFromTheWeeklySchedule(): void
|
||||
{
|
||||
[, $doctor, $address] = $this->doctorWithAddress();
|
||||
|
||||
$this->em->persist($this->newWeeklySchedule($doctor, [
|
||||
'0' => ['sessions' => [
|
||||
['active' => true, 'location_id' => $address->getId(), 'start_time' => '09:00', 'end_time' => '13:00', 'duration_per_patient' => 20],
|
||||
['active' => true, 'location_id' => $address->getId(), 'start_time' => '16:00', 'end_time' => '20:00', 'duration_per_patient' => 20],
|
||||
]],
|
||||
'1' => ['sessions' => [
|
||||
['active' => false, 'location_id' => $address->getId(), 'start_time' => '09:00', 'end_time' => '13:00', 'duration_per_patient' => 20],
|
||||
]],
|
||||
]));
|
||||
$this->em->flush();
|
||||
|
||||
$this->runBackfill(true, $this->pairOf($address));
|
||||
$this->runCalendarBackfill();
|
||||
$this->em->clear();
|
||||
|
||||
$doctorEntity = $this->em->getRepository(Doctor::class)->find($doctor->getId());
|
||||
$resource = $this->resources()->findForSubject($doctorEntity);
|
||||
|
||||
$calendars = static::getContainer()
|
||||
->get(\App\Resource\Repository\ResourceCalendarRepository::class)
|
||||
->findForResource($resource);
|
||||
|
||||
self::assertCount(2, $calendars, 'دو شیفت فعالِ شنبه؛ شیفت غیرفعال یکشنبه نمیآید');
|
||||
self::assertSame([0, 0], array_map(static fn ($c) => $c->getDayOfWeek(), $calendars));
|
||||
self::assertSame([540, 960], array_map(static fn ($c) => $c->getStartMinute(), $calendars));
|
||||
self::assertSame([0, 1], array_map(static fn ($c) => $c->getSequence(), $calendars));
|
||||
}
|
||||
|
||||
/** منبعی که کاربر خودش تنظیم کرده دست نمیخورد — همین idempotent بودن را میدهد. */
|
||||
public function testCalendarBackfillLeavesAnAlreadyConfiguredResourceAlone(): void
|
||||
{
|
||||
[$user, $doctor, $address] = $this->doctorWithAddress();
|
||||
|
||||
$this->em->persist($this->newWeeklySchedule($doctor, [
|
||||
'0' => ['sessions' => [
|
||||
['active' => true, 'location_id' => $address->getId(), 'start_time' => '09:00', 'end_time' => '13:00', 'duration_per_patient' => 20],
|
||||
]],
|
||||
]));
|
||||
$this->em->flush();
|
||||
|
||||
$this->runBackfill(true, $this->pairOf($address));
|
||||
$this->em->clear();
|
||||
|
||||
$doctorEntity = $this->em->getRepository(Doctor::class)->find($doctor->getId());
|
||||
$resource = $this->resources()->findForSubject($doctorEntity);
|
||||
|
||||
$this->authJson('PUT', "/api/v1/resource/{$resource->getUuid()}/calendar", $user, [
|
||||
'days' => [3 => [['start_minute' => 600, 'end_minute' => 660]]],
|
||||
]);
|
||||
self::assertSame(200, $this->responseCode());
|
||||
|
||||
$output = $this->runCalendarBackfill();
|
||||
self::assertStringContainsString('دستنخورده ماند', $output);
|
||||
|
||||
$this->em->clear();
|
||||
$calendars = static::getContainer()
|
||||
->get(\App\Resource\Repository\ResourceCalendarRepository::class)
|
||||
->findForResource($this->resources()->findByUuid($resource->getUuid()));
|
||||
|
||||
self::assertCount(1, $calendars);
|
||||
self::assertSame(3, $calendars[0]->getDayOfWeek(), 'تنظیم دستی کاربر سرِ جایش است');
|
||||
}
|
||||
|
||||
/** حداکثر یک پل: قید در سازنده است، چون MariaDB `CHECK` چندستونی را اجرا نمیکند. */
|
||||
public function testASecondBridgeIsRefused(): void
|
||||
{
|
||||
|
||||
@@ -0,0 +1,127 @@
|
||||
<?php
|
||||
|
||||
namespace App\Tests\Shared;
|
||||
|
||||
use App\Shared\Time\TimeInterval;
|
||||
use PHPUnit\Framework\TestCase;
|
||||
|
||||
/**
|
||||
* جبرِ بازه — واحد و بدون دیتابیس.
|
||||
*
|
||||
* قرارداد همهجا نیمباز `[start, end)` است؛ همین باعث میشود «۱۳:۰۰ پایان» و
|
||||
* «۱۳:۰۰ شروع» تداخل نداشته باشند.
|
||||
*/
|
||||
class TimeIntervalTest extends TestCase
|
||||
{
|
||||
/** @param list<array{int, int}> $pairs */
|
||||
private function set(array $pairs): array
|
||||
{
|
||||
return array_map(static fn (array $p): TimeInterval => new TimeInterval($p[0], $p[1]), $pairs);
|
||||
}
|
||||
|
||||
/** @return list<array{int, int}> */
|
||||
private function flatten(array $intervals): array
|
||||
{
|
||||
return array_map(static fn (TimeInterval $i): array => [$i->start, $i->end], $intervals);
|
||||
}
|
||||
|
||||
public function testEndMustBeAfterStart(): void
|
||||
{
|
||||
$this->expectException(\InvalidArgumentException::class);
|
||||
new TimeInterval(600, 600);
|
||||
}
|
||||
|
||||
public function testMergeJoinsOverlappingAndTouchingIntervals(): void
|
||||
{
|
||||
$merged = TimeInterval::mergeAll($this->set([[540, 780], [700, 900], [900, 960], [1200, 1260]]));
|
||||
|
||||
self::assertSame([[540, 960], [1200, 1260]], $this->flatten($merged));
|
||||
}
|
||||
|
||||
public function testMergeSortsUnorderedInput(): void
|
||||
{
|
||||
$merged = TimeInterval::mergeAll($this->set([[1200, 1260], [540, 600]]));
|
||||
|
||||
self::assertSame([[540, 600], [1200, 1260]], $this->flatten($merged));
|
||||
}
|
||||
|
||||
public function testIntersectKeepsOnlyTheCommonPart(): void
|
||||
{
|
||||
$result = TimeInterval::intersectAll(
|
||||
$this->set([[540, 1020]]),
|
||||
$this->set([[600, 720]]),
|
||||
);
|
||||
|
||||
self::assertSame([[600, 720]], $this->flatten($result));
|
||||
}
|
||||
|
||||
/** بازههای صرفاً چسبیده تقاطع ندارند — نیمباز بودن دقیقاً همین را میگوید. */
|
||||
public function testTouchingIntervalsDoNotIntersect(): void
|
||||
{
|
||||
$result = TimeInterval::intersectAll($this->set([[540, 780]]), $this->set([[780, 900]]));
|
||||
|
||||
self::assertSame([], $result);
|
||||
}
|
||||
|
||||
public function testIntersectOfDisjointSetsIsEmpty(): void
|
||||
{
|
||||
$result = TimeInterval::intersectAll($this->set([[540, 600]]), $this->set([[1080, 1200]]));
|
||||
|
||||
self::assertSame([], $result);
|
||||
}
|
||||
|
||||
/** بریدن از وسط، دو تکه میسازد و بقیهٔ روز سرِ جایش میماند. */
|
||||
public function testSubtractSplitsAnIntervalInTwo(): void
|
||||
{
|
||||
$result = TimeInterval::subtractAll($this->set([[540, 1020]]), $this->set([[600, 720]]));
|
||||
|
||||
self::assertSame([[540, 600], [720, 1020]], $this->flatten($result));
|
||||
}
|
||||
|
||||
public function testSubtractTrimsTheEdges(): void
|
||||
{
|
||||
self::assertSame(
|
||||
[[600, 1020]],
|
||||
$this->flatten(TimeInterval::subtractAll($this->set([[540, 1020]]), $this->set([[500, 600]]))),
|
||||
);
|
||||
|
||||
self::assertSame(
|
||||
[[540, 900]],
|
||||
$this->flatten(TimeInterval::subtractAll($this->set([[540, 1020]]), $this->set([[900, 1100]]))),
|
||||
);
|
||||
}
|
||||
|
||||
public function testSubtractCanEmptyTheSet(): void
|
||||
{
|
||||
self::assertSame([], TimeInterval::subtractAll($this->set([[540, 1020]]), $this->set([[400, 1200]])));
|
||||
}
|
||||
|
||||
/** دو مسدودکنندهٔ همپوشان اول اتحاد میشوند، بعد کسر — نه کسر پشتسرهم. */
|
||||
public function testOverlappingBlocksAreUnionedBeforeSubtracting(): void
|
||||
{
|
||||
$result = TimeInterval::subtractAll(
|
||||
$this->set([[540, 1020]]),
|
||||
$this->set([[600, 780], [720, 900]]),
|
||||
);
|
||||
|
||||
self::assertSame([[540, 600], [900, 1020]], $this->flatten($result));
|
||||
}
|
||||
|
||||
public function testSubtractingNothingReturnsTheInputMerged(): void
|
||||
{
|
||||
self::assertSame(
|
||||
[[540, 1020]],
|
||||
$this->flatten(TimeInterval::subtractAll($this->set([[540, 780], [780, 1020]]), [])),
|
||||
);
|
||||
}
|
||||
|
||||
/** تبدیل «دقیقه از نیمهشب» به timestamp — ضرب در ۶۰ باید صریح بماند. */
|
||||
public function testMinutesToAbsoluteMultipliesBySixty(): void
|
||||
{
|
||||
$absolute = (new TimeInterval(540, 1020))->minutesToAbsolute(1_000_000);
|
||||
|
||||
self::assertSame(1_000_000 + 540 * 60, $absolute->start);
|
||||
self::assertSame(1_000_000 + 1020 * 60, $absolute->end);
|
||||
self::assertSame(480 * 60, $absolute->end - $absolute->start);
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user