miro-reference-architecture

# Miro Reference Architecture ## Overview Production-ready architecture for Miro REST API v2 integrations. Layered design with a board service, item factory, webhook event processor, and caching layer. ## Architecture Diagram ``` ┌──────────────────────────────────────────────────────────┐ │ API / UI Layer │ │ Express routes, Next.js API routes, CLI commands │ ├──────────────────────────────────────────────────────────┤ │ Service Layer │ │ BoardService, ItemService, SyncService │ │ (business logic, orchestration, validation) │ ├──────────────────────────────────────────────────────────┤ │ Miro Client Layer │ │ MiroApiClient (REST v2), TokenManager (OAuth 2.0) │ │ ItemFactory (typed creation), ConnectorBuilder │ ├──────────────────────────────────────────────────────────┤ │ Infrastructure Layer │ │ Cache (LRU/Redis), Queue (PQueue), Monitor (metrics) │ │ WebhookProcessor (signature + idempotency) │ └──────────────────────────────────────────────────────────┘ │ ▼ https://api.miro.com/v2/ ``` ## Project Structure ``` src/ ├── miro/ │ ├── client.ts # MiroApiClient — wraps fetch with auth, retries, monitoring │ ├── token-manager.ts # OAuth 2.0 token lifecycl...