Закрытый веб-сервис для учебных тестов детей.
Сервис планируется на React/Next.js и PostgreSQL. Администратор загружает тесты JSON-файлами, назначает их детям или группам, а дети проходят тесты и видят прогресс по предметам.
- Требования к продукту
- Формат теста и JSON Schema
- JSON Schema
- Хранение тестов: реализация и открытые вопросы
- API и модель данных
- Экраны и критерии приёмки
- Пошаговый план разделов ученика: Subjects, Progress, Tests и Home
Документы описывают согласованный черновик первой версии и явно отмечают решения, которые ещё нужно принять до разработки.
Требуется Node.js 20.9 или новее.
cd /Users/olchu/Documents/projects/pet/repetition
npm install
npm run devОткройте http://localhost:3000.
Для API и локальной базы PostgreSQL:
cp .env.example .env
createuser repetition_app
psql postgres -c "ALTER ROLE repetition_app WITH LOGIN PASSWORD 'repetition_local';"
createdb --owner=repetition_app repetition
createdb --owner=repetition_app repetition_shadow
npm run db:validate
npm run db:migrate -- --name init
SEED_ADMIN_PASSWORD="replace-this-password" npm run db:seedКоманды createuser и createdb нужны только один раз. Если роль или база уже существуют, их повторно создавать не нужно. Запуск PostgreSQL через Homebrew описан в docs/LOCAL-DATABASE.md.
Проверки перед коммитом:
npm run lint
npm run build
node --test tests/overview.integration.cjs
node --test tests/rewards.integration.cjsОба теста запускают реальные обработчики API с тестовой авторизацией и PostgreSQL из DATABASE_URL, создают временные данные и удаляют их после проверки.