kooltab-backoffice/docs/testing.md

Testing

pnpm test        # every package's unit tests
pnpm test:e2e    # the API against a real database

Unit tests

• apps/api/src/**/*.spec.ts (Jest): the rules in ledger/ (tabs, drinks, settling, stock, product merges), event parsing, the app version gate, consistency checks, email templates and image processing. Pure, no database.
• apps/dashboard/src/**/*.test.ts (Vitest): the customer import, amount parsing, and that every translation key the dashboard uses exists in English and Dutch.

End-to-end tests

apps/api/test/api.e2e-spec.ts starts the whole API against the database in DATABASE_URL (migrated, and wiped by the test) and plays a terminal and the dashboard together: pairing, syncing events once, settling on a terminal and on the dashboard, customers getting tabs, stock movements, unpairing, venue access, and the superadmin page.

Locally, docker compose up -d creates a kooltap_test database too:

cd apps/api
DATABASE_URL=postgresql://kooltap:kooltap@localhost:5432/kooltap_test npx prisma migrate deploy
DATABASE_URL=postgresql://kooltap:kooltap@localhost:5432/kooltap_test pnpm test:e2e

CI runs both, checks that the Prisma schema matches the migrations, builds everything and exports the terminal protocol's JSON Schema.

By hand

pnpm simulate is a terminal on the command line: open tabs, ring up drinks and settle, and watch the dashboard follow.