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>

plugins/employees/api/routes.py

@@ -22,7 +22,7 @@ from shopdb.api import (
     employee_connection,
     require_role,
 )
-from shopdb.core.models import Setting
+from shopdb.api import Setting
 
 from ..models import DirectoryEmployee
 
@@ -112,7 +112,7 @@ def lookup_employee(sso):
         )
 
     if _selfhosted():
-        emp = DirectoryEmployee.query.get(int(sso))
+        emp = db.session.get(DirectoryEmployee, int(sso))
         if not emp:
             return error_response(ErrorCodes.NOT_FOUND,
                                   f'Employee with SSO {sso} not found', http_code=404)
@@ -247,7 +247,7 @@ def create_directory_employee():
         sso = int(fields['sso'])
     except (ValueError, TypeError):
         return error_response(ErrorCodes.VALIDATION_ERROR, 'sso must be numeric')
-    if DirectoryEmployee.query.get(sso):
+    if db.session.get(DirectoryEmployee, sso):
         return error_response(ErrorCodes.CONFLICT, f'SSO {sso} already exists', http_code=409)
     emp = DirectoryEmployee(sso=sso, firstname=fields['firstname'], lastname=fields['lastname'],
                             team=fields['team'], role=fields['role'], picture=fields['picture'])
@@ -263,7 +263,7 @@ def update_directory_employee(sso):
     guard = _require_selfhosted()
     if guard:
         return guard
-    emp = DirectoryEmployee.query.get(sso)
+    emp = db.session.get(DirectoryEmployee, sso)
     if not emp:
         return error_response(ErrorCodes.NOT_FOUND, 'Employee not found', http_code=404)
     fields = _employee_from_payload(request.get_json() or {})
@@ -285,7 +285,7 @@ def delete_directory_employee(sso):
     guard = _require_selfhosted()
     if guard:
         return guard
-    emp = DirectoryEmployee.query.get(sso)
+    emp = db.session.get(DirectoryEmployee, sso)
     if not emp:
         return error_response(ErrorCodes.NOT_FOUND, 'Employee not found', http_code=404)
     db.session.delete(emp)
@@ -326,7 +326,7 @@ def import_directory():
         team = row.get('team') or None
         role = row.get('role') or None
         picture = row.get('picture') or None
-        emp = DirectoryEmployee.query.get(sso)
+        emp = db.session.get(DirectoryEmployee, sso)
         if emp:
             emp.firstname, emp.lastname, emp.team, emp.role, emp.picture = first, last, team, role, picture
             updated += 1