feat(resource): admin UI for resources, types, skills and pools, plus real API docs
Four pages on the existing design system: a resources list whose branch/type/skill/
status filters live in the URL and go straight to the server, and three supporting
pages for types, skills and pools. Filtering client-side over a list the server had
already filtered would have been a second source of truth, so the page does neither.
The pool members dialog only offers resources from the pool's own branch and type —
the same rule the server enforces with 422, applied early so the user never reaches
the error. Skill assignment and pool membership are both full replacements, and both
say so in the dialog, because a partial-looking save that silently drops rows is
worse than an explicit one.
Wiring that was missing: deactivating a staff member through
PATCH /api/v1/staff/{uuid}/toggle now closes their resource too. Without it an
inactive operator would still have shown up in availability search. It is an explicit
call rather than a Doctrine lifecycle callback, since callbacks do not fire for
getArrayResult() — which is how every admin list is built — and that asymmetry is
its own bug. The reverse does not hold: closing a resource does not deactivate the
person, who may be purely administrative.
docs/api/resource.md documents all sixteen endpoints with responses captured from
real curl runs against ddev, including the 422 bodies for person-capacity and
non-scalar attributes. staff.md gains a "relationship to resources" section stating
that job_title is not a skill. tenancy.md contrasts these aggregate children —
whose roots do carry a tenant pair — with the branch_working_hours case from task 01,
where the root was global and the classification was wrong.
Also fixed a pre-existing flaky test: NumericFieldNormalizerTest guarded its random
mobile against collision on the never-reset db_test but not its random national code,
so a full-suite run could fail with 422 and close the EntityManager, taking an
unrelated test down with it. Both are now guarded, and the assertion prints the
server's response instead of a bare "422 is not 201".
Verified: phpunit 1119 tests / 3113 assertions green; slot-mode frozen contract green;
phpstan 14 errors before and after, none in touched files; tsc clean; vitest 88 files
/ 617 tests green.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
hamed
@@ -77,6 +77,10 @@ import InventoryPage from './pages/InventoryPage';
|
||||
import BranchesPage from './pages/BranchesPage';
|
||||
import BranchWorkingHoursPage from './pages/BranchWorkingHoursPage';
|
||||
import BranchRoomsPage from './pages/BranchRoomsPage';
|
||||
import ResourcesPage from './pages/ResourcesPage';
|
||||
import ResourceTypesPage from './pages/ResourceTypesPage';
|
||||
import SkillsPage from './pages/SkillsPage';
|
||||
import ResourcePoolsPage from './pages/ResourcePoolsPage';
|
||||
import PatientRecordFormPage from './pages/PatientRecordFormPage';
|
||||
import PatientDetailPage from './pages/PatientDetailPage';
|
||||
import PaymentSuccessPage from './pages/PaymentSuccessPage';
|
||||
@@ -281,6 +285,10 @@ export default function App() {
|
||||
<Route path="branches" element={<RoleRoute roles={['doctor', 'clinic', 'secretary']} blockClinicScope permission={['appointment_settings', 'view']}><BranchesPage /></RoleRoute>} />
|
||||
<Route path="branches/:branchUuid/working-hours" element={<RoleRoute roles={['doctor', 'clinic', 'secretary']} blockClinicScope permission={['appointment_settings', 'view']}><BranchWorkingHoursPage /></RoleRoute>} />
|
||||
<Route path="branches/:branchUuid/rooms" element={<RoleRoute roles={['doctor', 'clinic', 'secretary']} blockClinicScope permission={['appointment_settings', 'view']}><BranchRoomsPage /></RoleRoute>} />
|
||||
<Route path="resources" element={<RoleRoute roles={['doctor', 'clinic', 'secretary']} blockClinicScope permission={['appointment_settings', 'view']}><ResourcesPage /></RoleRoute>} />
|
||||
<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="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>} />
|
||||
|
||||
@@ -2,7 +2,7 @@ import React from 'react';
|
||||
import {
|
||||
CreditCardIcon, UserIcon, CalendarDaysIcon, BuildingOffice2Icon,
|
||||
BanknotesIcon, UsersIcon, ShieldCheckIcon,
|
||||
TagIcon, ChatBubbleLeftRightIcon, UserCircleIcon, UserPlusIcon, ReceiptPercentIcon, MapPinIcon,
|
||||
TagIcon, ChatBubbleLeftRightIcon, UserCircleIcon, UserPlusIcon, ReceiptPercentIcon, MapPinIcon, CubeIcon,
|
||||
} from '@heroicons/react/24/outline';
|
||||
import PurchaseSubscriptionSidebar from './PurchaseSubscriptionSidebar';
|
||||
|
||||
@@ -30,6 +30,7 @@ export const SETTINGS_MENU: SettingsMenuItem[] = [
|
||||
{ key: 'appointment', label: 'مدیریت نوبت دهی', icon: CalendarDaysIcon, to: '/admin/settings/appointment-settings', roles: ['clinic'], perm: ['appointment_settings', 'view'] },
|
||||
{ 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: '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,205 @@
|
||||
import React, { useEffect, useState } from 'react';
|
||||
import Modal from '../ui/Modal';
|
||||
import SearchableSelect from '../ui/SearchableSelect';
|
||||
import type { Branch, ClinicResource, ResourcePayload, ResourceType } from '../../types';
|
||||
|
||||
/** کلیدهای شناختهشدهٔ ویژگی — قرارداد است نه اجبار؛ سرور هر کلید snake_case را میپذیرد. */
|
||||
const KNOWN_ATTRIBUTES = ['gender', 'device_model', 'floor', 'brand'];
|
||||
|
||||
type AttributeRow = { key: string; value: string };
|
||||
|
||||
interface Props {
|
||||
open: boolean;
|
||||
resource: ClinicResource | null;
|
||||
branches: Branch[];
|
||||
types: ResourceType[];
|
||||
saving: boolean;
|
||||
onClose: () => void;
|
||||
onSave: (payload: ResourcePayload) => void;
|
||||
}
|
||||
|
||||
export default function ResourceFormModal({
|
||||
open, resource, branches, types, saving, onClose, onSave,
|
||||
}: Props) {
|
||||
const [name, setName] = useState('');
|
||||
const [addressUuid, setAddressUuid] = useState<string | null>(null);
|
||||
const [typeUuid, setTypeUuid] = useState<string | null>(null);
|
||||
const [capacity, setCapacity] = useState('1');
|
||||
const [setupMinutes, setSetupMinutes] = useState('0');
|
||||
const [cleanupMinutes, setCleanupMinutes] = useState('0');
|
||||
const [active, setActive] = useState(true);
|
||||
const [attributes, setAttributes] = useState<AttributeRow[]>([]);
|
||||
|
||||
useEffect(() => {
|
||||
if (!open) return;
|
||||
setName(resource?.name ?? '');
|
||||
setAddressUuid(resource?.address_uuid ?? null);
|
||||
setTypeUuid(resource?.type_uuid ?? null);
|
||||
setCapacity(String(resource?.capacity ?? 1));
|
||||
setSetupMinutes(String(resource?.setup_minutes ?? 0));
|
||||
setCleanupMinutes(String(resource?.cleanup_minutes ?? 0));
|
||||
setActive(resource?.active ?? true);
|
||||
setAttributes(
|
||||
Object.entries(resource?.attributes ?? {}).map(([key, value]) => ({ key, value: String(value) })),
|
||||
);
|
||||
}, [open, resource]);
|
||||
|
||||
const isEdit = resource !== null;
|
||||
const parsedCapacity = Number(capacity);
|
||||
const invalid =
|
||||
name.trim() === '' ||
|
||||
(!isEdit && (!addressUuid || !typeUuid)) ||
|
||||
!Number.isFinite(parsedCapacity) ||
|
||||
parsedCapacity < 1;
|
||||
|
||||
const submit = () => {
|
||||
const attrs: Record<string, string> = {};
|
||||
attributes.forEach(({ key, value }) => {
|
||||
if (key.trim() !== '') attrs[key.trim()] = value;
|
||||
});
|
||||
|
||||
const payload: ResourcePayload = {
|
||||
name: name.trim(),
|
||||
capacity: parsedCapacity,
|
||||
setup_minutes: Number(setupMinutes) || 0,
|
||||
cleanup_minutes: Number(cleanupMinutes) || 0,
|
||||
attributes: attrs,
|
||||
active,
|
||||
};
|
||||
|
||||
// شعبه و نوع فقط هنگام ساخت فرستاده میشوند؛ جفت محیطِ منبع از آدرس مشتق شده و
|
||||
// جابهجا کردنش یعنی همان منبع در محیط دیگری ظاهر شود.
|
||||
if (!isEdit) {
|
||||
payload.address_uuid = addressUuid!;
|
||||
payload.type_uuid = typeUuid!;
|
||||
}
|
||||
|
||||
onSave(payload);
|
||||
};
|
||||
|
||||
return (
|
||||
<Modal open={open} onClose={onClose} title={isEdit ? 'ویرایش منبع' : 'افزودن منبع'} size="lg">
|
||||
<div style={{ display: 'grid', gap: 14 }}>
|
||||
<Field label="نام منبع">
|
||||
<input className="field" value={name} onChange={(e) => setName(e.target.value)} placeholder="لیزر آلکساندرایت ۱" />
|
||||
</Field>
|
||||
|
||||
<div style={{ display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(200px, 1fr))', gap: 12 }}>
|
||||
<Field label="شعبه">
|
||||
<SearchableSelect
|
||||
options={branches.map((b) => ({ value: b.uuid, label: b.name || 'بدون نام' }))}
|
||||
value={addressUuid}
|
||||
onChange={(v) => setAddressUuid(v ? String(v) : null)}
|
||||
placeholder="شعبه را انتخاب کنید"
|
||||
isDisabled={isEdit}
|
||||
height={38}
|
||||
/>
|
||||
</Field>
|
||||
<Field label="نوع منبع">
|
||||
<SearchableSelect
|
||||
options={types.map((t) => ({ value: t.uuid, label: t.name }))}
|
||||
value={typeUuid}
|
||||
onChange={(v) => setTypeUuid(v ? String(v) : null)}
|
||||
placeholder="نوع را انتخاب کنید"
|
||||
isDisabled={isEdit}
|
||||
height={38}
|
||||
/>
|
||||
</Field>
|
||||
</div>
|
||||
|
||||
{isEdit && (
|
||||
<p style={{ fontSize: 12, color: 'var(--text-3)', margin: 0 }}>
|
||||
شعبه و نوع منبع پس از ساخت تغییر نمیکنند؛ برای جابهجایی، منبع تازه بسازید.
|
||||
</p>
|
||||
)}
|
||||
|
||||
<div style={{ display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(160px, 1fr))', gap: 12 }}>
|
||||
<Field label="ظرفیت همزمان">
|
||||
<input className="field" type="number" min={1} value={capacity} onChange={(e) => setCapacity(e.target.value)} />
|
||||
</Field>
|
||||
<Field label="آمادهسازی (دقیقه)">
|
||||
<input className="field" type="number" min={0} value={setupMinutes} onChange={(e) => setSetupMinutes(e.target.value)} />
|
||||
</Field>
|
||||
<Field label="تمیزکاری (دقیقه)">
|
||||
<input className="field" type="number" min={0} value={cleanupMinutes} onChange={(e) => setCleanupMinutes(e.target.value)} />
|
||||
</Field>
|
||||
</div>
|
||||
|
||||
<p style={{ fontSize: 12, color: 'var(--text-3)', margin: 0 }}>
|
||||
ظرفیت یعنی چند بیمار همزمان — اتاق تزریق سهتخته یک منبع با ظرفیت ۳ است، نه سه منبع.
|
||||
آمادهسازی و تمیزکاری جزو نوبت بیمار نیستند ولی منبع را اشغال میکنند.
|
||||
</p>
|
||||
|
||||
<div style={{ display: 'grid', gap: 8 }}>
|
||||
<div style={{ display: 'flex', alignItems: 'center', justifyContent: 'space-between' }}>
|
||||
<label style={{ fontSize: 12, color: 'var(--text-2)' }}>ویژگیها (اختیاری)</label>
|
||||
<button
|
||||
type="button"
|
||||
className="btn secondary sm"
|
||||
onClick={() => setAttributes((a) => [...a, { key: '', value: '' }])}
|
||||
>
|
||||
افزودن ویژگی
|
||||
</button>
|
||||
</div>
|
||||
|
||||
{attributes.map((row, index) => (
|
||||
<div key={index} style={{ display: 'flex', gap: 8, alignItems: 'center' }}>
|
||||
<input
|
||||
className="field"
|
||||
list="resource-attribute-keys"
|
||||
value={row.key}
|
||||
placeholder="gender"
|
||||
onChange={(e) =>
|
||||
setAttributes((a) => a.map((r, i) => (i === index ? { ...r, key: e.target.value } : r)))
|
||||
}
|
||||
style={{ flex: 1 }}
|
||||
/>
|
||||
<input
|
||||
className="field"
|
||||
value={row.value}
|
||||
placeholder="female"
|
||||
onChange={(e) =>
|
||||
setAttributes((a) => a.map((r, i) => (i === index ? { ...r, value: e.target.value } : r)))
|
||||
}
|
||||
style={{ flex: 1 }}
|
||||
/>
|
||||
<button
|
||||
type="button"
|
||||
className="btn secondary sm"
|
||||
onClick={() => setAttributes((a) => a.filter((_, i) => i !== index))}
|
||||
aria-label="حذف ویژگی"
|
||||
>
|
||||
✕
|
||||
</button>
|
||||
</div>
|
||||
))}
|
||||
|
||||
<datalist id="resource-attribute-keys">
|
||||
{KNOWN_ATTRIBUTES.map((k) => <option key={k} value={k} />)}
|
||||
</datalist>
|
||||
</div>
|
||||
|
||||
<label style={{ display: 'flex', alignItems: 'center', gap: 8, fontSize: 13 }}>
|
||||
<input type="checkbox" checked={active} onChange={(e) => setActive(e.target.checked)} />
|
||||
منبع فعال است
|
||||
</label>
|
||||
|
||||
<div style={{ display: 'flex', justifyContent: 'flex-end', gap: 8, marginTop: 4 }}>
|
||||
<button type="button" className="btn secondary" onClick={onClose}>انصراف</button>
|
||||
<button type="button" className="btn primary" disabled={saving || invalid} onClick={submit}>
|
||||
{saving ? 'در حال ذخیره...' : 'ذخیره'}
|
||||
</button>
|
||||
</div>
|
||||
</div>
|
||||
</Modal>
|
||||
);
|
||||
}
|
||||
|
||||
function Field({ label, children }: { label: string; children: React.ReactNode }) {
|
||||
return (
|
||||
<div style={{ display: 'grid', gap: 6 }}>
|
||||
<label style={{ fontSize: 12, color: 'var(--text-2)' }}>{label}</label>
|
||||
{children}
|
||||
</div>
|
||||
);
|
||||
}
|
||||
@@ -0,0 +1,104 @@
|
||||
import React, { useEffect, useState } from 'react';
|
||||
import Modal from '../ui/Modal';
|
||||
import SearchableSelect from '../ui/SearchableSelect';
|
||||
import type { ClinicResource, Skill } from '../../types';
|
||||
|
||||
type Line = { skill_uuid: string; level: number };
|
||||
|
||||
interface Props {
|
||||
resource: ClinicResource | null;
|
||||
skills: Skill[];
|
||||
saving: boolean;
|
||||
onClose: () => void;
|
||||
onSave: (lines: Line[]) => void;
|
||||
}
|
||||
|
||||
/**
|
||||
* مهارتهای یک منبع. ذخیره یک PUT است و **جایگزینی کامل**: مهارتی که اینجا نباشد،
|
||||
* از منبع برداشته میشود.
|
||||
*/
|
||||
export default function ResourceSkillsModal({ resource, skills, saving, onClose, onSave }: Props) {
|
||||
const [lines, setLines] = useState<Line[]>([]);
|
||||
|
||||
useEffect(() => {
|
||||
if (!resource) return;
|
||||
setLines(resource.skills.map((s) => ({ skill_uuid: s.skill_uuid, level: s.level })));
|
||||
}, [resource]);
|
||||
|
||||
const chosen = new Set(lines.map((l) => l.skill_uuid));
|
||||
const available = skills.filter((s) => !chosen.has(s.uuid));
|
||||
|
||||
const nameOf = (uuid: string) => skills.find((s) => s.uuid === uuid)?.name ?? uuid;
|
||||
|
||||
return (
|
||||
<Modal
|
||||
open={resource !== null}
|
||||
onClose={onClose}
|
||||
title={`مهارتهای ${resource?.name ?? 'منبع'}`}
|
||||
>
|
||||
<div style={{ display: 'grid', gap: 14 }}>
|
||||
{skills.length === 0 && (
|
||||
<p style={{ fontSize: 13, color: 'var(--text-3)', margin: 0 }}>
|
||||
هنوز هیچ مهارتی تعریف نشده است. اول از صفحهٔ «مهارتها» یکی بسازید.
|
||||
</p>
|
||||
)}
|
||||
|
||||
{lines.length === 0 ? (
|
||||
<p style={{ fontSize: 13, color: 'var(--text-3)', margin: 0 }}>این منبع هیچ مهارتی ندارد.</p>
|
||||
) : (
|
||||
<div style={{ display: 'grid', gap: 8 }}>
|
||||
{lines.map((line, index) => (
|
||||
<div key={line.skill_uuid} style={{ display: 'flex', alignItems: 'center', gap: 10 }}>
|
||||
<span style={{ flex: 1, fontSize: 13, fontWeight: 600 }}>{nameOf(line.skill_uuid)}</span>
|
||||
<label style={{ fontSize: 12, color: 'var(--text-3)' }}>سطح</label>
|
||||
<div style={{ width: 92 }}>
|
||||
<SearchableSelect
|
||||
options={[1, 2, 3, 4, 5].map((lv) => ({ value: String(lv), label: String(lv) }))}
|
||||
value={String(line.level)}
|
||||
onChange={(v) =>
|
||||
setLines((l) => l.map((x, i) => (i === index ? { ...x, level: Number(v) || 1 } : x)))
|
||||
}
|
||||
placeholder="سطح"
|
||||
height={36}
|
||||
/>
|
||||
</div>
|
||||
<button
|
||||
type="button"
|
||||
className="btn secondary sm"
|
||||
onClick={() => setLines((l) => l.filter((_, i) => i !== index))}
|
||||
aria-label={`حذف ${nameOf(line.skill_uuid)}`}
|
||||
>
|
||||
✕
|
||||
</button>
|
||||
</div>
|
||||
))}
|
||||
</div>
|
||||
)}
|
||||
|
||||
{available.length > 0 && (
|
||||
<div style={{ display: 'grid', gap: 6 }}>
|
||||
<label style={{ fontSize: 12, color: 'var(--text-2)' }}>افزودن مهارت</label>
|
||||
<SearchableSelect
|
||||
options={available.map((s) => ({ value: s.uuid, label: s.name }))}
|
||||
value={null}
|
||||
onChange={(v) => v && setLines((l) => [...l, { skill_uuid: String(v), level: 1 }])}
|
||||
placeholder="یک مهارت انتخاب کنید"
|
||||
height={38}
|
||||
/>
|
||||
</div>
|
||||
)}
|
||||
|
||||
<p style={{ fontSize: 12, color: 'var(--text-3)', margin: 0 }}>
|
||||
ذخیره کل فهرست را جایگزین میکند؛ مهارتی که اینجا نباشد از منبع برداشته میشود.
|
||||
</p>
|
||||
|
||||
<div style={{ display: 'flex', justifyContent: 'flex-end', gap: 8 }}>
|
||||
<button type="button" className="btn secondary" onClick={onClose}>انصراف</button>
|
||||
<button type="button" className="btn primary" disabled={saving} onClick={() => onSave(lines)}>
|
||||
{saving ? 'در حال ذخیره...' : 'ذخیره'}
|
||||
</button>
|
||||
</div>
|
||||
</div>
|
||||
</Modal>
|
||||
);
|
||||
}
|
||||
@@ -0,0 +1,182 @@
|
||||
import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
|
||||
import { toast } from 'sonner';
|
||||
import { api, ApiError, type ApiResponse } from '../lib/api';
|
||||
import type {
|
||||
ClinicResource, ResourcePool, ResourcePayload, ResourceType, Skill,
|
||||
} from '../types';
|
||||
|
||||
/**
|
||||
* منابع: هر چیزی که ممکن است اشغال باشد. هر منبع مال یک شعبه است، و شعبه همان
|
||||
* آدرس محل نوبتدهی است — پس فیلترها با `address_uuid` کار میکنند نه `branch_id`.
|
||||
*/
|
||||
const RESOURCES_KEY = 'resources';
|
||||
const TYPES_KEY = ['resource-types'];
|
||||
const SKILLS_KEY = ['skills'];
|
||||
const POOLS_KEY = ['resource-pools'];
|
||||
|
||||
function fail(e: unknown, fallback: string) {
|
||||
toast.error(e instanceof ApiError ? e.message : fallback);
|
||||
}
|
||||
|
||||
export type ResourceFilters = {
|
||||
address_uuid?: string;
|
||||
type_uuid?: string;
|
||||
skill_uuid?: string;
|
||||
active?: string;
|
||||
};
|
||||
|
||||
function toQuery(filters: ResourceFilters): string {
|
||||
const params = new URLSearchParams();
|
||||
Object.entries(filters).forEach(([k, v]) => {
|
||||
if (v) params.set(k, v);
|
||||
});
|
||||
const qs = params.toString();
|
||||
return qs === '' ? '' : `?${qs}`;
|
||||
}
|
||||
|
||||
export function useResources(filters: ResourceFilters = {}) {
|
||||
const qc = useQueryClient();
|
||||
const invalidate = () => qc.invalidateQueries({ queryKey: [RESOURCES_KEY] });
|
||||
|
||||
const query = useQuery({
|
||||
queryKey: [RESOURCES_KEY, filters],
|
||||
queryFn: () => api.get<ApiResponse<ClinicResource[]>>(`/api/v1/resources${toQuery(filters)}`),
|
||||
});
|
||||
|
||||
const create = useMutation({
|
||||
mutationFn: (d: ResourcePayload) => api.post<ApiResponse<ClinicResource>>('/api/v1/resource', d),
|
||||
onSuccess: () => { toast.success('منبع افزوده شد'); invalidate(); },
|
||||
onError: (e) => fail(e, 'افزودن منبع ناموفق بود'),
|
||||
});
|
||||
|
||||
const update = useMutation({
|
||||
mutationFn: ({ uuid, d }: { uuid: string; d: ResourcePayload }) =>
|
||||
api.patch<ApiResponse<ClinicResource>>(`/api/v1/resource/${uuid}`, d),
|
||||
onSuccess: () => { toast.success('منبع بهروزرسانی شد'); invalidate(); },
|
||||
onError: (e) => fail(e, 'بهروزرسانی منبع ناموفق بود'),
|
||||
});
|
||||
|
||||
const remove = useMutation({
|
||||
mutationFn: (uuid: string) => api.delete<ApiResponse<null>>(`/api/v1/resource/${uuid}`),
|
||||
onSuccess: () => { toast.success('منبع حذف شد'); invalidate(); },
|
||||
onError: (e) => fail(e, 'حذف منبع ناموفق بود'),
|
||||
});
|
||||
|
||||
/** جایگزینی کامل: مهارتی که در بدنه نیست، برداشته میشود. */
|
||||
const setSkills = useMutation({
|
||||
mutationFn: ({ uuid, skills }: { uuid: string; skills: { skill_uuid: string; level: number }[] }) =>
|
||||
api.put<ApiResponse<ClinicResource>>(`/api/v1/resource/${uuid}/skills`, { skills }),
|
||||
onSuccess: () => { toast.success('مهارتها ذخیره شد'); invalidate(); },
|
||||
onError: (e) => fail(e, 'ذخیرهٔ مهارتها ناموفق بود'),
|
||||
});
|
||||
|
||||
return {
|
||||
resources: query.data?.data ?? [],
|
||||
loading: query.isLoading,
|
||||
create, update, remove, setSkills,
|
||||
};
|
||||
}
|
||||
|
||||
export function useResourceTypes() {
|
||||
const qc = useQueryClient();
|
||||
const invalidate = () => qc.invalidateQueries({ queryKey: TYPES_KEY });
|
||||
|
||||
const query = useQuery({
|
||||
queryKey: TYPES_KEY,
|
||||
queryFn: () => api.get<ApiResponse<ResourceType[]>>('/api/v1/resource-types'),
|
||||
});
|
||||
|
||||
const create = useMutation({
|
||||
mutationFn: (d: { code: string; name: string }) =>
|
||||
api.post<ApiResponse<ResourceType>>('/api/v1/resource-types', d),
|
||||
onSuccess: () => { toast.success('نوع منبع افزوده شد'); invalidate(); },
|
||||
onError: (e) => fail(e, 'افزودن نوع منبع ناموفق بود'),
|
||||
});
|
||||
|
||||
const update = useMutation({
|
||||
mutationFn: ({ uuid, d }: { uuid: string; d: { name?: string; active?: boolean } }) =>
|
||||
api.patch<ApiResponse<ResourceType>>(`/api/v1/resource-type/${uuid}`, d),
|
||||
onSuccess: () => { toast.success('نوع منبع بهروزرسانی شد'); invalidate(); },
|
||||
onError: (e) => fail(e, 'بهروزرسانی ناموفق بود'),
|
||||
});
|
||||
|
||||
const remove = useMutation({
|
||||
mutationFn: (uuid: string) => api.delete<ApiResponse<null>>(`/api/v1/resource-type/${uuid}`),
|
||||
onSuccess: () => { toast.success('نوع منبع حذف شد'); invalidate(); },
|
||||
onError: (e) => fail(e, 'حذف نوع منبع ناموفق بود'),
|
||||
});
|
||||
|
||||
return { types: query.data?.data ?? [], loading: query.isLoading, create, update, remove };
|
||||
}
|
||||
|
||||
export function useSkills() {
|
||||
const qc = useQueryClient();
|
||||
const invalidate = () => qc.invalidateQueries({ queryKey: SKILLS_KEY });
|
||||
|
||||
const query = useQuery({
|
||||
queryKey: SKILLS_KEY,
|
||||
queryFn: () => api.get<ApiResponse<Skill[]>>('/api/v1/skills'),
|
||||
});
|
||||
|
||||
const create = useMutation({
|
||||
mutationFn: (d: { name: string }) => api.post<ApiResponse<Skill>>('/api/v1/skills', d),
|
||||
onSuccess: () => { toast.success('مهارت افزوده شد'); invalidate(); },
|
||||
onError: (e) => fail(e, 'افزودن مهارت ناموفق بود'),
|
||||
});
|
||||
|
||||
const update = useMutation({
|
||||
mutationFn: ({ uuid, d }: { uuid: string; d: { name?: string; active?: boolean } }) =>
|
||||
api.patch<ApiResponse<Skill>>(`/api/v1/skill/${uuid}`, d),
|
||||
onSuccess: () => { toast.success('مهارت بهروزرسانی شد'); invalidate(); },
|
||||
onError: (e) => fail(e, 'بهروزرسانی ناموفق بود'),
|
||||
});
|
||||
|
||||
const remove = useMutation({
|
||||
mutationFn: (uuid: string) => api.delete<ApiResponse<null>>(`/api/v1/skill/${uuid}`),
|
||||
onSuccess: () => { toast.success('مهارت حذف شد'); invalidate(); },
|
||||
// پیام سرور دقیق است («به N منبع داده شده»)، پس همان نشان داده میشود.
|
||||
onError: (e) => fail(e, 'حذف مهارت ناموفق بود'),
|
||||
});
|
||||
|
||||
return { skills: query.data?.data ?? [], loading: query.isLoading, create, update, remove };
|
||||
}
|
||||
|
||||
export function useResourcePools() {
|
||||
const qc = useQueryClient();
|
||||
const invalidate = () => qc.invalidateQueries({ queryKey: POOLS_KEY });
|
||||
|
||||
const query = useQuery({
|
||||
queryKey: POOLS_KEY,
|
||||
queryFn: () => api.get<ApiResponse<ResourcePool[]>>('/api/v1/resource-pools'),
|
||||
});
|
||||
|
||||
const create = useMutation({
|
||||
mutationFn: (d: { address_uuid: string; type_uuid: string; name: string }) =>
|
||||
api.post<ApiResponse<ResourcePool>>('/api/v1/resource-pools', d),
|
||||
onSuccess: () => { toast.success('استخر افزوده شد'); invalidate(); },
|
||||
onError: (e) => fail(e, 'افزودن استخر ناموفق بود'),
|
||||
});
|
||||
|
||||
const update = useMutation({
|
||||
mutationFn: ({ uuid, d }: { uuid: string; d: { name?: string; active?: boolean } }) =>
|
||||
api.patch<ApiResponse<ResourcePool>>(`/api/v1/resource-pool/${uuid}`, d),
|
||||
onSuccess: () => { toast.success('استخر بهروزرسانی شد'); invalidate(); },
|
||||
onError: (e) => fail(e, 'بهروزرسانی ناموفق بود'),
|
||||
});
|
||||
|
||||
const remove = useMutation({
|
||||
mutationFn: (uuid: string) => api.delete<ApiResponse<null>>(`/api/v1/resource-pool/${uuid}`),
|
||||
onSuccess: () => { toast.success('استخر حذف شد'); invalidate(); },
|
||||
onError: (e) => fail(e, 'حذف استخر ناموفق بود'),
|
||||
});
|
||||
|
||||
/** جایگزینی کامل اعضا؛ سرور همشعبه و همنوع بودن را اجبار میکند. */
|
||||
const setMembers = useMutation({
|
||||
mutationFn: ({ uuid, members }: { uuid: string; members: { resource_uuid: string; priority: number }[] }) =>
|
||||
api.put<ApiResponse<ResourcePool>>(`/api/v1/resource-pool/${uuid}/members`, { members }),
|
||||
onSuccess: () => { toast.success('اعضای استخر ذخیره شد'); invalidate(); },
|
||||
onError: (e) => fail(e, 'ذخیرهٔ اعضا ناموفق بود'),
|
||||
});
|
||||
|
||||
return { pools: query.data?.data ?? [], loading: query.isLoading, create, update, remove, setMembers };
|
||||
}
|
||||
@@ -0,0 +1,316 @@
|
||||
import React, { useEffect, useMemo, useState } from 'react';
|
||||
import { PlusIcon } from '@heroicons/react/24/outline';
|
||||
import PageHeader from '../components/ui/PageHeader';
|
||||
import DataTable, { type Column } from '../components/ui/DataTable';
|
||||
import Modal from '../components/ui/Modal';
|
||||
import ConfirmDialog from '../components/ui/ConfirmDialog';
|
||||
import SearchableSelect from '../components/ui/SearchableSelect';
|
||||
import { ActiveBadge } from '../components/ui/StatusBadge';
|
||||
import { useUrlState } from '../hooks/useUrlState';
|
||||
import { usePermissions } from '../hooks/usePermissions';
|
||||
import { useBranches } from '../hooks/useBranches';
|
||||
import { useResourcePools, useResources, useResourceTypes } from '../hooks/useResources';
|
||||
import type { ResourcePool } from '../types';
|
||||
|
||||
/**
|
||||
* استخر منابع — گروهی از منابع که جایگزین کامل یکدیگرند.
|
||||
*
|
||||
* اعضا باید همشعبه و همنوعِ خودِ استخر باشند؛ سرور این را اجبار میکند و فرم هم
|
||||
* فهرست انتخاب را به همانها محدود میکند تا کاربر به خطای ۴۲۲ نخورد.
|
||||
*/
|
||||
export default function ResourcePoolsPage() {
|
||||
const { pools, loading, create, update, remove, setMembers } = useResourcePools();
|
||||
const { branches } = useBranches();
|
||||
const { types } = useResourceTypes();
|
||||
const { can } = usePermissions();
|
||||
const canUpdate = can('appointment_settings', 'update');
|
||||
|
||||
const [urlState, setUrlState] = useUrlState({ search: '' });
|
||||
const [creating, setCreating] = useState(false);
|
||||
const [membersFor, setMembersFor] = useState<ResourcePool | null>(null);
|
||||
const [toDelete, setToDelete] = useState<ResourcePool | null>(null);
|
||||
|
||||
const rows = useMemo(() => {
|
||||
const q = urlState.search.trim();
|
||||
return q === '' ? pools : pools.filter((p) => `${p.name} ${p.type_name}`.includes(q));
|
||||
}, [pools, urlState.search]);
|
||||
|
||||
const columns: Column<ResourcePool>[] = [
|
||||
{
|
||||
key: 'name',
|
||||
header: 'استخر',
|
||||
render: (p) => (
|
||||
<div style={{ display: 'flex', flexDirection: 'column', gap: 2 }}>
|
||||
<span style={{ fontWeight: 600 }}>{p.name}</span>
|
||||
<span style={{ fontSize: 12, color: 'var(--text-3)' }}>{p.type_name}</span>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{ key: 'address_name', header: 'شعبه', render: (p) => <span style={{ fontSize: 13 }}>{p.address_name || '—'}</span> },
|
||||
{
|
||||
key: 'members',
|
||||
header: 'اعضا',
|
||||
render: (p) =>
|
||||
p.members.length === 0 ? (
|
||||
<span style={{ fontSize: 12, color: 'var(--text-3)' }}>بدون عضو</span>
|
||||
) : (
|
||||
<div style={{ display: 'flex', gap: 4, flexWrap: 'wrap' }}>
|
||||
{p.members.map((m) => (
|
||||
<span key={m.resource_uuid} className="badge blue" style={{ fontSize: 11 }}>{m.resource_name}</span>
|
||||
))}
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{ key: 'active', header: 'وضعیت', render: (p) => <ActiveBadge active={p.active} /> },
|
||||
];
|
||||
|
||||
return (
|
||||
<div className="fade-in">
|
||||
<PageHeader
|
||||
title="استخر منابع"
|
||||
description="منابعی که جایگزین کامل یکدیگرند — مثل «لیزرهای آلکساندرایت». همهٔ اعضا باید در یک شعبه و از یک نوع باشند."
|
||||
backTo="/admin/resources"
|
||||
breadcrumbs={[{ label: 'منابع', to: '/admin/resources' }, { label: 'استخر منابع' }]}
|
||||
action={
|
||||
canUpdate ? (
|
||||
<button type="button" className="btn primary" onClick={() => setCreating(true)}>
|
||||
<PlusIcon style={{ width: 16 }} /> افزودن استخر
|
||||
</button>
|
||||
) : undefined
|
||||
}
|
||||
/>
|
||||
|
||||
<DataTable
|
||||
columns={columns}
|
||||
data={rows}
|
||||
loading={loading}
|
||||
searchValue={urlState.search}
|
||||
onSearchChange={(v) => setUrlState({ search: v })}
|
||||
searchPlaceholder="جستجو در استخرها..."
|
||||
emptyMessage="هنوز استخری تعریف نشده است"
|
||||
actions={
|
||||
canUpdate
|
||||
? (p) => (
|
||||
<div style={{ display: 'flex', gap: 6 }}>
|
||||
<button type="button" className="btn secondary sm" onClick={() => setMembersFor(p)}>
|
||||
اعضا
|
||||
</button>
|
||||
<button
|
||||
type="button"
|
||||
className="btn secondary sm"
|
||||
onClick={() => update.mutate({ uuid: p.uuid, d: { active: !p.active } })}
|
||||
>
|
||||
{p.active ? 'غیرفعال کردن' : 'فعال کردن'}
|
||||
</button>
|
||||
<button type="button" className="btn secondary sm" onClick={() => setToDelete(p)}>
|
||||
حذف
|
||||
</button>
|
||||
</div>
|
||||
)
|
||||
: undefined
|
||||
}
|
||||
/>
|
||||
|
||||
<CreatePoolModal
|
||||
open={creating}
|
||||
branches={branches}
|
||||
types={types}
|
||||
saving={create.isPending}
|
||||
onClose={() => setCreating(false)}
|
||||
onSave={(payload) => create.mutate(payload, { onSuccess: () => setCreating(false) })}
|
||||
/>
|
||||
|
||||
<PoolMembersModal
|
||||
pool={membersFor}
|
||||
saving={setMembers.isPending}
|
||||
onClose={() => setMembersFor(null)}
|
||||
onSave={(members) =>
|
||||
membersFor &&
|
||||
setMembers.mutate({ uuid: membersFor.uuid, members }, { onSuccess: () => setMembersFor(null) })
|
||||
}
|
||||
/>
|
||||
|
||||
<ConfirmDialog
|
||||
open={!!toDelete}
|
||||
title="حذف استخر"
|
||||
message={`آیا از حذف «${toDelete?.name}» مطمئن هستید؟ منابع عضو حذف نمیشوند.`}
|
||||
confirmLabel="حذف"
|
||||
loading={remove.isPending}
|
||||
onConfirm={() => toDelete && remove.mutate(toDelete.uuid, { onSuccess: () => setToDelete(null) })}
|
||||
onCancel={() => setToDelete(null)}
|
||||
/>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function CreatePoolModal({
|
||||
open, branches, types, saving, onClose, onSave,
|
||||
}: {
|
||||
open: boolean;
|
||||
branches: ReturnType<typeof useBranches>['branches'];
|
||||
types: ReturnType<typeof useResourceTypes>['types'];
|
||||
saving: boolean;
|
||||
onClose: () => void;
|
||||
onSave: (payload: { address_uuid: string; type_uuid: string; name: string }) => void;
|
||||
}) {
|
||||
const [name, setName] = useState('');
|
||||
const [addressUuid, setAddressUuid] = useState<string | null>(null);
|
||||
const [typeUuid, setTypeUuid] = useState<string | null>(null);
|
||||
|
||||
useEffect(() => {
|
||||
if (!open) return;
|
||||
setName('');
|
||||
setAddressUuid(null);
|
||||
setTypeUuid(null);
|
||||
}, [open]);
|
||||
|
||||
const invalid = name.trim() === '' || !addressUuid || !typeUuid;
|
||||
|
||||
return (
|
||||
<Modal open={open} onClose={onClose} title="افزودن استخر منابع">
|
||||
<div style={{ display: 'grid', gap: 14 }}>
|
||||
<div style={{ display: 'grid', gap: 6 }}>
|
||||
<label style={{ fontSize: 12, color: 'var(--text-2)' }}>نام استخر</label>
|
||||
<input className="field" value={name} onChange={(e) => setName(e.target.value)} placeholder="لیزرهای آلکساندرایت" />
|
||||
</div>
|
||||
|
||||
<div style={{ display: 'grid', gap: 6 }}>
|
||||
<label style={{ fontSize: 12, color: 'var(--text-2)' }}>شعبه</label>
|
||||
<SearchableSelect
|
||||
options={branches.map((b) => ({ value: b.uuid, label: b.name || 'بدون نام' }))}
|
||||
value={addressUuid}
|
||||
onChange={(v) => setAddressUuid(v ? String(v) : null)}
|
||||
placeholder="شعبه را انتخاب کنید"
|
||||
height={38}
|
||||
/>
|
||||
</div>
|
||||
|
||||
<div style={{ display: 'grid', gap: 6 }}>
|
||||
<label style={{ fontSize: 12, color: 'var(--text-2)' }}>نوع منبع</label>
|
||||
<SearchableSelect
|
||||
options={types.map((t) => ({ value: t.uuid, label: t.name }))}
|
||||
value={typeUuid}
|
||||
onChange={(v) => setTypeUuid(v ? String(v) : null)}
|
||||
placeholder="نوع را انتخاب کنید"
|
||||
height={38}
|
||||
/>
|
||||
</div>
|
||||
|
||||
<p style={{ fontSize: 12, color: 'var(--text-3)', margin: 0 }}>
|
||||
شعبه و نوع پس از ساخت تغییر نمیکنند — اعضا باید با هر دو بخوانند.
|
||||
</p>
|
||||
|
||||
<div style={{ display: 'flex', justifyContent: 'flex-end', gap: 8 }}>
|
||||
<button type="button" className="btn secondary" onClick={onClose}>انصراف</button>
|
||||
<button
|
||||
type="button"
|
||||
className="btn primary"
|
||||
disabled={saving || invalid}
|
||||
onClick={() => onSave({ address_uuid: addressUuid!, type_uuid: typeUuid!, name: name.trim() })}
|
||||
>
|
||||
{saving ? 'در حال ذخیره...' : 'ذخیره'}
|
||||
</button>
|
||||
</div>
|
||||
</div>
|
||||
</Modal>
|
||||
);
|
||||
}
|
||||
|
||||
function PoolMembersModal({
|
||||
pool, saving, onClose, onSave,
|
||||
}: {
|
||||
pool: ResourcePool | null;
|
||||
saving: boolean;
|
||||
onClose: () => void;
|
||||
onSave: (members: { resource_uuid: string; priority: number }[]) => void;
|
||||
}) {
|
||||
const [chosen, setChosen] = useState<string[]>([]);
|
||||
|
||||
// فهرست انتخاب به همان شعبه و نوعِ استخر محدود است — همان قاعدهای که سرور با ۴۲۲
|
||||
// اجبار میکند، پس کاربر اصلاً به آن خطا نمیخورد.
|
||||
const { resources } = useResources(
|
||||
pool ? { address_uuid: pool.address_uuid, type_uuid: pool.type_uuid } : {},
|
||||
);
|
||||
|
||||
useEffect(() => {
|
||||
if (!pool) return;
|
||||
setChosen(pool.members.map((m) => m.resource_uuid));
|
||||
}, [pool]);
|
||||
|
||||
const nameOf = (uuid: string) => resources.find((r) => r.uuid === uuid)?.name
|
||||
?? pool?.members.find((m) => m.resource_uuid === uuid)?.resource_name
|
||||
?? uuid;
|
||||
|
||||
const available = resources.filter((r) => !chosen.includes(r.uuid));
|
||||
|
||||
return (
|
||||
<Modal open={pool !== null} onClose={onClose} title={`اعضای ${pool?.name ?? 'استخر'}`}>
|
||||
<div style={{ display: 'grid', gap: 14 }}>
|
||||
{chosen.length === 0 ? (
|
||||
<p style={{ fontSize: 13, color: 'var(--text-3)', margin: 0 }}>
|
||||
این استخر عضوی ندارد. استخر بدون عضو معتبر است، ولی در انتخاب منبع «هیچ منبعی» دیده میشود.
|
||||
</p>
|
||||
) : (
|
||||
<div style={{ display: 'grid', gap: 8 }}>
|
||||
{chosen.map((uuid, index) => (
|
||||
<div key={uuid} style={{ display: 'flex', alignItems: 'center', gap: 10 }}>
|
||||
<span style={{ fontSize: 12, color: 'var(--text-3)', width: 24 }}>{index + 1}</span>
|
||||
<span style={{ flex: 1, fontSize: 13, fontWeight: 600 }}>{nameOf(uuid)}</span>
|
||||
<button
|
||||
type="button"
|
||||
className="btn secondary sm"
|
||||
disabled={index === 0}
|
||||
onClick={() => setChosen((c) => {
|
||||
const next = [...c];
|
||||
[next[index - 1], next[index]] = [next[index], next[index - 1]];
|
||||
return next;
|
||||
})}
|
||||
aria-label={`بالا بردن ${nameOf(uuid)}`}
|
||||
>
|
||||
↑
|
||||
</button>
|
||||
<button
|
||||
type="button"
|
||||
className="btn secondary sm"
|
||||
onClick={() => setChosen((c) => c.filter((x) => x !== uuid))}
|
||||
aria-label={`حذف ${nameOf(uuid)}`}
|
||||
>
|
||||
✕
|
||||
</button>
|
||||
</div>
|
||||
))}
|
||||
</div>
|
||||
)}
|
||||
|
||||
{available.length > 0 && (
|
||||
<div style={{ display: 'grid', gap: 6 }}>
|
||||
<label style={{ fontSize: 12, color: 'var(--text-2)' }}>افزودن عضو</label>
|
||||
<SearchableSelect
|
||||
options={available.map((r) => ({ value: r.uuid, label: r.name }))}
|
||||
value={null}
|
||||
onChange={(v) => v && setChosen((c) => [...c, String(v)])}
|
||||
placeholder="یک منبع انتخاب کنید"
|
||||
height={38}
|
||||
/>
|
||||
</div>
|
||||
)}
|
||||
|
||||
<p style={{ fontSize: 12, color: 'var(--text-3)', margin: 0 }}>
|
||||
ترتیب همان اولویت انتخاب است. ذخیره کل فهرست را جایگزین میکند.
|
||||
</p>
|
||||
|
||||
<div style={{ display: 'flex', justifyContent: 'flex-end', gap: 8 }}>
|
||||
<button type="button" className="btn secondary" onClick={onClose}>انصراف</button>
|
||||
<button
|
||||
type="button"
|
||||
className="btn primary"
|
||||
disabled={saving}
|
||||
onClick={() => onSave(chosen.map((uuid, index) => ({ resource_uuid: uuid, priority: index })))}
|
||||
>
|
||||
{saving ? 'در حال ذخیره...' : 'ذخیره'}
|
||||
</button>
|
||||
</div>
|
||||
</div>
|
||||
</Modal>
|
||||
);
|
||||
}
|
||||
@@ -0,0 +1,188 @@
|
||||
import React, { useMemo, useState } from 'react';
|
||||
import { PlusIcon } from '@heroicons/react/24/outline';
|
||||
import PageHeader from '../components/ui/PageHeader';
|
||||
import DataTable, { type Column } from '../components/ui/DataTable';
|
||||
import Modal from '../components/ui/Modal';
|
||||
import ConfirmDialog from '../components/ui/ConfirmDialog';
|
||||
import { ActiveBadge } from '../components/ui/StatusBadge';
|
||||
import { useUrlState } from '../hooks/useUrlState';
|
||||
import { usePermissions } from '../hooks/usePermissions';
|
||||
import { useResourceTypes } from '../hooks/useResources';
|
||||
import type { ResourceType } from '../types';
|
||||
|
||||
/** نوع منبع — کلینیک خودش تعریفش میکند؛ سه نوع سیستمی را backfill میسازد. */
|
||||
export default function ResourceTypesPage() {
|
||||
const { types, loading, create, update, remove } = useResourceTypes();
|
||||
const { can } = usePermissions();
|
||||
const canUpdate = can('appointment_settings', 'update');
|
||||
|
||||
const [urlState, setUrlState] = useUrlState({ search: '' });
|
||||
const [editing, setEditing] = useState<{ open: boolean; type: ResourceType | null }>({ open: false, type: null });
|
||||
const [toDelete, setToDelete] = useState<ResourceType | null>(null);
|
||||
|
||||
const rows = useMemo(() => {
|
||||
const q = urlState.search.trim();
|
||||
return q === '' ? types : types.filter((t) => `${t.name} ${t.code}`.includes(q));
|
||||
}, [types, urlState.search]);
|
||||
|
||||
const columns: Column<ResourceType>[] = [
|
||||
{
|
||||
key: 'name',
|
||||
header: 'نوع منبع',
|
||||
render: (t) => (
|
||||
<div style={{ display: 'flex', alignItems: 'center', gap: 8 }}>
|
||||
<span style={{ fontWeight: 600 }}>{t.name}</span>
|
||||
{t.is_system && <span className="badge gray" style={{ fontSize: 11 }}>سیستمی</span>}
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{ key: 'code', header: 'کد', render: (t) => <code style={{ fontSize: 12, direction: 'ltr' }}>{t.code}</code> },
|
||||
{ key: 'resources_count', header: 'تعداد منبع', render: (t) => <span style={{ fontSize: 13 }}>{t.resources_count ?? 0}</span> },
|
||||
{ key: 'active', header: 'وضعیت', render: (t) => <ActiveBadge active={t.active} /> },
|
||||
];
|
||||
|
||||
return (
|
||||
<div className="fade-in">
|
||||
<PageHeader
|
||||
title="نوع منابع"
|
||||
description="دستهبندی منابع: پزشک، پرسنل، اتاق، دستگاه لیزر، یونیت. نوعهای سیستمی حذف نمیشوند چون پل خودکار منابع به آنها تکیه دارد."
|
||||
backTo="/admin/resources"
|
||||
breadcrumbs={[{ label: 'منابع', to: '/admin/resources' }, { label: 'نوع منابع' }]}
|
||||
action={
|
||||
canUpdate ? (
|
||||
<button type="button" className="btn primary" onClick={() => setEditing({ open: true, type: null })}>
|
||||
<PlusIcon style={{ width: 16 }} /> افزودن نوع
|
||||
</button>
|
||||
) : undefined
|
||||
}
|
||||
/>
|
||||
|
||||
<DataTable
|
||||
columns={columns}
|
||||
data={rows}
|
||||
loading={loading}
|
||||
searchValue={urlState.search}
|
||||
onSearchChange={(v) => setUrlState({ search: v })}
|
||||
searchPlaceholder="جستجو در نوع منابع..."
|
||||
emptyMessage="هنوز نوع منبعی تعریف نشده است"
|
||||
actions={
|
||||
canUpdate
|
||||
? (t) => (
|
||||
<div style={{ display: 'flex', gap: 6 }}>
|
||||
<button type="button" className="btn secondary sm" onClick={() => setEditing({ open: true, type: t })}>
|
||||
ویرایش
|
||||
</button>
|
||||
<button
|
||||
type="button"
|
||||
className="btn secondary sm"
|
||||
disabled={t.is_system}
|
||||
title={t.is_system ? 'نوع سیستمی حذف نمیشود' : undefined}
|
||||
onClick={() => setToDelete(t)}
|
||||
>
|
||||
حذف
|
||||
</button>
|
||||
</div>
|
||||
)
|
||||
: undefined
|
||||
}
|
||||
/>
|
||||
|
||||
<TypeModal
|
||||
open={editing.open}
|
||||
type={editing.type}
|
||||
saving={create.isPending || update.isPending}
|
||||
onClose={() => setEditing({ open: false, type: null })}
|
||||
onSave={(payload) => {
|
||||
const opts = { onSuccess: () => setEditing({ open: false, type: null }) };
|
||||
if (editing.type) update.mutate({ uuid: editing.type.uuid, d: { name: payload.name, active: payload.active } }, opts);
|
||||
else create.mutate({ code: payload.code, name: payload.name }, opts);
|
||||
}}
|
||||
/>
|
||||
|
||||
<ConfirmDialog
|
||||
open={!!toDelete}
|
||||
title="حذف نوع منبع"
|
||||
message={`آیا از حذف «${toDelete?.name}» مطمئن هستید؟`}
|
||||
confirmLabel="حذف"
|
||||
loading={remove.isPending}
|
||||
onConfirm={() => toDelete && remove.mutate(toDelete.uuid, { onSuccess: () => setToDelete(null) })}
|
||||
onCancel={() => setToDelete(null)}
|
||||
/>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function TypeModal({
|
||||
open, type, saving, onClose, onSave,
|
||||
}: {
|
||||
open: boolean;
|
||||
type: ResourceType | null;
|
||||
saving: boolean;
|
||||
onClose: () => void;
|
||||
onSave: (payload: { code: string; name: string; active: boolean }) => void;
|
||||
}) {
|
||||
const [code, setCode] = useState('');
|
||||
const [name, setName] = useState('');
|
||||
const [active, setActive] = useState(true);
|
||||
|
||||
React.useEffect(() => {
|
||||
if (!open) return;
|
||||
setCode(type?.code ?? '');
|
||||
setName(type?.name ?? '');
|
||||
setActive(type?.active ?? true);
|
||||
}, [open, type]);
|
||||
|
||||
const isEdit = type !== null;
|
||||
const codeValid = /^[a-z0-9_]{1,40}$/.test(code);
|
||||
const invalid = name.trim() === '' || (!isEdit && !codeValid);
|
||||
|
||||
return (
|
||||
<Modal open={open} onClose={onClose} title={isEdit ? 'ویرایش نوع منبع' : 'افزودن نوع منبع'}>
|
||||
<div style={{ display: 'grid', gap: 14 }}>
|
||||
<div style={{ display: 'grid', gap: 6 }}>
|
||||
<label style={{ fontSize: 12, color: 'var(--text-2)' }}>کد (انگلیسی)</label>
|
||||
<input
|
||||
className="field"
|
||||
value={code}
|
||||
disabled={isEdit}
|
||||
onChange={(e) => setCode(e.target.value)}
|
||||
placeholder="laser_device"
|
||||
style={{ direction: 'ltr' }}
|
||||
/>
|
||||
{!isEdit && code !== '' && !codeValid && (
|
||||
<span style={{ fontSize: 12, color: 'var(--danger)' }}>
|
||||
فقط حروف کوچک انگلیسی، عدد و زیرخط.
|
||||
</span>
|
||||
)}
|
||||
{isEdit && (
|
||||
<span style={{ fontSize: 12, color: 'var(--text-3)' }}>
|
||||
کد پس از ساخت تغییر نمیکند؛ منابع موجود با همین کد پیدا میشوند.
|
||||
</span>
|
||||
)}
|
||||
</div>
|
||||
|
||||
<div style={{ display: 'grid', gap: 6 }}>
|
||||
<label style={{ fontSize: 12, color: 'var(--text-2)' }}>نام نمایشی</label>
|
||||
<input className="field" value={name} onChange={(e) => setName(e.target.value)} placeholder="دستگاه لیزر" />
|
||||
</div>
|
||||
|
||||
<label style={{ display: 'flex', alignItems: 'center', gap: 8, fontSize: 13 }}>
|
||||
<input type="checkbox" checked={active} onChange={(e) => setActive(e.target.checked)} />
|
||||
فعال است
|
||||
</label>
|
||||
|
||||
<div style={{ display: 'flex', justifyContent: 'flex-end', gap: 8 }}>
|
||||
<button type="button" className="btn secondary" onClick={onClose}>انصراف</button>
|
||||
<button
|
||||
type="button"
|
||||
className="btn primary"
|
||||
disabled={saving || invalid}
|
||||
onClick={() => onSave({ code: code.trim(), name: name.trim(), active })}
|
||||
>
|
||||
{saving ? 'در حال ذخیره...' : 'ذخیره'}
|
||||
</button>
|
||||
</div>
|
||||
</div>
|
||||
</Modal>
|
||||
);
|
||||
}
|
||||
@@ -0,0 +1,110 @@
|
||||
import { describe, it, expect, beforeEach, vi } from 'vitest';
|
||||
import { screen, fireEvent, 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 { api } from '../lib/api';
|
||||
import ResourcesPage from './ResourcesPage';
|
||||
|
||||
const get = api.get as ReturnType<typeof vi.fn>;
|
||||
const post = api.post as ReturnType<typeof vi.fn>;
|
||||
|
||||
const branch = {
|
||||
id: '1', uuid: 'b1', type: 'clinic', clinic_id: 3, clinic_name: 'کلینیک',
|
||||
name: 'شعبهٔ مرکزی', map: { latitude: null, longitude: null }, address: null,
|
||||
telephone: null, active: true, timezone: 'Asia/Tehran', city: null, province: null,
|
||||
};
|
||||
|
||||
const laserType = { uuid: 't1', code: 'laser', name: 'دستگاه لیزر', is_system: false, active: true, resources_count: 1, created_at: 0, updated_at: 0 };
|
||||
const skill = { uuid: 's1', name: 'آلکساندرایت', active: true, resources_count: 1, created_at: 0, updated_at: 0 };
|
||||
|
||||
const resource = {
|
||||
uuid: 'r1', name: 'لیزر ۱', address_uuid: 'b1', address_name: 'شعبهٔ مرکزی',
|
||||
type_uuid: 't1', type_code: 'laser', type_name: 'دستگاه لیزر',
|
||||
capacity: 3, setup_minutes: 5, cleanup_minutes: 10, attributes: {},
|
||||
subject_kind: null, subject_uuid: null,
|
||||
skills: [{ skill_uuid: 's1', skill_name: 'آلکساندرایت', level: 4 }],
|
||||
active: true, created_at: 0, updated_at: 0,
|
||||
};
|
||||
|
||||
function mockApi() {
|
||||
get.mockImplementation((path: string) => {
|
||||
if (path.startsWith('/api/v1/branches')) return Promise.resolve({ success: true, data: [branch] });
|
||||
if (path.startsWith('/api/v1/resource-types')) return Promise.resolve({ success: true, data: [laserType] });
|
||||
if (path.startsWith('/api/v1/skills')) return Promise.resolve({ success: true, data: [skill] });
|
||||
if (path.startsWith('/api/v1/resources')) return Promise.resolve({ success: true, data: [resource] });
|
||||
return Promise.resolve({ success: true, data: [] });
|
||||
});
|
||||
post.mockResolvedValue({ success: true, data: resource });
|
||||
}
|
||||
|
||||
describe('ResourcesPage', () => {
|
||||
beforeEach(() => vi.clearAllMocks());
|
||||
|
||||
it('shows capacity as concurrency and both buffer minutes', async () => {
|
||||
mockApi();
|
||||
renderWithProviders(<ResourcesPage />, { route: '/admin/resources' });
|
||||
|
||||
await waitFor(() => expect(screen.getByText('لیزر ۱')).toBeInTheDocument());
|
||||
expect(screen.getByText('3 نفر')).toBeInTheDocument();
|
||||
expect(screen.getByText('5 / 10 دقیقه')).toBeInTheDocument();
|
||||
});
|
||||
|
||||
it('labels a resource with no bridge as equipment', async () => {
|
||||
mockApi();
|
||||
renderWithProviders(<ResourcesPage />, { route: '/admin/resources' });
|
||||
|
||||
await waitFor(() => expect(screen.getByText(/تجهیزات/)).toBeInTheDocument());
|
||||
});
|
||||
|
||||
it('renders each skill with its level', async () => {
|
||||
mockApi();
|
||||
renderWithProviders(<ResourcesPage />, { route: '/admin/resources' });
|
||||
|
||||
await waitFor(() => expect(screen.getByText('آلکساندرایت · 4')).toBeInTheDocument());
|
||||
});
|
||||
|
||||
/**
|
||||
* فیلترها از URL خوانده میشوند و مستقیم به سرور میروند — فیلتر دوبارهٔ سمت
|
||||
* کلاینت روی فهرستی که خودش فیلترشده آمده، منبع اختلاف است.
|
||||
*/
|
||||
it('passes the URL filters straight to the server', async () => {
|
||||
mockApi();
|
||||
renderWithProviders(<ResourcesPage />, {
|
||||
route: '/admin/resources?address=b1&type=t1&skill=s1&status=1',
|
||||
});
|
||||
|
||||
await waitFor(() => expect(get).toHaveBeenCalled());
|
||||
|
||||
const called = get.mock.calls.map((c) => String(c[0]));
|
||||
const listCall = called.find((p) => p.startsWith('/api/v1/resources'));
|
||||
|
||||
expect(listCall).toContain('address_uuid=b1');
|
||||
expect(listCall).toContain('type_uuid=t1');
|
||||
expect(listCall).toContain('skill_uuid=s1');
|
||||
expect(listCall).toContain('active=1');
|
||||
});
|
||||
|
||||
it('sends address and type only when creating, never when editing', async () => {
|
||||
mockApi();
|
||||
renderWithProviders(<ResourcesPage />, { route: '/admin/resources' });
|
||||
|
||||
await waitFor(() => expect(screen.getByText('لیزر ۱')).toBeInTheDocument());
|
||||
|
||||
fireEvent.click(screen.getByText('افزودن منبع'));
|
||||
fireEvent.change(screen.getByPlaceholderText('لیزر آلکساندرایت ۱'), { target: { value: 'لیزر تازه' } });
|
||||
|
||||
// شعبه و نوع هنوز انتخاب نشدهاند → ذخیره غیرفعال است.
|
||||
expect(screen.getByText('ذخیره').closest('button')).toBeDisabled();
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,230 @@
|
||||
import React, { useMemo, useState } from 'react';
|
||||
import { PlusIcon } from '@heroicons/react/24/outline';
|
||||
import PageHeader from '../components/ui/PageHeader';
|
||||
import DataTable, { type Column } from '../components/ui/DataTable';
|
||||
import ConfirmDialog from '../components/ui/ConfirmDialog';
|
||||
import SearchableSelect from '../components/ui/SearchableSelect';
|
||||
import { ActiveBadge } from '../components/ui/StatusBadge';
|
||||
import { useUrlState } from '../hooks/useUrlState';
|
||||
import { usePermissions } from '../hooks/usePermissions';
|
||||
import { useBranches } from '../hooks/useBranches';
|
||||
import { useResources, useResourceTypes, useSkills } from '../hooks/useResources';
|
||||
import ResourceFormModal from '../components/resources/ResourceFormModal';
|
||||
import ResourceSkillsModal from '../components/resources/ResourceSkillsModal';
|
||||
import type { ClinicResource } from '../types';
|
||||
|
||||
/** برچسب فارسی پلِ هر منبع؛ `null` یعنی تجهیزاتی که پشتش موجودیت دیگری نیست. */
|
||||
const SUBJECT_LABEL: Record<string, string> = {
|
||||
doctor: 'پزشک',
|
||||
staff: 'پرسنل',
|
||||
room: 'اتاق',
|
||||
};
|
||||
|
||||
/**
|
||||
* منابع — هر چیزی که ممکن است اشغال باشد.
|
||||
*
|
||||
* فیلترها (شعبه/نوع/مهارت/وضعیت) در URL مینشینند تا «بازگشت» و رفرش همان نما را
|
||||
* بدهند، و همانها مستقیم به سرور میروند: فیلتر کردن سمت کلاینت با فهرستی که خودش
|
||||
* فیلترشده آمده، دوبارهکاری و منبع اختلاف است.
|
||||
*/
|
||||
export default function ResourcesPage() {
|
||||
const [urlState, setUrlState] = useUrlState({
|
||||
search: '', address: '', type: '', skill: '', status: '',
|
||||
});
|
||||
|
||||
const { branches } = useBranches();
|
||||
const { types } = useResourceTypes();
|
||||
const { skills } = useSkills();
|
||||
const { can } = usePermissions();
|
||||
const canUpdate = can('appointment_settings', 'update');
|
||||
|
||||
const { resources, loading, create, update, remove, setSkills } = useResources({
|
||||
address_uuid: urlState.address || undefined,
|
||||
type_uuid: urlState.type || undefined,
|
||||
skill_uuid: urlState.skill || undefined,
|
||||
active: urlState.status || undefined,
|
||||
});
|
||||
|
||||
const [editing, setEditing] = useState<{ open: boolean; resource: ClinicResource | null }>({ open: false, resource: null });
|
||||
const [skillsFor, setSkillsFor] = useState<ClinicResource | null>(null);
|
||||
const [toDelete, setToDelete] = useState<ClinicResource | null>(null);
|
||||
|
||||
const rows = useMemo(() => {
|
||||
const q = urlState.search.trim();
|
||||
return q === '' ? resources : resources.filter((r) => `${r.name} ${r.type_name}`.includes(q));
|
||||
}, [resources, urlState.search]);
|
||||
|
||||
const columns: Column<ClinicResource>[] = [
|
||||
{
|
||||
key: 'name',
|
||||
header: 'منبع',
|
||||
render: (r) => (
|
||||
<div style={{ display: 'flex', flexDirection: 'column', gap: 2 }}>
|
||||
<span style={{ fontWeight: 600 }}>{r.name}</span>
|
||||
<span style={{ fontSize: 12, color: 'var(--text-3)' }}>
|
||||
{r.type_name}
|
||||
{r.subject_kind ? ` · ${SUBJECT_LABEL[r.subject_kind]}` : ' · تجهیزات'}
|
||||
</span>
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{ key: 'address_name', header: 'شعبه', render: (r) => <span style={{ fontSize: 13 }}>{r.address_name || '—'}</span> },
|
||||
{
|
||||
key: 'capacity',
|
||||
header: 'ظرفیت همزمان',
|
||||
render: (r) => <span style={{ fontSize: 13 }}>{r.capacity} نفر</span>,
|
||||
},
|
||||
{
|
||||
key: 'buffers',
|
||||
header: 'آمادهسازی / تمیزکاری',
|
||||
render: (r) => (
|
||||
<span style={{ fontSize: 13, color: 'var(--text-2)' }}>
|
||||
{r.setup_minutes} / {r.cleanup_minutes} دقیقه
|
||||
</span>
|
||||
),
|
||||
},
|
||||
{
|
||||
key: 'skills',
|
||||
header: 'مهارتها',
|
||||
render: (r) =>
|
||||
r.skills.length === 0 ? (
|
||||
<span style={{ fontSize: 12, color: 'var(--text-3)' }}>—</span>
|
||||
) : (
|
||||
<div style={{ display: 'flex', gap: 4, flexWrap: 'wrap' }}>
|
||||
{r.skills.map((s) => (
|
||||
<span key={s.skill_uuid} className="badge blue" style={{ fontSize: 11 }}>
|
||||
{s.skill_name} · {s.level}
|
||||
</span>
|
||||
))}
|
||||
</div>
|
||||
),
|
||||
},
|
||||
{ key: 'active', header: 'وضعیت', render: (r) => <ActiveBadge active={r.active} /> },
|
||||
];
|
||||
|
||||
return (
|
||||
<div className="fade-in">
|
||||
<PageHeader
|
||||
title="منابع"
|
||||
description="هر چیزی که ممکن است اشغال باشد: پزشک، اپراتور، اتاق، دستگاه. ظرفیت یعنی تعداد بیمار همزمان."
|
||||
backTo="/admin/settings-menu"
|
||||
action={
|
||||
canUpdate ? (
|
||||
<button type="button" className="btn primary" onClick={() => setEditing({ open: true, resource: null })}>
|
||||
<PlusIcon style={{ width: 16 }} /> افزودن منبع
|
||||
</button>
|
||||
) : undefined
|
||||
}
|
||||
/>
|
||||
|
||||
<DataTable
|
||||
columns={columns}
|
||||
data={rows}
|
||||
loading={loading}
|
||||
searchValue={urlState.search}
|
||||
onSearchChange={(v) => setUrlState({ search: v })}
|
||||
searchPlaceholder="جستجو در منابع..."
|
||||
emptyMessage="هیچ منبعی با این فیلترها یافت نشد"
|
||||
headerExtra={
|
||||
<div style={{ display: 'flex', gap: 8, flexWrap: 'wrap', marginRight: 'auto' }}>
|
||||
<div style={{ minWidth: 180 }}>
|
||||
<SearchableSelect
|
||||
options={branches.map((b) => ({ value: b.uuid, label: b.name || 'بدون نام' }))}
|
||||
value={urlState.address || null}
|
||||
onChange={(v) => setUrlState({ address: v ? String(v) : '' })}
|
||||
placeholder="همهٔ شعبهها"
|
||||
isClearable
|
||||
height={36}
|
||||
/>
|
||||
</div>
|
||||
<div style={{ minWidth: 170 }}>
|
||||
<SearchableSelect
|
||||
options={types.map((t) => ({ value: t.uuid, label: t.name }))}
|
||||
value={urlState.type || null}
|
||||
onChange={(v) => setUrlState({ type: v ? String(v) : '' })}
|
||||
placeholder="همهٔ نوعها"
|
||||
isClearable
|
||||
height={36}
|
||||
/>
|
||||
</div>
|
||||
<div style={{ minWidth: 170 }}>
|
||||
<SearchableSelect
|
||||
options={skills.map((s) => ({ value: s.uuid, label: s.name }))}
|
||||
value={urlState.skill || null}
|
||||
onChange={(v) => setUrlState({ skill: v ? String(v) : '' })}
|
||||
placeholder="همهٔ مهارتها"
|
||||
isClearable
|
||||
height={36}
|
||||
/>
|
||||
</div>
|
||||
<div style={{ minWidth: 140 }}>
|
||||
<SearchableSelect
|
||||
options={[
|
||||
{ value: '1', label: 'فعال' },
|
||||
{ value: '0', label: 'غیرفعال' },
|
||||
]}
|
||||
value={urlState.status || null}
|
||||
onChange={(v) => setUrlState({ status: v ? String(v) : '' })}
|
||||
placeholder="همهٔ وضعیتها"
|
||||
isClearable
|
||||
height={36}
|
||||
/>
|
||||
</div>
|
||||
</div>
|
||||
}
|
||||
actions={
|
||||
canUpdate
|
||||
? (r) => (
|
||||
<div style={{ display: 'flex', gap: 6 }}>
|
||||
<button type="button" className="btn secondary sm" onClick={() => setEditing({ open: true, resource: r })}>
|
||||
ویرایش
|
||||
</button>
|
||||
<button type="button" className="btn secondary sm" onClick={() => setSkillsFor(r)}>
|
||||
مهارتها
|
||||
</button>
|
||||
<button type="button" className="btn secondary sm" onClick={() => setToDelete(r)}>
|
||||
حذف
|
||||
</button>
|
||||
</div>
|
||||
)
|
||||
: undefined
|
||||
}
|
||||
/>
|
||||
|
||||
<ResourceFormModal
|
||||
open={editing.open}
|
||||
resource={editing.resource}
|
||||
branches={branches}
|
||||
types={types}
|
||||
saving={create.isPending || update.isPending}
|
||||
onClose={() => setEditing({ open: false, resource: null })}
|
||||
onSave={(payload) => {
|
||||
const opts = { onSuccess: () => setEditing({ open: false, resource: null }) };
|
||||
if (editing.resource) update.mutate({ uuid: editing.resource.uuid, d: payload }, opts);
|
||||
else create.mutate(payload, opts);
|
||||
}}
|
||||
/>
|
||||
|
||||
<ResourceSkillsModal
|
||||
resource={skillsFor}
|
||||
skills={skills}
|
||||
saving={setSkills.isPending}
|
||||
onClose={() => setSkillsFor(null)}
|
||||
onSave={(lines) =>
|
||||
skillsFor &&
|
||||
setSkills.mutate({ uuid: skillsFor.uuid, skills: lines }, { onSuccess: () => setSkillsFor(null) })
|
||||
}
|
||||
/>
|
||||
|
||||
<ConfirmDialog
|
||||
open={!!toDelete}
|
||||
title="حذف منبع"
|
||||
message={`آیا از حذف «${toDelete?.name}» مطمئن هستید؟`}
|
||||
confirmLabel="حذف"
|
||||
loading={remove.isPending}
|
||||
onConfirm={() => toDelete && remove.mutate(toDelete.uuid, { onSuccess: () => setToDelete(null) })}
|
||||
onCancel={() => setToDelete(null)}
|
||||
/>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
@@ -0,0 +1,157 @@
|
||||
import React, { useMemo, useState } from 'react';
|
||||
import { PlusIcon } from '@heroicons/react/24/outline';
|
||||
import PageHeader from '../components/ui/PageHeader';
|
||||
import DataTable, { type Column } from '../components/ui/DataTable';
|
||||
import Modal from '../components/ui/Modal';
|
||||
import ConfirmDialog from '../components/ui/ConfirmDialog';
|
||||
import { ActiveBadge } from '../components/ui/StatusBadge';
|
||||
import { useUrlState } from '../hooks/useUrlState';
|
||||
import { usePermissions } from '../hooks/usePermissions';
|
||||
import { useSkills } from '../hooks/useResources';
|
||||
import type { Skill } from '../types';
|
||||
|
||||
/**
|
||||
* مهارتها — «کدام اپراتور مجاز است با کدام دستگاه کار کند» یک اطلاعات است، نه یک
|
||||
* قانون. با «عنوان شغلی» پرسنل قاطی نشود: آن متن آزاد و فقط برای نمایش است.
|
||||
*/
|
||||
export default function SkillsPage() {
|
||||
const { skills, loading, create, update, remove } = useSkills();
|
||||
const { can } = usePermissions();
|
||||
const canUpdate = can('appointment_settings', 'update');
|
||||
|
||||
const [urlState, setUrlState] = useUrlState({ search: '' });
|
||||
const [editing, setEditing] = useState<{ open: boolean; skill: Skill | null }>({ open: false, skill: null });
|
||||
const [toDelete, setToDelete] = useState<Skill | null>(null);
|
||||
|
||||
const rows = useMemo(() => {
|
||||
const q = urlState.search.trim();
|
||||
return q === '' ? skills : skills.filter((s) => s.name.includes(q));
|
||||
}, [skills, urlState.search]);
|
||||
|
||||
const columns: Column<Skill>[] = [
|
||||
{ key: 'name', header: 'مهارت', render: (s) => <span style={{ fontWeight: 600 }}>{s.name}</span> },
|
||||
{
|
||||
key: 'resources_count',
|
||||
header: 'روی چند منبع',
|
||||
render: (s) => <span style={{ fontSize: 13 }}>{s.resources_count ?? 0}</span>,
|
||||
},
|
||||
{ key: 'active', header: 'وضعیت', render: (s) => <ActiveBadge active={s.active} /> },
|
||||
];
|
||||
|
||||
return (
|
||||
<div className="fade-in">
|
||||
<PageHeader
|
||||
title="مهارتها"
|
||||
description="مهارت روی منابع مینشیند و در انتخاب منبع مناسب استفاده میشود. مهارتی که به منبعی داده شده، تا برداشته نشود حذف نمیشود."
|
||||
backTo="/admin/resources"
|
||||
breadcrumbs={[{ label: 'منابع', to: '/admin/resources' }, { label: 'مهارتها' }]}
|
||||
action={
|
||||
canUpdate ? (
|
||||
<button type="button" className="btn primary" onClick={() => setEditing({ open: true, skill: null })}>
|
||||
<PlusIcon style={{ width: 16 }} /> افزودن مهارت
|
||||
</button>
|
||||
) : undefined
|
||||
}
|
||||
/>
|
||||
|
||||
<DataTable
|
||||
columns={columns}
|
||||
data={rows}
|
||||
loading={loading}
|
||||
searchValue={urlState.search}
|
||||
onSearchChange={(v) => setUrlState({ search: v })}
|
||||
searchPlaceholder="جستجو در مهارتها..."
|
||||
emptyMessage="هنوز مهارتی تعریف نشده است"
|
||||
actions={
|
||||
canUpdate
|
||||
? (s) => (
|
||||
<div style={{ display: 'flex', gap: 6 }}>
|
||||
<button type="button" className="btn secondary sm" onClick={() => setEditing({ open: true, skill: s })}>
|
||||
ویرایش
|
||||
</button>
|
||||
<button
|
||||
type="button"
|
||||
className="btn secondary sm"
|
||||
disabled={(s.resources_count ?? 0) > 0}
|
||||
title={(s.resources_count ?? 0) > 0 ? 'اول از منابع برداشته شود' : undefined}
|
||||
onClick={() => setToDelete(s)}
|
||||
>
|
||||
حذف
|
||||
</button>
|
||||
</div>
|
||||
)
|
||||
: undefined
|
||||
}
|
||||
/>
|
||||
|
||||
<SkillModal
|
||||
open={editing.open}
|
||||
skill={editing.skill}
|
||||
saving={create.isPending || update.isPending}
|
||||
onClose={() => setEditing({ open: false, skill: null })}
|
||||
onSave={({ name, active }) => {
|
||||
const opts = { onSuccess: () => setEditing({ open: false, skill: null }) };
|
||||
if (editing.skill) update.mutate({ uuid: editing.skill.uuid, d: { name, active } }, opts);
|
||||
else create.mutate({ name }, opts);
|
||||
}}
|
||||
/>
|
||||
|
||||
<ConfirmDialog
|
||||
open={!!toDelete}
|
||||
title="حذف مهارت"
|
||||
message={`آیا از حذف «${toDelete?.name}» مطمئن هستید؟`}
|
||||
confirmLabel="حذف"
|
||||
loading={remove.isPending}
|
||||
onConfirm={() => toDelete && remove.mutate(toDelete.uuid, { onSuccess: () => setToDelete(null) })}
|
||||
onCancel={() => setToDelete(null)}
|
||||
/>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function SkillModal({
|
||||
open, skill, saving, onClose, onSave,
|
||||
}: {
|
||||
open: boolean;
|
||||
skill: Skill | null;
|
||||
saving: boolean;
|
||||
onClose: () => void;
|
||||
onSave: (payload: { name: string; active: boolean }) => void;
|
||||
}) {
|
||||
const [name, setName] = useState('');
|
||||
const [active, setActive] = useState(true);
|
||||
|
||||
React.useEffect(() => {
|
||||
if (!open) return;
|
||||
setName(skill?.name ?? '');
|
||||
setActive(skill?.active ?? true);
|
||||
}, [open, skill]);
|
||||
|
||||
return (
|
||||
<Modal open={open} onClose={onClose} title={skill ? 'ویرایش مهارت' : 'افزودن مهارت'}>
|
||||
<div style={{ display: 'grid', gap: 14 }}>
|
||||
<div style={{ display: 'grid', gap: 6 }}>
|
||||
<label style={{ fontSize: 12, color: 'var(--text-2)' }}>نام مهارت</label>
|
||||
<input className="field" value={name} onChange={(e) => setName(e.target.value)} placeholder="لیزر آلکساندرایت" />
|
||||
</div>
|
||||
|
||||
<label style={{ display: 'flex', alignItems: 'center', gap: 8, fontSize: 13 }}>
|
||||
<input type="checkbox" checked={active} onChange={(e) => setActive(e.target.checked)} />
|
||||
فعال است
|
||||
</label>
|
||||
|
||||
<div style={{ display: 'flex', justifyContent: 'flex-end', gap: 8 }}>
|
||||
<button type="button" className="btn secondary" onClick={onClose}>انصراف</button>
|
||||
<button
|
||||
type="button"
|
||||
className="btn primary"
|
||||
disabled={saving || name.trim() === ''}
|
||||
onClick={() => onSave({ name: name.trim(), active })}
|
||||
>
|
||||
{saving ? 'در حال ذخیره...' : 'ذخیره'}
|
||||
</button>
|
||||
</div>
|
||||
</div>
|
||||
</Modal>
|
||||
);
|
||||
}
|
||||
@@ -83,6 +83,7 @@ Only **digits** are translated — no characters are stripped, so `IR` in a sheb
|
||||
| [clinic.md](clinic.md) | Clinics | 7 |
|
||||
| [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 |
|
||||
| [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,366 @@
|
||||
# Resource API — منابع، نوع منبع، مهارت و استخر
|
||||
|
||||
> **Base:** `/api/v1` · **Auth:** JWT روی همهٔ اندپوینتها
|
||||
> **مجوز:** `appointment_settings` (`view` خواندن، `update` نوشتن) — همان مجوز تنظیمات
|
||||
> نوبتدهی؛ مجوز تازهای ساخته نشده.
|
||||
|
||||
---
|
||||
|
||||
## منبع چیست
|
||||
|
||||
قانون طلایی اول مستند: **«تقویم مال منبع است، نه مال پزشک.»** منبع هر چیزی است که
|
||||
ممکن است اشغال باشد: پزشک، اپراتور، دستیار، دستگاه، اتاق، تخت، یونیت.
|
||||
|
||||
هر منبع مال یک **شعبه** است و شعبه همان رکورد آدرس محل نوبتدهی است
|
||||
(`doctor_addresses` — رجوع به [branch.md](branch.md)). پس همهجا `address_uuid` است،
|
||||
نه `branch_id`.
|
||||
|
||||
### پل، نه ادغام
|
||||
|
||||
`Doctor`، `ClinicStaff` و `Room` هرکدام هویت مستقل و مصرفکنندهٔ زنده دارند
|
||||
(`appointments.doctor_id`، `service_item_staff`، سایت عمومی). تبدیلشان به زیرکلاسِ منبع
|
||||
یعنی مهاجرت همزمان همهٔ آن مسیرها. بهجایش هر منبع **حداکثر یک** پل دارد:
|
||||
|
||||
| `subject_kind` | یعنی |
|
||||
|---|---|
|
||||
| `doctor` / `staff` / `room` | منبع همان موجودیت است |
|
||||
| `null` | دستگاه یا تجهیزات — منبعی که پشتش موجودیت دیگری نیست |
|
||||
|
||||
قید «حداکثر یکی» در خودِ entity اجبار میشود، نه با `CHECK` دیتابیس: MariaDB قید
|
||||
چندستونی را قابل اتکا اجرا نمیکند.
|
||||
|
||||
**یکتایی `(doctor_id, address_id)` است، نه `(doctor_id)`.** یک `WeeklySchedule` per
|
||||
جفت (پزشک، کلینیک) است ولی هر شیفتِ درونش `location_id` خودش را دارد، پس یک پزشک از
|
||||
قبل در چند آدرسِ یک محیط کار میکند. کلید زدن فقط روی پزشک، این واقعیت را غیرقابلبیان
|
||||
میکرد — و تقویمِ تسک ۰۳ دقیقاً per مکان است.
|
||||
|
||||
---
|
||||
|
||||
## سه قرارداد که باید بدانید
|
||||
|
||||
**۱. `capacity` یعنی همزمانی، نه تعداد ردیف.**
|
||||
اتاق تزریق سهتخته **یک** منبع با ظرفیت ۳ است، نه سه منبع. با سه ردیف، موتور جستجو
|
||||
باید سه تقویم را ادغام کند و «کدام تخت» بشود تصمیمی که هیچکس نمیخواهد بگیرد. با
|
||||
ظرفیت ۳، شرط اشغال یک شمارش ساده در برابر یک سقف است.
|
||||
منبعی که یک **شخص** است (پزشک/پرسنل) ظرفیت بیش از ۱ نمیپذیرد.
|
||||
|
||||
**۲. `setup_minutes` / `cleanup_minutes` جزو نوبت بیمار نیستند.**
|
||||
بیمار ساعت ۱۰:۰۰ میآید و ۱۰:۳۰ میرود؛ ولی یونیت از ۹:۵۵ تا ۱۰:۴۰ در دسترس نیست.
|
||||
با `WeeklySchedule.meta.buffer_minutes` قاطی نشود: آن فاصلهٔ سراسری بین دو نوبتِ
|
||||
**پزشک** است، این per منبع. هر دو کنار هم زندگی میکنند و آن یکی دستنخورده است.
|
||||
|
||||
**۳. مهارت یک جدول است، نه یک قانون.**
|
||||
«کدام اپراتور مجاز است با کدام دستگاه کار کند» یک اطلاعات است. با ۵۰ اپراتور و ۲۰۰
|
||||
سرویس، سپردنش به موتور قوانین یعنی ۱۰٬۰۰۰ قانون.
|
||||
با `ClinicStaff.job_title` قاطی نشود: آن متن آزاد و فقط برای نمایش است و هیچجا برای
|
||||
تصمیمگیری parse نمیشود.
|
||||
|
||||
⚠️ همهٔ اندپوینتها برای دادهٔ محیط دیگر **۴۰۴** میدهند، نه ۴۰۳ — وجود دادهٔ محیط
|
||||
بیگانه لو نمیرود. مالکیت صریح سنجیده میشود و به `TenantFilter` تکیه نمیشود، چون
|
||||
جداسازی سختِ فیلتر فقط روی محیطِ *انتخابشده* اعمال میشود
|
||||
([tenancy.md](../architecture/tenancy.md)).
|
||||
|
||||
---
|
||||
|
||||
## نوع منبع
|
||||
|
||||
### `GET /api/v1/resource-types`
|
||||
|
||||
خروجی واقعی (سه نوع سیستمی را `app:resource:backfill` ساخته):
|
||||
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"data": [
|
||||
{ "uuid": "c39053f3-a051-4f03-942f-08a2274bf658", "code": "room", "name": "اتاق", "is_system": true, "active": true, "created_at": 1785420038, "updated_at": 1785420038, "resources_count": 0 },
|
||||
{ "uuid": "c0447da1-30af-430b-8cbd-b464ccd81624", "code": "staff", "name": "پرسنل", "is_system": true, "active": true, "created_at": 1785420038, "updated_at": 1785420038, "resources_count": 0 },
|
||||
{ "uuid": "dcabd1c3-d554-4613-a33d-7c69b7ae7efe", "code": "doctor", "name": "پزشک", "is_system": true, "active": true, "created_at": 1785420038, "updated_at": 1785420038, "resources_count": 1 }
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
`resources_count` با **یک** کوئری گروهی پر میشود، نه یکی per نوع.
|
||||
|
||||
### `POST /api/v1/resource-types`
|
||||
|
||||
| فیلد | نوع | الزامی | قاعده |
|
||||
|---|---|---|---|
|
||||
| `code` | string | ✅ | `[a-z0-9_]{1,40}` · یکتا **per محیط** (همان کد در محیط دیگر مجاز است) |
|
||||
| `name` | string | ✅ | نام نمایشی فارسی |
|
||||
|
||||
**۲۰۱** (خروجی واقعی):
|
||||
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"data": {
|
||||
"uuid": "da4d6789-1167-4acb-beac-0ea13c00a37e",
|
||||
"code": "laser",
|
||||
"name": "دستگاه لیزر",
|
||||
"is_system": false,
|
||||
"active": true,
|
||||
"created_at": 1785420676,
|
||||
"updated_at": 1785420676,
|
||||
"resources_count": 0
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**۴۲۲:** کد تکراری در همان محیط (field `code`) · کد نامعتبر (field `code`) · نام خالی.
|
||||
|
||||
### `PATCH /api/v1/resource-type/{uuid}`
|
||||
|
||||
فقط `name` و `active`. **`code` تغییر نمیکند** حتی روی نوع غیرسیستمی: منابع موجود و
|
||||
پل خودکار با همان کد پیدا میشوند و عوض کردنش نگاشت را بیصدا میشکند. فرستادنش خطا
|
||||
نمیدهد، نادیده گرفته میشود.
|
||||
|
||||
### `DELETE /api/v1/resource-type/{uuid}`
|
||||
|
||||
**۴۲۲** وقتی `is_system` است («نوع منبع سیستمی حذف نمیشود») یا منبعی از آن نوع وجود
|
||||
دارد («این نوع روی N منبع استفاده شده است»).
|
||||
|
||||
---
|
||||
|
||||
## مهارت
|
||||
|
||||
### `GET /api/v1/skills` · `POST /api/v1/skills`
|
||||
|
||||
بدنهٔ ساخت فقط `name`. **۲۰۱** (خروجی واقعی):
|
||||
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"data": {
|
||||
"uuid": "48e60355-6788-4202-a775-a07986658662",
|
||||
"name": "لیزر آلکساندرایت",
|
||||
"active": true,
|
||||
"created_at": 1785420692,
|
||||
"updated_at": 1785420692,
|
||||
"resources_count": 0
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### `PATCH /api/v1/skill/{uuid}` — `name` و `active`
|
||||
|
||||
### `DELETE /api/v1/skill/{uuid}`
|
||||
|
||||
مهارتی که روی منبعی نشسته حذف نمیشود؛ وگرنه `ON DELETE RESTRICT` خطای خام دیتابیس
|
||||
میداد. **۴۲۲** (خروجی واقعی):
|
||||
|
||||
```json
|
||||
{"success":false,"data":null,"errors":[{"code":"ERR_VALIDATION_001","message":"این مهارت به 1 منبع داده شده است؛ اول از آنها برداشته شود"}]}
|
||||
```
|
||||
|
||||
> رقم لاتین در پیام عمدی است — قرارداد پیامهای درونریزیِ بکاند همین است و
|
||||
> قالببندی فارسی کارِ نمایش در کلاینت است.
|
||||
|
||||
---
|
||||
|
||||
## منابع
|
||||
|
||||
### `GET /api/v1/resources`
|
||||
|
||||
| Query | توضیح |
|
||||
|---|---|
|
||||
| `address_uuid` | فقط منابع این شعبه |
|
||||
| `type_uuid` | فقط این نوع |
|
||||
| `skill_uuid` | فقط منابعی که این مهارت را دارند |
|
||||
| `active` | `1` / `0` |
|
||||
| `clinic_uuid` | انتخاب صریح محیط |
|
||||
|
||||
`skill_uuid` متعلق به محیط دیگر **۴۰۴** میدهد، نه «هیچ نتیجه» — سکوت اینجا یعنی
|
||||
دیباگِ کور.
|
||||
|
||||
### `POST /api/v1/resource`
|
||||
|
||||
| فیلد | نوع | الزامی | قاعده |
|
||||
|---|---|---|---|
|
||||
| `address_uuid` | string | ✅ | شعبه؛ جفت محیطِ منبع **از همین** مشتق میشود، نه از بدنه |
|
||||
| `type_uuid` | string | ✅ | |
|
||||
| `name` | string | ✅ | حداکثر ۱۵۰ نویسه |
|
||||
| `capacity` | int | — | پیشفرض ۱، حداقل ۱؛ روی منبعِ شخص حداکثر ۱ |
|
||||
| `setup_minutes` | int | — | پیشفرض ۰، بازهٔ ۰..۴۸۰ |
|
||||
| `cleanup_minutes` | int | — | پیشفرض ۰، بازهٔ ۰..۴۸۰ |
|
||||
| `attributes` | object | — | حداکثر ۲۰ کلید · کلید `[a-z_]{1,40}` · مقدار فقط اسکالر |
|
||||
| `active` | bool | — | پیشفرض `true` |
|
||||
|
||||
`attributes` عمداً آزاد است — کلید ناشناخته پذیرفته میشود — ولی مقدارش باید ساده
|
||||
باشد. دلیل: تسک ۰۵ قید `same_gender` و تسک ۰۹ شرطهای منبع را با مقایسهٔ ساده روی
|
||||
همین مقادیر میسنجند؛ آرایهٔ تودرتو یعنی مقایسهٔ دلخواه، همان چیزی که بند ۸ مستند
|
||||
ممنوع کرده. کلیدهای قراردادی: `gender`, `device_model`, `floor`, `brand`.
|
||||
|
||||
**۲۰۱** (خروجی واقعی):
|
||||
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"data": {
|
||||
"uuid": "38bdd1e9-d982-4cef-9419-3d42ee6b85f2",
|
||||
"name": "لیزر آلکساندرایت ۱",
|
||||
"address_uuid": "d0601f79-6e4a-482e-afed-c9be3928d9e6",
|
||||
"address_name": "درمانگاه شبانه روزی صدرا ",
|
||||
"type_uuid": "da4d6789-1167-4acb-beac-0ea13c00a37e",
|
||||
"type_code": "laser",
|
||||
"type_name": "دستگاه لیزر",
|
||||
"capacity": 1,
|
||||
"setup_minutes": 5,
|
||||
"cleanup_minutes": 10,
|
||||
"attributes": { "device_model": "Candela GentleLase", "floor": "2" },
|
||||
"subject_kind": null,
|
||||
"subject_uuid": null,
|
||||
"skills": [],
|
||||
"active": true,
|
||||
"created_at": 1785420692,
|
||||
"updated_at": 1785420692
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**۴۲۲ — ظرفیت روی منبعِ شخص** (خروجی واقعی):
|
||||
|
||||
```json
|
||||
{"success":false,"data":null,"errors":[{"code":"ERR_VALIDATION_001","message":"منبعی که یک شخص است نمیتواند ظرفیت بیش از ۱ داشته باشد","field":"capacity"}]}
|
||||
```
|
||||
|
||||
**۴۲۲ — ویژگی غیر اسکالر** (خروجی واقعی):
|
||||
|
||||
```json
|
||||
{"success":false,"data":null,"errors":[{"code":"ERR_VALIDATION_001","message":"مقدار ویژگی «nested» باید یک مقدار ساده باشد","field":"attributes"}]}
|
||||
```
|
||||
|
||||
سایر ۴۲۲ها: `capacity < 1` · نام خالی · کلید ویژگی غیر snake_case ·
|
||||
`setup/cleanup` بیرون از ۰..۴۸۰.
|
||||
|
||||
### `GET/PATCH/DELETE /api/v1/resource/{uuid}`
|
||||
|
||||
`PATCH` همان فیلدهاست؛ `address_uuid` پذیرفته **نمیشود** (جفت محیط از آدرس مشتق شده
|
||||
و write-once است) و `type_uuid` قابل تغییر است.
|
||||
|
||||
### `PUT /api/v1/resource/{uuid}/skills`
|
||||
|
||||
جایگزینی **کامل**: مهارتی که در بدنه نیست، برداشته میشود. `{"skills":[]}` همه را
|
||||
پاک میکند.
|
||||
|
||||
```json
|
||||
{ "skills": [ { "skill_uuid": "48e60355-…", "level": 4 } ] }
|
||||
```
|
||||
|
||||
`level` بین ۱ و ۵ (پیشفرض ۱). از روز اول هست چون استراتژی «حفظ متخصصها» در تسک ۰۶
|
||||
رویش ساخته میشود و افزودنش بعداً یعنی backfill با حدس.
|
||||
|
||||
پاسخ ۲۰۰ کلِ منبع است؛ بخش `skills` آن (خروجی واقعی):
|
||||
|
||||
```json
|
||||
"skills": [
|
||||
{ "skill_uuid": "48e60355-6788-4202-a775-a07986658662", "skill_name": "لیزر آلکساندرایت", "level": 4 }
|
||||
]
|
||||
```
|
||||
|
||||
**۴۲۲:** `level` بیرون از ۱..۵ (field `level`) · مهارت تکراری در یک بدنه ·
|
||||
`skill_uuid` غایب. **۴۰۴:** مهارت محیط دیگر.
|
||||
|
||||
> **اتمی است.** اعتبارسنجی کل فهرست پیش از هر حذفی انجام میشود، پس یک ردیف نامعتبر
|
||||
> در انتهای فهرست، مهارتهای درستِ قبلی را پاک نمیکند و بعد ۴۲۲ برگرداند.
|
||||
|
||||
---
|
||||
|
||||
## استخر منابع
|
||||
|
||||
گروهی از منابع که **جایگزین کامل** یکدیگرند: «لیزرهای آلکساندرایت»، «اتاقهای معاینه».
|
||||
|
||||
### `GET/POST /api/v1/resource-pools`
|
||||
|
||||
بدنهٔ ساخت: `address_uuid` · `type_uuid` · `name`.
|
||||
|
||||
### `GET/PATCH/DELETE /api/v1/resource-pool/{uuid}`
|
||||
|
||||
`PATCH` فقط `name` و `active`. `DELETE` اعضا را با CASCADE میبرد ولی **خودِ منابع
|
||||
دستنخورده میمانند**.
|
||||
|
||||
### `PUT /api/v1/resource-pool/{uuid}/members`
|
||||
|
||||
```json
|
||||
{ "members": [ { "resource_uuid": "38bdd1e9-…", "priority": 0 } ] }
|
||||
```
|
||||
|
||||
هر عضو باید **همان شعبه و همان نوعِ** استخر را داشته باشد. تسک ۰۶ فرض میکند هر عضو
|
||||
جایگزین کامل دیگری است: عضوی از شعبهٔ دیگر یعنی بیمار در ساختمان اشتباه میایستد، و
|
||||
عضوی از نوع دیگر یعنی صندلی بهجای دستگاه لیزر پیشنهاد میشود.
|
||||
|
||||
`priority` ترتیب ترجیح در استراتژی انتخاب است؛ کوچکتر زودتر.
|
||||
|
||||
**۲۰۰** (خروجی واقعی):
|
||||
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"data": {
|
||||
"uuid": "9d50cf4a-bef6-423c-85e9-530bf3609964",
|
||||
"name": "لیزرهای آلکساندرایت",
|
||||
"address_uuid": "d0601f79-6e4a-482e-afed-c9be3928d9e6",
|
||||
"address_name": "درمانگاه شبانه روزی صدرا ",
|
||||
"type_uuid": "da4d6789-1167-4acb-beac-0ea13c00a37e",
|
||||
"type_code": "laser",
|
||||
"type_name": "دستگاه لیزر",
|
||||
"members": [
|
||||
{ "resource_uuid": "38bdd1e9-d982-4cef-9419-3d42ee6b85f2", "resource_name": "لیزر آلکساندرایت ۱", "priority": 0, "active": true }
|
||||
],
|
||||
"active": true,
|
||||
"created_at": 1785420708,
|
||||
"updated_at": 1785420708
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**۴۲۲:** «همهٔ اعضای استخر باید در یک شعبه باشند» · «… از یک نوع منبع باشند» · عضو
|
||||
تکراری. مثل مهارتها، اعتبارسنجی پیش از حذف است.
|
||||
|
||||
استخر **بدون عضو** معتبر است (در حال ساخت)، ولی تسک ۰۶ آن را «هیچ منبعی» میبیند.
|
||||
|
||||
---
|
||||
|
||||
## `app:resource:backfill`
|
||||
|
||||
هر موجودیت قابلاشغالِ موجود را به یک منبع پل میزند.
|
||||
|
||||
```bash
|
||||
ddev exec php bin/console app:resource:backfill # dry-run
|
||||
ddev exec php bin/console app:resource:backfill --force
|
||||
ddev exec php bin/console app:resource:backfill --force --pair=clinic:12
|
||||
```
|
||||
|
||||
| مورد | رفتار |
|
||||
|---|---|
|
||||
| اتاق | آدرسش را خودش دارد → منبع با **همان `capacity`** و همان `active` |
|
||||
| پزشک | یک منبع per آدرسی که در برنامهٔ هفتگی **شیفت فعال** دارد (`location_id`) |
|
||||
| پرسنل | فقط اگر محیط دقیقاً **یک** شعبه دارد؛ وگرنه رد و **گزارش** میشود |
|
||||
|
||||
پرسنل تنها موردی است که قابل استنتاج نیست: هیچ ستونی نمیگوید در کدام شعبه کار میکند.
|
||||
حدس زدنِ «اولین شعبه» او را در ساختمان اشتباه مینشاند، پس گزارش میشود تا کاربر خودش
|
||||
تعیین کند.
|
||||
|
||||
`--pair` هم برای عملیات است (اجرای دوباره برای یک کلینیک) و هم دامنه را محدود میکند.
|
||||
دستور **per محیط flush میکند**، پس یک ردیف خراب کل اجرای چندهزارمحیطی را با
|
||||
`EntityManagerClosed` از پا نمیاندازد.
|
||||
|
||||
idempotent است: تکیهگاهش وجود یا نبودِ منبعِ متناظر است، نه یک پرچم جداگانه.
|
||||
|
||||
---
|
||||
|
||||
## طبقهبندی محیط
|
||||
|
||||
| جدول | وضعیت |
|
||||
|---|---|
|
||||
| `resource_types` · `clinic_resources` · `skills` · `resource_pools` | جفت `(entity_type, entity_id)` |
|
||||
| `resource_skills` · `resource_pool_members` | `AGGREGATE_CHILDREN` — ریشههاشان خودشان جفت دارند |
|
||||
|
||||
---
|
||||
|
||||
## تستها
|
||||
|
||||
```bash
|
||||
ddev exec php bin/phpunit tests/Resource # ۵۲ تست / ۱۲۹ assertion
|
||||
ddev exec php vendor/bin/phpstan analyse src/Resource
|
||||
npx vitest run assets/admin/pages/ResourcesPage.test.tsx
|
||||
```
|
||||
@@ -178,3 +178,20 @@
|
||||
|------|------|-------|
|
||||
| ERR_STAFF_NOT_FOUND | 404 | پرسنل یافت نشد |
|
||||
| ERR_FORBIDDEN_001 | 403 | دسترسی ندارید |
|
||||
|
||||
---
|
||||
|
||||
## رابطه با منبع
|
||||
|
||||
پرسنل بهتنهایی تقویم، ظرفیت و مهارت ندارد؛ آنها روی **منبع** مینشینند
|
||||
([resource.md](resource.md)). هر پرسنل میتواند یک منبع از نوع `staff` در هر شعبه
|
||||
داشته باشد و `app:resource:backfill` این پل را برای پرسنلِ موجود میسازد.
|
||||
|
||||
| نکته | چرا |
|
||||
|---|---|
|
||||
| `job_title` **مهارت نیست** | متن آزاد و فقط برای نمایش است؛ هیچجا برای تصمیمگیری parse نمیشود. مهارت یک موجودیت با هویت است که در انتخاب منبع و شرط قوانین استفاده میشود |
|
||||
| غیرفعال کردن پرسنل | باید منبعش را هم ببندد، وگرنه در جستجوی وقت ظاهر میشود. `ResourceLinker::syncActive()` این کار را میکند — **فراخوانی صریح**، نه Doctrine lifecycle callback (که در `getArrayResult()` اجرا نمیشود و رفتار نامتقارن میسازد) |
|
||||
| غیرفعال کردن منبع | پرسنل را غیرفعال **نمیکند** — پرسنل ممکن است فقط نقش اداری داشته باشد |
|
||||
| پرسنلِ محیط چندشعبهای | backfill پلش را نمیسازد و **گزارش** میدهد: هیچ ستونی نمیگوید در کدام شعبه کار میکند و حدس زدن او را در ساختمان اشتباه مینشاند |
|
||||
|
||||
ظرفیت منبعِ پرسنل همیشه ۱ است — یک شخص همزمان دو بیمار ندارد.
|
||||
|
||||
@@ -154,6 +154,11 @@ public function __construct(ServiceSection $section, ...) {
|
||||
**درسِ عملیاتی:** آنجا که `AGGREGATE_CHILDREN` بیفایده است، فقط طبقهبندی عوض نکن؛
|
||||
جفت واقعی بده. و برای ریشهٔ سراسری یک resolver واحد بساز، نه بررسی تکراری در هر کنترلر.
|
||||
|
||||
قرینهٔ درست همین ماجرا در تسک ۰۲ دیده میشود: `resource_skills` و
|
||||
`resource_pool_members` هم فرزند aggregate اند، ولی ریشههاشان (`clinic_resources` و
|
||||
`resource_pools`) خودشان جفت محیط دارند و uuidشان از request نمیآید — پس آنجا
|
||||
`AGGREGATE_CHILDREN` طبقهبندی درستی است. تفاوت در ریشه است، نه در فرزند.
|
||||
|
||||
### uuid از درخواست — خطرناکترین الگو
|
||||
|
||||
سه نشتی واقعی در آدیت این نقطه پیدا شد و **هیچکدام در repository نبودند**؛ همه در کنترلر و سرویس بودند، جایی که یک uuid از بدنه یا کوئری میآید و کسی محیطش را نمیسنجد:
|
||||
|
||||
@@ -80,3 +80,18 @@ $this->assignTenantPair(
|
||||
|
||||
همان قاعدهٔ `docs/architecture/tenancy.md`: جفت در سازنده از ریشه مشتق میشود، نه از
|
||||
ورودی درخواست — پس هیچ نقطهٔ ساختی نمیتواند فراموشش کند و write-once میماند.
|
||||
|
||||
---
|
||||
|
||||
## بهروزرسانی پس از تسک ۰۲
|
||||
|
||||
منابع ساخته شدند و `clinic_resources.address_id` و `resource_pools.address_id` هر دو
|
||||
به `doctor_addresses(id)` میخورند — همانطور که جدول بالا پیشبینی کرده بود.
|
||||
|
||||
یک تصحیح **اضافه** روی همان جدول: کلید یکتای منبعِ پزشک
|
||||
`(doctor_id, address_id)` است نه `(doctor_id)`. یک `WeeklySchedule` per جفت
|
||||
(پزشک، کلینیک) است ولی هر شیفتِ درونش `location_id` خودش را دارد، پس یک پزشک از قبل
|
||||
در چند آدرسِ یک محیط کار میکند. همین برای `(staff_id, address_id)` هم صادق است.
|
||||
`rooms` استثناست: اتاق ذاتاً در یک آدرس است، پس `UNIQUE(room_id)` کافی است.
|
||||
|
||||
تسکهای ۰۴/۰۷/۰۸/۰۹/۱۰/۱۳ که هنوز `branch_id` میگویند، همین الگو را دنبال کنند.
|
||||
|
||||
@@ -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,90 +11,90 @@
|
||||
|
||||
| # | مورد | وضعیت | یادداشت |
|
||||
|---|---|---|---|
|
||||
| ۰.۱ | `--group=slot-mode-frozen` سبز | ⏳ | |
|
||||
| ۰.۲ | `Doctor` به `Resource` تبدیل **نشد** — فقط لینک شد | ⏳ | `appointments.doctor_id` سر جایش |
|
||||
| ۰.۳ | `ClinicStaff` و `Room` هویت مستقل حفظ کردند | ⏳ | |
|
||||
| ۰.۴ | `service_item_staff` و `ServiceItem.staffMembers` دستنخورده | ⏳ | |
|
||||
| ۰.۵ | `WeeklySchedule.meta.buffer_minutes` دستنخورده | ⏳ | `setup/cleanup` مفهوم جداست |
|
||||
| ۰.۱ | `--group=slot-mode-frozen` سبز | ✅ | ۳ تست / ۸ assertion سبز |
|
||||
| ۰.۲ | `Doctor` به `Resource` تبدیل **نشد** — فقط لینک شد | ✅ | فقط پل؛ `appointments.doctor_id` دستنخورده |
|
||||
| ۰.۳ | `ClinicStaff` و `Room` هویت مستقل حفظ کردند | ✅ | هر سه هویت مستقل ماندند |
|
||||
| ۰.۴ | `service_item_staff` و `ServiceItem.staffMembers` دستنخورده | ✅ | صفر تغییر |
|
||||
| ۰.۵ | `WeeklySchedule.meta.buffer_minutes` دستنخورده | ✅ | `setup/cleanup` per منبع است، آن یکی per پزشک |
|
||||
|
||||
## ۱. بکاند
|
||||
|
||||
| # | مورد | وضعیت | یادداشت |
|
||||
|---|---|---|---|
|
||||
| ۱.۱ | `ResourceType` · `ClinicResource` · `Skill` · `ResourceSkill` | ⏳ | |
|
||||
| ۱.۲ | `ResourcePool` · `ResourcePoolMember` | ⏳ | |
|
||||
| ۱.۳ | نام کلاس `ClinicResource` (نه `Resource`) و جدول `clinic_resources` | ⏳ | |
|
||||
| ۱.۴ | `ResourceLinker` — تنها نقطهٔ نگاشت پزشک/پرسنل/اتاق ↔ منبع | ⏳ | |
|
||||
| ۱.۵ | حداکثر یکی از `doctor_id`/`staff_id`/`room_id` — قید در سازنده | ⏳ | |
|
||||
| ۱.۶ | `capacity>1` روی `type=doctor` → ۴۲۲ | ⏳ | |
|
||||
| ۱.۷ | `normalizeAttributes` — اسکالر، کلید `[a-z_]{1,40}`، سقف ۲۰ | ⏳ | |
|
||||
| ۱.۸ | `ResourcePoolService` — اعضا همشعبه و همنوع، وگرنه ۴۲۲ | ⏳ | |
|
||||
| ۱.۹ | `findEligible()` با `HAVING COUNT(DISTINCT skill) = n` | ⏳ | همهٔ مهارتها، نه یکی |
|
||||
| ۱.۱۰ | `StaffService` موجود `ResourceLinker::syncActive()` صدا میزند | ⏳ | نه lifecycle callback |
|
||||
| ۱.۱۱ | چهارده endpoint | ⏳ | |
|
||||
| ۱.۱۲ | `app:resource:backfill` — dry-run، idempotent | ⏳ | سه نوع سیستمی + پزشک/پرسنل/اتاق |
|
||||
| ۱.۱۳ | `TenantOwnershipChecker` روی هر uuid از request | ⏳ | |
|
||||
| ۱.۱ | `ResourceType` · `ClinicResource` · `Skill` · `ResourceSkill` | ✅ | |
|
||||
| ۱.۲ | `ResourcePool` · `ResourcePoolMember` | ✅ | |
|
||||
| ۱.۳ | نام کلاس `ClinicResource` (نه `Resource`) و جدول `clinic_resources` | ✅ | |
|
||||
| ۱.۴ | `ResourceLinker` — تنها نقطهٔ نگاشت پزشک/پرسنل/اتاق ↔ منبع | ✅ | + identity map برای نوعهای flush-نشده |
|
||||
| ۱.۵ | حداکثر یکی از `doctor_id`/`staff_id`/`room_id` — قید در سازنده | ✅ | `BackfillResourceTest::testASecondBridgeIsRefused` |
|
||||
| ۱.۶ | `capacity>1` روی `type=doctor` → ۴۲۲ | ✅ | قید در entity روی هر منبعِ «شخص»، نه فقط `type=doctor` |
|
||||
| ۱.۷ | `normalizeAttributes` — اسکالر، کلید `[a-z_]{1,40}`، سقف ۲۰ | ✅ | |
|
||||
| ۱.۸ | `ResourcePoolService` — اعضا همشعبه و همنوع، وگرنه ۴۲۲ | ✅ | اعتبارسنجی پیش از حذف — اتمی |
|
||||
| ۱.۹ | `findEligible()` با `HAVING COUNT(DISTINCT skill) = n` | ✅ | `ResourceEligibilityTest` هر دو حالت را میسنجد |
|
||||
| ۱.۱۰ | `StaffService` موجود `ResourceLinker::syncActive()` صدا میزند | ✅ | `StaffController::toggle` صدا میزند؛ تست سطح endpoint دارد |
|
||||
| ۱.۱۱ | چهارده endpoint | ✅ | شانزده شد نه چهارده: `GET/DELETE /resource/{uuid}` و `GET /resource-pool/{uuid}` هم لازم بودند |
|
||||
| ۱.۱۲ | `app:resource:backfill` — dry-run، idempotent | ✅ | + `--pair` برای دامنه و flush per محیط |
|
||||
| ۱.۱۳ | `TenantOwnershipChecker` روی هر uuid از request | ✅ | `ResourceContext` تکنقطهٔ ۴۰۴ |
|
||||
|
||||
## ۲. دیتابیس
|
||||
|
||||
| # | مورد | وضعیت | یادداشت |
|
||||
|---|---|---|---|
|
||||
| ۲.۱ | شش جدول ساخته شد | ⏳ | |
|
||||
| ۲.۲ | سه UNIQUE تهیپذیر روی `doctor_id`/`staff_id`/`room_id` | ⏳ | |
|
||||
| ۲.۳ | `idx_resource_skills_skill (skill_id, level)` | ⏳ | کوئری داغ تسک ۰۶ |
|
||||
| ۲.۴ | `entity_type, entity_id` ستون اول ایندکسهای لیست | ⏳ | |
|
||||
| ۲.۵ | `resource_skills` و `resource_pool_members` در `AGGREGATE_CHILDREN` | ⏳ | |
|
||||
| ۲.۶ | `TenantSchemaCoverageTest` سبز | ⏳ | |
|
||||
| ۲.۱ | شش جدول ساخته شد | ✅ | `Version20260730132948` |
|
||||
| ۲.۲ | سه UNIQUE تهیپذیر روی `doctor_id`/`staff_id`/`room_id` | ✅ | دو تای اول به `(doctor_id, address_id)` و `(staff_id, address_id)` تصحیح شد — پزشک در چند شعبهٔ یک محیط کار میکند |
|
||||
| ۲.۳ | `idx_resource_skills_skill (skill_id, level)` | ✅ | کوئری داغ تسک ۰۶ |
|
||||
| ۲.۴ | `entity_type, entity_id` ستون اول ایندکسهای لیست | ✅ | |
|
||||
| ۲.۵ | `resource_skills` و `resource_pool_members` در `AGGREGATE_CHILDREN` | ✅ | ریشههاشان جفت دارند، پس ارثبری واقعی است |
|
||||
| ۲.۶ | `TenantSchemaCoverageTest` سبز | ✅ | |
|
||||
|
||||
## ۳. UI
|
||||
|
||||
| # | مورد | وضعیت | یادداشت |
|
||||
|---|---|---|---|
|
||||
| ۳.۱ | `ResourcesPage` · `ResourceFormPage` · `ResourceTypesPage` · `SkillsPage` · `ResourcePoolsPage` | ⏳ | |
|
||||
| ۳.۲ | فیلتر شعبه/نوع/فعال در URL با `useUrlState` | ⏳ | |
|
||||
| ۳.۳ | شعبه و نوع با `SearchableSelect` | ⏳ | |
|
||||
| ۳.۴ | مهارتها با چیپ چندانتخابی | ⏳ | |
|
||||
| ۳.۵ | `DataTable` با skeleton و empty state | ⏳ | |
|
||||
| ۳.۶ | `backTo`/`BackButton` روی همهٔ زیرصفحهها | ⏳ | |
|
||||
| ۳.۷ | هیچ رنگ/شعاع hard-code | ⏳ | |
|
||||
| ۳.۸ | دارکمود و حالت فشرده | ⏳ | |
|
||||
| ۳.۹ | RTL و موبایل | ⏳ | |
|
||||
| ۳.۱۰ | `setup/cleanup` با واحد فارسی «دقیقه» | ⏳ | |
|
||||
| ۳.۱۱ | هشدار «این منبع N نوبت آیندهٔ فعال دارد» هنگام غیرفعالسازی | ⏳ | |
|
||||
| ۳.۱ | `ResourcesPage` · `ResourceFormPage` · `ResourceTypesPage` · `SkillsPage` · `ResourcePoolsPage` | ✅ | `ResourceFormPage` بهصورت مودال شد نه صفحه: فرم کوتاه است و صفحهٔ جدا یک ناوبری اضافه بدون سود میداد |
|
||||
| ۳.۲ | فیلتر شعبه/نوع/فعال در URL با `useUrlState` | ✅ | شعبه/نوع/مهارت/وضعیت — هر چهار در URL و مستقیم به سرور |
|
||||
| ۳.۳ | شعبه و نوع با `SearchableSelect` | ✅ | هیچ `<select>` بومی در کل دامنه |
|
||||
| ۳.۴ | مهارتها با چیپ چندانتخابی | ✅ | چیپ در جدول + مودال اختصاصی با سطح ۱..۵؛ جایگزینی کامل |
|
||||
| ۳.۵ | `DataTable` با skeleton و empty state | ✅ | |
|
||||
| ۳.۶ | `backTo`/`BackButton` روی همهٔ زیرصفحهها | ✅ | `backTo` + breadcrumb روی هر سه زیرصفحه |
|
||||
| ۳.۷ | هیچ رنگ/شعاع hard-code | ✅ | همه از `var(--…)` |
|
||||
| ۳.۸ | دارکمود و حالت فشرده | 🔄 | کد فقط از توکن استفاده میکند؛ بازبینی چشمی در مرورگر انجام نشد |
|
||||
| ۳.۹ | RTL و موبایل | 🔄 | چیدمان grid با wrap؛ بازبینی چشمی موبایل انجام نشد |
|
||||
| ۳.۱۰ | `setup/cleanup` با واحد فارسی «دقیقه» | ✅ | برچسب «دقیقه» در فرم و ستون جدول |
|
||||
| ۳.۱۱ | هشدار «این منبع N نوبت آیندهٔ فعال دارد» هنگام غیرفعالسازی | ⏳ | نوبت هنوز به منبع وصل نیست — شمارش «نوبت آیندهٔ این منبع» تا تسک ۰۷ ممکن نیست |
|
||||
|
||||
## ۴. تست
|
||||
|
||||
| # | مورد | وضعیت | یادداشت |
|
||||
|---|---|---|---|
|
||||
| ۴.۱ | `ResourceCrudTest` — شعبهٔ محیط دیگر ۴۰۴، دو پل ۴۲۲، capacity | ⏳ | |
|
||||
| ۴.۲ | `SkillAssignmentTest` — جایگزینی کامل، level، حذف در استفاده | ⏳ | |
|
||||
| ۴.۳ | `ResourcePoolTest` — عضو شعبهٔ دیگر / نوع دیگر → ۴۲۲ | ⏳ | |
|
||||
| ۴.۴ | `ResourceEligibilityTest` — دو مهارت، منبع با یکی برنمیگردد | ⏳ | |
|
||||
| ۴.۵ | `BackfillResourceTest` — idempotent | ⏳ | |
|
||||
| ۴.۶ | `TenantLookupInventoryTest` شمارنده بهروز شد | ⏳ | |
|
||||
| ۴.۱ | `ResourceCrudTest` — شعبهٔ محیط دیگر ۴۰۴، دو پل ۴۲۲، capacity | ✅ | ۱۳ تست |
|
||||
| ۴.۲ | `SkillAssignmentTest` — جایگزینی کامل، level، حذف در استفاده | ✅ | ۹ تست شامل اتمی بودن |
|
||||
| ۴.۳ | `ResourcePoolTest` — عضو شعبهٔ دیگر / نوع دیگر → ۴۲۲ | ✅ | ۷ تست |
|
||||
| ۴.۴ | `ResourceEligibilityTest` — دو مهارت، منبع با یکی برنمیگردد | ✅ | ۶ تست |
|
||||
| ۴.۵ | `BackfillResourceTest` — idempotent | ✅ | ۱۰ تست |
|
||||
| ۴.۶ | `TenantLookupInventoryTest` شمارنده بهروز شد | ✅ | سبز بدون نیاز به تغییر شمارنده — lookupهای تازه از `ResourceContext` رد میشوند |
|
||||
|
||||
## ۵. مستندات
|
||||
|
||||
| # | مورد | وضعیت | یادداشت |
|
||||
|---|---|---|---|
|
||||
| ۵.۱ | `docs/api/resource.md` | ⏳ | |
|
||||
| ۵.۲ | توضیح «ظرفیت ۳ = یک ردیف، نه سه منبع» | ⏳ | |
|
||||
| ۵.۳ | تفاوت `setup/cleanup` منبع با `buffer_minutes` برنامه | ⏳ | |
|
||||
| ۵.۴ | `docs/api/staff.md` بخش «رابطه با منبع» | ⏳ | |
|
||||
| ۵.۵ | `docs/architecture/tenancy.md` بهروز | ⏳ | |
|
||||
| ۵.۱ | `docs/api/resource.md` | ✅ | JSON واقعی از curl روی ddev + ثبت در README |
|
||||
| ۵.۲ | توضیح «ظرفیت ۳ = یک ردیف، نه سه منبع» | ✅ | |
|
||||
| ۵.۳ | تفاوت `setup/cleanup` منبع با `buffer_minutes` برنامه | ✅ | |
|
||||
| ۵.۴ | `docs/api/staff.md` بخش «رابطه با منبع» | ✅ | بخش «رابطه با منبع» |
|
||||
| ۵.۵ | `docs/architecture/tenancy.md` بهروز | ✅ | تفاوت «ریشهٔ جفتدار» با پروندهٔ تسک ۰۱ |
|
||||
|
||||
## ۶. بازبینی پایانی
|
||||
|
||||
| # | مورد | وضعیت | یادداشت |
|
||||
|---|---|---|---|
|
||||
| ۶.۱ | هیچ 🔄 و ⏳ بیدلیل نمانده | ⏳ | |
|
||||
| ۶.۲ | `bin/phpunit` کامل سبز | ⏳ | |
|
||||
| ۶.۳ | `--group=slot-mode-frozen` سبز | ⏳ | |
|
||||
| ۶.۴ | `phpstan` بدون خطای جدید | ⏳ | |
|
||||
| ۶.۵ | `npx tsc --noEmit` و `yarn test` سبز | ⏳ | |
|
||||
| ۶.۶ | تستهای tenant سبز | ⏳ | |
|
||||
| ۶.۷ | `docs/api/*` بهروز | ⏳ | |
|
||||
| ۶.۸ | چکلیست UI کامل | ⏳ | |
|
||||
| ۶.۹ | دو کلاینت دیگر بررسی شدند | ⏳ | |
|
||||
| ۶.۱۰ | commit، سپس `graphify update .` | ⏳ | |
|
||||
| ۶.۱۱ | موارد بهتعویق با دلیل و تسک مقصد | ⏳ | |
|
||||
| ۶.۱ | هیچ 🔄 و ⏳ بیدلیل نمانده | ⚠️ | دو 🔄 بازبینی چشمی + یک ⏳ با مقصد صریح (تسک ۰۷) |
|
||||
| ۶.۲ | `bin/phpunit` کامل سبز | ✅ | ۱۱۱۹ تست / ۳۱۱۳ assertion سبز |
|
||||
| ۶.۳ | `--group=slot-mode-frozen` سبز | ✅ | |
|
||||
| ۶.۴ | `phpstan` بدون خطای جدید | ✅ | ۱۴ خطا قبل و بعد؛ `src/Resource` صفر خطا |
|
||||
| ۶.۵ | `npx tsc --noEmit` و `yarn test` سبز | ✅ | `tsc` تمیز · vitest ۸۸ فایل / ۶۱۷ تست |
|
||||
| ۶.۶ | تستهای tenant سبز | ✅ | |
|
||||
| ۶.۷ | `docs/api/*` بهروز | ✅ | |
|
||||
| ۶.۸ | چکلیست UI کامل | ⚠️ | ردیفهای ۳.۸/۳.۹ بازبینی چشمی میخواهند |
|
||||
| ۶.۹ | دو کلاینت دیگر بررسی شدند | ✅ | هیچکدام منابع را مصرف نمیکنند؛ اندپوینتهای تازه همه پنلمحورند و قرارداد موجودی عوض نشد |
|
||||
| ۶.۱۰ | commit، سپس `graphify update .` | ✅ | |
|
||||
| ۶.۱۱ | موارد بهتعویق با دلیل و تسک مقصد | ✅ | هشدار نوبت آینده ← تسک ۰۷ (ردیف ۳.۱۱) |
|
||||
|
||||
@@ -11,6 +11,7 @@ use App\Shared\Controller\BaseController;
|
||||
use App\Shared\Exception\AppException;
|
||||
use App\Staff\Entity\ClinicStaff;
|
||||
use App\Staff\Repository\ClinicStaffRepository;
|
||||
use App\Resource\Service\ResourceLinker;
|
||||
use App\Staff\Service\StaffAccountService;
|
||||
use Symfony\Component\HttpFoundation\JsonResponse;
|
||||
use Symfony\Component\HttpFoundation\Request;
|
||||
@@ -30,6 +31,7 @@ class StaffController extends BaseController
|
||||
private readonly SecretaryAccessChecker $secretaryAccess,
|
||||
private readonly \App\Clinic\Security\ClinicDoctorAccessChecker $clinicDoctorAccess,
|
||||
private readonly StaffAccountService $staffAccounts,
|
||||
private readonly ResourceLinker $resourceLinker,
|
||||
) {}
|
||||
|
||||
#[Route('/api/v1/staff', methods: ['GET'])]
|
||||
@@ -132,6 +134,11 @@ class StaffController extends BaseController
|
||||
$staff->toggleActive();
|
||||
$this->staffRepo->save($staff);
|
||||
|
||||
// منبعِ متناظر باید هموضعیت بماند، وگرنه پرسنل غیرفعال همچنان در جستجوی وقت
|
||||
// ظاهر میشود. فراخوانی صریح است و نه lifecycle callback: آن callback در
|
||||
// getArrayResult() — که لیستهای ادمین با آن ساخته میشوند — اجرا نمیشود.
|
||||
$this->resourceLinker->syncActive($staff, $staff->isActive());
|
||||
|
||||
return $this->success($staff->toArray());
|
||||
}
|
||||
|
||||
|
||||
@@ -185,6 +185,43 @@ class BackfillResourceTest extends ResourceTestCase
|
||||
self::assertStringContainsString('پرسنل: 0', $secondOutput);
|
||||
}
|
||||
|
||||
/**
|
||||
* توگلِ پرسنل از راه endpoint واقعی باید منبعش را هم ببندد — نه فقط سرویس.
|
||||
* بدون این سیمکشی، پرسنل غیرفعال همچنان در جستجوی وقتِ تسک ۰۶ ظاهر میشد.
|
||||
*/
|
||||
public function testTogglingStaffThroughTheEndpointClosesItsResource(): void
|
||||
{
|
||||
[$owner, , $address] = $this->clinicWithAddress();
|
||||
$staff = $this->staff($address, 'اپراتور توگل');
|
||||
|
||||
$this->runBackfill(true, $this->pairOf($address));
|
||||
$this->em->clear();
|
||||
|
||||
$this->authJson('PATCH', "/api/v1/staff/{$staff->getUuid()}/toggle", $owner);
|
||||
self::assertSame(200, $this->responseCode());
|
||||
|
||||
$this->em->clear();
|
||||
$reloaded = $this->em->getRepository(\App\Staff\Entity\ClinicStaff::class)->find($staff->getId());
|
||||
|
||||
self::assertFalse($reloaded->isActive());
|
||||
self::assertFalse($this->resources()->findForSubject($reloaded)->isActive());
|
||||
}
|
||||
|
||||
/** حداکثر یک پل: قید در سازنده است، چون MariaDB `CHECK` چندستونی را اجرا نمیکند. */
|
||||
public function testASecondBridgeIsRefused(): void
|
||||
{
|
||||
[, , $address] = $this->clinicWithAddress();
|
||||
$room = $this->room($address, 'اتاق دوپل');
|
||||
$staff = $this->staff($address, 'پرسنل دوپل');
|
||||
|
||||
$type = $this->resourceType($address, 'mixed', 'ترکیبی');
|
||||
$resource = new \App\Resource\Entity\ClinicResource($address, $type, 'منبع دوپل');
|
||||
$resource->linkTo($room);
|
||||
|
||||
$this->expectException(\InvalidArgumentException::class);
|
||||
$resource->linkTo($staff);
|
||||
}
|
||||
|
||||
/**
|
||||
* غیرفعال شدن پرسنل باید منبعش را هم ببندد، وگرنه در جستجوی وقتِ تسک ۰۶ ظاهر
|
||||
* میشود. عکسش برقرار نیست.
|
||||
|
||||
@@ -44,21 +44,34 @@ class NumericFieldNormalizerTest extends ApiTestCase
|
||||
// کد ملی هم همینطور. ثابتبودنش این تست را flaky میکرد: در اجرای کامل سوئیت،
|
||||
// بسته به ترتیب اجرا، ردیفِ اجرای قبلی باعث ۴۲۲ «تکراری» میشد و در اجرای تنها
|
||||
// سبز بود.
|
||||
$persianNationalCode = str_pad(
|
||||
$this->toPersianDigits((string) random_int(0, 9_999_999_999)),
|
||||
10,
|
||||
'۰',
|
||||
STR_PAD_LEFT,
|
||||
// مثل شماره، یکتاییاش هم باید سنجیده شود: تصادفیبودن تنهایی کافی نیست و در
|
||||
// اجرای کامل سوئیت روی db_testِ انباشته، برخورد ۴۲۲ «تکراری» میداد.
|
||||
do {
|
||||
$persianNationalCode = str_pad(
|
||||
$this->toPersianDigits((string) random_int(0, 9_999_999_999)),
|
||||
10,
|
||||
'۰',
|
||||
STR_PAD_LEFT,
|
||||
);
|
||||
$latinNationalCode = PersianText::digits($persianNationalCode);
|
||||
} while (
|
||||
$this->em->getRepository(DoctorSecretary::class)
|
||||
->findOneBy(['nationalCode' => $latinNationalCode]) !== null
|
||||
);
|
||||
|
||||
$this->authJson('POST', '/api/v1/secretary', $owner, [
|
||||
$body = $this->authJson('POST', '/api/v1/secretary', $owner, [
|
||||
'doctor_uuid' => $doctor->getUuid(),
|
||||
'mobile_number' => $persianMobile,
|
||||
'name' => 'منشی تست',
|
||||
'national_code' => $persianNationalCode,
|
||||
]);
|
||||
|
||||
self::assertSame(201, $this->responseCode(), 'Persian digits must not break validation');
|
||||
// بدنه در پیام میآید: «۴۲۲ بهجای ۲۰۱» بدون دلیلِ سرور قابل دیباگ نیست.
|
||||
self::assertSame(
|
||||
201,
|
||||
$this->responseCode(),
|
||||
'Persian digits must not break validation: ' . json_encode($body, JSON_UNESCAPED_UNICODE),
|
||||
);
|
||||
|
||||
$this->em->clear();
|
||||
$created = $this->em->getRepository(User::class)->findOneBy(['mobileNumber' => $latinMobile]);
|
||||
|
||||
Reference in New Issue
Block a user