Backend — Overview

Stub. Use the service.md template to fill this out. The Backend will likely be one of the first services we document in full.

Overview

Express JS application deployed on EC2 via pm2. Serves the Alyson API (consumed by alyson-frontend) and currently also co-hosts non-Alyson APIs (e.g. the Pre-pop API). See ADR-0003 — Cluttered backend acknowledgment (to be written).

Tech stack

• Node.js + Express
• Postgres (RDS)
• AWS SDK (EventBridge, SNS, Aurora)

Repository

• alyson-backend on GitHub

Sections to fill

• Architecture (internal module map)
• API reference (auto-generated from OpenAPI ideally)
• Data model (Postgres schemas — Alyson schema vs others)
• Configuration (env vars)
• Deployment (full runbook)
• Monitoring & alerts
• Local development
• Known issues — multi-schema clutter

See /templates/service.md for the full section list.