Experience Layer
Web-Konsole, Scanner-PWA, Druckoperator-Oberfläche, spätere native Apps.
Blueprint
Systemarchitektur
Cloud-native, API-first und mandantenfähig ausgelegt. Diese Struktur ist die Grundlage aller kommenden Ausbaustufen.
Schichten
Klare Trennung von Oberfläche, Domäne und Daten.
Domain Layer
Identity, Code, Asset, Location, Print, Scan, Access und Tenant Domänen.
Service Layer
Server Functions, Resolver-Endpunkte, Webhooks und Batch-Jobs.
Data Layer
Postgres mit Row Level Security, Audit-Tabellen und Event-Historie.
Realtime & Offline
Live-Scans, optimistische Sync-Queue und lokale Erfassung ohne Netz.
Integration Layer
REST v1, Webhooks, SDK-Pakete, optional GraphQL Gateway.
Kern-Entitäten
Datenarchitektur-Entwurf. Tabellen und Policies werden in einer späteren Phase angelegt.
- identity
- uuid · short_code · type · status · version
- identity_target
- routing rules · destination · valid_from/to
- code_carrier
- symbology · payload · print_state · nfc_uid
- asset
- inventory_no · serial_no · owner · lifecycle
- location
- site · zone · shelf · gps_lat/lng
- scan_event
- ip · country · device · browser · gps · source
- tenant / project
- isolation boundary · quotas · namespaces
- principal / role
- user · api_client · role_assignment
- audit_log
- actor · action · before/after · timestamp
Resolver-Vertrag
Unveränderliche Adressen, veränderbare Ziele.
- Kanonische URL
- https://code.metricode.com/{shortcode}
- Kurzdomain
- https://mc.id/{shortcode}
- Kurzcode-Alphabet
- Crockford Base32, kollisionsfrei, 6–10 Zeichen
- Signierte Links
- ?s={signature}&exp={unix}
- Auflösung
- identity → aktive Regel → Ziel + Protokolleintrag