From f55353ecc69e0f8955d64bdeb71154562bd65f7f Mon Sep 17 00:00:00 2001 From: joshua Date: Mon, 19 Oct 2026 13:24:44 +0200 Subject: [PATCH] Add parental consent for youth events Youth events need a name and date of birth for every attendee, and a parent/guardian's details for under-18s. Parents get an email and WhatsApp link to a consent page that records the signed name, time, IP, device and exact consent text; medical and emergency details are stored encrypted. Tickets are issued but check-in is blocked until consent is given (supervisor override audited). A daily job sends reminders and purges medical details after the retention period. Adds a supervisor consent tracker, consent status and medical list reports, and clears consent data when an account is anonymised. Co-Authored-By: Claude Opus 5.5 --- apps/events/CHANGELOG.md | 18 + apps/events/FEATURES.md | 14 +- apps/events/SETTINGS.md | 1 + apps/events/backend/.env.example | 2 + apps/events/backend/API_DOCUMENTATION.md | 26 ++ .../migration.sql | 71 ++++ apps/events/backend/prisma/schema.prisma | 119 +++++-- .../src/controllers/consentController.js | 264 ++++++++++++++ .../src/controllers/eventController.js | 25 +- .../src/controllers/registrationController.js | 26 +- .../src/controllers/ticketController.js | 22 ++ .../backend/src/controllers/userController.js | 2 + apps/events/backend/src/index.js | 44 +++ .../backend/src/routes/consentRoutes.js | 20 ++ apps/events/backend/src/utils/attendees.js | 55 ++- apps/events/backend/src/utils/consent.js | 332 ++++++++++++++++++ .../events/backend/src/utils/notifications.js | 1 + apps/events/backend/tests/attendees.test.js | 2 +- apps/events/backend/tests/consent.test.js | 135 +++++++ .../frontend/src/app/consent/[token]/page.tsx | 181 ++++++++++ .../app/dashboard/admin/audit-log/page.tsx | 6 + .../frontend/src/app/dashboard/admin/page.tsx | 3 +- .../src/app/dashboard/admin/settings/page.tsx | 12 + .../dashboard/staff/ticket-scanning/page.tsx | 41 ++- .../dashboard/supervisor/at-the-door/page.tsx | 14 +- .../app/dashboard/supervisor/consent/page.tsx | 251 +++++++++++++ .../app/dashboard/supervisor/events/page.tsx | 35 +- .../app/dashboard/supervisor/manual/page.tsx | 13 +- .../src/app/dashboard/supervisor/page.tsx | 3 +- .../app/register/[eventId]/RegisterForm.tsx | 13 +- .../frontend/src/app/self-service/page.tsx | 12 +- .../src/components/reports/ReportCatalog.ts | 4 + .../src/components/reports/ReportsV2.tsx | 88 ++++- .../components/shared/AttendeeNamesEditor.tsx | 86 ++++- .../src/components/shared/AttendeesPanel.tsx | 59 +++- .../src/content/help/event-detail.tsx | 2 +- .../frontend/src/content/help/registry.ts | 6 + .../content/help/staff-ticket-scanning.tsx | 5 +- .../src/content/help/supervisor-consent.tsx | 58 +++ .../src/content/help/supervisor-events.tsx | 2 +- apps/events/info.md | 3 +- 41 files changed, 1988 insertions(+), 88 deletions(-) create mode 100644 apps/events/backend/prisma/migrations/20261019121441_add_parental_consent/migration.sql create mode 100644 apps/events/backend/src/controllers/consentController.js create mode 100644 apps/events/backend/src/routes/consentRoutes.js create mode 100644 apps/events/backend/src/utils/consent.js create mode 100644 apps/events/backend/tests/consent.test.js create mode 100644 apps/events/frontend/src/app/consent/[token]/page.tsx create mode 100644 apps/events/frontend/src/app/dashboard/supervisor/consent/page.tsx create mode 100644 apps/events/frontend/src/content/help/supervisor-consent.tsx diff --git a/apps/events/CHANGELOG.md b/apps/events/CHANGELOG.md index c31f585..b39aa48 100644 --- a/apps/events/CHANGELOG.md +++ b/apps/events/CHANGELOG.md @@ -7,6 +7,24 @@ and this project follows [Semantic Versioning](https://semver.org/). ## [Unreleased] +### Added + +- Parental consent for youth events. A new "Requires parental consent" event setting (event wizard → Visibility) has its own consent text and optional medical info, emergency contact and photo consent questions. It turns on named attendees automatically. + - Registering then needs a name and date of birth for every main-ticket place. Anyone under 18 on the event's start date needs a parent or guardian's name, email and phone. + - This applies on the registration page, manual registration, at the door, the kiosk, and when editing names in My Events. +- The parent gets an email and a WhatsApp (always both) with a link to a new consent page (`/consent/`). There they read the text, answer the optional questions, type their full name and confirm they're the parent or guardian, then give or decline. + - The system records the time, IP, device, signed name, and the exact consent text and version shown. + - Medical and emergency details are stored encrypted. + - The registrant and the event's notification recipients are told the outcome. +- Tickets are still issued, but the scanner blocks check-in until consent is given, showing why. Supervisors can override, and the override is recorded in the audit log. On a youth event, a ticket with no named attendee counts as missing consent. +- A daily 09:00 job reminds unanswered requests after 2 days, then every 3 days until the event. It also deletes medical and emergency details a set number of days after the event (Site Settings → Legal, default 30). `CONSENT_JOBS_ENABLED=false` turns it off. +- Supervisor → Parental consent page: consent status per attendee, resend one or all pending requests, re-request consent after the consent text changes, and a printable, confidential medical & emergency list. Every view of the list is recorded in the audit log. +- New reports: "Parental consent status" and "Medical & emergency list". +- My Events shows each attendee's consent status, with a "Resend consent" button. +- Anonymising or closing an account also clears that person's attendees' parent, date-of-birth, medical and emergency details. +- New endpoints under `/api/consent`. `GET /api/tickets/scan-preview/:qrCode` now returns `consentStatus`, and `POST /api/tickets/scan/:qrCode` accepts `overrideConsent`. + - Requires the `add_parental_consent` database migration. + ## [1.14.0] - 2026-10-19 ### Added diff --git a/apps/events/FEATURES.md b/apps/events/FEATURES.md index 115894f..597b86f 100644 --- a/apps/events/FEATURES.md +++ b/apps/events/FEATURES.md @@ -134,6 +134,13 @@ Items & Pricing → Sections → Form → Visibility → Attachments**. added or changed later from My Events, and attendees can be sent a link to fill in their own form. Available on the registration page, manual registration, At the door and the kiosk. +- **Parental consent (youth events)** — on events that require it, every attendee + gives a date of birth; for anyone under 18, a parent or guardian gets an email and + a WhatsApp with a consent link. They read the event's consent text, optionally give + medical info, an emergency contact and photo consent, type their name to sign, and + give or decline. Tickets are issued but can't be checked in until consent is given + (supervisors can override, audited). Reminders go after 2 days, then every 3 days. + Medical details are encrypted and deleted a set number of days after the event. - **Coupon codes** — percentage, fixed-amount or free (comp) codes, entered under "Have a code?" on the registration page, in My Events (for unpaid registrations), manual registration, At the door and the kiosk. Codes can be limited to events, @@ -285,6 +292,9 @@ logout controls. Disconnected sessions are recovered automatically. Reconcile (Yoco transactions), and Payment Link. - **Coupon codes** (`/dashboard/supervisor/coupons`) — create, edit and turn off discount codes, and see who used each one. +- **Parental consent** (`/dashboard/supervisor/consent`) — consent status per + attendee on youth events, resend (one or all pending), re-request after the + consent text changes, and a printable medical & emergency list (audited). - **Email attendees / WhatsApp attendees** — bulk and scheduled messaging. - **Forms** — view, filter, edit and print form responses. - **Reports** — see [Reports](#reports). @@ -338,7 +348,7 @@ a viewer with its own filters, stat tiles and bar charts. | Category | Reports | |----------|---------| | Financial | Payments between dates · Revenue summary (by method) · Revenue detailed · Finance report (revenue & costs, after discounts) · Profit report · Discounts (coupon codes) | -| Registration | Attendees per event (grouped by option) · Registration type counts · Master orders breakdown · Registration status breakdown (count by registration or ticket quantity) | +| Registration | Attendees per event (grouped by option) · Registration type counts · Master orders breakdown · Registration status breakdown (count by registration or ticket quantity) · Parental consent status · Medical & emergency list | | Ticketing | Ticket usage summary | | Donations | Donations breakdown (used / unused per event) | | Cashup | Cashup reconciliation · Cashup audit trail | @@ -410,6 +420,7 @@ falling back to a general guide. |-----|----------| | Scheduled email/WhatsApp worker | Polls every 30 s (`SCHEDULED_EMAILS_INTERVAL_MS`) and purges sent jobs after 24 h | | Daily event summary email | 07:00 daily | +| Parental consent reminders, and deleting medical details after events | 09:00 daily (`CONSENT_JOBS_ENABLED=false` to disable) | | Database backup (`pg_dump`, gzipped, 14-day retention) | 02:00 daily (`BACKUP_ENABLED=false` to disable) | | Temp file cleanup (files older than 7 days in `/temp`) | Daily | @@ -442,6 +453,7 @@ falling back to a general guide. | `/contact`, `/legal/terms`, `/legal/privacy`, `/lockdown-rules` | Public | Info pages | | `/login`, `/register`, `/forgot-password`, `/reset-password`, `/activate-account` | Public | Accounts | | `/setup` | First run | Setup wizard | +| `/consent/[token]` | Parent/guardian | Give or decline parental consent | | `/self-service` | Supervisor-unlocked | Kiosk | | `/set-banner` | Supervisor | Site banner | | `/dashboard/user` (+ `/payments`, `/donate`, `/forms`, `/profile`, `/reset-password`) | User | My Events | diff --git a/apps/events/SETTINGS.md b/apps/events/SETTINGS.md index 74d20b8..231268d 100644 --- a/apps/events/SETTINGS.md +++ b/apps/events/SETTINGS.md @@ -66,6 +66,7 @@ or Branding tab has been saved even once — the wizard always writes | `legal_io_email` | `"io@example.com"` | Rendered as a `mailto:` link, so the placeholder stays a syntactically valid address on the IANA-reserved `example.com` domain rather than a bracketed non-email string that would break the link. | | `legal_website_url` | `"example.com"` | Same reasoning — used to build an `https://` link. | | `legal_effective_date` | `"[not yet set]"` | Plain text only, no link — a bracketed placeholder is fine here. | +| `consent_medical_retention_days` | `30` | Youth events: medical and emergency details from parental consent forms are deleted this many days after the event ends (daily 09:00 job). The consent record itself — who agreed, when, to which text — is kept. Set under Site Settings → Legal. | | `org_email` (as used on legal pages specifically) | `"privacy@example.com"` | Different fallback than `org_email`'s general default (blank) — also rendered as a `mailto:` link, so it needs to stay a valid-looking address. | ## WhatsApp diff --git a/apps/events/backend/.env.example b/apps/events/backend/.env.example index 7705d72..0db0eed 100644 --- a/apps/events/backend/.env.example +++ b/apps/events/backend/.env.example @@ -52,6 +52,8 @@ WAWP_INSTANCE_ID=your_wawp_instance_id DAILY_SUMMARY_ENABLED=true SCHEDULED_EMAILS_ENABLED=true SCHEDULED_EMAILS_INTERVAL_MS=30000 +# Daily 09:00 parental-consent job: reminders, and deleting medical details after events +CONSENT_JOBS_ENABLED=true # Nightly database backup at 02:00 (requires the `pg_dump` binary on this host). # Retention count is set via Admin → Site Settings → Backups (default 14). BACKUP_ENABLED=true diff --git a/apps/events/backend/API_DOCUMENTATION.md b/apps/events/backend/API_DOCUMENTATION.md index 804c91e..6b4bce0 100644 --- a/apps/events/backend/API_DOCUMENTATION.md +++ b/apps/events/backend/API_DOCUMENTATION.md @@ -19,6 +19,7 @@ Tokens are issued by `POST /api/users/login`. - [Event Attachments](#event-attachments) - [Registrations](#registrations) - [Coupons](#coupons) +- [Parental consent](#parental-consent) - [Payments](#payments) - [Tickets](#tickets) - [Broadcasts (Email)](#broadcasts-email) @@ -276,6 +277,31 @@ For unauthenticated (guest) registration on events with `requiresAuth: false`: --- +## Parental consent + +Youth events (`requiresParentalConsent`, plus `consentText`, `consentCollectMedical`, `consentCollectEmergency` and `consentCollectPhoto` on the event) need every main place named with a `dateOfBirth`. Attendees under 18 on the start date also need `parentName`, `parentEmail` and `parentPhone`. Changing `consentText` bumps `consentTextVersion`. + +| Method | Path | Auth | Description | +|--------|------|------|-------------| +| GET | `/api/consent/:token` | public | What the parent sees: attendee, event, consent text, fields to fill in | +| POST | `/api/consent/:token` | public | `{ decision: "give"\|"decline", signedName, isGuardian: true, medical?, emergency?, photoConsent? }` | +| GET | `/api/consent/events/:eventId` | staff+ | Consent status per attendee, with counts | +| POST | `/api/consent/requests/:id/resend` | user+ | Re-send one request with a new link (registrant or staff) | +| POST | `/api/consent/events/:eventId/resend-pending` | supervisor+ | Re-send every pending request | +| POST | `/api/consent/events/:eventId/rerequest` | supervisor+ | New requests for consent given on older text, and minors with none | +| GET | `/api/consent/events/:eventId/medical` | supervisor+ | Decrypted medical & emergency list (audited as `medical_list_viewed`) | + +How requests work: +- Requests go to the parent by both email and WhatsApp, whatever anyone's notification preference. +- Links are random tokens; only an HMAC is stored. They expire when the event ends. +- The answer stores the signed name, time, IP, device, and the exact text and version shown. +- Medical and emergency details are AES-256-GCM encrypted. A daily job (09:00, `CONSENT_JOBS_ENABLED=false` to disable) sends reminders (day 2, then every 3 days) and deletes them `consent_medical_retention_days` (default 30) after the event. + +Check-in rules: +- `GET /api/tickets/scan-preview/:qrCode` returns `consentStatus` (`not_required`, `missing`, `pending`, `given` or `declined`). +- `POST /api/tickets/scan/:qrCode` returns `403 { code: "CONSENT_REQUIRED" }` unless consent is given. +- Supervisors can pass `overrideConsent: true`, which is audited as `consent_override`. + ## Coupons | Method | Path | Auth | Description | diff --git a/apps/events/backend/prisma/migrations/20261019121441_add_parental_consent/migration.sql b/apps/events/backend/prisma/migrations/20261019121441_add_parental_consent/migration.sql new file mode 100644 index 0000000..1cc1e47 --- /dev/null +++ b/apps/events/backend/prisma/migrations/20261019121441_add_parental_consent/migration.sql @@ -0,0 +1,71 @@ +-- CreateEnum +CREATE TYPE "ConsentStatus" AS ENUM ('pending', 'given', 'declined'); + +-- AlterEnum +-- This migration adds more than one value to an enum. +-- With PostgreSQL versions 11 and earlier, this is not possible +-- in a single migration. This can be worked around by creating +-- multiple migrations, each migration adding only one value to +-- the enum. + + +ALTER TYPE "AdminAuditAction" ADD VALUE 'consent_override'; +ALTER TYPE "AdminAuditAction" ADD VALUE 'consent_rerequested'; +ALTER TYPE "AdminAuditAction" ADD VALUE 'medical_list_viewed'; + +-- AlterTable +ALTER TABLE "Attendee" ADD COLUMN "parentEmail" TEXT, +ADD COLUMN "parentName" TEXT, +ADD COLUMN "parentPhone" TEXT; + +-- AlterTable +ALTER TABLE "Event" ADD COLUMN "consentCollectEmergency" BOOLEAN NOT NULL DEFAULT false, +ADD COLUMN "consentCollectMedical" BOOLEAN NOT NULL DEFAULT false, +ADD COLUMN "consentCollectPhoto" BOOLEAN NOT NULL DEFAULT false, +ADD COLUMN "consentText" TEXT, +ADD COLUMN "consentTextVersion" INTEGER NOT NULL DEFAULT 1, +ADD COLUMN "requiresParentalConsent" BOOLEAN NOT NULL DEFAULT false; + +-- CreateTable +CREATE TABLE "ConsentRequest" ( + "id" TEXT NOT NULL, + "attendeeId" TEXT NOT NULL, + "eventId" TEXT NOT NULL, + "tokenHash" TEXT NOT NULL, + "status" "ConsentStatus" NOT NULL DEFAULT 'pending', + "textVersion" INTEGER NOT NULL, + "consentText" TEXT NOT NULL, + "parentName" TEXT, + "parentEmail" TEXT, + "parentPhone" TEXT, + "signedName" TEXT, + "ip" TEXT, + "device" TEXT, + "medical" TEXT, + "emergency" TEXT, + "photoConsent" BOOLEAN, + "respondedAt" TIMESTAMP(3), + "lastSentAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP, + "remindersSent" INTEGER NOT NULL DEFAULT 0, + "expiresAt" TIMESTAMP(3) NOT NULL, + "medicalPurgedAt" TIMESTAMP(3), + "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP, + + CONSTRAINT "ConsentRequest_pkey" PRIMARY KEY ("id") +); + +-- CreateIndex +CREATE UNIQUE INDEX "ConsentRequest_tokenHash_key" ON "ConsentRequest"("tokenHash"); + +-- CreateIndex +CREATE INDEX "ConsentRequest_attendeeId_createdAt_idx" ON "ConsentRequest"("attendeeId", "createdAt"); + +-- CreateIndex +CREATE INDEX "ConsentRequest_eventId_status_idx" ON "ConsentRequest"("eventId", "status"); + +-- AddForeignKey +ALTER TABLE "ConsentRequest" ADD CONSTRAINT "ConsentRequest_attendeeId_fkey" FOREIGN KEY ("attendeeId") REFERENCES "Attendee"("id") ON DELETE CASCADE ON UPDATE CASCADE; + +-- AddForeignKey +ALTER TABLE "ConsentRequest" ADD CONSTRAINT "ConsentRequest_eventId_fkey" FOREIGN KEY ("eventId") REFERENCES "Event"("id") ON DELETE CASCADE ON UPDATE CASCADE; + diff --git a/apps/events/backend/prisma/schema.prisma b/apps/events/backend/prisma/schema.prisma index 60d0867..17a8480 100644 --- a/apps/events/backend/prisma/schema.prisma +++ b/apps/events/backend/prisma/schema.prisma @@ -110,37 +110,45 @@ model User { } model Event { - id String @id @default(uuid()) - title String - description String? - startDate DateTime - endDate DateTime - registrationDeadline DateTime? - goLiveAt DateTime @default(now()) - price Float - picture String? - isActive Boolean @default(true) - isHidden Boolean @default(false) - requiresAuth Boolean @default(true) - requiresRegistration Boolean @default(true) + id String @id @default(uuid()) + title String + description String? + startDate DateTime + endDate DateTime + registrationDeadline DateTime? + goLiveAt DateTime @default(now()) + price Float + picture String? + isActive Boolean @default(true) + isHidden Boolean @default(false) + requiresAuth Boolean @default(true) + requiresRegistration Boolean @default(true) // Lets a payer name each person on a group registration (one named ticket each). - allowNamedAttendees Boolean @default(false) - contactName String? - contactPhone String? - contactEmail String? - location String? - createdAt DateTime @default(now()) - updatedAt DateTime @updatedAt - createdById String? - createdBy User? @relation(fields: [createdById], references: [id], onDelete: SetNull) - redirectUrl String? @unique - eventOptions EventOption[] - registrations Registration[] - payments Payment[] - tickets Ticket[] - attachments EventAttachment[] - form EventForm? - Section Section[] + allowNamedAttendees Boolean @default(false) + // Youth event: every attendee gives a date of birth, and a parent/guardian must give + // consent for anyone under 18 before they can be checked in. + requiresParentalConsent Boolean @default(false) + consentText String? + consentTextVersion Int @default(1) + consentCollectMedical Boolean @default(false) + consentCollectEmergency Boolean @default(false) + consentCollectPhoto Boolean @default(false) + contactName String? + contactPhone String? + contactEmail String? + location String? + createdAt DateTime @default(now()) + updatedAt DateTime @updatedAt + createdById String? + createdBy User? @relation(fields: [createdById], references: [id], onDelete: SetNull) + redirectUrl String? @unique + eventOptions EventOption[] + registrations Registration[] + payments Payment[] + tickets Ticket[] + attachments EventAttachment[] + form EventForm? + Section Section[] cashupStatus CashupStatus @default(open) cashupDraft Json? @@ -156,8 +164,9 @@ model Event { // Users who should receive registration/payment/daily-summary notifications for this // event. Falls back to `createdBy` when empty (see backend/src/utils/notifications.js). - notifyRecipients User[] @relation("EventNotifyRecipients") + notifyRecipients User[] @relation("EventNotifyRecipients") coupons CouponEvent[] + consentRequests ConsentRequest[] @@index([createdById]) @@index([closedById]) @@ -438,6 +447,9 @@ enum AdminAuditAction { coupon_updated coupon_disabled coupon_applied_manual + consent_override + consent_rerequested + medical_list_viewed } // Append-only audit trail for admin/supervisor-initiated actions with money or @@ -963,6 +975,9 @@ model Attendee { userId String? // existing account matched by email/phone dateOfBirth DateTime? gender String? + parentName String? + parentEmail String? + parentPhone String? order Int @default(0) createdAt DateTime @default(now()) updatedAt DateTime @updatedAt @@ -971,8 +986,50 @@ model Attendee { user User? @relation(fields: [userId], references: [id], onDelete: SetNull) ticket Ticket? formResponses FormResponse[] + consentRequests ConsentRequest[] @@index([registrationId]) @@index([registrationOptionId]) @@index([userId]) } + +// ─── Parental consent ───────────────────────────────────────────────────────── + +enum ConsentStatus { + pending + given + declined +} + +// A request for a parent/guardian to consent for one under-18 attendee. Only the hash +// of the link token is stored. A new request (e.g. after the consent text changes) +// supersedes earlier ones for the same attendee; the latest one decides check-in. +model ConsentRequest { + id String @id @default(uuid()) + attendeeId String + eventId String + tokenHash String @unique + status ConsentStatus @default(pending) + textVersion Int + consentText String // the exact text the parent was shown + parentName String? + parentEmail String? + parentPhone String? + signedName String? + ip String? + device String? + medical String? // encrypted JSON (utils/encryption.js); purged after the event + emergency String? // encrypted JSON; purged after the event + photoConsent Boolean? + respondedAt DateTime? + lastSentAt DateTime @default(now()) + remindersSent Int @default(0) + expiresAt DateTime + medicalPurgedAt DateTime? + createdAt DateTime @default(now()) + attendee Attendee @relation(fields: [attendeeId], references: [id], onDelete: Cascade) + event Event @relation(fields: [eventId], references: [id], onDelete: Cascade) + + @@index([attendeeId, createdAt]) + @@index([eventId, status]) +} diff --git a/apps/events/backend/src/controllers/consentController.js b/apps/events/backend/src/controllers/consentController.js new file mode 100644 index 0000000..c49c769 --- /dev/null +++ b/apps/events/backend/src/controllers/consentController.js @@ -0,0 +1,264 @@ +const prisma = require('../config/db'); +const { safeErrorMessage } = require('../utils/errorUtils'); +const { logAdminAction } = require('../utils/adminAudit'); +const { getClientIp } = require('../utils/requestUtils'); +const { describeUserAgent } = require('../utils/userAgent'); +const { + isMinor, consentStatusFor, validateConsentAnswer, sealJson, openJson, latestRequestsFor, + findRequestByToken, resendConsentRequest, createConsentRequest, +} = require('../utils/consent'); + +const STAFF = ['admin', 'supervisor', 'staff']; +const fail = (res, error) => res.status(error.statusCode || (res.statusCode === 200 ? 400 : res.statusCode)).json({ message: safeErrorMessage(error) }); + +// What the parent sees — never the registrant's contact details or other attendees. +function publicView(request) { + const ev = request.event; + const latestForAttendee = request._isLatest !== false; + return { + status: request.status, + superseded: !latestForAttendee, + expired: new Date(request.expiresAt) < new Date(), + respondedAt: request.respondedAt, + attendeeName: request.attendee.name, + parentName: request.parentName, + consentText: request.consentText, + textVersion: request.textVersion, + event: { title: ev.title, startDate: ev.startDate, endDate: ev.endDate, location: ev.location }, + collect: { medical: ev.consentCollectMedical, emergency: ev.consentCollectEmergency, photo: ev.consentCollectPhoto }, + }; +} + +// @desc Consent page data for a parent/guardian +// @route GET /api/consent/:token +// @access Public (the token is the credential) +const getConsent = async (req, res) => { + try { + const request = await findRequestByToken(req.params.token); + if (!request) { res.status(404); throw new Error('This consent link is not valid. It may have been replaced by a newer one — check your latest message.'); } + const latest = (await latestRequestsFor([request.attendeeId])).get(request.attendeeId); + res.json(publicView({ ...request, _isLatest: latest?.id === request.id })); + } catch (error) { + fail(res, error); + } +}; + +// @desc Give or decline consent +// @route POST /api/consent/:token +// @access Public (the token is the credential) +const answerConsent = async (req, res) => { + try { + const request = await findRequestByToken(req.params.token); + if (!request) { res.status(404); throw new Error('This consent link is not valid.'); } + if (request.status !== 'pending') { res.status(409); throw new Error(`Consent has already been ${request.status}.`); } + if (new Date(request.expiresAt) < new Date()) { res.status(410); throw new Error('This consent link has expired because the event has ended.'); } + const latest = (await latestRequestsFor([request.attendeeId])).get(request.attendeeId); + if (latest?.id !== request.id) { res.status(409); throw new Error('A newer consent request replaced this one — please use the link in your latest message.'); } + + let answer; + try { answer = validateConsentAnswer(req.body || {}, request.event); } catch (e) { res.status(400); throw e; } + + // Only flips pending → answered once, even if the form is submitted twice at once. + const updated = await prisma.consentRequest.updateMany({ + where: { id: request.id, status: 'pending' }, + data: { + status: answer.decision === 'give' ? 'given' : 'declined', + signedName: answer.signedName, + ip: getClientIp(req), + device: describeUserAgent(req.headers['user-agent']), + medical: sealJson(answer.medical), + emergency: sealJson(answer.emergency), + photoConsent: answer.photoConsent, + respondedAt: new Date(), + }, + }); + if (updated.count !== 1) { res.status(409); throw new Error('Consent has already been answered.'); } + + notifyConsentAnswered(request.id).catch(e => console.error('[consent] notify failed:', e?.message || e)); + res.json({ message: answer.decision === 'give' ? 'Thank you — consent has been given.' : 'Thank you — consent has been declined.', status: answer.decision === 'give' ? 'given' : 'declined' }); + } catch (error) { + fail(res, error); + } +}; + +// Tells the registrant and the event's notify recipients how a parent answered. +async function notifyConsentAnswered(requestId) { + const request = await prisma.consentRequest.findUnique({ + where: { id: requestId }, + include: { + attendee: { include: { registration: { include: { user: { select: { id: true, name: true, email: true, phoneNumber: true, notificationPreference: true } } } } } }, + event: { include: { createdBy: { select: { id: true, name: true, email: true } }, notifyRecipients: { select: { id: true, name: true, email: true } } } }, + }, + }); + if (!request) return; + const { sendMail, emailWrapper } = require('../utils/email'); + const { shouldEmail, waText } = require('../utils/notify'); + const { buildEventNotifyRecipientList } = require('../utils/notifications'); + const given = request.status === 'given'; + const verb = given ? 'given' : 'declined'; + const who = request.attendee.name; + const ev = request.event.title; + const payer = request.attendee.registration.user; + const line = given + ? `${request.signedName} gave parental consent for ${who} for ${ev}.` + : `${request.signedName} declined parental consent for ${who} for ${ev}. ${who} can't be checked in — please contact the organisers about a refund.`; + + const sends = []; + const payerHasEmail = payer?.email && !payer.email.endsWith('@guest.local') && !payer.email.endsWith('@deleted.invalid'); + if (payerHasEmail && shouldEmail(payer) && payer.email !== request.parentEmail) { + sends.push(sendMail({ to: payer.email, subject: `Consent ${verb} for ${who}`, html: emailWrapper(`

