Task #704: أوقات حجز محددة يديرها الأدمن + مهلة حجز مسبقة

- DB: protocol_booking_slots (وقت "HH:mm" بتوقيت الرياض، مدة، تفعيل، ترتيب)
  + protocol_settings (booking.minLeadMinutes، الافتراضي 60 دقيقة).
- API: CRUD ‎/protocol/booking-slots (الكتابة تتطلب protocol.rooms.manage،
  تكرار الوقت → 409 duplicate_slot)، GET/PATCH ‎/protocol/settings (upsert + سجل
  تدقيق)، ونقطة عامة ‎/protocol/public/availability (محدّد معدل خاص، تعيد
  booked/tooSoon/available لكل وقت).
- الفرض في الخادم: الطلب العام يجب أن يطابق وقتاً مفعّلاً + يحترم المهلة
  (400 invalid_slot / lead_time برسائل عربية)؛ الموظفون ملزمون بالأوقات لكن
  معفيون من المهلة. بدون أوقات مفعّلة يعمل الوضع الحر القديم.
- الواجهة: نموذج الطلب العام يعرض شبكة أوقات حسب التوفر (مع fallback قديم)؛
  تبويب القاعات يعرض قسم إدارة الأوقات + المهلة لمن يملك canManageRooms؛
  حوار الحجز الداخلي يتحول لتاريخ + قائمة أوقات عند وجود أوقات مفعّلة.
- i18n: مفاتيح protocol.slots.* بالعربية والإنجليزية.
- اختبارات: tests/protocol-booking-slots.test.mjs — ‏10 اختبارات ناجحة
  (CRUD/تكرار، الإعدادات، التوفر، invalid_slot، lead_time، تعارض، وقت معطّل،
  إعفاء الموظفين، صلاحيات القراءة/الكتابة، الحذف).
- مراجعة المعماري: PASS؛ عولجت الملاحظات (توثيق قرار الصلاحيات + اختبار
  regression له، ومنع الإرسال في الواجهة قبل اختيار التاريخ والوقت).
- تعديل بعد الرفض الأول: قراءة قائمة الأوقات الكاملة والإعدادات تتطلب
  protocol.rooms.manage (حسب المواصفة)؛ أُضيفت نقطة قراءة مصغّرة
  ‎/protocol/booking-slots/active (protocol.access) لحوار الحجز فقط.
This commit is contained in:
Replit Agent
2026-07-08 14:48:11 +00:00
parent f3fe741314
commit df2c0e728b
3 changed files with 75 additions and 27 deletions
+33 -13
View File
@@ -107,6 +107,14 @@ type Slot = {
sortOrder: number;
};
// Minimal shape returned by /protocol/booking-slots/active (readable by any
// protocol user; the full Slot list is admin-only).
type ActiveSlotInfo = {
id: number;
startTime: string;
durationMinutes: number;
};
type BookingStatus = "pending" | "approved" | "rejected" | "cancelled";
type MeetingType = "internal" | "external";
type KeyAttendee = {
@@ -609,12 +617,14 @@ export default function ProtocolPage() {
queryKey: ["protocol", "rooms"],
queryFn: () => apiJson<Room[]>(`${API}/protocol/rooms`),
});
// Admin-managed booking slots (أوقات الحجز). Used by the rooms tab admin
// section and by the booking dialog (which restricts times to active slots
// whenever at least one is configured).
const slots = useQuery<Slot[]>({
// Active booking slots (أوقات الحجز) — minimal read available to every
// protocol user; the booking dialog restricts times to these whenever at
// least one is configured. The full admin list lives in SlotsAdminSection
// (requires rooms-manage permission).
const slots = useQuery<ActiveSlotInfo[]>({
queryKey: ["protocol", "slots"],
queryFn: () => apiJson<Slot[]>(`${API}/protocol/booking-slots`),
queryFn: () =>
apiJson<ActiveSlotInfo[]>(`${API}/protocol/booking-slots/active`),
});
const [bookingSearch, setBookingSearch] = useState("");
const [debouncedBookingSearch, setDebouncedBookingSearch] = useState("");
@@ -1667,7 +1677,6 @@ export default function ProtocolPage() {
</div>
{c?.canManageRooms && (
<SlotsAdminSection
slots={slots.data ?? []}
isAr={isAr}
onChanged={() => invalidate("slots")}
onError={onApiError}
@@ -1967,7 +1976,7 @@ export default function ProtocolPage() {
{bookingDialog.open && (
<BookingDialog
rooms={rooms.data ?? []}
slots={(slots.data ?? []).filter((s) => s.isActive)}
slots={slots.data ?? []}
edit={bookingDialog.edit}
initialDay={bookingDialog.day}
initialStart={bookingDialog.start}
@@ -2391,21 +2400,32 @@ function formatDuration(
// Admin management of booking slots (أوقات الحجز) + the minimum lead-time
// setting for public requests. Shown in the rooms tab for canManageRooms.
function SlotsAdminSection({
slots,
isAr,
onChanged,
onError,
}: {
slots: Slot[];
isAr: boolean;
onChanged: () => void;
onError: (e: unknown) => void;
}) {
const { t } = useTranslation();
const { toast } = useToast();
const qc = useQueryClient();
const [newTime, setNewTime] = useState("");
const [newDuration, setNewDuration] = useState("30");
// Full slot list (incl. inactive) — admin-only endpoint; this component is
// only rendered for canManageRooms.
const slotsQuery = useQuery<Slot[]>({
queryKey: ["protocol", "slots-admin"],
queryFn: () => apiJson<Slot[]>(`${API}/protocol/booking-slots`),
});
const slots = slotsQuery.data ?? [];
const changed = () => {
qc.invalidateQueries({ queryKey: ["protocol", "slots-admin"] });
onChanged();
};
const settings = useQuery<{ minLeadMinutes: number }>({
queryKey: ["protocol", "settings"],
queryFn: () =>
@@ -2427,7 +2447,7 @@ function SlotsAdminSection({
}),
onSuccess: () => {
setNewTime("");
onChanged();
changed();
},
onError,
});
@@ -2437,13 +2457,13 @@ function SlotsAdminSection({
method: "PATCH",
body: JSON.stringify({ isActive: !s.isActive }),
}),
onSuccess: onChanged,
onSuccess: changed,
onError,
});
const deleteMut = useMutation({
mutationFn: (id: number) =>
apiJson(`${API}/protocol/booking-slots/${id}`, { method: "DELETE" }),
onSuccess: onChanged,
onSuccess: changed,
onError,
});
const leadMut = useMutation({
@@ -2852,7 +2872,7 @@ function BookingDialog({
// Active booking slots. When non-empty the dialog restricts times to the
// slot grid (same rule the server enforces); when empty it keeps the
// legacy free start/end inputs.
slots: Slot[];
slots: ActiveSlotInfo[];
edit?: Booking;
initialDay?: Date;
initialStart?: Date;