Cursor rule

1---
2alwaysApply: true
3description: "Структура проєкту buero.de — платформа вивчення німецької мови"
4---
5 
6# Buero.de — структура проєкту
7 
8## Backend
9 
10- Код backend у папці **buero-backend-api/**; вихідний код у **buero-backend-api/src/**.
11- **Package manager:** npm.
12- Джерела правди (архітектура, модулі, auth) — у **docs/** (див. нижче).
13 
14## Джерела правди
15 
16- **Архітектура та БД:** docs/architecture.md
17- **API-модулі:** docs/api-plan.md, docs/modules/*.md
18- **Auth:** docs/auth-spec.md, docs/auth-config.md
19- **Вимоги:** docs/requirements.md
20- **Інструменти:** docs/tools.md
21 
22## Модулі backend (порядок реалізації)
23 
241. **Auth** — реєстрація, логін, refresh, logout; JWT у cookie; refresh у Postgres.
252. **Users** — профіль поточного користувача (GET/PATCH me).
263. **Placement Test** — один глобальний тест, рівень A1–B2, trial після проходження.
274. **Courses** — CRUD курсів (teacher); список/перегляд для студента (доступ за підпискою/trial).
285. **Course Materials** — CRUD матеріалів (teacher); читання для студента; типи: video (YouTube), vocabulary, grammar, quiz, scenario, cultural_insight, homework, text.
296. **Progress & Quizzes** — course_progress, quiz_attempts (покрокове збереження), рекомендований крок.
307. **Subscriptions & Billing** — купівля/підписка на курс (Checkout з course_id), user_course_access, Stripe Customer Portal, webhooks.
318. **Lesson Requests** — студент створює запит; вчитель приймає/відхиляє, виставляє completed/rejected.
32 
33## Ролі
34 
35- **student** | **teacher**. Адмін-ролі немає.
36- Будь-який вчитель може створювати/редагувати/видаляти будь-який курс (courses.teacher_id лише «хто створив»).
37 
38## Стек (MVP)
39 
40- Backend: NestJS, Prisma, PostgreSQL, JWT (cookie), Swagger, class-validator, class-transformer. **npm** для залежностей.
41- Платежі: Stripe. Відео: YouTube (embed). Redis у MVP не використовується.
42 
43## Контент-моделі (фіксовані в проєкті)
44 
45- **Placement Test:** питання в таблиці **placement_questions**; поле **question_data** (JSONB) — текст питання, варіанти відповідей, правильна відповідь; **order_index** для порядку. Один глобальний тест (без course_id). Деталі: docs/modules/02-placement-test.md, docs/architecture.md §3.13.
46- **Сценарії (course_materials type = scenario):** **content** — JSON з нодами та гілками. Мінімум 3 гілки на сценарій. Формат нод: `{ id, type: "situation"|"choice"|"consequence"|"explanation", text, choices?: [{ text, nextNodeId, isCorrect, feedback }] }`. Деталі: docs/architecture.md §3.6, docs/modules/04-course-materials.md.
47- **Відео (course_materials type = video):** у **content** обов'язково поле **youtube_video_id** для embed (YouTube). Опційно **video_source: "youtube"** для майбутнього S3. Деталі: docs/modules/04-course-materials.md.
48