${line}

`), text: line })); + } + if (payer) sends.push(waText(payer, line)); + const staff = buildEventNotifyRecipientList(request.event); + if (staff.length) { + sends.push(sendMail({ to: staff.join(','), subject: `Consent ${verb}: ${who} — ${ev}`, html: emailWrapper(`

${line}

`), text: line })); + } + await Promise.allSettled(sends); +} + +/** One row per attendee on the event, with consent state — for the consent tracker. */ +async function consentRows(eventId) { + const event = await prisma.event.findUnique({ where: { id: eventId } }); + if (!event) return { event: null, rows: [] }; + const attendees = await prisma.attendee.findMany({ + where: { registration: { eventId, status: { not: 'cancelled' } } }, + include: { registration: { select: { id: true, status: true, user: { select: { id: true, name: true, email: true } } } } }, + orderBy: [{ registrationId: 'asc' }, { order: 'asc' }], + }); + const latest = await latestRequestsFor(attendees.map(a => a.id)); + const rows = attendees.map(a => { + const r = latest.get(a.id) || null; + return { + attendeeId: a.id, + name: a.name, + dateOfBirth: a.dateOfBirth, + minor: isMinor(a.dateOfBirth, event.startDate), + parentName: a.parentName, parentEmail: a.parentEmail, parentPhone: a.parentPhone, + registrationId: a.registrationId, + registrationStatus: a.registration.status, + bookedBy: a.registration.user, + status: consentStatusFor(a, event, r), + request: r && { + id: r.id, status: r.status, textVersion: r.textVersion, signedName: r.signedName, respondedAt: r.respondedAt, + lastSentAt: r.lastSentAt, remindersSent: r.remindersSent, photoConsent: r.photoConsent, + outdated: r.status === 'given' && r.textVersion < (event.consentTextVersion || 1), + }, + }; + }); + return { event, rows }; +} + +// @desc Consent status for every attendee on an event +// @route GET /api/consent/events/:eventId +// @access Private/Staff +const listEventConsent = async (req, res) => { + try { + const { event, rows } = await consentRows(req.params.eventId); + if (!event) { res.status(404); throw new Error('Event not found'); } + const counts = rows.reduce((c, r) => { c[r.status] = (c[r.status] || 0) + 1; return c; }, {}); + res.json({ + event: { id: event.id, title: event.title, startDate: event.startDate, requiresParentalConsent: event.requiresParentalConsent, consentTextVersion: event.consentTextVersion }, + counts, + rows, + }); + } catch (error) { + fail(res, error); + } +}; + +// @desc Re-send one consent request (with a fresh link) +// @route POST /api/consent/requests/:id/resend +// @access Private (the registrant, or staff) +const resendRequest = async (req, res) => { + try { + const request = await prisma.consentRequest.findUnique({ where: { id: req.params.id }, include: { attendee: { include: { registration: true } } } }); + if (!request) { res.status(404); throw new Error('Consent request not found'); } + if (request.attendee.registration.userId !== req.user.id && !STAFF.includes(req.user.role)) { res.status(403); throw new Error('Not authorized'); } + const latest = (await latestRequestsFor([request.attendeeId])).get(request.attendeeId); + if (latest?.id !== request.id) { res.status(400); throw new Error('A newer consent request has replaced this one.'); } + const sent = await resendConsentRequest(request.id); + res.json({ message: sent.length ? `Consent request re-sent by ${sent.join(' and ')}.` : 'The consent request could not be sent — check the parent\'s email and phone.' }); + } catch (error) { + fail(res, error); + } +}; + +// @desc Re-send every consent request still pending on an event +// @route POST /api/consent/events/:eventId/resend-pending +// @access Private/Supervisor +const resendPending = async (req, res) => { + try { + const { rows } = await consentRows(req.params.eventId); + const pending = rows.filter(r => r.status === 'pending' && r.request); + let sent = 0; + for (const r of pending) { + try { if ((await resendConsentRequest(r.request.id)).length) sent += 1; } catch {} + } + res.json({ message: `Re-sent ${sent} of ${pending.length} pending request(s).`, sent, pending: pending.length }); + } catch (error) { + fail(res, error); + } +}; + +// @desc Ask again for consent where it was given on an older version of the text, +// and for minors who never got a request (e.g. names added later) +// @route POST /api/consent/events/:eventId/rerequest +// @access Private/Supervisor +const rerequestConsent = async (req, res) => { + try { + const { event, rows } = await consentRows(req.params.eventId); + if (!event) { res.status(404); throw new Error('Event not found'); } + if (!event.requiresParentalConsent) { res.status(400); throw new Error('This event does not need parental consent.'); } + const targets = rows.filter(r => r.minor && r.registrationStatus !== 'cancelled' && (r.status === 'missing' || r.request?.outdated)); + let created = 0; + for (const r of targets) { + if (!r.parentEmail && !r.parentPhone) continue; + const attendee = await prisma.attendee.findUnique({ where: { id: r.attendeeId } }); + await createConsentRequest(attendee, event); + created += 1; + } + logAdminAction({ + actorId: req.user.id, actorRole: req.user.role, action: 'consent_rerequested', + targetType: 'Event', targetId: event.id, metadata: { requests: created, textVersion: event.consentTextVersion }, + ip: getClientIp(req), + }); + res.json({ message: `Sent ${created} new consent request(s).`, created }); + } catch (error) { + fail(res, error); + } +}; + +// @desc Medical & emergency list for an event (decrypted) — every view is audited +// @route GET /api/consent/events/:eventId/medical +// @access Private/Supervisor +const medicalList = async (req, res) => { + try { + const event = await prisma.event.findUnique({ where: { id: req.params.eventId } }); + if (!event) { res.status(404); throw new Error('Event not found'); } + const { rows } = await consentRows(event.id); + const ids = rows.map(r => r.request?.id).filter(Boolean); + const full = ids.length ? await prisma.consentRequest.findMany({ where: { id: { in: ids } } }) : []; + const byId = new Map(full.map(r => [r.id, r])); + const list = rows + .filter(r => r.request && byId.get(r.request.id)?.status === 'given') + .map(r => { + const fr = byId.get(r.request.id); + return { + name: r.name, dateOfBirth: r.dateOfBirth, + parentName: r.parentName, parentPhone: r.parentPhone, parentEmail: r.parentEmail, + medical: openJson(fr.medical), emergency: openJson(fr.emergency), photoConsent: fr.photoConsent, + purged: !!fr.medicalPurgedAt, + }; + }); + logAdminAction({ + actorId: req.user.id, actorRole: req.user.role, action: 'medical_list_viewed', + targetType: 'Event', targetId: event.id, metadata: { attendees: list.length }, + ip: getClientIp(req), + }); + res.json({ event: { id: event.id, title: event.title, startDate: event.startDate }, rows: list }); + } catch (error) { + fail(res, error); + } +}; + +module.exports = { getConsent, answerConsent, listEventConsent, resendRequest, resendPending, rerequestConsent, medicalList }; diff --git a/apps/events/backend/src/controllers/eventController.js b/apps/events/backend/src/controllers/eventController.js index 0f2c4c1..12b14d7 100644 --- a/apps/events/backend/src/controllers/eventController.js +++ b/apps/events/backend/src/controllers/eventController.js @@ -44,7 +44,7 @@ function toAbsoluteUrl(req, url) { // @access Private/Admin const createEvent = async (req, res) => { try { - const { title, description, startDate, endDate, registrationDeadline, goLiveAt, price, picture, redirectUrl, isHidden, requiresAuth, requiresRegistration, allowNamedAttendees, contactName, contactPhone, contactEmail, location } = req.body; + const { title, description, startDate, endDate, registrationDeadline, goLiveAt, price, picture, redirectUrl, isHidden, requiresAuth, requiresRegistration, allowNamedAttendees, requiresParentalConsent, consentText, consentCollectMedical, consentCollectEmergency, consentCollectPhoto, contactName, contactPhone, contactEmail, location } = req.body; const data = { id: uuidv4(), @@ -62,7 +62,13 @@ const createEvent = async (req, res) => { isHidden: isHidden === true || isHidden === 'true', requiresAuth: requiresAuth === false || requiresAuth === 'false' ? false : true, requiresRegistration: requiresRegistration === false || requiresRegistration === 'false' ? false : true, - allowNamedAttendees: allowNamedAttendees === true || allowNamedAttendees === 'true', + // A youth event needs names (with dates of birth), so it always takes them. + allowNamedAttendees: allowNamedAttendees === true || allowNamedAttendees === 'true' || requiresParentalConsent === true, + requiresParentalConsent: requiresParentalConsent === true, + consentText: consentText ? String(consentText) : null, + consentCollectMedical: consentCollectMedical === true, + consentCollectEmergency: consentCollectEmergency === true, + consentCollectPhoto: consentCollectPhoto === true, contactName: contactName || null, contactPhone: contactPhone || null, contactEmail: contactEmail || null, @@ -538,7 +544,7 @@ const updateEvent = async (req, res) => { ip: getClientIp(req), }); - const { title, description, startDate, endDate, registrationDeadline, goLiveAt, price, picture, isActive, redirectUrl, isHidden, requiresAuth, requiresRegistration, allowNamedAttendees, contactName, contactPhone, contactEmail, location } = req.body; + const { title, description, startDate, endDate, registrationDeadline, goLiveAt, price, picture, isActive, redirectUrl, isHidden, requiresAuth, requiresRegistration, allowNamedAttendees, requiresParentalConsent, consentText, consentCollectMedical, consentCollectEmergency, consentCollectPhoto, contactName, contactPhone, contactEmail, location } = req.body; const data = { title: title || event.title, @@ -553,7 +559,18 @@ const updateEvent = async (req, res) => { isHidden: isHidden !== undefined ? (isHidden === true || isHidden === 'true') : (event.isHidden ?? false), requiresAuth: requiresAuth !== undefined ? !(requiresAuth === false || requiresAuth === 'false') : (event.requiresAuth ?? true), requiresRegistration: requiresRegistration !== undefined ? !(requiresRegistration === false || requiresRegistration === 'false') : (event.requiresRegistration ?? true), - allowNamedAttendees: allowNamedAttendees !== undefined ? (allowNamedAttendees === true || allowNamedAttendees === 'true') : event.allowNamedAttendees, + allowNamedAttendees: (requiresParentalConsent ?? event.requiresParentalConsent) === true + ? true + : (allowNamedAttendees !== undefined ? (allowNamedAttendees === true || allowNamedAttendees === 'true') : event.allowNamedAttendees), + requiresParentalConsent: requiresParentalConsent !== undefined ? requiresParentalConsent === true : event.requiresParentalConsent, + consentCollectMedical: consentCollectMedical !== undefined ? consentCollectMedical === true : event.consentCollectMedical, + consentCollectEmergency: consentCollectEmergency !== undefined ? consentCollectEmergency === true : event.consentCollectEmergency, + consentCollectPhoto: consentCollectPhoto !== undefined ? consentCollectPhoto === true : event.consentCollectPhoto, + // Editing the consent text starts a new version; parents who already agreed keep + // their record of the old one (supervisors can re-request consent). + ...(consentText !== undefined && String(consentText || '') !== String(event.consentText || '') + ? { consentText: consentText ? String(consentText) : null, consentTextVersion: (event.consentTextVersion || 1) + 1 } + : {}), contactName: contactName !== undefined ? (contactName || null) : event.contactName, contactPhone: contactPhone !== undefined ? (contactPhone || null) : event.contactPhone, contactEmail: contactEmail !== undefined ? (contactEmail || null) : event.contactEmail, diff --git a/apps/events/backend/src/controllers/registrationController.js b/apps/events/backend/src/controllers/registrationController.js index 85fcd74..590d056 100644 --- a/apps/events/backend/src/controllers/registrationController.js +++ b/apps/events/backend/src/controllers/registrationController.js @@ -10,11 +10,22 @@ const { getClientIp } = require('../utils/requestUtils'); const { buildCouponLines, previewCoupon, applyCouponToRegistration, recalculateRegistrationDiscount, releaseRegistrationCoupons, describeCoupon } = require('../utils/coupons'); const { lineKey, validateAttendees, createAttendees, namedPlacesByKey } = require('../utils/attendees'); const { findAccountByContact } = require('../utils/accountMatch'); +const { ensureConsentRequests } = require('../utils/consent'); + +// Youth events: send parental consent requests for any new under-18 attendees. Runs in +// the background so a slow mail/WhatsApp send never holds up the registration. +function queueConsentRequests(registrationId) { + ensureConsentRequests(registrationId).catch(e => console.error('[consent] Failed to send requests:', e?.message || e)); +} // Named attendees for API responses, with whether their ticket has been issued/used. const ATTENDEES_INCLUDE = { orderBy: { order: 'asc' }, - include: { ticket: { select: { id: true, isUsed: true } } }, + include: { + ticket: { select: { id: true, isUsed: true } }, + // Latest consent request (youth events) — it decides check-in. + consentRequests: { orderBy: { createdAt: 'desc' }, take: 1, select: { id: true, status: true, respondedAt: true, lastSentAt: true, textVersion: true } }, + }, }; const TICKET_DELIVERY = ['payer', 'each']; @@ -399,7 +410,10 @@ const createRegistration = async (req, res) => { }); } - if (cleanAttendees.length > 0) await createAttendees(registration.id, cleanAttendees); + if (cleanAttendees.length > 0) { + await createAttendees(registration.id, cleanAttendees); + queueConsentRequests(registration.id); + } if (ticketDelivery) { await prisma.registration.update({ where: { id: registration.id }, data: { ticketDelivery } }); } @@ -1241,7 +1255,10 @@ const createManualRegistration = async (req, res) => { const registrationId = registration.id; - if (cleanAttendees.length > 0) await createAttendees(registrationId, cleanAttendees); + if (cleanAttendees.length > 0) { + await createAttendees(registrationId, cleanAttendees); + queueConsentRequests(registrationId); + } if (ticketDelivery) await prisma.registration.update({ where: { id: registrationId }, data: { ticketDelivery } }); if (couponCode && !couponError) { @@ -2171,6 +2188,7 @@ const updateAttendees = async (req, res) => { where: { id: a.id }, data: { name: c.name, email: c.email, phone: c.phone, + dateOfBirth: c.dateOfBirth, parentName: c.parentName, parentEmail: c.parentEmail, parentPhone: c.parentPhone, ...(contactChanged ? { userId: match?.user?.id || null } : {}), }, }); @@ -2182,6 +2200,8 @@ const updateAttendees = async (req, res) => { if (ticketDelivery) await tx.registration.update({ where: { id: registration.id }, data: { ticketDelivery } }); }); + queueConsentRequests(registration.id); + // Paid registrations: re-sync tickets and send any new ones. if (registration.status === 'paid') { const created = await generateTicketsForRegistration(registration.id); diff --git a/apps/events/backend/src/controllers/ticketController.js b/apps/events/backend/src/controllers/ticketController.js index 37fc4ea..9a8b95c 100644 --- a/apps/events/backend/src/controllers/ticketController.js +++ b/apps/events/backend/src/controllers/ticketController.js @@ -292,11 +292,14 @@ const getScanPreview = async (req, res) => { } const r = rows[0]; + const { consentStatusForTickets } = require('../utils/consent'); + const consentStatus = (await consentStatusForTickets([r.id])).get(r.id) || 'not_required'; res.json({ id: r.id, quantity: Number(r.quantity), isUsed: r.isUsed, eventId: r.eventId, + consentStatus, registrationOption: { id: r.registrationOptionId, eventOption: { id: r.eventOptionId, name: r.eventOptionName }, @@ -381,6 +384,25 @@ const scanTicket = async (req, res) => { }); } + // Youth events: no check-in without parental consent, unless a supervisor overrides. + const { consentStatusForTickets } = require('../utils/consent'); + const consentStatus = (await consentStatusForTickets([ticket.id])).get(ticket.id) || 'not_required'; + if (!['not_required', 'given'].includes(consentStatus)) { + const canOverride = ['admin', 'supervisor'].includes(req.user?.role); + if (!(req.body?.overrideConsent === true && canOverride)) { + const why = consentStatus === 'declined' ? 'Parental consent was declined' : consentStatus === 'pending' ? 'Parental consent is still pending' : 'Parental consent is missing'; + return res.status(403).json({ message: `${why} — this ticket can't be checked in.`, code: 'CONSENT_REQUIRED', consentStatus, canOverride, ticket }); + } + const { logAdminAction } = require('../utils/adminAudit'); + const { getClientIp } = require('../utils/requestUtils'); + logAdminAction({ + actorId: req.user.id, actorRole: req.user.role, action: 'consent_override', + targetType: 'Ticket', targetId: ticket.id, + metadata: { consentStatus, eventId: ticket.eventId }, + ip: getClientIp(req), + }); + } + // Determine how many to redeem this scan (defaults to all remaining) const requestedQty = parseInt(req.body?.qty || req.body?.quantity) || remaining; const qtyToRedeem = Math.min(Math.max(1, requestedQty), remaining); diff --git a/apps/events/backend/src/controllers/userController.js b/apps/events/backend/src/controllers/userController.js index b1226af..5c331c3 100644 --- a/apps/events/backend/src/controllers/userController.js +++ b/apps/events/backend/src/controllers/userController.js @@ -888,6 +888,7 @@ const anonymizeUser = async (req, res) => { } }); await clearTrustedDevices(req.params.id); + await require('../utils/consent').clearConsentDataForUser(req.params.id); res.json({ message: 'User data deleted' }); } catch (error) { @@ -1149,6 +1150,7 @@ const closeAccount = async (req, res) => { }, }); await clearTrustedDevices(req.user.id); + await require('../utils/consent').clearConsentDataForUser(req.user.id); // Send closure confirmation to the real address (before it was wiped) if (realEmail && !realEmail.endsWith('@deleted.invalid') && !realEmail.endsWith('@guest.local')) { const { sendMail, buildAccountClosedEmail } = require('../utils/email'); diff --git a/apps/events/backend/src/index.js b/apps/events/backend/src/index.js index e0fa6f2..8f6274d 100644 --- a/apps/events/backend/src/index.js +++ b/apps/events/backend/src/index.js @@ -176,6 +176,7 @@ app.use('/api', costRoutes); app.use('/api/cashups', cashupRoutes); app.use('/api/admin', adminRoutes); app.use('/api/coupons', require('./routes/couponRoutes')); +app.use('/api/consent', require('./routes/consentRoutes')); app.use('/api/backups', backupRoutes); // Pre-warm the settings cache so synchronous helpers have DB values from startup @@ -632,6 +633,18 @@ app.get('/docs', async (req, res) => { ]}, ]}, + { title: 'Parental consent', base: '/api/consent', endpoints: [ + { method:'GET', path:'/api/consent/:token', auth:'public', desc:'Consent page data for a parent/guardian (the link token is the credential; rate-limited)', + responses:[{ status:200, desc:'Success', body:{ status:'pending', attendeeName:'Sam Smith', consentText:'I give permission…', event:{ title:'Youth Camp' }, collect:{ medical:true, emergency:true, photo:true } }}, { status:404, desc:'Unknown or replaced link', body:{ message:'This consent link is not valid.' }}]}, + { method:'POST', path:'/api/consent/:token', auth:'public', desc:'Give or decline consent. Records name, time, IP, device and the consent text version; medical/emergency details are stored encrypted.', + request:{ body:{ decision:'give', signedName:'Pat Smith', isGuardian:true, medical:{ allergies:'Peanuts' }, emergency:{ name:'Gran', phone:'0821234567' }, photoConsent:true }}, + responses:[{ status:200, desc:'Answered', body:{ status:'given' }}, { status:409, desc:'Already answered', body:{ message:'Consent has already been given.' }}]}, + { method:'GET', path:'/api/consent/events/:eventId', auth:'staff+', desc:'Consent status for every attendee on an event' }, + { method:'POST', path:'/api/consent/requests/:id/resend', auth:'user+', desc:'Re-send a pending request with a fresh link (registrant or staff)' }, + { method:'POST', path:'/api/consent/events/:eventId/resend-pending', auth:'supervisor+', desc:'Re-send every pending request on an event' }, + { method:'POST', path:'/api/consent/events/:eventId/rerequest', auth:'supervisor+', desc:'Ask again where consent was given on an older version of the text, or never requested' }, + { method:'GET', path:'/api/consent/events/:eventId/medical', auth:'supervisor+', desc:'Decrypted medical & emergency list; every view is written to the admin audit log' }, + ]}, { title: 'Coupons', base: '/api/coupons', endpoints: [ { method:'POST', path:'/api/coupons/validate', auth:'public', desc:'Check a code against a basket before registering; returns the discount. Login needed for restricted codes; staff can pass forUserId (or null for a walk-in).', request:{ body:{ code:'STAFF50', eventId:'ev-uuid-...', options:[{ eventOptionId:'opt-uuid-...', quantity:2 }] }}, @@ -1295,6 +1308,37 @@ app.listen(PORT, () => { console.warn('[daily summaries] Not scheduled:', e?.message || e); } + // Daily parental-consent job — reminders for unanswered requests, and purging + // medical/emergency details a set number of days after each event. + try { + const enabled = String(process.env.CONSENT_JOBS_ENABLED || 'true').toLowerCase() !== 'false'; + if (enabled) { + const { sendConsentReminders, purgeConsentMedicalData } = require('./utils/consent'); + const runConsentJobs = async () => { + try { + const reminded = await sendConsentReminders(new Date()); + const purged = await purgeConsentMedicalData(new Date()); + if (reminded || purged) console.log(`[consent] Sent ${reminded} reminder(s), purged medical details on ${purged} request(s).`); + } catch (e) { + console.warn('[consent] Daily job failed:', e?.message || e); + } + }; + const scheduleConsent = () => { + const now = new Date(); + const next = new Date(now); + next.setHours(9, 0, 0, 0); + if (next <= now) next.setDate(next.getDate() + 1); + setTimeout(async () => { await runConsentJobs(); scheduleConsent(); }, next.getTime() - now.getTime()); + }; + scheduleConsent(); + console.log('[consent] Scheduler initialized (09:00 local time).'); + } else { + console.log('[consent] Scheduler disabled by env CONSENT_JOBS_ENABLED=false'); + } + } catch (e) { + console.warn('[consent] Not scheduled:', e?.message || e); + } + // Daily temp-file cleanup — removes files older than 7 days from /temp try { const { cleanupTempFiles } = require('./utils/cleanupTemp'); diff --git a/apps/events/backend/src/routes/consentRoutes.js b/apps/events/backend/src/routes/consentRoutes.js new file mode 100644 index 0000000..307ef1b --- /dev/null +++ b/apps/events/backend/src/routes/consentRoutes.js @@ -0,0 +1,20 @@ +const express = require('express'); +const rateLimit = require('express-rate-limit'); +const router = express.Router(); +const { getConsent, answerConsent, listEventConsent, resendRequest, resendPending, rerequestConsent, medicalList } = require('../controllers/consentController'); +const { protect, staff, supervisor } = require('../middleware/authMiddleware'); + +// The token in the link is the parent's only credential, so keep guessing slow. +const consentLimiter = rateLimit({ windowMs: 60 * 1000, max: 30, message: { message: 'Too many attempts. Please try again in a minute.' } }); + +router.get('/events/:eventId', protect, staff, listEventConsent); +router.post('/events/:eventId/resend-pending', protect, supervisor, resendPending); +router.post('/events/:eventId/rerequest', protect, supervisor, rerequestConsent); +router.get('/events/:eventId/medical', protect, supervisor, medicalList); +router.post('/requests/:id/resend', protect, resendRequest); + +// Public consent page +router.get('/:token', consentLimiter, getConsent); +router.post('/:token', consentLimiter, answerConsent); + +module.exports = router; diff --git a/apps/events/backend/src/utils/attendees.js b/apps/events/backend/src/utils/attendees.js index df275fc..df737b3 100644 --- a/apps/events/backend/src/utils/attendees.js +++ b/apps/events/backend/src/utils/attendees.js @@ -11,10 +11,16 @@ * accounts, in which case nothing is linked. * - Registration.ticketDelivery = 'each' sends each attendee their own ticket by * email/WhatsApp; attendees with no contact details fall back to the payer. + * - Youth events (requiresParentalConsent): every main place must be named with a date + * of birth, and anyone under 18 on the start date needs a parent/guardian name, email + * and phone (see utils/consent.js). */ const prisma = require('../config/db'); const { findAccountByContact } = require('./accountMatch'); +const { isMinor } = require('./consent'); + +const EMAIL_RE = /^[^@\s]+@[^@\s]+\.[^@\s]+$/; const lineKey = (eventOptionId, variantId) => `${eventOptionId}::${variantId || ''}`; @@ -34,27 +40,60 @@ function attendeeError(message) { * @param {object} [namedByKey] - places on those lines already named (and being kept) */ function validateAttendees(event, placesByKey, attendees, namedByKey = {}) { - if (!attendees || attendees.length === 0) return []; - if (!event.allowNamedAttendees) throw attendeeError('This event doesn\'t take attendee names.'); - if (!Array.isArray(attendees)) throw attendeeError('attendees must be a list'); + const consent = !!event.requiresParentalConsent; + if ((!attendees || attendees.length === 0) && !consent) return []; + if (!event.allowNamedAttendees && !consent) throw attendeeError('This event doesn\'t take attendee names.'); + if (!Array.isArray(attendees || [])) throw attendeeError('attendees must be a list'); const countByKey = {}; - return attendees.map((a, i) => { + const cleaned = (attendees || []).map((a, i) => { const option = (event.eventOptions || []).find(o => o.id === a?.eventOptionId); if (!option) throw attendeeError(`Attendee ${i + 1}: unknown ticket option.`); if (!option.isMainTicket) throw attendeeError(`Attendee ${i + 1}: names can only be given for "${option.name}" main tickets.`); const name = String(a.name || '').trim(); if (!name) throw attendeeError(`Attendee ${i + 1}: enter a name.`); const email = String(a.email || '').trim() || null; - if (email && !/^[^@\s]+@[^@\s]+\.[^@\s]+$/.test(email)) throw attendeeError(`Attendee ${i + 1}: "${email}" isn't a valid email address.`); + if (email && !EMAIL_RE.test(email)) throw attendeeError(`Attendee ${i + 1}: "${email}" isn't a valid email address.`); const phone = String(a.phone || '').trim() || null; const key = lineKey(a.eventOptionId, a.variantId); countByKey[key] = (countByKey[key] || 0) + 1; if (countByKey[key] + (namedByKey[key] || 0) > (placesByKey[key] || 0)) { throw attendeeError(`More names than "${option.name}" tickets.`); } - return { eventOptionId: a.eventOptionId, variantId: a.variantId || null, name, email, phone }; + + // Date of birth (always kept if given) and, for youth events, parent details. + let dateOfBirth = null; + if (a.dateOfBirth) { + dateOfBirth = new Date(a.dateOfBirth); + if (isNaN(dateOfBirth.getTime()) || dateOfBirth > new Date()) throw attendeeError(`${name}: enter a valid date of birth.`); + } else if (consent) { + throw attendeeError(`${name}: enter a date of birth.`); + } + const parentName = String(a.parentName || '').trim() || null; + const parentEmail = String(a.parentEmail || '').trim() || null; + const parentPhone = String(a.parentPhone || '').trim() || null; + if (consent && isMinor(dateOfBirth, event.startDate)) { + if (!parentName || !parentEmail || !parentPhone) { + throw attendeeError(`${name} is under 18, so a parent or guardian's name, email and phone are needed for consent.`); + } + if (!EMAIL_RE.test(parentEmail)) throw attendeeError(`${name}: "${parentEmail}" isn't a valid parent email address.`); + } + return { eventOptionId: a.eventOptionId, variantId: a.variantId || null, name, email, phone, dateOfBirth, parentName, parentEmail, parentPhone }; }); + + // Youth events need every main place named (with a date of birth). + if (consent) { + for (const o of event.eventOptions || []) { + if (!o.isMainTicket) continue; + for (const [key, places] of Object.entries(placesByKey)) { + if (!key.startsWith(`${o.id}::`)) continue; + if ((countByKey[key] || 0) + (namedByKey[key] || 0) < places) { + throw attendeeError(`This is a youth event — add a name and date of birth for every "${o.name}" ticket.`); + } + } + } + } + return cleaned; } /** @@ -147,6 +186,10 @@ async function createAttendees(registrationId, attendees, db = prisma) { name: a.name, email: a.email, phone: a.phone, + dateOfBirth: a.dateOfBirth || null, + parentName: a.parentName || null, + parentEmail: a.parentEmail || null, + parentPhone: a.parentPhone || null, userId: match.user?.id || null, order, }, diff --git a/apps/events/backend/src/utils/consent.js b/apps/events/backend/src/utils/consent.js new file mode 100644 index 0000000..60e3004 --- /dev/null +++ b/apps/events/backend/src/utils/consent.js @@ -0,0 +1,332 @@ +/** + * Parental consent for youth events. + * + * Rules: + * - On an event with requiresParentalConsent, every attendee gives a date of birth. + * Anyone under 18 on the event's start date needs a parent/guardian (name, email, + * phone), who is sent a consent request by email AND WhatsApp — regardless of anyone's + * notification preference. + * - A request's link token is random; only its HMAC is stored. Links expire when the + * event ends and can be re-sent (which issues a new token). + * - The parent's answer records the time, IP, device, typed name, and the exact consent + * text and version they saw. Medical/emergency details are stored encrypted and purged + * a set number of days after the event (setting consent_medical_retention_days). + * - Tickets are issued as normal but can't be checked in until consent is given — the + * latest request for the attendee decides. On a consent event, a ticket with no named + * attendee is treated as missing consent. Supervisors can override (audited). + * - Reminders go 2 days after the request, then every 3 days, until answered or the event. + */ + +const crypto = require('crypto'); +const prisma = require('../config/db'); + +const DAY = 24 * 60 * 60 * 1000; +const FIRST_REMINDER_AFTER = 2 * DAY; +const REMINDER_EVERY = 3 * DAY; +const DEFAULT_RETENTION_DAYS = 30; + +function consentError(message, statusCode = 400) { + const err = new Error(message); + err.statusCode = statusCode; + return err; +} + +// ─── Pure helpers ───────────────────────────────────────────────────────────── + +/** Whole years old on `onDate`. */ +function ageOn(dateOfBirth, onDate) { + const dob = new Date(dateOfBirth); + const on = new Date(onDate); + let age = on.getUTCFullYear() - dob.getUTCFullYear(); + const beforeBirthday = on.getUTCMonth() < dob.getUTCMonth() + || (on.getUTCMonth() === dob.getUTCMonth() && on.getUTCDate() < dob.getUTCDate()); + if (beforeBirthday) age -= 1; + return age; +} + +/** Under 18 on the event's start date. */ +function isMinor(dateOfBirth, eventStart) { + if (!dateOfBirth) return false; + return ageOn(dateOfBirth, eventStart) < 18; +} + +/** + * Consent state for one attendee: 'not_required' | 'missing' | 'pending' | 'given' | 'declined'. + * `latest` is the attendee's most recent ConsentRequest (or null). + */ +function consentStatusFor(attendee, event, latest) { + if (!event?.requiresParentalConsent) return 'not_required'; + if (!attendee) return 'missing'; // unnamed place on a consent event + if (!isMinor(attendee.dateOfBirth, event.startDate)) return 'not_required'; + if (!latest) return 'missing'; + return latest.status; +} + +/** Whether a pending request is due a reminder now. */ +function reminderDue(request, now = new Date()) { + if (!request || request.status !== 'pending') return false; + const t = new Date(now).getTime(); + if (t >= new Date(request.expiresAt).getTime()) return false; + const gap = request.remindersSent === 0 ? FIRST_REMINDER_AFTER : REMINDER_EVERY; + return t - new Date(request.lastSentAt).getTime() >= gap; +} + +const str = (v, max = 500) => String(v ?? '').trim().slice(0, max); + +/** + * Checks a parent's answer on the consent page. Pure. Returns the cleaned answer. + * @param {object} body - { decision: 'give'|'decline', signedName, isGuardian, medical, emergency, photoConsent } + * @param {object} event - with consentCollectMedical / Emergency / Photo + */ +function validateConsentAnswer(body, event) { + const decision = body?.decision; + if (decision !== 'give' && decision !== 'decline') throw consentError('Choose to give or decline consent.'); + const signedName = str(body.signedName, 200); + if (signedName.length < 2) throw consentError('Type your full name to sign.'); + if (body.isGuardian !== true) throw consentError('Confirm that you are the parent or legal guardian.'); + + const out = { decision, signedName, medical: null, emergency: null, photoConsent: null }; + if (decision === 'decline') return out; + + if (event.consentCollectMedical) { + const m = body.medical || {}; + out.medical = { + allergies: str(m.allergies), medication: str(m.medication), + conditions: str(m.conditions), medicalAid: str(m.medicalAid, 200), + }; + } + if (event.consentCollectEmergency) { + const em = body.emergency || {}; + out.emergency = { name: str(em.name, 200), phone: str(em.phone, 40), relationship: str(em.relationship, 100) }; + if (!out.emergency.name || !out.emergency.phone) throw consentError('Add an emergency contact name and phone number.'); + } + if (event.consentCollectPhoto) { + if (body.photoConsent !== true && body.photoConsent !== false) throw consentError('Answer the photo consent question.'); + out.photoConsent = body.photoConsent; + } + return out; +} + +// ─── Tokens ─────────────────────────────────────────────────────────────────── + +const hashToken = (token) => crypto.createHmac('sha256', process.env.JWT_SECRET || '').update(`consent:${token}`).digest('hex'); +const newToken = () => crypto.randomBytes(24).toString('hex'); + +function consentLink(token) { + const base = (process.env.FRONTEND_URL || process.env.APP_BASE_URL || 'http://localhost:3001').split(',')[0].trim().replace(/\/$/, ''); + return `${base}/consent/${token}`; +} + +// ─── Encryption of medical/emergency details ────────────────────────────────── + +function sealJson(value) { + if (!value) return null; + const { encrypt } = require('./encryption'); + return encrypt(JSON.stringify(value)); +} + +function openJson(value) { + if (!value) return null; + try { + const { decrypt } = require('./encryption'); + return JSON.parse(decrypt(value)); + } catch { + return null; + } +} + +// ─── Database helpers ───────────────────────────────────────────────────────── + +/** Latest request per attendee id. */ +async function latestRequestsFor(attendeeIds, db = prisma) { + if (!attendeeIds.length) return new Map(); + const rows = await db.consentRequest.findMany({ where: { attendeeId: { in: attendeeIds } }, orderBy: { createdAt: 'desc' } }); + const out = new Map(); + for (const r of rows) if (!out.has(r.attendeeId)) out.set(r.attendeeId, r); + return out; +} + +async function sendConsentMessage(request, token, { reminder = false } = {}) { + const { sendMail, emailWrapper, ctaButton, fallbackLink } = require('./email'); + const { waTextAny } = require('./notify'); + const { isValidZAPhone } = require('./whatsapp'); + const { getSettingSync } = require('./settingsCache'); + const orgName = getSettingSync('org_name', process.env.ORG_NAME || 'Cross Code'); + const ff = `-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif`; + + const event = request.event || await prisma.event.findUnique({ where: { id: request.eventId } }); + const attendee = request.attendee || await prisma.attendee.findUnique({ where: { id: request.attendeeId } }); + const link = consentLink(token); + const when = event?.startDate ? new Date(event.startDate).toLocaleDateString('en-GB', { day: 'numeric', month: 'long', year: 'numeric' }) : ''; + const subject = `${reminder ? 'Reminder: ' : ''}Consent needed for ${attendee.name} — ${event.title}`; + const intro = `${attendee.name} has been registered for ${event.title}${when ? ` on ${when}` : ''}. As their parent or guardian, please review the details and give (or decline) consent.`; + const sent = []; + + if (request.parentEmail && request.parentEmail.includes('@')) { + const html = emailWrapper(` +

