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/notifications/api/routes.py

@@ -227,7 +227,7 @@ def create_notification_type():
 @require_permission('notifications.create')
 def update_notification_type(type_id: int):
     """Update a notification type, including its auto-expiry rule."""
-    t = NotificationType.query.get(type_id)
+    t = db.session.get(NotificationType, type_id)
     if not t:
         return error_response(ErrorCodes.NOT_FOUND, f'Notification type {type_id} not found', http_code=404)
 
@@ -290,7 +290,7 @@ def list_notifications():
 
     # Current filter (active based on dates)
     if request.args.get('current', 'false').lower() == 'true':
-        now = datetime.utcnow()
+        now = datetime.now(timezone.utc).replace(tzinfo=None)
         query = query.filter(
             Notification.starttime <= now,
             db.or_(
@@ -317,7 +317,7 @@ def list_notifications():
 @notifications_bp.route('/<int:notification_id>', methods=['GET'])
 def get_notification(notification_id: int):
     """Get a single notification."""
-    n = Notification.query.get(notification_id)
+    n = db.session.get(Notification, notification_id)
 
     if not n:
         return error_response(
@@ -345,7 +345,7 @@ def create_notification():
         return error_response(ErrorCodes.VALIDATION_ERROR, 'notification/message is required')
 
     # Parse dates
-    starttime = datetime.utcnow()
+    starttime = datetime.now(timezone.utc).replace(tzinfo=None)
     if data.get('starttime') or data.get('startdate'):
         try:
             date_str = data.get('starttime') or data.get('startdate')
@@ -364,7 +364,7 @@ def create_notification():
     # No explicit end time: apply the per-type display window (recognition
     # clears at the next 8 AM Eastern, recertification runs two weeks).
     if endtime is None and data.get('notificationtypeid'):
-        ntype = NotificationType.query.get(data['notificationtypeid'])
+        ntype = db.session.get(NotificationType, data['notificationtypeid'])
         if ntype:
             endtime = _auto_endtime(ntype, starttime)
 
@@ -394,7 +394,7 @@ def create_notification():
 @require_permission('notifications.edit')
 def update_notification(notification_id: int):
     """Update a notification."""
-    n = Notification.query.get(notification_id)
+    n = db.session.get(Notification, notification_id)
 
     if not n:
         return error_response(
@@ -440,7 +440,7 @@ def update_notification(notification_id: int):
             except ValueError:
                 return error_response(ErrorCodes.VALIDATION_ERROR, 'Invalid starttime format')
         else:
-            n.starttime = datetime.utcnow()
+            n.starttime = datetime.now(timezone.utc).replace(tzinfo=None)
 
     if 'endtime' in data or 'enddate' in data:
         date_str = data.get('endtime') or data.get('enddate')
@@ -461,7 +461,7 @@ def update_notification(notification_id: int):
 @require_permission('notifications.delete')
 def delete_notification(notification_id: int):
     """Delete (soft delete) a notification."""
-    n = Notification.query.get(notification_id)
+    n = db.session.get(Notification, notification_id)
 
     if not n:
         return error_response(
@@ -485,7 +485,7 @@ def get_active_notifications():
     """
     Get currently active notifications for display.
     """
-    now = datetime.utcnow()
+    now = datetime.now(timezone.utc).replace(tzinfo=None)
 
     from datetime import timedelta
     lookahead = now + timedelta(days=10)
@@ -551,7 +551,7 @@ def get_calendar_events():
 @notifications_bp.route('/dashboard/summary', methods=['GET'])
 def dashboard_summary():
     """Get notifications dashboard summary."""
-    now = datetime.utcnow()
+    now = datetime.now(timezone.utc).replace(tzinfo=None)
 
     # Total active notifications
     total_active = Notification.query.filter(
@@ -643,7 +643,7 @@ def get_shopfloor_notifications():
     """
     from datetime import timedelta
 
-    now = datetime.utcnow()
+    now = datetime.now(timezone.utc).replace(tzinfo=None)
     business_unit = request.args.get('businessunit')
 
     # Base query for shopfloor notifications