2vur2

Подготовка к экзаменам DİM на основе статистики. Next.js 16 (App Router) + TypeScript + Tailwind 4 + Turso (libSQL) + Drizzle + Auth.js v5.

Запуск

cp .env.example .env.local   # заполнить значения (см. ниже)
npm install
npm run db:migrate           # применить миграции к Turso
npm run dev                  # http://localhost:3000

Письма в разработке не отправляются: EMAIL_PROVIDER=console печатает их в терминал npm run dev и сохраняет в .dev-mail/ (ссылки подтверждения и сброса пароля берите оттуда).

Команды

Команда	Что делает
npm run dev / build / start	Next.js
npm run lint / typecheck / format	ESLint, TypeScript, Prettier
npm test	Unit-тесты (Vitest)
npm run test:e2e	E2E (Playwright в системном Google Chrome). Тестовые пользователи e2e+…@example.test удаляются после прогона
npm run db:generate	Новая миграция из src/db/schema.ts → db/migrations/
npm run db:migrate / db:studio	Применить миграции / открыть Drizzle Studio

Переменные окружения

Переменная	Назначение
TURSO_DATABASE_URL, TURSO_AUTH_TOKEN	База Turso (turso db show <db> --url, turso db tokens create <db>)
AUTH_SECRET	Ключ подписи сессий: openssl rand -base64 33
AUTH_TRUST_HOST	true вне Vercel (локальный next start)
GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET	Google-вход (пока не подключён; пусто — кнопка скрыта)
APP_URL	Публичный адрес для ссылок в письмах (production: https://2vur2.az)
EMAIL_PROVIDER, EMAIL_FROM	console (реальный провайдер позже)
CAPTCHA_PROVIDER	none (провайдер позже)
FEATURE_GUARDIAN_CONSENT	Шаг для родителя (<18). Выключен до решения юриста
NEXT_PUBLIC_TELEGRAM_URL, NEXT_PUBLIC_INSTAGRAM_URL	Ссылки на каналы. Пусто — на главной вместо Telegram/Instagram показываются «Pulsuz başla» и «Statistikaya bax»

Домен

2vur2.az (регистратор online.az) подключён к проекту imtahan-app; www.2vur2.az → 308 на 2vur2.az. У online.az можно менять только DNS-серверы, поэтому DNS ведёт Vercel: ns1.vercel-dns.com, ns2.vercel-dns.com. Записи (A и т. д.) Vercel создаёт сам; почтовые MX/TXT, если появятся, добавляются в Vercel → Domains.

Структура

src/
  app/(auth)/        вход, регистрация, подтверждение почты, сброс пароля + server actions
  app/api/auth/      Auth.js и ссылка подтверждения почты
  auth.ts            Auth.js (Credentials, JWT); auth.config.ts — лёгкая часть для proxy
  proxy.ts           редирект с защищённых страниц (основная проверка — на сервере)
  components/        UI по дизайн-системе (кнопки, поля, пароль, сегменты, алерты…)
  config/            бренд, реальные цифры, флаги
  content/az.ts      все тексты интерфейса
  db/                схема Drizzle и подключение к Turso
  lib/               пароли (argon2id), токены, rate limit, письма, CAPTCHA
db/migrations/       SQL-миграции
e2e/                 Playwright-тесты

Демо-экраны приложения

Пока нет Excel и банка вопросов, экраны приложения работают на демо-данных из дизайна (src/lib/demo/):

• content.ts — темы, 70 вопросов дня (7 тем × 10), 4 пробных экзамена × 25 вопросов (без ответов);
• keys.ts — ответы и решения, только на сервере (в браузер уходят после ответа);
• state.ts — прогресс пользователя в httpOnly-cookie (покупки, ответы, результаты, подписка);
• actions.ts — server actions: ответ на вопрос дня, старт/автосохранение/завершение экзамена, mock-оплата, отмена подписки, сброс демо.

Таймер экзамена считается от серверного времени старта. Письменные ответы проверяются вручную (в демо они «на проверке»), бал — демо-формула 4 балла за вопрос. Новый пользователь начинает с нуля и без подписки (бесплатный план): 0 / 70 вопросов дня, ни одного купленного экзамена, серия и прогресс по типам считаются из ответов. Сбросить всё к нулю: Профиль → «Demo məlumatlarını sıfırla».

Вопросы дня (/gunun-suallari — обзор всех тем с номерами 1–10, то же на панели): на бесплатном плане в каждой теме открыт только 1-й вопрос (FREE_DAILY_PER_TOPIC), остальные 9 — с замком и кнопкой «Abunə ol». Доступ проверяется на сервере: у закрытого вопроса текст, варианты и ссылка на сборник не попадают в HTML, server action ответ не принимает. Подписка — mock-оплата «Aylıq abunə» (/odenis), после неё открыты все 70. Переключатель «Pulsuz plan kimi bax» в Профиле показывает бесплатный вид и при активной подписке. Когда придут данные, src/lib/demo/ заменяется таблицами БД, экраны остаются.

Демо-аккаунт: npm run db:seed-demo (логин и пароль — DEMO_* в .env.local).

Главная (/)

Лендинг по макету заказчика (Landing1 + Landing2): hero с живым топ-5 тем, цифры (вопросы, годы, темы, % найденных в сборнике 2025), «Necə işləyir», пример карточки (ответ не проверяется и не уходит в браузер — после выбора приглашение к регистрации), 8 самых частых тем, формат пробного экзамена, тарифы, блок учителя (заглушки), FAQ, CTA и тёмный футер. Все цифры — из тех же SQL-представлений, что и /statistika. Страница статическая и обновляется раз в 10 минут (revalidate = 600); если база недоступна, блоки с цифрами скрываются. Тексты — src/content/az-landing.ts, компоненты — src/components/landing/.

Онлайн-репетитор (/onlayn-repetitor)

Вопросы, которые по анализу чаще всего попадают на экзамен (доля — REPETITOR_HIT_RATE в src/lib/repetitor/source.ts, сейчас 90 %, цифра из анализа заказчика). Только для подписчиков: на бесплатном плане — экран с замком и «Abunə ol», страницы вопросов редиректят туда, текст вопросов в HTML не попадает, server actions без подписки не работают.

Режим репетитора: вопрос → «İpucu» (подсказка приходит с сервера только по запросу) → проверка → «Repetitorun izahı» (пошаговое решение) → ссылка на сборник и статистику темы → следующий вопрос. Прогресс (ответ, верно/неверно, была ли подсказка) — в демо-cookie, на панели — карточка с прогрессом.

Сейчас данные — мок: src/lib/repetitor/mock.ts (5 самых частых тем × 4 вопроса, тексты свои). Когда появится админ-панель, меняется только src/lib/repetitor/source.ts (функции уже async: listRepetitorTopics, getRepetitorTopic, findRepetitorQuestion, getRepetitorKey) — страницы не трогаем. Формат вопроса — src/lib/repetitor/types.ts (тема = slug из статистики, тип, сколько раз выпадал, текст, варианты A–E, ссылка на сборник; отдельно на сервере — ответ, подсказка, шаги решения).

Мои ошибки (/sehvlerim)

Собирает ошибки пользователя: вопросы дня (неверно или «Bilmirəm»), онлайн-репетитор, закрытые вопросы пробных экзаменов (неверный ответ; если вопрос экзамена совпадает с вопросом дня — это один вопрос). У каждой ошибки — «Sənin cavabın» / «Düzgün cavab» и ссылка на вопрос с решением; сгруппированы по темам. Вход — пункт бокового меню, карточка на панели, подсказка после неверного ответа.

«Səhvlərimi təkrar et» создаёт сессию (/sehvlerim/tekrar/[n]): каждая активная ошибка, после неё 0–2 похожих вопроса (сначала того же типа, потом той же темы; ещё не решённые — в приоритете), максимум 15 вопросов. Похожие берутся только из доступных пользователю (на бесплатном плане — открытые вопросы дня; репетитор — с подпиской; вопросы экзамена как «похожие» не даются). Верный ответ на ошибку отмечает её «Düzəldildi» (в следующую сессию она не попадает); неверный ответ на похожий вопрос добавляет его в ошибки. Код — src/lib/review/ (pool.ts — единая модель вопроса и ключи на сервере, mistakes.ts — список и сборка сессии, actions.ts).

DİM bal simulyatoru (/bal-simulyatoru)

Каркас раздела, контент добавит заказчик. Выбор типа экзамена (сейчас доступен «Buraxılış · 11-ci sinif», «9-cu sinif» и «Qəbul» — «Tezliklə»), по каждому формату вопросов (13 закрытых, 5 кодируемых, 7 письменных) — количество верных ответов (поле и кнопки −/+), «Təxmini bal» пересчитывается сразу; на мобильном балл закреплён под шапкой. Расчёт — демо-формула (4 балла за верный ответ, как в результатах пробных экзаменов). Настоящие формулы DİM, новые типы экзаменов и тексты меняются в одном месте: src/lib/score/simulators.ts (правила) и az.app.score (тексты, блок «Bal necə hesablanır» — заглушка [...]). Доступен всем вошедшим пользователям; вход — боковое меню и плитка на панели.

Статистика (/statistika)

Данные — Excel-анализ DIM_riyaziyyat_YEKUN_statistika.xlsx (в репозиторий не коммитится, лежит в data/):

npm run stats:import                      # data/DIM_riyaziyyat_YEKUN_statistika.xlsx
npm run stats:import -- путь/к/файлу.xlsx

• «Mövzular» → topics, «Bütün suallar» → exam_questions_stats (без текста вопросов), «Qeydlər» → stat_notes.
• Идемпотентно: upsert по (экзамен, № вопроса), строки, которых нет в файле, удаляются. Тема из «Bütün suallar», которой нет в «Mövzular», не создаётся — скрипт выводит список и останавливается.
• Агрегаты — SQL-представления (db/migrations/0002_stats_views.sql, 0003_…): topic_stats, exam_stats, topic_exam_stats, topic_match_stats, topic_type_stats. Все цифры на странице берутся из них.
• Страница публичная. Платные части (приоритетный план, полный список ссылок на сборники) проверяются на сервере; для бесплатных — 3 ссылки, остальные не запрашиваются. Демо-переключатель «Pulsuz plan kimi bax» — в Профиле.

Безопасность (что уже есть)

• Пароли — argon2id (19 MiB, t=2). В БД хранятся только SHA-256 хэши токенов из писем.
• Ссылка подтверждения работает 24 ч, ссылка сброса пароля — 30 мин, обе одноразовые.
• Rate limit в БД (работает на нескольких инстансах): вход, регистрация, сброс, повторная отправка письма.
• Сброс пароля не раскрывает, существует ли аккаунт. Проверки через zod, тексты ошибок на азербайджанском.
• Заголовки: nosniff, Referrer-Policy, X-Frame-Options, Permissions-Policy. CSP — на этапе 8.