${reminder ? 'A reminder: ' : ''}Parental consent needed

+

Hi ${request.parentName || 'there'},

+

${intro}

+ ${ctaButton('Review and give consent', link)} + ${fallbackLink(link)} +

${attendee.name} can't be checked in at the event until consent is given.

+ `, { preheader: `Consent needed for ${attendee.name}` }); + try { + await sendMail({ to: request.parentEmail, subject, html, text: `Hi ${request.parentName || 'there'},\n\n${intro.replace(/<[^>]+>/g, '')}\n\nReview and give consent: ${link}\n\n${orgName}` }); + sent.push('email'); + } catch (e) { + console.warn('[consent] email failed:', e?.message || e); + } + } + if (request.parentPhone && isValidZAPhone(request.parentPhone)) { + await waTextAny({ name: request.parentName, phoneNumber: request.parentPhone }, + `${reminder ? '⏰ Reminder: ' : ''}Hi ${request.parentName || 'there'}, ${attendee.name} has been registered for *${event.title}*${when ? ` on ${when}` : ''}. Please give (or decline) parental consent here: ${link}`); + sent.push('WhatsApp'); + } + return sent; +} + +/** + * Creates (and sends) a consent request for an attendee. Earlier requests stay as the + * record of what was agreed before; this one now decides check-in. + */ +async function createConsentRequest(attendee, event) { + const token = newToken(); + const request = await prisma.consentRequest.create({ + data: { + attendeeId: attendee.id, + eventId: event.id, + tokenHash: hashToken(token), + textVersion: event.consentTextVersion || 1, + consentText: event.consentText || '', + parentName: attendee.parentName, + parentEmail: attendee.parentEmail, + parentPhone: attendee.parentPhone, + expiresAt: event.endDate, + }, + }); + const sent = await sendConsentMessage({ ...request, event, attendee }, token); + return { request, sent }; +} + +/** + * Makes sure every under-18 attendee on a registration has a consent request — creates + * and sends one for anyone who has none yet, or whose parent details have changed since. + */ +async function ensureConsentRequests(registrationId) { + const reg = await prisma.registration.findUnique({ where: { id: registrationId }, include: { event: true, attendees: true } }); + if (!reg || !reg.event.requiresParentalConsent || reg.status === 'cancelled') return 0; + const minors = reg.attendees.filter(a => isMinor(a.dateOfBirth, reg.event.startDate)); + const latest = await latestRequestsFor(minors.map(a => a.id)); + let created = 0; + for (const a of minors) { + const r = latest.get(a.id); + const parentChanged = r && (r.parentEmail !== a.parentEmail || r.parentPhone !== a.parentPhone); + if (!r || (parentChanged && r.status !== 'given')) { + await createConsentRequest(a, reg.event); + created += 1; + } + } + return created; +} + +/** Re-sends a request with a fresh link (the old link stops working). */ +async function resendConsentRequest(requestId) { + const request = await prisma.consentRequest.findUnique({ where: { id: requestId }, include: { event: true, attendee: true } }); + if (!request) throw consentError('Consent request not found', 404); + if (request.status !== 'pending') throw consentError(`Consent has already been ${request.status}.`); + if (new Date(request.expiresAt) < new Date()) throw consentError('This event has ended.'); + const token = newToken(); + await prisma.consentRequest.update({ where: { id: request.id }, data: { tokenHash: hashToken(token), lastSentAt: new Date() } }); + return sendConsentMessage(request, token, { reminder: true }); +} + +async function findRequestByToken(token) { + if (!token || typeof token !== 'string' || token.length > 100) return null; + return prisma.consentRequest.findUnique({ + where: { tokenHash: hashToken(token) }, + include: { event: true, attendee: { include: { registration: { include: { user: { select: { id: true, name: true, email: true, phoneNumber: true, notificationPreference: true } } } } } } }, + }); +} + +/** + * Consent state for each ticket id — for the scan gate and staff screens. + * @returns {Promise>} ticketId → consent status + */ +async function consentStatusForTickets(ticketIds) { + const tickets = await prisma.ticket.findMany({ where: { id: { in: ticketIds } }, include: { event: true, attendee: true } }); + const latest = await latestRequestsFor(tickets.map(t => t.attendeeId).filter(Boolean)); + const out = new Map(); + for (const t of tickets) { + out.set(t.id, consentStatusFor(t.attendee, t.event, t.attendeeId ? latest.get(t.attendeeId) : null)); + } + return out; +} + +/** Daily job: reminders for unanswered requests. */ +async function sendConsentReminders(now = new Date()) { + const pending = await prisma.consentRequest.findMany({ + where: { status: 'pending', expiresAt: { gt: now } }, + include: { event: true, attendee: true }, + }); + // Only the latest request per attendee is still live. + const latest = await latestRequestsFor([...new Set(pending.map(r => r.attendeeId))]); + let sent = 0; + for (const r of pending) { + if (latest.get(r.attendeeId)?.id !== r.id || !reminderDue(r, now)) continue; + if (new Date(r.event.startDate) <= now) continue; // the event has started + const token = newToken(); + await prisma.consentRequest.update({ where: { id: r.id }, data: { tokenHash: hashToken(token), lastSentAt: now, remindersSent: { increment: 1 } } }); + await sendConsentMessage(r, token, { reminder: true }).catch(e => console.warn('[consent] reminder failed:', e?.message || e)); + sent += 1; + } + return sent; +} + +/** Daily job: delete medical/emergency details a set number of days after the event. */ +async function purgeConsentMedicalData(now = new Date()) { + const { getSettingSync } = require('./settingsCache'); + const days = Math.max(0, parseInt(getSettingSync('consent_medical_retention_days', String(DEFAULT_RETENTION_DAYS)), 10) || DEFAULT_RETENTION_DAYS); + const cutoff = new Date(new Date(now).getTime() - days * DAY); + const res = await prisma.consentRequest.updateMany({ + where: { medicalPurgedAt: null, event: { endDate: { lt: cutoff } }, OR: [{ medical: { not: null } }, { emergency: { not: null } }] }, + data: { medical: null, emergency: null, medicalPurgedAt: now }, + }); + return res.count; +} + +/** Clears parent, medical and emergency details for a person's registrations (anonymise). */ +async function clearConsentDataForUser(userId, db = prisma) { + const attendees = await db.attendee.findMany({ where: { OR: [{ userId }, { registration: { userId } }] }, select: { id: true } }); + const ids = attendees.map(a => a.id); + if (!ids.length) return 0; + await db.attendee.updateMany({ where: { id: { in: ids } }, data: { parentName: null, parentEmail: null, parentPhone: null, dateOfBirth: null, email: null, phone: null } }); + const res = await db.consentRequest.updateMany({ + where: { attendeeId: { in: ids } }, + data: { medical: null, emergency: null, parentName: null, parentEmail: null, parentPhone: null, ip: null, device: null, medicalPurgedAt: new Date() }, + }); + return res.count; +} + +module.exports = { + DEFAULT_RETENTION_DAYS, + consentError, + ageOn, + isMinor, + consentStatusFor, + reminderDue, + validateConsentAnswer, + hashToken, + consentLink, + sealJson, + openJson, + latestRequestsFor, + createConsentRequest, + ensureConsentRequests, + resendConsentRequest, + findRequestByToken, + consentStatusForTickets, + sendConsentReminders, + purgeConsentMedicalData, + clearConsentDataForUser, +}; diff --git a/apps/events/backend/src/utils/notifications.js b/apps/events/backend/src/utils/notifications.js index 4686596..00ed5be 100644 --- a/apps/events/backend/src/utils/notifications.js +++ b/apps/events/backend/src/utils/notifications.js @@ -1503,6 +1503,7 @@ async function sendAttendeeFormLinkMessage(attendee) { } module.exports = { + buildEventNotifyRecipientList, sendAttendeeFormLinkMessage, sendRegistrationEmails, sendRegistrationUpdatedEmails, diff --git a/apps/events/backend/tests/attendees.test.js b/apps/events/backend/tests/attendees.test.js index 181afe3..ee7a252 100644 --- a/apps/events/backend/tests/attendees.test.js +++ b/apps/events/backend/tests/attendees.test.js @@ -15,7 +15,7 @@ describe('validateAttendees', () => { { eventOptionId: 'kid', name: ' Sam ', email: ' ', phone: '0821234567' }, { eventOptionId: 'kid', name: 'Alex', email: 'alex@example.com' }, ]); - expect(out).toEqual([ + expect(out).toMatchObject([ { eventOptionId: 'kid', variantId: null, name: 'Sam', email: null, phone: '0821234567' }, { eventOptionId: 'kid', variantId: null, name: 'Alex', email: 'alex@example.com', phone: null }, ]); diff --git a/apps/events/backend/tests/consent.test.js b/apps/events/backend/tests/consent.test.js new file mode 100644 index 0000000..d74de5b --- /dev/null +++ b/apps/events/backend/tests/consent.test.js @@ -0,0 +1,135 @@ +process.env.JWT_SECRET = 'test-secret'; + +const { ageOn, isMinor, consentStatusFor, reminderDue, validateConsentAnswer, hashToken } = require('../src/utils/consent'); +const { validateAttendees, lineKey } = require('../src/utils/attendees'); + +const START = new Date('2026-12-10T08:00:00Z'); +const DAY = 24 * 60 * 60 * 1000; + +describe('ageOn / isMinor', () => { + test('counts whole years, turning a year older on the birthday', () => { + expect(ageOn('2008-12-10', START)).toBe(18); + expect(ageOn('2008-12-11', START)).toBe(17); + expect(ageOn('2010-01-01', START)).toBe(16); + }); + + test('under 18 on the event start date', () => { + expect(isMinor('2008-12-11', START)).toBe(true); + expect(isMinor('2008-12-10', START)).toBe(false); + expect(isMinor(null, START)).toBe(false); + }); +}); + +describe('consentStatusFor', () => { + const event = { requiresParentalConsent: true, startDate: START }; + const kid = { dateOfBirth: '2012-05-01' }; + + test('only needed on youth events, for minors', () => { + expect(consentStatusFor(kid, { ...event, requiresParentalConsent: false }, null)).toBe('not_required'); + expect(consentStatusFor({ dateOfBirth: '1990-01-01' }, event, null)).toBe('not_required'); + }); + + test('a minor with no request, or an unnamed ticket, is missing consent', () => { + expect(consentStatusFor(kid, event, null)).toBe('missing'); + expect(consentStatusFor(null, event, null)).toBe('missing'); + }); + + test('otherwise the latest request decides', () => { + expect(consentStatusFor(kid, event, { status: 'pending' })).toBe('pending'); + expect(consentStatusFor(kid, event, { status: 'given' })).toBe('given'); + expect(consentStatusFor(kid, event, { status: 'declined' })).toBe('declined'); + }); +}); + +describe('reminderDue', () => { + const now = new Date('2026-12-01T10:00:00Z'); + const req = (over) => ({ status: 'pending', remindersSent: 0, lastSentAt: new Date(now.getTime() - 1 * DAY), expiresAt: START, ...over }); + + test('first reminder 2 days after the request', () => { + expect(reminderDue(req({}), now)).toBe(false); + expect(reminderDue(req({ lastSentAt: new Date(now.getTime() - 2 * DAY) }), now)).toBe(true); + }); + + test('then every 3 days', () => { + expect(reminderDue(req({ remindersSent: 1, lastSentAt: new Date(now.getTime() - 2 * DAY) }), now)).toBe(false); + expect(reminderDue(req({ remindersSent: 1, lastSentAt: new Date(now.getTime() - 3 * DAY) }), now)).toBe(true); + }); + + test('never once answered or expired', () => { + expect(reminderDue(req({ status: 'given', lastSentAt: new Date(0) }), now)).toBe(false); + expect(reminderDue(req({ lastSentAt: new Date(0), expiresAt: new Date(now.getTime() - 1) }), now)).toBe(false); + }); +}); + +describe('validateConsentAnswer', () => { + const event = { consentCollectMedical: true, consentCollectEmergency: true, consentCollectPhoto: true }; + const ok = { decision: 'give', signedName: 'Pat Parent', isGuardian: true, medical: { allergies: 'Peanuts' }, emergency: { name: 'Gran', phone: '0821234567' }, photoConsent: false }; + + test('accepts a complete answer and keeps only known fields', () => { + const out = validateConsentAnswer({ ...ok, extra: 'x' }, event); + expect(out).toEqual({ + decision: 'give', signedName: 'Pat Parent', + medical: { allergies: 'Peanuts', medication: '', conditions: '', medicalAid: '' }, + emergency: { name: 'Gran', phone: '0821234567', relationship: '' }, + photoConsent: false, + }); + }); + + test('needs a decision, a typed name and the guardian tick', () => { + expect(() => validateConsentAnswer({ ...ok, decision: 'maybe' }, event)).toThrow(/give or decline/); + expect(() => validateConsentAnswer({ ...ok, signedName: ' ' }, event)).toThrow(/full name/); + expect(() => validateConsentAnswer({ ...ok, isGuardian: false }, event)).toThrow(/parent or legal guardian/); + }); + + test('needs an emergency contact and a photo answer when asked for', () => { + expect(() => validateConsentAnswer({ ...ok, emergency: {} }, event)).toThrow(/emergency contact/); + expect(() => validateConsentAnswer({ ...ok, photoConsent: undefined }, event)).toThrow(/photo/); + }); + + test('declining needs no extra details', () => { + expect(validateConsentAnswer({ decision: 'decline', signedName: 'Pat', isGuardian: true }, event)) + .toEqual({ decision: 'decline', signedName: 'Pat', medical: null, emergency: null, photoConsent: null }); + }); +}); + +describe('hashToken', () => { + test('is stable and never the token itself', () => { + expect(hashToken('abc')).toBe(hashToken('abc')); + expect(hashToken('abc')).not.toContain('abc'); + expect(hashToken('abc')).not.toBe(hashToken('abd')); + }); +}); + +describe('validateAttendees on a youth event', () => { + const event = { + requiresParentalConsent: true, allowNamedAttendees: true, startDate: START, + eventOptions: [{ id: 'kid', name: 'Camper', isMainTicket: true }, { id: 'shirt', name: 'T-shirt', isMainTicket: false }], + }; + const places = { [lineKey('kid', null)]: 2, [lineKey('shirt', null)]: 1 }; + const parent = { parentName: 'Pat', parentEmail: 'pat@example.com', parentPhone: '0821234567' }; + + test('every main place must be named', () => { + expect(() => validateAttendees(event, places, [{ eventOptionId: 'kid', name: 'A', dateOfBirth: '1990-01-01' }])).toThrow(/every "Camper" ticket/); + }); + + test('a date of birth is required', () => { + expect(() => validateAttendees(event, places, [{ eventOptionId: 'kid', name: 'A' }, { eventOptionId: 'kid', name: 'B' }])).toThrow(/date of birth/); + }); + + test('minors need full parent details; adults do not', () => { + expect(() => validateAttendees(event, places, [ + { eventOptionId: 'kid', name: 'Kid', dateOfBirth: '2014-03-03', parentName: 'Pat' }, + { eventOptionId: 'kid', name: 'Leader', dateOfBirth: '1990-01-01' }, + ])).toThrow(/under 18/); + const out = validateAttendees(event, places, [ + { eventOptionId: 'kid', name: 'Kid', dateOfBirth: '2014-03-03', ...parent }, + { eventOptionId: 'kid', name: 'Leader', dateOfBirth: '1990-01-01' }, + ]); + expect(out[0]).toMatchObject({ name: 'Kid', parentEmail: 'pat@example.com' }); + expect(out[0].dateOfBirth).toBeInstanceOf(Date); + }); + + test('a date of birth in the future is refused', () => { + expect(() => validateAttendees(event, { [lineKey('kid', null)]: 1 }, [{ eventOptionId: 'kid', name: 'A', dateOfBirth: '2999-01-01' }])).toThrow(/valid date of birth/); + }); +}); diff --git a/apps/events/frontend/src/app/consent/[token]/page.tsx b/apps/events/frontend/src/app/consent/[token]/page.tsx new file mode 100644 index 0000000..8777a7f --- /dev/null +++ b/apps/events/frontend/src/app/consent/[token]/page.tsx @@ -0,0 +1,181 @@ +"use client"; +import React, { useEffect, useState } from "react"; +import { useParams } from "next/navigation"; +import { Navbar } from "@/components/layout/Navbar"; +import { Footer } from "@/components/layout/Footer"; +import { apiFetch, ApiError } from "@/lib/api"; +import { formatDate } from "@/lib/date"; +import { ShieldCheck, CheckCircle2, XCircle } from "lucide-react"; + +type ConsentInfo = { + status: "pending" | "given" | "declined"; + superseded: boolean; + expired: boolean; + respondedAt: string | null; + attendeeName: string; + parentName: string | null; + consentText: string; + event: { title: string; startDate: string; endDate: string; location: string | null }; + collect: { medical: boolean; emergency: boolean; photo: boolean }; +}; + +const inputCls = "w-full border rounded-lg px-3 py-2 text-sm focus:outline-none focus:ring-2 focus:ring-brand-400"; + +/** Public page a parent/guardian opens from their consent email or WhatsApp. */ +export default function ConsentPage() { + const params = useParams<{ token: string }>(); + const token = params?.token; + const [info, setInfo] = useState(null); + const [loadError, setLoadError] = useState(null); + const [error, setError] = useState(null); + const [busy, setBusy] = useState(false); + const [done, setDone] = useState<"given" | "declined" | null>(null); + + const [signedName, setSignedName] = useState(""); + const [isGuardian, setIsGuardian] = useState(false); + const [medical, setMedical] = useState({ allergies: "", medication: "", conditions: "", medicalAid: "" }); + const [emergency, setEmergency] = useState({ name: "", phone: "", relationship: "" }); + const [photoConsent, setPhotoConsent] = useState(null); + + useEffect(() => { + if (!token) return; + apiFetch(`/api/consent/${encodeURIComponent(token)}`) + .then(res => { setInfo(res); setSignedName(res.parentName || ""); }) + .catch(e => setLoadError(e instanceof ApiError ? e.message : "Couldn't load this consent request.")); + }, [token]); + + const submit = async (decision: "give" | "decline") => { + if (!token || !info) return; + setError(null); + if (decision === "give" && info.collect.photo && photoConsent === null) { setError("Please answer the photo consent question."); return; } + setBusy(true); + try { + await apiFetch(`/api/consent/${encodeURIComponent(token)}`, { + method: "POST", + body: { + decision, signedName, isGuardian, + ...(decision === "give" && info.collect.medical ? { medical } : {}), + ...(decision === "give" && info.collect.emergency ? { emergency } : {}), + ...(decision === "give" && info.collect.photo ? { photoConsent } : {}), + }, + }); + setDone(decision === "give" ? "given" : "declined"); + } catch (e) { + setError(e instanceof ApiError ? e.message : "Couldn't save your answer. Please try again."); + } finally { + setBusy(false); + } + }; + + const open = info && info.status === "pending" && !info.superseded && !info.expired && !done; + + return ( +
+ +
+
+
+ +
+

Parental consent

+
+ + {loadError &&
{loadError}
} + {!info && !loadError &&
Loading…
} + + {info && ( +
+
+
Event
+
{info.event.title}
+
+ {formatDate(new Date(info.event.startDate))}{info.event.endDate ? ` – ${formatDate(new Date(info.event.endDate))}` : ""} + {info.event.location ? ` · ${info.event.location}` : ""} +
+
+
+
Attendee
+
{info.attendeeName}
+
+ + {(done || info.status !== "pending") && ( +
+ {(done || info.status) === "given" ? : } + + {(done || info.status) === "given" ? "Consent has been given. Thank you!" : "Consent has been declined. The organisers have been told."} + {!done && info.respondedAt && ` (${formatDate(new Date(info.respondedAt))})`} + +
+ )} + {!done && info.status === "pending" && info.superseded && ( +
A newer consent request has replaced this one. Please use the link in your latest message.
+ )} + {!done && info.status === "pending" && info.expired && ( +
This consent link has expired because the event has ended.
+ )} + + {open && ( + <> +
+
Please read
+
{info.consentText || "The organisers haven't added any consent text."}
+
+ + {info.collect.medical && ( +
+ Medical information (kept confidential and deleted after the event) +