Quiz Monorepo

Минимальный monorepo для квиз-платформы с приложениями:

• apps/backend — Node.js + TypeScript API.
• apps/frontend — пользовательский React-клиент.
• apps/admin — админ-панель React.
• packages/shared — общие типы и утилиты.

Product planning

• Детальный план запуска MVP: docs/mvp-delivery-plan.md.
• Машиночитаемый workflow исполнения (стадии, зависимости, KPI): docs/mvp-execution-workflow.yaml.
• Практический план исполнения “что дальше”: docs/mvp-next-steps.md.

Требования

• Node.js 20+
• npm 10+
• Docker + Docker Compose

Быстрый старт

1. Установить зависимости:

npm install

2. Скопировать переменные окружения:

cp env.example .env

3. Поднять PostgreSQL:

docker compose up -d postgres

4. Прогнать миграции:

npm run db:migrate -w apps/backend

5. Заполнить демо-данными:

npm run db:seed -w apps/backend

Локальный запуск

• Backend:

npm run dev -w apps/backend

• Frontend:

npm run dev -w apps/frontend

• Admin:

npm run dev -w apps/admin

Проверки

• Lint для всего monorepo:

npm run lint

• Тесты для всего monorepo:

npm run test

• Сборка:

npm run build

База данных

SQL-миграции: apps/backend/db/migrations.

Seed-данные: apps/backend/db/seeds.

Ключевые таблицы:

• users
• rooms
• room_members
• quiz_packs
• questions
• game_sessions
• session_questions
• answers
• session_scores
• generated_assets
• reports
• analytics_events