Cursor rule

1---
2globs: "buero-backend-api/**/*.spec.ts,buero-backend-api/**/*.test.ts,buero-backend-api/**/e2e/**/*.ts"
3description: "Тестування API та backend — buero.de"
4---
5 
6# Тестування — buero.de
7 
8## Інструменти
9 
10- **Jest** — unit and integration tests (docs/tools.md).
11- **Supertest** — e2e HTTP requests to the NestJS app (in-memory, no real network).
12 
13## Test database
14 
15- Use a **dedicated test database** for tests (e.g. separate `DATABASE_URL_TEST` or test schema). Do not run tests against the development database. Ensure tests are isolated (clean state or transactions per test) and do not depend on execution order.
16 
17## Що тестувати
18 
19- **Services:** logic without HTTP (e.g. UserService: password hashing, JWT generation; CourseService: CRUD, access check for subscription/trial). Mock PrismaService or use the test DB.
20- **Controllers / e2e:** requests to endpoints (register, login, GET /api/courses, etc.); assert status codes, response body, cookies where relevant.
21- **Stripe webhook:** idempotency (duplicate stripe_event_id must not change DB); signature verification (mock or test key).
22 
23## Конвенції
24 
25- Test files next to code: ***.spec.ts** (unit/integration) or under **test/** / **e2e/** for e2e.
26- Descriptive names in English: `describe('CourseService')`, `it('returns 403 when student has no subscription')`.
27- Isolate tests; do not rely on execution order.
28 
29## Посилання
30 
31- docs/tools.md (Jest, Supertest); docs/auth-spec.md for auth flows.
32