Cursor rule

1---
2globs: buero-backend-api/prisma/**/*,buero-backend-api/**/prisma.service.ts,**/prisma/**/*,**/*repository*
3description: "Prisma та БД — buero.de (PostgreSQL)"
4---
5 
6# База даних та Prisma — buero.de
7 
8## Джерело схеми
9 
10Схема та зв'язки описані в **docs/architecture.md** (розділ 3). Prisma schema (schema.prisma) має відповідати цим таблицям.
11 
12## Основні сутності
13 
14- **users** — id (UUID), email, password_hash, role (student | teacher), language (en | de), stripe_customer_id, deleted_at, timestamps.
15- **refresh_tokens** — зберігання refresh JWT для revoke при logout.
16- **student_profiles** — user_id (1-1), level (A1|A2|B1|B2), trial_ends_at, timezone.
17- **teacher_profiles** — user_id (1-1), bio, is_active.
18- **courses** — teacher_id (nullable, «хто створив»), title, description, language, category (language | sociocultural), is_published.
19- **course_materials** — course_id, type (video, vocabulary, grammar, quiz, scenario, cultural_insight, homework, text), title, content (JSONB), order_index.
20- **user_course_access** — доступ студента до курсу: trial, purchase або subscription; UNIQUE(user_id, course_id).
21- **subscriptions**, **payments** — прив'язані до курсу (course_id); один активний subscription на (user_id, course_id).
22- **stripe_webhook_events** — stripe_event_id (UNIQUE) для ідемпотентності webhook.
23- **course_progress**, **quiz_attempts** — прогрес і покрокові відповіді квізів/сценаріїв.
24- **lesson_requests** — student_id, teacher_id (після прийняття), status (pending | accepted | completed | rejected).
25- **placement_questions** — один глобальний Placement Test (без course_id).
26 
27## Патерни
28 
29- Інжекція **PrismaService** у сервіси; не створювати окремий репозиторійний шар без потреби.
30- Транзакції для операцій з кількома таблицями (наприклад створення subscription + оновлення user).
31- Міграції: описові назви; тестувати на dev перед застосуванням.
32- Індекси з architecture.md (users.email, subscriptions.user_id, course_materials.course_id, тощо) — додати в міграції або вручну.
33 
34## Команди (орієнтовно)
35 
36- Генерація клієнта: `npx prisma generate`
37- Міграції: `npx prisma migrate dev` / `migrate deploy`
38- Seed: за потреби (placement_questions, тестові курси тощо).
39