ExamPlatform

Платформа компьютерного тестирования для школьников: учитель собирает тесты и домашние задания, назначает их ученикам и группам, следит за ходом работы и проверяет результаты.

Стек: Next.js (App Router) · Supabase (Postgres + Auth + Storage) · TypeScript · Tailwind · Vercel.

Запуск

npm install
npm run dev          # http://localhost:3000

Нужен .env.local — список переменных в .env.example.

Проверки перед пушем:

npx tsc --noEmit     # обязательно
npm run lint

Что где лежит

Каталог	Что внутри
app/teacher/	Кабинет учителя и админа
app/student/	Кабинет ученика, прохождение теста
app/api/	Серверные роуты
lib/	Бизнес-логика: оценивание, парсинг, роли, уведомления
components/	UI, сгруппирован по разделам
supabase/migrations/	Схема БД — единственный источник правды
scripts/	Импорт книг, нагрузочный тест, служебные утилиты
docs/	Разбор пайплайна импорта OCR-книг

Основные модули

• Тесты и ДЗ — сборка из PDF (распознавание через PaddleOCR), из библиотеки задач и из учебников; версионирование, ключи ответов, критерии.
• Библиотека — банк задач ОГЭ/ЕГЭ и учебники, с фильтрами по темам ФИПИ.
• Назначения и мониторинг — кому что задано, кто пишет прямо сейчас, что ждёт проверки.
• Оценивание — автопроверка по ключам, ручная проверка развёрнутых ответов, накопительный итог по назначению.
• Учебные программы — темы с прикреплёнными заданиями и прогрессом учеников.
• Посещаемость — журнал занятий с расписанием на несколько недель.
• Доски — совместное рабочее полотно с учеником или группой.

Правила разработки

Соглашения проекта — в AGENTS.md, он же подключён к CLAUDE.md.

Важное про схему: актуальная структура БД — это миграции и types/database.ts, а не документация. Типы генерируются из живой базы, при изменении схемы их нужно перегенерировать.

Архив

_local/ не под контролем версий и содержит рабочие материалы: образцы OCR-вывода, документы ФИПИ и устаревшую документацию v1 (май 2026), которая описывает уже заменённые решения — оставлена только на случай, если понадобится свериться с историей.