examples/storefront Public
Architecture
From .rebasely/architecture/system.yaml at 94db762: 7 components, 7 connections.
Select a component to see what it talks to.
storefront-api
The public HTTP API (wrangler.jsonc, Worker storefront-api). Shoppers browse the catalog, fill carts and check out; the merchant edits products and uploads their images with the admin token. Its OrdersService entrypoint is how the other Workers change orders: it is the only Worker with the database binding. A cron trigger expires unpaid orders every five minutes.
- Owns
- src/**
- Talks to
- db (d1), images (r2), stripe (https), order-events (queue)
- Used by
- stripe-webhook (rpc), fulfilment (rpc)
Components
- storefront-api Worker
The public HTTP API (wrangler.jsonc, Worker storefront-api). Shoppers browse the catalog, fill carts and check out; the merchant edits products and uploads their images with the admin token. Its OrdersService entrypoint is how the other Workers change orders: it is the only Worker with the database binding. A cron trigger expires unpaid orders every five minutes.
- Owns
- src/**
- Talks to
- db (d1), images (r2), stripe (https), order-events (queue)
- Used by
- stripe-webhook (rpc), fulfilment (rpc)
- stripe-webhook Worker
Worker storefront-stripe-webhook (workers/stripe-webhook). Verifies Stripe's webhook signatures and settles the order of each PaymentIntent through OrdersService.
- Owns
- workers/stripe-webhook/**
- Talks to
- storefront-api (rpc), stripe (webhooks)
- fulfilment Worker
Worker storefront-fulfilment (workers/fulfilment). Consumes order-events, sends each paid order to the warehouse's shipments API and records the shipment through OrdersService. Failed messages retry with backoff and end in order-events-dlq after six attempts.
- Owns
- workers/fulfilment/**
- Talks to
- storefront-api (rpc)
- db D1 database
The storefront database: products, carts, orders and their lines. Every schema change is a numbered file in migrations/, applied with wrangler d1 migrations apply.
- Owns
- migrations/**
- Binding
- DB
- Used by
- storefront-api (d1)
- images R2 bucket
Bucket storefront-images: product images under products/<product>/<hash>.<ext>. A key is never overwritten, so every image URL can be cached for a year. Public on its custom domain (IMAGES_URL), where browsers load the images; storefront-api only writes to it.
- Binding
- IMAGES
- Used by
- storefront-api (r2)
- order-events Queue
Queue order-events: order.paid and order.cancelled, sent by OrdersService when an order changes state. Consumed by fulfilment (queues.consumers in its wrangler.jsonc). At least once, so consumers dedupe by order id.
- Binding
- ORDER_EVENTS
- Used by
- storefront-api (queue)
- stripe External
Stripe, through the stripe npm package. storefront-api creates a PaymentIntent per order with the secret key; the shopper confirms it in the browser with the Payment Element, and Stripe reports the outcome to stripe-webhook.
- Package
- stripe
- Used by
- storefront-api (https), stripe-webhook (webhooks)