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/printers/api/asset_routes.py

@@ -54,7 +54,7 @@ def list_printer_types():
 @jwt_required(optional=True)
 def get_printer_type(type_id: int):
     """Get a single printer type."""
-    t = PrinterType.query.get(type_id)
+    t = db.session.get(PrinterType, type_id)
 
     if not t:
         return error_response(
@@ -108,7 +108,7 @@ def create_printer_type():
 @require_permission('printers.edit')
 def update_printer_type(type_id: int):
     """Update a printer type."""
-    t = PrinterType.query.get(type_id)
+    t = db.session.get(PrinterType, type_id)
     if not t:
         return error_response(ErrorCodes.NOT_FOUND,
                               f'Printer type with ID {type_id} not found', http_code=404)
@@ -132,7 +132,7 @@ def update_printer_type(type_id: int):
 @require_permission('printers.delete')
 def delete_printer_type(type_id: int):
     """Delete a printer type. Refused if any printer still uses it."""
-    t = PrinterType.query.get(type_id)
+    t = db.session.get(PrinterType, type_id)
     if not t:
         return error_response(ErrorCodes.NOT_FOUND, 'Printer type not found', http_code=404)
     inuse = Printer.query.filter_by(printertypeid=type_id).count()
@@ -182,7 +182,7 @@ def create_driver():
 @jwt_required()
 @require_permission('printers.edit')
 def update_driver(driver_id):
-    d = PrinterDriver.query.get(driver_id)
+    d = db.session.get(PrinterDriver, driver_id)
     if not d:
         return error_response(ErrorCodes.NOT_FOUND, 'Driver not found', http_code=404)
     data = request.get_json() or {}
@@ -199,7 +199,7 @@ def update_driver(driver_id):
 @jwt_required()
 @require_permission('printers.delete')
 def delete_driver(driver_id):
-    d = PrinterDriver.query.get(driver_id)
+    d = db.session.get(PrinterDriver, driver_id)
     if not d:
         return error_response(ErrorCodes.NOT_FOUND, 'Driver not found', http_code=404)
     db.session.delete(d)
@@ -398,7 +398,7 @@ def pc_default_printer():
 @jwt_required(optional=True)
 def get_printer(printer_id: int):
     """Get a single printer with full details."""
-    printer = Printer.query.get(printer_id)
+    printer = db.session.get(Printer, printer_id)
 
     if not printer:
         return error_response(
@@ -551,7 +551,7 @@ def create_printer():
 @require_permission('printers.edit')
 def update_printer(printer_id: int):
     """Update printer (both Asset and Printer records)."""
-    printer = Printer.query.get(printer_id)
+    printer = db.session.get(Printer, printer_id)
 
     if not printer:
         return error_response(
@@ -626,7 +626,7 @@ def update_printer(printer_id: int):
 @require_permission('printers.delete')
 def delete_printer(printer_id: int):
     """Delete (soft delete) printer."""
-    printer = Printer.query.get(printer_id)
+    printer = db.session.get(Printer, printer_id)
 
     if not printer:
         return error_response(
@@ -650,7 +650,7 @@ def delete_printer(printer_id: int):
 @jwt_required(optional=True)
 def get_printer_supplies(printer_id: int):
     """Get supply levels from Zabbix (real-time lookup)."""
-    printer = Printer.query.get(printer_id)
+    printer = db.session.get(Printer, printer_id)
 
     if not printer:
         return error_response(ErrorCodes.NOT_FOUND, 'Printer not found', http_code=404)
@@ -776,7 +776,7 @@ def _get_low_supplies_data():
             location_name = None
             if asset.locationid:
                 from shopdb.api import Location
-                loc = Location.query.get(asset.locationid)
+                loc = db.session.get(Location, asset.locationid)
                 if loc:
                     location_name = loc.locationname
 
@@ -1031,7 +1031,7 @@ def list_supply_models():
 @jwt_required(optional=True)
 def list_model_supplies(modelnumberid: int):
     """List all supplies mapped to a model."""
-    model = Model.query.get(modelnumberid)
+    model = db.session.get(Model, modelnumberid)
     if not model:
         return error_response(ErrorCodes.NOT_FOUND, 'Model not found', http_code=404)
 
@@ -1053,7 +1053,7 @@ def list_model_supplies(modelnumberid: int):
 @require_permission('printers.create')
 def create_model_supply(modelnumberid: int):
     """Add a supply to a model."""
-    model = Model.query.get(modelnumberid)
+    model = db.session.get(Model, modelnumberid)
     if not model:
         return error_response(ErrorCodes.NOT_FOUND, 'Model not found', http_code=404)
 
@@ -1094,7 +1094,7 @@ def create_model_supply(modelnumberid: int):
 @require_permission('printers.edit')
 def update_model_supply(modelsupplyid: int):
     """Update a model supply."""
-    supply = ModelSupply.query.get(modelsupplyid)
+    supply = db.session.get(ModelSupply, modelsupplyid)
     if not supply:
         return error_response(ErrorCodes.NOT_FOUND, 'Supply not found', http_code=404)
 
@@ -1139,7 +1139,7 @@ def update_model_supply(modelsupplyid: int):
 @require_permission('printers.delete')
 def delete_model_supply(modelsupplyid: int):
     """Delete a model supply."""
-    supply = ModelSupply.query.get(modelsupplyid)
+    supply = db.session.get(ModelSupply, modelsupplyid)
     if not supply:
         return error_response(ErrorCodes.NOT_FOUND, 'Supply not found', http_code=404)