From e11c3caaab28a3ea82802d0a4b8bd1293ae2c334 Mon Sep 17 00:00:00 2001 From: joshua Date: Wed, 28 Oct 2026 03:59:52 +0200 Subject: [PATCH] Volunteer rosters: docs, changelog (1.46.0) Co-Authored-By: Claude Opus 5.5 --- apps/events/CHANGELOG.md | 38 +++++++++++++++ apps/events/FEATURES.md | 60 ++++++++++++++++++++---- apps/events/SETTINGS.md | 1 + apps/events/backend/.env.example | 2 + apps/events/backend/API_DOCUMENTATION.md | 35 ++++++++++++++ apps/events/backend/package-lock.json | 4 +- apps/events/backend/package.json | 2 +- apps/events/docs/HANDOVER.md | 42 +++++++++++++---- apps/events/docs/ROADMAP-v2.md | 9 ++-- apps/events/frontend/package-lock.json | 4 +- apps/events/frontend/package.json | 2 +- apps/events/package-lock.json | 4 +- apps/events/package.json | 2 +- 13 files changed, 176 insertions(+), 29 deletions(-) diff --git a/apps/events/CHANGELOG.md b/apps/events/CHANGELOG.md index 8713b75..59b1ba5 100644 --- a/apps/events/CHANGELOG.md +++ b/apps/events/CHANGELOG.md @@ -7,6 +7,44 @@ and this project follows [Semantic Versioning](https://semver.org/). ## [Unreleased] +## [1.46.0] - 2026-10-28 + +### Added + +- **Volunteer rosters** — plan who serves where (Supervisor → **Volunteer rosters**). + - **Serving roles** (Welcome, Parking, Kids, Sound…) per event, or per session on a multi-session + event, with the number of people needed, optional shift times and a short description. Each + event or session has its own roster; nothing repeats by itself. + - **Anyone with an account can volunteer:** My account → **Serving** lists events looking for + people and lets you sign up for a role that isn't full. Supervisors can also put someone on a + role (even beyond the number needed). Nobody can be in two roles at the same time. Supervisors + get a sign-up link to share (it works for hidden events too). + - **Reminders** by WhatsApp or email the day before a shift. + - **"Can't make it" swaps:** the volunteer asks for cover, the event's other volunteers are told, + and the first to accept takes the place straight away — no approval. The event's notification + recipients get an email about every swap and every withdrawal. + - **Check-in on the day:** volunteers scan the event's check-in QR code (show it on a screen or + print it) with their phone camera and are checked in for that day's shifts; staff can tick + people in on Staff → **Volunteers**, and undo it. + - **Kids rooms:** a role can be linked to a kids room. Its volunteers count as leaders on duty + in that room once they check in (for the room's ratio), and the room screen lists who is + rostered but not in yet. + - **Free volunteer ticket**, off by default: choose a ticket per event (or add a free + "Volunteer" ticket) and everyone on the roster gets a free place on it unless they already have + a ticket. It's given back when they leave the roster. + - **Roster sheet** with phone numbers, check-in times and a printable view; fill rate per + event; **hours served** per person across events. + - Audit log entries for the volunteer ticket, role changes, people put on or taken off a roster + and check-ins by hand; opening a roster is in the access log. "Download my data" includes + your shifts; anonymising an account gives up its future shifts. + - Background job `volunteers` (every 15 minutes, `VOLUNTEER_JOBS_ENABLED`) sends the reminders. + +### Fixed + +- **The kids check-in ticket was offered publicly:** the free "Kids check-in" ticket from 1.45.0 + showed on the event page and could be booked by anyone. It (and the new volunteer ticket) is now + left out of public event pages and lists and refused on public registration; staff still see it. + ## [1.45.1] - 2026-10-28 ### Fixed diff --git a/apps/events/FEATURES.md b/apps/events/FEATURES.md index 63ca840..b8b7f38 100644 --- a/apps/events/FEATURES.md +++ b/apps/events/FEATURES.md @@ -31,12 +31,13 @@ WhatsApp · PM2 for process management · optional Sentry for error monitoring. 15. [Site settings & setup wizard](#site-settings--setup-wizard) 16. [Multi-campus](#multi-campus) 17. [Kids check-in](#kids-check-in) -18. [Accounts & security](#accounts--security) -19. [Privacy (POPIA)](#privacy-popia) -20. [Help system](#help-system) -21. [Background jobs](#background-jobs) -22. [Operations](#operations) -23. [Page map](#page-map) +18. [Volunteer rosters](#volunteer-rosters) +19. [Accounts & security](#accounts--security) +20. [Privacy (POPIA)](#privacy-popia) +21. [Help system](#help-system) +22. [Background jobs](#background-jobs) +23. [Operations](#operations) +24. [Page map](#page-map) --- @@ -397,6 +398,8 @@ logout controls. Disconnected sessions are recovered automatically. and print an event's tickets. - **Kids check-in** (`/dashboard/staff/kids`) and the **room screen** (`/dashboard/staff/kids/rooms`) — see [Kids check-in](#kids-check-in). +- **Volunteers** (`/dashboard/staff/volunteers`) — today's roster, ticking volunteers in and the + check-in QR code — see [Volunteer rosters](#volunteer-rosters). --- @@ -594,6 +597,43 @@ label printers. changed only by parents, supervisors and admins (audited); opening the desk/room screens and offline downloads are in the access log; a child's profile is deleted after **6 months** without a check-in (Admin → Privacy → Retention). +- **Volunteers in kids rooms:** a serving role linked to a room puts its volunteers on duty there + when they check in; the room screen lists who is rostered but not in yet. +- The kids ticket is never offered publicly (left out of public event pages, refused on public + registration). + +--- + +## Volunteer rosters + +Who serves where, for an event or each session. + +- **Roles** (Supervisor → Volunteer rosters, `/dashboard/supervisor/volunteers`): name, people + needed, optional shift times (default: the session's or event's times), description, and + optionally a kids room. On a multi-session event each role is for one session. A role can't be + deleted once someone has checked in for it. +- **Volunteering** (My account → Serving, `/dashboard/user/serving`): anyone with an account signs + up for a role that isn't full; supervisors can also put people on (beyond the number needed). + Nobody can be in two roles whose shifts overlap. `?event=` opens one event (the sign-up link + supervisors share, also for hidden events). Volunteers are told when they're put on, taken off, + or a role is deleted, and get a **reminder the day before**. +- **Swaps:** "Can't make it" asks for cover — the event's other volunteers are told and the request + shows on everyone's Serving page; the first to accept takes the place at once (no approval). The + event's notification recipients (or its creator) are emailed about every swap and withdrawal. +- **Check-in:** volunteers scan the event's **check-in QR code** (Check-in QR tab, or Staff → + Volunteers) with their phone camera → `/serve/check-in` → every shift of theirs on that day is + checked in. Staff can tick people in by hand (and undo). Check-in opens on the day of the shift + and closes when it ends. +- **Kids rooms:** checking in for a role linked to a kids room puts the volunteer on duty in that + room (counted for the ratio, like "I'm on duty"); undoing the check-in takes them off. +- **Volunteer ticket** (off by default): choose a main ticket of the event, or add a free + "Volunteer" ticket. Volunteers without a ticket get a free place on it (in My Events); it's + cancelled when they leave the roster (unless it was scanned), moves with a swap, and is never + offered publicly. +- **Reports:** roster sheet (phone numbers, check-in time and how), printable; fill rate per event; + **hours served** per person (checked-in shifts × shift length) over all events or one. +- **Read-only licence:** new roles and sign-ups are blocked; check-ins, swaps and withdrawals keep + working. --- @@ -713,6 +753,7 @@ can't start, the same jobs run on in-process timers. | `payment-status` — look up PayFast checkouts (10 min – 3 days old) whose notification never arrived, and record them | Every 15 minutes (`PAYMENT_STATUS_JOB_ENABLED=false`) | | `feedback` — post-event feedback forms and their 3-day reminder | Every 15 minutes (`FEEDBACK_JOB_ENABLED=false`) | | `sessions` — session reminders, and certificates for events that ended in the last 14 days | Every 5 minutes (`SESSION_JOBS_ENABLED=false`) | +| `volunteers` — volunteer reminders the day before a shift | Every 15 minutes (`VOLUNTEER_JOBS_ENABLED=false`) | | `consent` — parental consent reminders, and deleting medical details after events | 09:00 daily (`CONSENT_JOBS_ENABLED=false`) | | `privacy` — remind admins of privacy requests due within a week or overdue | 08:00 daily (`PRIVACY_JOBS_ENABLED=false`) | | `retention` — delete/anonymise personal information past its retention period (Admin → Privacy → Retention) | 03:30 daily (`RETENTION_JOBS_ENABLED=false`) | @@ -777,9 +818,10 @@ can't start, the same jobs run on in-process timers. | `/waitlist/claim/[token]` | Public | Claim a waitlist place | | `/certificates/verify/[code]` | Public | Check a completion certificate | | `/unsubscribe?t=…` | Public | Unsubscribe from news (link in news emails/WhatsApps) | +| `/serve/check-in?code=…` | User (logs in first) | Volunteer check-in (where the event's check-in QR code leads) | | `/self-service` | Supervisor-unlocked | Kiosk | | `/set-banner` | Supervisor | Site banner | -| `/dashboard/user` (+ `/payments`, `/donate`, `/forms`, `/profile`, `/privacy`, `/kids`, `/reset-password`) | User | My Events | -| `/dashboard/staff` (+ `/ticket-scanning`, `/event-tickets`, `/my-groups`, `/kids`, `/kids/rooms`) | Staff | Staff tools | -| `/dashboard/supervisor` (+ `/events`, `/event-options`, `/at-the-door`, `/manual`, `/manual-registration`, `/payments`, `/coupons`, `/waitlist`, `/attendance`, `/consent`, `/offline-scans`, `/allocations`, `/kids`, `/email-attendees`, `/whatsapp-attendees`, `/forms`, `/reports`) | Supervisor | Supervisor tools | +| `/dashboard/user` (+ `/payments`, `/donate`, `/forms`, `/profile`, `/privacy`, `/kids`, `/serving`, `/reset-password`) | User | My Events | +| `/dashboard/staff` (+ `/ticket-scanning`, `/event-tickets`, `/my-groups`, `/kids`, `/kids/rooms`, `/volunteers`) | Staff | Staff tools | +| `/dashboard/supervisor` (+ `/events`, `/event-options`, `/at-the-door`, `/manual`, `/manual-registration`, `/payments`, `/coupons`, `/waitlist`, `/attendance`, `/consent`, `/offline-scans`, `/allocations`, `/kids`, `/volunteers`, `/email-attendees`, `/whatsapp-attendees`, `/forms`, `/reports`) | Supervisor | Supervisor tools | | `/dashboard/admin` (+ `/users`, `/registrations`, `/forms`, `/cashup`, `/cashup/[id]`, `/audit-log`, `/data-requests`, `/privacy`, `/settings`) | Admin | Admin tools | diff --git a/apps/events/SETTINGS.md b/apps/events/SETTINGS.md index ad5ab34..3c704ca 100644 --- a/apps/events/SETTINGS.md +++ b/apps/events/SETTINGS.md @@ -116,6 +116,7 @@ Managed in the Payments tab (through `/api/payments/providers/settings` and `/ap | `PRIVACY_JOBS_ENABLED` (env) | `true` | The daily 08:00 `privacy` job that reminds admins of requests due within a week or overdue. | | `retention_policies` | Inactive accounts 60 months (on), form answers 12, login history 24, payment details 24, children at kids check-in (`kids_profiles`) 6, audit/access logs 60 — all on | Admin → Privacy → Retention (JSON `{ policies: { key: { enabled, months } }, reviewedAt, reviewedBy }`). Minimums: inactive accounts and logs 12 months, login history and payment details 3, form answers and kids profiles 1; maximum 240. Saving marks them reviewed (readiness check). | | `retention_last_run` | — | When the `retention` job last ran and what it did (readiness check: within 2 days). | +| `VOLUNTEER_JOBS_ENABLED` (env) | `true` | The `volunteers` job (every 15 minutes) that sends volunteer reminders the day before a shift. | | `RETENTION_JOBS_ENABLED` (env) | `true` | The nightly 03:30 `retention` job. Off means nothing expires automatically. | | `wawp_webhook_last_seen` | — | Set when WAWP's webhook arrives with the right secret; the readiness page uses it to check WhatsApp STOP is set up. | | `privacy_notice_draft` | — | The unpublished draft from Admin → Privacy → Privacy notice (JSON). Published versions are in the `PrivacyNotice` table. With no published version the built-in notice (`backend/src/utils/privacyNotice.js`) is shown. The notice's org name, Information Officer, website, emails and medical retention days come from the settings above when it's shown. | diff --git a/apps/events/backend/.env.example b/apps/events/backend/.env.example index d4bd2ed..5eaf7a7 100644 --- a/apps/events/backend/.env.example +++ b/apps/events/backend/.env.example @@ -75,6 +75,8 @@ WAITLIST_JOB_ENABLED=true # WAITLIST_JOB_INTERVAL_MS=600000 # Payments: every 15 minutes, look up PayFast checkouts whose notification never arrived PAYMENT_STATUS_JOB_ENABLED=true +# Volunteer rosters: reminders the day before a shift (every 15 minutes) +VOLUNTEER_JOBS_ENABLED=true # Privacy (POPIA): daily 08:00 reminder to admins of data requests due within a week PRIVACY_JOBS_ENABLED=true # Privacy (POPIA): nightly 03:30 retention job (Admin → Privacy → Retention). Note: inactive diff --git a/apps/events/backend/API_DOCUMENTATION.md b/apps/events/backend/API_DOCUMENTATION.md index ae90764..fc51f15 100644 --- a/apps/events/backend/API_DOCUMENTATION.md +++ b/apps/events/backend/API_DOCUMENTATION.md @@ -922,6 +922,41 @@ Allergies, medical and custody notes are stored encrypted. Staff routes are camp | GET | `/api/kids/events/:eventId/offline?deviceId=&sessionId=` | staff+ | Offline snapshot: board plus `families` and `codes` (20 reserved for the device). Access log `kids_offline` | | POST | `/api/kids/events/:eventId/sync` | staff+ | `{ deviceId, occasion, checkIns: [{ clientId, familyId, childId, roomId, code, at }], checkOuts: [{ clientId, collectedBy, at }] }` → `{ checkedIn, checkedOut, conflicts }`; idempotent by `clientId`; audited as `kids_offline_sync` | +Since 1.46.0 board rooms also carry `rostered: [{ userId, name, checkedIn }]` (volunteers on a serving +role linked to the room); checked-in ones are counted in `leaders`. + +## Volunteer rosters + +Volunteer rosters (1.46.0, `src/utils/volunteers.js`). A **serving role** belongs to an event, or to +one session of a multi-session event (`sessionId` required there), with `needed` people and optional +`startsAt`/`endsAt` (default: the session's or event's times). A **slot** is a person on a role; +nobody can hold two slots whose shifts overlap (`409 SHIFT_CLASH`). When `Event.volunteerOptionId` +is set, each volunteer without a ticket gets a free place on it (cancelled when they leave, moved +with a swap). `volunteerOptionId` and `kidsOptionId` are left out of public event pages +(`GET /api/events`, `GET /api/events/:id` for non-staff) and refused on public registration. Staff +routes are campus-scoped. + +| Method | Path | Auth | Description | +|--------|------|------|-------------| +| GET | `/api/volunteers/me` | user | `{ slots, cover, events }` — my shifts (upcoming and the last week; `canCheckIn`, `swapId`, `hasTicket`), open cover requests I could take, and public events with roles | +| GET | `/api/volunteers/events/:eventId` | user | `{ event, sessions, roles, totals }` — each role with `shift`, `needed`, `filled`, `full`, `mine`, `coverNeeded` (no names) | +| POST | `/api/volunteers/roles/:id/sign-up` | user | `201 { slotId, ticket }`; `409 ROLE_FULL`, `409 SHIFT_CLASH`. Blocked in licence read-only mode | +| DELETE | `/api/volunteers/slots/:id` | user | Withdraw (not after check-in or once the shift is over); the event's notify recipients are emailed | +| POST | `/api/volunteers/slots/:id/swap` | user | `{ note? }` → `{ swapId }` — "can't make it"; the event's other volunteers are told | +| DELETE | `/api/volunteers/swaps/:id` | user | Cancel my cover request | +| POST | `/api/volunteers/swaps/:id/accept` | user | Take the place over at once → `{ slotId, role, event }`; `409 SWAP_CLOSED` if someone was first. Both volunteers and the event's notify recipients are told | +| POST | `/api/volunteers/check-in` | user | `{ qr }` (`SERVE-`) → `{ event, checkedIn: [{ role, kidsRoom }], already }` for my shifts on today. `404 BAD_QR`, `404 NOT_ROSTERED`, `400 NOT_TODAY`. A kids-room role starts a `KidsRoomDuty` (`fromRoster`) | +| GET | `/api/volunteers/manage/events?all=1` | staff+ | Events with roles from the last 30 days on; `all=1` (supervisors) every upcoming event | +| GET | `/api/volunteers/manage/events/:eventId?log=1` | staff+ | The roster with `volunteers: [{ slotId, name, phone, email, checkedInAt, checkInMethod, swapOpen, hasTicket }]` per role, and `totals: { needed, filled, checkedIn, fillRate }`. `log=1` writes the access log (`volunteer_roster`) | +| GET | `/api/volunteers/manage/events/:eventId/qr` | staff+ | `{ token, qr }` — the check-in QR value (the page encodes `/serve/check-in?code=`) | +| POST | `/api/volunteers/manage/slots/:id/check-in` | staff+ | `{ undo? }` — check in by hand (or undo, which ends rostered kids-room duty). Audited as `volunteer_checked_in_manual` | +| GET / PUT | `/api/volunteers/manage/events/:eventId/settings` | supervisor+ | `{ optionId }` — the volunteer ticket: a main ticket covering the whole event, `'new'` for a free "Volunteer" ticket, `null` = off (default). Also returns the event's `kidsRooms`. Audited as `volunteer_settings_updated` | +| POST | `/api/volunteers/manage/events/:eventId/roles` | supervisor+ | `{ name, needed, sessionId?, startsAt?, endsAt?, description?, kidsRoomId? }`. Audited as `volunteer_roles_changed`; blocked in read-only mode | +| PUT / DELETE | `/api/volunteers/manage/roles/:id` | supervisor+ | Change / delete a role (delete refused once someone checked in; its volunteers are told) | +| POST | `/api/volunteers/manage/roles/:id/assign` | supervisor+ | `{ userId }` — allowed beyond `needed`; the person is told. Audited as `volunteer_assigned` | +| DELETE | `/api/volunteers/manage/slots/:id` | supervisor+ | Take someone off (not after check-in); they're told. Audited as `volunteer_removed` | +| GET | `/api/volunteers/manage/hours?eventId=&from=&to=` | supervisor+ | `[{ userId, name, shifts, hours, events }]` — checked-in shifts × shift length, most first | + ## Webhooks | Method | Path | Auth | Description | diff --git a/apps/events/backend/package-lock.json b/apps/events/backend/package-lock.json index 4b84745..1edc936 100644 --- a/apps/events/backend/package-lock.json +++ b/apps/events/backend/package-lock.json @@ -1,12 +1,12 @@ { "name": "event-management-backend", - "version": "1.45.1", + "version": "1.46.0", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "event-management-backend", - "version": "1.45.1", + "version": "1.46.0", "hasInstallScript": true, "dependencies": { "@prisma/adapter-pg": "^7.10.1", diff --git a/apps/events/backend/package.json b/apps/events/backend/package.json index 34c0d17..f556311 100644 --- a/apps/events/backend/package.json +++ b/apps/events/backend/package.json @@ -1,6 +1,6 @@ { "name": "event-management-backend", - "version": "1.45.1", + "version": "1.46.0", "description": "Event Management System Backend", "main": "src/index.js", "scripts": { diff --git a/apps/events/docs/HANDOVER.md b/apps/events/docs/HANDOVER.md index 679ebe1..34f4113 100644 --- a/apps/events/docs/HANDOVER.md +++ b/apps/events/docs/HANDOVER.md @@ -1,6 +1,6 @@ # Handover — where things stand and how to carry on -Last updated: 2026-10-28, after **1.45.1** (and Hub 1.1.0). The plan itself is in +Last updated: 2026-10-28, after **1.46.0** (and Hub 1.1.0). The plan itself is in [ROADMAP-v2.md](./ROADMAP-v2.md) (decisions table at the end); the previous round of features is in [FEATURES-ROUND-1.md](./FEATURES-ROUND-1.md). @@ -14,6 +14,7 @@ encrypted settings unreadable or break existing installs. | Version | What | |---------|------| +| 1.46.0 | **Volunteer rosters** (§5): serving roles per event or session, anyone signs up (or supervisors assign), day-before reminders, "can't make it" swaps that happen on accept (notify recipients emailed), self check-in with the event's QR code or by staff, kids-room roles count as leaders on duty, free volunteer ticket off by default, roster sheet and hours served. Also fixes the 1.45.0 kids ticket being offered publicly | | 1.45.1 | Privacy notice (built-in text) and terms of use brought up to date with kids check-in, sessions, certificates, campuses, the Hub heartbeat and where data is stored. Installs with a published notice must publish a new version themselves | | 1.45.0 | **Kids check-in** (§4), fully digital: families/children/authorised adults kept between events (My account → Kids), staff desk with pickup codes and a "write on the sticker" panel, rooms with age ranges and ratios, room screen (on duty, call parent, alerts), check-out by code (wrong code alerts, override with reason), offline desk with reserved codes, attendance through a free kids ticket; 6-month retention rule for children | | 1.44.0 | **Campus-scoped staff** (§12 part 2): Admin → Users "Limit to campuses"; `utils/campusScope.js` on every staff/supervisor route (and owner-or-staff routes), lists filtered, scanner names the other campus, church-wide events view/scan/door-only for scoped staff; route test `tests/campusScopeRoutes.test.js` | @@ -41,13 +42,10 @@ encrypted settings unreadable or break existing installs. ## Next up -1. **Roll out the update requests:** deploy **Hub 1.1.0**, then set "Latest Cross Events release" - to `1.42.0` in Hub → Settings, then update the sites to 1.42.0 (the last update done without a - request). A 1.42.0 site talking to an older Hub shows "The Hub doesn't take update requests yet". -2. **Try `scripts/install.sh` on a test server.** The production Hub key is built in since - 1.42.1, so a fresh install needs no `HUB_PUBLIC_KEY`; existing installs can drop it from `.env`. -3. **1.46.0 — Volunteer rosters** (§5), per campus. Wallet passes (§7) are removed from scope - (2026-10-28), so 1.47.0 is event series & cloning and 1.48.0 outbound webhooks. +Hub 1.1.0 is deployed with update requests rolled out, and `scripts/install.sh` has been tried on +a test server (both done 2026-10-28). + +1. **1.47.0 — Event series & cloning** (§6), then **1.48.0 — outbound webhooks** (§8). ## Working on this repo @@ -254,6 +252,30 @@ encrypted settings unreadable or break existing installs. - e2e: `kids.spec.ts` on the seeded hidden "E2E Kids Church" (set up, parent adds a child, desk checks in, parent sees the code, wrong code then the right one, room alert). +## Where volunteer rosters live (1.46.0) + +- `backend/src/utils/volunteers.js` — everything: shifts (`shiftOf`: the role's own times, else its + session's, else the event's), overlap and check-in-window rules, roles, sign-up / leave / swaps, + the free volunteer place (`givePlace` / `releasePlace`, `VolunteerSlot.registrationId`), QR and + manual check-in (kids-room roles start a `KidsRoomDuty` with `fromRoster`), `rosteredForRooms` + (used by the kids board), messages, the `volunteers` reminder job, hours served, and the privacy + parts (`exportVolunteering`, `forgetVolunteer`). Pure parts tested in `tests/volunteers.test.js`. +- `reservedOptionIds` / `publicOptions` there: the kids and volunteer tickets are left out of public + event pages and refused on public registration (`eventController`, `registrationController`). + **A new staff-only ticket type should be added to `reservedOptionIds`.** +- `controllers/volunteerController.js` + `routes/volunteerRoutes.js` (`/api/volunteers`); campus + resolvers `servingRole` and `volunteerSlot`; sign-ups, new roles and assigning are in `readOnly.js`. +- Swaps: no approval — accepting moves the slot at once (claimed with an `updateMany` on + `status: 'open'` so two people can't both take it); `tellOrganisers` emails + `getEventNotifyEmails(event)` (notify recipients, else the creator), not the registrations inbox. +- The check-in QR holds `SERVE-`; the page encodes it as a URL + (`/serve/check-in?code=…`) so phone cameras open it directly. +- Frontend: `lib/volunteers.ts`, `components/volunteers/{RosterSheet,CheckInQr}.tsx`, pages + `dashboard/supervisor/volunteers` (roles, QR, ticket, hours), `dashboard/staff/volunteers` (the day), + `dashboard/user/serving` (`?event=` opens one event — the shareable sign-up link), `serve/check-in`. +- e2e: `volunteers.spec.ts` on the seeded hidden "E2E Serving Sunday" (role, ticket hidden publicly, + sign-up, cover request, staff take over, QR check-in, roster). + ## Known gaps / follow-ups - WhatsApp STOP only works once someone pastes the webhook URL from Site settings → WhatsApp @@ -275,3 +297,7 @@ encrypted settings unreadable or break existing installs. - Kids check-in: the offline desk is tested at the API level (sync, idempotency, code reservation), not in the browser. A family's two parents share one family; linking a second parent is done at the desk ("parents" endpoint) — there's no invite from My account yet. +- Volunteer rosters: if a volunteer edits their free volunteer registration on the edit page, the + volunteer ticket isn't among the public options, so saving drops it (the backend only refuses + adding or increasing it). Rare; the place is still in the roster, and a supervisor can give a + ticket at the door. Reminders are a single "day before" one (no per-event timing yet). diff --git a/apps/events/docs/ROADMAP-v2.md b/apps/events/docs/ROADMAP-v2.md index f9ca200..f93bd71 100644 --- a/apps/events/docs/ROADMAP-v2.md +++ b/apps/events/docs/ROADMAP-v2.md @@ -32,7 +32,9 @@ per campus, public filter and campus pages, home campus, filters, campus broadca 1.44.0 **campus-scoped staff** shipped (Admin → Users "Limit to campuses", every staff route checked). Wallet passes are removed from scope (2026-10-28), so everything after volunteer rosters moves up by one. 1.45.0 **kids check-in** shipped (fully digital: pickup codes, sticker panel, rooms with -ratios, offline desk). **Next: 1.46.0 Volunteer rosters.** +ratios, offline desk). 1.46.0 **volunteer rosters** shipped (roles per event or session, sign-ups and +assigning, swaps on accept, QR self check-in, kids-room roles on duty, optional volunteer ticket). +**Next: 1.47.0 Event series and cloning.** **Repositories:** @@ -443,7 +445,7 @@ Parents manage their family's children in My account and see pickup codes on the ## 5. Volunteer / serving rosters -Plan who serves where, for an event or each session. +Plan who serves where, for an event or each session. (Shipped in 1.46.0 — decisions below.) - **Serving roles** per event/session: Welcome, Parking, Kids, Sound, Kitchen… with the number of people needed. @@ -950,7 +952,7 @@ income justify the hardware: | 5 | 1.38.0 ✅ 1.39.0 ✅ 1.40.0 ✅ | **POPIA toolkit** (1.38.0: user privacy centre, unsubscribe, WhatsApp STOP, data requests inbox; 1.39.0: privacy notice editor + versions, operator register, consent log, access log; 1.40.0: retention jobs, breach register, children’s-data flags, readiness page) | Main selling point; retention jobs use the job queue | | 6 | 1.41.0 ✅ – 1.42.0 ✅ + Hub 1.0 ✅ – 1.1 ✅ | Install/update scripts, `/health`, licence step in `/setup`, "Connect to Hub", heartbeat, licence states — plus the **Hub** app (separate repo); rename to Cross Events (1.41.3); Request update (1.42.0 / Hub 1.1.0) | Must exist before the first church is sold; Hope Family Church registers as install #1 | | 7 | 1.43.0 ✅ – 1.44.0 ✅ | **Multi-campus**: 1.43.0 campuses (settings, events, public filter and landing pages, home campus, filters, messages, summaries); 1.44.0 campus-scoped staff | Kids rooms and volunteer roles are per campus, so campuses come first; scoping is split out because it's security-heavy | -| 8 | 1.45.0 ✅ – 1.46.0 | Kids check-in, Volunteer rosters | Depend on sessions and campuses | +| 8 | 1.45.0 ✅ – 1.46.0 ✅ | Kids check-in, Volunteer rosters | Depend on sessions and campuses | | 9 | 1.47.0 – 1.48.0 | Event series & cloning, Outbound webhooks (Wallet passes removed from scope) | Smaller, independent wins | | 10 | 1.49.0 – 1.51.0 | Admin dashboard/Ctrl+K/bulk actions, Afrikaans, Accessibility pass | Polish before the big release | | 11 | 1.52.0 | TypeScript backend + OpenAPI + `/api/v2` alongside v1 | The breaking-change groundwork | @@ -1005,6 +1007,7 @@ feature. | — | Updates | Sites show **Request update**, never the deploy command: the request goes to the Hub, which tells Joshua; he updates the server. 1.42.0 / Hub 1.1.0; Multi-campus and everything after moves up by one (2026-10-27) | | — | Wallet passes | **Removed from scope** (2026-10-28); everything after volunteer rosters moves up by one | | — | Kids check-in (1.45.0) | One release. **Fully digital** — no label printers: pickup code on the parent's phone, a "write on the sticker" panel for blank stickers. Staff desk only (no kiosk). Anyone with the pickup code can collect; families list authorised adults without accounts. Child profiles deleted after 6 months without a check-in (2026-10-28) | +| — | Volunteer rosters (1.46.0) | Anyone with an account can volunteer. Roles are per event (or per session) — rosters cover one event/session and never repeat. A swap needs no approval: it happens once someone accepts, and the event's notify recipients are emailed. Volunteers check in by scanning a QR code or are checked in by staff. The free volunteer ticket is off by default and chosen per event. A role linked to a kids room counts its checked-in volunteers as leaders on duty for the room's ratio (2026-10-28) | | — | POPIA: WhatsApp STOP | In 1.38.0, via WAWP's incoming `message` webhook with a secret in the URL (WAWP doesn't sign webhooks) (2026-10-23) | ## Still open diff --git a/apps/events/frontend/package-lock.json b/apps/events/frontend/package-lock.json index dc446be..092e82e 100644 --- a/apps/events/frontend/package-lock.json +++ b/apps/events/frontend/package-lock.json @@ -1,12 +1,12 @@ { "name": "hope-events-frontend", - "version": "1.45.1", + "version": "1.46.0", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "hope-events-frontend", - "version": "1.45.1", + "version": "1.46.0", "dependencies": { "@dnd-kit/core": "^6.3.1", "@hookform/resolvers": "^5.2.1", diff --git a/apps/events/frontend/package.json b/apps/events/frontend/package.json index 323d5e8..1b9f522 100644 --- a/apps/events/frontend/package.json +++ b/apps/events/frontend/package.json @@ -1,6 +1,6 @@ { "name": "hope-events-frontend", - "version": "1.45.1", + "version": "1.46.0", "private": true, "scripts": { "dev": "next dev --turbopack", diff --git a/apps/events/package-lock.json b/apps/events/package-lock.json index ac29822..9ff4ce2 100644 --- a/apps/events/package-lock.json +++ b/apps/events/package-lock.json @@ -1,12 +1,12 @@ { "name": "hope-events", - "version": "1.45.1", + "version": "1.46.0", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "hope-events", - "version": "1.45.1", + "version": "1.46.0", "license": "ISC", "devDependencies": { "@playwright/test": "^1.64.0", diff --git a/apps/events/package.json b/apps/events/package.json index da784af..bf0f2c1 100644 --- a/apps/events/package.json +++ b/apps/events/package.json @@ -1,6 +1,6 @@ { "name": "hope-events", - "version": "1.45.1", + "version": "1.46.0", "main": "index.js", "scripts": { "dev:backend": "cd backend && npm run dev",