diff --git a/apps/events/docs/HANDOVER.md b/apps/events/docs/HANDOVER.md index 5b79d58..d49b68a 100644 --- a/apps/events/docs/HANDOVER.md +++ b/apps/events/docs/HANDOVER.md @@ -44,7 +44,8 @@ encrypted settings unreadable or break existing installs. 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.45.0 — Kids check-in** (§4), then 1.46.0 volunteer rosters (§5) — both per campus. +3. **1.45.0 — Kids check-in** (§4, fully digital — no label printers), then 1.46.0 volunteer + rosters (§5) — both per campus. Wallet passes (§7) are removed from scope (2026-10-28). ## Working on this repo diff --git a/apps/events/docs/ROADMAP-v2.md b/apps/events/docs/ROADMAP-v2.md index e418562..d802941 100644 --- a/apps/events/docs/ROADMAP-v2.md +++ b/apps/events/docs/ROADMAP-v2.md @@ -30,7 +30,8 @@ Cross Events Hub); 1.42.0 **Request update** button instead of the deploy comman everything after moves up by one more (2026-10-27). 1.43.0 **campuses** shipped (settings, events per campus, public filter and campus pages, home campus, filters, campus broadcasts and summaries); 1.44.0 **campus-scoped staff** shipped (Admin → Users "Limit to campuses", every staff route checked). -**Next: 1.45.0 Kids check-in.** +Wallet passes are removed from scope (2026-10-28), so everything after volunteer rosters moves +up by one. **Next: 1.45.0 Kids check-in.** **Repositories:** @@ -46,10 +47,10 @@ per campus, public filter and campus pages, home campus, filters, campus broadca 1. [Multi-day events (sessions)](#1-multi-day-events-sessions) ← **first** 2. [Payment providers: PayFast](#2-payment-providers-payfast) 3. [POPIA toolkit](#3-popia-toolkit) -4. [Kids check-in with security labels](#4-kids-check-in-with-security-labels) +4. [Kids check-in (digital pickup codes)](#4-kids-check-in-digital-pickup-codes) 5. [Volunteer / serving rosters](#5-volunteer--serving-rosters) 6. [Event series and cloning](#6-event-series-and-cloning) -7. [Apple and Google Wallet tickets](#7-apple-and-google-wallet-tickets) +7. ~~[Apple and Google Wallet tickets](#7-apple-and-google-wallet-tickets)~~ — removed from scope 8. [Outbound webhooks](#8-outbound-webhooks) 9. [Admin dashboard, command palette, bulk actions](#9-admin-dashboard-command-palette-bulk-actions) 10. [Languages (Afrikaans first)](#10-languages-afrikaans-first) @@ -393,37 +394,49 @@ self-service privacy tools. --- -## 4. Kids check-in with security labels +## 4. Kids check-in (digital pickup codes) -A secure check-in/check-out flow for children's ministry and youth events. -**Builds on sessions (§1), attendees, parental consent and allocation groups.** +A secure check-in/check-out flow for children's ministry, run from a **staff desk**. +**Builds on sessions (§1), attendees, allocation groups and campuses (§12).** Fully digital — +no label printers (2026-10-28). -**Who:** Parents check in children (self-service kiosk or staff desk). -Kids-ministry staff run rooms. Supervisors set up rooms. +**Who:** Kids-ministry staff at the check-in desk and in the rooms. Supervisors set up rooms. +Parents manage their family's children in My account and see pickup codes on their phone. ### How it works -- Parent finds their family (phone number / QR from My account) and ticks the - children being dropped off. New children can be added on the spot. -- The system prints **two labels**: - - **Child label:** name, room, allergy/medical icons, short pickup code. - - **Parent label:** the same pickup code. -- **Check-out** requires scanning or typing the matching code. A mismatch - alerts the room leader. -- Rooms come from allocation groups (age/grade rules), with **ratios** (e.g. - 1 leader per 5 toddlers) and live room counts. -- **Page a parent:** room leader taps "Call parent" → WhatsApp/SMS to the - parent ("Please come to the Toddlers room"). -- Attendance per child per session feeds the attendance register. +- **Families and children are kept between events** (weekly kids church): a family has one or + more parent accounts, its children (name, date of birth, allergies, medical notes, custody + notes — the last three encrypted) and **authorised adults** (name, phone, relationship — no + account needed). Parents manage them under My account → Kids; staff can find a family by + phone, name or the parent's QR code and add a family or child on the spot. +- An event gets a **Kids check-in** switch (single events or one session per Sunday). The first + check-in makes a free registration under the parent with an attendee and ticket per child, and + each check-in writes a `TicketUsage`, so the attendance register, reports and campus scoping work + as they do for tickets. +- Each check-in gets a **pickup code** (4 characters, no 0/O/1/I, unique per event and day). The + parent sees it live on their phone (code + QR) and gets it by WhatsApp/email; it can also be + sent to an authorised adult. **Anyone with the code can collect** the child. +- **"Write on the sticker" panel** on the desk screen: first name, room, code and a short alert + (ALLERGY / MEDICAL) in large print, for volunteers to copy onto a blank sticker. The full + details stay on screen. +- **Rooms** are a "Kids rooms" allocation set: each room has an age range, capacity and a + **ratio** (children per leader). The room is suggested from the child's age. Room screens show + live cards (name, code, allergy/medical icons, custody notes) and counts: children in, leaders + on duty ("I'm on duty"), over-ratio and full warnings. +- **Check-out** by scanning the parent's QR or typing the code; the leader records who collected. + A wrong code alerts the room and is logged; "Override" needs a reason. +- **Page a parent:** "Call parent" → WhatsApp (email fallback) and a notice on the parent's page. ### Plumbing / edge cases -- Label printing via browser print with label-size CSS (Dymo / Brother label - printers, 62 mm and 89×36 mm presets); PDF fallback. -- Allergies and medical info come from the consent/medical fields; respect - the medical-info deletion rules. -- Custody notes ("Do not release to …") visible to room leaders only. -- Works on the existing offline-scanning foundations for flaky Wi-Fi. +- Medical and custody notes: room leaders, supervisors and admins only; never in messages; + room lists showing them are written to the access log. +- POPIA: families and children in `anonymiseUser` / `exportUserData`; retention rule — a child's + profile is deleted after **6 months** without a check-in; readiness flags children's data. +- Offline: the desk caches the event's families and checks in offline (device-prefixed codes, + synced later). Check-out offline only for children checked in on the same device. +- Audit log: overrides, wrong codes and custody-note changes. --- @@ -458,6 +471,8 @@ Plan who serves where, for an event or each session. ## 7. Apple and Google Wallet tickets +> **Removed from scope (2026-10-28).** Kept here for reference only; not planned for 2.0. + - "Add to Apple Wallet" / "Add to Google Wallet" buttons next to the PDF ticket, in email and in My Events. - Pass shows event, date (next session for multi-day), location, holder name, @@ -935,9 +950,9 @@ income justify the hardware: | 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 | -| 9 | 1.47.0 – 1.49.0 | Event series & cloning, Wallet passes, Outbound webhooks | Smaller, independent wins | -| 10 | 1.50.0 – 1.52.0 | Admin dashboard/Ctrl+K/bulk actions, Afrikaans, Accessibility pass | Polish before the big release | -| 11 | 1.53.0 | TypeScript backend + OpenAPI + `/api/v2` alongside v1 | The breaking-change groundwork | +| 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 | | 12 | **2.0.0** | **AI helpers** (§15 — headline feature: draft an event, summarise reports and feedback, draft messages, improve text; through the Hub with a rand cap per licence), v1 API removed, migration guide, marketing site/docs for selling | The release. AI needs the Hub (phase 6) for the key, metering and caps | Each phase should add matching help content (`frontend/src/content/help/`), @@ -987,6 +1002,8 @@ feature. | — | Campus-scoped staff (1.44.0) | Scoped staff: their campuses' events plus "All campuses" events, which they can view, scan, take door payments and do manual registrations for, but not set up, cash up or refund. Banner, provider reconciliation and unlinked donations: unscoped only; broadcasts limited to their campuses' audiences and their events' attendees; coupons only for their events. Other campuses' records answer "not found" except the scanner, which names the campus. Scopes ignored while campuses are off, with a warning (2026-10-27) | | — | Multi-campus split | Two releases: **1.43.0 campuses**, **1.44.0 campus-scoped staff**; everything after moves up by one. Scoped staff can view and scan "All campuses" events, only admins and unscoped supervisors edit them. "Everyone at campus X" = home campus X, plus (tick box) registrants of campus X's events in the last 12 months. Campus landing pages are in 1.43.0 (2026-10-27) | | — | 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) | | — | 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