Multi-site distribution readiness: settings-driven site config, security closeout, release engineering, v0.5.0

Make the app distributable to other GE Aerospace sites (one self-hosted
instance per site, ADR-004). GE values remain the shipped defaults; every
site-specific behavior is now a Setting an admin can change in the UI.

Settings-driven site config:
- Branding: site/QR/badge logos, favicon, primary color (upload endpoints
  mirror the map-blueprint pattern; new Settings > Branding section).
- ServiceNow: search/incident/change URL templates ({ticket}), ticket
  prefixes, enable toggle. Defaults point at the current
  geaerospaceqa.service-now.com global search. Disabled = plain-text tickets.
- Employee-id regex (employeeid_pattern), printer hostname template,
  QR label targets (qr_target_printer / qr_target_usb, blank = asset page,
  else URL template with placeholders), usb_label_style (barcode|qr).
- West Jefferson floor-plan PNGs removed from the tree; generic placeholder
  ships as the map default and sites upload their own blueprint.

Security closeout:
- dashboarddefaults writes now require admin.
- Collector: generic error messages (no str(exc) leak); API key accepted
  via X-API-Key header only (BREAKING: querystring api_key removed).
- IP-based login rate limiting (AUTH_RATELIMIT_* knobs) atop account lockout.
- Setting.set() creation race fixed (IntegrityError retry).

Release engineering and docs:
- __version__ 0.5.0 (distinct from __contract_version__, ADR-007),
  CHANGELOG.md, Gitea Actions CI config, frontend version aligned.
- One wizard-first install story across README/DEPLOY; new CONFIG.md,
  UPGRADE.md, BACKUP-RESTORE.md; CLAUDE.md and ROADMAP de-staled.
- Dockerfile multi-stage build now bundles the frontend; compose binds
  MySQL to 127.0.0.1; stale database/schema.sql and one-off SQL removed.

Debt and fixes:
- .query.get() -> db.session.get() sweep; datetime.utcnow() removed
  (naive-UTC via timezone-aware now); users.py on authz decorators.
- Fixed 4 stale tests (slides feed shape, shopfloor splitperemployee,
  plugin contract purity) and the USB label page field mapping (both usb
  modes emit the cmmc shape: device_id/device_desc).
- Health endpoint reports the real version.

248 tests pass; naming/style check green; frontend builds; fresh-DB
flask db upgrade + seeds verified; QR targets verified by decoding
rendered codes.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Dockerfile

@@ -2,14 +2,33 @@
 #
 # One image, one site. Per ADR-004, each adopting facility runs its own
 # stack with its own DB, secrets, and enabled-plugin list. This image
-# bundles all six core plugins; install them at runtime with
-# `flask plugin install <name>`.
+# bundles all ten core plugins (computers, employees, equipment,
+# knowledgebase, network, notifications, printers, slides, usb, warranty);
+# install them at runtime with `flask plugin install <name>`.
+#
+# The frontend is built in a first stage and its dist output is copied into
+# the final image so Flask can serve the SPA (register_frontend_routes in
+# shopdb/__init__.py resolves <repo>/frontend/dist).
 #
 # Build:
 #   docker build -t shopdb-flask .
 # Run (with .env):
 #   docker run --env-file .env -p 5001:5001 shopdb-flask
 
+# ---- Stage 1: build the Vue frontend ----
+FROM node:20-slim AS frontendbuild
+
+WORKDIR /build
+
+# Copy only the manifests first so `npm ci` caches on dependency changes.
+COPY frontend/package*.json ./
+RUN npm ci
+
+COPY frontend/ ./
+RUN npm run build
+# Output lands in /build/dist (Vite default), copied into the final stage below.
+
+# ---- Stage 2: Python application image ----
 FROM python:3.12-slim AS base
 
 ENV PYTHONDONTWRITEBYTECODE=1 \
@@ -37,6 +56,9 @@ COPY migrations/ ./migrations/
 COPY scripts/ ./scripts/
 COPY wsgi.py ./
 
+# Built SPA from stage 1. Flask serves it via register_frontend_routes.
+COPY --from=frontendbuild /build/dist ./frontend/dist
+
 RUN useradd --create-home --shell /bin/bash shopdb \
     && chown -R shopdb:shopdb /app
 USER shopdb