diff --git a/apps/events/CHANGELOG.md b/apps/events/CHANGELOG.md index 2f81a93..d1aa16e 100644 --- a/apps/events/CHANGELOG.md +++ b/apps/events/CHANGELOG.md @@ -7,6 +7,39 @@ and this project follows [Semantic Versioning](https://semver.org/). ## [Unreleased] +## [1.43.0] - 2026-10-27 + +### Added + +- **Campuses** (Site settings → Campuses, off by default) for a church with more than one campus + in one install. Churches with one campus see no campus fields anywhere. + - Admins turn campuses on, then add, order, archive and delete campuses: name, web address, + address, contact, colour, logo, default event location, and staff who get that campus's daily + summary. A campus with events can't be deleted, only archived. Turning campuses off hides + everything campus-related and deletes nothing. + - **Events** belong to one campus or to **All campuses** (church-wide). Choosing a campus fills + in its default location; moving an event to another campus is in the audit log. The Events + list in the dashboard shows each event's campus and has a campus filter. + - **Public site:** a campus filter on the events page, remembered in the visitor's browser and + starting on their home campus; a campus shows its own events plus church-wide ones. The campus + shows on event cards, the event page and ticket PDFs. **Campus pages** at `/campus/` + (also in the sitemap). + - **Home campus** on the profile page. + - **Reports and dashboards:** a campus filter on Reports (all reports and the funnel) and on the + admin and supervisor dashboards' past-month tiles, with a church-wide total. + - **Broadcasts:** "Everyone at a campus" in Email and WhatsApp broadcasts — people whose home + campus it is, plus (ticked) people who registered for its events in the last 12 months. News + consent still applies. + - **Daily summary:** campus recipients also get the summary of their campus's events. + - The Hub heartbeat reports whether campuses are on and how many there are (`campusCount`). + - Campus-scoped staff (supervisors and staff limited to some campuses) follow in 1.44.0. +- The privacy notice lists the new `hope_events_campus` browser-storage item. + +### Fixed + +- "Request update" (1.42.0) wasn't written to the audit log: the `hub_update_requested` action was + missing from the database. The request itself always worked. + ## [1.42.1] - 2026-10-27 ### Changed diff --git a/apps/events/FEATURES.md b/apps/events/FEATURES.md index da59c7d..f223db0 100644 --- a/apps/events/FEATURES.md +++ b/apps/events/FEATURES.md @@ -29,12 +29,13 @@ WhatsApp · PM2 for process management · optional Sentry for error monitoring. 13. [Cashup & event costs](#cashup--event-costs) 14. [Reports](#reports) 15. [Site settings & setup wizard](#site-settings--setup-wizard) -16. [Accounts & security](#accounts--security) -17. [Privacy (POPIA)](#privacy-popia) -18. [Help system](#help-system) -19. [Background jobs](#background-jobs) -20. [Operations](#operations) -21. [Page map](#page-map) +16. [Multi-campus](#multi-campus) +17. [Accounts & security](#accounts--security) +18. [Privacy (POPIA)](#privacy-popia) +19. [Help system](#help-system) +20. [Background jobs](#background-jobs) +21. [Operations](#operations) +22. [Page map](#page-map) --- @@ -511,6 +512,7 @@ applied without a restart. Secrets are encrypted with AES-256-GCM. | Tab | Contains | |-----|----------| | Organisation | Name, tagline, contact email/phone, address (with map link) | +| Campuses | Off by default. Turn on, then add, order, archive or delete campuses (name, web address, address, contact, colour, logo, default event location, daily-summary recipients) | | Branding | Primary/secondary/accent colours, logo, favicon, colours suggested from the logo, live website/email preview on desktop and mobile | | Notifications | Registrations inbox and admin notification emails | | Email | SMTP host/port/TLS/user/password/from, with a "Test connection" button | @@ -523,6 +525,28 @@ See [SETTINGS.md](./SETTINGS.md) for the default of every setting. --- +## Multi-campus + +For a church with several campuses in one install (Site settings → Campuses, off by +default — single-campus churches never see campus fields). + +- **Events** belong to one campus or to **All campuses** (church-wide). Choosing a campus fills in + its default location. Moving an event to another campus is in the audit log. +- **Public site:** a campus filter on the events page, remembered per visitor and starting on their + home campus; a campus shows its own events plus church-wide ones. The campus shows on event cards, + the event page and ticket PDFs. Each campus has a page at `/campus/` (also in the sitemap). +- **People** choose a home campus on their profile. +- **Reports and dashboards:** a campus filter on Reports (every report and the funnel) and on the + admin/supervisor dashboards' month-over-month tiles, with a church-wide total. +- **Messages:** "Everyone at a campus" in Email and WhatsApp broadcasts — home campus, plus (ticked) + people who registered for its events in the last 12 months. News consent still applies. +- **Daily summary:** campus recipients get the summary of their campus's events. +- **Turning it off** hides everything campus-related; nothing is deleted. A campus with events can't + be deleted, only archived. +- Campus-scoped staff (limited to some campuses) come in 1.44.0. + +--- + ## Accounts & security - Register, log in, forgot/reset password, activate account (for accounts @@ -689,6 +713,7 @@ can't start, the same jobs run on in-process timers. |------|-----|------| | `/` | Public | Home | | `/events`, `/events/[id]` | Public | Event list and detail | +| `/campus/[slug]` | Public | A campus's page and its events (while campuses are on) | | `/[alias]` | Public | Event short link | | `/register/[eventId]` | Public / User | Registration | | `/registration/success` | Public / User | Confirmation, form and pay | diff --git a/apps/events/SETTINGS.md b/apps/events/SETTINGS.md index b28a8c1..5ca3f2d 100644 --- a/apps/events/SETTINGS.md +++ b/apps/events/SETTINGS.md @@ -85,6 +85,12 @@ Managed in the Payments tab (through `/api/payments/providers/settings` and `/ap | `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. | +## Campuses + +| Setting | Default when unset | Notes | +|---|---|---| +| `campuses_enabled` | `false` | Site settings → Campuses → "Use campuses". Changed only through `PUT /api/campuses/settings` (audited); hidden from the generic settings endpoints. Off hides campus fields and filters everywhere; campuses and each event's campus are kept. The campuses themselves are in the `Campus` table. | + ## Cross Events Hub (licence) | Setting | Default when unset | Notes | diff --git a/apps/events/backend/API_DOCUMENTATION.md b/apps/events/backend/API_DOCUMENTATION.md index 058d615..76c2129 100644 --- a/apps/events/backend/API_DOCUMENTATION.md +++ b/apps/events/backend/API_DOCUMENTATION.md @@ -847,9 +847,33 @@ The connection to the Cross Events Hub (`src/hub/`, protocol in `docs/hub-protoc | GET | `/api/hub/status` | admin | `{ state: active\|grace\|suspended\|revoked\|unlicensed, readOnly, daysLeft, endsAt, graceEndsAt, licence, connected, keyConfigured, hubUrl, lastHeartbeatAt, lastError, version, latestVersion, updateAvailable }` | | POST | `/api/hub/connect` | admin (incl. the `/setup` token) | `{ licenceKey }` — registers with the Hub; stores the install id, encrypted secret and licence token. Hub errors pass through with their `code` (`LICENCE_NOT_FOUND`, `LICENCE_IN_USE`, `LICENCE_REVOKED`, `HUB_UNREACHABLE`, …). Audited as `hub_connected` | | POST | `/api/hub/heartbeat` | admin | Check in now; returns the status | +| POST | `/api/hub/update-request` | admin | Ask the Hub for this site to be updated (protocol §3a); the provider is told, nothing runs on the site. Returns the status with `updateRequest: { requestedAt, version }` until the site runs that version. `409 UP_TO_DATE`; audited as `hub_update_requested` | **Read-only mode** (licence suspended, revoked, or past its grace period): `403 { code: "LICENCE_READ_ONLY" }` on `POST /api/events`, event options and variants, `POST /api/registrations` (and `/manual`), `PUT /api/registrations/:id/options`, `POST /api/payments`, `/payments/checkout` (`/send`), `/payments/yoco-checkout` (`/send`), `/payments/pay/:id`, `POST /api/waitlist`, `POST /api/coupons`, `POST /api/bundles/event/:id`. Everything else — scanning, exports, refunds, cancellations, privacy requests, settings — keeps working, and payment webhooks for payments already started are still processed. +## Campuses + +Multi-campus (`src/utils/campuses.js`), off by default. While off, every campus field and filter +below is ignored and `GET /api/campuses` returns `{ enabled: false, campuses: [] }`. + +| Method | Path | Auth | Description | +|--------|------|------|-------------| +| GET | `/api/campuses` | public | `{ enabled, campuses }` — active campuses in order | +| GET | `/api/campuses/by-slug/:slug` | public | One active campus (its `/campus/` page); 404 when archived or off | +| GET | `/api/campuses/admin` | admin | All campuses incl. archived, with `notifyRecipients` and `_count { events, homeOf }` | +| PUT | `/api/campuses/settings` | admin | `{ enabled }` — audited as `campuses_toggled` (the `campuses_enabled` setting can't be changed through `PUT /api/settings`) | +| POST | `/api/campuses` | admin | `{ name, slug?, address?, contactName?, contactEmail?, contactPhone?, colour? (#rrggbb), logoUrl?, defaultLocation? }`; 409 when the slug is taken | +| PUT | `/api/campuses/:id` | admin | Same fields, plus `notifyRecipientIds` (staff only) and `archived` | +| PUT | `/api/campuses/order` | admin | `{ ids: [...] }` | +| DELETE | `/api/campuses/:id` | admin | Only without events — otherwise `409 CAMPUS_HAS_EVENTS` (archive instead) | +| GET | `/api/campuses/:id/audience` | supervisor+ | `{ campus, users }` — home campus, plus `?registrants=true` people registered for its events in the last 12 months (not cancelled). Broadcasts send to these ids as usual, so news consent still applies | + +**Campus on other endpoints:** +- Events carry `campusId` (null = all campuses) and `campus { id, name, slug, colour }`. `POST`/`PUT /api/events` take `campusId` (`''`/`null` = all campuses; an archived campus can stay but can't be newly chosen); moving an event is audited as `event_campus_changed`. +- `GET /api/events?campus=` — that campus's events plus church-wide ones. `GET /api/events/all?campus=` — one campus, or church-wide only. +- `GET /api/stats/overview?campus=`. +- `PUT /api/users/profile` takes `homeCampusId`; `GET` returns it. + ## Webhooks | Method | Path | Auth | Description | diff --git a/apps/events/backend/package-lock.json b/apps/events/backend/package-lock.json index 6e0734b..eac7a4e 100644 --- a/apps/events/backend/package-lock.json +++ b/apps/events/backend/package-lock.json @@ -1,12 +1,12 @@ { "name": "event-management-backend", - "version": "1.42.1", + "version": "1.43.0", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "event-management-backend", - "version": "1.42.1", + "version": "1.43.0", "hasInstallScript": true, "dependencies": { "@prisma/adapter-pg": "^7.10.1", diff --git a/apps/events/backend/package.json b/apps/events/backend/package.json index a9adf97..63399a9 100644 --- a/apps/events/backend/package.json +++ b/apps/events/backend/package.json @@ -1,6 +1,6 @@ { "name": "event-management-backend", - "version": "1.42.1", + "version": "1.43.0", "description": "Event Management System Backend", "main": "src/index.js", "scripts": { diff --git a/apps/events/backend/src/index.js b/apps/events/backend/src/index.js index 2c22847..9d39d90 100644 --- a/apps/events/backend/src/index.js +++ b/apps/events/backend/src/index.js @@ -926,6 +926,22 @@ app.get('/docs', async (req, res) => { responses:[{ status:200, desc:'Status, with updateRequest', body:{ updateAvailable:true, updateRequest:{ requestedAt:'2026-10-27T09:00:00.000Z', version:'1.42.0' } }}, { status:409, desc:'Already on the latest version', body:{ code:'UP_TO_DATE', message:'This site already runs the latest version.' }}, { status:502, desc:'Hub unreachable' }]}, ]}, + { title: 'Campuses', base: '/api/campuses', endpoints: [ + { method:'GET', path:'/api/campuses', auth:'Public', desc:'Whether campuses are on, and the active campuses in order (empty while off)', + responses:[{ status:200, desc:'Success', body:{ enabled:true, campuses:[{ id:'c_1', name:'Henley Campus', slug:'henley-campus', address:'1 Church St', colour:'#1d4ed8', defaultLocation:'Main hall', order:0 }] }}]}, + { method:'GET', path:'/api/campuses/by-slug/:slug', auth:'Public', desc:'One active campus, for its /campus/ page (404 when archived or campuses are off)' }, + { method:'GET', path:'/api/campuses/admin', auth:'admin', desc:'All campuses with archived ones, event and home-campus counts, and daily-summary recipients' }, + { method:'PUT', path:'/api/campuses/settings', auth:'admin', desc:'Turn campuses on or off (off hides campus fields and filters; nothing is deleted). Audited as campuses_toggled', + request:{ body:{ enabled:true } }}, + { method:'POST', path:'/api/campuses', auth:'admin', desc:'Add a campus (slug made from the name unless given). 409 if the slug is taken', + request:{ body:{ name:'Henley Campus', address:'1 Church St', colour:'#1d4ed8', defaultLocation:'Main hall' } }}, + { method:'PUT', path:'/api/campuses/:id', auth:'admin', desc:'Change a campus, its daily-summary recipients (staff only) and archived state', + request:{ body:{ name:'Henley Campus', notifyRecipientIds:['u_1'], archived:false } }}, + { method:'PUT', path:'/api/campuses/order', auth:'admin', desc:'Put the campuses in this order', request:{ body:{ ids:['c_2','c_1'] } }}, + { method:'DELETE', path:'/api/campuses/:id', auth:'admin', desc:'Delete a campus with no events (409 CAMPUS_HAS_EVENTS otherwise — archive it)' }, + { method:'GET', path:'/api/campuses/:id/audience', auth:'supervisor+', desc:'"Everyone at campus X" for broadcasts: home campus X, plus with ?registrants=true people registered for its events in the last 12 months' }, + ]}, + { title: 'Privacy (POPIA)', base: '/api/privacy', endpoints: [ { method:'GET', path:'/api/privacy/me', auth:'user', desc:'My news opt-in, its history, and my privacy requests', responses:[{ status:200, desc:'Success', body:{ news:{ email:true, whatsapp:false }, newsAskedAt:'2026-10-23T08:00:00.000Z', canWhatsApp:false, notificationPreference:'email', history:[{ channel:'email', granted:true, source:'signup', createdAt:'2026-10-23T08:00:00.000Z' }], requests:[] }}]}, @@ -1172,7 +1188,7 @@ app.get('/docs', async (req, res) => { { method:'GET', path:'/api/stats/staff', auth:'staff+', desc:'Everything the staff dashboard needs, in one call' }, { method:'GET', path:'/api/stats/supervisor', auth:'supervisor+', desc:'Everything the supervisor dashboard needs, in one call' }, { method:'GET', path:'/api/stats/admin', auth:'admin', desc:'Everything the admin dashboard needs, in one call' }, - { method:'GET', path:'/api/stats/overview', auth:'supervisor+', desc:'Trailing-month KPIs (registrations, tickets, revenue, donations), revenue trend, top events, funnel conversion' }, + { method:'GET', path:'/api/stats/overview', auth:'supervisor+', desc:'Trailing-month KPIs (registrations, tickets, revenue, donations), revenue trend, top events, funnel conversion. ?campus= for one campus or church-wide events only' }, ]}, { title: 'Backups', base: '/api/backups', endpoints: [ { method:'GET', path:'/api/backups', auth:'admin', desc:'Local database backups, newest first' }, diff --git a/apps/events/backend/src/utils/privacyNotice.js b/apps/events/backend/src/utils/privacyNotice.js index eb2e759..18a4508 100644 --- a/apps/events/backend/src/utils/privacyNotice.js +++ b/apps/events/backend/src/utils/privacyNotice.js @@ -182,6 +182,7 @@ const DEFAULT_SECTIONS = [ '• hope_events_device — only if you tick "Trust this device" when entering a two-factor code, so you aren\'t asked for a code every time.', '• hope_events_cookie_consent — remembers your choice on the cookie notice.', '• banner_dismissed_… — remembers notices you have closed.', + '• hope_events_campus — only on churches with more than one campus: the campus you chose on the events page, so it stays chosen.', 'Staff and administrators only:', '• hope_events_scan_device, hope_events_offline_lock and the "hope-events-offline-scan" database — on a staff member\'s scanner in offline mode: the device\'s id, the ticket list for the section being scanned, and scans waiting to upload. They are deleted when offline mode is ended. A copy of the scanner page is also cached so it opens without a connection.', '• hope_events_admin_token, hope_events_admin_user_cache and hope_events_impersonation — only while an administrator is using read-only support access (section 9), and removed when it ends.', diff --git a/apps/events/docs/HANDOVER.md b/apps/events/docs/HANDOVER.md index 73da37c..10b2ed9 100644 --- a/apps/events/docs/HANDOVER.md +++ b/apps/events/docs/HANDOVER.md @@ -1,6 +1,6 @@ # Handover — where things stand and how to carry on -Last updated: 2026-10-27, after **1.42.1** (and Hub 1.1.0). The plan itself is in +Last updated: 2026-10-27, after **1.43.0** (and Hub 1.1.0). The plan itself is in [ROADMAP-v2.md](./ROADMAP-v2.md) (decisions table at the end); the previous round of features is in [FEATURES-ROUND-1.md](./FEATURES-ROUND-1.md). @@ -14,6 +14,7 @@ encrypted settings unreadable or break existing installs. | Version | What | |---------|------| +| 1.43.0 | **Campuses** (§12 part 1): Site settings → Campuses (off by default), events per campus or all campuses, public campus filter (remembered, starts on home campus) and `/campus/` pages, home campus on the profile, campus filters on Reports and the dashboards, "Everyone at a campus" in broadcasts, campus summary recipients, campus on ticket PDFs, heartbeat `campusCount`. Also adds the `hub_update_requested` audit action missing since 1.42.0 | | 1.42.1 | Production Hub public key built in (`publicKey.js`); `HUB_PUBLIC_KEY` only needed for a local Hub | | 1.42.0 | **Request update** instead of the deploy command: Site settings → Licence sends a signed update request to the Hub (protocol §3a), which opens an alert and emails Joshua; "Update requested on …" until the site runs that version, and the admin update banner hides meanwhile. Audit action `hub_update_requested`. Needs Hub 1.1.0 | | 1.41.3 | Renamed Hope Events → **Cross Events** in all UI text and docs (technical identifiers unchanged, see above) | @@ -42,7 +43,10 @@ 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.43.0 — Multi-campus** (§12). +3. **1.44.0 — Campus-scoped staff** (§12, "Plumbing (1.44.0)"): `UserCampusScope`, a + `utils/campusScope.js` helper on every staff/supervisor endpoint (115 in 27 route files at + 1.42.1), and the route-list test that fails on any endpoint that isn't campus-checked or marked + campus-independent. ## Working on this repo @@ -191,6 +195,23 @@ encrypted settings unreadable or break existing installs. - `scripts/install.sh` — fresh Ubuntu server to a running site (written and syntax-checked; not yet run on a real server). +## Where campuses live (1.43.0) + +- `backend/src/utils/campuses.js`: the setting (`campuses_enabled`, off by default), `campusWhere` + (list filters: one campus, `'all'` = church-wide only, `withAllCampuses` for the public list), + `campusForEvent` (what to save on an event), `campusAudienceWhere` (broadcast audience). Pure + parts are tested in `tests/campuses.test.js`. +- `controllers/campusController.js`, routes `/api/campuses/*`. The setting is changed only through + `PUT /api/campuses/settings` (it's in `PRIVATE_KEYS` in the settings controller). +- **While campuses are off, every campus field and filter is ignored** (the data stays). New code + should check `campusesEnabled()` the same way. +- Frontend: `hooks/useCampuses.ts` (one cached `GET /api/campuses` per page load), + `components/shared/CampusFilter.tsx` (`CampusFilter`, `matchesCampus`, `CampusBadge`), + `CampusAudiencePicker.tsx`, `components/admin/CampusesTab.tsx`, `components/events/EventsGrid.tsx` + (public filter, `hope_events_campus` in localStorage), `app/campus/[slug]/page.tsx`. +- e2e: the campuses and two events' campuses are **seeded** in `e2e/support/prepare-db.js` with + campuses off (so a pre-built frontend already has them); `campuses.spec.ts` turns them on and off. + ## Known gaps / follow-ups - WhatsApp STOP only works once someone pastes the webhook URL from Site settings → WhatsApp diff --git a/apps/events/docs/ROADMAP-v2.md b/apps/events/docs/ROADMAP-v2.md index 4edc7dd..24f1377 100644 --- a/apps/events/docs/ROADMAP-v2.md +++ b/apps/events/docs/ROADMAP-v2.md @@ -27,8 +27,9 @@ notifications. SnapScan and Zapper are dropped — Yoco and PayFast are enough ( Cross Events Hub); 1.42.0 **Request update** button instead of the deploy command, with Hub 1.1.0 (update requests); 1.42.1 the production Hub key built in. Later versions moved up by one (2026-10-27). Multi-campus is split in two — 1.43.0 campuses, 1.44.0 campus-scoped staff — so -everything after moves up by one more (2026-10-27). -**Next: 1.43.0 Campuses.** +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). +**Next: 1.44.0 Campus-scoped staff.** **Repositories:** @@ -909,7 +910,7 @@ income justify the hardware: | 4 | 1.36.0 ✅ – 1.37.2 | Payment provider interface (Yoco moved behind it) → PayFast, then hiding "Pay online" when it can't be used and payment status checks (SnapScan and Zapper dropped) | Payment code gets split out of the big controller as part of this | | 5 | 1.38.0 ✅ 1.39.0 ✅ 1.40.0 ✅ | **POPIA toolkit** (1.38.0: user privacy centre, unsubscribe, WhatsApp STOP, data requests inbox; 1.39.0: privacy notice editor + versions, operator register, consent log, access log; 1.40.0: retention jobs, breach register, children’s-data flags, readiness page) | Main selling point; retention jobs use the job queue | | 6 | 1.41.0 ✅ – 1.42.0 ✅ + Hub 1.0 ✅ – 1.1 ✅ | Install/update scripts, `/health`, licence step in `/setup`, "Connect to Hub", heartbeat, licence states — plus the **Hub** app (separate repo); rename to Cross Events (1.41.3); Request update (1.42.0 / Hub 1.1.0) | Must exist before the first church is sold; Hope Family Church registers as install #1 | -| 7 | 1.43.0 – 1.44.0 | **Multi-campus**: 1.43.0 campuses (settings, events, public filter and landing pages, home campus, filters, messages, summaries); 1.44.0 campus-scoped staff | Kids rooms and volunteer roles are per campus, so campuses come first; scoping is split out because it's security-heavy | +| 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 | diff --git a/apps/events/docs/hub-protocol.md b/apps/events/docs/hub-protocol.md index c47b9bf..a3ef0e5 100644 --- a/apps/events/docs/hub-protocol.md +++ b/apps/events/docs/hub-protocol.md @@ -96,7 +96,8 @@ X-Hub-Signature: "checkIns": { "last30d": 96 }, "messages": { "email30d": 610, "whatsapp30d": 233 }, "paymentProviders": ["yoco", "payfast"], - "campuses": false, + "campuses": false, // Site settings → Campuses on/off + "campusCount": 0, // active campuses (0 while off; Cross Events 1.43.0+) "income": { "last30d": "R5 001–R20 000", "allTime": "over R100 000" } } } diff --git a/apps/events/e2e/campuses.spec.ts b/apps/events/e2e/campuses.spec.ts new file mode 100644 index 0000000..da2c53a --- /dev/null +++ b/apps/events/e2e/campuses.spec.ts @@ -0,0 +1,45 @@ +import { test, expect, seed, api, API } from "./fixtures"; + +// Multi-campus. The campuses and the two events' campuses are seeded (e2e/support/prepare-db.js) +// with campuses off; these tests turn them on, and off again afterwards so the other specs see a +// single-campus church. +test.describe("campuses", () => { + test.beforeAll(async ({ browser }) => { + const page = await browser.newPage(); + await api(page, "admin", "PUT", "/api/campuses/settings", { enabled: true }); + await page.close(); + }); + + test.afterAll(async ({ browser }) => { + const page = await browser.newPage(); + await api(page, "admin", "PUT", "/api/campuses/settings", { enabled: false }); + await page.close(); + }); + + test("the events page filters by campus and keeps church-wide events", async ({ page }) => { + await page.goto("/events"); + await expect(page.getByText("E2E Paid Conference")).toBeVisible(); + await page.getByLabel("Campus").selectOption({ label: "E2E North" }); + await expect(page.getByText("E2E Free Evening")).toBeVisible(); // North + await expect(page.getByText("E2E Alpha Course")).toBeVisible(); // all campuses + await expect(page.getByText("E2E Paid Conference")).toBeHidden(); // South + // The choice is remembered. + await page.reload(); + await expect(page.getByLabel("Campus")).toHaveValue(seed().campuses.north.id); + await expect(page.getByText("E2E Paid Conference")).toBeHidden(); + }); + + test("a campus has its own page", async ({ page }) => { + await page.goto(`/campus/${seed().campuses.north.slug}`); + await expect(page.getByRole("heading", { name: "E2E North" })).toBeVisible(); + await expect(page.getByText("1 North Road")).toBeVisible(); + await expect(page.getByText("E2E Free Evening")).toBeVisible(); + await expect(page.getByText("E2E Paid Conference")).toBeHidden(); + }); + + test("a campus with events can't be deleted", async ({ page }) => { + const res = await page.request.delete(`${API}/api/campuses/${seed().campuses.north.id}`, { headers: { Authorization: `Bearer ${seed().users.admin.token}` } }); + expect(res.status()).toBe(409); + expect((await res.json()).code).toBe("CAMPUS_HAS_EVENTS"); + }); +}); diff --git a/apps/events/e2e/fixtures.ts b/apps/events/e2e/fixtures.ts index b780dbd..6c10086 100644 --- a/apps/events/e2e/fixtures.ts +++ b/apps/events/e2e/fixtures.ts @@ -6,6 +6,7 @@ export type Role = "admin" | "supervisor" | "staff" | "user"; export type Seed = { users: Record; events: { free: string; paid: string; course: string; dropIn: string; conference: string }; + campuses: Record<"north" | "south", { id: string; slug: string }>; course: { sessions: { id: string; label: string }[]; ticketId: string; qrCode: string }; unsubscribeToken: string; newsPromptUser: { id: string; token: string }; diff --git a/apps/events/e2e/support/prepare-db.js b/apps/events/e2e/support/prepare-db.js index 6fa93e5..a0f93da 100644 --- a/apps/events/e2e/support/prepare-db.js +++ b/apps/events/e2e/support/prepare-db.js @@ -68,8 +68,14 @@ async function seed(url) { return d; }; + // Multi-campus: two campuses with campuses switched off (campuses.spec.ts turns them on). + // Seeded here rather than in the test so pages built before the tests already carry them. + const north = await prisma.campus.create({ data: { name: 'E2E North', slug: 'e2e-north', address: '1 North Road', order: 0 } }); + const south = await prisma.campus.create({ data: { name: 'E2E South', slug: 'e2e-south', order: 1 } }); + const free = await prisma.event.create({ data: { + campusId: north.id, title: 'E2E Free Evening', description: 'A free evening for the tests.', startDate: at(1), endDate: at(1, 19), price: 0, location: '1 Test Street, Pretoria', createdById: users.supervisor.id, eventOptions: { create: [{ name: 'Entry', price: 0, isMainTicket: true }] }, @@ -77,6 +83,7 @@ async function seed(url) { }); const paid = await prisma.event.create({ data: { + campusId: south.id, title: 'E2E Paid Conference', description: 'A paid one-day conference.', startDate: at(3, 7), endDate: at(3, 15), price: 150, location: '1 Test Street, Pretoria', createdById: users.supervisor.id, eventOptions: { create: [{ name: 'Conference ticket', price: 150, isMainTicket: true }] }, @@ -156,6 +163,7 @@ async function seed(url) { const out = { users: Object.fromEntries(Object.entries(users).map(([k, u]) => [k, { id: u.id, name: u.name, email: u.email, token: generateToken(u.id, u.role, u.tokenVersion || 0) }])), events: { free: free.id, paid: paid.id, course: course.id, dropIn: dropIn.id, conference: conference.id }, + campuses: { north: { id: north.id, slug: north.slug }, south: { id: south.id, slug: south.slug } }, course: { sessions: course.sessions.map(s => ({ id: s.id, label: s.label })), ticketId: ticket.id, qrCode: ticket.qrCode }, // An account that has never answered the news question (asked once after login). newsPromptUser: await (async () => { diff --git a/apps/events/frontend/package-lock.json b/apps/events/frontend/package-lock.json index 3eeb65b..713e62e 100644 --- a/apps/events/frontend/package-lock.json +++ b/apps/events/frontend/package-lock.json @@ -1,12 +1,12 @@ { "name": "hope-events-frontend", - "version": "1.42.1", + "version": "1.43.0", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "hope-events-frontend", - "version": "1.42.1", + "version": "1.43.0", "dependencies": { "@dnd-kit/core": "^6.3.1", "@hookform/resolvers": "^5.2.1", diff --git a/apps/events/frontend/package.json b/apps/events/frontend/package.json index a4b8579..bbf9cf6 100644 --- a/apps/events/frontend/package.json +++ b/apps/events/frontend/package.json @@ -1,6 +1,6 @@ { "name": "hope-events-frontend", - "version": "1.42.1", + "version": "1.43.0", "private": true, "scripts": { "dev": "next dev --turbopack", diff --git a/apps/events/frontend/src/app/campus/[slug]/page.tsx b/apps/events/frontend/src/app/campus/[slug]/page.tsx new file mode 100644 index 0000000..fa495f3 --- /dev/null +++ b/apps/events/frontend/src/app/campus/[slug]/page.tsx @@ -0,0 +1,93 @@ +import { Metadata } from "next"; +import Link from "next/link"; +import { notFound } from "next/navigation"; +import { Navbar } from "@/components/layout/Navbar"; +import { Footer } from "@/components/layout/Footer"; +import { EventCard } from "@/components/events/EventCard"; +import { ApiImage } from "@/components/shared/ApiImage"; +import { apiFetch, apiFetchListForPrerender, ApiError } from "@/lib/api"; +import { mapsSearchUrl } from "@/lib/maps"; +import { CalendarX, MapPin, Mail, Phone, User, ArrowLeft } from "lucide-react"; +import type { Campus } from "@/hooks/useCampuses"; + +export const revalidate = 60; + +type Event = React.ComponentProps["event"] & { cashupStatus?: string; nextSession?: { startsAt: string } | null }; + +async function loadCampus(slug: string): Promise { + try { + return await apiFetch(`/api/campuses/by-slug/${encodeURIComponent(slug)}`, { nextOptions: { next: { revalidate } } }); + } catch (e) { + // 404: no such campus, archived, or campuses are off. + if (e instanceof ApiError && e.status === 404) return null; + throw e; + } +} + +export async function generateMetadata({ params }: { params: Promise<{ slug: string }> }): Promise { + const { slug } = await params; + const campus = await loadCampus(slug); + if (!campus) return {}; + return { + title: `${campus.name} — events`, + description: `Upcoming events at ${campus.name}${campus.address ? `, ${campus.address}` : ""}.`, + alternates: { canonical: `/campus/${campus.slug}` }, + }; +} + +/** A campus's own page: its details and upcoming events (its own plus church-wide ones). */ +export default async function CampusPage({ params }: { params: Promise<{ slug: string }> }) { + const { slug } = await params; + const campus = await loadCampus(slug); + if (!campus) notFound(); + + const events = await apiFetchListForPrerender(`/api/events?campus=${encodeURIComponent(campus.slug)}`, { nextOptions: { next: { revalidate } } }); + const now = Date.now(); + const upcoming = (events || []) + .filter(e => e.cashupStatus !== "closed" && new Date(e.endDate || e.startDate).getTime() > now) + .sort((a, b) => new Date(a.nextSession?.startsAt || a.startDate).getTime() - new Date(b.nextSession?.startsAt || b.startDate).getTime()); + + return ( +
+ +
+ + All events + +
+
+ {campus.logoUrl && } +
+

{campus.name}

+
+ {campus.address && ( +

+ + {campus.address} +

+ )} + {campus.contactName &&

{campus.contactName}

} + {campus.contactEmail &&

{campus.contactEmail}

} + {campus.contactPhone &&

{campus.contactPhone}

} +
+
+
+
+ +

Upcoming events

+

Events at {campus.name}, and church-wide events for every campus.

+ {upcoming.length === 0 ? ( +
+ +

No upcoming events at {campus.name} right now — check back soon.

+
+ ) : ( +
+ {upcoming.map(event => )} +
+ )} +
+
+
+ ); +} diff --git a/apps/events/frontend/src/app/dashboard/admin/audit-log/page.tsx b/apps/events/frontend/src/app/dashboard/admin/audit-log/page.tsx index 38a292a..f2c7164 100644 --- a/apps/events/frontend/src/app/dashboard/admin/audit-log/page.tsx +++ b/apps/events/frontend/src/app/dashboard/admin/audit-log/page.tsx @@ -97,6 +97,12 @@ const ACTION_LABELS: Record = { breach_updated: "Security compromise updated", hub_connected: "Connected to the Cross Events Hub", hub_update_requested: "Asked the Hub for an update", + campuses_toggled: "Campuses turned on/off", + campus_created: "Campus added", + campus_updated: "Campus changed", + campus_archived: "Campus archived/restored", + campus_deleted: "Campus deleted", + event_campus_changed: "Event moved to another campus", }; interface AuditLogEntry { diff --git a/apps/events/frontend/src/app/dashboard/admin/page.tsx b/apps/events/frontend/src/app/dashboard/admin/page.tsx index 6976fa4..85867ba 100644 --- a/apps/events/frontend/src/app/dashboard/admin/page.tsx +++ b/apps/events/frontend/src/app/dashboard/admin/page.tsx @@ -15,6 +15,7 @@ import { QuickActionTile, QuickActionGrid } from "@/components/shared/QuickActio import { AreaTrendChart } from "@/components/charts/AreaTrendChart"; import { Table, TableHeader, TableBody, TableRow, TableHead, TableCell } from "@/components/ui/table"; import type { DashboardStats, PaymentStats } from "@/types"; +import { CampusFilter } from "@/components/shared/CampusFilter"; const formatRand = (n: number) => `R ${(n || 0).toFixed(2)}`; const formatRandAxis = (n: number) => `R${new Intl.NumberFormat(undefined, { notation: "compact", maximumFractionDigits: 1 }).format(n)}`; @@ -77,6 +78,7 @@ export default function AdminDashboardPage() { const [loadingStats, setLoadingStats] = useState(false); const hasLoadedOnce = useRef(false); const [paymentsTab, setPaymentsTab] = useState<"today" | "week" | "month">("today"); + const [campus, setCampus] = useState(""); const loadStats = useCallback(async () => { if (!token) return; @@ -85,7 +87,8 @@ export default function AdminDashboardPage() { if (isFirstLoad) setLoadingStats(true); const [dash, overviewData] = await Promise.all([ apiFetch("/api/stats/admin", { authToken: token }), - apiFetch("/api/stats/overview", { authToken: token }), + // The month-over-month tiles follow the campus filter; today's totals stay church-wide. + apiFetch(`/api/stats/overview${campus ? `?campus=${encodeURIComponent(campus)}` : ""}`, { authToken: token }), ]); setPaymentStats(dash.paymentStats); setOverview(overviewData); @@ -95,7 +98,7 @@ export default function AdminDashboardPage() { hasLoadedOnce.current = true; if (isFirstLoad) setLoadingStats(false); } - }, [token, setPaymentStats, setOverview]); + }, [token, campus, setPaymentStats, setOverview]); useEffect(() => { if (!token) return; @@ -118,6 +121,7 @@ export default function AdminDashboardPage() {

Welcome back{user ? `, ${user.name}` : ""} 👋

Here's what's happening with your events today.

+
{!isAdmin && ( diff --git a/apps/events/frontend/src/app/dashboard/admin/settings/page.tsx b/apps/events/frontend/src/app/dashboard/admin/settings/page.tsx index ddfc803..877f7a8 100644 --- a/apps/events/frontend/src/app/dashboard/admin/settings/page.tsx +++ b/apps/events/frontend/src/app/dashboard/admin/settings/page.tsx @@ -7,22 +7,24 @@ import Link from "next/link"; import { apiFetch, ApiError, API_BASE, resolveToApiOrigin } from "@/lib/api"; import { useSiteSettings } from "@/contexts/SiteSettingsContext"; import { useDismissingState } from "@/hooks/useDismissingState"; -import { Building2, Palette, Bell, Mail, Scale, MessageCircle, CreditCard, DatabaseBackup, Timer, KeyRound, type LucideIcon } from "lucide-react"; +import { Building2, Palette, Bell, Mail, Scale, MessageCircle, CreditCard, DatabaseBackup, Timer, KeyRound, MapPinned, type LucideIcon } from "lucide-react"; import { ColorPickerField } from "@/components/admin/ColorPickerField"; import { BrandingPreviewPanel } from "@/components/admin/BrandingPreviewPanel"; import { BackupsTab } from "@/components/admin/BackupsTab"; import { JobsTab } from "@/components/admin/JobsTab"; import { PaymentsTab } from "@/components/admin/PaymentsTab"; import { LicenceTab } from "@/components/admin/LicenceTab"; +import { CampusesTab } from "@/components/admin/CampusesTab"; import { extractDominantColors } from "@/lib/extractColors"; import { mapsSearchUrl } from "@/lib/maps"; import { errorMessage } from "@/lib/utils"; import { BackLink } from "@/components/shared/BackLink"; -type TabId = "organisation" | "branding" | "notifications" | "email" | "legal" | "whatsapp" | "payments" | "backups" | "jobs" | "licence"; +type TabId = "organisation" | "campuses" | "branding" | "notifications" | "email" | "legal" | "whatsapp" | "payments" | "backups" | "jobs" | "licence"; const TABS: { id: TabId; label: string; icon: LucideIcon }[] = [ { id: "organisation", label: "Organisation", icon: Building2 }, + { id: "campuses", label: "Campuses", icon: MapPinned }, { id: "branding", label: "Branding", icon: Palette }, { id: "notifications", label: "Notifications", icon: Bell }, { id: "email", label: "Email", icon: Mail }, @@ -716,6 +718,7 @@ function SiteSettingsPageInner() { {activeTab === "backups" && } {activeTab === "jobs" && } {activeTab === "licence" && } + {activeTab === "campuses" && } {activeTab === "branding" && ( diff --git a/apps/events/frontend/src/app/dashboard/supervisor/email-attendees/page.tsx b/apps/events/frontend/src/app/dashboard/supervisor/email-attendees/page.tsx index 7dcd7a5..1361ed6 100644 --- a/apps/events/frontend/src/app/dashboard/supervisor/email-attendees/page.tsx +++ b/apps/events/frontend/src/app/dashboard/supervisor/email-attendees/page.tsx @@ -11,6 +11,7 @@ import { errorMessage } from "@/lib/utils"; import type { Event, MessageSendResult, Registration, User } from "@/types"; import { BackLink } from "@/components/shared/BackLink"; import { MessageKindPicker, matchedText, type MessageKind } from "@/components/shared/MessageKindPicker"; +import { CampusAudiencePicker } from "@/components/shared/CampusAudiencePicker"; type Attendee = { id: string; name: string; email: string; pref: string }; type TemplateKey = 'custom'|'payment_reminder'|'event_reminder'|'tickets'; @@ -735,6 +736,7 @@ function EmailAttendeesPageInner() { channel="email" />
Select users from your database to include. Green = Email/both preference. You can also add external emails below.
+
diff --git a/apps/events/frontend/src/app/dashboard/supervisor/events/page.tsx b/apps/events/frontend/src/app/dashboard/supervisor/events/page.tsx index eac1647..8e7d0f9 100644 --- a/apps/events/frontend/src/app/dashboard/supervisor/events/page.tsx +++ b/apps/events/frontend/src/app/dashboard/supervisor/events/page.tsx @@ -8,6 +8,8 @@ import { apiFetch, API_BASE } from "@/lib/api"; import { ApiImage } from "@/components/shared/ApiImage"; import { useDismissingState } from "@/hooks/useDismissingState"; import { useSiteSettings } from "@/contexts/SiteSettingsContext"; +import { useCampuses } from "@/hooks/useCampuses"; +import { CampusBadge, CampusFilter, matchesCampus } from "@/components/shared/CampusFilter"; import { Calendar } from "lucide-react"; import { ChoicesEditor } from "@/components/shared/FormFieldExtras"; import { errorMessage } from "@/lib/utils"; @@ -830,6 +832,7 @@ interface EventDraft { redirectUrl: string; isActive: boolean; isHidden: boolean; requiresAuth: boolean; requiresRegistration: boolean; contactName: string; contactPhone: string; contactEmail: string; location: string; allowNamedAttendees: boolean; + campusId: string; // "" = all campuses requiresParentalConsent: boolean; consentText: string; consentCollectMedical: boolean; consentCollectEmergency: boolean; consentCollectPhoto: boolean; waitlistEnabled: boolean; waitlistOfferHours: string; waitlistPartialOffers: boolean; @@ -845,6 +848,7 @@ const blankDraft = (location = ""): EventDraft => ({ redirectUrl: "", isActive: true, isHidden: false, requiresAuth: true, requiresRegistration: true, contactName: "", contactPhone: "", contactEmail: "", location, allowNamedAttendees: false, + campusId: "", requiresParentalConsent: false, consentText: "", consentCollectMedical: true, consentCollectEmergency: true, consentCollectPhoto: true, waitlistEnabled: false, waitlistOfferHours: "24", waitlistPartialOffers: true, @@ -873,6 +877,7 @@ interface EventModalProps { function EventModal({ mode, event: ev, onClose, onSuccess }: EventModalProps) { const { token } = useAuth(); const { settings } = useSiteSettings(); + const campusInfo = useCampuses(); const [step, setStep] = useState(0); const [pricingSubstep, setPricingSubstep] = useState(0); const [saving, setSaving] = useState(false); @@ -897,6 +902,7 @@ function EventModal({ mode, event: ev, onClose, onSuccess }: EventModalProps) { allowSponsorships: !!ev.allowSponsorships, sponsorshipGoalSpots: ev.sponsorshipGoalSpots ? String(ev.sponsorshipGoalSpots) : "", showSponsorshipProgress: ev.showSponsorshipProgress !== false, contactName: ev.contactName || "", contactPhone: ev.contactPhone || "", contactEmail: ev.contactEmail || "", location: ev.location || "", + campusId: ev.campusId || "", scheduleType: ev.scheduleType === "sessions" ? "sessions" : "single", attendanceMode: ev.attendanceMode === "pick" ? "pick" : "whole", } : blankDraft(settings.org_address || "")); @@ -1284,6 +1290,8 @@ function EventModal({ mode, event: ev, onClose, onSuccess }: EventModalProps) { contactPhone: draft.contactPhone || undefined, contactEmail: draft.contactEmail || undefined, location: draft.location.trim(), + // Only sent while campuses are on; the server ignores it otherwise. + ...(campusInfo.enabled ? { campusId: draft.campusId || null } : {}), }; let notice: { eventId: string; moved: number; cancelled: number } | null = null; @@ -1473,6 +1481,29 @@ function EventModal({ mode, event: ev, onClose, onSuccess }: EventModalProps) { upd({ registrationDeadline: v })} hint={multi ? "Registration closes when the first session starts unless late joining is on (Attendance step)" : undefined} /> upd({ goLiveAt: v })} hint="Leave blank to show immediately" />
+ {campusInfo.enabled && ( +
+ + +

"All campuses" events show at every campus — for church-wide conferences and camps.

+
+ )}
upd({ location: e.target.value })} placeholder="e.g. 123 Church St, City" /> @@ -1844,6 +1875,7 @@ function EventCard({ ev, onEdit }: { ev: Event; onEdit: () => void }) { {isPast && !isInactive && Past} {ev.isHidden && Hidden} {isClosed && Closed} +
{scheduleSummary(ev) || <>{ev.startDate ? new Date(ev.startDate).toLocaleDateString() : ""}{ev.endDate ? ` – ${new Date(ev.endDate).toLocaleDateString()}` : ""}} @@ -1897,6 +1929,7 @@ export default function ManageEventsPage() { const [showInactive, setShowInactive] = useState(false); const [showClosed, setShowClosed] = useState(false); const [search, setSearch] = useState(""); + const [campus, setCampus] = useState(""); const isAdmin = user?.role === "admin"; const now = Date.now(); @@ -1905,8 +1938,9 @@ export default function ManageEventsPage() { if (!showClosed && ev.cashupStatus === "closed") return false; if (!includePast && ev.endDate && new Date(ev.endDate).getTime() < now) return false; if (search && !ev.title?.toLowerCase().includes(search.toLowerCase())) return false; + if (!matchesCampus(ev, campus)) return false; return true; - }), [events, includePast, showInactive, showClosed, search, now]); + }), [events, includePast, showInactive, showClosed, search, campus, now]); const openCreate = () => { setEditingEvent(null); setModalMode("create"); }; const openEdit = async (ev: Event) => { @@ -1940,6 +1974,7 @@ export default function ManageEventsPage() {
setSearch(e.target.value)} /> + diff --git a/apps/events/frontend/src/app/dashboard/supervisor/page.tsx b/apps/events/frontend/src/app/dashboard/supervisor/page.tsx index 41df325..1398bf9 100644 --- a/apps/events/frontend/src/app/dashboard/supervisor/page.tsx +++ b/apps/events/frontend/src/app/dashboard/supervisor/page.tsx @@ -15,6 +15,7 @@ import { QuickActionTile, QuickActionGrid } from "@/components/shared/QuickActio import { AreaTrendChart } from "@/components/charts/AreaTrendChart"; import { Table, TableHeader, TableBody, TableRow, TableHead, TableCell } from "@/components/ui/table"; import type { DashboardStats, PaymentStats, RecentScan, ScanStats } from "@/types"; +import { CampusFilter } from "@/components/shared/CampusFilter"; const formatRand = (n: number) => `R ${(n || 0).toFixed(2)}`; const formatRandAxis = (n: number) => `R${new Intl.NumberFormat(undefined, { notation: "compact", maximumFractionDigits: 1 }).format(n)}`; @@ -75,6 +76,7 @@ export default function SupervisorDashboardPage() { const [overview, setOverview] = useStableState(null); const [loadingStats, setLoadingStats] = useState(false); const hasLoadedOnce = useRef(false); + const [campus, setCampus] = useState(""); const loadStats = useCallback(async () => { if (!token) return; @@ -83,7 +85,8 @@ export default function SupervisorDashboardPage() { if (isFirstLoad) setLoadingStats(true); const [data, overviewData] = await Promise.all([ apiFetch("/api/stats/supervisor", { authToken: token }), - apiFetch("/api/stats/overview", { authToken: token }), + // The month-over-month tiles follow the campus filter; today's totals stay church-wide. + apiFetch(`/api/stats/overview${campus ? `?campus=${encodeURIComponent(campus)}` : ""}`, { authToken: token }), ]); setScanStats(data.scanStats); setPaymentStats(data.paymentStats); @@ -95,7 +98,7 @@ export default function SupervisorDashboardPage() { hasLoadedOnce.current = true; if (isFirstLoad) setLoadingStats(false); } - }, [token, setScanStats, setPaymentStats, setRecentScans, setOverview]); + }, [token, campus, setScanStats, setPaymentStats, setRecentScans, setOverview]); useEffect(() => { if (!token) return; @@ -114,6 +117,7 @@ export default function SupervisorDashboardPage() {

Welcome back{user ? `, ${user.name}` : ""} 👋

Here's what's happening with your events today.

+
{!canView && ( diff --git a/apps/events/frontend/src/app/dashboard/supervisor/whatsapp-attendees/page.tsx b/apps/events/frontend/src/app/dashboard/supervisor/whatsapp-attendees/page.tsx index 8c1e2ec..6fbb592 100644 --- a/apps/events/frontend/src/app/dashboard/supervisor/whatsapp-attendees/page.tsx +++ b/apps/events/frontend/src/app/dashboard/supervisor/whatsapp-attendees/page.tsx @@ -11,6 +11,7 @@ import { errorMessage } from "@/lib/utils"; import type { Event, MessageSendResult, Registration, User } from "@/types"; import { BackLink } from "@/components/shared/BackLink"; import { MessageKindPicker, matchedText, type MessageKind } from "@/components/shared/MessageKindPicker"; +import { CampusAudiencePicker } from "@/components/shared/CampusAudiencePicker"; // Attendee with preference info type Attendee = { id: string; name: string; phone: string; pref: string }; @@ -809,6 +810,7 @@ function WhatsAppAttendeesPageInner() {
Only users with phone numbers shown. Green = WhatsApp/both preference.
+
diff --git a/apps/events/frontend/src/app/dashboard/user/profile/page.tsx b/apps/events/frontend/src/app/dashboard/user/profile/page.tsx index 4ab51c9..396331a 100644 --- a/apps/events/frontend/src/app/dashboard/user/profile/page.tsx +++ b/apps/events/frontend/src/app/dashboard/user/profile/page.tsx @@ -11,6 +11,7 @@ import { TwoFactorChallenge, TwoFactorMethod } from "@/lib/auth"; import { User, Lock, ShieldAlert, ShieldCheck, ShieldOff, Trash2, Clock, LogIn, KeyRound, RotateCcw } from "lucide-react"; import { errorMessage } from "@/lib/utils"; import { BackLink } from "@/components/shared/BackLink"; +import { useCampuses } from "@/hooks/useCampuses"; type ActivityEvent = { id: string; type: "login" | "password_changed" | "password_reset" | "two_factor_enabled" | "two_factor_disabled"; device: string | null; createdAt: string }; @@ -37,6 +38,8 @@ export default function UserProfilePage() { const [email, setEmail] = useState(""); const [phone, setPhone] = useState(""); const [notifPref, setNotifPref] = useState<"email" | "whatsapp" | "both">("email"); + const [homeCampusId, setHomeCampusId] = useState(""); + const campusInfo = useCampuses(); const [profileMsg, setProfileMsg] = useDismissingState<{ type: "ok" | "err"; text: string } | null>(null); const [savingProfile, setSavingProfile] = useState(false); @@ -48,6 +51,7 @@ export default function UserProfilePage() { setEmail(user.email || ""); setPhone(user.phoneNumber || ""); setNotifPref(user.notificationPreference || "email"); + setHomeCampusId(user.homeCampusId || ""); } }, [user]); @@ -65,6 +69,7 @@ export default function UserProfilePage() { email, phoneNumber: phone || null, notificationPreference: hasValidPhone ? notifPref : "email", + ...(campusInfo.enabled ? { homeCampusId: homeCampusId || null } : {}), }, }); // Backend returns a refreshed token — save it so the session stays valid @@ -335,6 +340,17 @@ export default function UserProfilePage() { setPhone(e.target.value)} placeholder="e.g. 082 123 4567" />
+ {campusInfo.enabled && campusInfo.campuses.length > 0 && ( +
+ + +

The events page starts on this campus, and you'll get messages meant for people at this campus.

+
+ )} + {hasValidPhone && (
diff --git a/apps/events/frontend/src/app/events/[id]/page.tsx b/apps/events/frontend/src/app/events/[id]/page.tsx index 08a4335..28ae225 100644 --- a/apps/events/frontend/src/app/events/[id]/page.tsx +++ b/apps/events/frontend/src/app/events/[id]/page.tsx @@ -9,6 +9,7 @@ import { JoinWaitlistButton } from "@/components/events/JoinWaitlistButton"; import { soldOutLines } from "@/lib/waitlist"; import { SponsorSpot } from "@/components/events/SponsorSpot"; import { FunnelTracker } from "@/components/events/FunnelTracker"; +import { CampusBadge } from "@/components/shared/CampusFilter"; import { Calendar, Ticket, Paperclip, Sparkles } from "lucide-react"; export const revalidate = 60; @@ -45,6 +46,7 @@ type Event = { contactPhone?: string | null; contactEmail?: string | null; location?: string | null; + campus?: { id: string; name: string; slug: string; colour: string | null } | null; waitlistEnabled?: boolean; allowSponsorships?: boolean; bundles?: PublicBundle[]; @@ -208,6 +210,7 @@ export default async function EventDetailPage({ params }: { params: Promise<{ id

{event.title}

+

{scheduleSummary(event) || formatDateTimeRange(event.startDate, event.endDate)} diff --git a/apps/events/frontend/src/app/events/page.tsx b/apps/events/frontend/src/app/events/page.tsx index c587498..256d3f1 100644 --- a/apps/events/frontend/src/app/events/page.tsx +++ b/apps/events/frontend/src/app/events/page.tsx @@ -1,9 +1,9 @@ import { Metadata } from "next"; import { Navbar } from "@/components/layout/Navbar"; import { Footer } from "@/components/layout/Footer"; -import { EventCard } from "@/components/events/EventCard"; +import { EventsGrid } from "@/components/events/EventsGrid"; import { apiFetchListForPrerender } from "@/lib/api"; -import { Calendar, CalendarX } from "lucide-react"; +import { Calendar } from "lucide-react"; export const revalidate = 60; @@ -27,6 +27,8 @@ type Event = { picture?: string; isSoldOut?: boolean; cashupStatus?: string; + campusId?: string | null; + campus?: { id: string; name: string; slug: string; colour: string | null } | null; }; export default async function EventsPage() { @@ -52,18 +54,7 @@ export default async function EventsPage() {

{sorted.length} upcoming event{sorted.length === 1 ? "" : "s"}

- {sorted.length === 0 ? ( -
- -

No events available right now — check back soon.

-
- ) : ( -
- {sorted.map((event) => ( - ) - )} -
- )} +
diff --git a/apps/events/frontend/src/app/sitemap.ts b/apps/events/frontend/src/app/sitemap.ts index 9838a96..6385ecd 100644 --- a/apps/events/frontend/src/app/sitemap.ts +++ b/apps/events/frontend/src/app/sitemap.ts @@ -23,6 +23,19 @@ export default async function sitemap(): Promise { // same degrade-gracefully posture as layout.tsx's getServerSettings. } + // Campus pages, while campuses are on (the list is empty otherwise). + let campuses: { slug: string }[] = []; + try { + campuses = (await apiFetch<{ campuses: { slug: string }[] }>("/api/campuses", { nextOptions: { next: { revalidate } } })).campuses || []; + } catch { + // Same as events above. + } + const campusEntries: MetadataRoute.Sitemap = campuses.map((c) => ({ + url: `${base}/campus/${c.slug}`, + changeFrequency: "weekly", + priority: 0.6, + })); + const eventEntries: MetadataRoute.Sitemap = (events || []).map((e) => ({ url: `${base}/events/${e.id}`, lastModified: e.updatedAt ? new Date(e.updatedAt) : undefined, @@ -30,5 +43,5 @@ export default async function sitemap(): Promise { priority: 0.7, })); - return [...staticEntries, ...eventEntries]; + return [...staticEntries, ...campusEntries, ...eventEntries]; } diff --git a/apps/events/frontend/src/components/admin/CampusesTab.tsx b/apps/events/frontend/src/components/admin/CampusesTab.tsx new file mode 100644 index 0000000..e4f2687 --- /dev/null +++ b/apps/events/frontend/src/components/admin/CampusesTab.tsx @@ -0,0 +1,256 @@ +"use client"; + +import React, { useCallback, useEffect, useState } from "react"; +import Link from "next/link"; +import { MapPin, Plus, ArrowUp, ArrowDown, Archive, ArchiveRestore, Trash2, Pencil } from "lucide-react"; +import { apiFetch } from "@/lib/api"; +import { useAuth } from "@/hooks/useAuth"; +import { useDismissingState } from "@/hooks/useDismissingState"; +import { reloadCampuses, type Campus } from "@/hooks/useCampuses"; +import { errorMessage } from "@/lib/utils"; + +type Person = { id: string; name: string; email: string }; +type AdminCampus = Campus & { + archivedAt: string | null; + notifyRecipients: Person[]; + _count: { events: number; homeOf: number }; +}; +type Draft = { + name: string; slug: string; address: string; defaultLocation: string; + contactName: string; contactEmail: string; contactPhone: string; colour: string; logoUrl: string; + notifyRecipients: Person[]; +}; + +const EMPTY: Draft = { name: "", slug: "", address: "", defaultLocation: "", contactName: "", contactEmail: "", contactPhone: "", colour: "", logoUrl: "", notifyRecipients: [] }; +const inputCls = "w-full border rounded-lg px-3 py-2 text-sm focus:outline-none focus:ring-2 focus:ring-brand-500"; + +const toDraft = (c: AdminCampus): Draft => ({ + name: c.name, slug: c.slug, address: c.address || "", defaultLocation: c.defaultLocation || "", + contactName: c.contactName || "", contactEmail: c.contactEmail || "", contactPhone: c.contactPhone || "", + colour: c.colour || "", logoUrl: c.logoUrl || "", notifyRecipients: c.notifyRecipients || [], +}); + +/** Staff who get the daily summary for this campus's events. */ +function RecipientsField({ value, onChange }: { value: Person[]; onChange: (v: Person[]) => void }) { + const { token } = useAuth(); + const [search, setSearch] = useState(""); + const [results, setResults] = useState([]); + useEffect(() => { + if (!search.trim()) { setResults([]); return; } + let cancelled = false; + const t = setTimeout(async () => { + try { + const res = await apiFetch<{ data?: (Person & { role?: string })[] }>(`/api/users?search=${encodeURIComponent(search.trim())}&limit=10`, { authToken: token }); + if (!cancelled) setResults((res?.data || []).filter(u => u.role !== "user")); + } catch { if (!cancelled) setResults([]); } + }, 300); + return () => { cancelled = true; clearTimeout(t); }; + }, [search, token]); + const shown = results.filter(r => !value.some(v => v.id === r.id)); + return ( +
+ {value.length > 0 && ( +
    + {value.map(p => ( +
  • + {p.name} + +
  • + ))} +
+ )} + setSearch(e.target.value)} /> + {shown.length > 0 && ( +
    + {shown.map(u => ( +
  • + +
  • + ))} +
+ )} +
+ ); +} + +function CampusForm({ initial, saving, onSave, onCancel }: { initial: Draft; saving: boolean; onSave: (d: Draft) => void; onCancel: () => void }) { + const [d, setD] = useState(initial); + const set = (k: keyof Draft) => (e: React.ChangeEvent) => setD(prev => ({ ...prev, [k]: e.target.value })); + return ( +
{ e.preventDefault(); onSave(d); }} className="border rounded-xl p-4 space-y-3 bg-gray-50"> +
+ + + + + + + + + +
+
+

Daily summary for this campus

+

These staff also get the daily summary of this campus's events, on top of each event's own recipients.

+ setD(prev => ({ ...prev, notifyRecipients: v }))} /> +
+
+ + +
+
+ ); +} + +/** Site settings → Campuses: turn campuses on, and add, order, archive and delete them. */ +export function CampusesTab({ active }: { active: boolean }) { + const { token } = useAuth(); + const [enabled, setEnabled] = useState(false); + const [campuses, setCampuses] = useState(null); + const [editing, setEditing] = useState(null); + const [busy, setBusy] = useState(false); + const [msg, setMsg] = useDismissingState<{ type: "ok" | "err"; text: string } | null>(null); + + const load = useCallback(async () => { + if (!token) return; + try { + const res = await apiFetch<{ enabled: boolean; campuses: AdminCampus[] }>("/api/campuses/admin", { authToken: token }); + setEnabled(res.enabled); + setCampuses(res.campuses); + } catch (e) { setMsg({ type: "err", text: errorMessage(e) || "Could not load campuses." }); } + }, [token, setMsg]); + useEffect(() => { if (active) load(); }, [active, load]); + + const run = async (fn: () => Promise, ok?: string) => { + setBusy(true); + try { + await fn(); + reloadCampuses(); + await load(); + if (ok) setMsg({ type: "ok", text: ok }); + return true; + } catch (e) { + setMsg({ type: "err", text: errorMessage(e) || "Something went wrong." }); + return false; + } finally { setBusy(false); } + }; + + const toggle = (on: boolean) => run(() => apiFetch("/api/campuses/settings", { method: "PUT", authToken: token, body: { enabled: on } }), on ? "Campuses are on." : "Campuses are off — campus fields are hidden, nothing is deleted."); + const save = async (d: Draft, id?: string) => { + const body = { ...d, notifyRecipients: undefined, notifyRecipientIds: d.notifyRecipients.map(p => p.id) }; + const ok = await run(() => id + ? apiFetch(`/api/campuses/${id}`, { method: "PUT", authToken: token, body }) + : apiFetch("/api/campuses", { method: "POST", authToken: token, body }).then((c) => { + const created = c as AdminCampus; + // Recipients are set with an update, so a new campus gets them too. + return d.notifyRecipients.length ? apiFetch(`/api/campuses/${created.id}`, { method: "PUT", authToken: token, body: { notifyRecipientIds: body.notifyRecipientIds } }) : created; + }), id ? "Campus saved." : "Campus added."); + if (ok) setEditing(null); + }; + const move = (list: AdminCampus[], i: number, dir: -1 | 1) => { + const ids = list.map(c => c.id); + [ids[i], ids[i + dir]] = [ids[i + dir], ids[i]]; + return run(() => apiFetch("/api/campuses/order", { method: "PUT", authToken: token, body: { ids } })); + }; + const setArchived = (c: AdminCampus, archived: boolean) => run(() => apiFetch(`/api/campuses/${c.id}`, { method: "PUT", authToken: token, body: { archived } }), archived ? `${c.name} archived.` : `${c.name} restored.`); + const remove = (c: AdminCampus) => { + if (!window.confirm(`Delete ${c.name}? This can't be undone.`)) return; + run(() => apiFetch(`/api/campuses/${c.id}`, { method: "DELETE", authToken: token }), `${c.name} deleted.`); + }; + + if (!campuses) return msg ?

{msg.text}

:

Loading…

; + const activeList = campuses.filter(c => !c.archivedAt); + const archivedList = campuses.filter(c => c.archivedAt); + + return ( +
+
+

Campuses

+

For a church with more than one campus: each event belongs to a campus or to all campuses, the events page gets a campus filter, and people can choose their home campus. Churches with one campus can leave this off — nobody sees campus fields then.

+
+ + + + {enabled && ( + <> +
+ {activeList.length === 0 && editing !== "new" &&

No campuses yet. Add your first one below.

} + {activeList.map((c, i) => editing === c.id ? ( + save(d, c.id)} onCancel={() => setEditing(null)} /> + ) : ( +
+ +
+

{c.name}

+

+ /campus/{c.slug} + {" · "}{c._count.events} event{c._count.events === 1 ? "" : "s"}{" · "}{c._count.homeOf} {c._count.homeOf === 1 ? "person" : "people"} call it home + {c.address && <> · {c.address}} +

+
+
+ + + + + {c._count.events === 0 && ( + + )} +
+
+ ))} +
+ + {editing === "new" ? ( + save(d)} onCancel={() => setEditing(null)} /> + ) : ( + + )} + + {archivedList.length > 0 && ( +
+

Archived

+

Archived campuses aren't offered for new events or as a home campus. Events that already have one keep it.

+
+ {archivedList.map(c => ( +
+

{c.name} · {c._count.events} event{c._count.events === 1 ? "" : "s"}

+ + {c._count.events === 0 && ( + + )} +
+ ))} +
+
+ )} + + )} + + {msg &&
{msg.text}
} +
+ ); +} diff --git a/apps/events/frontend/src/components/events/EventCard.tsx b/apps/events/frontend/src/components/events/EventCard.tsx index fd20452..4f9784f 100644 --- a/apps/events/frontend/src/components/events/EventCard.tsx +++ b/apps/events/frontend/src/components/events/EventCard.tsx @@ -1,6 +1,7 @@ import { ApiImage } from "@/components/shared/ApiImage"; import { Calendar, MapPin } from "lucide-react"; import { ContactButton } from "@/components/events/ContactButton"; +import { CampusBadge } from "@/components/shared/CampusFilter"; type Event = { id: string; @@ -24,6 +25,7 @@ import { ContactButton } from "@/components/events/ContactButton"; scheduleType?: "single" | "sessions"; sessions?: EventSession[]; registrationClosesAt?: string; + campus?: { id: string; name: string; slug: string; colour: string | null } | null; }; import { formatDateTimeRange } from "@/lib/date"; @@ -66,6 +68,7 @@ export const EventCard = ({ event }: { event: Event }) => { )}

{event.title}

+

{dateRange} diff --git a/apps/events/frontend/src/components/events/EventsGrid.tsx b/apps/events/frontend/src/components/events/EventsGrid.tsx new file mode 100644 index 0000000..1180135 --- /dev/null +++ b/apps/events/frontend/src/components/events/EventsGrid.tsx @@ -0,0 +1,59 @@ +"use client"; + +import React, { useEffect, useState } from "react"; +import { CalendarX } from "lucide-react"; +import { EventCard } from "@/components/events/EventCard"; +import { CampusFilter } from "@/components/shared/CampusFilter"; +import { useCampuses } from "@/hooks/useCampuses"; +import { useAuth } from "@/hooks/useAuth"; + +type GridEvent = React.ComponentProps["event"] & { campusId?: string | null }; + +// The visitor's campus choice, kept in this browser (like the cookie choice). +const STORAGE_KEY = "hope_events_campus"; + +function readStored(): string | null { + try { return localStorage.getItem(STORAGE_KEY); } catch { return null; } +} +function store(value: string) { + try { localStorage.setItem(STORAGE_KEY, value); } catch { /* private window etc. */ } +} + +/** + * The public events grid with a campus filter (while campuses are on). A campus shows its own + * events plus church-wide ones. Starts on the visitor's last choice, else their home campus. + */ +export function EventsGrid({ events }: { events: GridEvent[] }) { + const { enabled, campuses } = useCampuses(); + const { user } = useAuth(); + const [campus, setCampus] = useState(""); + + useEffect(() => { + if (!enabled) return; + const stored = readStored(); + const start = stored ?? user?.homeCampusId ?? ""; + // Only a campus that still exists (an archived one falls back to every campus). + setCampus(start && campuses.some(c => c.id === start) ? start : ""); + }, [enabled, campuses, user?.homeCampusId]); + + const choose = (value: string) => { setCampus(value); store(value); }; + const shown = enabled && campus ? events.filter(e => !e.campusId || e.campusId === campus) : events; + + return ( + <> +

+ +
+ {shown.length === 0 ? ( +
+ +

{events.length ? "No events at this campus right now — try another campus." : "No events available right now — check back soon."}

+
+ ) : ( +
+ {shown.map(event => )} +
+ )} + + ); +} diff --git a/apps/events/frontend/src/components/reports/ReportsV2.tsx b/apps/events/frontend/src/components/reports/ReportsV2.tsx index b987902..8cac495 100644 --- a/apps/events/frontend/src/components/reports/ReportsV2.tsx +++ b/apps/events/frontend/src/components/reports/ReportsV2.tsx @@ -14,6 +14,7 @@ import { HorizontalBarChart } from "./charts/HorizontalBarChart"; import { AreaTrendChart } from "@/components/charts/AreaTrendChart"; import { errorMessage } from "@/lib/utils"; import { registrationOptionUnitPrice } from "@/lib/pricing"; +import { CampusFilter, matchesCampus } from "@/components/shared/CampusFilter"; import type { ConsentRow, Event, EventCashup, EventFinancials, MedicalRow, Payment, Registration, Ticket, UserSummary } from "@/types"; const METHOD_KEYS = ["cash", "card", "eft", "other"] as const; @@ -164,6 +165,8 @@ export default function ReportsV2({ backHref }: { backHref?: string } = {}) { // hiding them by default would work against those reports' whole purpose. This toggle // lets staff exclude them when they only want currently-open events. const [showClosedEvents, setShowClosedEvents] = useState(true); + // Multi-campus: one campus's events, church-wide ones, or all (the church-wide total). + const [campus, setCampus] = useState(""); const isAdmin = role === "admin"; const filteredEvents = useMemo(() => { @@ -172,9 +175,10 @@ export default function ReportsV2({ backHref }: { backHref?: string } = {}) { if (!showPastEvents && ev.endDate && new Date(ev.endDate) < now) return false; if (!showInactiveEvents && ev.isActive === false) return false; if (!showClosedEvents && ev.cashupStatus === "closed") return false; + if (!matchesCampus(ev, campus)) return false; return true; }); - }, [events, showPastEvents, showInactiveEvents, showClosedEvents]); + }, [events, showPastEvents, showInactiveEvents, showClosedEvents, campus]); useEffect(() => { (async () => { @@ -1457,6 +1461,15 @@ export default function ReportsV2({ backHref }: { backHref?: string } = {}) { )} {error &&
{error}
} + { setCampus(v); setSelectedEventIds([]); }} + withChurchWide + everyLabel="All campuses (church-wide total)" + className="mb-3" + id="reports-campus" + /> + void }) { + const { token } = useAuth(); + const { enabled, campuses } = useCampuses(); + const [campusId, setCampusId] = useState(""); + const [registrants, setRegistrants] = useState(true); + const [busy, setBusy] = useState(false); + const [note, setNote] = useState<{ ok: boolean; text: string } | null>(null); + if (!enabled || campuses.length === 0) return null; + + const add = async () => { + if (!campusId) return; + setBusy(true); + setNote(null); + try { + const res = await apiFetch<{ campus: { name: string }; users: { id: string }[] }>(`/api/campuses/${campusId}/audience${registrants ? "?registrants=true" : ""}`, { authToken: token }); + const ids = res.users.map(u => u.id); + const merged = Array.from(new Set([...selectedIds, ...ids])); + onChange(merged); + const added = merged.length - selectedIds.length; + const people = (n: number) => `${n} ${n === 1 ? "person" : "people"}`; + setNote({ + ok: true, + text: ids.length === 0 ? `Nobody at ${res.campus.name} yet.` + : added === ids.length ? `Added ${people(added)} at ${res.campus.name}.` + : `Added ${people(added)} at ${res.campus.name} — ${ids.length - added} already selected.`, + }); + } catch (e) { + setNote({ ok: false, text: errorMessage(e) || "Could not load the campus's people." }); + } finally { + setBusy(false); + } + }; + + return ( +
+

Everyone at a campus

+
+ + +
+ + {note &&

{note.text}

} +
+ ); +} diff --git a/apps/events/frontend/src/components/shared/CampusFilter.tsx b/apps/events/frontend/src/components/shared/CampusFilter.tsx new file mode 100644 index 0000000..956643f --- /dev/null +++ b/apps/events/frontend/src/components/shared/CampusFilter.tsx @@ -0,0 +1,58 @@ +"use client"; + +import React from "react"; +import Link from "next/link"; +import { MapPin } from "lucide-react"; +import { useCampuses, type EventCampus } from "@/hooks/useCampuses"; + +/** + * A campus dropdown for lists and reports. Renders nothing while campuses are off. + * Values: "" = every campus (church-wide total), "all" = only events for all campuses + * (when `withChurchWide`), otherwise a campus id. + */ +export function CampusFilter({ value, onChange, withChurchWide = false, everyLabel = "All campuses", className = "", id = "campus-filter" }: { + value: string; + onChange: (value: string) => void; + withChurchWide?: boolean; + everyLabel?: string; + className?: string; + id?: string; +}) { + const { enabled, campuses } = useCampuses(); + if (!enabled || campuses.length === 0) return null; + return ( + + ); +} + +/** Does an event pass a CampusFilter value? */ +export function matchesCampus(ev: { campusId?: string | null }, value: string): boolean { + if (!value) return true; + if (value === "all") return !ev.campusId; + return ev.campusId === value; +} + +/** + * The campus an event belongs to, as a small label (`link`: to the campus page). Nothing for + * church-wide events or while campuses are off. + */ +export function CampusBadge({ campus, className = "", link = false }: { campus?: EventCampus | null; className?: string; link?: boolean }) { + const { enabled } = useCampuses(); + if (!enabled || !campus) return null; + const cls = `inline-flex items-center gap-1 text-[11px] px-1.5 py-0.5 rounded bg-gray-100 text-gray-700 ${link ? "hover:bg-gray-200" : ""} ${className}`; + const inner = ( + <> + + {campus.name} + + ); + return link ? {inner} : {inner}; +} diff --git a/apps/events/frontend/src/content/help/site-settings.tsx b/apps/events/frontend/src/content/help/site-settings.tsx index 31bc58d..6a82a86 100644 --- a/apps/events/frontend/src/content/help/site-settings.tsx +++ b/apps/events/frontend/src/content/help/site-settings.tsx @@ -1,5 +1,5 @@ import React from "react"; -import { Building2, Palette, Bell, Mail, Scale, MessageCircle, LayoutDashboard, Timer, Play, CreditCard, ArrowUpDown, KeyRound, ArrowUpCircle } from "lucide-react"; +import { Building2, Palette, Bell, Mail, Scale, MessageCircle, LayoutDashboard, Timer, Play, CreditCard, ArrowUpDown, KeyRound, ArrowUpCircle, MapPinned, Archive, Users } from "lucide-react"; import { GuideItem } from "@/components/shared/GuideItem"; import type { HelpContent } from "./types"; @@ -32,6 +32,30 @@ export const siteSettingsHelpContent: HelpContent = {
), }, + { + key: "campuses", + label: "Campuses", + icon: MapPinned, + content: ( +
+

For a church with more than one campus. Off by default — a church with one campus never sees campus fields anywhere.

+
+ + Tick Use campuses, then add each campus: its name, web address (its page is /campus/…), address, contact, colour and the default location for its events. The order you set is the order of every campus list. + + + Each event belongs to one campus, or to All campuses for church-wide conferences and camps. The events page gets a campus filter (remembered per visitor, starting on their home campus); a campus shows its own events plus the church-wide ones. + + + People can choose a home campus on their profile. In Email and WhatsApp broadcasts, Everyone at a campus adds the people whose home campus it is — and, ticked, people who registered for its events in the last 12 months. News still only goes to people who opted in. + + + A campus with events can't be deleted — archive it instead: it disappears from filters and new events, and its events keep it. Turning campuses off hides everything campus-related; nothing is deleted, and it all comes back when you turn them on again. + +
+
+ ), + }, { key: "branding", label: "Branding", diff --git a/apps/events/frontend/src/content/help/supervisor-events.tsx b/apps/events/frontend/src/content/help/supervisor-events.tsx index c67ec01..7a5cbcc 100644 --- a/apps/events/frontend/src/content/help/supervisor-events.tsx +++ b/apps/events/frontend/src/content/help/supervisor-events.tsx @@ -32,7 +32,7 @@ export const supervisorEventsHelpContent: HelpContent = {

Creating or editing an event walks through several steps:

- Title, description, start/end times, registration deadline, go-live time, base price, picture, and a custom URL alias. + Title, description, start/end times, registration deadline, go-live time, base price, picture, and a custom URL alias. With campuses on (Site settings → Campuses), also the campus — one campus, or All campuses for a church-wide event. Choosing a campus fills in its default location. Choose "Multiple sessions" for one event on several dates — e.g. every Wednesday 18:30–20:30 for 5 weeks. Use the repeat pattern to create the dates, then edit any of them, add a label ("Week 1 — …"), a different location, or an extra date. People register and pay once and get one ticket for every session. Cancel a session (e.g. a public holiday) rather than deleting it once people have been checked in. Registration closes when the first session starts unless you turn on late joining. diff --git a/apps/events/frontend/src/hooks/useCampuses.ts b/apps/events/frontend/src/hooks/useCampuses.ts new file mode 100644 index 0000000..a590d5c --- /dev/null +++ b/apps/events/frontend/src/hooks/useCampuses.ts @@ -0,0 +1,55 @@ +"use client"; + +import { useEffect, useState } from "react"; +import { apiFetch } from "@/lib/api"; + +export type Campus = { + id: string; + name: string; + slug: string; + address: string | null; + colour: string | null; + logoUrl: string | null; + defaultLocation: string | null; + contactName: string | null; + contactEmail: string | null; + contactPhone: string | null; + order: number; +}; + +/** What an event carries about its campus. */ +export type EventCampus = { id: string; name: string; slug: string; colour: string | null }; + +type CampusState = { enabled: boolean; campuses: Campus[] }; + +// One request per page load, shared by every component that asks. +let cache: Promise | null = null; + +function load(): Promise { + if (!cache) { + cache = apiFetch("/api/campuses").catch(() => { + cache = null; // try again next time + return { enabled: false, campuses: [] }; + }); + } + return cache; +} + +/** Forget the cached list (after Site settings → Campuses changes it). */ +export function reloadCampuses() { + cache = null; +} + +/** + * Whether campuses are on (Site settings → Campuses) and the active campuses. While off, + * `enabled` is false and `campuses` is empty, so callers hide every campus field. + */ +export function useCampuses() { + const [state, setState] = useState({ enabled: false, campuses: [], loading: true }); + useEffect(() => { + let alive = true; + load().then(s => { if (alive) setState({ ...s, loading: false }); }); + return () => { alive = false; }; + }, []); + return state; +} diff --git a/apps/events/frontend/src/lib/auth.ts b/apps/events/frontend/src/lib/auth.ts index f8b894e..3a44320 100644 --- a/apps/events/frontend/src/lib/auth.ts +++ b/apps/events/frontend/src/lib/auth.ts @@ -13,6 +13,8 @@ export type AuthUser = { newsPromptPending?: boolean; // POPIA: a privacy notice version they must accept has been published since they last did. noticePromptPending?: boolean; + // Multi-campus: their home campus (the events page starts on it). + homeCampusId?: string | null; }; export type AuthResponse = AuthUser & { diff --git a/apps/events/frontend/src/types/index.ts b/apps/events/frontend/src/types/index.ts index 4d7b1b9..44e2f1d 100644 --- a/apps/events/frontend/src/types/index.ts +++ b/apps/events/frontend/src/types/index.ts @@ -31,6 +31,8 @@ export type User = { isActive?: boolean; notificationPreference?: NotificationPreference; twoFactorEnabled?: boolean; + // Multi-campus: their home campus (only used while campuses are on). + homeCampusId?: string | null; createdAt?: string; updatedAt?: string; }; @@ -113,6 +115,9 @@ export type Event = { price: number; picture?: string | null; location?: string | null; + // Multi-campus: null = all campuses. `campus` is included by the event endpoints. + campusId?: string | null; + campus?: { id: string; name: string; slug: string; colour: string | null } | null; isActive?: boolean; isHidden?: boolean; isLive?: boolean; diff --git a/apps/events/package-lock.json b/apps/events/package-lock.json index 8267926..58834ae 100644 --- a/apps/events/package-lock.json +++ b/apps/events/package-lock.json @@ -1,12 +1,12 @@ { "name": "hope-events", - "version": "1.42.1", + "version": "1.43.0", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "hope-events", - "version": "1.42.1", + "version": "1.43.0", "license": "ISC", "devDependencies": { "@playwright/test": "^1.64.0", diff --git a/apps/events/package.json b/apps/events/package.json index 6388a4c..4a17afb 100644 --- a/apps/events/package.json +++ b/apps/events/package.json @@ -1,6 +1,6 @@ { "name": "hope-events", - "version": "1.42.1", + "version": "1.43.0", "main": "index.js", "scripts": { "dev:backend": "cd backend && npm run dev",