Initialize Stage 0: Next.js 16 scaffold with auth and role-based routing

- Next.js 16.2.2 + React 19 + TypeScript + Tailwind v4
- Better Auth with email/password and role system (student/curator/admin)
- Prisma 7 schema: User, Session, Account, Verification + full LMS model
- Role-based dashboards: student /dashboard, curator /curator/dashboard, admin /admin/dashboard
- Auth pages: login, register, verify-email
- Better Auth API route handler
- Middleware for route protection
- Docker Compose with PostgreSQL 16
- Seed script with test users (admin/curator/student)
- CLAUDE.md and ROADMAP.md project documentation

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

ROADMAP.md

@@ -0,0 +1,197 @@
+# ROADMAP — LMS Second Brain
+
+**Стек:** Next.js 14 · PostgreSQL · Prisma · NextAuth v5 · Tailwind · shadcn/ui · TipTap · Kinescope · Resend · Hetzner Object Storage  
+**Принцип:** один этап — одна рабочая фича. Не переходим к следующему, пока текущий не работает end-to-end.
+
+---
+
+## Этап 0 — Каркас, auth, роли
+**Цель:** запущен локально, можно войти в систему с тремя ролями.
+
+- [ ] Инициализация Next.js 14 (App Router, TypeScript, Tailwind)
+- [ ] Docker Compose: PostgreSQL 16 + Redis (для сессий)
+- [ ] Prisma: подключение, начальная схема (User + роли)
+- [ ] NextAuth v5: вход по email/password, хранение сессии
+- [ ] Middleware: защита маршрутов по роли (STUDENT / CURATOR / ADMIN)
+- [ ] Базовые layout-компоненты: Header, Sidebar, страница-заглушка для каждой роли
+- [ ] Страница регистрации с подтверждением email (Resend)
+- [ ] Страница входа, выхода, «забыл пароль»
+- [ ] Seed-скрипт: создать тестового админа, куратора и ученика
+- [ ] `.env.example` заполнен, README с инструкцией запуска
+
+**Критерий готовности:** открываю localhost:3000, регистрируюсь, подтверждаю email, вхожу — вижу дашборд своей роли.
+
+---
+
+## Этап 1 — Курсы → Модули → Уроки (CRUD в админке)
+**Цель:** могу создать полную структуру курса из браузера.
+
+- [ ] Prisma-схема: Course, Module, Lesson (с порядком, статусом published)
+- [ ] Admin: список курсов, создать / редактировать / удалить курс
+- [ ] Admin: список модулей внутри курса, drag-and-drop сортировка
+- [ ] Admin: список уроков внутри модуля, drag-and-drop сортировка
+- [ ] Admin: редактор урока с TipTap (заголовки, списки, цитаты, код, картинки, ссылки)
+- [ ] Загрузка картинок в уроке → Hetzner Object Storage
+- [ ] Поле для Kinescope ID в уроке (просто текстовое, без интеграции — это Этап 2)
+- [ ] Публикация/скрытие курса и урока (черновик / опубликован)
+- [ ] Управление доступом: выдать / забрать доступ к курсу для пользователя
+
+**Критерий готовности:** создаю курс «Obsidian PKM», добавляю 2 модуля, в каждом по 3 урока с текстом и картинкой, публикую.
+
+---
+
+## Этап 2 — Интеграция Kinescope, рендер уроков для ученика
+**Цель:** ученик видит урок с видео Kinescope и текстом.
+
+- [ ] Компонент `KinescopePlayer` — обёртка над `@kinescope/react-kinescope-player`
+- [ ] Рендер урока для ученика: видео (если есть Kinescope ID) + текст + файлы
+- [ ] Загрузка PDF/файлов к уроку (Object Storage), список для скачивания
+- [ ] Страница курса для ученика: список модулей и уроков, статус прохождения
+- [ ] Навигация по урокам: предыдущий / следующий
+- [ ] Блокировка доступа к курсу без enrollment (middleware или server component)
+- [ ] Страница «Мои курсы» в личном кабинете ученика
+
+**Кинескоп-нюанс:** пока без DRM (бесплатный план), просто передаём `videoId` в компонент. Когда появится платный план — добавим signed URLs в отдельной задаче.
+
+**Критерий готовности:** ученик открывает урок, смотрит видео из Kinescope, читает текст, скачивает PDF.
+
+---
+
+## Этап 3 — Прогресс и линейное открытие уроков
+**Цель:** ученик проходит курс последовательно, прогресс сохраняется.
+
+- [ ] Prisma: таблица `LessonProgress` (userId, lessonId, completedAt)
+- [ ] Кнопка «Урок завершён» — создаёт запись в LessonProgress
+- [ ] Логика блокировки: следующий урок открыт только если предыдущий завершён
+- [ ] Прогресс-бар по курсу (% завершённых уроков)
+- [ ] Прогресс-бар по модулю
+- [ ] API: `POST /api/progress/complete` — принимает lessonId, создаёт прогресс
+- [ ] Иконки статуса уроков в боковой панели: ✓ пройден / 🔒 заблокирован / → текущий
+
+**Примечание:** если в уроке есть тест (Этап 4) или ДЗ (Этап 5) — кнопка «Завершить» появляется только после их прохождения/отправки. Эту логику дорабатываем на соответствующих этапах.
+
+**Критерий готовности:** прохожу урок 1, нажимаю «Завершён» — открывается урок 2. Урок 3 заблокирован. Прогресс-бар показывает 33%.
+
+---
+
+## Этап 4 — Тесты и квизы
+**Цель:** можно добавить тест к уроку, ученик проходит и получает результат.
+
+- [ ] Prisma: Quiz, QuizQuestion, QuizOption, QuizAttempt
+- [ ] Admin: создание теста к уроку (добавить вопрос → варианты ответов → отметить правильный)
+- [ ] Типы вопросов: одиночный выбор, множественный выбор, короткий текст
+- [ ] Рендер теста в уроке для ученика
+- [ ] Авто-проверка (single/multiple choice), результат сразу
+- [ ] Настройка: показывать правильные ответы после прохождения (да/нет)
+- [ ] Интеграция с прогрессом: урок с тестом засчитан только после прохождения теста
+
+**Критерий готовности:** добавляю тест из 3 вопросов к уроку, ученик проходит, видит результат, урок засчитывается.
+
+---
+
+## Этап 5 — Домашние задания и обратная связь куратора
+**Цель:** ученик сдаёт ДЗ, куратор оставляет комментарий.
+
+- [ ] Prisma: Homework, HomeworkSubmission, HomeworkFeedback
+- [ ] Admin: добавить блок ДЗ к уроку (текст задания)
+- [ ] Ученик: форма отправки ДЗ (текст + файлы → Object Storage)
+- [ ] Ученик: ДЗ засчитывается **автоматически при отправке** (урок открывается сразу)
+- [ ] Куратор: список ДЗ на проверку (все или по курсу), статус «новое / просмотрено»
+- [ ] Куратор: просмотр ДЗ, оставить текстовый комментарий
+- [ ] История обмена по ДЗ (ученик может ответить на комментарий куратора)
+- [ ] Уведомление ученику когда куратор оставил комментарий (заглушка — реальные email на Этапе 7)
+
+**Критерий готовности:** отправляю ДЗ — урок открывается. Куратор заходит в панель, видит ДЗ, оставляет комментарий. Ученик видит комментарий в карточке урока.
+
+---
+
+## Этап 6 — Обсуждения под уроками
+**Цель:** ученики могут общаться под каждым уроком.
+
+- [ ] Prisma: LessonComment (с поддержкой вложенных ответов — опционально)
+- [ ] Рендер треда комментариев под уроком
+- [ ] Форма отправки комментария (только для enrolled учеников)
+- [ ] Модерация: куратор/админ может удалить комментарий
+- [ ] Пагинация или infinite scroll для длинных тредов
+
+**Критерий готовности:** ученик оставляет комментарий, другой ученик его видит, куратор может удалить.
+
+---
+
+## Этап 7 — Email-уведомления
+**Цель:** все участники получают нужные письма через Resend.
+
+- [ ] Базовый email-шаблон (HTML, фирменный стиль)
+- [ ] Ученик: подтверждение регистрации (уже частично с Этапа 0, финализировать)
+- [ ] Ученик: письмо когда куратор оставил комментарий к ДЗ
+- [ ] Ученик: письмо когда ответили на его комментарий в уроке
+- [ ] Куратор / Админ: новое ДЗ на проверку
+- [ ] Куратор / Админ: новый комментарий в обсуждении
+- [ ] Админ: зарегистрирован новый ученик
+- [ ] Очередь отправки (edge case: Resend временно недоступен → retry)
+
+**Критерий готовности:** отправляю ДЗ — куратор получает email. Куратор отвечает — ученик получает email.
+
+---
+
+## Этап 8 — Импорт уроков из Markdown
+**Цель:** могу импортировать урок из .md-файла Obsidian одним действием.
+
+- [ ] API: `POST /api/admin/lessons/import-md` — принимает .md-файл
+- [ ] Парсинг frontmatter (title, order, kinescopeId и кастомные поля) → метаданные урока
+- [ ] Конвертация Markdown-тела в TipTap JSON (через remark / rehype)
+- [ ] UI в админке: кнопка «Импортировать из .md» на странице урока
+- [ ] Обработка картинок в Markdown (локальные пути → Object Storage)
+
+**Критерий готовности:** беру .md-файл из Obsidian с frontmatter и текстом → импортирую → урок создан с правильными метаданными и контентом.
+
+---
+
+## Этап 9 — Миграция с emdesell
+**Цель:** все пользователи и контент перенесены в новую LMS.
+
+- [ ] Скрипт импорта пользователей из CSV-экспорта emdesell (email, имя, курсы)
+- [ ] Создание пользователей без пароля + письмо «установите пароль»
+- [ ] Назначение доступов к курсам по данным из CSV
+- [ ] Чек-лист ручного переноса контента (уроки, PDF, структура курсов)
+- [ ] Скрипт проверки целостности: все enrolled пользователи имеют доступ к нужным курсам
+- [ ] QA: проверить 10 случайных аккаунтов после импорта
+
+**Критерий готовности:** все ученики из emdesell могут войти в новую LMS и продолжить обучение.
+
+---
+
+## Этап 10 — Telegram-бот и аналитика
+**Цель:** получаю уведомления в Telegram, вижу базовую аналитику.
+
+- [ ] Telegram-бот: уведомление куратору/админу о новом ДЗ
+- [ ] Telegram-бот: уведомление об ошибках (500-е, failed email и т.д.)
+- [ ] Yandex.Metrika: базовое подключение (pageviews)
+- [ ] Admin: простая страница аналитики (активные ученики, прогресс по курсам)
+
+---
+
+## Этап 11 — Деплой на Hetzner
+**Цель:** LMS работает на production-сервере по своему домену с SSL.
+
+- [ ] `docker-compose.prod.yml`: app + PostgreSQL + Redis + Nginx
+- [ ] Nginx: SSL через Let's Encrypt (certbot), reverse proxy на Next.js
+- [ ] GitHub Actions: CI/CD pipeline (lint → build → push Docker image → deploy)
+- [ ] Резервное копирование PostgreSQL (cron → Object Storage)
+- [ ] Мониторинг uptime (UptimeRobot или аналог)
+- [ ] `.env` на сервере через Hetzner Secrets Manager или vault-файл вне репозитория
+- [ ] Smoke-тест: регистрация → урок → ДЗ → куратор → email
+
+**Критерий MVP готов:** создаю курс из админки, добавляю уроки с Kinescope, импортирую ученика из emdesell, даю доступ — ученик регистрируется, проходит урок, сдаёт тест, отправляет ДЗ, получает автодоступ к следующему уроку, позже — комментарий куратора на email.
+
+---
+
+## Бэклог (после MVP)
+
+- Сертификаты по окончании курса
+- Геймификация (баллы, бейджи, рейтинги)
+- Промокоды и интеграция с платёжными системами
+- Дедлайны и расписания
+- Kinescope DRM (signed URLs) — при переходе на платный план
+- Водяные знаки на PDF и картинках
+- Мобильное приложение