Alyson Docs

Backend Development

How we develop the Alyson backend.

Owner: @adminStatus: wipLast verified: 5/18/2026

Stub. Fill this in via /qa-session backend-development or the intake-then-draft pattern. Sections below are placeholders.

Repo layout

(Paste the tree, annotate what lives where.)

Local development

How to run the backend locally. Required env vars, DB setup, seeds.

Code conventions

  • Style / lint / formatter
  • Naming
  • Error handling
  • Logging
  • Auth / middleware patterns

API conventions

  • Routing conventions
  • Request validation
  • Response envelopes
  • Versioning

Database

  • Migration tool and process
  • Schema conventions
  • Multi-schema (Alyson vs non-Alyson) caveats

Testing

  • Test framework
  • What we test, what we skip
  • How to run tests

PR conventions

  • Branching
  • Review expectations
  • CI checks

Deployment

Link to the deployment runbook.