Skip to the content.

Deployment topology

Configured topology only: no claim that a stack is currently deployed. Mermaid subgraphs represent UML deployment nodes; arrows name communication, not inheritance.

flowchart TB
  Browser["Browser / admin client"]
  subgraph Local["Host local"]
    Host["Nuxt web / media-nuxt"]
    FS["SQLite media.sqlite and filesystem blobs"]
    Host -->|local media ports| FS
  end
  subgraph Docker["Docker variants"]
    Web["Local web or development web + API"]
    DD["DynamoDB Local"]
    Min["MinIO"]
    Admin["Standalone admin"]
    AF["Admin SQLite / filesystem volume"]
    RIE["Test Lambda RIE and HTTP proxy"]
    Web -->|default media catalog| DD
    Web -->|default blobs| Min
    RIE -->|catalog| DD
    RIE -->|blobs| Min
    Admin -->|no MEDIA_API_URL| AF
    Admin -->|MEDIA_API_URL configured| Web
  end
  subgraph AWS["SAM test / production configuration"]
    API["HTTP API"]
    Nitro["Nitro Lambda"]
    Table["MediaTable / DynamoDB"]
    Queue["MediaQueue / SQS"]
    Worker["MediaWorkerFunction / Lambda"]
    DLQ["MediaDLQ"]
    Bucket["Private AssetsBucket / S3"]
    CDN["AssetsDistribution / CloudFront OAC"]
    API -->|HTTP event| Nitro
    Nitro -->|catalog| Table
    Nitro -->|presign, probe and blob operations| Bucket
    Nitro -->|jobId| Queue
    Queue -->|batch size 1| Worker
    Queue -->|redrive after maxReceiveCount 3| DLQ
    Worker -->|job and catalog state| Table
    Worker -->|read original / write variants| Bucket
    CDN -->|OAC GetObject| Bucket
    Worker -->|replacement invalidation| CDN
    Nitro -->|delete / replacement invalidation| CDN
  end
  Browser -->|host HTTP| Host
  Browser -->|Docker HTTP| Web
  Browser -->|admin HTTP| Admin
  Browser -->|AWS API requests| API
  Browser -->|public media| CDN

Host local defaults to SQLite/FS. Docker local and development default to DynamoDB Local/MinIO; choosing sqlite or postgres uses the mounted SQLite/FS media store. Docker test uses Lambda RIE, DynamoDB Local and MinIO with synchronous materialization (no queue URL). Standalone admin keeps its own SQLite/FS catalog unless forwarding is configured; its separate CDN-management MinIO settings do not select its DAM backend. AWS Lambda always selects DynamoDB/S3. Worker timeout is 300 seconds, queue visibility 360 seconds, batch size 1. Media uses the stack-owned AssetsDistribution even when test static assets use a shared CDN.

Source evidence