Chris Farhood
1d8a086fad
- New lib/cascade.ts: detect when PATCH extends endTime beyond original, query same-groomer downstream active appointments, and shift them forward by (overrunEnd + buffer − downstreamStart). Propagates through the chain until no more conflicts. - Cascade result (shifted[], flaggedForReview[], cascadeLog[]) included in the PATCH response when a shift occurs. Clients receive reschedule email notification. Out-of-business-hours shifts are flagged rather than auto-applied. - Added cascadeDelay() and cascadeOnStatusOverrun() helpers. - Cascade wired into the this_only PATCH path in appointments.ts. Tests: cascade.test.ts UAT: apps/api/UAT_PLAYBOOK.md §2 Refs: GRO-1175, GRO-1162-G Co-Authored-By: Paperclip <noreply@paperclip.ing>
3.0 KiB
3.0 KiB
GroomBook API — UAT Playbook
This document captures user-acceptance test cases for GroomBook API features. Each section corresponds to a feature or bug-fix PR. Update this file when a PR changes user-facing behaviour.
1. Appointment Booking (/api/appointments)
1.1 Create Appointment
- POST
/api/appointmentswith valid payload → 201, appointment returned with generated id - Overlapping staff appointment → 409 conflict error returned
endTimebeforestartTime→ 422 error
1.2 Update Appointment (PATCH /api/appointments/:id)
- Extending
endTimeon ascheduledappointment triggers cascade delay prevention if downstream appointments exist - Extending
endTimereturnscascadeobject in response with shifted appointments - Extending
endTimesends reschedule email to each affected client - Appointments outside business hours after shift are flagged in
cascade.flaggedForReviewinstead of auto-shifted - Only
scheduledandconfirmeddownstream appointments are shifted;in_progress,completed,cancelledare skipped - Cascade stops when a downstream appointment no longer conflicts with the shifted boundary
- Shifts are included in API response under
cascade.shifted[]
1.3 Series (Recurring) Appointments
- Updating one occurrence with
cascadeMode: "this_and_future"shifts that occurrence and all future ones - Updating one occurrence with
cascadeMode: "all"shifts every occurrence in the series
2. Cascade Delay Prevention
2.1 Basic Cascade
- When a groomer's appointment overruns, the next same-groomer
scheduledappointment shifts forward - Delta applied to both
startTimeandendTime(duration preserved) - Cascade propagates through multiple downstream appointments
2.2 Buffer Time
- A configurable buffer (default 15 minutes) is added between the overrunning appointment end and the shifted start
- Cascade respects the buffer between each consecutive pair of appointments
2.3 Business Hours Guard
- If a proposed shift would place an appointment start or end outside business hours, it is flagged instead of shifted
- Flagged appointments are listed in
cascade.flaggedForReview[]with reason text
2.4 Email Notification
- Each shifted appointment triggers a reschedule email to the client
- Email includes original time (struck through) and new time
- Email is skipped silently if SMTP is not configured
2.5 Status Transition Overrun
- When an
in_progressappointment's actual end time exceedsendTime + bufferMinutes, the cascade is triggered using the status transition path
3. Authentication & RBAC
3.1 Staff Authentication
- Unauthenticated request → 401
- Groomer role can only view/edit their own appointments → 403 for others
- Manager role can view/edit all appointments
3.2 Client Authentication
- Clients can access their own appointments via tokenized links
- Tokenized confirm/cancel links work without authentication