Add the API import surface for legacy migrations (contract 0.8.0)

Goal: an LLM or script can migrate an entire legacy database using only
the HTTP API - original history preserved, safely re-runnable.

- X-Import-Mode header (admin only): create/update endpoints across 15
  timestamped entity types accept original createddate/modifieddate;
  helper exposed via shopdb.api (contract 0.7.0 -> 0.8.0).
- Exact-match natural-key lookup filters on 13 list endpoints for the
  lookup-then-upsert recipe.
- Selfhosted USB checkout/checkin accept backdated event times in
  import mode.
- docs/IMPORT-API.md: operator manual grounded in the real legacy
  schema - order of operations, full table-by-table mapping including
  the machines fan-out, idempotent Python importer with dry-run, parity
  checks, and decided dispositions for unmigrated tables (DNC config
  stays live-fed via the collector; supportteams/appowners map to the
  upcoming supportteams model).

635 tests pass; naming green; frontend untouched.

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

plugins/machines/api/routes.py

@@ -7,7 +7,7 @@ from shopdb.api import db, Asset, AssetType, Vendor, Model, AuditLog, success_re
 
 from ..models import Machine, MachineType
 
-from shopdb.api import require_permission, require_role
+from shopdb.api import require_permission, require_role, apply_import_timestamps
 
 machines_bp = Blueprint('machines', __name__)
 
@@ -170,6 +170,10 @@ def list_machines():
     if request.args.get('active', 'true').lower() != 'false':
         query = query.filter(Asset.isactive == True)
 
+    # Exact-match natural-key lookup for idempotent import (asset number).
+    if exactassetnumber := request.args.get('assetnumber'):
+        query = query.filter(Asset.assetnumber == exactassetnumber)
+
     # Search filter
     if search := request.args.get('search'):
         query = query.filter(
@@ -337,6 +341,9 @@ def create_machine():
     db.session.add(mach)
     db.session.flush()
 
+    # Preserve legacy timestamps in import mode (no-op otherwise)
+    apply_import_timestamps(asset, data)
+
     # Audit log
     AuditLog.log('created', 'Machine', entityid=mach.machineid,
                  entityname=data['assetnumber'])
@@ -412,6 +419,7 @@ def update_machine(machine_id: int):
         AuditLog.log('updated', 'Machine', entityid=mach.machineid,
                      entityname=asset.assetnumber, changes=changes)
 
+    apply_import_timestamps(asset, data)
     db.session.commit()
 
     result = asset.to_dict()