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
- packages/media-nuxt/runtime/server/utils/media-library.ts:138 — export function getMediaLibrary
- infra/sam/template.yaml:305 — MediaWorkerFunction:
- docker/docker-compose.dev.yml:21 — services:
- docker/docker-compose.local.yml:14 — services:
- docker/docker-compose.test.yml:21 — services:
- docker/docker-compose.admin.yml:13 — services:
- packages/media-aws/src/worker-handler.ts:12 — export async function mediaWorkerHandler
- packages/media-aws/src/create-aws-media-library.ts:24 — export function createAwsMediaLibrary