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>
189 lines
7.5 KiB
TypeScript
189 lines
7.5 KiB
TypeScript
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>
|
|
);
|
|
}
|