Add posterImageUrl to events

Concert posters already live on the public website, so events store a URL
to an existing image rather than hosting an uploaded file.

.env.example

@@ -1,11 +1,3 @@
-# Values containing #, ", \ or surrounding spaces must be single-quoted
-# (dotenv 16 treats an unquoted # as a comment): DB_PASSWORD='abc#def'
-# REQUIRED. The admin module treats anything other than "development" or "test"
-# as production: strict secrets, cross-subdomain cookies, no relaxed CORS.
-# Leaving it unset is therefore safe-by-default but will refuse to boot without
-# the admin secrets below. Set it to development for local work.
-NODE_ENV=development
-
 PORT=3000
 
 DB_HOST=
@@ -27,45 +19,6 @@ SALESFORCE_API_URL=
 SALESFORCE_CLIENT_ID=
 SALESFORCE_CLIENT_SECRET=
 
-TICKETS_DB=
-TICKETS_RATE_LIMIT_MAX=10
-TICKETS_RATE_LIMIT_WINDOW_MIN=10
-
-ADMIN_DB=
-# 32+ random bytes, e.g. `openssl rand -base64 48`. Mandatory outside
-# development/test - there is deliberately no fallback, since a hardcoded one
-# would be a published signing key. Rotating it signs everyone out and
-# invalidates outstanding password-reset links.
-BETTER_AUTH_SECRET=
-API_BASE_URL=http://localhost:3000
-ADMIN_APP_URL=http://localhost:3002
-# Comma-separated origins of the apps that may call /admin/* with credentials.
-APP_ORIGINS=http://localhost:3001
-# nachklang.art in production; passkeys are bound to this value.
-PASSKEY_RP_ID=localhost
-# On start-up, makes sure this address can get in (invite, or grant admin if the
-# user already exists). Idempotent, safe to leave set.
-ADMIN_BOOTSTRAP_EMAIL=
-
-# The header the reverse proxy puts the real client IP in, and the proxy hops to
-# trust. Get these right or better-auth cannot resolve a client IP and every
-# request shares ONE rate-limit bucket (/sign-in/* allows 3 per 10 seconds, so
-# one noisy client locks everyone out). Check with:
-#   SELECT `key` FROM rateLimit;  -- a "no-trusted-ip" row means it is happening.
-# The header the reverse proxy puts the real client IP in. Must be one the proxy
-# actually overwrites - trusting a header it does not set lets any client send its
-# own value and bypass the sign-in rate limit entirely.
-# Set to "none" to trust no header at all: every request then shares one rate-limit
-# bucket, which is the safe fallback if the check below fails. Verify after deploy
-# with: SELECT ipAddress FROM session ORDER BY createdAt DESC LIMIT 3;
-CLIENT_IP_HEADERS=x-real-ip
-TRUSTED_PROXY_IPS=
-
-# Writes invitation links to the log. That link is a live account-creation
-# credential, so this is refused outside development. Needed locally, where the
-# mail relay is off and only the token's hash is stored.
-ADMIN_LOG_INVITE_LINKS=true
-
 MEMBER_CREDENTIAL=123
 CHOIR_CREDENTIAL=123
 MANAGEMENT_CREDENTIAL=123

.nvmrc

@@ -1 +0,0 @@
-26

CLAUDE.md

@@ -8,24 +8,20 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 npm run build    # Compile TypeScript → dist/
 npm run start    # Build and start (tsc && node ./dist/app.js)
 npm run debug    # Start with DEBUG=* environment variable
-npm run test     # Run the vitest suite once with coverage (lcov + testResults/sonar-report.xml)
+npm run test     # Run Jest tests with coverage (outputs sonar-report.xml)
-npm run test:watch  # vitest in watch mode
-npm run test:integration  # Admin-module tests against a throwaway MariaDB (needs docker or podman)
 ```
 
 Run a single test file:
 ```bash
-npx vitest run test/some.test.ts
+npx jest test/some.test.ts
 ```
 
 ## Architecture
 
-Express.js REST API in TypeScript with a service-oriented layering. Domains: `Calendar` (events, users), `Feedback` (concert feedback forms, mounted at `/feedback`, backed by its own `FEEDBACK_DB` — see `src/models/feedback/`: public submission flow, admin CRUD, reporting, and a Salesforce newsletter-sync integration), `Tickets` (mounted at `/tickets`), and `Admin` (identity and permissions, mounted at `/admin`, backed by `ADMIN_DB` — see below).
+Express.js REST API in TypeScript with a service-oriented layering. Domains: `Calendar` (events, users) and `Feedback` (concert feedback forms, mounted at `/feedback`, backed by its own `FEEDBACK_DB` — see `src/models/feedback/`: public submission flow, admin CRUD, reporting, and a Salesforce newsletter-sync integration).
-
-`src/app.factory.ts` builds the Express app; `app.ts` only starts it. The split exists so the integration tests drive the real wiring.
 
 **Request path:**
-1. `src/app.factory.ts` mounts `Calendar.router.ts` at `/calendar`
+1. `app.ts` mounts `Calendar.router.ts` at `/calendar`
 2. `Calendar.router.ts` delegates to `events.router.ts` and `users.router.ts`
 3. Routers call services; services call the MariaDB pool in `Calendar.db.ts`
 
@@ -38,43 +34,7 @@ Express.js REST API in TypeScript with a service-oriented layering. Domains: `Ca
 | DB pool | `src/models/calendar/Calendar.db.ts` (MariaDB, pool size 5) |
 | Shared | `src/common/` (base route class, nodemailer wrapper), `src/middleware/logger.ts` (Winston) |
 
-**Auth model:** Two of them, on purpose.
+**Auth model:** Users must have a `@nachklang.art` email. After activation they receive a session token (30-day window); the token hash + IP are stored in the DB. Credentials for non-user calendar access (`MEMBER_CREDENTIAL`, `CHOIR_CREDENTIAL`, `MANAGEMENT_CREDENTIAL`) come from `.env`.
-
-*Admin module (`src/models/admin/`)* — the current one, used by feedback, tickets and the
-admin app. better-auth 1.7 on its own `nachklang_admin` database (Kysely + mysql2; every
-other domain keeps the `mariadb` driver), mounted at `/admin/auth/*` for the auth handler
-and `/admin` for the JSON routes. Sessions are httpOnly cookies scoped to
-`.nachklang.art`, so one sign-in covers every app. Accounts are **invite-only** — public
-sign-up is disabled, and `invitations.plugin.ts` is the only code that creates users.
-A permission is **(app, role)** in `user_app_permissions`, keyed on
-`(user_id, app, role)` so one user can hold several roles per app. `access` is the only role
-today and means "may use this app at all"; `APP_ROLES` in `admin.schema.ts` is the contract,
-and a role not listed there is rejected rather than written. `requireAppAccess(app)` in
-`admin.middleware.ts` is the single authenticator - it takes an optional second argument to
-narrow to one role, and queries the database on every request (no cookie cache) so disabling
-a user takes effect at once. Two things to know before touching this: any count of admins
-must count **distinct users**, not permission rows, or a single admin with two roles reads as
-two and the last-admin guard stops guarding; and both write endpoints accept
-`{permissions: [{app, role}]}` as well as the older `{apps: ['tickets']}`, which means the
-same at the `access` role. `ADMIN_BOOTSTRAP_EMAIL`
-makes sure someone can always get in on a fresh database.
-
-*Legacy calendar* — unchanged: users need a `@nachklang.art` email, and after activation
-get a session token (30-day window, hash + IP stored in the DB), passed as query
-parameters. Migration is planned but not started: `docs/calendar-auth-migration.md`.
-Credentials for non-user calendar access (`MEMBER_CREDENTIAL`, `CHOIR_CREDENTIAL`,
-`MANAGEMENT_CREDENTIAL`) come from `.env`.
-
-**Admin database driver:** the admin pool is the **callback-style** `mysql2`, never
-`mysql2/promise`. Kysely's `MysqlDialect` calls `pool.getConnection((err, conn) => ...)`;
-the promise wrapper ignores that callback, so every Kysely query hangs forever with no
-error. Only the integration tests catch this.
-
-**Admin schema changes:** `sql/admin/NNN_*.sql`, hand-maintained and mirrored in
-`docker/init/`. The better-auth tables must match what the configured version derives from
-`admin.auth.ts` — on every better-auth upgrade, re-derive them (`getAuthTables` from
-`better-auth/db`, called with `auth.options`), diff, and add a numbered migration. Do not
-use the published `@better-auth/cli`; it lags the library.
 
 **Event versioning:** Events have a companion `event_versions` table. `events.service.ts` manages writes to both.
 
@@ -86,36 +46,13 @@ use the published `@better-auth/cli`; it lags the library.
 
 ## Environment
 
-dotenv 16 parses `.env` stricter than the old dotenv 8: an unquoted `#` starts a comment and
-backslash escapes inside double quotes are expanded. Wrap any value containing `#`, `"`, `\` or
-surrounding spaces in single quotes (`DB_PASSWORD='abc#def'`), which are taken literally.
-A truncated password shows up as MariaDB "Access denied ... (using password: YES)".
-
-**`NODE_ENV` is load-bearing for the admin module.** Only the explicit values
-`development` and `test` relax anything; everything else, *including unset*, is treated as
-production (strict secrets, cross-subdomain cookies, no localhost CORS). That direction is
-deliberate: a Plesk vhost does not set `NODE_ENV`, and the inverse arrangement would
-silently degrade the signing key, the cookie domain and the CORS list at once. Local work
-needs `NODE_ENV=development`.
-
 Copy `.env.example` (or create `.env`) with:
 ```
-NODE_ENV=
 PORT=
 DB_HOST=
 DB_USER=
 DB_PASSWORD=
 CALENDAR_DB=
-ADMIN_DB=
-BETTER_AUTH_SECRET=
-API_BASE_URL=
-ADMIN_APP_URL=
-APP_ORIGINS=
-PASSKEY_RP_ID=
-ADMIN_BOOTSTRAP_EMAIL=
-CLIENT_IP_HEADERS=
-TRUSTED_PROXY_IPS=
-ADMIN_LOG_INVITE_LINKS=
 FEEDBACK_DB=
 FEEDBACK_IP_SALT=
 FEEDBACK_RATE_LIMIT_MAX=
@@ -132,10 +69,6 @@ CHOIR_CREDENTIAL=
 MANAGEMENT_CREDENTIAL=
 ```
 
-## TypeScript / module system
+## TypeScript config
 
-The API runs on Node 26 (`engines` in package.json, `.nvmrc`; Plesk runs 26 too) and is native ESM (`"type": "module"`, `module: nodenext`, target ES2024, strict mode, compiled output in `./dist`, inline source maps). Consequences:
+Strict mode enabled, target ES2016, compiled output in `./dist`, inline source maps. Tests run through `ts-jest` directly against `.ts` sources.
-
-- Relative imports carry the `.js` suffix (`import {x} from "./x.js"`) even though the source file is `.ts`.
-- CommonJS dependencies are consumed via default imports (`import mariadb from "mariadb"`, `import cors from "cors"`, `import winston from "winston"`), never `require()`.
-- Tests run with vitest directly against `.ts` sources; import `describe`/`it`/`expect`/`vi` from `vitest` explicitly (no globals). Module mocks use `vi.mock(...)` with the same `.js`-suffixed paths as the imports.

DEFERRED_SECURITY.md

@@ -11,19 +11,7 @@ These items were identified during a security review on 2026-05-02 and conscious
 
 `sessionId` and `sessionKey` are currently read from query parameters, which means they appear in server access logs, browser history, proxy logs, and `Referer` headers.
 
-**Fix (updated 2026-09-06):** Move the calendar onto the shared admin identity -
+**Fix:** Move to request headers (`X-Session-Id` / `X-Session-Key`) or the request body. Requires a corresponding frontend update.
-`requireAppAccess('calendar')` against the better-auth session cookie, per
-`docs/calendar-auth-migration.md`. That closes this item outright rather than moving the
-credential to a safer place, and it is now the cheaper of the two: the feedback and tickets
-modules made the same move on 2026-09-06 for one line each.
-
-~~Move to request headers (`X-Session-Id` / `X-Session-Key`) or the request body.~~ No longer
-the recommendation. Nothing on the server reads those two headers any more - the calendar's
-query parameters are the last legacy credential path in the API - so this would build a second
-mechanism just as the first is being retired. They survive only in the CORS `allowedHeaders`
-list, and only until both frontends are redeployed.
-
-Either fix requires a corresponding frontend update.
 
 > Note: the shared calendar `password` parameter in query params is intentional (iCal clients don't support headers) and is acceptable for the current setup.
 
@@ -44,13 +32,6 @@ Currently any active user can edit, move, or delete any event regardless of who
 
 ## 3. Activation token has no expiry
 
-> **Superseded for new accounts (2026-09-05).** The admin module
-> (`src/models/admin/`) replaced account creation for the feedback, tickets and admin
-> apps: accounts now come from `invitations`, whose tokens expire after 7 days and are
-> stored only as a SHA-256 hash. The item below still stands for the legacy calendar
-> `users` table, which the admin module deliberately left alone - see
-> `docs/calendar-auth-migration.md`.
-
 **File:** `src/models/calendar/users/users.service.ts` — `createUser` / `activateUser`
 
 The email activation link is valid indefinitely. Acceptable for a small, trusted userbase.
@@ -64,10 +45,6 @@ The email activation link is valid indefinitely. Acceptable for a small, trusted
 
 ## 4. Password reset token has no expiry
 
-> **Superseded for new accounts (2026-09-05).** Password resets for admin-module accounts
-> go through better-auth, whose reset tokens expire after one hour. As with item 3, the
-> text below still applies to the legacy calendar `users` table.
-
 **File:** `src/models/calendar/users/users.service.ts` — `initiatePasswordReset` / `finalizePasswordReset`
 
 The reset token stored in `pw_reset_token_hash` never expires. Acceptable for a small, trusted userbase.

app.ts

@@ -1,8 +1,16 @@
+import express from 'express';
 import * as http from 'http';
 import * as dotenv from 'dotenv';
-import logger from './src/middleware/logger.js';
+import swaggerUi from 'swagger-ui-express';
-import {createApp} from './src/app.factory.js';
+import swaggerJSDoc from 'swagger-jsdoc';
-import {bootstrapAdmin} from './src/models/admin/admin.bootstrap.js';
+import logger from './src/middleware/logger';
+
+// Router imports
+import {calendarRouter} from './src/models/calendar/Calendar.router';
+import {feedbackRouter} from './src/models/feedback/Feedback.router';
+
+
+let cors = require('cors');
 
 dotenv.config();
 
@@ -13,11 +21,95 @@ if (!process.env.PORT) {
 
 const port: number = parseInt(process.env.PORT, 10);
 
-const app = createApp();
+const app: express.Application = express();
 const server: http.Server = http.createServer(app);
 
+// Behind Plesk's nginx, req.ip is the proxy unless we trust the forwarded header.
+// Verify the resolved client IP is correct in staging before relying on it
+// (used by the feedback rate limiter).
+app.set('trust proxy', 1);
+
+// here we are adding middleware to parse all incoming requests as JSON
+app.use(express.json());
+
+// Configure CORS
+let allowedHosts = [
+	'https://www.nachklang.art',
+	'https://calendar.nachklang.art',
+	'https://feedback.nachklang.art'
+];
+const isDev = process.env.NODE_ENV !== 'production';
+const localhostRegex = /^http:\/\/localhost:\d+$/;
+// Matches http://<private-LAN-IPv4>:<port> - needed so the feedback form can
+// be reached from a real phone over WiFi during dev (the phone's Origin is
+// the dev machine's LAN IP, never "localhost"). Dev-only, same as above.
+const lanIpRegex = /^http:\/\/(192\.168\.\d{1,3}\.\d{1,3}|10\.\d{1,3}\.\d{1,3}\.\d{1,3}|172\.(1[6-9]|2\d|3[01])\.\d{1,3}\.\d{1,3}):\d+$/;
+app.use(cors({
+	allowedHeaders: ['Content-Type', 'X-Session-Id', 'X-Session-Key'],
+	origin: function (origin: any, callback: any) {
+		// Allow requests with no origin
+		if (!origin) return callback(null, true);
+
+		// Any localhost port, or a private-LAN IP, is fine outside production -
+		// dev servers pick whatever port is free (Next.js falls back from 3000
+		// if it's taken), and real-device testing hits the dev machine by IP.
+		if (isDev && (localhostRegex.test(origin) || lanIpRegex.test(origin))) {
+			return callback(null, true);
+		}
+
+		// Block requests with wrong origin
+		if (allowedHosts.indexOf(origin) === -1) {
+			return callback(new Error('The CORS policy doesn\'t allow access for your origin.'), false);
+		}
+
+		// Allow all other requests
+		return callback(null, true);
+	}
+}));
+
+// Swagger documentation
+const swaggerDefinition = {
+	openapi: '3.0.0',
+	info: {
+		title: 'Nachklang e.V. REST API',
+		version: '0.1.0',
+		license: {
+			name: 'Licensed Under MIT',
+			url: 'https://spdx.org/licenses/MIT.html'
+		},
+		contact: {
+			name: 'Nachklang e.V.',
+			url: 'https://www.nachklang.art'
+		}
+	}
+};
+
+const options = {
+	swaggerDefinition,
+	// Paths to files containing OpenAPI definitions
+	apis: [
+		'./src/models/**/*.interface.ts',
+		'./src/models/**/*.router.ts'
+	]
+};
+
+const swaggerSpec = swaggerJSDoc(options);
+
+app.use(
+	'/docs',
+	swaggerUi.serve,
+	swaggerUi.setup(swaggerSpec)
+);
+
+// Add routers
+app.use('/calendar', calendarRouter);
+app.use('/feedback', feedbackRouter);
+
+// this is a simple route to make sure everything is working properly
+app.get('/', (req: express.Request, res: express.Response) => {
+	res.status(200).send('Welcome to the Nachklang e.V. REST API!');
+});
+
 server.listen(port, () => {
 	logger.info('Server listening on Port ' + port);
-	// Makes sure ADMIN_BOOTSTRAP_EMAIL can always get in. Never throws.
-	void bootstrapAdmin();
 });

docker-compose.dev.yml

@@ -1,28 +0,0 @@
-# Local dev only — not used in production/deployment. Spins up a MariaDB
-# instance with the calendar (reconstructed dev schema, see docker/init's
-# disclaimer), feedback, and tickets databases pre-seeded.
-#
-# Usage:
-#   docker compose -f docker-compose.dev.yml up -d
-#
-# Then point .env at:
-#   DB_HOST=127.0.0.1
-#   DB_USER=nachklang
-#   DB_PASSWORD=devpassword
-#   CALENDAR_DB=nachklang_calendar
-#   FEEDBACK_DB=nachklang_feedback
-#   TICKETS_DB=nachklang_tickets
-services:
-  mariadb:
-    image: mariadb:11
-    environment:
-      MARIADB_ROOT_PASSWORD: rootdevpassword
-    ports:
-      - "3306:3306"
-    volumes:
-      - nachklang_dev_db:/var/lib/mysql
-      - ./sql:/migrations:ro
-      - ./docker/init:/docker-entrypoint-initdb.d:ro
-
-volumes:
-  nachklang_dev_db:

docker-compose.test.yml

@@ -1,31 +0,0 @@
-# Manual alternative for bringing up the admin tests' database by hand.
-#
-# `npm run test:integration` does NOT use this file: test/integration/setup.ts
-# starts the container directly, because `podman compose` needs a separate
-# compose provider that neither podman nor docker ships, and one container needs
-# no orchestration. Keep the two in step, or delete this file if nobody uses it.
-#
-# Port 3307 and a throwaway data directory on purpose: it must never collide
-# with, or outlive, the dev database from docker-compose.dev.yml.
-services:
-  mariadb-test:
-    image: mariadb:11
-    environment:
-      MARIADB_ROOT_PASSWORD: roottestpassword
-      MARIADB_DATABASE: nachklang_admin
-      MARIADB_USER: nachklang
-      MARIADB_PASSWORD: testpassword
-    ports:
-      - "3307:3306"
-    tmpfs:
-      - /var/lib/mysql
-    volumes:
-      # Applied by the entrypoint on first boot, against MARIADB_DATABASE.
-      # This is the very migration production runs, so a mistake in it fails
-      # the test run rather than the deploy.
-      - ./sql/admin/001_init.sql:/docker-entrypoint-initdb.d/001_init.sql:ro
-    healthcheck:
-      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
-      interval: 2s
-      timeout: 5s
-      retries: 30

docker/init/00-databases.sql

@@ -1,12 +0,0 @@
--- Local dev only. Creates the four databases + a dev user with full access.
-CREATE DATABASE IF NOT EXISTS nachklang_calendar CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-CREATE DATABASE IF NOT EXISTS nachklang_feedback CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-CREATE DATABASE IF NOT EXISTS nachklang_tickets CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-CREATE DATABASE IF NOT EXISTS nachklang_admin CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-
-CREATE USER IF NOT EXISTS 'nachklang'@'%' IDENTIFIED BY 'devpassword';
-GRANT ALL PRIVILEGES ON nachklang_calendar.* TO 'nachklang'@'%';
-GRANT ALL PRIVILEGES ON nachklang_feedback.* TO 'nachklang'@'%';
-GRANT ALL PRIVILEGES ON nachklang_tickets.* TO 'nachklang'@'%';
-GRANT ALL PRIVILEGES ON nachklang_admin.* TO 'nachklang'@'%';
-FLUSH PRIVILEGES;

docker/init/01-calendar-schema-dev.sql

@@ -1,89 +0,0 @@
--- Local dev only. Real schema, provided directly by the repo owner
--- (calendars, events, event_versions, sessions, users) - not a guess.
-USE nachklang_calendar;
-
-CREATE TABLE `calendars` (
-  `calendar_id` int(11) NOT NULL AUTO_INCREMENT,
-  `name` text NOT NULL,
-  `includes_calendars` text DEFAULT NULL,
-  PRIMARY KEY (`calendar_id`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci;
-
-CREATE TABLE `users` (
-  `user_id` int(11) NOT NULL AUTO_INCREMENT,
-  `full_name` text NOT NULL,
-  `password_hash` text DEFAULT NULL,
-  `email` text NOT NULL,
-  `is_active` tinyint(1) DEFAULT 0,
-  `pw_reset_token_hash` text DEFAULT NULL,
-  `activation_token` text DEFAULT NULL,
-  PRIMARY KEY (`user_id`),
-  UNIQUE KEY `email` (`email`) USING HASH
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci;
-
-CREATE TABLE `sessions` (
-  `session_id` int(11) NOT NULL AUTO_INCREMENT,
-  `user_id` int(11) NOT NULL,
-  `session_key_hash` text DEFAULT NULL,
-  `created_date` datetime DEFAULT current_timestamp(),
-  `valid_until` datetime DEFAULT (current_timestamp() + interval 30 day),
-  `last_ip` text DEFAULT NULL,
-  PRIMARY KEY (`session_id`),
-  KEY `sessions_users_user_id_fk` (`user_id`),
-  CONSTRAINT `sessions_users_user_id_fk` FOREIGN KEY (`user_id`) REFERENCES `users` (`user_id`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci;
-
-CREATE TABLE `events` (
-  `event_id` int(11) NOT NULL AUTO_INCREMENT,
-  `calendar_id` int(11) NOT NULL,
-  `uuid` text NOT NULL,
-  `created_date` datetime DEFAULT current_timestamp(),
-  `created_by_id` int(11) NOT NULL,
-  PRIMARY KEY (`event_id`),
-  KEY `events_calendars_calendar_id_fk` (`calendar_id`),
-  KEY `events_users_user_id_fk` (`created_by_id`),
-  CONSTRAINT `events_calendars_calendar_id_fk` FOREIGN KEY (`calendar_id`) REFERENCES `calendars` (`calendar_id`),
-  CONSTRAINT `events_users_user_id_fk` FOREIGN KEY (`created_by_id`) REFERENCES `users` (`user_id`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci;
-
-CREATE TABLE `event_versions` (
-  `event_version_id` int(11) NOT NULL AUTO_INCREMENT,
-  `event_id` int(11) NOT NULL,
-  `name` text DEFAULT NULL,
-  `description` text DEFAULT NULL,
-  `start_datetime` datetime DEFAULT NULL,
-  `end_datetime` datetime DEFAULT NULL,
-  `whole_day` tinyint(1) DEFAULT NULL,
-  `repeat_frequency` text DEFAULT NULL,
-  `location` text DEFAULT NULL,
-  `url` text DEFAULT NULL,
-  `version_created_by_id` int(11) DEFAULT NULL,
-  `status` text DEFAULT NULL,
-  `version_created_at` datetime DEFAULT current_timestamp(),
-  PRIMARY KEY (`event_version_id`),
-  KEY `event_versions_events_event_id_fk` (`event_id`),
-  KEY `event_versions_users_user_id_fk` (`version_created_by_id`),
-  CONSTRAINT `event_versions_events_event_id_fk` FOREIGN KEY (`event_id`) REFERENCES `events` (`event_id`) ON DELETE CASCADE ON UPDATE CASCADE,
-  CONSTRAINT `event_versions_users_user_id_fk` FOREIGN KEY (`version_created_by_id`) REFERENCES `users` (`user_id`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci;
-
-INSERT INTO calendars (calendar_id, name, includes_calendars) VALUES
-    (1, 'public', '[]'),
-    (2, 'members', '[]'),
-    (3, 'management', '[]'),
-    (4, 'choir', '[]'),
-    (5, 'birthdays', '[]');
-
--- Dev admin, password: devpassword
-INSERT INTO users (email, password_hash, full_name, is_active) VALUES
-    ('dev@nachklang.art', '$2b$10$vmj7POS/68SGE.eI7pGjMegrw0vNNZ2HVSUTra5NRsl8iOLwiMgZK', 'Dev Admin', 1);
-
-INSERT INTO events (calendar_id, uuid, created_by_id) VALUES
-    (1, UUID(), 1),
-    (1, UUID(), 1),
-    (1, UUID(), 1);
-
-INSERT INTO event_versions (event_id, name, description, start_datetime, end_datetime, whole_day, location, url, status, version_created_by_id) VALUES
-    (1, 'Frühlingskonzert 2026', 'Erstes Konzert der Reihe', '2026-04-18 19:00:00', '2026-04-18 21:00:00', 0, 'Musikhochschule, Karlsruhe', 'https://www.nachklang.art/events/fruehlingskonzert-2026', 'PUBLIC', 1),
-    (2, 'Sommerkonzert 2026', 'Zweites Konzert der Reihe', '2026-07-11 19:00:00', '2026-07-11 21:00:00', 0, 'Christuskirche, Karlsruhe', 'https://www.nachklang.art/events/sommerkonzert-2026', 'PUBLIC', 1),
-    (3, 'Adventskonzert 2026', 'Drittes Konzert der Reihe', '2026-12-05 19:00:00', '2026-12-05 21:00:00', 0, 'Stadtkirche, Karlsruhe', 'https://www.nachklang.art/events/adventskonzert-2026', 'DRAFT', 1);

docker/init/02-feedback-schema.sql

@@ -1,3 +0,0 @@
-USE nachklang_feedback;
-SOURCE /migrations/feedback/001_init.sql;
-SOURCE /migrations/feedback/002_add_poster_image_url.sql;

docker/init/03-tickets-schema.sql

@@ -1,3 +0,0 @@
-USE nachklang_tickets;
-SOURCE /migrations/tickets/001_init.sql;
-SOURCE /migrations/tickets/002_add_require_address.sql;

docker/init/04-admin-schema.sql

@@ -1,170 +0,0 @@
--- Local dev only. Mirrors the table definitions in sql/admin/001_init.sql -
--- keep the two in step - and seeds a ready-to-use dev account on top.
-USE nachklang_admin;
-
-CREATE TABLE IF NOT EXISTS `user` (
-	`id`            VARCHAR(36)  NOT NULL,
-	`name`          VARCHAR(255) NOT NULL,
-	`email`         VARCHAR(255) NOT NULL,
-	`emailVerified` TINYINT(1)   NOT NULL DEFAULT 0,
-	`image`         TEXT         DEFAULT NULL,
-	`createdAt`     DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP,
-	`updatedAt`     DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP,
-	-- Nachklang addition, declared through better-auth's additionalFields so
-	-- the adapter knows about it. Disabling also revokes the user's sessions.
-	`disabled`      TINYINT(1)   NOT NULL DEFAULT 0,
-	PRIMARY KEY (`id`),
-	UNIQUE KEY `user_email` (`email`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
-CREATE TABLE IF NOT EXISTS `session` (
-	`id`        VARCHAR(36)  NOT NULL,
-	`expiresAt` DATETIME     NOT NULL,
-	`token`     VARCHAR(255) NOT NULL,
-	`createdAt` DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP,
-	`updatedAt` DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP,
-	`ipAddress` VARCHAR(255) DEFAULT NULL,
-	`userAgent` TEXT         DEFAULT NULL,
-	`userId`    VARCHAR(36)  NOT NULL,
-	PRIMARY KEY (`id`),
-	UNIQUE KEY `session_token` (`token`),
-	KEY `session_user` (`userId`),
-	CONSTRAINT `session_user_fk` FOREIGN KEY (`userId`) REFERENCES `user` (`id`) ON DELETE CASCADE
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
-CREATE TABLE IF NOT EXISTS `account` (
-	`id`                    VARCHAR(36)  NOT NULL,
-	-- 1.7 addition: distinguishes a local credential account
-	-- ("local:credential") from an OAuth issuer. Written by better-auth.
-	`issuer`                VARCHAR(255) NOT NULL,
-	`accountId`             VARCHAR(255) NOT NULL,
-	`providerId`            VARCHAR(255) NOT NULL,
-	`userId`                VARCHAR(36)  NOT NULL,
-	`accessToken`           TEXT         DEFAULT NULL,
-	`refreshToken`          TEXT         DEFAULT NULL,
-	`idToken`               TEXT         DEFAULT NULL,
-	`accessTokenExpiresAt`  DATETIME     DEFAULT NULL,
-	`refreshTokenExpiresAt` DATETIME     DEFAULT NULL,
-	`scope`                 TEXT         DEFAULT NULL,
-	`password`              TEXT         DEFAULT NULL,
-	`createdAt`             DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP,
-	`updatedAt`             DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP,
-	PRIMARY KEY (`id`),
-	KEY `account_user` (`userId`),
-	KEY `account_provider` (`providerId`, `accountId`),
-	CONSTRAINT `account_user_fk` FOREIGN KEY (`userId`) REFERENCES `user` (`id`) ON DELETE CASCADE
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
--- Password-reset and e-mail-verification tokens.
-CREATE TABLE IF NOT EXISTS `verification` (
-	`id`         VARCHAR(36)  NOT NULL,
-	`identifier` VARCHAR(255) NOT NULL,
-	`value`      TEXT         NOT NULL,
-	`expiresAt`  DATETIME     NOT NULL,
-	`createdAt`  DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP,
-	`updatedAt`  DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP,
-	PRIMARY KEY (`id`),
-	KEY `verification_identifier` (`identifier`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
-CREATE TABLE IF NOT EXISTS `passkey` (
-	`id`           VARCHAR(36)  NOT NULL,
-	`name`         VARCHAR(255) DEFAULT NULL,
-	`publicKey`    TEXT         NOT NULL,
-	`userId`       VARCHAR(36)  NOT NULL,
-	`credentialID` VARCHAR(255) NOT NULL,
-	`counter`      INT          NOT NULL DEFAULT 0,
-	`deviceType`   VARCHAR(255) NOT NULL,
-	`backedUp`     TINYINT(1)   NOT NULL DEFAULT 0,
-	`transports`   VARCHAR(255) DEFAULT NULL,
-	`createdAt`    DATETIME     DEFAULT CURRENT_TIMESTAMP,
-	`aaguid`       VARCHAR(255) DEFAULT NULL,
-	PRIMARY KEY (`id`),
-	KEY `passkey_user` (`userId`),
-	KEY `passkey_credential` (`credentialID`),
-	CONSTRAINT `passkey_user_fk` FOREIGN KEY (`userId`) REFERENCES `user` (`id`) ON DELETE CASCADE
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
--- Required by rateLimit.storage = 'database' in admin.auth.ts. Passenger may
--- run several API instances, and an in-memory limiter would give each of them
--- its own budget.
-CREATE TABLE IF NOT EXISTS `rateLimit` (
-	`id`          VARCHAR(36)  NOT NULL,
-	`key`         VARCHAR(255) NOT NULL,
-	`count`       INT          NOT NULL DEFAULT 0,
-	-- Epoch milliseconds, not a DATETIME: better-auth stores a number here.
-	`lastRequest` BIGINT       NOT NULL DEFAULT 0,
-	PRIMARY KEY (`id`),
-	UNIQUE KEY `rate_limit_key` (`key`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
--- ---------------------------------------------------------------------------
--- Nachklang-owned tables
--- ---------------------------------------------------------------------------
-
--- Which apps a user may administer. `admin` is just another app: holding it is
--- what lets someone manage users and invitations. A permission is (app, role);
--- `access` is the only role today, and the key admits several per app so finer
--- ones can be added by inserting rows rather than by migrating this table.
-CREATE TABLE IF NOT EXISTS `user_app_permissions` (
-	`user_id`    VARCHAR(36) NOT NULL,
-	`app`        ENUM('calendar','feedback','tickets','admin') NOT NULL,
-	-- One row per (user, app, role). `access` means "may use this app at all"
-	-- and is the only role today; the key allows several per app so a finer
-	-- permission can be added later by inserting rows, not by migrating.
-	`role`       VARCHAR(32) NOT NULL DEFAULT 'access',
-	`granted_by` VARCHAR(36) DEFAULT NULL,
-	`granted_at` DATETIME    NOT NULL DEFAULT CURRENT_TIMESTAMP,
-	-- (user_id, app) is the leftmost prefix of this key, so the per-request
-	-- permission lookup needs no separate index.
-	PRIMARY KEY (`user_id`, `app`, `role`),
-	CONSTRAINT `uap_user_fk` FOREIGN KEY (`user_id`) REFERENCES `user` (`id`) ON DELETE CASCADE
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
--- The only route to a new account: there is no public sign-up. Only the
--- SHA-256 of the token is stored, so a dump of this table hands out no access.
-CREATE TABLE IF NOT EXISTS `invitations` (
-	`id`          INT AUTO_INCREMENT PRIMARY KEY,
-	`email`       VARCHAR(255) NOT NULL,
-	`name`        VARCHAR(255) NOT NULL,
-	`token_hash`  CHAR(64)     NOT NULL,
-	`permissions` JSON         NOT NULL,
-	`invited_by`  VARCHAR(36)  DEFAULT NULL,
-	`created_at`  DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP,
-	`expires_at`  DATETIME     NOT NULL,
-	`accepted_at` DATETIME     DEFAULT NULL,
-	`revoked_at`  DATETIME     DEFAULT NULL,
-	UNIQUE KEY `inv_token_hash` (`token_hash`),
-	KEY `inv_email` (`email`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
--- ---------------------------------------------------------------------------
--- Dev seed: dev@nachklang.art / devpassword, with every app permission.
--- Local only - this account exists nowhere but in this container.
---
--- The password hash is better-auth's own scrypt format (salt:hash), produced
--- with better-auth 1.7.2's hashPassword(). Regenerate it if better-auth ever
--- changes that format; a hash it cannot parse shows up as "invalid password"
--- on an otherwise correct sign-in.
---
--- `issuer` must be exactly 'local:credential' - it is how better-auth 1.7
--- recognises a local password account when signing in.
--- ---------------------------------------------------------------------------
-INSERT INTO `user` (`id`, `name`, `email`, `emailVerified`, `disabled`)
-VALUES ('dev-user-0000-0000-0000-000000000001', 'Dev Admin', 'dev@nachklang.art', 1, 0);
-
-INSERT INTO `account` (`id`, `issuer`, `accountId`, `providerId`, `userId`, `password`)
-VALUES (
-	'dev-acct-0000-0000-0000-000000000001',
-	'local:credential',
-	'dev-user-0000-0000-0000-000000000001',
-	'credential',
-	'dev-user-0000-0000-0000-000000000001',
-	'e6a0485feb04b8fa64453db87badd8e1:85aaffd845e1e44fabc5be97d684c0f533845ed11088bd3f4d533ef277ead71da8372b5c6a72c7eae2d48e3270c50e2d13cffa4fcfb0b5cec456100b8f007ed2'
-);
-
-INSERT INTO `user_app_permissions` (`user_id`, `app`, `role`) VALUES
-	('dev-user-0000-0000-0000-000000000001', 'calendar', 'access'),
-	('dev-user-0000-0000-0000-000000000001', 'feedback', 'access'),
-	('dev-user-0000-0000-0000-000000000001', 'tickets',  'access'),
-	('dev-user-0000-0000-0000-000000000001', 'admin',    'access');

docs/calendar-auth-migration.md

@@ -1,74 +0,0 @@
-# Migrating the Calendar domain onto the admin identity module
-
-Status: **not started.** Written 2026-09-05 alongside the admin module (step 2 of
-`docs/plan-admin-auth.md` in the nachklang-admin repo), which deliberately left the
-calendar alone.
-
-## Why the calendar was left out
-
-The admin module replaced authentication for feedback and tickets by swapping one
-middleware. The calendar cannot be done that way, because its user identity is woven into
-its data:
-
-- `users`/`sessions` live in the **calendar** database and are the same tables the
-  feedback and tickets admin areas used to authenticate against.
-- `events.created_by_id` is an **INT** foreign key into `users.user_id`. The admin module's
-  user ids are **VARCHAR(36)** strings. Migrating identity means migrating that column and
-  every query that joins it.
-- The Angular frontend passes `sessionId`/`sessionKey` as **query parameters**
-  (`DEFERRED_SECURITY.md` item 1). Cookie sessions remove the parameters entirely, so
-  every calendar route signature and the frontend's HTTP layer change together.
-- `credentials.service.ts` implements a second, parallel authorisation model: the
-  `MEMBER_CREDENTIAL` / `CHOIR_CREDENTIAL` / `MANAGEMENT_CREDENTIAL` shared secrets that
-  let non-users read specific calendars. That has no equivalent in the admin module and is
-  not a per-user permission at all.
-
-What already exists today: `calendar` is a value in the `user_app_permissions.app` enum, so
-permissions can be granted before anything else moves.
-
-## What is in place to build on
-
-- Cookie sessions across `*.nachklang.art`, and `requireAppAccess('calendar')` in
-  `src/models/admin/admin.middleware.ts` - usable the moment a calendar route wants it.
-- `res.locals.admin` is `{id, email, displayName, apps}`; `id` is the string user id.
-- Invitations, disable/enable and session revocation already cover calendar users, because
-  they are properties of the account rather than of an app.
-
-## Suggested sequence
-
-Each step is meant to leave production working on its own.
-
-1. **Add a bridging column.** `ALTER TABLE events ADD COLUMN created_by_user_id
-   VARCHAR(36) NULL`, indexed. Nothing reads it yet.
-2. **Map the accounts.** For every legacy `users` row that should survive, invite the
-   person through the admin UI. On acceptance, backfill `events.created_by_user_id` from
-   `events.created_by_id` via an email-to-new-id mapping. Everyone not re-invited keeps
-   working on the legacy path until step 4.
-3. **Dual-read.** Change `events.service.ts` to prefer `created_by_user_id` and fall back
-   to `created_by_id`. Writes fill both. This is the only step that is temporary code, and
-   it should carry a removal note pointing at step 5.
-4. **Switch the routes.** Replace the query-parameter session checks in
-   `events.router.ts` and `users.router.ts` with `requireAppAccess('calendar')`, and change
-   the Angular frontend to `withCredentials: true` against the same origin list. Deploy the
-   API first; the calendar frontend is broken between the two deploys, so pick a quiet
-   time. This closes `DEFERRED_SECURITY.md` item 1.
-5. **Drop the legacy path.** Remove `users.service.ts`'s session handling, the `sessions`
-   table, `created_by_id`, and the dual-read from step 3. Legacy `/calendar/users/*` stays
-   only if something still calls it - otherwise delete it too. `X-Session-Id` /
-   `X-Session-Key` can then come out of the CORS `allowedHeaders` list in
-   `src/app.factory.ts`.
-
-## Open questions to settle before starting
-
-- **The shared calendar credentials.** Do `MEMBER_CREDENTIAL` and friends stay as a
-  separate mechanism (they serve people with no account at all, and iCal clients that
-  cannot send headers), or do read-only accounts replace them? This is a product decision,
-  not a technical one, and it decides how much of `credentials.service.ts` survives.
-- **The iCal export.** `GET /calendar/events/{calendar}/ical` takes a password in the query
-  string on purpose, because iCal clients cannot send headers. Cookie sessions do not help
-  here; this endpoint likely keeps its own scheme.
-- **Which legacy accounts to keep.** Step 2 is the moment to not re-invite people who no
-  longer need access.
-- **`event_versions.version_created_by_id`.** The same INT reference again, joined in
-  `events.service.ts` for the "last modified by" name. It has to move with `events`, and it
-  is the reason step 1's bridging column needs a sibling on `event_versions`.

jest.config.js

@@ -0,0 +1,8 @@
+/** @type {import('ts-jest/dist/types').InitialOptionsTsJest} */
+module.exports = {
+    preset: 'ts-jest',
+    testEnvironment: 'node',
+    roots: [
+        'test'
+    ]
+};

package.json

@@ -3,65 +3,55 @@
 	"version": "0.1.0",
 	"description": "",
 	"main": "index.js",
-	"type": "module",
-	"engines": {
-		"node": ">=26"
-	},
 	"scripts": {
 		"start": "tsc && node ./dist/app.js",
 		"build": "tsc",
 		"debug": "export DEBUG=* && npm run start",
-		"test": "vitest run --coverage",
+		"test": "jest --coverage --testResultsProcessor ./node_modules/jest-sonar-reporter/index.js"
-		"test:watch": "vitest",
-		"test:integration": "vitest run --config vitest.integration.config.ts"
 	},
 	"keywords": [],
 	"author": "",
 	"license": "ISC",
 	"dependencies": {
-		"@better-auth/core": "^1.7.2",
-		"@better-auth/passkey": "^1.7.2",
 		"app-root-path": "^3.0.0",
-		"axios": "^1.20.0",
+		"axios": "^0.24.0",
 		"bcrypt": "^5.0.1",
-		"better-auth": "^1.7.2",
 		"cors": "^2.8.5",
 		"debug": "^4.3.1",
-		"dotenv": "^16.6.1",
+		"dotenv": "^8.2.0",
 		"express": "^4.18.2",
 		"guid-typescript": "^1.0.9",
-		"kysely": "^0.29.5",
 		"mariadb": "^3.0.2",
-		"mysql2": "^3.24.3",
+		"nodemailer": "^6.9.8",
 		"random-words": "^1.1.1",
 		"swagger-jsdoc": "^6.1.0",
 		"swagger-ui-express": "^4.3.0",
-		"winston": "^3.3.3",
+		"winston": "^3.3.3"
-		"zod": "^4.5.4"
 	},
 	"devDependencies": {
 		"@types/app-root-path": "^1.2.4",
 		"@types/bcrypt": "^3.0.1",
-		"@types/cors": "^2.8.19",
 		"@types/debug": "^4.1.5",
 		"@types/express": "^4.17.15",
-		"@types/node": "^26.4.1",
+		"@types/jest": "^28.1.3",
+		"@types/node": "^18.11.17",
+		"@types/nodemailer": "^6.4.14",
 		"@types/random-words": "^1.1.2",
-		"@types/supertest": "^7.2.1",
 		"@types/swagger-jsdoc": "^6.0.1",
 		"@types/swagger-ui-express": "^4.1.3",
 		"@types/winston": "^2.4.4",
-		"@vitest/coverage-v8": "^5.0.0",
 		"is-number": "^7.0.0",
+		"jest": "^28.1.1",
+		"jest-sonar-reporter": "^2.0.0",
 		"source-map-support": "^0.5.19",
-		"supertest": "^7.2.2",
+		"ts-jest": "^28.0.5",
-		"typescript": "^5.9.3",
+		"tslint": "^6.1.3",
-		"vitest": "^5.0.0",
+		"typescript": "^4.9.4"
-		"vitest-sonar-reporter": "^3.0.0"
 	},
-	"overrides": {
+	"jestSonar": {
-		"better-auth": {
+		"sonar56x": true,
-			"vitest": "$vitest"
+		"reportPath": "testResults",
-		}
+		"reportFile": "sonar-report.xml",
+		"indent": 4
 	}
 }

sql/admin/001_init.sql

@@ -1,150 +0,0 @@
--- nachklang_admin: identity, sessions and per-app permissions for every
--- *.nachklang.art app.
---
--- The better-auth tables below (user, session, account, verification, passkey,
--- rateLimit) mirror what better-auth 1.7.2 derives from the configuration in
--- src/models/admin/admin.auth.ts, including the `disabled` additionalField on
--- `user` and the `rateLimit` table that rateLimit.storage='database' requires.
--- On every better-auth upgrade: re-derive the table list, diff it against this
--- file, and add a numbered migration - never edit this one in place.
---
--- Table and column names are better-auth's own ("camel" casing, so `rateLimit`
--- and `userId`). MariaDB on Linux compares table names case-sensitively, so the
--- casing here is load-bearing. The two Nachklang-owned tables at the bottom use
--- the snake_case convention of the rest of this repo's SQL.
-
-CREATE TABLE IF NOT EXISTS `user` (
-	`id`            VARCHAR(36)  NOT NULL,
-	`name`          VARCHAR(255) NOT NULL,
-	`email`         VARCHAR(255) NOT NULL,
-	`emailVerified` TINYINT(1)   NOT NULL DEFAULT 0,
-	`image`         TEXT         DEFAULT NULL,
-	`createdAt`     DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP,
-	`updatedAt`     DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP,
-	-- Nachklang addition, declared through better-auth's additionalFields so
-	-- the adapter knows about it. Disabling also revokes the user's sessions.
-	`disabled`      TINYINT(1)   NOT NULL DEFAULT 0,
-	PRIMARY KEY (`id`),
-	UNIQUE KEY `user_email` (`email`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
-CREATE TABLE IF NOT EXISTS `session` (
-	`id`        VARCHAR(36)  NOT NULL,
-	`expiresAt` DATETIME     NOT NULL,
-	`token`     VARCHAR(255) NOT NULL,
-	`createdAt` DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP,
-	`updatedAt` DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP,
-	`ipAddress` VARCHAR(255) DEFAULT NULL,
-	`userAgent` TEXT         DEFAULT NULL,
-	`userId`    VARCHAR(36)  NOT NULL,
-	PRIMARY KEY (`id`),
-	UNIQUE KEY `session_token` (`token`),
-	KEY `session_user` (`userId`),
-	CONSTRAINT `session_user_fk` FOREIGN KEY (`userId`) REFERENCES `user` (`id`) ON DELETE CASCADE
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
-CREATE TABLE IF NOT EXISTS `account` (
-	`id`                    VARCHAR(36)  NOT NULL,
-	-- 1.7 addition: distinguishes a local credential account
-	-- ("local:credential") from an OAuth issuer. Written by better-auth.
-	`issuer`                VARCHAR(255) NOT NULL,
-	`accountId`             VARCHAR(255) NOT NULL,
-	`providerId`            VARCHAR(255) NOT NULL,
-	`userId`                VARCHAR(36)  NOT NULL,
-	`accessToken`           TEXT         DEFAULT NULL,
-	`refreshToken`          TEXT         DEFAULT NULL,
-	`idToken`               TEXT         DEFAULT NULL,
-	`accessTokenExpiresAt`  DATETIME     DEFAULT NULL,
-	`refreshTokenExpiresAt` DATETIME     DEFAULT NULL,
-	`scope`                 TEXT         DEFAULT NULL,
-	`password`              TEXT         DEFAULT NULL,
-	`createdAt`             DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP,
-	`updatedAt`             DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP,
-	PRIMARY KEY (`id`),
-	KEY `account_user` (`userId`),
-	KEY `account_provider` (`providerId`, `accountId`),
-	CONSTRAINT `account_user_fk` FOREIGN KEY (`userId`) REFERENCES `user` (`id`) ON DELETE CASCADE
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
--- Password-reset and e-mail-verification tokens.
-CREATE TABLE IF NOT EXISTS `verification` (
-	`id`         VARCHAR(36)  NOT NULL,
-	`identifier` VARCHAR(255) NOT NULL,
-	`value`      TEXT         NOT NULL,
-	`expiresAt`  DATETIME     NOT NULL,
-	`createdAt`  DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP,
-	`updatedAt`  DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP,
-	PRIMARY KEY (`id`),
-	KEY `verification_identifier` (`identifier`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
-CREATE TABLE IF NOT EXISTS `passkey` (
-	`id`           VARCHAR(36)  NOT NULL,
-	`name`         VARCHAR(255) DEFAULT NULL,
-	`publicKey`    TEXT         NOT NULL,
-	`userId`       VARCHAR(36)  NOT NULL,
-	`credentialID` VARCHAR(255) NOT NULL,
-	`counter`      INT          NOT NULL DEFAULT 0,
-	`deviceType`   VARCHAR(255) NOT NULL,
-	`backedUp`     TINYINT(1)   NOT NULL DEFAULT 0,
-	`transports`   VARCHAR(255) DEFAULT NULL,
-	`createdAt`    DATETIME     DEFAULT CURRENT_TIMESTAMP,
-	`aaguid`       VARCHAR(255) DEFAULT NULL,
-	PRIMARY KEY (`id`),
-	KEY `passkey_user` (`userId`),
-	KEY `passkey_credential` (`credentialID`),
-	CONSTRAINT `passkey_user_fk` FOREIGN KEY (`userId`) REFERENCES `user` (`id`) ON DELETE CASCADE
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
--- Required by rateLimit.storage = 'database' in admin.auth.ts. Passenger may
--- run several API instances, and an in-memory limiter would give each of them
--- its own budget.
-CREATE TABLE IF NOT EXISTS `rateLimit` (
-	`id`          VARCHAR(36)  NOT NULL,
-	`key`         VARCHAR(255) NOT NULL,
-	`count`       INT          NOT NULL DEFAULT 0,
-	-- Epoch milliseconds, not a DATETIME: better-auth stores a number here.
-	`lastRequest` BIGINT       NOT NULL DEFAULT 0,
-	PRIMARY KEY (`id`),
-	UNIQUE KEY `rate_limit_key` (`key`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
--- ---------------------------------------------------------------------------
--- Nachklang-owned tables
--- ---------------------------------------------------------------------------
-
--- Which apps a user may administer. `admin` is just another app: holding it is
--- what lets someone manage users and invitations. A permission is (app, role);
--- `access` is the only role today, and the key admits several per app so finer
--- ones can be added by inserting rows rather than by migrating this table.
-CREATE TABLE IF NOT EXISTS `user_app_permissions` (
-	`user_id`    VARCHAR(36) NOT NULL,
-	`app`        ENUM('calendar','feedback','tickets','admin') NOT NULL,
-	-- One row per (user, app, role). `access` means "may use this app at all"
-	-- and is the only role today; the key allows several per app so a finer
-	-- permission can be added later by inserting rows, not by migrating.
-	`role`       VARCHAR(32) NOT NULL DEFAULT 'access',
-	`granted_by` VARCHAR(36) DEFAULT NULL,
-	`granted_at` DATETIME    NOT NULL DEFAULT CURRENT_TIMESTAMP,
-	-- (user_id, app) is the leftmost prefix of this key, so the per-request
-	-- permission lookup needs no separate index.
-	PRIMARY KEY (`user_id`, `app`, `role`),
-	CONSTRAINT `uap_user_fk` FOREIGN KEY (`user_id`) REFERENCES `user` (`id`) ON DELETE CASCADE
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
--- The only route to a new account: there is no public sign-up. Only the
--- SHA-256 of the token is stored, so a dump of this table hands out no access.
-CREATE TABLE IF NOT EXISTS `invitations` (
-	`id`          INT AUTO_INCREMENT PRIMARY KEY,
-	`email`       VARCHAR(255) NOT NULL,
-	`name`        VARCHAR(255) NOT NULL,
-	`token_hash`  CHAR(64)     NOT NULL,
-	`permissions` JSON         NOT NULL,
-	`invited_by`  VARCHAR(36)  DEFAULT NULL,
-	`created_at`  DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP,
-	`expires_at`  DATETIME     NOT NULL,
-	`accepted_at` DATETIME     DEFAULT NULL,
-	`revoked_at`  DATETIME     DEFAULT NULL,
-	UNIQUE KEY `inv_token_hash` (`token_hash`),
-	KEY `inv_email` (`email`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

sql/tickets/001_init.sql

@@ -1,102 +0,0 @@
--- Nachklang e.V. Tickets module — initial schema for TICKETS_DB
--- Apply manually against the TICKETS_DB database (separate from CALENDAR_DB
--- and FEEDBACK_DB). See nachklang-tickets/docs/plan-ticket-shop.md for the
--- full design rationale.
---
--- Apply with e.g.:
---   mysql -h <DB_HOST> -u <DB_USER> -p <TICKETS_DB> < 001_init.sql
---
--- Deliberately no USE statement here: the target database is selected via
--- the mysql command line above (whatever TICKETS_DB is actually named in
--- .env), not hardcoded to a literal schema name.
---
--- `event_id` columns below refer to Calendar's `events.event_id` (a
--- different database). Deliberately no cross-database foreign key —
--- Tickets reads Calendar events via events.service.ts in the same Node
--- process, not via a DB-level join.
-
--- 1. voucher_codes --------------------------------------------------------
-CREATE TABLE voucher_codes (
-    code             VARCHAR(12)  NOT NULL PRIMARY KEY,
-    status           ENUM('UNUSED','REDEEMED','VOID') NOT NULL DEFAULT 'UNUSED',
-    max_guests       INT          NOT NULL DEFAULT 2,
-    prefill_name     VARCHAR(255) NULL,
-    prefill_email    VARCHAR(255) NULL,
-    batch_id         VARCHAR(36)  NULL,
-    created_by_email VARCHAR(255) NOT NULL,
-    created_at       DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    KEY idx_vc_batch (batch_id),
-    KEY idx_vc_status (status)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
--- 2. voucher_code_events (join: which concerts a code may be redeemed for) -
-CREATE TABLE voucher_code_events (
-    voucher_code_event_id INT AUTO_INCREMENT PRIMARY KEY,
-    code                   VARCHAR(12) NOT NULL,
-    event_id               INT         NOT NULL,
-    CONSTRAINT fk_vce_code FOREIGN KEY (code) REFERENCES voucher_codes(code) ON DELETE CASCADE,
-    UNIQUE KEY uq_vce_code_event (code, event_id),
-    KEY idx_vce_event (event_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
--- 3. event_ticket_settings (per-concert voucher config) ---------------------
--- One row per Calendar event_id that has ever had voucher settings
--- configured. Absent row == uncapped, no deadline, address not collected
--- (see docs/plan-ticket-shop.md — "absence over sentinels").
-CREATE TABLE event_ticket_settings (
-    event_id             INT        NOT NULL PRIMARY KEY,
-    capacity             INT        NULL,
-    redemption_deadline  DATETIME   NULL,
-    collect_address      TINYINT(1) NOT NULL DEFAULT 0,
-    updated_at           DATETIME   NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
--- 4. redemptions ------------------------------------------------------------
--- `status` is soft-state rather than a hard delete on undo, so guest data
--- and history survive an undo for the audit trail. Capacity/reporting
--- queries filter status = 'ACTIVE'. A code that gets redeemed again after
--- being undone creates a new row here rather than reviving the old one.
-CREATE TABLE redemptions (
-    redemption_id   INT AUTO_INCREMENT PRIMARY KEY,
-    code            VARCHAR(12)  NOT NULL,
-    event_id        INT          NOT NULL,
-    status          ENUM('ACTIVE','UNDONE') NOT NULL DEFAULT 'ACTIVE',
-    contact_name    VARCHAR(255) NOT NULL,
-    contact_email   VARCHAR(255) NOT NULL,
-    contact_address TEXT         NULL,
-    guest_count     INT          NOT NULL,
-    redeemed_at     DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    CONSTRAINT fk_red_code FOREIGN KEY (code) REFERENCES voucher_codes(code),
-    KEY idx_red_event_status (event_id, status),
-    KEY idx_red_code (code)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
--- 5. redemption_guests --------------------------------------------------------
--- One row per attendee, including the primary contact (position 0).
-CREATE TABLE redemption_guests (
-    redemption_guest_id INT AUTO_INCREMENT PRIMARY KEY,
-    redemption_id       INT          NOT NULL,
-    name                VARCHAR(255) NOT NULL,
-    position            INT          NOT NULL DEFAULT 0,
-    CONSTRAINT fk_rg_redemption FOREIGN KEY (redemption_id) REFERENCES redemptions(redemption_id) ON DELETE CASCADE,
-    KEY idx_rg_redemption (redemption_id, position)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-
--- 6. voucher_audit_log ----------------------------------------------------
--- Lightweight admin-action history per code (not a full version-history
--- system) — who did what and why. Covers EDIT/VOID/UNDO only; the guest's
--- own redemption isn't an admin action so it isn't logged here (it's
--- already timestamped on `redemptions.redeemed_at`).
-CREATE TABLE voucher_audit_log (
-    audit_id        INT AUTO_INCREMENT PRIMARY KEY,
-    code            VARCHAR(12)  NOT NULL,
-    redemption_id   INT          NULL,
-    admin_email     VARCHAR(255) NOT NULL,
-    action          ENUM('EDIT','VOID','UNDO') NOT NULL,
-    change_summary  JSON         NULL,
-    reason          VARCHAR(500) NULL,
-    created_at      DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    CONSTRAINT fk_val_code FOREIGN KEY (code) REFERENCES voucher_codes(code) ON DELETE CASCADE,
-    CONSTRAINT fk_val_redemption FOREIGN KEY (redemption_id) REFERENCES redemptions(redemption_id) ON DELETE SET NULL,
-    KEY idx_val_code_time (code, created_at)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

sql/tickets/002_add_require_address.sql

@@ -1,7 +0,0 @@
--- Nachklang e.V. Tickets module — adds a per-event "address required" flag,
--- distinct from collect_address (which only controls whether the field is
--- shown/collected at all). Apply manually against TICKETS_DB, after
--- 001_init.sql:
---   mysql -h <DB_HOST> -u <DB_USER> -p <TICKETS_DB> < 002_add_require_address.sql
-ALTER TABLE event_ticket_settings
-    ADD COLUMN require_address TINYINT(1) NOT NULL DEFAULT 0 AFTER collect_address;

sql/tickets/003_add_confirmation_email_status.sql

@@ -1,7 +0,0 @@
--- Nachklang e.V. Tickets module — records the outcome of the redemption
--- confirmation email on the redemption itself, so the admin UI can flag a
--- failed send and offer a resend. NULL until the post-commit send resolves.
--- Apply manually against TICKETS_DB, after 002_add_require_address.sql:
---   mysql -h <DB_HOST> -u <DB_USER> -p <TICKETS_DB> < 003_add_confirmation_email_status.sql
-ALTER TABLE redemptions
-    ADD COLUMN confirmation_email_status ENUM('SENT','FAILED') NULL DEFAULT NULL AFTER redeemed_at;

src/app.factory.ts

@@ -1,171 +0,0 @@
-import express from 'express';
-import * as dotenv from 'dotenv';
-import swaggerUi from 'swagger-ui-express';
-import swaggerJSDoc from 'swagger-jsdoc';
-import cors from 'cors';
-import {toNodeHandler} from 'better-auth/node';
-import logger from './middleware/logger.js';
-
-// Router imports
-import {calendarRouter} from './models/calendar/Calendar.router.js';
-import {feedbackRouter} from './models/feedback/Feedback.router.js';
-import {ticketsRouter} from './models/tickets/Tickets.router.js';
-import {adminRouter} from './models/admin/Admin.router.js';
-import {auth} from './models/admin/admin.auth.js';
-import {ADMIN_ALLOWED_ORIGINS, isProd} from './models/admin/admin.config.js';
-
-
-dotenv.config();
-
-
-/**
- * Builds the Express app with every router and middleware in place.
- *
- * Separate from app.ts so the integration tests can drive the *real* wiring
- * with supertest instead of a hand-rolled copy of it. The order below is not
- * cosmetic - CORS has to precede the better-auth handler so preflights get
- * their headers, and the better-auth handler has to precede express.json()
- * because it reads the raw body stream itself.
- */
-export const createApp = (): express.Application => {
-	const app: express.Application = express();
-
-	// Behind Plesk's nginx, req.ip is the proxy unless we trust the forwarded header.
-	// Verify the resolved client IP is correct in staging before relying on it
-	// (used by the feedback rate limiter).
-	app.set('trust proxy', 1);
-
-	// Configure CORS. This has to run before the better-auth handler below, so
-	// that preflights for /admin/auth/* get their headers, which is why it now
-	// sits above express.json() instead of after it.
-	let allowedHosts = [
-		'https://www.nachklang.art',
-		'https://calendar.nachklang.art',
-		'https://feedback.nachklang.art',
-		'https://tickets.nachklang.art',
-		'https://admin.nachklang.art',
-		// The admin app's origin comes from ADMIN_APP_URL, so a rename or a
-		// staging host does not need a code change here.
-		...ADMIN_ALLOWED_ORIGINS
-	];
-	// `isProd` from admin.config, NOT `NODE_ENV !== 'production'`. The two are not
-	// the same when NODE_ENV is unset, which is exactly what a fresh Plesk vhost
-	// gives you: the old test called that "dev" and opened the loopback and
-	// private-LAN exceptions below. With `credentials: true` on this CORS config
-	// and a session cookie scoped to .nachklang.art, that let any page served
-	// from localhost read a signed-in admin's data cross-origin. admin.config
-	// treats anything but an explicit 'development'/'test' as production, so an
-	// unset value now fails closed.
-	const isDev = !isProd;
-	const localhostRegex = /^http:\/\/localhost:\d+$/;
-	// Matches http://<private-LAN-IPv4>:<port> - needed so the feedback form can
-	// be reached from a real phone over WiFi during dev (the phone's Origin is
-	// the dev machine's LAN IP, never "localhost"). Dev-only, same as above.
-	const lanIpRegex = /^http:\/\/(192\.168\.\d{1,3}\.\d{1,3}|10\.\d{1,3}\.\d{1,3}\.\d{1,3}|172\.(1[6-9]|2\d|3[01])\.\d{1,3}\.\d{1,3}):\d+$/;
-	app.use(cors({
-		// X-Session-* are no longer read by anything on this side: the step 4
-		// cutover took the last two readers (feedback.auth.ts, tickets.auth.ts)
-		// off them, and the calendar module passes its session in query
-		// parameters (DEFERRED_SECURITY.md item 1). They stay allowed only so a
-		// browser still running the pre-cutover tickets or feedback bundle gets
-		// a clean 401 rather than a CORS preflight failure. Drop them once both
-		// frontends are deployed - see docs/calendar-auth-migration.md step 5.
-		allowedHeaders: ['Content-Type', 'X-Session-Id', 'X-Session-Key'],
-		// The admin session lives in a cookie, so browsers must be allowed to send
-		// it cross-origin - this is what makes credentials: 'include' work.
-		credentials: true,
-		origin: function (origin: any, callback: any) {
-			// Allow requests with no origin
-			if (!origin) return callback(null, true);
-
-			// Any localhost port, or a private-LAN IP, is fine outside production -
-			// dev servers pick whatever port is free (Next.js falls back from 3000
-			// if it's taken), and real-device testing hits the dev machine by IP.
-			if (isDev && (localhostRegex.test(origin) || lanIpRegex.test(origin))) {
-				return callback(null, true);
-			}
-
-			// Block requests with wrong origin
-			if (allowedHosts.indexOf(origin) === -1) {
-				return callback(new Error('The CORS policy doesn\'t allow access for your origin.'), false);
-			}
-
-			// Allow all other requests
-			return callback(null, true);
-		}
-	}));
-
-	// better-auth's own handler, mounted before express.json(): it reads the raw
-	// request body stream itself and a parsed body would leave it hanging.
-	//
-	// Wrapped, because Express 4 does not await an async handler: a rejected
-	// promise escapes as an unhandled rejection instead of becoming a response.
-	// Nearly every better-auth route touches the admin database, so a database
-	// blip would leave the request hanging with no answer at all while the
-	// process logged an uncaughtException - observed by pointing ADMIN_DB at a
-	// database the user cannot open. Answer 503 instead: the caller learns, and
-	// the other domains keep serving.
-	const authHandler = toNodeHandler(auth);
-	app.all('/admin/auth/*', (req, res) => {
-		Promise.resolve(authHandler(req, res)).catch((e: any) => {
-			logger.error('Admin auth handler failed', {path: req.path, detail: e?.message});
-			if (!res.headersSent) {
-				res.status(503).send({
-					status: 'SERVICE_UNAVAILABLE',
-					message: 'Die Anmeldung ist derzeit nicht verfügbar. Bitte versuche es später erneut.'
-				});
-			}
-		});
-	});
-
-	// here we are adding middleware to parse all incoming requests as JSON
-	app.use(express.json());
-
-	// Swagger documentation
-	const swaggerDefinition = {
-		openapi: '3.0.0',
-		info: {
-			title: 'Nachklang e.V. REST API',
-			version: '1.0.0',
-			license: {
-				name: 'Licensed Under MIT',
-				url: 'https://spdx.org/licenses/MIT.html'
-			},
-			contact: {
-				name: 'Nachklang e.V.',
-				url: 'https://www.nachklang.art'
-			}
-		}
-	};
-
-	const options = {
-		swaggerDefinition,
-		// Paths to files containing OpenAPI definitions
-		apis: [
-			'./src/models/**/*.interface.ts',
-			'./src/models/**/*.router.ts'
-		]
-	};
-
-	const swaggerSpec = swaggerJSDoc(options);
-
-	app.use(
-		'/docs',
-		swaggerUi.serve,
-		swaggerUi.setup(swaggerSpec)
-	);
-
-	// Add routers
-	app.use('/calendar', calendarRouter);
-	app.use('/feedback', feedbackRouter);
-	app.use('/tickets', ticketsRouter);
-	// JSON routes only; the auth handler above is mounted separately.
-	app.use('/admin', adminRouter);
-
-	// this is a simple route to make sure everything is working properly
-	app.get('/', (req: express.Request, res: express.Response) => {
-		res.status(200).send('Welcome to the Nachklang e.V. REST API!');
-	});
-
-	return app;
-};

src/common/common.mail.nodemailer.ts

@@ -0,0 +1,38 @@
+import * as nodemailer from 'nodemailer';
+
+export namespace MailService {
+    const transporter = nodemailer.createTransport({
+        host: process.env.EMAIL_HOST,
+        pool: true,
+        port: 465,
+        secure: true,
+        auth: {
+            user: process.env.EMAIL_USERNAME,
+            pass: process.env.EMAIL_PASSWORD
+        },
+        tls: {rejectUnauthorized: false}
+    });
+
+    const mailConfigurations = {
+
+        // It should be a string of sender email
+        from: 'noreply@nachklang.art',
+
+        // Comma Separated list of mails
+        to: 'mail@pmueller.me',
+
+        // Subject of Email
+        subject: '',
+
+        // This would be the text of email body
+        text: ''
+    };
+
+    export const sendMail = async (recipientAddress: string, subject: string, body: string) => {
+        mailConfigurations.to = recipientAddress;
+        mailConfigurations.subject = subject;
+        mailConfigurations.text = body;
+
+        await transporter.sendMail(mailConfigurations);
+    };
+}

src/common/common.mail.ts

@@ -1,107 +0,0 @@
-import logger from '../middleware/logger.js';
-import {salesforceApexRestPost, salesforceEnabled} from './salesforce.client.js';
-
-// Transactional email for the ticketing/calendar flows (voucher redemption
-// confirmations, account activation links, password-reset tokens) is relayed
-// through the Nachklang Salesforce org rather than sent over our own SMTP host:
-// that host's IP reputation gets it blocked by allowlist-based receivers
-// (notably t-online.de). Salesforce's MTA plus the org's DKIM signature for
-// nachklang.art get the mail delivered. The org endpoint is EmailSendResource
-// (POST /services/apexrest/email/send); the From address is fixed server-side
-// there and is never sent from here.
-//
-// sendMail never throws on a delivery problem. Every caller has already
-// committed its own work (a registration, a password-reset token, a
-// redemption) by the time mail goes out, so a mail failure must not surface as
-// a user-facing error. It returns whether the mail was accepted so the one
-// caller that shows failures to staff (the voucher confirmation) can record it.
-
-export namespace MailService {
-	export interface MailAttachment {
-		filename: string;
-		content: string | Buffer;
-		contentType?: string;
-	}
-
-	export interface SendMailOptions {
-		html?: string;
-		attachments?: MailAttachment[];
-	}
-
-	interface EmailSendResponse {
-		status: 'SENT';
-	}
-
-	// Practical ceiling, well under Apex REST's 6 MB request-body limit once
-	// base64 inflation (~33%) is accounted for. The only attachment today is a
-	// ~1 KB .ics file.
-	const MAX_ATTACHMENT_BYTES = 3 * 1024 * 1024;
-
-	const isRetriable = (err: any): boolean => {
-		const status = err?.response?.status;
-		if (status !== undefined) {
-			return status >= 500;
-		}
-		// No response at all - network error or timeout.
-		return true;
-	};
-
-	/**
-	 * Relays one email through the Salesforce org. Retries once on a transient
-	 * failure (5xx / network / timeout), then logs and returns false rather
-	 * than throwing. Returns false immediately (without a callout) when the
-	 * Salesforce integration is disabled.
-	 */
-	export const sendMail = async (
-		recipientAddress: string,
-		subject: string,
-		body: string,
-		options?: SendMailOptions
-	): Promise<boolean> => {
-		if (!salesforceEnabled()) {
-			logger.info('MailService: SALESFORCE_ENABLED is false, would have sent', {recipientAddress, subject});
-			return false;
-		}
-
-		let attachments: {filename: string; contentType?: string; contentBase64: string}[];
-		try {
-			attachments = (options?.attachments ?? []).map(attachment => {
-				const buffer = Buffer.isBuffer(attachment.content)
-					? attachment.content
-					: Buffer.from(attachment.content, 'utf-8');
-				if (buffer.byteLength > MAX_ATTACHMENT_BYTES) {
-					throw new Error(`attachment ${attachment.filename} is ${buffer.byteLength} bytes, over the ${MAX_ATTACHMENT_BYTES} limit`);
-				}
-				return {filename: attachment.filename, contentType: attachment.contentType, contentBase64: buffer.toString('base64')};
-			});
-		} catch (err: any) {
-			logger.error('MailService: could not prepare attachments', {recipientAddress, subject, detail: err?.message});
-			return false;
-		}
-
-		const payload = {
-			to: recipientAddress,
-			subject,
-			textBody: body,
-			htmlBody: options?.html ?? null,
-			attachments
-		};
-
-		for (let attempt = 1; attempt <= 2; attempt++) {
-			try {
-				await salesforceApexRestPost<EmailSendResponse>('/services/apexrest/email/send', payload);
-				return true;
-			} catch (err: any) {
-				const status = err?.response?.status;
-				const detail = err?.response?.data?.errorCode || err?.response?.data?.message || err?.message || 'unknown error';
-				if (attempt === 1 && isRetriable(err)) {
-					logger.warn('MailService: send failed, retrying once', {recipientAddress, subject, status, detail});
-					continue;
-				}
-				logger.error('MailService: send failed', {recipientAddress, subject, status, detail});
-				return false;
-			}
-		}
-		return false;
-	};
-}

src/common/salesforce.client.ts

@@ -1,66 +0,0 @@
-import axios from 'axios';
-
-// Shared server-to-server access to the one Nachklang Salesforce org. Both the
-// newsletter-signup sync (feedback module) and the transactional-email relay
-// (common.mail) authenticate the same way - OAuth 2.0 client credentials
-// against the nk_Nachklang_API_Integration external client app - so the token
-// cache and the retry-once-on-401 live here rather than being duplicated.
-//
-// Salesforce's client-credentials token response does not reliably include
-// expires_in, so the cache lifetime is a conservative guess rather than a
-// value read from the response - a 401 on the next call just triggers a fresh
-// fetch (see salesforceApexRestPost).
-
-const TOKEN_CACHE_MS = 15 * 60 * 1000;
-let cachedToken: {accessToken: string; fetchedAt: number} | null = null;
-
-export const salesforceEnabled = (): boolean => process.env.SALESFORCE_ENABLED === 'true';
-
-const readConfig = (): {instanceUrl: string; clientId: string; clientSecret: string} => {
-	const instanceUrl = process.env.SALESFORCE_API_URL;
-	const clientId = process.env.SALESFORCE_CLIENT_ID;
-	const clientSecret = process.env.SALESFORCE_CLIENT_SECRET;
-	if (!instanceUrl || !clientId || !clientSecret) {
-		throw new Error('SALESFORCE_ENABLED is true but SALESFORCE_API_URL/SALESFORCE_CLIENT_ID/SALESFORCE_CLIENT_SECRET are not fully configured.');
-	}
-	return {instanceUrl, clientId, clientSecret};
-};
-
-const getAccessToken = async (forceRefresh: boolean): Promise<string> => {
-	if (!forceRefresh && cachedToken && Date.now() - cachedToken.fetchedAt < TOKEN_CACHE_MS) {
-		return cachedToken.accessToken;
-	}
-
-	const {instanceUrl, clientId, clientSecret} = readConfig();
-	const res = await axios.post(
-		`${instanceUrl}/services/oauth2/token`,
-		new URLSearchParams({grant_type: 'client_credentials', client_id: clientId, client_secret: clientSecret}).toString(),
-		{headers: {'Content-Type': 'application/x-www-form-urlencoded'}, timeout: 10000}
-	);
-	cachedToken = {accessToken: res.data.access_token, fetchedAt: Date.now()};
-	return cachedToken.accessToken;
-};
-
-/**
- * POSTs a JSON body to an Apex REST path (e.g. '/services/apexrest/newsletter/signup')
- * and returns the parsed response body. Retries once with a forced token
- * refresh on a 401 - the server-side token may have expired even though our
- * conservative local TTL has not. All other errors propagate to the caller.
- */
-export const salesforceApexRestPost = async <T>(path: string, body: unknown): Promise<T> => {
-	const {instanceUrl} = readConfig();
-	const url = `${instanceUrl}${path}`;
-
-	try {
-		const token = await getAccessToken(false);
-		const res = await axios.post<T>(url, body, {headers: {Authorization: `Bearer ${token}`}, timeout: 10000});
-		return res.data;
-	} catch (err: any) {
-		if (err?.response?.status === 401) {
-			const token = await getAccessToken(true);
-			const res = await axios.post<T>(url, body, {headers: {Authorization: `Bearer ${token}`}, timeout: 10000});
-			return res.data;
-		}
-		throw err;
-	}
-};

src/middleware/logger.ts

@@ -1,10 +1,10 @@
-import appRoot from 'app-root-path';
+import * as appRoot from 'app-root-path';
-import winston from 'winston';
+import * as winston from 'winston';
 
 const options = {
 	file_info: {
 		level: 'info',
-		filename: `${appRoot.path}/logs/app.log`,
+		filename: `${appRoot}/logs/app.log`,
 		handleExceptions: true,
 		json: true,
 		maxsize: 5242880, // 5MB
@@ -13,7 +13,7 @@ const options = {
 	},
 	file_error: {
 		level: 'error',
-		filename: `${appRoot.path}/logs/error.log`,
+		filename: `${appRoot}/logs/error.log`,
 		handleExceptions: true,
 		json: true,
 		maxsize: 5242880, // 5MB
@@ -22,7 +22,7 @@ const options = {
 	},
 	file_debug: {
 		level: 'debug',
-		filename: `${appRoot.path}/logs/debug.log`,
+		filename: `${appRoot}/logs/debug.log`,
 		handleExceptions: true,
 		json: true,
 		maxsize: 5242880, // 5MB

src/models/admin/Admin.db.ts

@@ -1,55 +0,0 @@
-import * as dotenv from 'dotenv';
-import mysql from 'mysql2';
-import {Kysely, MysqlDialect} from 'kysely';
-import {AdminDatabase} from './admin.schema.js';
-import logger from '../../middleware/logger.js';
-
-dotenv.config();
-
-/**
- * The admin module is the one place in this API that does not use the
- * `mariadb` driver: better-auth talks to the database through Kysely, whose
- * MySQL dialect expects a mysql2 pool. The other domains keep their own
- * `mariadb` pools (see Feedback.db.ts) - this is an addition, not a migration.
- *
- * The pool is the callback-style `mysql2` one, NOT `mysql2/promise`: Kysely's
- * MysqlDialect calls `pool.getConnection((err, conn) => ...)`. The promise
- * wrapper ignores that callback and returns a Promise instead, so every query
- * through Kysely would hang forever with no error - which is exactly what it
- * did until the integration tests caught it.
- *
- * timezone 'Z' matters: better-auth computes session and token expiry in UTC.
- * Without it mysql2 would write and read those DATETIMEs in the process's local
- * zone, so sessions would expire an hour early or late depending on DST.
- */
-
-export namespace NachklangAdminDB {
-	export const pool = mysql.createPool({
-		host: process.env.DB_HOST,
-		user: process.env.DB_USER,
-		password: process.env.DB_PASSWORD,
-		database: process.env.ADMIN_DB,
-		// The other modules' pools default to 3306. This one is configurable so
-		// the integration tests can point at a throwaway container on another
-		// port without touching a developer's real .env.
-		port: parseInt(process.env.DB_PORT || '3306', 10),
-		connectionLimit: 5,
-		timezone: 'Z'
-	});
-
-	// mysql2 emits connection trouble as an event on the pool, not only as a
-	// rejected query. Without a listener Node turns that into an
-	// uncaughtException, so a database restart would take the whole API - and
-	// with it the calendar, feedback and tickets domains - down with it.
-	// Individual queries still reject, and their callers still answer 500.
-	pool.on('error', (err: unknown) => {
-		logger.error('Admin database pool error', {detail: (err as any)?.message});
-	});
-
-	// Handed to better-auth as `database: {dialect, type: 'mysql'}`.
-	export const dialect = new MysqlDialect({pool});
-
-	// Used by this module's own services for the two custom tables and for
-	// permission lookups that join better-auth's `user`.
-	export const db = new Kysely<AdminDatabase>({dialect});
-}

src/models/admin/Admin.router.ts

@@ -1,48 +0,0 @@
-import express, {Request, Response} from 'express';
-import {requireAppAccess, requireSignedIn} from './admin.middleware.js';
-import {usersAdminRouter} from './users/users.admin.router.js';
-import {invitationsRouter} from './invitations/invitations.router.js';
-
-/**
- * The admin module's JSON routes. Deliberately *not* the better-auth handler:
- * that one is mounted separately in app.ts, ahead of express.json(), because it
- * needs the raw request body stream.
- *
- * Mounted at /admin, so the tree is:
- *   /admin/me            any signed-in account
- *   /admin/users/*       admin permission
- *   /admin/invitations/* admin permission
- */
-export const adminRouter = express.Router();
-
-/**
- * @swagger
- * /admin/me:
- *      get:
- *          summary: The current user's identity and app permissions
- *          description: Used by every frontend to decide what to show. The API remains the real gate.
- *          tags: [admin]
- *          responses:
- *              200:
- *                  description: Success
- *              401:
- *                  description: Not signed in
- *              403:
- *                  description: Account disabled
- */
-adminRouter.get('/me', requireSignedIn, (req: Request, res: Response) => {
-	res.status(200).send({
-		id: res.locals.admin.id,
-		email: res.locals.admin.email,
-		fullName: res.locals.admin.displayName,
-		// `permissions` is the full (app, role) truth; `apps` is the distinct
-		// apps within it. Both are sent because the three frontends only ever ask
-		// "may I show this app?", and keeping `apps` means a finer permission can
-		// land here without a coordinated deploy of all of them.
-		permissions: res.locals.admin.permissions,
-		apps: res.locals.admin.apps
-	});
-});
-
-adminRouter.use('/users', requireAppAccess('admin'), usersAdminRouter);
-adminRouter.use('/invitations', requireAppAccess('admin'), invitationsRouter);

src/models/admin/admin.auth.ts

@@ -1,162 +0,0 @@
-import {betterAuth} from 'better-auth';
-import {APIError} from 'better-auth/api';
-import {passkey, getAuthenticatorName} from '@better-auth/passkey';
-import {NachklangAdminDB} from './Admin.db.js';
-import {invitationsPlugin} from './invitations/invitations.plugin.js';
-import {sendPasswordResetMail} from './admin.mail.js';
-import * as UsersService from './users/users.admin.service.js';
-import logger from '../../middleware/logger.js';
-import {
-	ADMIN_ALLOWED_ORIGINS,
-	API_BASE_URL,
-	BETTER_AUTH_SECRET,
-	CLIENT_IP_HEADERS,
-	PASSKEY_RP_ID,
-	TRUSTED_PROXY_IPS,
-	isProd
-} from './admin.config.js';
-
-/**
- * The single better-auth instance for all *.nachklang.art apps. Mounted in
- * app.ts at /admin/auth/* with better-auth's own node handler, ahead of
- * express.json() (it needs the raw body stream).
- *
- * The session cookie is what every app trusts. Everything else in this module -
- * permissions, invitations, the admin UI - hangs off it.
- */
-
-const DAY = 60 * 60 * 24;
-
-// Dev runs the apps on plain localhost ports; cookies ignore the port, so
-// single-sign-on across them works without fake subdomains or mkcert.
-const localhostOrigins = [
-	'http://localhost:3000',
-	'http://localhost:3001',
-	'http://localhost:3002',
-	'http://localhost:3003'
-];
-
-const trustedOrigins = isProd
-	? ADMIN_ALLOWED_ORIGINS
-	: Array.from(new Set([...ADMIN_ALLOWED_ORIGINS, ...localhostOrigins]));
-
-export const auth = betterAuth({
-	appName: 'Nachklang',
-	database: {
-		dialect: NachklangAdminDB.dialect,
-		type: 'mysql'
-	},
-	basePath: '/admin/auth',
-	// Mandatory once crossSubDomainCookies is on: better-auth derives the
-	// cookie domain and its own absolute URLs from this.
-	baseURL: API_BASE_URL,
-	secret: BETTER_AUTH_SECRET,
-	trustedOrigins,
-
-	emailAndPassword: {
-		enabled: true,
-		// There is no public sign-up: accounts exist only through an
-		// invitation (see invitations.plugin.ts). This also makes
-		// auth.api.signUpEmail throw, which is intended.
-		disableSignUp: true,
-		sendResetPassword: async ({user, url}) => {
-			await sendPasswordResetMail(user.email, user.name, url);
-		}
-	},
-
-	user: {
-		additionalFields: {
-			// Not `returned`, and not settable through the API: disabling is an
-			// admin action on /admin/users/:id/disable, never something a
-			// session owner can flip on themselves.
-			disabled: {
-				type: 'boolean',
-				defaultValue: false,
-				input: false,
-				returned: false
-			}
-		}
-	},
-
-	session: {
-		expiresIn: 30 * DAY,
-		updateAge: DAY
-		// Deliberately no cookieCache: requireAppAccess hits the database on
-		// every request anyway, and a cached session would keep a disabled
-		// user or a revoked session alive for the cache's lifetime.
-	},
-
-	advanced: {
-		// Fixes the cookie name across releases so the frontends' middleware can
-		// check for it: "nachklang.session_token", or
-		// "__Secure-nachklang.session_token" over https.
-		cookiePrefix: 'nachklang',
-		crossSubDomainCookies: isProd
-			? {enabled: true, domain: '.nachklang.art'}
-			: {enabled: false},
-		ipAddress: {
-			// better-auth reads the request itself and does not know about
-			// Express's `trust proxy`, so both the header and the trusted hops
-			// have to be named here. Getting this wrong does not fail loudly -
-			// it collapses every client into one rate-limit bucket. See the
-			// commentary on CLIENT_IP_HEADERS in admin.config.ts.
-			ipAddressHeaders: CLIENT_IP_HEADERS,
-			...(TRUSTED_PROXY_IPS.length > 0 ? {trustedProxies: TRUSTED_PROXY_IPS} : {})
-		}
-	},
-
-	rateLimit: {
-		enabled: true,
-		// Passenger may run more than one instance; an in-memory limiter would
-		// then give each of them its own budget.
-		storage: 'database'
-	},
-
-	plugins: [
-		passkey({
-			rpID: PASSKEY_RP_ID,
-			rpName: 'Nachklang',
-			origin: ADMIN_ALLOWED_ORIGINS,
-
-			registration: {
-				// Without this, every passkey is stored with name = NULL and the
-				// account page can only label them all "Passkey" - useless at the
-				// one moment that list matters, when someone has to remove the
-				// passkey on the device they just lost.
-				//
-				// The AAGUID identifies the authenticator *model* (not a device
-				// and not a person), and better-auth ships the lookup table, so
-				// this yields "1Password", "iCloud Keychain", "Windows Hello".
-				// It only fills a blank: a name the client sent always wins, and
-				// an unknown AAGUID leaves the column NULL as before.
-				afterVerification: async ({verification}) => {
-					const name = getAuthenticatorName(verification.registrationInfo?.aaguid);
-					return name ? {name} : undefined;
-				}
-			}
-		}),
-		invitationsPlugin()
-	],
-
-	databaseHooks: {
-		session: {
-			create: {
-				before: async session => {
-					const access = await UsersService.loadAccess(session.userId);
-					if (access?.disabled) {
-						logger.warn('Admin: sign-in attempt by a disabled account', {userId: session.userId});
-						// Throwing rather than returning false: `false` aborts
-						// the session write silently and the caller sees a
-						// confusing success-shaped response with no cookie.
-						throw new APIError('FORBIDDEN', {
-							code: 'ACCOUNT_DISABLED',
-							message: 'Dieses Konto ist deaktiviert.'
-						});
-					}
-				}
-			}
-		}
-	}
-});
-
-export type AdminAuth = typeof auth;

src/models/admin/admin.bootstrap.ts

@@ -1,68 +0,0 @@
-import * as UsersService from './users/users.admin.service.js';
-import * as InvitationsService from './invitations/invitations.service.js';
-import {sendInvitationMail} from './admin.mail.js';
-import {ACCESS_ROLE} from './admin.schema.js';
-import {ADMIN_APP_URL, ADMIN_BOOTSTRAP_EMAIL, LOG_INVITE_LINKS} from './admin.config.js';
-import logger from '../../middleware/logger.js';
-
-/**
- * Solves the empty-database problem: with invite-only accounts and no public
- * sign-up, a fresh nachklang_admin has nobody who can invite anybody. Rather
- * than a CLI script somebody has to remember to run against production, the API
- * makes sure on every start that ADMIN_BOOTSTRAP_EMAIL can get in.
- *
- * Idempotent by design - it is safe on every restart:
- *   - an active admin already exists  -> do nothing
- *   - the address exists as a user    -> grant it `admin`
- *   - an open invitation exists       -> do nothing (do not re-mail on restart)
- *   - otherwise                       -> invite, and mail the link
- *
- * Never throws: a database blip at boot must not stop the API from serving the
- * calendar, feedback and tickets domains.
- */
-export const bootstrapAdmin = async (): Promise<void> => {
-	try {
-		if (!ADMIN_BOOTSTRAP_EMAIL) {
-			return;
-		}
-
-		const email = ADMIN_BOOTSTRAP_EMAIL.trim().toLowerCase();
-
-		if ((await UsersService.countActiveAdmins()) > 0) {
-			return;
-		}
-
-		const existing = await UsersService.findUserByEmail(email);
-		if (existing) {
-			await UsersService.grantPermission(existing.id, 'admin', null);
-			logger.info('Admin bootstrap: granted the admin permission to the existing bootstrap user', {email});
-			return;
-		}
-
-		// An expired invitation is not "open", so the next restart re-issues
-		// one - which is the recovery path if the first mail never arrived.
-		if (await InvitationsService.hasOpenInvitationFor(email)) {
-			logger.info('Admin bootstrap: an open invitation already exists', {email});
-			return;
-		}
-
-		const invitation = await InvitationsService.createInvitation(
-			email,
-			'Nachklang Admin',
-			[{app: 'admin', role: ACCESS_ROLE}],
-			null
-		);
-
-		const mailed = await sendInvitationMail(email, 'Nachklang Admin', invitation.token, invitation.expiresAt);
-		logger.info('Admin bootstrap: invitation created', {email, mailed});
-
-		// With the mail relay off, the logged link is how a local setup gets its
-		// first admin. Explicit opt-in (see LOG_INVITE_LINKS): the link is a
-		// live credential, so this must never depend on NODE_ENV alone.
-		if (LOG_INVITE_LINKS) {
-			logger.info(`Admin bootstrap: ${ADMIN_APP_URL}/accept-invite?token=${invitation.token}`);
-		}
-	} catch (e: any) {
-		logger.error('Admin bootstrap failed', {detail: e?.message});
-	}
-};

src/models/admin/admin.config.ts

@@ -1,189 +0,0 @@
-import * as crypto from 'crypto';
-import * as dotenv from 'dotenv';
-import logger from '../../middleware/logger.js';
-
-dotenv.config();
-
-/**
- * One place that reads the admin module's environment. Both admin.auth.ts
- * (better-auth trustedOrigins, passkey origins) and app.ts (CORS) need the
- * same origin list, and a second parser would drift from this one.
- *
- * Read this before changing the environment handling below: several security
- * properties depend on it, and they are deliberately arranged to fail *safe*.
- *
- * `NODE_ENV` is opt-in to relaxed behaviour, not opt-in to strict behaviour.
- * Only the explicit values 'development' and 'test' relax anything; anything
- * else - including NODE_ENV being unset, which is exactly what a fresh Plesk
- * vhost gives you - is treated as production. The inverse arrangement is a
- * trap: it degrades the cookie domain, the CORS origin list and the signing
- * key all at once, and every one of those failures is silent.
- *
- * The signing key is never allowed to be a known constant. In dev, an unset
- * BETTER_AUTH_SECRET becomes a random per-process value: sessions do not
- * survive a restart, which is mildly annoying and much better than a default
- * secret that can be copied out of this file and used against production.
- */
-
-const nodeEnv = process.env.NODE_ENV;
-
-// Explicitly relaxed environments. Everything else, unset included, is strict.
-const isRelaxedEnv = nodeEnv === 'development' || nodeEnv === 'test';
-
-export const isProd = !isRelaxedEnv;
-
-const required = (name: string, devDefault: string): string => {
-	const value = process.env[name];
-	if (value) {
-		return value;
-	}
-	if (isProd) {
-		logger.error(
-			`Admin module: ${name} is not set (NODE_ENV=${nodeEnv ?? 'unset'}, so strict mode applies; ` +
-			'set NODE_ENV=development for local work)'
-		);
-		throw new Error(`${name} must be set unless NODE_ENV is development or test`);
-	}
-	return devDefault;
-};
-
-export const API_BASE_URL = required('API_BASE_URL', 'http://localhost:3000');
-export const ADMIN_APP_URL = required('ADMIN_APP_URL', 'http://localhost:3002');
-
-// 32+ random bytes; better-auth signs cookies and reset tokens with it.
-// Rotating it invalidates every session, which is why it is not derived.
-// There is no hardcoded fallback on purpose: a constant committed here would
-// be a published signing key the moment someone deploys without setting it.
-export const BETTER_AUTH_SECRET = required(
-	'BETTER_AUTH_SECRET',
-	crypto.randomBytes(48).toString('base64')
-);
-
-// Passkeys are bound to this: a credential registered for "nachklang.art"
-// works on every *.nachklang.art host, one registered for "localhost" only
-// works in dev. Changing it invalidates every registered passkey.
-export const PASSKEY_RP_ID = process.env.PASSKEY_RP_ID || (isProd ? 'nachklang.art' : 'localhost');
-
-const parseList = (value: string | undefined, fallback: string[]): string[] => {
-	const parsed = (value || '')
-		.split(',')
-		.map(entry => entry.trim())
-		.filter(entry => entry.length > 0);
-
-	return parsed.length > 0 ? parsed : fallback;
-};
-
-/**
- * The apps whose frontends may talk to /admin/* with credentials.
- *
- * They feed better-auth's `trustedOrigins`, which is what lets the tickets and
- * feedback admin areas call /admin/auth/sign-out from their own origin. That
- * became load-bearing with the step 4 cutover: before it, the only browser
- * origin that ever reached /admin/auth was the admin app itself.
- *
- * Hence the production default rather than an empty list. An origin missing
- * here fails in a way that is easy to misread - sign-in works, the app works,
- * and only sign-out returns an origin error - so the two frontends we know
- * about are named here and APP_ORIGINS overrides them for a staging host.
- * Dev adds the localhost ports separately (see admin.auth.ts).
- */
-const DEFAULT_APP_ORIGINS = [
-	'https://tickets.nachklang.art',
-	'https://feedback.nachklang.art'
-];
-
-export const APP_ORIGINS = parseList(process.env.APP_ORIGINS, DEFAULT_APP_ORIGINS)
-	.map(origin => origin.replace(/\/$/, ''));
-
-// Kept in sync by construction rather than by three separate lists: the admin
-// app itself always counts, and dev adds the local ports.
-export const ADMIN_ALLOWED_ORIGINS = Array.from(new Set([
-	ADMIN_APP_URL.replace(/\/$/, ''),
-	...APP_ORIGINS
-]));
-
-/**
- * The header the reverse proxy puts the real client IP in, and the proxy hops
- * to trust when reading it.
- *
- * This matters more than it looks. better-auth does not know about Express's
- * `trust proxy`; it reads the request itself. If it cannot resolve a client IP
- * it falls back to a single shared bucket ("no-trusted-ip") for the whole
- * process - and /sign-in/* carries a default of 3 requests per 10 seconds, so
- * one noisy client would lock every user out of every app.
- *
- * Without TRUSTED_PROXY_IPS, better-auth rejects a multi-value
- * x-forwarded-for outright (it cannot tell which hop is the client), which is
- * exactly the case that produces that shared bucket. Set it to the address or
- * CIDR of Plesk's nginx. Conversely, listing a header the proxy does not
- * overwrite lets a client set its own IP and mint itself an unlimited
- * brute-force budget - so the default is the single header nginx sets, not a
- * permissive list.
- */
-
-/**
- * `CLIENT_IP_HEADERS=none` trusts no header at all.
- *
- * This is the escape hatch for the one case where the wrong setting is worse
- * than no setting: if the proxy turns out NOT to overwrite the header we are
- * trusting, any client can send it and mint itself an unlimited brute-force
- * budget against /sign-in. Falling back to the shared bucket is bad (one noisy
- * client can lock the organisation out for ten seconds at a time) but it is
- * bad in a way that fails closed, and it can be reverted from the environment
- * without a deploy.
- *
- * Reach for it only after a check has actually failed - `SELECT ipAddress FROM
- * session ORDER BY createdAt DESC` showing 127.0.0.1 or NULL for a real remote
- * sign-in - and take it back out once the header is configured.
- *
- * An empty or unset value still means "use the default", not "trust nothing":
- * a stray blank line in a .env must not silently change how requests are
- * bucketed. Only the explicit word does that.
- */
-const TRUST_NO_HEADER = 'none';
-
-export const TRUST_NO_CLIENT_IP_HEADER =
-	(process.env.CLIENT_IP_HEADERS || '').trim().toLowerCase() === TRUST_NO_HEADER;
-
-// An empty array is what better-auth reads as "no headers": it only falls back
-// to its own default when the option is absent, and `[]` is truthy.
-export const CLIENT_IP_HEADERS = TRUST_NO_CLIENT_IP_HEADER
-	? []
-	: parseList(process.env.CLIENT_IP_HEADERS, ['x-real-ip']);
-
-export const TRUSTED_PROXY_IPS = parseList(process.env.TRUSTED_PROXY_IPS, []);
-
-if (isProd && TRUST_NO_CLIENT_IP_HEADER) {
-	logger.warn(
-		'Admin module: CLIENT_IP_HEADERS=none - no client-IP header is trusted, so every ' +
-		'request shares one rate-limit bucket and /sign-in allows 3 attempts per 10 seconds ' +
-		'for everyone combined. This is the safe fallback, not a destination: configure the ' +
-		'header the proxy actually sets and remove it.'
-	);
-} else if (isProd && TRUSTED_PROXY_IPS.length === 0) {
-	logger.warn(
-		'Admin module: TRUSTED_PROXY_IPS is not set. If the proxy sends a multi-value ' +
-		`${CLIENT_IP_HEADERS.join('/')}, better-auth cannot resolve a client IP and every ` +
-		'request shares one rate-limit bucket. Verify with: SELECT `key` FROM rateLimit - ' +
-		'a "no-trusted-ip" row means this is happening. A single-value header needs no ' +
-		'trusted proxies, so this warning is expected on a plain single-proxy setup.'
-	);
-}
-
-export const ADMIN_BOOTSTRAP_EMAIL = process.env.ADMIN_BOOTSTRAP_EMAIL || '';
-
-/**
- * Whether to write invitation links to the log. An invitation link is a live
- * account-creation credential, so this is an explicit opt-in rather than
- * something inferred from NODE_ENV: local work needs it (the mail relay is
- * usually off, and only the token's hash is stored, so there is otherwise no
- * way to walk the accept flow), and production must never have it.
- *
- * Refused outright in strict mode, so setting it in a production .env by
- * accident fails at boot instead of quietly filling the log with credentials.
- */
-export const LOG_INVITE_LINKS = process.env.ADMIN_LOG_INVITE_LINKS === 'true' && !isProd;
-
-if (process.env.ADMIN_LOG_INVITE_LINKS === 'true' && isProd) {
-	logger.error('Admin module: ADMIN_LOG_INVITE_LINKS is set outside development - refusing to log invitation tokens');
-}

src/models/admin/admin.errors.ts

@@ -1,17 +0,0 @@
-import {Response} from 'express';
-import {Guid} from 'guid-typescript';
-import logger from '../../middleware/logger.js';
-
-/**
- * Same catch-block convention as the feedback and tickets modules: log with a
- * reference guid, never hand the real error message to the client.
- */
-export const sendServerError = (res: Response, e: any): void => {
-	const errorGuid = Guid.create().toString();
-	logger.error('Error handling a request: ' + e.message, {reference: errorGuid});
-	res.status(500).send({
-		status: 'PROCESSING_ERROR',
-		message: 'Internal Server Error. Try again later.',
-		reference: errorGuid
-	});
-};

src/models/admin/admin.interface.ts

@@ -1,120 +0,0 @@
-/**
- * Swagger component definitions for the admin module. Picked up by
- * swagger-jsdoc through the `src/models/**\/*.interface.ts` glob in
- * app.factory.ts.
- *
- * Note what is *not* documented here: the better-auth routes under
- * /admin/auth/* (sign-in, sign-out, reset-password, passkey ceremonies, and
- * the invitation preview/accept endpoints). better-auth owns those paths and
- * their shapes; duplicating them by hand would only drift on the next upgrade.
- */
-
-/**
- * @swagger
- * components:
- *   securitySchemes:
- *     AdminSessionCookie:
- *       type: apiKey
- *       in: cookie
- *       name: nachklang.session_token
- *       description: >
- *         Set by /admin/auth/sign-in/email. Over https the name is
- *         __Secure-nachklang.session_token and the cookie is scoped to
- *         .nachklang.art, so one sign-in covers every *.nachklang.art app.
- *   schemas:
- *     AdminApp:
- *       type: string
- *       enum: [calendar, feedback, tickets, admin]
- *       description: Holding "admin" is what allows managing users and invitations.
- *     AdminMe:
- *       type: object
- *       properties:
- *         id:
- *           type: string
- *         email:
- *           type: string
- *         fullName:
- *           type: string
- *         apps:
- *           type: array
- *           items:
- *             $ref: '#/components/schemas/AdminApp'
- *     AdminUserSession:
- *       type: object
- *       properties:
- *         id:
- *           type: string
- *         createdAt:
- *           type: string
- *           format: date-time
- *         expiresAt:
- *           type: string
- *           format: date-time
- *         ipAddress:
- *           type: string
- *           nullable: true
- *         userAgent:
- *           type: string
- *           nullable: true
- *     AdminUser:
- *       type: object
- *       properties:
- *         id:
- *           type: string
- *         email:
- *           type: string
- *         name:
- *           type: string
- *         apps:
- *           type: array
- *           items:
- *             $ref: '#/components/schemas/AdminApp'
- *         status:
- *           type: string
- *           enum: [aktiv, deaktiviert]
- *           description: Derived - there is no status column.
- *         createdAt:
- *           type: string
- *           format: date-time
- *         lastSignInAt:
- *           type: string
- *           format: date-time
- *           nullable: true
- *           description: Newest session's creation time; null once every session has expired.
- *     AdminUserDetail:
- *       allOf:
- *         - $ref: '#/components/schemas/AdminUser'
- *         - type: object
- *           properties:
- *             sessions:
- *               type: array
- *               items:
- *                 $ref: '#/components/schemas/AdminUserSession'
- *             passkeyCount:
- *               type: integer
- *     AdminInvitation:
- *       type: object
- *       description: An open invitation. The token itself is never returned by any endpoint.
- *       properties:
- *         id:
- *           type: integer
- *         email:
- *           type: string
- *         name:
- *           type: string
- *         apps:
- *           type: array
- *           items:
- *             $ref: '#/components/schemas/AdminApp'
- *         invitedBy:
- *           type: string
- *           nullable: true
- *           description: Null for the invitation created by the ADMIN_BOOTSTRAP_EMAIL bootstrap.
- *         createdAt:
- *           type: string
- *           format: date-time
- *         expiresAt:
- *           type: string
- *           format: date-time
- */
-export {};

src/models/admin/admin.mail.ts

@@ -1,124 +0,0 @@
-import {MailService} from '../../common/common.mail.js';
-import {ADMIN_APP_URL} from './admin.config.js';
-
-/**
- * The two transactional mails the admin module sends. Both go out through the
- * shared MailService (Salesforce relay, see common.mail.ts), which never throws
- * on a delivery failure - the invitation row and the reset token are already
- * committed by the time we get here.
- *
- * HTML plus a plain-text body: the text part is not a fallback afterthought,
- * it is what allowlist-based receivers and text-only clients actually show.
- */
-
-const escapeHtml = (value: string): string => {
-	return value
-		.replace(/&/g, '&')
-		.replace(/</g, '&lt;')
-		.replace(/>/g, '&gt;')
-		.replace(/"/g, '&quot;');
-};
-
-// `heading` is escaped here; `paragraphs` are not, because callers pass markup
-// (a <strong> around the expiry date) and escape their own interpolations.
-const layout = (heading: string, paragraphs: string[], buttonLabel: string, buttonUrl: string): string => {
-	const body = paragraphs.map(p => `<p style="margin:0 0 16px;">${p}</p>`).join('');
-	return `<!doctype html>
-<html lang="de">
-<body style="margin:0;padding:24px;background:#f5f5f4;font-family:Helvetica,Arial,sans-serif;color:#1c1917;">
-<div style="max-width:520px;margin:0 auto;background:#ffffff;border-radius:8px;padding:32px;">
-<h1 style="margin:0 0 24px;font-size:20px;">${escapeHtml(heading)}</h1>
-${body}
-<p style="margin:24px 0;">
-<a href="${escapeHtml(buttonUrl)}" style="display:inline-block;background:#1c1917;color:#ffffff;text-decoration:none;padding:12px 20px;border-radius:6px;">${escapeHtml(buttonLabel)}</a>
-</p>
-<p style="margin:0;font-size:13px;color:#57534e;">Falls der Button nicht funktioniert, kopiere diesen Link in deinen Browser:<br>
-<span style="word-break:break-all;">${escapeHtml(buttonUrl)}</span></p>
-</div>
-</body>
-</html>`;
-};
-
-/**
- * Invitation mail. The link carries the raw token in the query string; the
- * admin app strips it from the URL as soon as it has read it (see the plan's
- * §3b - the token must never reach an API access log or a Referer header).
- */
-export const sendInvitationMail = async (
-	recipientAddress: string,
-	name: string,
-	token: string,
-	expiresAt: Date
-): Promise<boolean> => {
-	const url = `${ADMIN_APP_URL}/accept-invite?token=${encodeURIComponent(token)}`;
-	const expiry = expiresAt.toLocaleDateString('de-DE', {day: '2-digit', month: '2-digit', year: 'numeric'});
-	const subject = 'Dein Zugang zu Nachklang';
-
-	const text = [
-		`Hallo ${name},`,
-		'',
-		'du wurdest eingeladen, ein Nachklang-Konto anzulegen. Über diesen Link vergibst du dein Passwort:',
-		'',
-		url,
-		'',
-		`Der Link ist bis zum ${expiry} gültig.`,
-		'',
-		'Wenn du damit nichts anfangen kannst, ignoriere diese E-Mail einfach.',
-		'',
-		'Viele Grüße',
-		'Nachklang e.V.'
-	].join('\n');
-
-	const html = layout(
-		`Hallo ${name},`,
-		[
-			'du wurdest eingeladen, ein Nachklang-Konto anzulegen. Über den Button vergibst du dein Passwort.',
-			`Der Link ist bis zum <strong>${escapeHtml(expiry)}</strong> gültig.`,
-			'Wenn du damit nichts anfangen kannst, ignoriere diese E-Mail einfach.'
-		],
-		'Konto einrichten',
-		url
-	);
-
-	return MailService.sendMail(recipientAddress, subject, text, {html});
-};
-
-/**
- * Password reset. better-auth builds the URL (it embeds its own token and the
- * redirectTo the admin app passed), so this only wraps it in our templates.
- */
-export const sendPasswordResetMail = async (
-	recipientAddress: string,
-	name: string,
-	url: string
-): Promise<boolean> => {
-	const subject = 'Passwort zurücksetzen';
-
-	const text = [
-		`Hallo ${name},`,
-		'',
-		'über diesen Link kannst du ein neues Passwort vergeben:',
-		'',
-		url,
-		'',
-		'Der Link ist eine Stunde gültig.',
-		'',
-		'Wenn du kein neues Passwort angefordert hast, ist nichts passiert - ignoriere diese E-Mail.',
-		'',
-		'Viele Grüße',
-		'Nachklang e.V.'
-	].join('\n');
-
-	const html = layout(
-		`Hallo ${name},`,
-		[
-			'über den Button kannst du ein neues Passwort vergeben.',
-			'Der Link ist eine Stunde gültig.',
-			'Wenn du kein neues Passwort angefordert hast, ist nichts passiert - ignoriere diese E-Mail.'
-		],
-		'Neues Passwort vergeben',
-		url
-	);
-
-	return MailService.sendMail(recipientAddress, subject, text, {html});
-};

src/models/admin/admin.middleware.ts

@@ -1,140 +0,0 @@
-import express from 'express';
-import {fromNodeHeaders} from 'better-auth/node';
-import {auth} from './admin.auth.js';
-import * as UsersService from './users/users.admin.service.js';
-import {AppName, AppPermission, AppRole} from './admin.schema.js';
-import {sendServerError} from './admin.errors.js';
-
-/**
- * The one authenticator for every admin area in this API. It replaces
- * feedback.auth.ts and tickets.auth.ts, which each re-implemented the same
- * header-session check against the calendar users table.
- *
- * Two things are checked on every request, deliberately without any caching:
- * that the session cookie is valid (better-auth), and that the user is still
- * enabled and still holds the permission for this app (one database query).
- * That is what makes "disable a user" and "revoke a session" take effect
- * immediately rather than whenever a cached session happens to expire.
- */
-
-// The shape the feedback and tickets services already expect - unchanged, so
-// nothing downstream of the authenticator needs to know this file replaced
-// their own.
-export interface AdminIdentity {
-	id: string;
-	email: string;
-	displayName: string;
-}
-
-export interface AdminAccess extends AdminIdentity {
-	disabled: boolean;
-	/** Every (app, role) grant. */
-	permissions: AppPermission[];
-	/** The distinct apps those grants cover. */
-	apps: AppName[];
-}
-
-const unauthorized = (res: express.Response): void => {
-	res.status(401).send({status: 'UNAUTHORIZED', message: 'Anmeldung erforderlich.'});
-};
-
-const forbidden = (res: express.Response, message: string): void => {
-	res.status(403).send({status: 'FORBIDDEN', message});
-};
-
-/**
- * Resolves the session cookie to a user with their permissions, or null.
- * One database query, no cache. Throws only on infrastructure errors.
- */
-export const resolveAccess = async (req: express.Request): Promise<AdminAccess | null> => {
-	const session = await auth.api.getSession({headers: fromNodeHeaders(req.headers)});
-	if (!session?.user) {
-		return null;
-	}
-
-	const access = await UsersService.loadAccess(session.user.id);
-	if (!access) {
-		return null;
-	}
-
-	return {
-		id: access.id,
-		email: access.email,
-		displayName: access.displayName,
-		disabled: access.disabled,
-		permissions: access.permissions,
-		apps: access.apps
-	};
-};
-
-/**
- * Any signed-in account, no permission required. Used by /admin/me and the
- * account-management routes: a user with no app permissions at all still has
- * to be able to see that, and to manage their own password and passkeys.
- *
- * The disabled check is not redundant with the session-create hook: that hook
- * stops a disabled user from signing in, this stops one who was disabled while
- * holding a live cookie. Disabling revokes sessions, so the window is small -
- * but "small" is not "closed".
- */
-export const requireSignedIn: express.RequestHandler = async (req, res, next) => {
-	try {
-		const access = await resolveAccess(req);
-		if (!access) {
-			unauthorized(res);
-			return;
-		}
-		if (access.disabled) {
-			forbidden(res, 'Dieses Konto ist deaktiviert.');
-			return;
-		}
-
-		res.locals.admin = access;
-		next();
-	} catch (e: any) {
-		sendServerError(res, e);
-	}
-};
-
-/**
- * The gate every admin area sits behind. `requireAppAccess('feedback')` is
- * what feedback.auth.ts's requireAdminAuth used to be, except that it now
- * answers 403 for a signed-in user without that app's permission instead of
- * letting any activated @nachklang.art account in.
- *
- * The optional second argument narrows it to one role within the app. Nothing
- * passes it today - every app has exactly the `access` role - but it is the
- * seam a finer permission arrives through.
- */
-export const requireAppAccess = (app: AppName, role?: AppRole): express.RequestHandler => {
-	return async (req, res, next) => {
-		try {
-			const access = await resolveAccess(req);
-			if (!access) {
-				unauthorized(res);
-				return;
-			}
-			if (access.disabled) {
-				forbidden(res, 'Dieses Konto ist deaktiviert.');
-				return;
-			}
-
-			// Without a role this asks "may they open this app at all?", which is
-			// any grant on it. With one it asks for that specific grant - the hook
-			// a finer permission plugs into, without touching existing call sites.
-			const allowed = role === undefined
-				? access.apps.includes(app)
-				: access.permissions.some(permission => permission.app === app && permission.role === role);
-
-			if (!allowed) {
-				forbidden(res, 'Für diesen Bereich fehlt dir die Berechtigung.');
-				return;
-			}
-
-			res.locals.admin = access;
-			next();
-		} catch (e: any) {
-			sendServerError(res, e);
-		}
-	};
-};

src/models/admin/admin.schema.ts

@@ -1,179 +0,0 @@
-import {Generated} from 'kysely';
-
-/**
- * Kysely table types for `nachklang_admin`. Only the columns this module
- * actually reads or writes are declared - better-auth owns the full shape of
- * its own tables and does not use this interface, it is here so the users and
- * invitations services get compile-time checking instead of `any`.
- *
- * Column names follow better-auth's default "camel" casing for its tables
- * (`emailVerified`, `userId`, `createdAt`); our own two tables use the
- * snake_case convention of the rest of the repo's SQL.
- */
-
-export type AppName = 'calendar' | 'feedback' | 'tickets' | 'admin';
-
-export const APP_NAMES: AppName[] = ['calendar', 'feedback', 'tickets', 'admin'];
-
-export const isAppName = (value: unknown): value is AppName => {
-	return typeof value === 'string' && (APP_NAMES as string[]).includes(value);
-};
-
-/**
- * A permission is (app, role), not just an app. Today every app has exactly one
- * role - `access`, "may use this app at all" - so the model looks like a plain
- * list of apps and the UI renders one checkbox each. It is written this way
- * anyway because the alternative gets expensive fast: `user_app_permissions`
- * has primary key (user_id, app, role), so a user can hold several roles for
- * the same app, and adding one later is a string in APP_ROLES plus rows - never
- * a schema migration and never a change to the shape on the wire.
- *
- * Note the role is deliberately NOT called `admin`, which is what the column
- * defaulted to before: on a `tickets` row that reads as "tickets administrator"
- * when it only ever meant "has access", and once real roles exist there would
- * be no way to tell the two apart.
- */
-export const ACCESS_ROLE = 'access';
-
-export type AppRole = string;
-
-/** Every role that exists, per app, in display order. Extend to add one. */
-export const APP_ROLES: Record<AppName, readonly AppRole[]> = {
-	calendar: [ACCESS_ROLE],
-	feedback: [ACCESS_ROLE],
-	tickets: [ACCESS_ROLE],
-	admin: [ACCESS_ROLE]
-};
-
-export interface AppPermission {
-	app: AppName;
-	role: AppRole;
-}
-
-export const isAppRole = (app: AppName, role: unknown): role is AppRole => {
-	return typeof role === 'string' && APP_ROLES[app].includes(role);
-};
-
-export const isAppPermission = (value: unknown): value is AppPermission => {
-	if (typeof value !== 'object' || value === null) {
-		return false;
-	}
-	const candidate = value as {app?: unknown; role?: unknown};
-	return isAppName(candidate.app) && isAppRole(candidate.app, candidate.role);
-};
-
-/**
- * Normalises whatever a caller sent into a valid, duplicate-free permission
- * list. Accepts the richer `{app, role}` form and the plain `AppName` form,
- * because `{apps: ['tickets']}` is still what the older callers send and it
- * means exactly "tickets at the access role".
- */
-export const toPermissions = (value: unknown): AppPermission[] | null => {
-	if (!Array.isArray(value)) {
-		return null;
-	}
-
-	const permissions: AppPermission[] = [];
-	for (const entry of value) {
-		if (isAppName(entry)) {
-			permissions.push({app: entry, role: ACCESS_ROLE});
-		} else if (isAppPermission(entry)) {
-			permissions.push({app: entry.app, role: entry.role});
-		} else {
-			return null;
-		}
-	}
-
-	const seen = new Set<string>();
-	return permissions.filter(permission => {
-		const key = `${permission.app}:${permission.role}`;
-		if (seen.has(key)) {
-			return false;
-		}
-		seen.add(key);
-		return true;
-	});
-};
-
-/** The distinct apps a permission list grants any access to. */
-export const appsOf = (permissions: AppPermission[]): AppName[] => {
-	return APP_NAMES.filter(app => permissions.some(permission => permission.app === app));
-};
-
-export interface UserTable {
-	id: string;
-	name: string;
-	email: string;
-	emailVerified: boolean;
-	image: string | null;
-	createdAt: Date;
-	updatedAt: Date;
-	// Added via better-auth `additionalFields` (see admin.auth.ts).
-	disabled: boolean;
-}
-
-export interface SessionTable {
-	id: string;
-	token: string;
-	userId: string;
-	expiresAt: Date;
-	createdAt: Date;
-	updatedAt: Date;
-	ipAddress: string | null;
-	userAgent: string | null;
-}
-
-export interface PasskeyTable {
-	id: string;
-	name: string | null;
-	userId: string;
-	createdAt: Date;
-}
-
-export interface UserAppPermissionTable {
-	user_id: string;
-	app: AppName;
-	role: AppRole;
-	granted_by: string | null;
-	granted_at: Generated<Date>;
-}
-
-export interface InvitationTable {
-	// AUTO_INCREMENT: present on select, never supplied on insert.
-	id: Generated<number>;
-	email: string;
-	name: string;
-	token_hash: string;
-	// JSON column holding an AppPermission[]. Older rows may hold a plain
-	// AppName[]; `parsePermissions` reads both.
-	permissions: string;
-	invited_by: string | null;
-	created_at: Generated<Date>;
-	expires_at: Date;
-	accepted_at: Date | null;
-	revoked_at: Date | null;
-}
-
-export interface VerificationTable {
-	id: string;
-	identifier: string;
-	value: string;
-	expiresAt: Date;
-}
-
-export interface RateLimitTable {
-	id: string;
-	key: string;
-	count: number;
-	lastRequest: number;
-}
-
-export interface AdminDatabase {
-	user: UserTable;
-	session: SessionTable;
-	passkey: PasskeyTable;
-	verification: VerificationTable;
-	rateLimit: RateLimitTable;
-	user_app_permissions: UserAppPermissionTable;
-	invitations: InvitationTable;
-}

src/models/admin/invitations/invitations.plugin.ts

@@ -1,196 +0,0 @@
-import * as z from 'zod';
-import {APIError, createAuthEndpoint} from 'better-auth/api';
-import {setSessionCookie} from 'better-auth/cookies';
-import {createLocalAccountIssuer} from 'better-auth/db';
-import {runWithTransaction} from '@better-auth/core/context';
-import type {BetterAuthPlugin} from 'better-auth';
-import * as InvitationsService from './invitations.service.js';
-import * as UsersService from '../users/users.admin.service.js';
-import logger from '../../../middleware/logger.js';
-
-/**
- * The two public endpoints of the invitation flow, implemented as a better-auth
- * plugin rather than as plain Express routes on the admin router.
- *
- * Why a plugin: `emailAndPassword.disableSignUp` is on, which makes
- * `auth.api.signUpEmail` refuse - deliberately, there is no public sign-up.
- * Accepting an invitation still has to create a user, hash a password, write a
- * credential account and sign the person in. All four are better-auth
- * internals reachable only from inside an endpoint's context, so this is where
- * account creation lives. Nothing outside this file may create users.
- *
- * Because they are plugin endpoints they sit under better-auth's basePath:
- *   POST /admin/auth/invitations/preview
- *   POST /admin/auth/invitations/accept
- *
- * The token travels in the request *body*, never in the path or query, so it
- * cannot end up in an access log or a Referer header.
- */
-
-// Unknown, expired, revoked and already-accepted tokens must be
-// indistinguishable to the caller: one shared error, one shared message.
-const invalidToken = (): APIError => {
-	return new APIError('BAD_REQUEST', {
-		code: 'INVALID_INVITATION',
-		message: 'Diese Einladung ist nicht mehr gültig.'
-	});
-};
-
-export const invitationsPlugin = () => {
-	return {
-		id: 'nachklang-invitations',
-		endpoints: {
-			/**
-			 * Lets the accept-invite page show who the invitation is for before
-			 * asking for a password. Returns only name and email - never the
-			 * granted apps, which is information the invitee has no need for
-			 * and an attacker with a stolen link should not get either.
-			 */
-			previewInvitation: createAuthEndpoint(
-				'/invitations/preview',
-				{
-					method: 'POST',
-					body: z.object({
-						token: z.string().min(1)
-					})
-				},
-				async ctx => {
-					const invitation = await InvitationsService.findByToken(ctx.body.token);
-					if (!invitation) {
-						throw invalidToken();
-					}
-
-					return ctx.json({email: invitation.email, name: invitation.name});
-				}
-			),
-
-			/**
-			 * Redeems the invitation: creates the user, its credential account
-			 * and its permissions, then signs the person straight in so they
-			 * land in the app instead of on a login form.
-			 */
-			acceptInvitation: createAuthEndpoint(
-				'/invitations/accept',
-				{
-					method: 'POST',
-					body: z.object({
-						token: z.string().min(1),
-						password: z.string().min(8).max(128)
-					})
-				},
-				async ctx => {
-					const invitation = await InvitationsService.findByToken(ctx.body.token);
-					if (!invitation) {
-						throw invalidToken();
-					}
-
-					// An account for this address already exists: the right fix
-					// is for an admin to grant permissions on the existing user,
-					// not to create a second one. Reported distinctly because
-					// the person holds a valid token - this leaks nothing they
-					// do not already know about their own mailbox.
-					const existing = await UsersService.findUserByEmail(invitation.email);
-					if (existing) {
-						throw new APIError('CONFLICT', {
-							code: 'USER_ALREADY_EXISTS',
-							message: 'Für diese E-Mail-Adresse gibt es bereits ein Konto. Melde dich stattdessen an.'
-						});
-					}
-
-					// Claim the invitation before creating anything. The update
-					// is conditional on it still being open, so two concurrent
-					// submissions of the same link cannot both end up creating a
-					// user.
-					const claimed = await InvitationsService.markAccepted(invitation.id);
-					if (!claimed) {
-						throw invalidToken();
-					}
-
-					// The user and its credential account go in one better-auth
-					// transaction, the way better-auth's own sign-up route does
-					// it: a half-created account with no password is not
-					// recoverable through any route this API exposes.
-					//
-					// It cannot cover everything, though. `user_app_permissions`
-					// and `invitations` are written through this module's own
-					// Kysely pool, which is a different connection, so no single
-					// transaction spans both. What follows is therefore
-					// compensated by hand rather than rolled back.
-					let user: Awaited<ReturnType<typeof ctx.context.internalAdapter.createUser>> | null = null;
-					try {
-						user = await runWithTransaction(ctx.context.adapter, async () => {
-							const created = await ctx.context.internalAdapter.createUser(
-								{
-									email: invitation.email,
-									name: invitation.name,
-									// Accepting a link sent to that mailbox *is*
-									// the proof of address ownership, so there is
-									// no separate verification mail (plan
-									// decision 15).
-									emailVerified: true,
-									disabled: false
-								},
-								{method: 'email-password'}
-							);
-
-							// Same call better-auth's own sign-up route makes,
-							// down to the synthetic issuer - a credential account
-							// written any other way is not found on sign-in.
-							await ctx.context.internalAdapter.linkAccount({
-								userId: created.id,
-								providerId: 'credential',
-								issuer: createLocalAccountIssuer('credential'),
-								accountId: created.id,
-								password: await ctx.context.password.hash(ctx.body.password)
-							});
-
-							return created;
-						});
-
-						await UsersService.setPermissions(user.id, invitation.permissions, null);
-
-						const session = await ctx.context.internalAdapter.createSession(user.id);
-						await setSessionCookie(ctx, {session, user});
-
-						return ctx.json({
-							user: {id: user.id, email: user.email, name: user.name}
-						});
-					} catch (e: any) {
-						// Undo what committed, so the invitee can use their link
-						// again instead of being stranded with a burnt token, an
-						// account they cannot sign into, and an admin who cannot
-						// re-invite them (the create route 409s on an existing
-						// user, and there is no delete route by design).
-						//
-						// Deleting the user is safe here: it was created moments
-						// ago in this request, and acceptance already established
-						// that no account for this address existed before.
-						try {
-							if (user) {
-								await ctx.context.internalAdapter.deleteUser(user.id);
-							}
-							await InvitationsService.unmarkAccepted(invitation.id);
-						} catch (compensationError: any) {
-							// Now the state really is inconsistent, and only a
-							// human can sort it out. Say so loudly and precisely.
-							logger.error('Admin: invitation acceptance failed AND its rollback failed', {
-								invitationId: invitation.id,
-								email: invitation.email,
-								userId: user?.id,
-								detail: e?.message,
-								compensationDetail: compensationError?.message
-							});
-							throw e;
-						}
-
-						logger.error('Admin: invitation acceptance failed and was rolled back', {
-							invitationId: invitation.id,
-							detail: e?.message
-						});
-						throw e;
-					}
-				}
-			)
-		}
-	} satisfies BetterAuthPlugin;
-};

src/models/admin/invitations/invitations.router.ts

@@ -1,208 +0,0 @@
-import express, {Request, Response} from 'express';
-import * as InvitationsService from './invitations.service.js';
-import * as UsersService from '../users/users.admin.service.js';
-import {toPermissions} from '../admin.schema.js';
-import {sendInvitationMail} from '../admin.mail.js';
-import {ADMIN_APP_URL, LOG_INVITE_LINKS} from '../admin.config.js';
-import {sendServerError} from '../admin.errors.js';
-import logger from '../../../middleware/logger.js';
-
-export const invitationsRouter = express.Router();
-
-/**
- * The admin-facing half of invitations (create, resend, revoke). The public
- * half - preview and accept - lives in invitations.plugin.ts, because
- * redeeming an invitation has to create a user through better-auth internals.
- *
- * Mounted behind requireAppAccess('admin').
- */
-
-const EMAIL_PATTERN = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
-
-/**
- * With the mail relay off (the normal local setup) the invitation mail never
- * arrives, and only the token's hash is stored, so there would be no way to
- * walk through the accept flow. Logging the link closes that.
- *
- * Gated on an explicit opt-in rather than on NODE_ENV: the link is a live
- * account-creation credential, and "not production" is too weak a condition to
- * hang that on. See LOG_INVITE_LINKS in admin.config.ts.
- */
-const logInviteLinkInDev = (token: string): void => {
-	if (LOG_INVITE_LINKS) {
-		logger.info(`Admin: invitation link ${ADMIN_APP_URL}/accept-invite?token=${encodeURIComponent(token)}`);
-	}
-};
-
-/**
- * @swagger
- * /admin/invitations:
- *      get:
- *          summary: List open (unaccepted, unrevoked, unexpired) invitations
- *          tags: [admin]
- *          responses:
- *              200:
- *                  description: Success
- */
-invitationsRouter.get('/', async (req: Request, res: Response) => {
-	try {
-		res.status(200).send(await InvitationsService.listOpenInvitations());
-	} catch (e: any) {
-		sendServerError(res, e);
-	}
-});
-
-/**
- * @swagger
- * /admin/invitations:
- *      post:
- *          summary: Invite someone and mail them an acceptance link
- *          tags: [admin]
- *          requestBody:
- *              required: true
- *              content:
- *                  application/json:
- *                      schema:
- *                          type: object
- *                          required: [email, name, permissions]
- *                          properties:
- *                              email:
- *                                  type: string
- *                              name:
- *                                  type: string
- *                              permissions:
- *                                  type: array
- *                                  description: >
- *                                      One entry per (app, role). A plain array of app names is
- *                                      accepted too and means the same at the `access` role.
- *                                  items:
- *                                      type: object
- *                                      properties:
- *                                          app:
- *                                              type: string
- *                                          role:
- *                                              type: string
- *          responses:
- *              201:
- *                  description: Invitation created and mailed
- *              400:
- *                  description: Invalid input
- *              409:
- *                  description: A user with this address already exists
- */
-invitationsRouter.post('/', async (req: Request, res: Response) => {
-	try {
-		const email = String(req.body?.email || '').trim().toLowerCase();
-		const name = String(req.body?.name || '').trim();
-
-		// Same two accepted shapes as PUT /admin/users/:id/permissions.
-		const permissions = toPermissions(req.body?.permissions ?? req.body?.apps);
-
-		if (!EMAIL_PATTERN.test(email) || name.length === 0 || !permissions) {
-			res.status(400).send({
-				status: 'BAD_REQUEST',
-				message: 'E-Mail, Name und Berechtigungen sind erforderlich.'
-			});
-			return;
-		}
-
-		// Inviting someone who already has an account would strand them on an
-		// accept page that can only fail. Granting permissions on the existing
-		// user is the operation they actually want.
-		if (await UsersService.findUserByEmail(email)) {
-			res.status(409).send({
-				status: 'CONFLICT',
-				message: 'Für diese E-Mail-Adresse gibt es bereits ein Konto. Vergib dort die Berechtigungen.'
-			});
-			return;
-		}
-
-		const invitation = await InvitationsService.createInvitation(
-			email,
-			name,
-			permissions,
-			res.locals.admin.id
-		);
-
-		const mailed = await sendInvitationMail(email, name, invitation.token, invitation.expiresAt);
-		if (!mailed) {
-			logger.warn('Admin: invitation created but the mail was not accepted', {email});
-		}
-		logInviteLinkInDev(invitation.token);
-
-		res.status(201).send({id: invitation.id, email, name, expiresAt: invitation.expiresAt, mailed});
-	} catch (e: any) {
-		sendServerError(res, e);
-	}
-});
-
-/**
- * @swagger
- * /admin/invitations/{invitationId}/resend:
- *      post:
- *          summary: Issue a new token for an open invitation and mail it again
- *          description: The previous link stops working.
- *          tags: [admin]
- *          responses:
- *              200:
- *                  description: Resent
- *              404:
- *                  description: No open invitation with this id
- */
-invitationsRouter.post('/:invitationId/resend', async (req: Request, res: Response) => {
-	try {
-		const invitationId = parseInt(req.params.invitationId, 10);
-		if (Number.isNaN(invitationId)) {
-			res.status(400).send({status: 'BAD_REQUEST', message: 'Ungültige Einladungs-ID.'});
-			return;
-		}
-
-		const resent = await InvitationsService.resendInvitation(invitationId);
-		if (!resent) {
-			res.status(404).send({status: 'NOT_FOUND', message: 'Einladung nicht gefunden.'});
-			return;
-		}
-
-		const mailed = await sendInvitationMail(resent.email, resent.name, resent.token, resent.expiresAt);
-		if (!mailed) {
-			logger.warn('Admin: invitation resent but the mail was not accepted', {email: resent.email});
-		}
-		logInviteLinkInDev(resent.token);
-
-		res.status(200).send({id: invitationId, expiresAt: resent.expiresAt, mailed});
-	} catch (e: any) {
-		sendServerError(res, e);
-	}
-});
-
-/**
- * @swagger
- * /admin/invitations/{invitationId}:
- *      delete:
- *          summary: Revoke an open invitation
- *          tags: [admin]
- *          responses:
- *              204:
- *                  description: Revoked
- *              404:
- *                  description: No open invitation with this id
- */
-invitationsRouter.delete('/:invitationId', async (req: Request, res: Response) => {
-	try {
-		const invitationId = parseInt(req.params.invitationId, 10);
-		if (Number.isNaN(invitationId)) {
-			res.status(400).send({status: 'BAD_REQUEST', message: 'Ungültige Einladungs-ID.'});
-			return;
-		}
-
-		const revoked = await InvitationsService.revokeInvitation(invitationId);
-		if (!revoked) {
-			res.status(404).send({status: 'NOT_FOUND', message: 'Einladung nicht gefunden.'});
-			return;
-		}
-
-		res.status(204).send();
-	} catch (e: any) {
-		sendServerError(res, e);
-	}
-});

src/models/admin/invitations/invitations.service.ts

@@ -1,239 +0,0 @@
-import * as crypto from 'crypto';
-import {NachklangAdminDB} from '../Admin.db.js';
-import {AppPermission, isAppName, isAppPermission, ACCESS_ROLE} from '../admin.schema.js';
-
-const db = NachklangAdminDB.db;
-
-/**
- * Invitations are this API's only path to a new account (there is no public
- * sign-up). The raw token exists exactly twice: in the mail we send and in the
- * request body when it comes back. What we store is its SHA-256 hash, so a
- * database dump does not hand out account access - the same reasoning as the
- * calendar module's session key hashing, and the reason lookups go through
- * `findByToken` rather than any query on a plaintext column.
- */
-
-export const INVITATION_TTL_DAYS = 7;
-
-export interface OpenInvitation {
-	id: number;
-	email: string;
-	name: string;
-	permissions: AppPermission[];
-	invitedBy: string | null;
-	createdAt: Date;
-	expiresAt: Date;
-}
-
-export interface AcceptableInvitation {
-	id: number;
-	email: string;
-	name: string;
-	permissions: AppPermission[];
-}
-
-const hashToken = (token: string): string => {
-	return crypto.createHash('sha256').update(token).digest('hex');
-};
-
-const generateToken = (): string => {
-	// 32 bytes, url-safe: it travels in a mail link's query string.
-	return crypto.randomBytes(32).toString('base64url');
-};
-
-/**
- * Reads the stored permission list. Two shapes are accepted: the current
- * `[{app, role}]`, and a bare `['tickets', ...]` from before roles existed,
- * which means the same thing at the `access` role. Invitations live for seven
- * days, so a deploy that changes the shape has in-flight rows in the old one -
- * tolerating both is what stops those invitees from being stranded.
- *
- * mysql2 hands back a JSON column already parsed; a driver or column-type
- * change that turns it into a string must not break the read path either.
- */
-const parsePermissions = (value: unknown): AppPermission[] => {
-	const raw = typeof value === 'string' ? JSON.parse(value) : value;
-	if (!Array.isArray(raw)) {
-		return [];
-	}
-
-	return raw.flatMap((entry): AppPermission[] => {
-		if (isAppName(entry)) {
-			return [{app: entry, role: ACCESS_ROLE}];
-		}
-		return isAppPermission(entry) ? [{app: entry.app, role: entry.role}] : [];
-	});
-};
-
-const expiryFromNow = (): Date => {
-	return new Date(Date.now() + INVITATION_TTL_DAYS * 24 * 60 * 60 * 1000);
-};
-
-/**
- * Creates an invitation and returns the raw token for the mail. Any earlier
- * open invitation for the same address is revoked first: two valid links for
- * one mailbox is a needless second live credential, and "resend" would
- * otherwise quietly accumulate them.
- */
-export const createInvitation = async (
-	email: string,
-	name: string,
-	permissions: AppPermission[],
-	invitedBy: string | null
-): Promise<{id: number; token: string; expiresAt: Date}> => {
-	const token = generateToken();
-	const expiresAt = expiryFromNow();
-	const valid = permissions.filter(isAppPermission);
-
-	const id = await db.transaction().execute(async trx => {
-		await trx
-			.updateTable('invitations')
-			.set({revoked_at: new Date()})
-			.where('email', '=', email)
-			.where('accepted_at', 'is', null)
-			.where('revoked_at', 'is', null)
-			.execute();
-
-		const result = await trx
-			.insertInto('invitations')
-			.values({
-				email,
-				name,
-				token_hash: hashToken(token),
-				permissions: JSON.stringify(valid),
-				invited_by: invitedBy,
-				created_at: new Date(),
-				expires_at: expiresAt
-			})
-			.executeTakeFirst();
-
-		return Number(result.insertId);
-	});
-
-	return {id, token, expiresAt};
-};
-
-/**
- * Looks up a still-usable invitation by raw token. Callers must not
- * distinguish "unknown", "expired", "revoked" and "already accepted" to the
- * client: all four answer with the same shape, so a stranger cannot probe which
- * tokens ever existed.
- */
-export const findByToken = async (token: string): Promise<AcceptableInvitation | null> => {
-	const row = await db
-		.selectFrom('invitations')
-		.select(['id', 'email', 'name', 'permissions'])
-		.where('token_hash', '=', hashToken(token))
-		.where('accepted_at', 'is', null)
-		.where('revoked_at', 'is', null)
-		.where('expires_at', '>', new Date())
-		.executeTakeFirst();
-
-	if (!row) {
-		return null;
-	}
-
-	return {id: row.id, email: row.email, name: row.name, permissions: parsePermissions(row.permissions)};
-};
-
-/** Marks the invitation accepted. Conditional on it still being open so two
- *  concurrent accepts of the same link cannot both create an account. */
-export const markAccepted = async (invitationId: number): Promise<boolean> => {
-	const result = await db
-		.updateTable('invitations')
-		.set({accepted_at: new Date()})
-		.where('id', '=', invitationId)
-		.where('accepted_at', 'is', null)
-		.where('revoked_at', 'is', null)
-		.executeTakeFirst();
-
-	return Number(result.numUpdatedRows) > 0;
-};
-
-/**
- * Reverses markAccepted. Used only to compensate a failed acceptance: the user
- * could not be created, so the link must become usable again rather than
- * stranding the invitee with a burnt token and no account.
- */
-export const unmarkAccepted = async (invitationId: number): Promise<void> => {
-	await db
-		.updateTable('invitations')
-		.set({accepted_at: null})
-		.where('id', '=', invitationId)
-		.execute();
-};
-
-export const listOpenInvitations = async (): Promise<OpenInvitation[]> => {
-	const rows = await db
-		.selectFrom('invitations')
-		.select(['id', 'email', 'name', 'permissions', 'invited_by', 'created_at', 'expires_at'])
-		.where('accepted_at', 'is', null)
-		.where('revoked_at', 'is', null)
-		.where('expires_at', '>', new Date())
-		.orderBy('created_at', 'desc')
-		.execute();
-
-	return rows.map(row => ({
-		id: row.id,
-		email: row.email,
-		name: row.name,
-		permissions: parsePermissions(row.permissions),
-		invitedBy: row.invited_by,
-		createdAt: row.created_at,
-		expiresAt: row.expires_at
-	}));
-};
-
-export const getOpenInvitation = async (invitationId: number): Promise<OpenInvitation | null> => {
-	const all = await listOpenInvitations();
-	return all.find(invitation => invitation.id === invitationId) ?? null;
-};
-
-/** Resend issues a *new* token and expiry and invalidates the old one, rather
- *  than re-mailing the existing link: if the first mail leaked, resending it
- *  would extend the leak's lifetime. */
-export const resendInvitation = async (
-	invitationId: number
-): Promise<{token: string; email: string; name: string; expiresAt: Date} | null> => {
-	const invitation = await getOpenInvitation(invitationId);
-	if (!invitation) {
-		return null;
-	}
-
-	const token = generateToken();
-	const expiresAt = expiryFromNow();
-
-	await db
-		.updateTable('invitations')
-		.set({token_hash: hashToken(token), expires_at: expiresAt, created_at: new Date()})
-		.where('id', '=', invitationId)
-		.execute();
-
-	return {token, email: invitation.email, name: invitation.name, expiresAt};
-};
-
-export const revokeInvitation = async (invitationId: number): Promise<boolean> => {
-	const result = await db
-		.updateTable('invitations')
-		.set({revoked_at: new Date()})
-		.where('id', '=', invitationId)
-		.where('accepted_at', 'is', null)
-		.where('revoked_at', 'is', null)
-		.executeTakeFirst();
-
-	return Number(result.numUpdatedRows) > 0;
-};
-
-/** Used by the bootstrap to stay idempotent across restarts. */
-export const hasOpenInvitationFor = async (email: string): Promise<boolean> => {
-	const row = await db
-		.selectFrom('invitations')
-		.select('id')
-		.where('email', '=', email)
-		.where('accepted_at', 'is', null)
-		.where('revoked_at', 'is', null)
-		.where('expires_at', '>', new Date())
-		.executeTakeFirst();
-
-	return Boolean(row);
-};

src/models/admin/users/users.admin.router.ts

@@ -1,247 +0,0 @@
-import express, {Request, Response} from 'express';
-import * as UsersService from './users.admin.service.js';
-import {toPermissions} from '../admin.schema.js';
-import {sendServerError} from '../admin.errors.js';
-
-export const usersAdminRouter = express.Router();
-
-/**
- * User administration. Mounted behind requireAppAccess('admin'), so every
- * handler here can assume res.locals.admin is an admin.
- *
- * The guards below exist because this API can lock its own operators out: the
- * only way to grant a permission is through these routes, so an admin who
- * removes the last `admin` permission leaves nobody who can put it back short
- * of a manual SQL statement in production.
- */
-
-const conflict = (res: Response, message: string): void => {
-	res.status(409).send({status: 'CONFLICT', message});
-};
-
-const notFound = (res: Response): void => {
-	res.status(404).send({status: 'NOT_FOUND', message: 'Benutzer nicht gefunden.'});
-};
-
-/**
- * @swagger
- * /admin/users:
- *      get:
- *          summary: List all users with their app permissions and status
- *          tags: [admin]
- *          responses:
- *              200:
- *                  description: Success
- *              401:
- *                  description: Not signed in
- *              403:
- *                  description: Missing the admin permission
- */
-usersAdminRouter.get('/', async (req: Request, res: Response) => {
-	try {
-		res.status(200).send(await UsersService.listUsers());
-	} catch (e: any) {
-		sendServerError(res, e);
-	}
-});
-
-/**
- * @swagger
- * /admin/users/{userId}:
- *      get:
- *          summary: One user with their active sessions and passkey count
- *          tags: [admin]
- *          parameters:
- *              - in: path
- *                name: userId
- *                required: true
- *                schema:
- *                    type: string
- *          responses:
- *              200:
- *                  description: Success
- *              404:
- *                  description: Unknown user
- */
-usersAdminRouter.get('/:userId', async (req: Request, res: Response) => {
-	try {
-		const detail = await UsersService.getUserDetail(req.params.userId);
-		if (!detail) {
-			notFound(res);
-			return;
-		}
-		res.status(200).send(detail);
-	} catch (e: any) {
-		sendServerError(res, e);
-	}
-});
-
-/**
- * @swagger
- * /admin/users/{userId}/permissions:
- *      put:
- *          summary: Replace a user's app permissions
- *          description: Refuses to remove the caller's own admin permission or the last remaining active admin.
- *          tags: [admin]
- *          requestBody:
- *              required: true
- *              content:
- *                  application/json:
- *                      schema:
- *                          type: object
- *                          properties:
- *                              permissions:
- *                                  type: array
- *                                  description: >
- *                                      One entry per (app, role). `access` is the only role today.
- *                                      A plain array of app names is also accepted and means the
- *                                      same at the `access` role.
- *                                  items:
- *                                      type: object
- *                                      properties:
- *                                          app:
- *                                              type: string
- *                                              enum: [calendar, feedback, tickets, admin]
- *                                          role:
- *                                              type: string
- *                                              enum: [access]
- *          responses:
- *              200:
- *                  description: Success
- *              400:
- *                  description: Invalid app or role
- *              409:
- *                  description: Would lock the last admin out
- */
-usersAdminRouter.put('/:userId/permissions', async (req: Request, res: Response) => {
-	try {
-		const userId = req.params.userId;
-
-		// `permissions: [{app, role}]` is the real shape; `apps: ['tickets']` is
-		// accepted as shorthand for the same thing at the `access` role, so a
-		// caller that predates roles keeps working.
-		const permissions = toPermissions(req.body?.permissions ?? req.body?.apps);
-
-		if (!permissions) {
-			res.status(400).send({status: 'BAD_REQUEST', message: 'Ungültige Berechtigungsliste.'});
-			return;
-		}
-
-		if (!(await UsersService.userExists(userId))) {
-			notFound(res);
-			return;
-		}
-
-		const target = await UsersService.loadAccess(userId);
-		const keepsAdmin = permissions.some(permission => permission.app === 'admin');
-		const losesAdmin = Boolean(target?.apps.includes('admin')) && !keepsAdmin;
-
-		// Self-lockout is checked here because it needs the caller's identity,
-		// which the service has no business knowing. The last-admin check is
-		// NOT done here: it has to be inside the write transaction to survive
-		// two admins acting at the same time (see setPermissionsGuarded).
-		if (losesAdmin && userId === res.locals.admin.id) {
-			conflict(res, 'Du kannst dir die Admin-Berechtigung nicht selbst entziehen.');
-			return;
-		}
-
-		const result = await UsersService.setPermissionsGuarded(userId, permissions, res.locals.admin.id);
-		if (result === 'last-admin') {
-			conflict(res, 'Die letzte Admin-Berechtigung kann nicht entzogen werden.');
-			return;
-		}
-
-		res.status(200).send(await UsersService.getUserDetail(userId));
-	} catch (e: any) {
-		sendServerError(res, e);
-	}
-});
-
-/**
- * @swagger
- * /admin/users/{userId}/disable:
- *      post:
- *          summary: Disable a user and revoke all of their sessions
- *          tags: [admin]
- *          responses:
- *              200:
- *                  description: Success
- *              409:
- *                  description: Would disable the caller or the last admin
- */
-usersAdminRouter.post('/:userId/disable', async (req: Request, res: Response) => {
-	try {
-		const userId = req.params.userId;
-
-		if (userId === res.locals.admin.id) {
-			conflict(res, 'Du kannst dich nicht selbst deaktivieren.');
-			return;
-		}
-
-		const target = await UsersService.loadAccess(userId);
-		if (!target) {
-			notFound(res);
-			return;
-		}
-
-		const result = await UsersService.disableUserGuarded(userId);
-		if (result === 'last-admin') {
-			conflict(res, 'Der letzte aktive Admin kann nicht deaktiviert werden.');
-			return;
-		}
-
-		res.status(200).send(await UsersService.getUserDetail(userId));
-	} catch (e: any) {
-		sendServerError(res, e);
-	}
-});
-
-/**
- * @swagger
- * /admin/users/{userId}/enable:
- *      post:
- *          summary: Re-enable a disabled user
- *          description: Does not restore sessions - the user signs in again.
- *          tags: [admin]
- *          responses:
- *              200:
- *                  description: Success
- */
-usersAdminRouter.post('/:userId/enable', async (req: Request, res: Response) => {
-	try {
-		if (!(await UsersService.userExists(req.params.userId))) {
-			notFound(res);
-			return;
-		}
-
-		await UsersService.enableUser(req.params.userId);
-		res.status(200).send(await UsersService.getUserDetail(req.params.userId));
-	} catch (e: any) {
-		sendServerError(res, e);
-	}
-});
-
-/**
- * @swagger
- * /admin/users/{userId}/sessions/{sessionId}:
- *      delete:
- *          summary: Revoke one session of a user
- *          tags: [admin]
- *          responses:
- *              204:
- *                  description: Revoked
- *              404:
- *                  description: Unknown session for this user
- */
-usersAdminRouter.delete('/:userId/sessions/:sessionId', async (req: Request, res: Response) => {
-	try {
-		const revoked = await UsersService.revokeSession(req.params.userId, req.params.sessionId);
-		if (!revoked) {
-			res.status(404).send({status: 'NOT_FOUND', message: 'Sitzung nicht gefunden.'});
-			return;
-		}
-		res.status(204).send();
-	} catch (e: any) {
-		sendServerError(res, e);
-	}
-});

src/models/admin/users/users.admin.service.ts

@@ -1,439 +0,0 @@
-import {Transaction} from 'kysely';
-import {NachklangAdminDB} from '../Admin.db.js';
-import {
-	AdminDatabase,
-	AppName,
-	AppPermission,
-	AppRole,
-	ACCESS_ROLE,
-	appsOf,
-	isAppName,
-	isAppRole
-} from '../admin.schema.js';
-
-const db = NachklangAdminDB.db;
-
-/**
- * Everything that reads or writes permissions. Two callers with very different
- * hot-path requirements share this file: admin.middleware.ts runs
- * `loadAccess` on *every* admin-authenticated request (which is why it is one
- * query joining `user.disabled` and the permission rows - see the plan's
- * decision to run without better-auth's cookieCache), and the /admin/users
- * routes run the rest.
- */
-
-export interface UserAccess {
-	id: string;
-	email: string;
-	displayName: string;
-	disabled: boolean;
-	/** Every (app, role) grant this user holds. */
-	permissions: AppPermission[];
-	/** The distinct apps the above grants any access to. Derived, kept because
-	 *  most callers only ever ask "may they open this app at all?". */
-	apps: AppName[];
-}
-
-export type UserStatus = 'aktiv' | 'deaktiviert';
-
-export interface UserListEntry {
-	id: string;
-	email: string;
-	name: string;
-	permissions: AppPermission[];
-	apps: AppName[];
-	status: UserStatus;
-	createdAt: Date;
-	lastSignInAt: Date | null;
-}
-
-export interface UserSessionEntry {
-	id: string;
-	createdAt: Date;
-	expiresAt: Date;
-	ipAddress: string | null;
-	userAgent: string | null;
-}
-
-export interface UserDetail extends UserListEntry {
-	sessions: UserSessionEntry[];
-	passkeyCount: number;
-}
-
-/**
- * The single per-request lookup behind requireAppAccess. Returns null when the
- * user row is gone; `disabled` is returned rather than filtered so the
- * middleware can answer 403 (account deactivated) instead of a misleading 401.
- */
-export const loadAccess = async (userId: string): Promise<UserAccess | null> => {
-	const rows = await db
-		.selectFrom('user')
-		.leftJoin('user_app_permissions', 'user_app_permissions.user_id', 'user.id')
-		.where('user.id', '=', userId)
-		.select([
-			'user.id as id',
-			'user.email as email',
-			'user.name as name',
-			'user.disabled as disabled',
-			'user_app_permissions.app as app',
-			'user_app_permissions.role as role'
-		])
-		.execute();
-
-	if (rows.length === 0) {
-		return null;
-	}
-
-	const permissions = toPermissionRows(rows);
-
-	return {
-		id: rows[0].id,
-		email: rows[0].email,
-		displayName: rows[0].name,
-		// MySQL TINYINT(1) comes back as 0/1 through mysql2.
-		disabled: Boolean(rows[0].disabled),
-		permissions,
-		apps: appsOf(permissions)
-	};
-};
-
-/**
- * Turns joined permission rows into AppPermission[]. The left join produces one
- * row with a null app for a user who holds nothing, and a role written directly
- * into the database that no longer appears in APP_ROLES is dropped rather than
- * trusted - the table is the store, APP_ROLES is the contract.
- */
-const toPermissionRows = (rows: {app: AppName | null; role: string | null}[]): AppPermission[] => {
-	return rows
-		.filter((row): row is {app: AppName; role: string} =>
-			isAppName(row.app) && isAppRole(row.app, row.role))
-		.map(row => ({app: row.app, role: row.role}));
-};
-
-export const listUsers = async (): Promise<UserListEntry[]> => {
-	const users = await db
-		.selectFrom('user')
-		.select(['id', 'email', 'name', 'disabled', 'createdAt'])
-		.orderBy('name', 'asc')
-		.execute();
-
-	const permissions = await db
-		.selectFrom('user_app_permissions')
-		.select(['user_id', 'app', 'role'])
-		.execute();
-
-	// Last sign-in is derived from the newest session rather than stored: a
-	// session row is created on every sign-in and we never update its
-	// createdAt, so max(createdAt) is exactly that, with no extra column to
-	// keep in sync.
-	//
-	// The expiry filter must match getUserDetail's. better-auth only deletes an
-	// expired session when someone actually presents it, so expired rows linger
-	// - without this, the list would report a last sign-in for someone the
-	// detail view shows as never having signed in.
-	const lastSessions = await db
-		.selectFrom('session')
-		.where('expiresAt', '>', new Date())
-		.select(({fn}) => ['userId', fn.max('createdAt').as('lastSignInAt')])
-		.groupBy('userId')
-		.execute();
-
-	const permissionsByUser = new Map<string, AppPermission[]>();
-	for (const row of permissions) {
-		if (!isAppRole(row.app, row.role)) {
-			continue;
-		}
-		const held = permissionsByUser.get(row.user_id) || [];
-		held.push({app: row.app, role: row.role});
-		permissionsByUser.set(row.user_id, held);
-	}
-
-	const lastSignInByUser = new Map<string, Date | null>(
-		lastSessions.map(row => [row.userId, row.lastSignInAt as Date | null])
-	);
-
-	return users.map(user => {
-		const held = permissionsByUser.get(user.id) || [];
-		return {
-			id: user.id,
-			email: user.email,
-			name: user.name,
-			permissions: held,
-			apps: appsOf(held),
-			status: user.disabled ? ('deaktiviert' as const) : ('aktiv' as const),
-			createdAt: user.createdAt,
-			lastSignInAt: lastSignInByUser.get(user.id) ?? null
-		};
-	});
-};
-
-export const getUserDetail = async (userId: string): Promise<UserDetail | null> => {
-	const user = await db
-		.selectFrom('user')
-		.select(['id', 'email', 'name', 'disabled', 'createdAt'])
-		.where('id', '=', userId)
-		.executeTakeFirst();
-
-	if (!user) {
-		return null;
-	}
-
-	const [permissions, sessions, passkeys] = await Promise.all([
-		db
-			.selectFrom('user_app_permissions')
-			.select(['app', 'role'])
-			.where('user_id', '=', userId)
-			.execute(),
-		db
-			.selectFrom('session')
-			.select(['id', 'createdAt', 'expiresAt', 'ipAddress', 'userAgent'])
-			.where('userId', '=', userId)
-			.where('expiresAt', '>', new Date())
-			.orderBy('createdAt', 'desc')
-			.execute(),
-		db
-			.selectFrom('passkey')
-			.select(({fn}) => fn.countAll<number>().as('count'))
-			.where('userId', '=', userId)
-			.executeTakeFirst()
-	]);
-
-	const held = toPermissionRows(permissions);
-
-	return {
-		id: user.id,
-		email: user.email,
-		name: user.name,
-		permissions: held,
-		apps: appsOf(held),
-		status: user.disabled ? 'deaktiviert' : 'aktiv',
-		createdAt: user.createdAt,
-		lastSignInAt: sessions.length > 0 ? sessions[0].createdAt : null,
-		sessions,
-		passkeyCount: Number(passkeys?.count ?? 0)
-	};
-};
-
-/**
- * Replaces a user's permission set. Written as delete-then-insert inside one
- * transaction rather than a diff: the set is at most four rows, and a diff
- * would only add branches for no measurable gain.
- */
-
-/** The rows a permission list becomes. One row per (app, role). */
-const permissionRows = (
-	userId: string,
-	permissions: AppPermission[],
-	grantedBy: string | null
-) => {
-	return permissions.map(permission => ({
-		user_id: userId,
-		app: permission.app,
-		role: permission.role,
-		granted_by: grantedBy,
-		granted_at: new Date()
-	}));
-};
-
-/** Drops anything not in APP_ROLES and de-duplicates on (app, role). */
-const validPermissions = (permissions: AppPermission[]): AppPermission[] => {
-	const seen = new Set<string>();
-	return permissions.filter(permission => {
-		if (!isAppName(permission.app) || !isAppRole(permission.app, permission.role)) {
-			return false;
-		}
-		const key = `${permission.app}:${permission.role}`;
-		if (seen.has(key)) {
-			return false;
-		}
-		seen.add(key);
-		return true;
-	});
-};
-
-export const setPermissions = async (
-	userId: string,
-	permissions: AppPermission[],
-	grantedBy: string | null
-): Promise<void> => {
-	const valid = validPermissions(permissions);
-
-	await db.transaction().execute(async trx => {
-		await trx.deleteFrom('user_app_permissions').where('user_id', '=', userId).execute();
-		if (valid.length > 0) {
-			await trx
-				.insertInto('user_app_permissions')
-				.values(permissionRows(userId, valid, grantedBy))
-				.execute();
-		}
-	});
-};
-
-/**
- * Why the guards live down here rather than in the router: they are
- * check-then-act, and the check has to happen inside the same transaction as
- * the write, over locked rows. Two admins each removing the other's `admin`
- * permission at the same moment would otherwise both read a count of 2, both
- * pass, and both commit - leaving nobody who can administer anything, with
- * ADMIN_BOOTSTRAP_EMAIL at the next restart as the only way back in.
- *
- * `SELECT ... FOR UPDATE` makes the second transaction wait and re-read the
- * count the first one just changed.
- */
-export type LastAdminGuardResult = 'ok' | 'last-admin';
-
-const countActiveAdminsForUpdate = async (trx: Transaction<AdminDatabase>): Promise<number> => {
-	const row = await trx
-		.selectFrom('user_app_permissions')
-		.innerJoin('user', 'user.id', 'user_app_permissions.user_id')
-		.where('user_app_permissions.app', '=', 'admin')
-		.where('user.disabled', '=', false)
-		// countDistinct, not countAll: with (user_id, app, role) as the key one
-		// user can hold several roles on `admin`, and counting rows would make a
-		// single admin with two roles look like two admins - defeating the guard
-		// at exactly the moment it matters.
-		.select(({fn}) => fn.count<number>('user_app_permissions.user_id').distinct().as('count'))
-		.forUpdate()
-		.executeTakeFirst();
-
-	return Number(row?.count ?? 0);
-};
-
-/**
- * Replaces a user's permissions, refusing to remove the last active admin.
- * Returns 'last-admin' instead of throwing so the router can answer 409.
- */
-export const setPermissionsGuarded = async (
-	userId: string,
-	permissions: AppPermission[],
-	grantedBy: string | null
-): Promise<LastAdminGuardResult> => {
-	const valid = validPermissions(permissions);
-	const keepsAdmin = valid.some(permission => permission.app === 'admin');
-
-	return db.transaction().execute(async trx => {
-		const target = await trx
-			.selectFrom('user_app_permissions')
-			.innerJoin('user', 'user.id', 'user_app_permissions.user_id')
-			.where('user_app_permissions.user_id', '=', userId)
-			.where('user_app_permissions.app', '=', 'admin')
-			.select(['user.disabled as disabled'])
-			.limit(1)
-			.forUpdate()
-			.executeTakeFirst();
-
-		const losesAdmin = Boolean(target) && !keepsAdmin;
-		if (losesAdmin && !target?.disabled && (await countActiveAdminsForUpdate(trx)) <= 1) {
-			return 'last-admin';
-		}
-
-		await trx.deleteFrom('user_app_permissions').where('user_id', '=', userId).execute();
-		if (valid.length > 0) {
-			await trx
-				.insertInto('user_app_permissions')
-				.values(permissionRows(userId, valid, grantedBy))
-				.execute();
-		}
-
-		return 'ok';
-	});
-};
-
-/**
- * Disables a user and revokes every session, refusing to disable the last
- * active admin. Same locking rationale as setPermissionsGuarded.
- */
-export const disableUserGuarded = async (userId: string): Promise<LastAdminGuardResult> => {
-	return db.transaction().execute(async trx => {
-		const isAdmin = await trx
-			.selectFrom('user_app_permissions')
-			.innerJoin('user', 'user.id', 'user_app_permissions.user_id')
-			.where('user_app_permissions.user_id', '=', userId)
-			.where('user_app_permissions.app', '=', 'admin')
-			.where('user.disabled', '=', false)
-			.select('user_app_permissions.user_id')
-			.limit(1)
-			.forUpdate()
-			.executeTakeFirst();
-
-		if (isAdmin && (await countActiveAdminsForUpdate(trx)) <= 1) {
-			return 'last-admin';
-		}
-
-		await trx.updateTable('user').set({disabled: true}).where('id', '=', userId).execute();
-		await trx.deleteFrom('session').where('userId', '=', userId).execute();
-
-		return 'ok';
-	});
-};
-
-export const grantPermission = async (
-	userId: string,
-	app: AppName,
-	grantedBy: string | null,
-	role: AppRole = ACCESS_ROLE
-): Promise<void> => {
-	await db
-		.insertInto('user_app_permissions')
-		.values({user_id: userId, app, role, granted_by: grantedBy, granted_at: new Date()})
-		// The row already existing is the success case - this is "make sure they
-		// hold it", not "re-grant it" - so nothing is overwritten and granted_by
-		// keeps naming whoever granted it first.
-		.onDuplicateKeyUpdate({role})
-		.execute();
-};
-
-/** Disabling revokes every session: a disabled user must lose access now, not
- *  when their 30-day cookie happens to expire. */
-export const disableUser = async (userId: string): Promise<void> => {
-	await db.transaction().execute(async trx => {
-		await trx.updateTable('user').set({disabled: true}).where('id', '=', userId).execute();
-		await trx.deleteFrom('session').where('userId', '=', userId).execute();
-	});
-};
-
-export const enableUser = async (userId: string): Promise<void> => {
-	await db.updateTable('user').set({disabled: false}).where('id', '=', userId).execute();
-};
-
-export const revokeSession = async (userId: string, sessionId: string): Promise<boolean> => {
-	const result = await db
-		.deleteFrom('session')
-		.where('id', '=', sessionId)
-		.where('userId', '=', userId)
-		.executeTakeFirst();
-
-	return Number(result.numDeletedRows) > 0;
-};
-
-/**
- * Guard input for the self-lockout rules: how many enabled users still hold the
- * `admin` permission. Disabled admins do not count - they cannot sign in, so
- * leaving only disabled admins is the same lockout as leaving none.
- */
-export const countActiveAdmins = async (): Promise<number> => {
-	const row = await db
-		.selectFrom('user_app_permissions')
-		.innerJoin('user', 'user.id', 'user_app_permissions.user_id')
-		.where('user_app_permissions.app', '=', 'admin')
-		.where('user.disabled', '=', false)
-		.select(({fn}) => fn.countAll<number>().as('count'))
-		.executeTakeFirst();
-
-	return Number(row?.count ?? 0);
-};
-
-export const userExists = async (userId: string): Promise<boolean> => {
-	const row = await db.selectFrom('user').select('id').where('id', '=', userId).executeTakeFirst();
-	return Boolean(row);
-};
-
-export const findUserByEmail = async (email: string): Promise<{id: string; email: string} | null> => {
-	const row = await db
-		.selectFrom('user')
-		.select(['id', 'email'])
-		.where('email', '=', email)
-		.executeTakeFirst();
-
-	return row ?? null;
-};

src/models/calendar/Calendar.db.ts

@@ -1,5 +1,6 @@
 import * as dotenv from 'dotenv';
-import mariadb from 'mariadb';
+
+const mariadb = require('mariadb');
 
 dotenv.config();
 
@@ -9,7 +10,8 @@ export namespace NachklangCalendarDB {
 		user: process.env.DB_USER,
 		password: process.env.DB_PASSWORD,
 		database: process.env.CALENDAR_DB,
-		connectionLimit: 5
+		connectionLimit: 5,
+		autoCommit: false
 	});
 
 	export const getConnection = async () => {

src/models/calendar/Calendar.router.ts

@@ -3,9 +3,9 @@
  */
 import express, {Request, Response} from 'express';
 import {Guid} from 'guid-typescript';
-import logger from '../../middleware/logger.js';
+import logger from '../../middleware/logger';
-import {eventsRouter} from './events/events.router.js';
+import {eventsRouter} from './events/events.router';
-import {usersRouter} from './users/users.router.js';
+import {usersRouter} from './users/users.router';
 
 /**
  * Router Definition

src/models/calendar/events/credentials.service.ts

@@ -1,5 +1,5 @@
 import * as dotenv from 'dotenv';
-import * as UserService from '../users/users.service.js';
+import * as UserService from '../users/users.service';
 
 
 dotenv.config();

src/models/calendar/events/event.interface.ts

@@ -70,9 +70,9 @@
  *           description: The ID of the user who created the event
  *           example: 456
  *         lastModifiedBy:
- *           type: string
+ *         	 type: string
- *           description: The name of the user who last modified the event
+ *         	 description: The name of the user who last modified the event
- *           example: "John Doe"
+ *         	 example: "John Doe"
  *         lastModifiedById:
  *           type: integer
  *           description: The ID of the user who last modified the event

src/models/calendar/events/events.router.ts

@@ -3,13 +3,13 @@
  */
 
 import express, {Request, Response} from 'express';
-import {Event} from './event.interface.js';
+import {Event} from './event.interface';
-import * as EventService from './events.service.js';
+import * as EventService from './events.service';
-import * as iCalService from './icalgenerator.service.js';
+import * as iCalService from './icalgenerator.service';
-import * as CredentialService from './credentials.service.js';
+import * as CredentialService from './credentials.service';
-import * as UserService from '../users/users.service.js';
+import * as UserService from '../users/users.service';
 import {Guid} from 'guid-typescript';
-import logger from '../../../middleware/logger.js';
+import logger from '../../../middleware/logger';
 
 
 /**

src/models/calendar/events/events.service.ts

@@ -1,7 +1,7 @@
 import * as dotenv from 'dotenv';
 import {Guid} from 'guid-typescript';
-import {Event} from './event.interface.js';
+import {Event} from './event.interface';
-import {NachklangCalendarDB} from '../Calendar.db.js';
+import {NachklangCalendarDB} from '../Calendar.db';
 
 
 dotenv.config();
@@ -126,64 +126,6 @@ export const getAllEventsAdmin = async (calendarId: number): Promise<Event[]> =>
 	}
 };
 
-/**
- * Returns a single event by id (latest version, any status), or null if it
- * doesn't exist. Unlike getAllEvents/getAllEventsAdmin this isn't scoped to
- * a calendar - callers that need to enforce calendar/status visibility
- * should check the returned event's calendarId/status themselves.
- * @param eventId The event id
- */
-export const getEventById = async (eventId: number): Promise<Event | null> => {
-	let conn = await NachklangCalendarDB.getConnection();
-	try {
-		const eventsQuery = `
-		SELECT e.calendar_id, e.uuid, e.created_date, e.created_by_id, u.full_name as created_by_name, u2.full_name as last_modified_by_name, v.* FROM events e
-			INNER JOIN (
-  				SELECT event_id, MAX(event_version_id) AS latest_version
-			  	FROM event_versions
-			  	GROUP BY event_id
-			) latest_versions
-			ON e.event_id = latest_versions.event_id
-			INNER JOIN event_versions v
-			ON v.event_id = latest_versions.event_id AND v.event_version_id = latest_versions.latest_version
-			LEFT OUTER JOIN users u ON u.user_id = e.created_by_id
-		    LEFT OUTER JOIN users u2 ON u2.user_id = v.version_created_by_id
-			WHERE e.event_id = ?`;
-		const eventsRes = await conn.query(eventsQuery, eventId);
-
-		if (eventsRes.length === 0) {
-			return null;
-		}
-
-		const row = eventsRes[0];
-		return {
-			eventId: row.event_id,
-			calendarId: row.calendar_id,
-			uuid: row.uuid,
-			name: row.name,
-			description: row.description,
-			startDateTime: row.start_datetime,
-			endDateTime: row.end_datetime,
-			createdDate: row.created_date,
-			lastModifiedDate: row.version_created_at,
-			location: row.location,
-			createdBy: row.created_by_name,
-			createdById: row.created_by_id,
-			lastModifiedBy: row.last_modified_by_name,
-			lastModifiedById: row.version_created_by_id,
-			url: row.url,
-			wholeDay: row.whole_day,
-            repeatFrequency: row.repeat_frequency,
-			status: row.status
-		} as Event;
-	} catch (err) {
-		throw err;
-	} finally {
-		// Return connection
-		await conn.end();
-	}
-};
-
 /**
  * Create the given event in the database
  * @param event The event to create

src/models/calendar/events/icalgenerator.service.ts

@@ -1,4 +1,4 @@
-import {Event} from './event.interface.js';
+import {Event} from './event.interface';
 
 /**
  * Interface to external classes - Turns the given events into an ical string

src/models/calendar/users/users.router.ts

@@ -3,11 +3,11 @@
  */
 
 import express, {Request, Response} from 'express';
-import * as UserService from './users.service.js';
+import * as UserService from './users.service';
-import {Session} from './session.interface.js';
+import {Session} from './session.interface';
-import {User} from './user.interface.js';
+import {User} from './user.interface';
 import {Guid} from 'guid-typescript';
-import logger from '../../../middleware/logger.js';
+import logger from '../../../middleware/logger';
 
 /**
  * Router Definition

src/models/calendar/users/users.service.ts

@@ -1,10 +1,10 @@
 import * as dotenv from 'dotenv';
-import bcrypt from 'bcrypt';
+import * as bcrypt from 'bcrypt';
 import {Guid} from 'guid-typescript';
-import {User} from './user.interface.js';
+import {User} from './user.interface';
-import {Session} from './session.interface.js';
+import {Session} from './session.interface';
-import {NachklangCalendarDB} from '../Calendar.db.js';
+import {NachklangCalendarDB} from '../Calendar.db';
-import {MailService} from '../../../common/common.mail.js';
+import {MailService} from "../../../common/common.mail.nodemailer";
 
 dotenv.config();
 
@@ -54,10 +54,7 @@ export const createUser = async (email: string, password: string, fullName: stri
 			sessionId = row.session_id;
 		}
 
-		// Send email with activation link (after commit so we don't block on email
+		// Send email with activation link (after commit so we don't block on email delivery)
-		// delivery). sendMail never throws on a delivery failure - it logs and
-		// returns false - so a mail-server problem here can't roll back the
-		// already-committed user and leave registration reporting a false error.
 		await MailService.sendMail(email, 'Activate your Nachklang account', `Hi ${fullName},\n\nPlease click on the following link to activate your account:\n\nhttps://api.nachklang.art/calendar/users/activate?id=${userId}&token=${activationToken}`);
 
 		return {

src/models/feedback/Feedback.db.ts

@@ -1,5 +1,6 @@
 import * as dotenv from 'dotenv';
-import mariadb from 'mariadb';
+
+const mariadb = require('mariadb');
 
 dotenv.config();
 
@@ -9,7 +10,8 @@ export namespace NachklangFeedbackDB {
 		user: process.env.DB_USER,
 		password: process.env.DB_PASSWORD,
 		database: process.env.FEEDBACK_DB,
-		connectionLimit: 5
+		connectionLimit: 5,
+		autoCommit: false
 	});
 
 	export const getConnection = async () => {

src/models/feedback/Feedback.router.ts

@@ -2,9 +2,9 @@
  * Required External Modules and Interfaces
  */
 import express, {Request, Response} from 'express';
-import {publicRouter} from './public/public.router.js';
+import {publicRouter} from './public/public.router';
-import {adminRouter} from './admin/admin.router.js';
+import {adminRouter} from './admin/admin.router';
-import {sendServerError} from './feedback.errors.js';
+import {sendServerError} from './feedback.errors';
 
 /**
  * Router Definition

src/models/feedback/admin/admin.interface.ts

@@ -1,6 +1,19 @@
 /**
  * @swagger
  * components:
+ *   parameters:
+ *     SessionIdHeader:
+ *       in: header
+ *       name: X-Session-Id
+ *       required: true
+ *       schema:
+ *         type: string
+ *     SessionKeyHeader:
+ *       in: header
+ *       name: X-Session-Key
+ *       required: true
+ *       schema:
+ *         type: string
  *   schemas:
  *     EventAdminSummary:
  *       type: object
@@ -68,7 +81,7 @@
  *           type: boolean
  */
 
-import {QuestionType, Song} from '../feedback.interface.js';
+import {QuestionType, Song} from '../feedback.interface';
 
 export interface EventAdminSummary {
 	eventId: number;

src/models/feedback/admin/admin.router.ts

@@ -2,13 +2,13 @@
  * Required External Modules and Interfaces
  */
 import express, {Request, Response} from 'express';
-import {requireAdminAuth} from '../feedback.auth.js';
+import {requireAdminAuth} from '../feedback.auth';
-import {sendServerError} from '../feedback.errors.js';
+import {sendServerError} from '../feedback.errors';
-import {eventsAdminRouter} from './events.admin.router.js';
+import {eventsAdminRouter} from './events.admin.router';
-import {songsAdminRouter} from './songs.admin.router.js';
+import {songsAdminRouter} from './songs.admin.router';
-import {questionsAdminRouter} from './questions.admin.router.js';
+import {questionsAdminRouter} from './questions.admin.router';
-import {reportsAdminRouter} from './reports.admin.router.js';
+import {reportsAdminRouter} from './reports.admin.router';
-import * as ReportsAdminService from './reports.admin.service.js';
+import * as ReportsAdminService from './reports.admin.service';
 
 /**
  * Router Definition
@@ -26,8 +26,9 @@ adminRouter.use(requireAdminAuth);
  *          summary: Validate the current admin session
  *          description: Used by the Next.js middleware/proxy to gate /admin. Returns the authenticated admin's identity.
  *          tags: [feedback-admin]
- *          security:
+ *          parameters:
- *              - AdminSessionCookie: []
+ *              - $ref: '#/components/parameters/SessionIdHeader'
+ *              - $ref: '#/components/parameters/SessionKeyHeader'
  *          responses:
  *              200:
  *                  description: Success
@@ -42,8 +43,6 @@ adminRouter.use(requireAdminAuth);
  *                                      type: string
  *              401:
  *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
  */
 adminRouter.get('/me', (req: Request, res: Response) => {
 	res.status(200).send({email: res.locals.admin.email, fullName: res.locals.admin.displayName});
@@ -56,9 +55,9 @@ adminRouter.get('/me', (req: Request, res: Response) => {
  *          summary: Delete a single submission
  *          description: Removes the submission and everything under it (its answers, guest book entry, newsletter signup) - for removing an individual abusive or inappropriate entry. Not a bulk moderation tool.
  *          tags: [feedback-admin]
- *          security:
- *              - AdminSessionCookie: []
  *          parameters:
+ *              - $ref: '#/components/parameters/SessionIdHeader'
+ *              - $ref: '#/components/parameters/SessionKeyHeader'
  *              - in: path
  *                name: submissionId
  *                required: true
@@ -71,8 +70,6 @@ adminRouter.get('/me', (req: Request, res: Response) => {
  *                  description: Unknown submission
  *              401:
  *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
  */
 adminRouter.delete('/submissions/:submissionId', async (req: Request, res: Response) => {
 	try {

src/models/feedback/admin/csv.service.ts

@@ -1,5 +1,5 @@
-import {NachklangFeedbackDB} from '../Feedback.db.js';
+import {NachklangFeedbackDB} from '../Feedback.db';
-import {formatDatetime} from '../feedback.dates.js';
+import {formatDatetime} from '../feedback.dates';
 
 const CSV_SEPARATOR = ';';
 const UTF8_BOM = '';

src/models/feedback/admin/events.admin.router.ts

@@ -2,9 +2,9 @@
  * Required External Modules and Interfaces
  */
 import express, {Request, Response} from 'express';
-import * as EventsAdminService from './events.admin.service.js';
+import * as EventsAdminService from './events.admin.service';
-import * as SongsAdminService from './songs.admin.service.js';
+import * as SongsAdminService from './songs.admin.service';
-import {sendServerError} from '../feedback.errors.js';
+import {sendServerError} from '../feedback.errors';
 
 /**
  * Router Definition
@@ -18,8 +18,9 @@ export const eventsAdminRouter = express.Router();
  *          summary: List all events (admin)
  *          description: All events, published or not, past or future, with submission counts.
  *          tags: [feedback-admin]
- *          security:
+ *          parameters:
- *              - AdminSessionCookie: []
+ *              - $ref: '#/components/parameters/SessionIdHeader'
+ *              - $ref: '#/components/parameters/SessionKeyHeader'
  *          responses:
  *              200:
  *                  description: Success
@@ -31,14 +32,13 @@ export const eventsAdminRouter = express.Router();
  *                                  $ref: '#/components/schemas/EventAdminSummary'
  *              401:
  *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
  *      post:
  *          summary: Create an event
  *          description: Auto-generates the slug from the name and event year; defaults feedback_deadline to event_date + 14 days 23:59:59 unless supplied.
  *          tags: [feedback-admin]
- *          security:
+ *          parameters:
- *              - AdminSessionCookie: []
+ *              - $ref: '#/components/parameters/SessionIdHeader'
+ *              - $ref: '#/components/parameters/SessionKeyHeader'
  *          requestBody:
  *              required: true
  *              content:
@@ -68,8 +68,6 @@ export const eventsAdminRouter = express.Router();
  *                  description: Missing required fields
  *              401:
  *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
  */
 eventsAdminRouter.get('/', async (req: Request, res: Response) => {
 	try {
@@ -103,9 +101,9 @@ eventsAdminRouter.post('/', async (req: Request, res: Response) => {
  *          summary: Get one event (admin)
  *          description: Full event detail including setlist and assigned questions.
  *          tags: [feedback-admin]
- *          security:
- *              - AdminSessionCookie: []
  *          parameters:
+ *              - $ref: '#/components/parameters/SessionIdHeader'
+ *              - $ref: '#/components/parameters/SessionKeyHeader'
  *              - in: path
  *                name: eventId
  *                required: true
@@ -122,14 +120,12 @@ eventsAdminRouter.post('/', async (req: Request, res: Response) => {
  *                  description: Unknown event
  *              401:
  *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
  *      put:
  *          summary: Update an event
  *          tags: [feedback-admin]
- *          security:
- *              - AdminSessionCookie: []
  *          parameters:
+ *              - $ref: '#/components/parameters/SessionIdHeader'
+ *              - $ref: '#/components/parameters/SessionKeyHeader'
  *              - in: path
  *                name: eventId
  *                required: true
@@ -142,15 +138,13 @@ eventsAdminRouter.post('/', async (req: Request, res: Response) => {
  *                  description: Unknown event
  *              401:
  *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
  *      delete:
  *          summary: Delete an event
  *          description: Refuses with 409 if submissions exist unless ?force=true is passed.
  *          tags: [feedback-admin]
- *          security:
- *              - AdminSessionCookie: []
  *          parameters:
+ *              - $ref: '#/components/parameters/SessionIdHeader'
+ *              - $ref: '#/components/parameters/SessionKeyHeader'
  *              - in: path
  *                name: eventId
  *                required: true
@@ -169,8 +163,6 @@ eventsAdminRouter.post('/', async (req: Request, res: Response) => {
  *                  description: Submissions exist and force was not set
  *              401:
  *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
  */
 eventsAdminRouter.get('/:eventId', async (req: Request, res: Response) => {
 	try {
@@ -222,9 +214,9 @@ eventsAdminRouter.delete('/:eventId', async (req: Request, res: Response) => {
  *      get:
  *          summary: Get an event's setlist
  *          tags: [feedback-admin]
- *          security:
- *              - AdminSessionCookie: []
  *          parameters:
+ *              - $ref: '#/components/parameters/SessionIdHeader'
+ *              - $ref: '#/components/parameters/SessionKeyHeader'
  *              - in: path
  *                name: eventId
  *                required: true
@@ -235,14 +227,12 @@ eventsAdminRouter.delete('/:eventId', async (req: Request, res: Response) => {
  *                  description: Success
  *              401:
  *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
  *      post:
  *          summary: Add a song to an event's setlist
  *          tags: [feedback-admin]
- *          security:
- *              - AdminSessionCookie: []
  *          parameters:
+ *              - $ref: '#/components/parameters/SessionIdHeader'
+ *              - $ref: '#/components/parameters/SessionKeyHeader'
  *              - in: path
  *                name: eventId
  *                required: true
@@ -267,8 +257,6 @@ eventsAdminRouter.delete('/:eventId', async (req: Request, res: Response) => {
  *                  description: Missing title
  *              401:
  *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
  */
 eventsAdminRouter.get('/:eventId/songs', async (req: Request, res: Response) => {
 	try {
@@ -304,9 +292,9 @@ eventsAdminRouter.post('/:eventId/songs', async (req: Request, res: Response) =>
  *          summary: Bulk reorder an event's setlist
  *          description: Rewrites song positions as a dense 0..n-1 sequence in one transaction.
  *          tags: [feedback-admin]
- *          security:
- *              - AdminSessionCookie: []
  *          parameters:
+ *              - $ref: '#/components/parameters/SessionIdHeader'
+ *              - $ref: '#/components/parameters/SessionKeyHeader'
  *              - in: path
  *                name: eventId
  *                required: true
@@ -329,8 +317,6 @@ eventsAdminRouter.post('/:eventId/songs', async (req: Request, res: Response) =>
  *                  description: Reordered
  *              401:
  *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
  */
 eventsAdminRouter.put('/:eventId/songs/order', async (req: Request, res: Response) => {
 	try {
@@ -348,9 +334,9 @@ eventsAdminRouter.put('/:eventId/songs/order', async (req: Request, res: Respons
  *      get:
  *          summary: Get an event's assigned questions
  *          tags: [feedback-admin]
- *          security:
- *              - AdminSessionCookie: []
  *          parameters:
+ *              - $ref: '#/components/parameters/SessionIdHeader'
+ *              - $ref: '#/components/parameters/SessionKeyHeader'
  *              - in: path
  *                name: eventId
  *                required: true
@@ -361,15 +347,13 @@ eventsAdminRouter.put('/:eventId/songs/order', async (req: Request, res: Respons
  *                  description: Success
  *              401:
  *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
  *      put:
  *          summary: Bulk-set an event's assigned questions
  *          description: One transaction - inserts new, updates existing, deletes removed. Keeps the admin UI a simple save-the-whole-list form.
  *          tags: [feedback-admin]
- *          security:
- *              - AdminSessionCookie: []
  *          parameters:
+ *              - $ref: '#/components/parameters/SessionIdHeader'
+ *              - $ref: '#/components/parameters/SessionKeyHeader'
  *              - in: path
  *                name: eventId
  *                required: true
@@ -399,8 +383,6 @@ eventsAdminRouter.put('/:eventId/songs/order', async (req: Request, res: Respons
  *                  description: Saved
  *              401:
  *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
  */
 eventsAdminRouter.get('/:eventId/questions', async (req: Request, res: Response) => {
 	try {

src/models/feedback/admin/events.admin.service.ts

@@ -1,7 +1,7 @@
-import {NachklangFeedbackDB} from '../Feedback.db.js';
+import {NachklangFeedbackDB} from '../Feedback.db';
-import {Song} from '../feedback.interface.js';
+import {Song} from '../feedback.interface';
-import {CreateEventInput, EventAdminDetail, EventAdminQuestionAssignment, EventAdminSummary, UpdateEventInput} from './admin.interface.js';
+import {CreateEventInput, EventAdminDetail, EventAdminQuestionAssignment, EventAdminSummary, UpdateEventInput} from './admin.interface';
-import {formatDatetime} from '../feedback.dates.js';
+import {formatDatetime} from '../feedback.dates';
 
 const UMLAUT_MAP: Record<string, string> = {
 	'ä': 'ae', 'ö': 'oe', 'ü': 'ue', 'ß': 'ss',

src/models/feedback/admin/questions.admin.router.ts

@@ -2,8 +2,8 @@
  * Required External Modules and Interfaces
  */
 import express, {Request, Response} from 'express';
-import * as QuestionsAdminService from './questions.admin.service.js';
+import * as QuestionsAdminService from './questions.admin.service';
-import {sendServerError} from '../feedback.errors.js';
+import {sendServerError} from '../feedback.errors';
 
 /**
  * Router Definition
@@ -16,9 +16,9 @@ export const questionsAdminRouter = express.Router();
  *      get:
  *          summary: List the question library
  *          tags: [feedback-admin]
- *          security:
- *              - AdminSessionCookie: []
  *          parameters:
+ *              - $ref: '#/components/parameters/SessionIdHeader'
+ *              - $ref: '#/components/parameters/SessionKeyHeader'
  *              - in: query
  *                name: includeArchived
  *                schema:
@@ -34,13 +34,12 @@ export const questionsAdminRouter = express.Router();
  *                                  $ref: '#/components/schemas/AdminQuestion'
  *              401:
  *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
  *      post:
  *          summary: Create a question
  *          tags: [feedback-admin]
- *          security:
+ *          parameters:
- *              - AdminSessionCookie: []
+ *              - $ref: '#/components/parameters/SessionIdHeader'
+ *              - $ref: '#/components/parameters/SessionKeyHeader'
  *          requestBody:
  *              required: true
  *              content:
@@ -62,8 +61,6 @@ export const questionsAdminRouter = express.Router();
  *                  description: Missing or invalid fields
  *              401:
  *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
  */
 questionsAdminRouter.get('/', async (req: Request, res: Response) => {
 	try {
@@ -97,9 +94,9 @@ questionsAdminRouter.post('/', async (req: Request, res: Response) => {
  *          summary: Edit a question's label/help text
  *          description: question_type is immutable after creation - the admin UI offers "archive and create new" instead.
  *          tags: [feedback-admin]
- *          security:
- *              - AdminSessionCookie: []
  *          parameters:
+ *              - $ref: '#/components/parameters/SessionIdHeader'
+ *              - $ref: '#/components/parameters/SessionKeyHeader'
  *              - in: path
  *                name: questionId
  *                required: true
@@ -126,15 +123,13 @@ questionsAdminRouter.post('/', async (req: Request, res: Response) => {
  *                  description: Unknown question
  *              401:
  *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
  *      delete:
  *          summary: Archive (or hard-delete) a question
  *          description: Archives the question if it has ever been used; hard-deletes it if it has never been assigned to any event.
  *          tags: [feedback-admin]
- *          security:
- *              - AdminSessionCookie: []
  *          parameters:
+ *              - $ref: '#/components/parameters/SessionIdHeader'
+ *              - $ref: '#/components/parameters/SessionKeyHeader'
  *              - in: path
  *                name: questionId
  *                required: true
@@ -147,8 +142,6 @@ questionsAdminRouter.post('/', async (req: Request, res: Response) => {
  *                  description: Unknown question
  *              401:
  *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
  */
 questionsAdminRouter.put('/:questionId', async (req: Request, res: Response) => {
 	try {

src/models/feedback/admin/questions.admin.service.ts

@@ -1,6 +1,6 @@
-import {NachklangFeedbackDB} from '../Feedback.db.js';
+import {NachklangFeedbackDB} from '../Feedback.db';
-import {QuestionType} from '../feedback.interface.js';
+import {QuestionType} from '../feedback.interface';
-import {AdminQuestion} from './admin.interface.js';
+import {AdminQuestion} from './admin.interface';
 
 const mapRow = (row: any): AdminQuestion => ({
 	questionId: row.question_id,

src/models/feedback/admin/reports.admin.interface.ts

@@ -1,4 +1,4 @@
-import {QuestionType} from '../feedback.interface.js';
+import {QuestionType} from '../feedback.interface';
 
 export interface SongPickResult {
 	songId: number;

src/models/feedback/admin/reports.admin.router.ts

@@ -2,10 +2,10 @@
  * Required External Modules and Interfaces
  */
 import express, {Request, Response} from 'express';
-import * as ReportsAdminService from './reports.admin.service.js';
+import * as ReportsAdminService from './reports.admin.service';
-import * as CsvService from './csv.service.js';
+import * as CsvService from './csv.service';
-import * as EventsAdminService from './events.admin.service.js';
+import * as EventsAdminService from './events.admin.service';
-import {sendServerError} from '../feedback.errors.js';
+import {sendServerError} from '../feedback.errors';
 
 /**
  * Router Definition
@@ -19,9 +19,9 @@ export const reportsAdminRouter = express.Router();
  *          summary: Aggregated feedback report for one event
  *          description: Song-pick vote counts, song-rating averages, capped free-text list, guest book count, and newsletter sync counts.
  *          tags: [feedback-admin]
- *          security:
- *              - AdminSessionCookie: []
  *          parameters:
+ *              - $ref: '#/components/parameters/SessionIdHeader'
+ *              - $ref: '#/components/parameters/SessionKeyHeader'
  *              - in: path
  *                name: eventId
  *                required: true
@@ -34,8 +34,6 @@ export const reportsAdminRouter = express.Router();
  *                  description: Unknown event
  *              401:
  *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
  */
 reportsAdminRouter.get('/:eventId/report', async (req: Request, res: Response) => {
 	try {
@@ -57,9 +55,9 @@ reportsAdminRouter.get('/:eventId/report', async (req: Request, res: Response) =
  *          summary: Guest Book entries for one event
  *          description: Newest first, paginated.
  *          tags: [feedback-admin]
- *          security:
- *              - AdminSessionCookie: []
  *          parameters:
+ *              - $ref: '#/components/parameters/SessionIdHeader'
+ *              - $ref: '#/components/parameters/SessionKeyHeader'
  *              - in: path
  *                name: eventId
  *                required: true
@@ -83,8 +81,6 @@ reportsAdminRouter.get('/:eventId/report', async (req: Request, res: Response) =
  *                  description: Success
  *              401:
  *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
  */
 reportsAdminRouter.get('/:eventId/guestbook', async (req: Request, res: Response) => {
 	try {
@@ -105,9 +101,9 @@ reportsAdminRouter.get('/:eventId/guestbook', async (req: Request, res: Response
  *          summary: Newsletter signups for one event
  *          description: Includes sync_status, so failures can be handled manually. Newest first, paginated.
  *          tags: [feedback-admin]
- *          security:
- *              - AdminSessionCookie: []
  *          parameters:
+ *              - $ref: '#/components/parameters/SessionIdHeader'
+ *              - $ref: '#/components/parameters/SessionKeyHeader'
  *              - in: path
  *                name: eventId
  *                required: true
@@ -131,8 +127,6 @@ reportsAdminRouter.get('/:eventId/guestbook', async (req: Request, res: Response
  *                  description: Success
  *              401:
  *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
  */
 reportsAdminRouter.get('/:eventId/newsletter', async (req: Request, res: Response) => {
 	try {
@@ -153,9 +147,9 @@ reportsAdminRouter.get('/:eventId/newsletter', async (req: Request, res: Respons
  *          summary: CSV export of all answers for one event
  *          description: Long format, one row per answer. UTF-8 BOM, `;` separator, RFC 4180 escaping, formula-injection guard.
  *          tags: [feedback-admin]
- *          security:
- *              - AdminSessionCookie: []
  *          parameters:
+ *              - $ref: '#/components/parameters/SessionIdHeader'
+ *              - $ref: '#/components/parameters/SessionKeyHeader'
  *              - in: path
  *                name: eventId
  *                required: true
@@ -168,8 +162,6 @@ reportsAdminRouter.get('/:eventId/newsletter', async (req: Request, res: Respons
  *                      text/csv: {}
  *              401:
  *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
  */
 reportsAdminRouter.get('/:eventId/export/responses.csv', async (req: Request, res: Response) => {
 	try {
@@ -195,9 +187,9 @@ reportsAdminRouter.get('/:eventId/export/responses.csv', async (req: Request, re
  *      get:
  *          summary: CSV export of Guest Book entries for one event
  *          tags: [feedback-admin]
- *          security:
- *              - AdminSessionCookie: []
  *          parameters:
+ *              - $ref: '#/components/parameters/SessionIdHeader'
+ *              - $ref: '#/components/parameters/SessionKeyHeader'
  *              - in: path
  *                name: eventId
  *                required: true
@@ -210,8 +202,6 @@ reportsAdminRouter.get('/:eventId/export/responses.csv', async (req: Request, re
  *                      text/csv: {}
  *              401:
  *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
  */
 reportsAdminRouter.get('/:eventId/export/guestbook.csv', async (req: Request, res: Response) => {
 	try {

src/models/feedback/admin/reports.admin.service.ts

@@ -1,7 +1,7 @@
-import {NachklangFeedbackDB} from '../Feedback.db.js';
+import {NachklangFeedbackDB} from '../Feedback.db';
 import {
 	AnswerRow, EventReport, FreeTextReport, SongPickReport, SongRatingReport
-} from './reports.admin.interface.js';
+} from './reports.admin.interface';
 
 const FREE_TEXT_CAP = 500;
 

src/models/feedback/admin/songs.admin.router.ts

@@ -2,8 +2,8 @@
  * Required External Modules and Interfaces
  */
 import express, {Request, Response} from 'express';
-import * as SongsAdminService from './songs.admin.service.js';
+import * as SongsAdminService from './songs.admin.service';
-import {sendServerError} from '../feedback.errors.js';
+import {sendServerError} from '../feedback.errors';
 
 /**
  * Router Definition
@@ -16,9 +16,9 @@ export const songsAdminRouter = express.Router();
  *      put:
  *          summary: Edit a song's title/composer
  *          tags: [feedback-admin]
- *          security:
- *              - AdminSessionCookie: []
  *          parameters:
+ *              - $ref: '#/components/parameters/SessionIdHeader'
+ *              - $ref: '#/components/parameters/SessionKeyHeader'
  *              - in: path
  *                name: songId
  *                required: true
@@ -45,15 +45,13 @@ export const songsAdminRouter = express.Router();
  *                  description: Unknown song
  *              401:
  *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
  *      delete:
  *          summary: Remove a song
  *          description: Past answers keep their song_title_snapshot even after the song is removed.
  *          tags: [feedback-admin]
- *          security:
- *              - AdminSessionCookie: []
  *          parameters:
+ *              - $ref: '#/components/parameters/SessionIdHeader'
+ *              - $ref: '#/components/parameters/SessionKeyHeader'
  *              - in: path
  *                name: songId
  *                required: true
@@ -66,8 +64,6 @@ export const songsAdminRouter = express.Router();
  *                  description: Unknown song
  *              401:
  *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
  */
 songsAdminRouter.put('/:songId', async (req: Request, res: Response) => {
 	try {

src/models/feedback/admin/songs.admin.service.ts

@@ -1,4 +1,4 @@
-import {NachklangFeedbackDB} from '../Feedback.db.js';
+import {NachklangFeedbackDB} from '../Feedback.db';
 
 export const addSong = async (eventId: number, title: string, composer: string | null): Promise<number> => {
 	let conn = await NachklangFeedbackDB.getConnection();

src/models/feedback/feedback.auth.ts

@@ -1,38 +1,78 @@
-import {requireAppAccess} from '../admin/admin.middleware.js';
+import express from 'express';
+import * as UserService from '../calendar/users/users.service';
+import {sendServerError} from './feedback.errors';
 
 /**
  * This file is the ONLY place in the feedback module that knows how admin
- * authentication works. No route handler and no service outside this file may
+ * authentication works today. No route handler and no service outside this
- * read session headers or resolve a user itself.
+ * file may import users.service, read session headers, or touch bcrypt.
  *
- * Today: the shared admin identity in `src/models/admin/`. A session cookie
+ * Today: reuses the existing Calendar users/sessions mechanism. Any
- * set by /admin/auth on admin.nachklang.art, plus a `feedback` permission on
+ * activated @nachklang.art account may administer feedback — no roles.
- * the account. Both are re-checked on every request, so disabling a user or
+ * Migrating to Keycloak later means writing a keycloakJwtAuthenticator
- * taking their feedback permission away takes effect immediately.
+ * below and changing the one `activeAuthenticator` binding (plus the
+ * frontend's login route handler) — nothing else in the feedback module
+ * needs to change.
  *
- * Before 2026-09-06 this was a header session against the calendar users
+ * Explicitly forbidden: accepting sessionId/sessionKey from query
- * table, and any activated @nachklang.art account could administer feedback.
+ * parameters, even "temporarily". That is the exact mistake documented in
- * That is why the swap is a one-line binding: everything downstream only ever
+ * DEFERRED_SECURITY.md item 1 for the Calendar domain, where credentials
- * saw `requireAdminAuth` and `res.locals.admin`, and both still mean what
+ * end up in access logs, browser history, proxy logs, and Referer headers.
- * they meant. What changed is that access is now granted per user rather than
+ * Headers only.
- * implied by having an account.
- *
- * Explicitly forbidden: accepting session credentials from query parameters,
- * even "temporarily". That is the exact mistake documented in
- * DEFERRED_SECURITY.md item 1 for the Calendar domain, where credentials end
- * up in access logs, browser history, proxy logs, and Referer headers.
  */
 
-// The only thing the rest of the feedback module knows about an admin. The
+// The only thing the rest of the feedback module knows about an admin.
-// shared middleware puts a superset of this on res.locals.admin.
 export interface AdminIdentity {
 	id: string;
 	email: string;
 	displayName: string;
 }
 
+// Pluggable strategy: extract + verify credentials from a request.
+// Returns the identity, or null if unauthenticated. Throws only on
+// infrastructure errors (e.g. the DB being unreachable).
+export type AdminAuthenticator = (req: express.Request) => Promise<AdminIdentity | null>;
+
+// Current implementation: reads X-Session-Id / X-Session-Key headers,
+// delegates to the existing calendar UserService.checkSession(...).
+export const sessionHeaderAuthenticator: AdminAuthenticator = async (req) => {
+	const sessionId = req.header('X-Session-Id');
+	const sessionKey = req.header('X-Session-Key');
+	if (!sessionId || !sessionKey) {
+		return null;
+	}
+
+	const ip = req.ip || '';
+	const user = await UserService.checkSession(sessionId, sessionKey, ip);
+
+	// Mirrors the Calendar domain's own convention: a valid session on an
+	// inactive (not yet activated) account is not sufficient.
+	if (!user || !user.isActive) {
+		return null;
+	}
+
+	return {
+		id: String(user.userId),
+		email: user.email,
+		displayName: user.fullName
+	};
+};
+
+// Swap point: change this one binding to migrate to Keycloak.
+export const activeAuthenticator: AdminAuthenticator = sessionHeaderAuthenticator;
+
 // Express middleware used by every admin route. On success:
-// res.locals.admin = AdminAccess (an AdminIdentity plus permissions), calls
+// res.locals.admin = AdminIdentity, calls next(). On failure: 401.
-// next(). On failure: 401 when not signed in, 403 when signed in without the
+export const requireAdminAuth: express.RequestHandler = async (req, res, next) => {
-// feedback permission.
+	try {
-export const requireAdminAuth = requireAppAccess('feedback');
+		const identity = await activeAuthenticator(req);
+		if (!identity) {
+			res.status(401).send({status: 'UNAUTHORIZED', message: 'Anmeldung erforderlich.'});
+			return;
+		}
+		res.locals.admin = identity;
+		next();
+	} catch (e: any) {
+		sendServerError(res, e);
+	}
+};

src/models/feedback/feedback.errors.ts

@@ -1,6 +1,6 @@
 import {Response} from 'express';
 import {Guid} from 'guid-typescript';
-import logger from '../../middleware/logger.js';
+import logger from '../../middleware/logger';
 
 /**
  * The feedback module's standard catch-block response: log with a

src/models/feedback/feedback.ratelimit.ts

@@ -1,6 +1,6 @@
 import * as crypto from 'crypto';
 import * as dotenv from 'dotenv';
-import {NachklangFeedbackDB} from './Feedback.db.js';
+import {NachklangFeedbackDB} from './Feedback.db';
 
 dotenv.config();
 

src/models/feedback/integrations/salesforce.service.ts

@@ -1,6 +1,6 @@
-import {NachklangFeedbackDB} from '../Feedback.db.js';
+import axios from 'axios';
-import logger from '../../../middleware/logger.js';
+import {NachklangFeedbackDB} from '../Feedback.db';
-import {salesforceApexRestPost} from '../../../common/salesforce.client.js';
+import logger from '../../../middleware/logger';
 
 // Newsletter opt-ins sync to Salesforce, which already runs a full
 // double-opt-in subscription flow (Person Account for existing constituents,
@@ -9,8 +9,7 @@ import {salesforceApexRestPost} from '../../../common/salesforce.client.js';
 // This is the one file that knows that contract exists; submissions.service.ts
 // only ever calls syncNewsletterSignup(signupId) after its own transaction
 // commits, fire-and-forget, so a Salesforce outage can never delay or fail a
-// visitor's feedback submission. The OAuth token cache and retry-once-on-401
+// visitor's feedback submission.
-// live in common/salesforce.client.ts, shared with the transactional-email relay.
 
 interface SalesforceSuccessResponse {
 	status: 'PENDING_CONFIRMATION' | 'ALREADY_SUBSCRIBED';
@@ -27,8 +26,54 @@ interface NewsletterSignupRow {
 	event_name: string;
 }
 
-const postSignup = (payload: {firstName: string; lastName: string; email: string; eventName: string}): Promise<SalesforceSuccessResponse> =>
+// Salesforce's client-credentials token response does not reliably include
-	salesforceApexRestPost<SalesforceSuccessResponse>('/services/apexrest/newsletter/signup', payload);
+// expires_in, so the cache lifetime is a conservative guess rather than a
+// value read from the response - a 401 on the next call just triggers a
+// fresh fetch (see the retry-once logic in postSignup).
+const TOKEN_CACHE_MS = 15 * 60 * 1000;
+let cachedToken: {accessToken: string; fetchedAt: number} | null = null;
+
+const getAccessToken = async (forceRefresh: boolean): Promise<string> => {
+	if (!forceRefresh && cachedToken && Date.now() - cachedToken.fetchedAt < TOKEN_CACHE_MS) {
+		return cachedToken.accessToken;
+	}
+
+	const instanceUrl = process.env.SALESFORCE_API_URL;
+	const clientId = process.env.SALESFORCE_CLIENT_ID;
+	const clientSecret = process.env.SALESFORCE_CLIENT_SECRET;
+	if (!instanceUrl || !clientId || !clientSecret) {
+		throw new Error('SALESFORCE_ENABLED is true but SALESFORCE_API_URL/SALESFORCE_CLIENT_ID/SALESFORCE_CLIENT_SECRET are not fully configured.');
+	}
+
+	const res = await axios.post(
+		`${instanceUrl}/services/oauth2/token`,
+		new URLSearchParams({grant_type: 'client_credentials', client_id: clientId, client_secret: clientSecret}).toString(),
+		{headers: {'Content-Type': 'application/x-www-form-urlencoded'}, timeout: 10000}
+	);
+	cachedToken = {accessToken: res.data.access_token, fetchedAt: Date.now()};
+	return cachedToken.accessToken;
+};
+
+const postSignup = async (payload: {firstName: string; lastName: string; email: string; eventName: string}): Promise<SalesforceSuccessResponse> => {
+	const instanceUrl = process.env.SALESFORCE_API_URL;
+	const url = `${instanceUrl}/services/apexrest/newsletter/signup`;
+
+	try {
+		const token = await getAccessToken(false);
+		const res = await axios.post<SalesforceSuccessResponse>(url, payload, {headers: {Authorization: `Bearer ${token}`}, timeout: 10000});
+		return res.data;
+	} catch (err: any) {
+		// The cached token may have expired server-side even though our
+		// conservative local TTL hasn't - retry once with a forced refresh
+		// before treating this as a real failure.
+		if (err?.response?.status === 401) {
+			const token = await getAccessToken(true);
+			const res = await axios.post<SalesforceSuccessResponse>(url, payload, {headers: {Authorization: `Bearer ${token}`}, timeout: 10000});
+			return res.data;
+		}
+		throw err;
+	}
+};
 
 const markSynced = async (signupId: number, externalId: string): Promise<void> => {
 	let conn = await NachklangFeedbackDB.getConnection();

src/models/feedback/public/events.public.service.ts

@@ -1,5 +1,5 @@
-import {NachklangFeedbackDB} from '../Feedback.db.js';
+import {NachklangFeedbackDB} from '../Feedback.db';
-import {EventConfig, EventSummary, Question, Song} from '../feedback.interface.js';
+import {EventConfig, EventSummary, Question, Song} from '../feedback.interface';
 
 /**
  * Returns all events currently eligible to receive feedback:

src/models/feedback/public/public.router.ts

@@ -2,11 +2,11 @@
  * Required External Modules and Interfaces
  */
 import express, {Request, Response} from 'express';
-import logger from '../../../middleware/logger.js';
+import logger from '../../../middleware/logger';
-import {getEligibleEvents, getEventConfigBySlug} from './events.public.service.js';
+import {getEligibleEvents, getEventConfigBySlug} from './events.public.service';
-import {submitFeedback} from './submissions.service.js';
+import {submitFeedback} from './submissions.service';
-import {hashIp, isRateLimited, recordSubmission} from '../feedback.ratelimit.js';
+import {hashIp, isRateLimited, recordSubmission} from '../feedback.ratelimit';
-import {sendServerError} from '../feedback.errors.js';
+import {sendServerError} from '../feedback.errors';
 
 /**
  * Router Definition

src/models/feedback/public/submissions.service.ts

@@ -1,9 +1,9 @@
-import {NachklangFeedbackDB} from '../Feedback.db.js';
+import {NachklangFeedbackDB} from '../Feedback.db';
-import {QuestionType} from '../feedback.interface.js';
+import {QuestionType} from '../feedback.interface';
-import {getEventConfigBySlug} from './events.public.service.js';
+import {getEventConfigBySlug} from './events.public.service';
-import {AnswerInput, GuestBookInput, NewsletterInput, SubmissionRequestBody} from './submission.interface.js';
+import {AnswerInput, GuestBookInput, NewsletterInput, SubmissionRequestBody} from './submission.interface';
-import {syncNewsletterSignup} from '../integrations/salesforce.service.js';
+import {syncNewsletterSignup} from '../integrations/salesforce.service';
-import logger from '../../../middleware/logger.js';
+import logger from '../../../middleware/logger';
 
 // Bump when the privacy/consent copy shown next to the newsletter opt-in
 // changes; recorded per-signup so a past consent's exact wording is provable.

src/models/tickets/Tickets.db.ts

@@ -1,18 +0,0 @@
-import * as dotenv from 'dotenv';
-import mariadb from 'mariadb';
-
-dotenv.config();
-
-export namespace NachklangTicketsDB {
-	const pool = mariadb.createPool({
-		host: process.env.DB_HOST,
-		user: process.env.DB_USER,
-		password: process.env.DB_PASSWORD,
-		database: process.env.TICKETS_DB,
-		connectionLimit: 5
-	});
-
-	export const getConnection = async () => {
-		return pool.getConnection();
-	};
-}

src/models/tickets/Tickets.router.ts

@@ -1,8 +0,0 @@
-import express from 'express';
-import {adminRouter} from './admin/admin.router.js';
-import {publicRouter} from './public/public.router.js';
-
-export const ticketsRouter = express.Router();
-
-ticketsRouter.use('/admin', adminRouter);
-ticketsRouter.use('/', publicRouter);

src/models/tickets/admin/admin.router.ts

@@ -1,36 +0,0 @@
-import express, {Request, Response} from 'express';
-import {requireAdminAuth} from '../tickets.auth.js';
-import {vouchersAdminRouter} from './vouchers.admin.router.js';
-import {redemptionsAdminRouter, voucherHistoryRouter} from './redemptions.admin.router.js';
-import {eventsAdminRouter} from './events.admin.router.js';
-
-export const adminRouter = express.Router();
-
-// Applied once at the top of the admin router tree - every route below
-// requires a valid admin session (mirrors Feedback's admin.router.ts).
-adminRouter.use(requireAdminAuth);
-
-/**
- * @swagger
- * /tickets/admin/me:
- *      get:
- *          summary: Validate the current admin session
- *          tags: [tickets-admin]
- *          security:
- *              - AdminSessionCookie: []
- *          responses:
- *              200:
- *                  description: Success
- *              401:
- *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
- */
-adminRouter.get('/me', (req: Request, res: Response) => {
-	res.status(200).send({email: res.locals.admin.email, fullName: res.locals.admin.displayName});
-});
-
-adminRouter.use('/vouchers', vouchersAdminRouter);
-adminRouter.use('/vouchers', voucherHistoryRouter);
-adminRouter.use('/redemptions', redemptionsAdminRouter);
-adminRouter.use('/events', eventsAdminRouter);

src/models/tickets/admin/events.admin.router.ts

@@ -1,187 +0,0 @@
-import express, {Request, Response} from 'express';
-import * as EventsAdminService from './events.admin.service.js';
-import {sendServerError} from '../tickets.errors.js';
-
-export const eventsAdminRouter = express.Router();
-
-/**
- * @swagger
- * /tickets/admin/events:
- *      get:
- *          summary: List concerts for the admin event picker
- *          description: Wraps the Calendar module's public-calendar admin listing (includes DRAFT events).
- *          tags: [tickets-admin]
- *          security:
- *              - AdminSessionCookie: []
- *          responses:
- *              200:
- *                  description: Success
- *              401:
- *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
- */
-eventsAdminRouter.get('/', async (req: Request, res: Response) => {
-	try {
-		res.status(200).send(await EventsAdminService.listEventsForPicker());
-	} catch (e: any) {
-		sendServerError(res, e);
-	}
-});
-
-/**
- * @swagger
- * /tickets/admin/events/available:
- *      get:
- *          summary: List public-calendar events not yet added to the ticket shop
- *          description: Source list for the "add a concert" picker - the public calendar holds more than concerts, so events only appear in the ticket shop once explicitly added.
- *          tags: [tickets-admin]
- *          security:
- *              - AdminSessionCookie: []
- *          responses:
- *              200:
- *                  description: Success
- *              401:
- *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
- */
-eventsAdminRouter.get('/available', async (req: Request, res: Response) => {
-	try {
-		res.status(200).send(await EventsAdminService.listAvailableEventsToAdd());
-	} catch (e: any) {
-		sendServerError(res, e);
-	}
-});
-
-/**
- * @swagger
- * /tickets/admin/events/{eventId}/stats:
- *      get:
- *          summary: Get a concert's voucher/capacity stats
- *          tags: [tickets-admin]
- *          security:
- *              - AdminSessionCookie: []
- *          parameters:
- *              - in: path
- *                name: eventId
- *                required: true
- *                schema:
- *                    type: integer
- *          responses:
- *              200:
- *                  description: Success
- *                  content:
- *                      application/json:
- *                          schema:
- *                              $ref: '#/components/schemas/EventStats'
- *              401:
- *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
- */
-eventsAdminRouter.get('/:eventId/stats', async (req: Request, res: Response) => {
-	try {
-		res.status(200).send(await EventsAdminService.getEventStats(Number(req.params.eventId)));
-	} catch (e: any) {
-		sendServerError(res, e);
-	}
-});
-
-/**
- * @swagger
- * /tickets/admin/events/{eventId}/settings:
- *      put:
- *          summary: Set a concert's voucher settings
- *          description: Upserts capacity (null = uncapped), redemption deadline (null = none), and whether to collect a mailing address.
- *          tags: [tickets-admin]
- *          security:
- *              - AdminSessionCookie: []
- *          parameters:
- *              - in: path
- *                name: eventId
- *                required: true
- *                schema:
- *                    type: integer
- *          requestBody:
- *              required: true
- *              content:
- *                  application/json:
- *                      schema:
- *                          type: object
- *                          properties:
- *                              capacity:
- *                                  type: integer
- *                                  nullable: true
- *                              redemptionDeadline:
- *                                  type: string
- *                                  format: date-time
- *                                  nullable: true
- *                              collectAddress:
- *                                  type: boolean
- *                              requireAddress:
- *                                  type: boolean
- *                                  description: Only meaningful when collectAddress is true.
- *          responses:
- *              200:
- *                  description: Saved
- *              401:
- *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
- */
-eventsAdminRouter.put('/:eventId/settings', async (req: Request, res: Response) => {
-	try {
-		const {capacity, redemptionDeadline, collectAddress, requireAddress} = req.body || {};
-		await EventsAdminService.setEventSettings(Number(req.params.eventId), {
-			capacity: capacity ?? null,
-			// The mariadb driver needs an actual Date to serialize a DATETIME
-			// column correctly - a raw ISO string (as arrives over JSON) gets
-			// rejected with "Incorrect datetime value".
-			redemptionDeadline: redemptionDeadline ? new Date(redemptionDeadline) : null,
-			collectAddress: !!collectAddress,
-			requireAddress: !!collectAddress && !!requireAddress
-		});
-		res.status(200).send({status: 'OK'});
-	} catch (e: any) {
-		sendServerError(res, e);
-	}
-});
-
-/**
- * @swagger
- * /tickets/admin/events/{eventId}/settings:
- *      delete:
- *          summary: Remove an event from the ticket shop
- *          description: Deletes its settings row, so it drops out of the picker and reappears in the "add" list. Refused with 409 if vouchers already reference the event - existing vouchers/redemptions stay valid either way.
- *          tags: [tickets-admin]
- *          security:
- *              - AdminSessionCookie: []
- *          parameters:
- *              - in: path
- *                name: eventId
- *                required: true
- *                schema:
- *                    type: integer
- *          responses:
- *              200:
- *                  description: Removed
- *              409:
- *                  description: Vouchers already reference this event
- *              401:
- *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
- */
-eventsAdminRouter.delete('/:eventId/settings', async (req: Request, res: Response) => {
-	try {
-		const result = await EventsAdminService.removeEvent(Number(req.params.eventId));
-		if (result === 'HAS_VOUCHERS') {
-			res.status(409).send({status: 'HAS_VOUCHERS', message: 'Für dieses Konzert existieren bereits Gutscheine.'});
-			return;
-		}
-		res.status(200).send({status: 'OK'});
-	} catch (e: any) {
-		sendServerError(res, e);
-	}
-});

src/models/tickets/admin/events.admin.service.ts

@@ -1,155 +0,0 @@
-import * as CalendarEventsService from '../../calendar/events/events.service.js';
-import {NachklangTicketsDB} from '../Tickets.db.js';
-import {getEventTicketState} from '../tickets.capacity.js';
-import {EventStats, EventTicketSettings} from '../tickets.interface.js';
-
-// Concerts are managed on the public calendar (calendarId 1) - see
-// docs/plan-ticket-shop.md. getAllEventsAdmin includes DRAFT events so
-// organizers can generate vouchers for a concert before it's announced.
-const PUBLIC_CALENDAR_ID = 1;
-
-export interface EventPickerEntry {
-	eventId: number;
-	name: string;
-	startDateTime: Date;
-	location: string;
-	status: string | undefined;
-}
-
-/**
- * The public calendar holds more than concerts (rehearsal announcements,
- * general notices, etc.), and Calendar's own Event has no category field to
- * tell them apart. `event_ticket_settings` doubles as the ticket shop's
- * allow-list: a Calendar event only appears here once an admin has
- * explicitly added it (see addEvent/removeEvent below) - even with every
- * setting left at its default (uncapped, no deadline, no address).
- */
-export const listEventsForPicker = async (): Promise<EventPickerEntry[]> => {
-	let conn = await NachklangTicketsDB.getConnection();
-	let enabledEventIds: number[];
-	try {
-		const rows = await conn.query('SELECT event_id FROM event_ticket_settings');
-		enabledEventIds = rows.map((r: any) => r.event_id);
-	} finally {
-		await conn.end();
-	}
-	if (enabledEventIds.length === 0) return [];
-
-	const events = await Promise.all(enabledEventIds.map(id => CalendarEventsService.getEventById(id)));
-	return events
-		.filter((e): e is NonNullable<typeof e> => e !== null && e.status !== 'DELETED')
-		.map(e => ({eventId: e.eventId, name: e.name, startDateTime: e.startDateTime, location: e.location, status: e.status}))
-		.sort((a, b) => a.startDateTime.getTime() - b.startDateTime.getTime());
-};
-
-/**
- * Public-calendar events that could be added to the ticket shop but
- * haven't been yet - source list for the "add a concert" picker.
- */
-export const listAvailableEventsToAdd = async (): Promise<EventPickerEntry[]> => {
-	let conn = await NachklangTicketsDB.getConnection();
-	let enabledEventIds: Set<number>;
-	try {
-		const rows = await conn.query('SELECT event_id FROM event_ticket_settings');
-		enabledEventIds = new Set(rows.map((r: any) => r.event_id));
-	} finally {
-		await conn.end();
-	}
-
-	const events = await CalendarEventsService.getAllEventsAdmin(PUBLIC_CALENDAR_ID);
-	return events
-		.filter(e => e.status !== 'DELETED' && !enabledEventIds.has(e.eventId))
-		.map(e => ({eventId: e.eventId, name: e.name, startDateTime: e.startDateTime, location: e.location, status: e.status}))
-		.sort((a, b) => a.startDateTime.getTime() - b.startDateTime.getTime());
-};
-
-export const getEventStats = async (eventId: number): Promise<EventStats> => {
-	let conn = await NachklangTicketsDB.getConnection();
-	try {
-		const ticketState = await getEventTicketState(conn, eventId);
-
-		const countRows = await conn.query(
-			`SELECT vc.status, COUNT(DISTINCT vc.code) as cnt
-			 FROM voucher_codes vc
-			 INNER JOIN voucher_code_events vce ON vce.code = vc.code
-			 WHERE vce.event_id = ?
-			 GROUP BY vc.status`,
-			[eventId]
-		);
-		let unusedCodes = 0, redeemedCodes = 0, voidCodes = 0;
-		for (const row of countRows) {
-			if (row.status === 'UNUSED') unusedCodes = Number(row.cnt);
-			if (row.status === 'REDEEMED') redeemedCodes = Number(row.cnt);
-			if (row.status === 'VOID') voidCodes = Number(row.cnt);
-		}
-
-		return {
-			eventId,
-			capacity: ticketState.capacity,
-			redemptionDeadline: ticketState.redemptionDeadline,
-			collectAddress: ticketState.collectAddress,
-			requireAddress: ticketState.requireAddress,
-			guestsUsed: ticketState.guestsUsed,
-			spotsRemaining: ticketState.spotsRemaining,
-			unusedCodes,
-			redeemedCodes,
-			voidCodes
-		};
-	} finally {
-		await conn.end();
-	}
-};
-
-/**
- * Upsert - also doubles as "add this event to the ticket shop" when called
- * with all-default values (see listEventsForPicker).
- */
-export const setEventSettings = async (eventId: number, settings: Omit<EventTicketSettings, 'eventId'>): Promise<void> => {
-	let conn = await NachklangTicketsDB.getConnection();
-	try {
-		await conn.beginTransaction();
-		await conn.query(
-			`INSERT INTO event_ticket_settings (event_id, capacity, redemption_deadline, collect_address, require_address)
-			 VALUES (?,?,?,?,?)
-			 ON DUPLICATE KEY UPDATE capacity = VALUES(capacity), redemption_deadline = VALUES(redemption_deadline), collect_address = VALUES(collect_address), require_address = VALUES(require_address)`,
-			[eventId, settings.capacity, settings.redemptionDeadline, settings.collectAddress ? 1 : 0, settings.requireAddress ? 1 : 0]
-		);
-		await conn.commit();
-	} catch (err) {
-		await conn.rollback();
-		throw err;
-	} finally {
-		await conn.end();
-	}
-};
-
-export type RemoveEventResult = 'REMOVED' | 'HAS_VOUCHERS';
-
-/**
- * Removes an event from the ticket shop (deletes its settings row, so it
- * drops out of listEventsForPicker and reappears in the "add" list).
- * Refuses if vouchers already reference it - existing vouchers/redemptions
- * stay valid and keep working even for an event no longer offered for new
- * voucher generation, so this only blocks removing one that's still in use.
- */
-export const removeEvent = async (eventId: number): Promise<RemoveEventResult> => {
-	let conn = await NachklangTicketsDB.getConnection();
-	try {
-		await conn.beginTransaction();
-
-		const voucherRows = await conn.query('SELECT 1 FROM voucher_code_events WHERE event_id = ? LIMIT 1', [eventId]);
-		if (voucherRows.length > 0) {
-			await conn.rollback();
-			return 'HAS_VOUCHERS';
-		}
-
-		await conn.query('DELETE FROM event_ticket_settings WHERE event_id = ?', [eventId]);
-		await conn.commit();
-		return 'REMOVED';
-	} catch (err) {
-		await conn.rollback();
-		throw err;
-	} finally {
-		await conn.end();
-	}
-};

src/models/tickets/admin/redemptions.admin.router.ts

@@ -1,301 +0,0 @@
-import express, {Request, Response} from 'express';
-import * as RedemptionsAdminService from './redemptions.admin.service.js';
-import {sendServerError} from '../tickets.errors.js';
-
-export const redemptionsAdminRouter = express.Router();
-
-/**
- * @swagger
- * /tickets/admin/redemptions:
- *      get:
- *          summary: List redemptions (admin)
- *          description: Filterable by event and status (ACTIVE/UNDONE).
- *          tags: [tickets-admin]
- *          security:
- *              - AdminSessionCookie: []
- *          parameters:
- *              - in: query
- *                name: eventId
- *                schema:
- *                    type: integer
- *              - in: query
- *                name: status
- *                schema:
- *                    $ref: '#/components/schemas/RedemptionStatus'
- *          responses:
- *              200:
- *                  description: Success
- *                  content:
- *                      application/json:
- *                          schema:
- *                              type: array
- *                              items:
- *                                  $ref: '#/components/schemas/RedemptionSummary'
- *              401:
- *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
- */
-redemptionsAdminRouter.get('/', async (req: Request, res: Response) => {
-	try {
-		const eventId = req.query.eventId !== undefined ? Number(req.query.eventId) : undefined;
-		const status = req.query.status as any;
-		res.status(200).send(await RedemptionsAdminService.listRedemptions({eventId, status}));
-	} catch (e: any) {
-		sendServerError(res, e);
-	}
-});
-
-/**
- * @swagger
- * /tickets/admin/redemptions/{redemptionId}:
- *      get:
- *          summary: Get a single redemption (admin)
- *          tags: [tickets-admin]
- *          security:
- *              - AdminSessionCookie: []
- *          parameters:
- *              - in: path
- *                name: redemptionId
- *                required: true
- *                schema:
- *                    type: integer
- *          responses:
- *              200:
- *                  description: Success
- *              404:
- *                  description: Unknown redemption
- *              401:
- *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
- *      patch:
- *          summary: Edit a redemption's contact info and/or guest list
- *          description: Only fields present in the body are changed. Growing the guest count is re-checked against the voucher's max guests and the event's remaining capacity. Logs to the audit trail with an optional admin-supplied reason.
- *          tags: [tickets-admin]
- *          security:
- *              - AdminSessionCookie: []
- *          parameters:
- *              - in: path
- *                name: redemptionId
- *                required: true
- *                schema:
- *                    type: integer
- *          requestBody:
- *              content:
- *                  application/json:
- *                      schema:
- *                          type: object
- *                          properties:
- *                              contactName:
- *                                  type: string
- *                              contactEmail:
- *                                  type: string
- *                              contactAddress:
- *                                  type: string
- *                                  nullable: true
- *                              guestNames:
- *                                  type: array
- *                                  items:
- *                                      type: string
- *                              reason:
- *                                  type: string
- *          responses:
- *              200:
- *                  description: Edited
- *              404:
- *                  description: Unknown redemption
- *              409:
- *                  description: Not active, exceeds max guests, or exceeds remaining capacity
- *              401:
- *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
- */
-redemptionsAdminRouter.get('/:redemptionId', async (req: Request, res: Response) => {
-	try {
-		const redemption = await RedemptionsAdminService.getRedemption(Number(req.params.redemptionId));
-		if (!redemption) {
-			res.status(404).send({status: 'NOT_FOUND'});
-			return;
-		}
-		res.status(200).send(redemption);
-	} catch (e: any) {
-		sendServerError(res, e);
-	}
-});
-
-redemptionsAdminRouter.patch('/:redemptionId', async (req: Request, res: Response) => {
-	try {
-		const {contactName, contactEmail, contactAddress, guestNames, reason} = req.body || {};
-		const result = await RedemptionsAdminService.editRedemption(
-			Number(req.params.redemptionId),
-			{contactName, contactEmail, contactAddress, guestNames},
-			res.locals.admin.email,
-			reason || null
-		);
-
-		switch (result.status) {
-			case 'EDITED':
-				res.status(200).send({status: 'OK'});
-				return;
-			case 'NOT_FOUND':
-				res.status(404).send({status: 'NOT_FOUND'});
-				return;
-			case 'NOT_ACTIVE':
-				res.status(409).send({status: 'NOT_ACTIVE', message: 'This redemption is not active.'});
-				return;
-			case 'INVALID_EMAIL':
-				res.status(400).send({status: 'INVALID_EMAIL', message: 'Die E-Mail-Adresse sieht nicht gültig aus.'});
-				return;
-			case 'EXCEEDS_MAX_GUESTS':
-				res.status(409).send({status: 'EXCEEDS_MAX_GUESTS', maxGuests: result.maxGuests});
-				return;
-			case 'CAPACITY_EXCEEDED':
-				res.status(409).send({status: 'CAPACITY_EXCEEDED', spotsRemaining: result.spotsRemaining});
-				return;
-		}
-	} catch (e: any) {
-		sendServerError(res, e);
-	}
-});
-
-/**
- * @swagger
- * /tickets/admin/redemptions/{redemptionId}/undo:
- *      post:
- *          summary: Undo a redemption
- *          description: Reopens the code (back to UNUSED) and marks the redemption UNDONE. Guest data is kept for the audit trail; a later re-redemption creates a new redemption record.
- *          tags: [tickets-admin]
- *          security:
- *              - AdminSessionCookie: []
- *          parameters:
- *              - in: path
- *                name: redemptionId
- *                required: true
- *                schema:
- *                    type: integer
- *          requestBody:
- *              content:
- *                  application/json:
- *                      schema:
- *                          type: object
- *                          properties:
- *                              reason:
- *                                  type: string
- *          responses:
- *              200:
- *                  description: Undone
- *              404:
- *                  description: Unknown redemption
- *              409:
- *                  description: Redemption is not active
- *              401:
- *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
- */
-redemptionsAdminRouter.post('/:redemptionId/undo', async (req: Request, res: Response) => {
-	try {
-		const result = await RedemptionsAdminService.undoRedemption(Number(req.params.redemptionId), res.locals.admin.email, req.body?.reason || null);
-		if (result === 'NOT_FOUND') {
-			res.status(404).send({status: 'NOT_FOUND'});
-			return;
-		}
-		if (result === 'NOT_ACTIVE') {
-			res.status(409).send({status: 'NOT_ACTIVE', message: 'This redemption is not active.'});
-			return;
-		}
-		res.status(200).send({status: 'OK'});
-	} catch (e: any) {
-		sendServerError(res, e);
-	}
-});
-
-/**
- * @swagger
- * /tickets/admin/redemptions/{redemptionId}/resend-confirmation:
- *      post:
- *          summary: Resend the redemption confirmation email
- *          description: Rebuilds the confirmation email from the stored redemption data and sends it again, then records the outcome on the redemption. Intended for redemptions whose original confirmation email failed.
- *          tags: [tickets-admin]
- *          security:
- *              - AdminSessionCookie: []
- *          parameters:
- *              - in: path
- *                name: redemptionId
- *                required: true
- *                schema:
- *                    type: integer
- *          responses:
- *              200:
- *                  description: The email was accepted for delivery
- *              404:
- *                  description: Unknown redemption
- *              409:
- *                  description: Redemption is not active
- *              502:
- *                  description: The email relay rejected the send
- *              401:
- *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
- */
-redemptionsAdminRouter.post('/:redemptionId/resend-confirmation', async (req: Request, res: Response) => {
-	try {
-		const result = await RedemptionsAdminService.resendRedemptionConfirmation(Number(req.params.redemptionId));
-		switch (result) {
-			case 'SENT':
-				res.status(200).send({status: 'OK'});
-				return;
-			case 'NOT_FOUND':
-				res.status(404).send({status: 'NOT_FOUND'});
-				return;
-			case 'NOT_ACTIVE':
-				res.status(409).send({status: 'NOT_ACTIVE', message: 'This redemption is not active.'});
-				return;
-			case 'FAILED':
-				res.status(502).send({status: 'SEND_FAILED', message: 'Die E-Mail konnte nicht versendet werden. Bitte später erneut versuchen.'});
-				return;
-		}
-	} catch (e: any) {
-		sendServerError(res, e);
-	}
-});
-
-/**
- * @swagger
- * /tickets/admin/vouchers/{code}/history:
- *      get:
- *          summary: Get a voucher's admin-action audit trail
- *          tags: [tickets-admin]
- *          security:
- *              - AdminSessionCookie: []
- *          parameters:
- *              - in: path
- *                name: code
- *                required: true
- *                schema:
- *                    type: string
- *          responses:
- *              200:
- *                  description: Success
- *                  content:
- *                      application/json:
- *                          schema:
- *                              type: array
- *                              items:
- *                                  $ref: '#/components/schemas/AuditLogEntry'
- *              401:
- *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
- */
-export const voucherHistoryRouter = express.Router();
-voucherHistoryRouter.get('/:code/history', async (req: Request, res: Response) => {
-	try {
-		res.status(200).send(await RedemptionsAdminService.getAuditHistory(req.params.code));
-	} catch (e: any) {
-		sendServerError(res, e);
-	}
-});

src/models/tickets/admin/redemptions.admin.service.ts

@@ -1,274 +0,0 @@
-import {NachklangTicketsDB} from '../Tickets.db.js';
-import {getEventTicketState} from '../tickets.capacity.js';
-import {recordConfirmationEmailResult, sendRedemptionConfirmation} from '../tickets.confirmation-email.js';
-import {AuditLogEntry, RedemptionSummary} from '../tickets.interface.js';
-import {isValidEmail} from '../tickets.validation.js';
-
-const mapRedemptionRow = (row: any, guests: string[]): RedemptionSummary => ({
-	redemptionId: row.redemption_id,
-	code: row.code,
-	eventId: row.event_id,
-	status: row.status,
-	contactName: row.contact_name,
-	contactEmail: row.contact_email,
-	contactAddress: row.contact_address,
-	guestCount: row.guest_count,
-	guests,
-	redeemedAt: row.redeemed_at,
-	confirmationEmailStatus: row.confirmation_email_status ?? null
-});
-
-export interface ListRedemptionsFilter {
-	eventId?: number;
-	status?: 'ACTIVE' | 'UNDONE';
-}
-
-export const listRedemptions = async (filter: ListRedemptionsFilter): Promise<RedemptionSummary[]> => {
-	let conn = await NachklangTicketsDB.getConnection();
-	try {
-		const where: string[] = [];
-		const params: any[] = [];
-		if (filter.eventId !== undefined) {
-			where.push('event_id = ?');
-			params.push(filter.eventId);
-		}
-		if (filter.status) {
-			where.push('status = ?');
-			params.push(filter.status);
-		}
-		let query = 'SELECT * FROM redemptions';
-		if (where.length > 0) query += ' WHERE ' + where.join(' AND ');
-		query += ' ORDER BY redeemed_at DESC';
-
-		const rows = await conn.query(query, params);
-		if (rows.length === 0) return [];
-
-		const redemptionIds = rows.map((r: any) => r.redemption_id);
-		const guestRows = await conn.query(
-			'SELECT redemption_id, name FROM redemption_guests WHERE redemption_id IN (?) ORDER BY redemption_id, position',
-			[redemptionIds]
-		);
-		const guestsByRedemption = new Map<number, string[]>();
-		for (const g of guestRows) {
-			const list = guestsByRedemption.get(g.redemption_id) || [];
-			list.push(g.name);
-			guestsByRedemption.set(g.redemption_id, list);
-		}
-
-		return rows.map((row: any) => mapRedemptionRow(row, guestsByRedemption.get(row.redemption_id) || []));
-	} finally {
-		await conn.end();
-	}
-};
-
-export const getRedemption = async (redemptionId: number): Promise<RedemptionSummary | null> => {
-	let conn = await NachklangTicketsDB.getConnection();
-	try {
-		const rows = await conn.query('SELECT * FROM redemptions WHERE redemption_id = ?', [redemptionId]);
-		if (rows.length === 0) return null;
-		const guestRows = await conn.query('SELECT name FROM redemption_guests WHERE redemption_id = ? ORDER BY position', [redemptionId]);
-		return mapRedemptionRow(rows[0], guestRows.map((g: any) => g.name));
-	} finally {
-		await conn.end();
-	}
-};
-
-export type UndoRedemptionResult = 'UNDONE' | 'NOT_FOUND' | 'NOT_ACTIVE';
-
-/**
- * Reopens the code (back to UNUSED) and marks the redemption UNDONE
- * (soft-state, not deleted - guest names/contact info stay for the audit
- * trail). A later re-redemption of the same code creates a new
- * redemptions row rather than reviving this one.
- */
-export const undoRedemption = async (redemptionId: number, adminEmail: string, reason: string | null): Promise<UndoRedemptionResult> => {
-	let conn = await NachklangTicketsDB.getConnection();
-	try {
-		await conn.beginTransaction();
-
-		const rows = await conn.query('SELECT * FROM redemptions WHERE redemption_id = ? FOR UPDATE', [redemptionId]);
-		if (rows.length === 0) {
-			await conn.rollback();
-			return 'NOT_FOUND';
-		}
-		const redemption = rows[0];
-		if (redemption.status !== 'ACTIVE') {
-			await conn.rollback();
-			return 'NOT_ACTIVE';
-		}
-
-		await conn.query('UPDATE redemptions SET status = ? WHERE redemption_id = ?', ['UNDONE', redemptionId]);
-		await conn.query('UPDATE voucher_codes SET status = ? WHERE code = ?', ['UNUSED', redemption.code]);
-		await conn.query(
-			'INSERT INTO voucher_audit_log (code, redemption_id, admin_email, action, reason) VALUES (?,?,?,?,?)',
-			[redemption.code, redemptionId, adminEmail, 'UNDO', reason]
-		);
-
-		await conn.commit();
-		return 'UNDONE';
-	} catch (err) {
-		await conn.rollback();
-		throw err;
-	} finally {
-		await conn.end();
-	}
-};
-
-export interface EditRedemptionInput {
-	contactName?: string;
-	contactEmail?: string;
-	contactAddress?: string | null;
-	guestNames?: string[];
-}
-
-export type EditRedemptionResult =
-	| {status: 'EDITED'}
-	| {status: 'NOT_FOUND'}
-	| {status: 'NOT_ACTIVE'}
-	| {status: 'INVALID_EMAIL'}
-	| {status: 'EXCEEDS_MAX_GUESTS'; maxGuests: number}
-	| {status: 'CAPACITY_EXCEEDED'; spotsRemaining: number};
-
-/**
- * Direct admin correction of a redemption's contact info and/or guest
- * list. Only the fields present in `input` are changed. Growing the guest
- * count is re-checked against both the voucher's own max_guests and the
- * event's remaining capacity (forUpdate=true, same race-safety approach as
- * the public redeem path).
- */
-export const editRedemption = async (redemptionId: number, input: EditRedemptionInput, adminEmail: string, reason: string | null): Promise<EditRedemptionResult> => {
-	if (input.contactEmail !== undefined && !isValidEmail(input.contactEmail)) {
-		return {status: 'INVALID_EMAIL'};
-	}
-
-	let conn = await NachklangTicketsDB.getConnection();
-	try {
-		await conn.beginTransaction();
-
-		const rows = await conn.query('SELECT * FROM redemptions WHERE redemption_id = ? FOR UPDATE', [redemptionId]);
-		if (rows.length === 0) {
-			await conn.rollback();
-			return {status: 'NOT_FOUND'};
-		}
-		const before = rows[0];
-		if (before.status !== 'ACTIVE') {
-			await conn.rollback();
-			return {status: 'NOT_ACTIVE'};
-		}
-
-		const changeSummary: Record<string, {before: any; after: any}> = {};
-		const fields: string[] = [];
-		const values: any[] = [];
-
-		if (input.contactName !== undefined && input.contactName !== before.contact_name) {
-			changeSummary.contactName = {before: before.contact_name, after: input.contactName};
-			fields.push('contact_name = ?');
-			values.push(input.contactName);
-		}
-		if (input.contactEmail !== undefined && input.contactEmail !== before.contact_email) {
-			changeSummary.contactEmail = {before: before.contact_email, after: input.contactEmail};
-			fields.push('contact_email = ?');
-			values.push(input.contactEmail);
-		}
-		if (input.contactAddress !== undefined && input.contactAddress !== before.contact_address) {
-			changeSummary.contactAddress = {before: before.contact_address, after: input.contactAddress};
-			fields.push('contact_address = ?');
-			values.push(input.contactAddress);
-		}
-
-		if (input.guestNames !== undefined) {
-			const newCount = input.guestNames.length;
-			const delta = newCount - before.guest_count;
-
-			if (delta > 0) {
-				const voucherRows = await conn.query('SELECT max_guests FROM voucher_codes WHERE code = ?', [before.code]);
-				const maxGuests = voucherRows[0].max_guests;
-				if (newCount > maxGuests) {
-					await conn.rollback();
-					return {status: 'EXCEEDS_MAX_GUESTS', maxGuests};
-				}
-
-				const ticketState = await getEventTicketState(conn, before.event_id, true);
-				if (ticketState.spotsRemaining !== null && delta > ticketState.spotsRemaining) {
-					await conn.rollback();
-					return {status: 'CAPACITY_EXCEEDED', spotsRemaining: ticketState.spotsRemaining};
-				}
-			}
-
-			const oldGuestRows = await conn.query('SELECT name FROM redemption_guests WHERE redemption_id = ? ORDER BY position', [redemptionId]);
-			changeSummary.guests = {before: oldGuestRows.map((g: any) => g.name), after: input.guestNames};
-
-			fields.push('guest_count = ?');
-			values.push(newCount);
-
-			await conn.query('DELETE FROM redemption_guests WHERE redemption_id = ?', [redemptionId]);
-			for (let i = 0; i < input.guestNames.length; i++) {
-				await conn.query('INSERT INTO redemption_guests (redemption_id, name, position) VALUES (?,?,?)', [redemptionId, input.guestNames[i], i]);
-			}
-		}
-
-		if (fields.length > 0) {
-			values.push(redemptionId);
-			await conn.query(`UPDATE redemptions SET ${fields.join(', ')} WHERE redemption_id = ?`, values);
-		}
-
-		if (Object.keys(changeSummary).length > 0) {
-			await conn.query(
-				'INSERT INTO voucher_audit_log (code, redemption_id, admin_email, action, change_summary, reason) VALUES (?,?,?,?,?,?)',
-				[before.code, redemptionId, adminEmail, 'EDIT', JSON.stringify(changeSummary), reason]
-			);
-		}
-
-		await conn.commit();
-		return {status: 'EDITED'};
-	} catch (err) {
-		await conn.rollback();
-		throw err;
-	} finally {
-		await conn.end();
-	}
-};
-
-export type ResendConfirmationResult = 'SENT' | 'FAILED' | 'NOT_FOUND' | 'NOT_ACTIVE';
-
-/**
- * Rebuilds and re-sends the redemption confirmation email from the stored
- * redemption data, then records the new outcome on the row. Used by the admin
- * UI's "resend" action on a redemption whose confirmation email failed. Only
- * active redemptions can be resent.
- */
-export const resendRedemptionConfirmation = async (redemptionId: number): Promise<ResendConfirmationResult> => {
-	const redemption = await getRedemption(redemptionId);
-	if (!redemption) return 'NOT_FOUND';
-	if (redemption.status !== 'ACTIVE') return 'NOT_ACTIVE';
-
-	const sent = await sendRedemptionConfirmation({
-		eventId: redemption.eventId,
-		contactName: redemption.contactName,
-		contactEmail: redemption.contactEmail,
-		guestNames: redemption.guests
-	});
-	await recordConfirmationEmailResult(redemptionId, sent);
-	return sent ? 'SENT' : 'FAILED';
-};
-
-export const getAuditHistory = async (code: string): Promise<AuditLogEntry[]> => {
-	let conn = await NachklangTicketsDB.getConnection();
-	try {
-		const rows = await conn.query('SELECT * FROM voucher_audit_log WHERE code = ? ORDER BY created_at DESC', [code]);
-		return rows.map((row: any) => ({
-			auditId: row.audit_id,
-			code: row.code,
-			redemptionId: row.redemption_id,
-			adminEmail: row.admin_email,
-			action: row.action,
-			// The mariadb driver already deserializes JSON-typed columns into
-			// objects - only parse if we somehow got a raw string back.
-			changeSummary: typeof row.change_summary === 'string' ? JSON.parse(row.change_summary) : (row.change_summary ?? null),
-			reason: row.reason,
-			createdAt: row.created_at
-		}));
-	} finally {
-		await conn.end();
-	}
-};

src/models/tickets/admin/vouchers.admin.router.ts

@@ -1,257 +0,0 @@
-import express, {Request, Response} from 'express';
-import * as VouchersAdminService from './vouchers.admin.service.js';
-import {sendServerError} from '../tickets.errors.js';
-
-export const vouchersAdminRouter = express.Router();
-
-/**
- * @swagger
- * /tickets/admin/vouchers:
- *      get:
- *          summary: List vouchers (admin)
- *          description: Filterable by event and status.
- *          tags: [tickets-admin]
- *          security:
- *              - AdminSessionCookie: []
- *          parameters:
- *              - in: query
- *                name: eventId
- *                schema:
- *                    type: integer
- *              - in: query
- *                name: status
- *                schema:
- *                    $ref: '#/components/schemas/VoucherStatus'
- *          responses:
- *              200:
- *                  description: Success
- *                  content:
- *                      application/json:
- *                          schema:
- *                              type: array
- *                              items:
- *                                  $ref: '#/components/schemas/VoucherCode'
- *              401:
- *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
- */
-vouchersAdminRouter.get('/', async (req: Request, res: Response) => {
-	try {
-		const eventId = req.query.eventId !== undefined ? Number(req.query.eventId) : undefined;
-		const status = req.query.status as any;
-		res.status(200).send(await VouchersAdminService.listVouchers({eventId, status}));
-	} catch (e: any) {
-		sendServerError(res, e);
-	}
-});
-
-/**
- * @swagger
- * /tickets/admin/vouchers/wildcard:
- *      post:
- *          summary: Batch-generate wildcard codes
- *          description: Generates `quantity` codes sharing the same eligible events and max-guest count, grouped under one batchId.
- *          tags: [tickets-admin]
- *          security:
- *              - AdminSessionCookie: []
- *          requestBody:
- *              required: true
- *              content:
- *                  application/json:
- *                      schema:
- *                          type: object
- *                          required: [eventIds, quantity]
- *                          properties:
- *                              eventIds:
- *                                  type: array
- *                                  items:
- *                                      type: integer
- *                              maxGuests:
- *                                  type: integer
- *                                  default: 2
- *                              quantity:
- *                                  type: integer
- *          responses:
- *              201:
- *                  description: Created
- *                  content:
- *                      application/json:
- *                          schema:
- *                              type: object
- *                              properties:
- *                                  codes:
- *                                      type: array
- *                                      items:
- *                                          type: string
- *              400:
- *                  description: Invalid input
- *              401:
- *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
- */
-vouchersAdminRouter.post('/wildcard', async (req: Request, res: Response) => {
-	try {
-		const {eventIds, maxGuests, quantity} = req.body || {};
-		if (!Array.isArray(eventIds) || eventIds.length === 0 || !quantity) {
-			res.status(400).send({status: 'BAD_REQUEST', message: 'eventIds and quantity are required'});
-			return;
-		}
-		const codes = await VouchersAdminService.generateWildcardBatch(
-			{eventIds, maxGuests: maxGuests || 2, quantity},
-			res.locals.admin.email
-		);
-		res.status(201).send({codes});
-	} catch (e: any) {
-		res.status(400).send({status: 'BAD_REQUEST', message: e.message});
-	}
-});
-
-/**
- * @swagger
- * /tickets/admin/vouchers/personalized:
- *      post:
- *          summary: Bulk-create personalized codes
- *          description: One code per row (name, email, eligible events, max guests), grouped under one batchId.
- *          tags: [tickets-admin]
- *          security:
- *              - AdminSessionCookie: []
- *          requestBody:
- *              required: true
- *              content:
- *                  application/json:
- *                      schema:
- *                          type: object
- *                          required: [rows]
- *                          properties:
- *                              rows:
- *                                  type: array
- *                                  items:
- *                                      type: object
- *                                      required: [name, email, eventIds]
- *                                      properties:
- *                                          name:
- *                                              type: string
- *                                          email:
- *                                              type: string
- *                                          eventIds:
- *                                              type: array
- *                                              items:
- *                                                  type: integer
- *                                          maxGuests:
- *                                              type: integer
- *                                              default: 2
- *          responses:
- *              201:
- *                  description: Created
- *              400:
- *                  description: Invalid input
- *              401:
- *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
- */
-vouchersAdminRouter.post('/personalized', async (req: Request, res: Response) => {
-	try {
-		const rows = (req.body?.rows || []).map((r: any) => ({
-			name: r.name,
-			email: r.email,
-			eventIds: r.eventIds || [],
-			maxGuests: r.maxGuests || 2
-		}));
-		const codes = await VouchersAdminService.generatePersonalizedBatch(rows, res.locals.admin.email);
-		res.status(201).send({codes});
-	} catch (e: any) {
-		res.status(400).send({status: 'BAD_REQUEST', message: e.message});
-	}
-});
-
-/**
- * @swagger
- * /tickets/admin/vouchers/{code}:
- *      get:
- *          summary: Get a single voucher (admin)
- *          tags: [tickets-admin]
- *          security:
- *              - AdminSessionCookie: []
- *          parameters:
- *              - in: path
- *                name: code
- *                required: true
- *                schema:
- *                    type: string
- *          responses:
- *              200:
- *                  description: Success
- *              404:
- *                  description: Unknown code
- *              401:
- *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
- */
-vouchersAdminRouter.get('/:code', async (req: Request, res: Response) => {
-	try {
-		const voucher = await VouchersAdminService.getVoucher(req.params.code);
-		if (!voucher) {
-			res.status(404).send({status: 'NOT_FOUND'});
-			return;
-		}
-		res.status(200).send(voucher);
-	} catch (e: any) {
-		sendServerError(res, e);
-	}
-});
-
-/**
- * @swagger
- * /tickets/admin/vouchers/{code}/void:
- *      post:
- *          summary: Void an unredeemed code
- *          description: Only allowed while the code is UNUSED. Logs to the voucher's audit trail.
- *          tags: [tickets-admin]
- *          security:
- *              - AdminSessionCookie: []
- *          parameters:
- *              - in: path
- *                name: code
- *                required: true
- *                schema:
- *                    type: string
- *          requestBody:
- *              content:
- *                  application/json:
- *                      schema:
- *                          type: object
- *                          properties:
- *                              reason:
- *                                  type: string
- *          responses:
- *              200:
- *                  description: Voided
- *              404:
- *                  description: Unknown code
- *              409:
- *                  description: Code is not in UNUSED status
- *              401:
- *                  description: Unauthorized
- *              403:
- *                  description: Signed in without the permission for this app, or account disabled
- */
-vouchersAdminRouter.post('/:code/void', async (req: Request, res: Response) => {
-	try {
-		const result = await VouchersAdminService.voidCode(req.params.code, res.locals.admin.email, req.body?.reason || null);
-		if (result === 'NOT_FOUND') {
-			res.status(404).send({status: 'NOT_FOUND'});
-			return;
-		}
-		if (result === 'NOT_UNUSED') {
-			res.status(409).send({status: 'NOT_UNUSED', message: 'Only unused codes can be voided.'});
-			return;
-		}
-		res.status(200).send({status: 'OK'});
-	} catch (e: any) {
-		sendServerError(res, e);
-	}
-});

src/models/tickets/admin/vouchers.admin.service.ts

@@ -1,244 +0,0 @@
-import {Guid} from 'guid-typescript';
-import {NachklangTicketsDB} from '../Tickets.db.js';
-import {generateUniqueCode} from '../tickets.codes.js';
-import {VoucherCode, VoucherStatus} from '../tickets.interface.js';
-import {isValidEmail} from '../tickets.validation.js';
-
-export interface WildcardGenerateInput {
-	eventIds: number[];
-	maxGuests: number;
-	quantity: number;
-}
-
-export interface PersonalizedRowInput {
-	name: string;
-	email: string;
-	eventIds: number[];
-	maxGuests: number;
-}
-
-const mapVoucherRow = (row: any): VoucherCode => ({
-	code: row.code,
-	status: row.status,
-	maxGuests: row.max_guests,
-	prefillName: row.prefill_name,
-	prefillEmail: row.prefill_email,
-	batchId: row.batch_id,
-	createdByEmail: row.created_by_email,
-	createdAt: row.created_at,
-	eligibleEventIds: []
-});
-
-/**
- * Guards the event allow-list (event_ticket_settings) at the one place
- * codes actually get minted - the admin event picker already filters to
- * allow-listed events, but that's cosmetic unless generation enforces the
- * same rule server-side. Without this, any event_id could be passed
- * directly (bypassing the picker) and get a fully-uncapped, no-deadline
- * redeemable code minted for a non-concert Calendar event.
- */
-const assertEventsAllowListed = async (conn: any, eventIds: number[]): Promise<void> => {
-	const uniqueIds = [...new Set(eventIds)];
-	const rows = await conn.query('SELECT event_id FROM event_ticket_settings WHERE event_id IN (?)', [uniqueIds]);
-	const allowListed = new Set<number>(rows.map((r: any) => r.event_id));
-	const missing = uniqueIds.filter(id => !allowListed.has(id));
-	if (missing.length > 0) {
-		throw new Error(`event(s) not added to the ticket shop yet: ${missing.join(', ')}`);
-	}
-};
-
-/**
- * Attaches eligibleEventIds to a list of voucher rows in one extra query,
- * rather than N+1 per code.
- */
-const attachEligibleEvents = async (conn: any, vouchers: VoucherCode[]): Promise<VoucherCode[]> => {
-	if (vouchers.length === 0) return vouchers;
-	const codes = vouchers.map(v => v.code);
-	const rows = await conn.query('SELECT code, event_id FROM voucher_code_events WHERE code IN (?)', [codes]);
-	const byCode = new Map<string, number[]>();
-	for (const row of rows) {
-		const list = byCode.get(row.code) || [];
-		list.push(row.event_id);
-		byCode.set(row.code, list);
-	}
-	for (const voucher of vouchers) {
-		voucher.eligibleEventIds = byCode.get(voucher.code) || [];
-	}
-	return vouchers;
-};
-
-/**
- * Batch-generates N wildcard codes sharing the same eligible events and
- * max-guest count. All codes get the same batchId so the admin UI can group
- * "codes generated together" (e.g. for printing a sheet for the conductor).
- */
-export const generateWildcardBatch = async (input: WildcardGenerateInput, createdByEmail: string): Promise<string[]> => {
-	if (input.quantity < 1 || input.quantity > 500) {
-		throw new Error('quantity must be between 1 and 500');
-	}
-	if (input.eventIds.length === 0) {
-		throw new Error('at least one eligible event is required');
-	}
-
-	let conn = await NachklangTicketsDB.getConnection();
-	try {
-		await conn.beginTransaction();
-
-		await assertEventsAllowListed(conn, input.eventIds);
-
-		const existingRows = await conn.query('SELECT code FROM voucher_codes');
-		const existingCodes = new Set<string>(existingRows.map((r: any) => r.code));
-
-		const batchId = Guid.create().toString();
-		const codes: string[] = [];
-		for (let i = 0; i < input.quantity; i++) {
-			const code = generateUniqueCode(existingCodes);
-			codes.push(code);
-			await conn.query(
-				'INSERT INTO voucher_codes (code, status, max_guests, batch_id, created_by_email) VALUES (?,?,?,?,?)',
-				[code, 'UNUSED', input.maxGuests, batchId, createdByEmail]
-			);
-			for (const eventId of input.eventIds) {
-				await conn.query('INSERT INTO voucher_code_events (code, event_id) VALUES (?,?)', [code, eventId]);
-			}
-		}
-
-		await conn.commit();
-		return codes;
-	} catch (err) {
-		await conn.rollback();
-		throw err;
-	} finally {
-		await conn.end();
-	}
-};
-
-/**
- * Bulk-creates personalized codes from a list of rows (repeating-row admin
- * UI - see docs/plan-ticket-shop.md). One code per row, all sharing a
- * batchId for the submission.
- */
-export const generatePersonalizedBatch = async (rows: PersonalizedRowInput[], createdByEmail: string): Promise<string[]> => {
-	if (rows.length === 0) {
-		throw new Error('at least one row is required');
-	}
-	for (const row of rows) {
-		if (!row.name || !row.email || row.eventIds.length === 0) {
-			throw new Error('each row requires a name, email, and at least one eligible event');
-		}
-		if (!isValidEmail(row.email)) {
-			throw new Error(`"${row.email}" does not look like a valid email address`);
-		}
-	}
-
-	let conn = await NachklangTicketsDB.getConnection();
-	try {
-		await conn.beginTransaction();
-
-		await assertEventsAllowListed(conn, rows.flatMap(r => r.eventIds));
-
-		const existingRows = await conn.query('SELECT code FROM voucher_codes');
-		const existingCodes = new Set<string>(existingRows.map((r: any) => r.code));
-
-		const batchId = Guid.create().toString();
-		const codes: string[] = [];
-		for (const row of rows) {
-			const code = generateUniqueCode(existingCodes);
-			codes.push(code);
-			await conn.query(
-				'INSERT INTO voucher_codes (code, status, max_guests, prefill_name, prefill_email, batch_id, created_by_email) VALUES (?,?,?,?,?,?,?)',
-				[code, 'UNUSED', row.maxGuests, row.name, row.email, batchId, createdByEmail]
-			);
-			for (const eventId of row.eventIds) {
-				await conn.query('INSERT INTO voucher_code_events (code, event_id) VALUES (?,?)', [code, eventId]);
-			}
-		}
-
-		await conn.commit();
-		return codes;
-	} catch (err) {
-		await conn.rollback();
-		throw err;
-	} finally {
-		await conn.end();
-	}
-};
-
-export interface ListVouchersFilter {
-	eventId?: number;
-	status?: VoucherStatus;
-}
-
-export const listVouchers = async (filter: ListVouchersFilter): Promise<VoucherCode[]> => {
-	let conn = await NachklangTicketsDB.getConnection();
-	try {
-		let query = 'SELECT vc.* FROM voucher_codes vc';
-		const params: any[] = [];
-		const where: string[] = [];
-
-		if (filter.eventId !== undefined) {
-			query += ' INNER JOIN voucher_code_events vce ON vce.code = vc.code';
-			where.push('vce.event_id = ?');
-			params.push(filter.eventId);
-		}
-		if (filter.status) {
-			where.push('vc.status = ?');
-			params.push(filter.status);
-		}
-		if (where.length > 0) {
-			query += ' WHERE ' + where.join(' AND ');
-		}
-		query += ' GROUP BY vc.code ORDER BY vc.created_at DESC';
-
-		const rows = await conn.query(query, params);
-		const vouchers = rows.map(mapVoucherRow);
-		return await attachEligibleEvents(conn, vouchers);
-	} finally {
-		await conn.end();
-	}
-};
-
-export const getVoucher = async (code: string): Promise<VoucherCode | null> => {
-	let conn = await NachklangTicketsDB.getConnection();
-	try {
-		const rows = await conn.query('SELECT * FROM voucher_codes WHERE code = ?', [code]);
-		if (rows.length === 0) return null;
-		const [voucher] = await attachEligibleEvents(conn, [mapVoucherRow(rows[0])]);
-		return voucher;
-	} finally {
-		await conn.end();
-	}
-};
-
-export type VoidCodeResult = 'VOIDED' | 'NOT_FOUND' | 'NOT_UNUSED';
-
-export const voidCode = async (code: string, adminEmail: string, reason: string | null): Promise<VoidCodeResult> => {
-	let conn = await NachklangTicketsDB.getConnection();
-	try {
-		await conn.beginTransaction();
-
-		const rows = await conn.query('SELECT status FROM voucher_codes WHERE code = ?', [code]);
-		if (rows.length === 0) {
-			await conn.rollback();
-			return 'NOT_FOUND';
-		}
-		if (rows[0].status !== 'UNUSED') {
-			await conn.rollback();
-			return 'NOT_UNUSED';
-		}
-
-		await conn.query('UPDATE voucher_codes SET status = ? WHERE code = ?', ['VOID', code]);
-		await conn.query(
-			'INSERT INTO voucher_audit_log (code, redemption_id, admin_email, action, reason) VALUES (?,NULL,?,?,?)',
-			[code, adminEmail, 'VOID', reason]
-		);
-
-		await conn.commit();
-		return 'VOIDED';
-	} catch (err) {
-		await conn.rollback();
-		throw err;
-	} finally {
-		await conn.end();
-	}
-};

src/models/tickets/public/public.router.ts

@@ -1,135 +0,0 @@
-import express, {Request, Response} from 'express';
-import * as VoucherPublicService from './voucher.public.service.js';
-import {sendServerError} from '../tickets.errors.js';
-import {hashIp, redeemLimiter, validateLimiter} from '../tickets.ratelimit.js';
-
-export const publicRouter = express.Router();
-
-publicRouter.get('/', async (req: Request, res: Response) => {
-	res.status(200).send('Nachklang e.V. Tickets API Endpoint');
-});
-
-const rateLimitGuard = (req: Request, res: Response, limiter: typeof validateLimiter): string | null => {
-	const ipHash = hashIp(req.ip || '');
-	if (limiter.isRateLimited(ipHash)) {
-		res.status(429).send({status: 'RATE_LIMITED', message: 'Zu viele Anfragen. Bitte versuche es später erneut.'});
-		return null;
-	}
-	return ipHash;
-};
-
-/**
- * @swagger
- * /tickets/voucher/{code}:
- *      get:
- *          summary: Validate a voucher code
- *          description: Returns status, prefill data, and eligible events (with deadline/capacity state) for a code. Rate-limited per IP.
- *          tags: [tickets]
- *          parameters:
- *              - in: path
- *                name: code
- *                required: true
- *                schema:
- *                    type: string
- *          responses:
- *              200:
- *                  description: Success
- *                  content:
- *                      application/json:
- *                          schema:
- *                              $ref: '#/components/schemas/VoucherValidation'
- *              404:
- *                  description: Unknown code
- *              429:
- *                  description: Rate limited
- */
-publicRouter.get('/voucher/:code', async (req: Request, res: Response) => {
-	try {
-		const ipHash = rateLimitGuard(req, res, validateLimiter);
-		if (!ipHash) return;
-		validateLimiter.recordRequest(ipHash);
-
-		const voucher = await VoucherPublicService.validateVoucher(req.params.code.toUpperCase());
-		if (!voucher) {
-			res.status(404).send({status: 'NOT_FOUND'});
-			return;
-		}
-		res.status(200).send(voucher);
-	} catch (e: any) {
-		sendServerError(res, e);
-	}
-});
-
-/**
- * @swagger
- * /tickets/voucher/{code}/redeem:
- *      post:
- *          summary: Redeem a voucher code
- *          description: Marks the code redeemed, records the redemption, and sends a confirmation email with an .ics attachment. Rate-limited per IP.
- *          tags: [tickets]
- *          parameters:
- *              - in: path
- *                name: code
- *                required: true
- *                schema:
- *                    type: string
- *          requestBody:
- *              required: true
- *              content:
- *                  application/json:
- *                      schema:
- *                          $ref: '#/components/schemas/RedeemRequest'
- *          responses:
- *              200:
- *                  description: Redeemed
- *              400:
- *                  description: Invalid request
- *              404:
- *                  description: Unknown code
- *              409:
- *                  description: Code already used, event no longer eligible, deadline passed, or capacity exceeded
- *              429:
- *                  description: Rate limited
- */
-publicRouter.post('/voucher/:code/redeem', async (req: Request, res: Response) => {
-	try {
-		const ipHash = rateLimitGuard(req, res, redeemLimiter);
-		if (!ipHash) return;
-		redeemLimiter.recordRequest(ipHash);
-
-		const code = req.params.code.toUpperCase();
-		const {eventId, contactName, contactEmail, contactAddress, guests} = req.body || {};
-		if (!eventId || !contactName || !contactEmail || !Array.isArray(guests)) {
-			res.status(400).send({status: 'BAD_REQUEST', message: 'eventId, contactName, contactEmail, and guests are required'});
-			return;
-		}
-
-		const result = await VoucherPublicService.redeemVoucher(code, {eventId, contactName, contactEmail, contactAddress, guests});
-
-		switch (result.status) {
-			case 'OK':
-				res.status(200).send({status: 'OK', redemptionId: result.redemptionId});
-				return;
-			case 'NOT_FOUND':
-				res.status(404).send({status: 'NOT_FOUND'});
-				return;
-			case 'ALREADY_USED':
-				res.status(409).send({status: 'ALREADY_USED', message: 'Dieser Code wurde bereits eingelöst.'});
-				return;
-			case 'INVALID_EVENT':
-				res.status(409).send({status: 'INVALID_EVENT', message: 'Dieses Konzert ist für diesen Code nicht verfügbar.'});
-				return;
-			case 'DEADLINE_PASSED':
-				res.status(409).send({status: 'DEADLINE_PASSED', message: 'Die Anmeldefrist für dieses Konzert ist abgelaufen.'});
-				return;
-			case 'CAPACITY_EXCEEDED':
-				res.status(409).send({status: 'CAPACITY_EXCEEDED', message: 'Nicht genügend freie Plätze für dieses Konzert.', spotsRemaining: result.spotsRemaining});
-				return;
-			case 'ADDRESS_REQUIRED':
-				res.status(409).send({status: 'ADDRESS_REQUIRED', message: 'Für dieses Konzert ist eine Adresse erforderlich.'});
-				return;
-		}
-	} catch (e: any) {
-		res.status(400).send({status: 'BAD_REQUEST', message: e.message});
-	}
-});

src/models/tickets/public/voucher.public.service.ts

@@ -1,184 +0,0 @@
-import * as EventsService from '../../calendar/events/events.service.js';
-import logger from '../../../middleware/logger.js';
-import {NachklangTicketsDB} from '../Tickets.db.js';
-import {getEventTicketState} from '../tickets.capacity.js';
-import {recordConfirmationEmailResult, sendRedemptionConfirmation} from '../tickets.confirmation-email.js';
-import {EligibleEvent, RedeemRequest, VoucherValidation} from '../tickets.interface.js';
-import {isValidEmail} from '../tickets.validation.js';
-
-/**
- * Builds the eligible-events list for a code: for each event it's linked
- * to, merges live Calendar event details with the Tickets module's own
- * capacity/deadline state. Events deleted from the calendar since the code
- * was generated are silently skipped rather than erroring. DRAFT events are
- * deliberately still eligible - vouchers are sometimes sent out before a
- * concert is publicly announced (see docs/plan-ticket-shop.md), so only
- * DELETED is excluded here, not draft/unpublished status.
- */
-export const validateVoucher = async (code: string): Promise<VoucherValidation | null> => {
-	let conn = await NachklangTicketsDB.getConnection();
-	try {
-		const voucherRows = await conn.query('SELECT * FROM voucher_codes WHERE code = ?', [code]);
-		if (voucherRows.length === 0) {
-			return null;
-		}
-		const voucher = voucherRows[0];
-
-		const eventIdRows = await conn.query('SELECT event_id FROM voucher_code_events WHERE code = ?', [code]);
-		const eligibleEvents: EligibleEvent[] = [];
-		const now = new Date();
-
-		for (const row of eventIdRows) {
-			const eventId = row.event_id;
-			const event = await EventsService.getEventById(eventId);
-			if (!event || event.status === 'DELETED') continue;
-
-			const ticketState = await getEventTicketState(conn, eventId);
-			eligibleEvents.push({
-				eventId,
-				name: event.name,
-				startDateTime: event.startDateTime,
-				location: event.location,
-				deadlinePassed: ticketState.redemptionDeadline !== null && now > new Date(ticketState.redemptionDeadline),
-				isFull: ticketState.spotsRemaining !== null && ticketState.spotsRemaining <= 0,
-				spotsRemaining: ticketState.spotsRemaining,
-				collectAddress: ticketState.collectAddress,
-				requireAddress: ticketState.requireAddress
-			});
-		}
-
-		eligibleEvents.sort((a, b) => a.startDateTime.getTime() - b.startDateTime.getTime());
-
-		return {
-			code: voucher.code,
-			status: voucher.status,
-			maxGuests: voucher.max_guests,
-			prefillName: voucher.prefill_name,
-			prefillEmail: voucher.prefill_email,
-			eligibleEvents
-		};
-	} finally {
-		await conn.end();
-	}
-};
-
-export type RedeemResult =
-	| {status: 'OK'; redemptionId: number}
-	| {status: 'NOT_FOUND'}
-	| {status: 'ALREADY_USED'}
-	| {status: 'INVALID_EVENT'}
-	| {status: 'DEADLINE_PASSED'}
-	| {status: 'CAPACITY_EXCEEDED'; spotsRemaining: number}
-	| {status: 'ADDRESS_REQUIRED'};
-
-export const redeemVoucher = async (code: string, request: RedeemRequest): Promise<RedeemResult> => {
-	if (!request.contactName || !request.contactEmail || !Array.isArray(request.guests) || request.guests.length === 0) {
-		throw new Error('contactName, contactEmail, and at least one guest are required');
-	}
-	if (!isValidEmail(request.contactEmail)) {
-		throw new Error('contactEmail does not look like a valid email address');
-	}
-	for (const guest of request.guests) {
-		if (!guest.name) {
-			throw new Error('every guest requires a name');
-		}
-	}
-
-	let conn = await NachklangTicketsDB.getConnection();
-	let redemptionId: number;
-	let eventId: number;
-	try {
-		await conn.beginTransaction();
-
-		// Locks the code row so two concurrent requests for the same code
-		// can't both pass the "still UNUSED" check.
-		const voucherRows = await conn.query('SELECT * FROM voucher_codes WHERE code = ? FOR UPDATE', [code]);
-		if (voucherRows.length === 0) {
-			await conn.rollback();
-			return {status: 'NOT_FOUND'};
-		}
-		const voucher = voucherRows[0];
-		if (voucher.status !== 'UNUSED') {
-			await conn.rollback();
-			return {status: 'ALREADY_USED'};
-		}
-
-		const eligibleRows = await conn.query('SELECT 1 FROM voucher_code_events WHERE code = ? AND event_id = ?', [code, request.eventId]);
-		if (eligibleRows.length === 0) {
-			await conn.rollback();
-			return {status: 'INVALID_EVENT'};
-		}
-
-		// A concert can be canceled/deleted from the calendar after codes were
-		// issued - without this, such a code would stay silently redeemable.
-		// DRAFT is deliberately still allowed (see validateVoucher's comment).
-		const event = await EventsService.getEventById(request.eventId);
-		if (!event || event.status === 'DELETED') {
-			await conn.rollback();
-			return {status: 'INVALID_EVENT'};
-		}
-
-		if (request.guests.length > voucher.max_guests) {
-			await conn.rollback();
-			throw new Error(`this code allows at most ${voucher.max_guests} guests`);
-		}
-
-		// forUpdate=true serializes concurrent redemptions against this event
-		// so the capacity check below can't race past a hard cap.
-		const ticketState = await getEventTicketState(conn, request.eventId, true);
-		const now = new Date();
-		if (ticketState.redemptionDeadline !== null && now > new Date(ticketState.redemptionDeadline)) {
-			await conn.rollback();
-			return {status: 'DEADLINE_PASSED'};
-		}
-		if (ticketState.spotsRemaining !== null && request.guests.length > ticketState.spotsRemaining) {
-			await conn.rollback();
-			return {status: 'CAPACITY_EXCEEDED', spotsRemaining: ticketState.spotsRemaining};
-		}
-		if (ticketState.requireAddress && !request.contactAddress?.trim()) {
-			await conn.rollback();
-			return {status: 'ADDRESS_REQUIRED'};
-		}
-
-		const contactAddress = ticketState.collectAddress ? (request.contactAddress || null) : null;
-
-		const redemptionRes = await conn.query(
-			'INSERT INTO redemptions (code, event_id, contact_name, contact_email, contact_address, guest_count) VALUES (?,?,?,?,?,?) RETURNING redemption_id',
-			[code, request.eventId, request.contactName, request.contactEmail, contactAddress, request.guests.length]
-		);
-		redemptionId = redemptionRes[0].redemption_id;
-		eventId = request.eventId;
-
-		for (let i = 0; i < request.guests.length; i++) {
-			await conn.query('INSERT INTO redemption_guests (redemption_id, name, position) VALUES (?,?,?)', [redemptionId, request.guests[i].name, i]);
-		}
-
-		await conn.query('UPDATE voucher_codes SET status = ? WHERE code = ?', ['REDEEMED', code]);
-
-		await conn.commit();
-	} catch (err) {
-		await conn.rollback();
-		throw err;
-	} finally {
-		await conn.end();
-	}
-
-	// Sent after commit, mirroring the Calendar/Feedback convention: a mail
-	// delivery failure shouldn't roll back a successful redemption, and the
-	// guest has in fact already secured their spot. The send itself no longer
-	// throws on a delivery problem; its result is recorded on the redemption
-	// so staff can spot and resend a failed confirmation from the admin UI.
-	try {
-		const sent = await sendRedemptionConfirmation({
-			eventId,
-			contactName: request.contactName,
-			contactEmail: request.contactEmail,
-			guestNames: request.guests.map(g => g.name)
-		});
-		await recordConfirmationEmailResult(redemptionId, sent);
-	} catch (e: any) {
-		logger.error('Redemption ' + redemptionId + ' committed but the confirmation email step failed: ' + e.message);
-	}
-
-	return {status: 'OK', redemptionId};
-};

src/models/tickets/tickets.auth.ts

@@ -1,31 +0,0 @@
-import {requireAppAccess} from '../admin/admin.middleware.js';
-
-/**
- * Mirrors the Feedback module's feedback.auth.ts: this is the ONLY place in
- * the tickets module that knows how admin authentication works. No route
- * handler and no service outside this file may read session headers or
- * resolve a user itself.
- *
- * Today: the shared admin identity in `src/models/admin/`. A session cookie
- * set by /admin/auth on admin.nachklang.art, plus a `tickets` permission on
- * the account. Both are re-checked on every request, so disabling a user or
- * taking their tickets permission away takes effect immediately.
- *
- * Before 2026-09-06 this was a header session against the calendar users
- * table, and any activated @nachklang.art account could administer vouchers
- * (see docs/plan-ticket-shop.md, which called a roles model out of scope for
- * v1). It is in scope now, and lives in the admin module rather than here.
- *
- * Explicitly forbidden: accepting session credentials from query parameters -
- * see DEFERRED_SECURITY.md item 1.
- */
-
-export interface AdminIdentity {
-	id: string;
-	email: string;
-	displayName: string;
-}
-
-// On failure: 401 when not signed in, 403 when signed in without the tickets
-// permission.
-export const requireAdminAuth = requireAppAccess('tickets');

src/models/tickets/tickets.capacity.ts

@@ -1,41 +0,0 @@
-export interface EventTicketState {
-	eventId: number;
-	capacity: number | null;
-	redemptionDeadline: Date | null;
-	collectAddress: boolean;
-	requireAddress: boolean;
-	guestsUsed: number;
-	spotsRemaining: number | null;
-}
-
-/**
- * Reads an event's voucher settings + live guest count within the caller's
- * connection/transaction. Absence of a settings row means uncapped/no
- * deadline/no address collection - the "absence over sentinels" convention
- * also used by the Feedback module.
- *
- * Pass forUpdate=true from inside the redeem transaction to lock the
- * settings row for the duration of that transaction, serializing concurrent
- * redemptions against the same event so the guestsUsed sum computed here
- * stays correct even under a last-spot race. Events with no settings row
- * (uncapped) don't need this - there's no cap to race against.
- */
-export const getEventTicketState = async (conn: any, eventId: number, forUpdate = false): Promise<EventTicketState> => {
-	const settingsQuery = `SELECT capacity, redemption_deadline, collect_address, require_address FROM event_ticket_settings WHERE event_id = ?${forUpdate ? ' FOR UPDATE' : ''}`;
-	const settingsRows = await conn.query(settingsQuery, [eventId]);
-	const capacity = settingsRows.length > 0 ? settingsRows[0].capacity : null;
-	const redemptionDeadline = settingsRows.length > 0 ? settingsRows[0].redemption_deadline : null;
-	const collectAddress = settingsRows.length > 0 ? !!settingsRows[0].collect_address : false;
-	// Only meaningful when collectAddress is also true - the field isn't
-	// shown/collected at all otherwise, so "required" is moot.
-	const requireAddress = collectAddress && settingsRows.length > 0 ? !!settingsRows[0].require_address : false;
-
-	const usedRows = await conn.query(
-		"SELECT COALESCE(SUM(guest_count), 0) as used FROM redemptions WHERE event_id = ? AND status = 'ACTIVE'",
-		[eventId]
-	);
-	const guestsUsed = Number(usedRows[0].used);
-	const spotsRemaining = capacity === null ? null : Math.max(0, capacity - guestsUsed);
-
-	return {eventId, capacity, redemptionDeadline, collectAddress, requireAddress, guestsUsed, spotsRemaining};
-};

src/models/tickets/tickets.codes.ts

@@ -1,38 +0,0 @@
-import * as crypto from 'crypto';
-
-// Excludes 0/O, 1/I/L to avoid look-alike confusion when a code is
-// hand-written, read aloud, or typed from a printed fallback under a QR
-// code. 31 symbols * 8 chars ≈ 39.6 bits of entropy - effectively
-// unguessable combined with rate-limiting on the redeem endpoint.
-const CODE_ALPHABET = 'ABCDEFGHJKMNPQRSTUVWXYZ23456789';
-const CODE_LENGTH = 8;
-
-/**
- * Generates a single random code. Uses crypto.randomInt (uniform, no
- * modulo bias) rather than Math.random() since these gate a real-world
- * concert invitation.
- */
-export const generateCode = (): string => {
-	let code = '';
-	for (let i = 0; i < CODE_LENGTH; i++) {
-		code += CODE_ALPHABET[crypto.randomInt(CODE_ALPHABET.length)];
-	}
-	return code;
-};
-
-/**
- * Generates a code guaranteed not to collide with any row `existingCodes`
- * already contains, tries up to `maxAttempts` times before giving up.
- * Collisions are astronomically unlikely at this entropy - this exists as
- * a correctness backstop, not because collisions are expected.
- */
-export const generateUniqueCode = (existingCodes: Set<string>, maxAttempts = 20): string => {
-	for (let i = 0; i < maxAttempts; i++) {
-		const candidate = generateCode();
-		if (!existingCodes.has(candidate)) {
-			existingCodes.add(candidate);
-			return candidate;
-		}
-	}
-	throw new Error('Could not generate a unique voucher code after ' + maxAttempts + ' attempts');
-};

src/models/tickets/tickets.confirmation-email.ts

@@ -1,76 +0,0 @@
-import * as EventsService from '../calendar/events/events.service.js';
-import * as IcalService from '../calendar/events/icalgenerator.service.js';
-import {MailService} from '../../common/common.mail.js';
-import logger from '../../middleware/logger.js';
-import {NachklangTicketsDB} from './Tickets.db.js';
-
-export type ConfirmationEmailStatus = 'SENT' | 'FAILED';
-
-// The redemption confirmation email is built and sent from here so the public
-// redeem path and the admin "resend" action share one copy of the German text
-// and the .ics attachment logic.
-
-const formatGermanDateTime = (date: Date): string =>
-	new Intl.DateTimeFormat('de-DE', {
-		dateStyle: 'full',
-		timeStyle: 'short',
-		timeZone: 'Europe/Berlin'
-	}).format(date);
-
-export interface ConfirmationRecipient {
-	eventId: number;
-	contactName: string;
-	contactEmail: string;
-	guestNames: string[];
-}
-
-/**
- * Sends the redemption confirmation email for one redemption. Returns whether
- * the mail was accepted by the relay. Never throws: a missing event is treated
- * as "not sent", and MailService.sendMail already swallows delivery failures.
- */
-export const sendRedemptionConfirmation = async (recipient: ConfirmationRecipient): Promise<boolean> => {
-	const event = await EventsService.getEventById(recipient.eventId);
-	if (!event) {
-		logger.error('Confirmation email skipped: event ' + recipient.eventId + ' no longer exists');
-		return false;
-	}
-
-	const guestList = recipient.guestNames.map(name => `- ${name}`).join('\n');
-	const body =
-		`Hallo ${recipient.contactName},\n\n` +
-		`vielen Dank für deine Anmeldung zu "${event.name}"!\n\n` +
-		`Termin: ${formatGermanDateTime(event.startDateTime)}\n` +
-		`Ort: ${event.location}\n\n` +
-		`Angemeldete Gäste:\n${guestList}\n\n` +
-		`Wir freuen uns auf dich!\n\nDein Nachklang-Team`;
-
-	let icsAttachment;
-	try {
-		const ics = await IcalService.convertToIcal([event]);
-		icsAttachment = [{filename: 'konzert.ics', content: ics, contentType: 'text/calendar'}];
-	} catch (e: any) {
-		// Non-fatal: the confirmation still goes out, just without the calendar file.
-		logger.warn('Confirmation email for event ' + recipient.eventId + ' sent without .ics attachment: ' + e?.message);
-		icsAttachment = undefined;
-	}
-
-	return MailService.sendMail(recipient.contactEmail, `Bestätigung: ${event.name}`, body, {attachments: icsAttachment});
-};
-
-/**
- * Records the outcome of a confirmation-email send on the redemption row so the
- * admin UI can flag failures. Best-effort: a failure to write the flag is
- * logged, never thrown - the redemption itself already succeeded.
- */
-export const recordConfirmationEmailResult = async (redemptionId: number, sent: boolean): Promise<void> => {
-	const status: ConfirmationEmailStatus = sent ? 'SENT' : 'FAILED';
-	let conn = await NachklangTicketsDB.getConnection();
-	try {
-		await conn.query('UPDATE redemptions SET confirmation_email_status = ? WHERE redemption_id = ?', [status, redemptionId]);
-	} catch (err: any) {
-		logger.error('Could not record confirmation email status for redemption ' + redemptionId + ': ' + err?.message);
-	} finally {
-		await conn.end();
-	}
-};

src/models/tickets/tickets.errors.ts

@@ -1,18 +0,0 @@
-import {Response} from 'express';
-import {Guid} from 'guid-typescript';
-import logger from '../../middleware/logger.js';
-
-/**
- * The tickets module's standard catch-block response: log with a reference
- * guid, never leak the real error message to the client. Mirrors the
- * Feedback module's feedback.errors.ts convention.
- */
-export const sendServerError = (res: Response, e: any): void => {
-	const errorGuid = Guid.create().toString();
-	logger.error('Error handling a request: ' + e.message, {reference: errorGuid});
-	res.status(500).send({
-		status: 'PROCESSING_ERROR',
-		message: 'Internal Server Error. Try again later.',
-		reference: errorGuid
-	});
-};

src/models/tickets/tickets.interface.ts

@@ -1,307 +0,0 @@
-/**
- * @swagger
- * components:
- *   schemas:
- *     VoucherStatus:
- *       type: string
- *       enum: [UNUSED, REDEEMED, VOID]
- *     RedemptionStatus:
- *       type: string
- *       enum: [ACTIVE, UNDONE]
- *     EligibleEvent:
- *       type: object
- *       required: [eventId, name, startDateTime, location, deadlinePassed, isFull, collectAddress, requireAddress]
- *       properties:
- *         eventId:
- *           type: integer
- *           example: 42
- *         name:
- *           type: string
- *           example: "Adventskonzert 2026"
- *         startDateTime:
- *           type: string
- *           format: date-time
- *         location:
- *           type: string
- *         deadlinePassed:
- *           type: boolean
- *         isFull:
- *           type: boolean
- *         spotsRemaining:
- *           type: integer
- *           nullable: true
- *           description: null when the event has no capacity cap set (uncapped)
- *         collectAddress:
- *           type: boolean
- *         requireAddress:
- *           type: boolean
- *     VoucherValidation:
- *       type: object
- *       required: [code, status, maxGuests, eligibleEvents]
- *       properties:
- *         code:
- *           type: string
- *           example: "K7F3M9QX"
- *         status:
- *           $ref: '#/components/schemas/VoucherStatus'
- *         maxGuests:
- *           type: integer
- *           example: 2
- *         prefillName:
- *           type: string
- *           nullable: true
- *         prefillEmail:
- *           type: string
- *           nullable: true
- *         eligibleEvents:
- *           type: array
- *           items:
- *             $ref: '#/components/schemas/EligibleEvent'
- *     RedeemGuest:
- *       type: object
- *       required: [name]
- *       properties:
- *         name:
- *           type: string
- *           example: "Erika Mustermann"
- *     RedeemRequest:
- *       type: object
- *       required: [eventId, contactName, contactEmail, guests]
- *       properties:
- *         eventId:
- *           type: integer
- *         contactName:
- *           type: string
- *         contactEmail:
- *           type: string
- *         contactAddress:
- *           type: string
- *           nullable: true
- *         guests:
- *           type: array
- *           items:
- *             $ref: '#/components/schemas/RedeemGuest'
- *     RedemptionSummary:
- *       type: object
- *       required: [redemptionId, code, eventId, status, contactName, contactEmail, guestCount, guests, redeemedAt]
- *       properties:
- *         redemptionId:
- *           type: integer
- *         code:
- *           type: string
- *         eventId:
- *           type: integer
- *         status:
- *           $ref: '#/components/schemas/RedemptionStatus'
- *         contactName:
- *           type: string
- *         contactEmail:
- *           type: string
- *         contactAddress:
- *           type: string
- *           nullable: true
- *         guestCount:
- *           type: integer
- *         guests:
- *           type: array
- *           items:
- *             type: string
- *         redeemedAt:
- *           type: string
- *           format: date-time
- *         confirmationEmailStatus:
- *           type: string
- *           enum: [SENT, FAILED]
- *           nullable: true
- *           description: Outcome of the redemption confirmation email. null until the send resolves.
- *     VoucherCode:
- *       type: object
- *       required: [code, status, maxGuests, createdByEmail, createdAt, eligibleEventIds]
- *       properties:
- *         code:
- *           type: string
- *         status:
- *           $ref: '#/components/schemas/VoucherStatus'
- *         maxGuests:
- *           type: integer
- *         prefillName:
- *           type: string
- *           nullable: true
- *         prefillEmail:
- *           type: string
- *           nullable: true
- *         batchId:
- *           type: string
- *           nullable: true
- *         createdByEmail:
- *           type: string
- *         createdAt:
- *           type: string
- *           format: date-time
- *         eligibleEventIds:
- *           type: array
- *           items:
- *             type: integer
- *     EventTicketSettings:
- *       type: object
- *       required: [eventId, collectAddress, requireAddress]
- *       properties:
- *         eventId:
- *           type: integer
- *         capacity:
- *           type: integer
- *           nullable: true
- *         redemptionDeadline:
- *           type: string
- *           format: date-time
- *           nullable: true
- *         collectAddress:
- *           type: boolean
- *         requireAddress:
- *           type: boolean
- *           description: Only meaningful when collectAddress is true.
- *     EventStats:
- *       type: object
- *       required: [eventId, collectAddress, requireAddress, guestsUsed, unusedCodes, redeemedCodes, voidCodes]
- *       properties:
- *         eventId:
- *           type: integer
- *         capacity:
- *           type: integer
- *           nullable: true
- *         redemptionDeadline:
- *           type: string
- *           format: date-time
- *           nullable: true
- *         collectAddress:
- *           type: boolean
- *         requireAddress:
- *           type: boolean
- *         guestsUsed:
- *           type: integer
- *         spotsRemaining:
- *           type: integer
- *           nullable: true
- *         unusedCodes:
- *           type: integer
- *         redeemedCodes:
- *           type: integer
- *         voidCodes:
- *           type: integer
- *     AuditLogEntry:
- *       type: object
- *       required: [auditId, code, adminEmail, action, createdAt]
- *       properties:
- *         auditId:
- *           type: integer
- *         code:
- *           type: string
- *         redemptionId:
- *           type: integer
- *           nullable: true
- *         adminEmail:
- *           type: string
- *         action:
- *           type: string
- *           enum: [EDIT, VOID, UNDO]
- *         changeSummary:
- *           type: object
- *           nullable: true
- *         reason:
- *           type: string
- *           nullable: true
- *         createdAt:
- *           type: string
- *           format: date-time
- */
-
-export type VoucherStatus = 'UNUSED' | 'REDEEMED' | 'VOID';
-export type RedemptionStatus = 'ACTIVE' | 'UNDONE';
-export type AuditAction = 'EDIT' | 'VOID' | 'UNDO';
-
-export interface EligibleEvent {
-	eventId: number;
-	name: string;
-	startDateTime: Date;
-	location: string;
-	deadlinePassed: boolean;
-	isFull: boolean;
-	spotsRemaining: number | null;
-	collectAddress: boolean;
-	requireAddress: boolean;
-}
-
-export interface VoucherValidation {
-	code: string;
-	status: VoucherStatus;
-	maxGuests: number;
-	prefillName: string | null;
-	prefillEmail: string | null;
-	eligibleEvents: EligibleEvent[];
-}
-
-export interface RedeemGuest {
-	name: string;
-}
-
-export interface RedeemRequest {
-	eventId: number;
-	contactName: string;
-	contactEmail: string;
-	contactAddress?: string | null;
-	guests: RedeemGuest[];
-}
-
-export interface RedemptionSummary {
-	redemptionId: number;
-	code: string;
-	eventId: number;
-	status: RedemptionStatus;
-	contactName: string;
-	contactEmail: string;
-	contactAddress: string | null;
-	guestCount: number;
-	guests: string[];
-	redeemedAt: Date;
-	// null until the post-redemption confirmation email send resolves.
-	confirmationEmailStatus: 'SENT' | 'FAILED' | null;
-}
-
-export interface VoucherCode {
-	code: string;
-	status: VoucherStatus;
-	maxGuests: number;
-	prefillName: string | null;
-	prefillEmail: string | null;
-	batchId: string | null;
-	createdByEmail: string;
-	createdAt: Date;
-	eligibleEventIds: number[];
-}
-
-export interface EventTicketSettings {
-	eventId: number;
-	capacity: number | null;
-	redemptionDeadline: Date | null;
-	collectAddress: boolean;
-	requireAddress: boolean;
-}
-
-export interface EventStats extends EventTicketSettings {
-	guestsUsed: number;
-	spotsRemaining: number | null;
-	unusedCodes: number;
-	redeemedCodes: number;
-	voidCodes: number;
-}
-
-export interface AuditLogEntry {
-	auditId: number;
-	code: string;
-	redemptionId: number | null;
-	adminEmail: string;
-	action: AuditAction;
-	changeSummary: Record<string, unknown> | null;
-	reason: string | null;
-	createdAt: Date;
-}

src/models/tickets/tickets.ratelimit.ts

@@ -1,68 +0,0 @@
-import * as crypto from 'crypto';
-import * as dotenv from 'dotenv';
-
-dotenv.config();
-
-const RATE_LIMIT_WINDOW_MIN = parseInt(process.env.TICKETS_RATE_LIMIT_WINDOW_MIN || '10', 10);
-const RATE_LIMIT_WINDOW_MS = RATE_LIMIT_WINDOW_MIN * 60 * 1000;
-
-// Salted per-process (not persisted/configured) - these limiters are
-// in-memory-only with no DB backstop, so the salt only needs to survive
-// for the current process's lifetime, unlike Feedback's FEEDBACK_IP_SALT
-// which also salts a persisted ip_hash column.
-const IP_SALT = crypto.randomBytes(32).toString('hex');
-
-export const hashIp = (ip: string): string => {
-	return crypto.createHash('sha256').update(IP_SALT + ip).digest('hex');
-};
-
-/**
- * Two independent budgets, not one shared counter: validating a code (GET)
- * is a cheap, repeatable lookup a guest's own browser triggers on every
- * page load/reload/back-navigation of their redemption link - a shared
- * budget with redeem meant a guest could exhaust it just by reloading the
- * page a few times before ever submitting. Redeeming (POST) is the
- * sensitive, code-consuming action and stays tightly limited; validating
- * is limited too (it's still the enumeration vector for guessing codes),
- * just with a much larger allowance headroomed for normal page-reload
- * behaviour.
- */
-const createLimiter = (max: number) => {
-	const recentRequests = new Map<string, number[]>();
-
-	const pruneOld = (timestamps: number[], now: number): number[] => {
-		return timestamps.filter(t => now - t < RATE_LIMIT_WINDOW_MS);
-	};
-
-	const sweepInterval = setInterval(() => {
-		const now = Date.now();
-		for (const [ipHash, timestamps] of recentRequests) {
-			if (pruneOld(timestamps, now).length === 0) {
-				recentRequests.delete(ipHash);
-			}
-		}
-	}, RATE_LIMIT_WINDOW_MS);
-	sweepInterval.unref();
-
-	return {
-		isRateLimited: (ipHash: string): boolean => {
-			const now = Date.now();
-			const timestamps = pruneOld(recentRequests.get(ipHash) || [], now);
-			if (timestamps.length > 0) {
-				recentRequests.set(ipHash, timestamps);
-			} else {
-				recentRequests.delete(ipHash);
-			}
-			return timestamps.length >= max;
-		},
-		recordRequest: (ipHash: string): void => {
-			const now = Date.now();
-			const timestamps = pruneOld(recentRequests.get(ipHash) || [], now);
-			timestamps.push(now);
-			recentRequests.set(ipHash, timestamps);
-		}
-	};
-};
-
-export const validateLimiter = createLimiter(parseInt(process.env.TICKETS_VALIDATE_RATE_LIMIT_MAX || '30', 10));
-export const redeemLimiter = createLimiter(parseInt(process.env.TICKETS_REDEEM_RATE_LIMIT_MAX || '10', 10));

src/models/tickets/tickets.validation.ts

@@ -1,6 +0,0 @@
-// Intentionally permissive - "looks like an email" (something@something.tld),
-// not full RFC 5322 validation. Good enough to catch typos without rejecting
-// real addresses RFC 5322 edge cases would.
-const EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
-
-export const isValidEmail = (email: string): boolean => EMAIL_REGEX.test(email.trim());

test/admin/admin.bootstrap.test.ts

@@ -1,96 +0,0 @@
-import {vi, describe, it, expect, beforeEach, type Mock} from 'vitest';
-
-vi.mock('../../src/models/admin/users/users.admin.service.js', () => ({
-	countActiveAdmins: vi.fn(),
-	findUserByEmail: vi.fn(),
-	grantPermission: vi.fn()
-}));
-vi.mock('../../src/models/admin/invitations/invitations.service.js', () => ({
-	hasOpenInvitationFor: vi.fn(),
-	createInvitation: vi.fn()
-}));
-vi.mock('../../src/models/admin/admin.mail.js', () => ({
-	sendInvitationMail: vi.fn()
-}));
-vi.mock('../../src/models/admin/admin.config.js', () => ({
-	ADMIN_BOOTSTRAP_EMAIL: 'boss@nachklang.art',
-	ADMIN_APP_URL: 'http://localhost:3002',
-	isProd: false
-}));
-
-import * as UsersService from '../../src/models/admin/users/users.admin.service.js';
-import * as InvitationsService from '../../src/models/admin/invitations/invitations.service.js';
-import {sendInvitationMail} from '../../src/models/admin/admin.mail.js';
-import {bootstrapAdmin} from '../../src/models/admin/admin.bootstrap.js';
-
-const countActiveAdmins = UsersService.countActiveAdmins as Mock;
-const findUserByEmail = UsersService.findUserByEmail as Mock;
-const grantPermission = UsersService.grantPermission as Mock;
-const hasOpenInvitationFor = InvitationsService.hasOpenInvitationFor as Mock;
-const createInvitation = InvitationsService.createInvitation as Mock;
-const mockMail = sendInvitationMail as Mock;
-
-beforeEach(() => {
-	countActiveAdmins.mockReset();
-	findUserByEmail.mockReset();
-	grantPermission.mockReset();
-	hasOpenInvitationFor.mockReset();
-	createInvitation.mockReset();
-	mockMail.mockReset();
-	mockMail.mockResolvedValue(true);
-	createInvitation.mockResolvedValue({id: 1, token: 'raw-token', expiresAt: new Date()});
-});
-
-describe('bootstrapAdmin', () => {
-	it('does nothing when an active admin already exists', async () => {
-		countActiveAdmins.mockResolvedValue(1);
-
-		await bootstrapAdmin();
-
-		expect(createInvitation).not.toHaveBeenCalled();
-		expect(grantPermission).not.toHaveBeenCalled();
-	});
-
-	it('grants admin directly when the bootstrap address is already a user', async () => {
-		countActiveAdmins.mockResolvedValue(0);
-		findUserByEmail.mockResolvedValue({id: 'u9', email: 'boss@nachklang.art'});
-
-		await bootstrapAdmin();
-
-		expect(grantPermission).toHaveBeenCalledWith('u9', 'admin', null);
-		expect(createInvitation).not.toHaveBeenCalled();
-	});
-
-	it('does not re-invite (or re-mail) while an open invitation exists', async () => {
-		countActiveAdmins.mockResolvedValue(0);
-		findUserByEmail.mockResolvedValue(null);
-		hasOpenInvitationFor.mockResolvedValue(true);
-
-		await bootstrapAdmin();
-
-		expect(createInvitation).not.toHaveBeenCalled();
-		expect(mockMail).not.toHaveBeenCalled();
-	});
-
-	it('invites with the admin permission when there is nothing to work with', async () => {
-		countActiveAdmins.mockResolvedValue(0);
-		findUserByEmail.mockResolvedValue(null);
-		hasOpenInvitationFor.mockResolvedValue(false);
-
-		await bootstrapAdmin();
-
-		expect(createInvitation).toHaveBeenCalledWith(
-			'boss@nachklang.art',
-			'Nachklang Admin',
-			[{app: 'admin', role: 'access'}],
-			null
-		);
-		expect(mockMail).toHaveBeenCalled();
-	});
-
-	it('never throws when the database is unreachable at boot', async () => {
-		countActiveAdmins.mockRejectedValue(new Error('connect ECONNREFUSED'));
-
-		await expect(bootstrapAdmin()).resolves.toBeUndefined();
-	});
-});

test/admin/admin.config.test.ts

@@ -1,143 +0,0 @@
-import {afterEach, beforeEach, describe, expect, it, vi} from 'vitest';
-
-// admin.config calls dotenv.config(), which would read the repo's own .env and
-// quietly reintroduce NODE_ENV=development - the exact value several of these
-// cases exist to remove. Stub it so the tests see only what they set.
-vi.mock('dotenv', () => ({config: vi.fn()}));
-
-/**
- * admin.config reads the environment once at import, so every case here has to
- * reset the module registry and re-import it. The two things worth pinning are
- * the ones that are silent when wrong: which client-IP header is trusted, and
- * whether an unset NODE_ENV counts as production.
- */
-
-const ORIGINAL_ENV = {...process.env};
-
-const loadConfig = async () => {
-	vi.resetModules();
-	return import('../../src/models/admin/admin.config.js');
-};
-
-beforeEach(() => {
-	process.env = {...ORIGINAL_ENV};
-	// dotenv.config() in admin.config does not overwrite what is already set,
-	// so setting these here is enough to keep the local .env out of the test.
-	process.env.NODE_ENV = 'test';
-	delete process.env.CLIENT_IP_HEADERS;
-	delete process.env.TRUSTED_PROXY_IPS;
-});
-
-afterEach(() => {
-	process.env = {...ORIGINAL_ENV};
-});
-
-describe('CLIENT_IP_HEADERS', () => {
-	it('defaults to the single header Plesk nginx sets', async () => {
-		const config = await loadConfig();
-		expect(config.CLIENT_IP_HEADERS).toEqual(['x-real-ip']);
-		expect(config.TRUST_NO_CLIENT_IP_HEADER).toBe(false);
-	});
-
-	it('reads a comma-separated list', async () => {
-		process.env.CLIENT_IP_HEADERS = 'x-real-ip, cf-connecting-ip';
-		const config = await loadConfig();
-		expect(config.CLIENT_IP_HEADERS).toEqual(['x-real-ip', 'cf-connecting-ip']);
-	});
-
-	it('trusts nothing when set to "none"', async () => {
-		// The escape hatch. An empty list is what better-auth reads as "no
-		// headers" - it only falls back to its own default when the option is
-		// absent - so this really does stop any header being believed.
-		process.env.CLIENT_IP_HEADERS = 'none';
-		const config = await loadConfig();
-		expect(config.CLIENT_IP_HEADERS).toEqual([]);
-		expect(config.TRUST_NO_CLIENT_IP_HEADER).toBe(true);
-	});
-
-	it('accepts the hatch case-insensitively and with stray whitespace', async () => {
-		process.env.CLIENT_IP_HEADERS = '  NONE  ';
-		const config = await loadConfig();
-		expect(config.CLIENT_IP_HEADERS).toEqual([]);
-	});
-
-	it('treats an empty value as "use the default", not as the hatch', async () => {
-		// A blank line in a .env must not silently change how requests are
-		// bucketed - only the explicit word does that.
-		process.env.CLIENT_IP_HEADERS = '';
-		const config = await loadConfig();
-		expect(config.CLIENT_IP_HEADERS).toEqual(['x-real-ip']);
-		expect(config.TRUST_NO_CLIENT_IP_HEADER).toBe(false);
-	});
-
-	it('does not mistake a header actually named none-ish for the hatch', async () => {
-		process.env.CLIENT_IP_HEADERS = 'x-none';
-		const config = await loadConfig();
-		expect(config.CLIENT_IP_HEADERS).toEqual(['x-none']);
-		expect(config.TRUST_NO_CLIENT_IP_HEADER).toBe(false);
-	});
-});
-
-describe('APP_ORIGINS', () => {
-	beforeEach(() => {
-		delete process.env.APP_ORIGINS;
-	});
-
-	// These reach better-auth's trustedOrigins, and the step 4 cutover made the
-	// tickets and feedback origins load-bearing: without them their sign-out
-	// call is rejected while everything else still works.
-	it('defaults to the two production frontends', async () => {
-		const config = await loadConfig();
-		expect(config.APP_ORIGINS).toEqual([
-			'https://tickets.nachklang.art',
-			'https://feedback.nachklang.art'
-		]);
-	});
-
-	it('is overridden wholesale by the environment, for a staging host', async () => {
-		process.env.APP_ORIGINS = 'https://tickets.staging.example, https://feedback.staging.example/';
-		const config = await loadConfig();
-		expect(config.APP_ORIGINS).toEqual([
-			'https://tickets.staging.example',
-			// Trailing slash stripped: an origin with one never matches.
-			'https://feedback.staging.example'
-		]);
-	});
-
-	it('always includes the admin app itself in ADMIN_ALLOWED_ORIGINS', async () => {
-		process.env.ADMIN_APP_URL = 'https://admin.nachklang.art';
-		const config = await loadConfig();
-		expect(config.ADMIN_ALLOWED_ORIGINS).toContain('https://admin.nachklang.art');
-		expect(config.ADMIN_ALLOWED_ORIGINS).toContain('https://tickets.nachklang.art');
-	});
-});
-
-describe('isProd', () => {
-	it('is false only for the explicit relaxed environments', async () => {
-		process.env.NODE_ENV = 'development';
-		expect((await loadConfig()).isProd).toBe(false);
-
-		process.env.NODE_ENV = 'test';
-		expect((await loadConfig()).isProd).toBe(false);
-	});
-
-	it('treats an unset NODE_ENV as production, which is what a bare vhost gives', async () => {
-		delete process.env.NODE_ENV;
-		// Strict mode refuses to boot without these; supply them so the import
-		// gets far enough to answer the question being asked.
-		process.env.BETTER_AUTH_SECRET = 'x'.repeat(48);
-		process.env.API_BASE_URL = 'https://api.nachklang.art';
-		process.env.ADMIN_APP_URL = 'https://admin.nachklang.art';
-
-		expect((await loadConfig()).isProd).toBe(true);
-	});
-
-	it('refuses to start without a signing key outside development', async () => {
-		delete process.env.NODE_ENV;
-		delete process.env.BETTER_AUTH_SECRET;
-		process.env.API_BASE_URL = 'https://api.nachklang.art';
-		process.env.ADMIN_APP_URL = 'https://admin.nachklang.art';
-
-		await expect(loadConfig()).rejects.toThrow(/BETTER_AUTH_SECRET/);
-	});
-});

test/admin/admin.mail.test.ts

@@ -1,71 +0,0 @@
-import {vi, describe, it, expect, beforeEach, type Mock} from 'vitest';
-
-vi.mock('../../src/common/common.mail.js', () => ({
-	MailService: {sendMail: vi.fn()}
-}));
-vi.mock('../../src/models/admin/admin.config.js', () => ({
-	ADMIN_APP_URL: 'https://admin.nachklang.art'
-}));
-
-import {MailService} from '../../src/common/common.mail.js';
-import {sendInvitationMail, sendPasswordResetMail} from '../../src/models/admin/admin.mail.js';
-
-const sendMail = MailService.sendMail as Mock;
-
-beforeEach(() => {
-	sendMail.mockReset();
-	sendMail.mockResolvedValue(true);
-});
-
-describe('sendInvitationMail', () => {
-	it('points at the admin app and carries the token in the query string', async () => {
-		await sendInvitationMail('a@nachklang.art', 'Anna', 'tok-en_123', new Date('2026-09-12T10:00:00Z'));
-
-		const [to, subject, text, options] = sendMail.mock.calls[0];
-		expect(to).toBe('a@nachklang.art');
-		expect(subject).toBeTruthy();
-		expect(text).toContain('https://admin.nachklang.art/accept-invite?token=tok-en_123');
-		expect(options.html).toContain('https://admin.nachklang.art/accept-invite?token=tok-en_123');
-	});
-
-	it('url-encodes a token containing url-significant characters', async () => {
-		await sendInvitationMail('a@nachklang.art', 'Anna', 'a+b/c=d', new Date());
-
-		const [, , text] = sendMail.mock.calls[0];
-		expect(text).toContain('token=a%2Bb%2Fc%3Dd');
-	});
-
-	it('sends both a text and an html part', async () => {
-		await sendInvitationMail('a@nachklang.art', 'Anna', 'tok', new Date());
-
-		const [, , text, options] = sendMail.mock.calls[0];
-		expect(text.length).toBeGreaterThan(0);
-		expect(options.html).toContain('<html');
-	});
-
-	it('escapes a name that contains html', async () => {
-		await sendInvitationMail('a@nachklang.art', '<script>alert(1)</script>', 'tok', new Date());
-
-		const [, , , options] = sendMail.mock.calls[0];
-		expect(options.html).not.toContain('<script>');
-		expect(options.html).toContain('&lt;script&gt;');
-	});
-
-	it('reports a delivery failure to the caller rather than throwing', async () => {
-		sendMail.mockResolvedValue(false);
-
-		await expect(sendInvitationMail('a@nachklang.art', 'Anna', 'tok', new Date())).resolves.toBe(false);
-	});
-});
-
-describe('sendPasswordResetMail', () => {
-	it('uses the url better-auth generated, unchanged', async () => {
-		const url = 'https://api.nachklang.art/admin/auth/reset-password/abc?callbackURL=x';
-
-		await sendPasswordResetMail('a@nachklang.art', 'Anna', url);
-
-		const [, , text, options] = sendMail.mock.calls[0];
-		expect(text).toContain(url);
-		expect(options.html).toContain('https://api.nachklang.art/admin/auth/reset-password/abc');
-	});
-});

test/admin/admin.middleware.test.ts

@@ -1,222 +0,0 @@
-import {vi, describe, it, expect, beforeEach, type Mock} from 'vitest';
-import {Request, Response} from 'express';
-
-vi.mock('../../src/models/admin/admin.auth.js', () => ({
-	auth: {api: {getSession: vi.fn()}}
-}));
-vi.mock('../../src/models/admin/users/users.admin.service.js', () => ({
-	loadAccess: vi.fn()
-}));
-
-import {auth} from '../../src/models/admin/admin.auth.js';
-import * as UsersService from '../../src/models/admin/users/users.admin.service.js';
-import {requireAppAccess, requireSignedIn, resolveAccess} from '../../src/models/admin/admin.middleware.js';
-
-const mockGetSession = auth.api.getSession as unknown as Mock;
-const mockLoadAccess = UsersService.loadAccess as Mock;
-
-const makeReq = (): Request => ({headers: {cookie: 'nachklang.session_token=abc'}} as unknown as Request);
-
-const makeRes = (): Response => {
-	const res: any = {};
-	res.status = vi.fn().mockReturnValue(res);
-	res.send = vi.fn().mockReturnValue(res);
-	res.locals = {};
-	return res as Response;
-};
-
-const activeUser = {
-	id: 'u1',
-	email: 'a@nachklang.art',
-	displayName: 'A',
-	disabled: false,
-	permissions: [
-		{app: 'feedback', role: 'access'},
-		{app: 'admin', role: 'access'}
-	],
-	apps: ['feedback', 'admin']
-};
-
-describe('resolveAccess', () => {
-	beforeEach(() => {
-		mockGetSession.mockReset();
-		mockLoadAccess.mockReset();
-	});
-
-	it('returns null without a valid session', async () => {
-		mockGetSession.mockResolvedValue(null);
-		expect(await resolveAccess(makeReq())).toBeNull();
-		expect(mockLoadAccess).not.toHaveBeenCalled();
-	});
-
-	it('returns null when the session points at a user row that is gone', async () => {
-		mockGetSession.mockResolvedValue({user: {id: 'u1'}});
-		mockLoadAccess.mockResolvedValue(null);
-		expect(await resolveAccess(makeReq())).toBeNull();
-	});
-
-	it('resolves identity and permissions in a single permission query', async () => {
-		mockGetSession.mockResolvedValue({user: {id: 'u1'}});
-		mockLoadAccess.mockResolvedValue(activeUser);
-
-		expect(await resolveAccess(makeReq())).toEqual({
-			id: 'u1',
-			email: 'a@nachklang.art',
-			displayName: 'A',
-			disabled: false,
-			permissions: [
-				{app: 'feedback', role: 'access'},
-				{app: 'admin', role: 'access'}
-			],
-			apps: ['feedback', 'admin']
-		});
-		// No cookieCache: exactly one lookup per request, never zero.
-		expect(mockLoadAccess).toHaveBeenCalledTimes(1);
-	});
-});
-
-describe('requireSignedIn', () => {
-	beforeEach(() => {
-		mockGetSession.mockReset();
-		mockLoadAccess.mockReset();
-	});
-
-	it('401s without a session', async () => {
-		mockGetSession.mockResolvedValue(null);
-		const res = makeRes();
-		const next = vi.fn();
-
-		await requireSignedIn(makeReq(), res, next);
-
-		expect(res.status).toHaveBeenCalledWith(401);
-		expect(next).not.toHaveBeenCalled();
-	});
-
-	it('403s a disabled user that still holds a valid cookie', async () => {
-		mockGetSession.mockResolvedValue({user: {id: 'u1'}});
-		mockLoadAccess.mockResolvedValue({...activeUser, disabled: true});
-		const res = makeRes();
-		const next = vi.fn();
-
-		await requireSignedIn(makeReq(), res, next);
-
-		expect(res.status).toHaveBeenCalledWith(403);
-		expect(next).not.toHaveBeenCalled();
-	});
-
-	it('admits a signed-in user with no app permissions at all', async () => {
-		mockGetSession.mockResolvedValue({user: {id: 'u1'}});
-		mockLoadAccess.mockResolvedValue({...activeUser, apps: []});
-		const res = makeRes();
-		const next = vi.fn();
-
-		await requireSignedIn(makeReq(), res, next);
-
-		expect(next).toHaveBeenCalled();
-		expect(res.locals.admin.apps).toEqual([]);
-	});
-});
-
-describe('requireAppAccess', () => {
-	beforeEach(() => {
-		mockGetSession.mockReset();
-		mockLoadAccess.mockReset();
-	});
-
-	it('401s without a session', async () => {
-		mockGetSession.mockResolvedValue(null);
-		const res = makeRes();
-		const next = vi.fn();
-
-		await requireAppAccess('feedback')(makeReq(), res, next);
-
-		expect(res.status).toHaveBeenCalledWith(401);
-	});
-
-	it('403s a signed-in user without that app permission', async () => {
-		mockGetSession.mockResolvedValue({user: {id: 'u1'}});
-		mockLoadAccess.mockResolvedValue({
-			...activeUser,
-			permissions: [{app: 'feedback', role: 'access'}],
-			apps: ['feedback']
-		});
-		const res = makeRes();
-		const next = vi.fn();
-
-		await requireAppAccess('tickets')(makeReq(), res, next);
-
-		expect(res.status).toHaveBeenCalledWith(403);
-		expect(next).not.toHaveBeenCalled();
-	});
-
-	it('403s a disabled user even when they hold the permission', async () => {
-		mockGetSession.mockResolvedValue({user: {id: 'u1'}});
-		mockLoadAccess.mockResolvedValue({...activeUser, disabled: true});
-		const res = makeRes();
-		const next = vi.fn();
-
-		await requireAppAccess('feedback')(makeReq(), res, next);
-
-		expect(res.status).toHaveBeenCalledWith(403);
-	});
-
-	it('passes through and exposes the identity the feedback/tickets services expect', async () => {
-		mockGetSession.mockResolvedValue({user: {id: 'u1'}});
-		mockLoadAccess.mockResolvedValue(activeUser);
-		const res = makeRes();
-		const next = vi.fn();
-
-		await requireAppAccess('feedback')(makeReq(), res, next);
-
-		expect(next).toHaveBeenCalled();
-		expect(res.locals.admin).toMatchObject({id: 'u1', email: 'a@nachklang.art', displayName: 'A'});
-	});
-
-	it('500s (never allows through) when the permission query throws', async () => {
-		mockGetSession.mockResolvedValue({user: {id: 'u1'}});
-		mockLoadAccess.mockRejectedValue(new Error('db down'));
-		const res = makeRes();
-		const next = vi.fn();
-
-		await requireAppAccess('feedback')(makeReq(), res, next);
-
-		expect(res.status).toHaveBeenCalledWith(500);
-		expect(next).not.toHaveBeenCalled();
-	});
-
-	// The seam a finer per-app permission arrives through. Nothing passes a role
-	// today, so these two pin the behaviour before there is anything to break.
-	it('403s when a specific role is required and the user only holds another', async () => {
-		mockGetSession.mockResolvedValue({user: {id: 'u1'}});
-		mockLoadAccess.mockResolvedValue({
-			...activeUser,
-			permissions: [{app: 'tickets', role: 'access'}],
-			apps: ['tickets']
-		});
-		const res = makeRes();
-		const next = vi.fn();
-
-		await requireAppAccess('tickets', 'refund')(makeReq(), res, next);
-
-		expect(res.status).toHaveBeenCalledWith(403);
-		expect(next).not.toHaveBeenCalled();
-	});
-
-	it('passes when the user holds exactly the required role', async () => {
-		mockGetSession.mockResolvedValue({user: {id: 'u1'}});
-		mockLoadAccess.mockResolvedValue({
-			...activeUser,
-			permissions: [
-				{app: 'tickets', role: 'access'},
-				{app: 'tickets', role: 'refund'}
-			],
-			apps: ['tickets']
-		});
-		const res = makeRes();
-		const next = vi.fn();
-
-		await requireAppAccess('tickets', 'refund')(makeReq(), res, next);
-
-		expect(next).toHaveBeenCalled();
-	});
-});

test/admin/admin.schema.test.ts

@@ -1,99 +0,0 @@
-import {describe, expect, it} from 'vitest';
-import {
-	ACCESS_ROLE,
-	appsOf,
-	isAppPermission,
-	isAppRole,
-	toPermissions
-} from '../../src/models/admin/admin.schema.js';
-
-/**
- * The permission model is (app, role). These tests pin the two properties the
- * rest of the module leans on: that the older `['tickets']` shape still means
- * "tickets at the access role", and that nothing outside APP_ROLES gets in.
- */
-
-describe('toPermissions', () => {
-	it('reads the full (app, role) form', () => {
-		expect(toPermissions([{app: 'tickets', role: 'access'}])).toEqual([
-			{app: 'tickets', role: 'access'}
-		]);
-	});
-
-	it('reads a plain app list as that app at the access role', () => {
-		expect(toPermissions(['feedback', 'admin'])).toEqual([
-			{app: 'feedback', role: ACCESS_ROLE},
-			{app: 'admin', role: ACCESS_ROLE}
-		]);
-	});
-
-	it('accepts the two forms mixed, which is what a half-migrated caller sends', () => {
-		expect(toPermissions(['feedback', {app: 'tickets', role: 'access'}])).toEqual([
-			{app: 'feedback', role: ACCESS_ROLE},
-			{app: 'tickets', role: ACCESS_ROLE}
-		]);
-	});
-
-	it('drops duplicates of the same (app, role)', () => {
-		expect(toPermissions(['tickets', {app: 'tickets', role: 'access'}])).toEqual([
-			{app: 'tickets', role: ACCESS_ROLE}
-		]);
-	});
-
-	it('rejects rather than silently dropping an unknown app', () => {
-		// Silently ignoring it would let "grant calendar + nonsense" look like a
-		// success while granting less than the caller asked for.
-		expect(toPermissions(['calendar', 'nonsense'])).toBeNull();
-	});
-
-	it('rejects an unknown role', () => {
-		expect(toPermissions([{app: 'tickets', role: 'refund'}])).toBeNull();
-	});
-
-	it('rejects anything that is not a list', () => {
-		expect(toPermissions('admin')).toBeNull();
-		expect(toPermissions(null)).toBeNull();
-		expect(toPermissions({app: 'admin', role: 'access'})).toBeNull();
-	});
-
-	it('reads an empty list as "no permissions", not as invalid', () => {
-		expect(toPermissions([])).toEqual([]);
-	});
-});
-
-describe('isAppRole', () => {
-	it('accepts the access role for every app', () => {
-		expect(isAppRole('admin', ACCESS_ROLE)).toBe(true);
-		expect(isAppRole('calendar', ACCESS_ROLE)).toBe(true);
-	});
-
-	it('rejects a role that does not exist yet', () => {
-		expect(isAppRole('tickets', 'refund')).toBe(false);
-	});
-});
-
-describe('isAppPermission', () => {
-	it('needs both halves to be valid', () => {
-		expect(isAppPermission({app: 'tickets', role: ACCESS_ROLE})).toBe(true);
-		expect(isAppPermission({app: 'tickets'})).toBe(false);
-		expect(isAppPermission({role: ACCESS_ROLE})).toBe(false);
-		expect(isAppPermission(null)).toBe(false);
-	});
-});
-
-describe('appsOf', () => {
-	it('collapses several roles on one app to a single entry', () => {
-		// The point of the derived list: a user with two roles on tickets has
-		// access to tickets once, not twice.
-		const apps = appsOf([
-			{app: 'tickets', role: ACCESS_ROLE},
-			{app: 'tickets', role: 'future-role'},
-			{app: 'admin', role: ACCESS_ROLE}
-		]);
-		expect(apps).toEqual(['tickets', 'admin']);
-	});
-
-	it('is empty for no permissions', () => {
-		expect(appsOf([])).toEqual([]);
-	});
-});

test/admin/auth-binding.ts

@@ -1,118 +0,0 @@
-import {vi, describe, it, expect, beforeEach, type Mock} from 'vitest';
-import express, {Request, Response} from 'express';
-
-/**
- * Shared body for the two cutover tests (2026-09-06). feedback.auth.ts and
- * tickets.auth.ts used to carry their own header-session authenticator against
- * the calendar users table; both are now one binding to the shared admin gate.
- *
- * What is worth asserting is not how that gate works - admin.middleware.test.ts
- * owns that - but that each module is bound to *its own* app, and that neither
- * consults the calendar users service any more. The mocks live in the calling
- * file because vi.mock is per-module-graph; only the assertions are shared.
- */
-
-export interface BindingMocks {
-	/** auth.api.getSession from the mocked admin.auth.js */
-	getSession: Mock;
-	/** loadAccess from the mocked users.admin.service.js */
-	loadAccess: Mock;
-	/** checkSession from the mocked calendar users.service.js */
-	checkSession: Mock;
-}
-
-const makeReq = (): Request => ({headers: {cookie: 'nachklang.session_token=abc'}} as unknown as Request);
-
-const makeRes = (): Response => {
-	const res: any = {};
-	res.status = vi.fn().mockReturnValue(res);
-	res.send = vi.fn().mockReturnValue(res);
-	res.locals = {};
-	return res as Response;
-};
-
-const userWith = (...apps: string[]) => ({
-	id: 'u1',
-	email: 'a@nachklang.art',
-	displayName: 'Anna Admin',
-	disabled: false,
-	permissions: apps.map(app => ({app, role: 'access'})),
-	apps
-});
-
-export const describeAdminBinding = (
-	app: string,
-	otherApp: string,
-	middleware: express.RequestHandler,
-	mocks: () => BindingMocks
-): void => {
-	describe(`${app} requireAdminAuth`, () => {
-		let m: BindingMocks;
-
-		const run = async () => {
-			const res = makeRes();
-			const next = vi.fn();
-			await middleware(makeReq(), res, next);
-			return {res, next};
-		};
-
-		beforeEach(() => {
-			m = mocks();
-			m.getSession.mockReset();
-			m.loadAccess.mockReset();
-			m.checkSession.mockReset();
-		});
-
-		it('responds 401 and does not call next() without a session', async () => {
-			m.getSession.mockResolvedValue(null);
-
-			const {res, next} = await run();
-
-			expect(res.status).toHaveBeenCalledWith(401);
-			expect(next).not.toHaveBeenCalled();
-		});
-
-		it(`responds 403 for a signed-in user who only has ${otherApp}`, async () => {
-			m.getSession.mockResolvedValue({user: {id: 'u1'}});
-			m.loadAccess.mockResolvedValue(userWith(otherApp));
-
-			const {res, next} = await run();
-
-			expect(res.status).toHaveBeenCalledWith(403);
-			expect(next).not.toHaveBeenCalled();
-		});
-
-		it('responds 403 for a disabled user who still holds the permission', async () => {
-			m.getSession.mockResolvedValue({user: {id: 'u1'}});
-			m.loadAccess.mockResolvedValue({...userWith(app), disabled: true});
-
-			const {res, next} = await run();
-
-			expect(res.status).toHaveBeenCalledWith(403);
-			expect(next).not.toHaveBeenCalled();
-		});
-
-		it('sets res.locals.admin and calls next() with the permission', async () => {
-			m.getSession.mockResolvedValue({user: {id: 'u1'}});
-			m.loadAccess.mockResolvedValue(userWith(app));
-
-			const {res, next} = await run();
-
-			expect(next).toHaveBeenCalled();
-			expect(res.locals.admin).toMatchObject({id: 'u1', email: 'a@nachklang.art', displayName: 'Anna Admin'});
-		});
-
-		// Weaker than it looks and kept deliberately: neither module imports
-		// checkSession any more, so this cannot fail today. It is a tripwire for
-		// the change that would matter - someone reintroducing a header-session
-		// fallback "just for the calendar users who have not been invited yet",
-		// which is exactly the shortcut the cutover exists to close.
-		it('never falls back to a calendar header session', async () => {
-			m.getSession.mockResolvedValue(null);
-
-			await run();
-
-			expect(m.checkSession).not.toHaveBeenCalled();
-		});
-	});
-};

test/admin/users.admin.router.test.ts

@@ -1,199 +0,0 @@
-import {vi, describe, it, expect, beforeEach, type Mock} from 'vitest';
-import express from 'express';
-import request from 'supertest';
-
-vi.mock('../../src/models/admin/users/users.admin.service.js', () => ({
-	listUsers: vi.fn(),
-	getUserDetail: vi.fn(),
-	loadAccess: vi.fn(),
-	setPermissions: vi.fn(),
-	setPermissionsGuarded: vi.fn(),
-	disableUser: vi.fn(),
-	disableUserGuarded: vi.fn(),
-	enableUser: vi.fn(),
-	revokeSession: vi.fn(),
-	countActiveAdmins: vi.fn(),
-	userExists: vi.fn()
-}));
-
-import * as UsersService from '../../src/models/admin/users/users.admin.service.js';
-import {usersAdminRouter} from '../../src/models/admin/users/users.admin.router.js';
-
-const service = UsersService as unknown as Record<string, Mock>;
-
-// The router always runs behind requireAppAccess('admin'), which is what puts
-// res.locals.admin there; this stands in for it.
-const makeApp = (callerId = 'me') => {
-	const app = express();
-	app.use(express.json());
-	app.use((req, res, next) => {
-		res.locals.admin = {id: callerId, email: 'me@nachklang.art', displayName: 'Me', apps: ['admin']};
-		next();
-	});
-	app.use('/admin/users', usersAdminRouter);
-	return app;
-};
-
-beforeEach(() => {
-	for (const fn of Object.values(service)) {
-		if (typeof fn?.mockReset === 'function') {
-			fn.mockReset();
-		}
-	}
-	service.getUserDetail.mockResolvedValue({id: 'other', apps: []});
-	service.userExists.mockResolvedValue(true);
-	service.setPermissionsGuarded.mockResolvedValue('ok');
-	service.disableUserGuarded.mockResolvedValue('ok');
-});
-
-describe('PUT /admin/users/:id/permissions', () => {
-	it('rejects an unknown app name', async () => {
-		const res = await request(makeApp()).put('/admin/users/other/permissions').send({apps: ['calendar', 'nope']});
-
-		expect(res.status).toBe(400);
-		expect(service.setPermissionsGuarded).not.toHaveBeenCalled();
-	});
-
-	it('rejects a non-array body', async () => {
-		const res = await request(makeApp()).put('/admin/users/other/permissions').send({apps: 'admin'});
-
-		expect(res.status).toBe(400);
-	});
-
-	it('404s for an unknown user', async () => {
-		service.userExists.mockResolvedValue(false);
-
-		const res = await request(makeApp()).put('/admin/users/ghost/permissions').send({apps: []});
-
-		expect(res.status).toBe(404);
-		expect(service.setPermissionsGuarded).not.toHaveBeenCalled();
-	});
-
-	it('refuses to remove the caller\'s own admin permission', async () => {
-		service.loadAccess.mockResolvedValue({id: 'me', disabled: false, apps: ['admin']});
-		service.countActiveAdmins.mockResolvedValue(5);
-
-		const res = await request(makeApp('me')).put('/admin/users/me/permissions').send({apps: ['feedback']});
-
-		expect(res.status).toBe(409);
-		expect(service.setPermissionsGuarded).not.toHaveBeenCalled();
-	});
-
-	// The last-admin decision is made inside the write transaction (so two
-	// admins acting at once cannot both pass a check-then-act); the router's
-	// job is only to turn that verdict into a 409.
-	it('answers 409 when the service reports the last admin would be removed', async () => {
-		service.loadAccess.mockResolvedValue({id: 'other', disabled: false, apps: ['admin']});
-		service.setPermissionsGuarded.mockResolvedValue('last-admin');
-
-		const res = await request(makeApp('me')).put('/admin/users/other/permissions').send({apps: []});
-
-		expect(res.status).toBe(409);
-	});
-
-	it('allows removing an admin while another active admin remains', async () => {
-		service.loadAccess.mockResolvedValue({id: 'other', disabled: false, apps: ['admin']});
-
-		const res = await request(makeApp('me')).put('/admin/users/other/permissions').send({apps: ['tickets']});
-
-		expect(res.status).toBe(200);
-		expect(service.setPermissionsGuarded).toHaveBeenCalledWith(
-			'other',
-			[{app: 'tickets', role: 'access'}],
-			'me'
-		);
-	});
-
-	it('accepts the richer {permissions} body', async () => {
-		service.loadAccess.mockResolvedValue({id: 'other', disabled: false, apps: []});
-
-		const res = await request(makeApp('me'))
-			.put('/admin/users/other/permissions')
-			.send({permissions: [{app: 'tickets', role: 'access'}]});
-
-		expect(res.status).toBe(200);
-		expect(service.setPermissionsGuarded).toHaveBeenCalledWith(
-			'other',
-			[{app: 'tickets', role: 'access'}],
-			'me'
-		);
-	});
-
-	it('rejects a role that does not exist', async () => {
-		service.loadAccess.mockResolvedValue({id: 'other', disabled: false, apps: []});
-
-		const res = await request(makeApp('me'))
-			.put('/admin/users/other/permissions')
-			.send({permissions: [{app: 'tickets', role: 'refund'}]});
-
-		expect(res.status).toBe(400);
-		expect(service.setPermissionsGuarded).not.toHaveBeenCalled();
-	});
-
-	it('allows granting permissions to someone who has none', async () => {
-		service.loadAccess.mockResolvedValue({id: 'other', disabled: false, apps: []});
-
-		const res = await request(makeApp('me')).put('/admin/users/other/permissions').send({apps: ['feedback', 'tickets']});
-
-		expect(res.status).toBe(200);
-		expect(service.setPermissionsGuarded).toHaveBeenCalledWith(
-			'other',
-			[{app: 'feedback', role: 'access'}, {app: 'tickets', role: 'access'}],
-			'me'
-		);
-	});
-});
-
-describe('POST /admin/users/:id/disable', () => {
-	it('refuses to disable the caller', async () => {
-		const res = await request(makeApp('me')).post('/admin/users/me/disable');
-
-		expect(res.status).toBe(409);
-		expect(service.disableUserGuarded).not.toHaveBeenCalled();
-	});
-
-	it('answers 409 when the service reports the last active admin would be disabled', async () => {
-		service.loadAccess.mockResolvedValue({id: 'other', disabled: false, apps: ['admin']});
-		service.disableUserGuarded.mockResolvedValue('last-admin');
-
-		const res = await request(makeApp('me')).post('/admin/users/other/disable');
-
-		expect(res.status).toBe(409);
-	});
-
-	it('disables a non-admin user', async () => {
-		service.loadAccess.mockResolvedValue({id: 'other', disabled: false, apps: ['feedback']});
-
-		const res = await request(makeApp('me')).post('/admin/users/other/disable');
-
-		expect(res.status).toBe(200);
-		expect(service.disableUserGuarded).toHaveBeenCalledWith('other');
-	});
-
-	it('404s for an unknown user', async () => {
-		service.loadAccess.mockResolvedValue(null);
-
-		const res = await request(makeApp('me')).post('/admin/users/ghost/disable');
-
-		expect(res.status).toBe(404);
-	});
-});
-
-describe('DELETE /admin/users/:id/sessions/:sid', () => {
-	it('404s when the session does not belong to that user', async () => {
-		service.revokeSession.mockResolvedValue(false);
-
-		const res = await request(makeApp()).delete('/admin/users/other/sessions/s1');
-
-		expect(res.status).toBe(404);
-	});
-
-	it('204s on a successful revoke', async () => {
-		service.revokeSession.mockResolvedValue(true);
-
-		const res = await request(makeApp()).delete('/admin/users/other/sessions/s1');
-
-		expect(res.status).toBe(204);
-		expect(service.revokeSession).toHaveBeenCalledWith('other', 's1');
-	});
-});

test/common/common.mail.test.ts

@@ -1,116 +0,0 @@
-// common.mail relays one email through the Salesforce org (see
-// src/common/common.mail.ts). These tests mock the shared Salesforce client so
-// no network is touched, and check: the payload shape, base64 attachment
-// encoding, the attachment size cap, the retry-once-on-transient-failure
-// behaviour, and that a delivery failure is swallowed (returns false, never
-// throws).
-
-import {vi, describe, it, expect, beforeEach, type Mock} from 'vitest';
-vi.mock('../../src/common/salesforce.client.js');
-vi.mock('../../src/middleware/logger.js', () => ({
-	__esModule: true,
-	default: {info: vi.fn(), warn: vi.fn(), error: vi.fn()}
-}));
-
-import {MailService} from '../../src/common/common.mail.js';
-import {salesforceApexRestPost, salesforceEnabled} from '../../src/common/salesforce.client.js';
-
-const mockPost = salesforceApexRestPost as Mock;
-const mockEnabled = salesforceEnabled as Mock;
-
-const httpError = (status: number, body?: any): any => {
-	const err: any = new Error('request failed with ' + status);
-	err.response = {status, data: body};
-	return err;
-};
-
-beforeEach(() => {
-	vi.clearAllMocks();
-	mockEnabled.mockReturnValue(true);
-	mockPost.mockResolvedValue({status: 'SENT'});
-});
-
-describe('MailService.sendMail', () => {
-	it('returns false without a callout when Salesforce is disabled', async () => {
-		mockEnabled.mockReturnValue(false);
-
-		const result = await MailService.sendMail('guest@example.com', 'Hi', 'Hallo');
-
-		expect(result).toBe(false);
-		expect(mockPost).not.toHaveBeenCalled();
-	});
-
-	it('posts the email to the Apex REST endpoint and returns true on success', async () => {
-		const result = await MailService.sendMail('guest@example.com', 'Bestätigung', 'Hallo', {html: '<p>Hallo</p>'});
-
-		expect(result).toBe(true);
-		expect(mockPost).toHaveBeenCalledWith('/services/apexrest/email/send', {
-			to: 'guest@example.com',
-			subject: 'Bestätigung',
-			textBody: 'Hallo',
-			htmlBody: '<p>Hallo</p>',
-			attachments: []
-		});
-	});
-
-	it('sends htmlBody as null when no HTML is given', async () => {
-		await MailService.sendMail('guest@example.com', 'Hi', 'Hallo');
-
-		expect(mockPost).toHaveBeenCalledWith('/services/apexrest/email/send', expect.objectContaining({htmlBody: null}));
-	});
-
-	it('base64-encodes attachments', async () => {
-		await MailService.sendMail('guest@example.com', 'Hi', 'Hallo', {
-			attachments: [{filename: 'konzert.ics', content: 'BEGIN:VCALENDAR', contentType: 'text/calendar'}]
-		});
-
-		expect(mockPost).toHaveBeenCalledWith(
-			'/services/apexrest/email/send',
-			expect.objectContaining({
-				attachments: [{
-					filename: 'konzert.ics',
-					contentType: 'text/calendar',
-					contentBase64: Buffer.from('BEGIN:VCALENDAR', 'utf-8').toString('base64')
-				}]
-			})
-		);
-	});
-
-	it('rejects an attachment over the size cap without sending', async () => {
-		const huge = Buffer.alloc(3 * 1024 * 1024 + 1);
-
-		const result = await MailService.sendMail('guest@example.com', 'Hi', 'Hallo', {
-			attachments: [{filename: 'big.pdf', content: huge}]
-		});
-
-		expect(result).toBe(false);
-		expect(mockPost).not.toHaveBeenCalled();
-	});
-
-	it('retries once on a 5xx and returns false when the retry also fails', async () => {
-		mockPost.mockRejectedValue(httpError(503));
-
-		const result = await MailService.sendMail('guest@example.com', 'Hi', 'Hallo');
-
-		expect(result).toBe(false);
-		expect(mockPost).toHaveBeenCalledTimes(2);
-	});
-
-	it('retries once on a network error (no response) then succeeds', async () => {
-		mockPost.mockRejectedValueOnce(new Error('socket hang up')).mockResolvedValueOnce({status: 'SENT'});
-
-		const result = await MailService.sendMail('guest@example.com', 'Hi', 'Hallo');
-
-		expect(result).toBe(true);
-		expect(mockPost).toHaveBeenCalledTimes(2);
-	});
-
-	it('does not retry on a 4xx (e.g. the 429 limit response) and returns false', async () => {
-		mockPost.mockRejectedValue(httpError(429, {errorCode: 'LIMIT_REACHED'}));
-
-		const result = await MailService.sendMail('guest@example.com', 'Hi', 'Hallo');
-
-		expect(result).toBe(false);
-		expect(mockPost).toHaveBeenCalledTimes(1);
-	});
-});

test/common/salesforce.client.test.ts

@@ -1,125 +0,0 @@
-// salesforce.client caches the OAuth token at module scope, so every test
-// resets the module registry for a clean cache and re-imports axios + the
-// module under test after the reset (same approach as
-// test/feedback/salesforce.service.test.ts). Mocked modules survive
-// vi.resetModules(), so mock state is reset explicitly in beforeEach.
-
-import {vi, describe, it, expect, beforeEach, afterAll} from 'vitest';
-vi.mock('axios');
-
-const freshImports = async () => {
-	const axios: any = (await import('axios')).default;
-	const {salesforceApexRestPost, salesforceEnabled} = await import('../../src/common/salesforce.client.js');
-	return {axios, salesforceApexRestPost, salesforceEnabled};
-};
-
-const ORIGINAL_ENV = {...process.env};
-const ENABLED_ENV = {
-	...ORIGINAL_ENV,
-	SALESFORCE_ENABLED: 'true',
-	SALESFORCE_API_URL: 'https://example.my.salesforce.com',
-	SALESFORCE_CLIENT_ID: 'client-id',
-	SALESFORCE_CLIENT_SECRET: 'client-secret'
-};
-
-beforeEach(() => {
-	vi.resetModules();
-	vi.resetAllMocks();
-	process.env = {...ENABLED_ENV};
-});
-
-afterAll(() => {
-	process.env = {...ORIGINAL_ENV};
-});
-
-describe('salesforceEnabled', () => {
-	it('is true only when SALESFORCE_ENABLED === "true"', async () => {
-		process.env.SALESFORCE_ENABLED = 'true';
-		expect((await freshImports()).salesforceEnabled()).toBe(true);
-
-		vi.resetModules();
-		process.env.SALESFORCE_ENABLED = 'false';
-		expect((await freshImports()).salesforceEnabled()).toBe(false);
-	});
-});
-
-describe('salesforceApexRestPost', () => {
-	it('fetches a token, posts to the given Apex REST path, and returns the response body', async () => {
-		const {axios, salesforceApexRestPost} = await freshImports();
-		axios.post.mockImplementation((url: string) => {
-			if (url.endsWith('/services/oauth2/token')) return Promise.resolve({data: {access_token: 'tok-1'}});
-			return Promise.resolve({data: {ok: true}});
-		});
-
-		const result = await salesforceApexRestPost('/services/apexrest/email/send', {to: 'x@example.com'});
-
-		expect(result).toEqual({ok: true});
-		expect(axios.post).toHaveBeenCalledWith(
-			'https://example.my.salesforce.com/services/oauth2/token',
-			expect.any(String),
-			expect.objectContaining({headers: {'Content-Type': 'application/x-www-form-urlencoded'}})
-		);
-		expect(axios.post).toHaveBeenCalledWith(
-			'https://example.my.salesforce.com/services/apexrest/email/send',
-			{to: 'x@example.com'},
-			expect.objectContaining({headers: {Authorization: 'Bearer tok-1'}})
-		);
-	});
-
-	it('reuses the cached token across calls instead of fetching twice', async () => {
-		const {axios, salesforceApexRestPost} = await freshImports();
-		axios.post.mockImplementation((url: string) => {
-			if (url.endsWith('/services/oauth2/token')) return Promise.resolve({data: {access_token: 'tok-1'}});
-			return Promise.resolve({data: {}});
-		});
-
-		await salesforceApexRestPost('/services/apexrest/email/send', {});
-		await salesforceApexRestPost('/services/apexrest/email/send', {});
-
-		const tokenCalls = axios.post.mock.calls.filter(([url]: [string]) => url.endsWith('/services/oauth2/token'));
-		expect(tokenCalls).toHaveLength(1);
-	});
-
-	it('retries once with a fresh token on a 401, then succeeds', async () => {
-		const {axios, salesforceApexRestPost} = await freshImports();
-		let tokenFetches = 0;
-		axios.post.mockImplementation((url: string) => {
-			if (url.endsWith('/services/oauth2/token')) {
-				tokenFetches += 1;
-				return Promise.resolve({data: {access_token: `tok-${tokenFetches}`}});
-			}
-			if (tokenFetches === 1) {
-				const err: any = new Error('Unauthorized');
-				err.response = {status: 401};
-				return Promise.reject(err);
-			}
-			return Promise.resolve({data: {ok: true}});
-		});
-
-		const result = await salesforceApexRestPost('/services/apexrest/email/send', {});
-
-		expect(result).toEqual({ok: true});
-		expect(tokenFetches).toBe(2);
-	});
-
-	it('does not retry on a non-401 error and rethrows it', async () => {
-		const {axios, salesforceApexRestPost} = await freshImports();
-		axios.post.mockImplementation((url: string) => {
-			if (url.endsWith('/services/oauth2/token')) return Promise.resolve({data: {access_token: 'tok-1'}});
-			const err: any = new Error('Server error');
-			err.response = {status: 500};
-			return Promise.reject(err);
-		});
-
-		await expect(salesforceApexRestPost('/services/apexrest/email/send', {})).rejects.toThrow('Server error');
-		const endpointCalls = axios.post.mock.calls.filter(([url]: [string]) => url.endsWith('/email/send'));
-		expect(endpointCalls).toHaveLength(1);
-	});
-
-	it('throws a clear error when client credentials are not configured', async () => {
-		process.env.SALESFORCE_CLIENT_ID = '';
-		const {salesforceApexRestPost} = await freshImports();
-
-		await expect(salesforceApexRestPost('/services/apexrest/email/send', {})).rejects.toThrow('SALESFORCE_CLIENT_ID');
-	});
-});

test/feedback/csv.service.test.ts

@@ -1,6 +1,5 @@
-import {describe, it, expect} from 'vitest';
+import {escapeCsvField} from '../../src/models/feedback/admin/csv.service';
-import {escapeCsvField} from '../../src/models/feedback/admin/csv.service.js';
+import {formatDatetime} from '../../src/models/feedback/feedback.dates';
-import {formatDatetime} from '../../src/models/feedback/feedback.dates.js';
 
 describe('escapeCsvField', () => {
 	it('passes plain text through unchanged', () => {

test/feedback/events.admin.service.test.ts

@@ -1,5 +1,4 @@
-import {describe, it, expect} from 'vitest';
+import {computeDefaultDeadline, slugBase, slugifyName} from '../../src/models/feedback/admin/events.admin.service';
-import {computeDefaultDeadline, slugBase, slugifyName} from '../../src/models/feedback/admin/events.admin.service.js';
 
 describe('slugifyName', () => {
 	it('lowercases and hyphenates', () => {