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>

shopdb/core/api/dashboarddefaults.py

@@ -10,6 +10,7 @@ from flask_jwt_extended import jwt_required
 from shopdb.extensions import db
 from shopdb.core.models import DashboardDefault, BusinessUnit, AuditLog
 from shopdb.utils.responses import success_response, error_response, ErrorCodes
+from shopdb.utils.authz import require_role
 
 dashboarddefaults_bp = Blueprint('dashboarddefaults', __name__)
 
@@ -64,6 +65,7 @@ def list_defaults():
 
 @dashboarddefaults_bp.route('', methods=['POST'])
 @jwt_required()
+@require_role('admin')
 def create_default():
     """Create a visitor-IP -> business-unit mapping."""
     data = request.get_json() or {}
@@ -74,7 +76,7 @@ def create_default():
         return error_response(ErrorCodes.VALIDATION_ERROR, 'ipaddress is required')
     if not businessunitid:
         return error_response(ErrorCodes.VALIDATION_ERROR, 'businessunitid is required')
-    if not BusinessUnit.query.get(businessunitid):
+    if not db.session.get(BusinessUnit, businessunitid):
         return error_response(ErrorCodes.NOT_FOUND, 'Business unit not found',
                               http_code=404)
     if DashboardDefault.query.filter_by(ipaddress=ipaddress, isactive=True).first():
@@ -94,15 +96,16 @@ def create_default():
 
 @dashboarddefaults_bp.route('/<int:default_id>', methods=['PUT'])
 @jwt_required()
+@require_role('admin')
 def update_default(default_id):
     """Update a mapping."""
-    default = DashboardDefault.query.get(default_id)
+    default = db.session.get(DashboardDefault, default_id)
     if not default:
         return error_response(ErrorCodes.NOT_FOUND, 'Mapping not found', http_code=404)
 
     data = request.get_json() or {}
     if 'businessunitid' in data:
-        if not BusinessUnit.query.get(data['businessunitid']):
+        if not db.session.get(BusinessUnit, data['businessunitid']):
             return error_response(ErrorCodes.NOT_FOUND, 'Business unit not found',
                                   http_code=404)
         default.businessunitid = data['businessunitid']
@@ -117,9 +120,10 @@ def update_default(default_id):
 
 @dashboarddefaults_bp.route('/<int:default_id>', methods=['DELETE'])
 @jwt_required()
+@require_role('admin')
 def delete_default(default_id):
     """Delete (deactivate) a mapping."""
-    default = DashboardDefault.query.get(default_id)
+    default = db.session.get(DashboardDefault, default_id)
     if not default:
         return error_response(ErrorCodes.NOT_FOUND, 'Mapping not found', http_code=404)
     default.isactive = False