Integrations

Payments, storage, email, AI chat, and the health endpoint.

IntegrationConfigureUsed for
PostgreSQLDATABASE_URLEverything
S3-compatible storageS3_BUCKET_NAME, S3_REGION, S3_ACCESS_KEY_ID, S3_SECRET_ACCESS_KEY, S3_ENDPOINTMenu images
SMTPSMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASSWORD, SMTP_FROM, SMTP_STORE_LINKPassword reset email
StripeSee Payment providersOnline card payment, refunds
PayPalPAYPAL_*Adapter and webhook
OpenRouterOPENROUTER_API_KEY, OPENROUTER_MODEL, OPENROUTER_MAX_TOKENSDashboard AI chat at /api/completion

Health

GET /api/health returns the runtime health as JSON: 200 when ok, 503 otherwise, never cached. Use it for load balancer checks.

Domain events

State changes write CoffeeDomainEvent records and CoffeeOutboxDelivery rows. Both lists are hidden and system only.

Payment providers

Manual cash, Stripe Checkout, and the PayPal adapter, with webhooks and refunds.

Set up the menu

Create categories, items, and modifiers that consume stock correctly.

On this page

Health
Domain events