📄️ Current State
Wrkbelt's shipped architecture, as of v0.6.0 — each subsystem page is verified against the current code.
📄️ Multi-tenant hierarchy
Org types, ancestry, dual-check authorization, @TargetOrgId binding, session org context, impersonation, ancestry cache.
📄️ Catalog and enablement
How Products and Integrations are defined in the seed-driven catalog and enabled per organization.
📄️ Multi-instance runtime
Production topology, the four ioredis clients, the five semantic Redis services, Socket.IO fanout, ancestry invalidation broadcast, graceful shutdown, and cron + SQS fanout.
📄️ Cluster Coordination Pattern
The decision guide for picking the right cross-instance coordination primitive — RemoteCacheProvider, RateLimiter, DistributedLock, ResourceLease, BroadcastChannel, idempotency-log, or cron-tickle + SQS fanout.
📄️ Booking session pipeline
Unified Scheduler-widget event pipeline — gateway pre-derive → SQS FIFO dedup → idempotent processor; the producer's id stamp is the load-bearing dedup contract.
📄️ Data model and migrations
Entity layout under types-data, BaseEntity plus Mongoose discriminators, the MigrationBootCoordinator (lock + per-record CAS + heartbeat lease), and the idempotency log.
📄️ Audit and observability
The two-tier audit-write strategy (sync sensitive, async routine), dual-identity records, structured-log keys feeding CloudWatch alarms, and Sentry tracing.