Encore.ts API (api-events) - Soundcheck

The Soundcheck REST API migration from Go to Encore.ts is complete. api-events (api-events/, port 4000) is the sole runtime for public HTTP, owns PostgreSQL DDL, and serves web, mobile, e2e, and MCP clients. Use the current backend docs instead of this page for day-to-day work:

Topic	Doc
Overview & quick start	API Overview
Architecture	API Architecture
Local setup	API Setup
Infra profiles	Development Profiles
Notifications & Pub/Sub	api-events
Secrets / env inventory	api-events operations
Canonical source	`api-events/README.md`

What changed

Before: Go API (api/, :8080) was system of record; api-events was notification fan-out only; dual schema parity (schema:parity) kept Go and TS Prisma mirrors aligned.
Now: api-events owns src/db/schema.prisma, migrations, all REST endpoints, and direct Pub/Sub publication. A shared transactional outbox is not implemented; see the target workflow contract. The Go API tree is removed. No differential oracle or schema parity gate.

Local development (current)

npm run dev:infra
cd api-events && npm run db:migrate && npm run db:seed:demo-full
docker compose -p api -f dev/docker-compose.yml restart clerk-emulator
cd api-events && npm run dev:emulator
cd web && npm run dev:emulator

Port	Service
4000	Encore api-events
5433	Shared Postgres
4711	Clerk emulator
4092	Cleo Pay emulator
10000	Azurite

Client base URLs

Client	Setting
Web dev	`BACKEND_API_URL=http://localhost:4000` (via `npm run dev:emulator`)
Mobile	`EXPO_PUBLIC_API_URL=http://localhost:4000`
MCP	`API_BASE_URL=http://localhost:4000`
E2E	`E2E_API_URL=http://localhost:4000`

Contract gates (current)

Gate	Command
Unit + coverage	`cd api-events && npm run checks`
OpenAPI	`npm run openapi:parity`
E2E regression	`npm run test:e2e` with `E2E_ENFORCE_COVERAGE=1` in CI

Route inventory: the Encore endpoint declarations, with domains in api-events/routes.json Agent conventions for new endpoints: .agents/skills/encore-port/SKILL.md