Aleksey Razorvin
d013a16e98
- Create DOC/СПРИНТЫ.md: 5 sprints, value-first approach - Sprint 1: infra + test creation (no auth) - Sprint 2: taking tests + results - Sprint 3: results tracker - Sprint 4: auth + roles + user management - Sprint 5: MAX notifications - Add DOC/ШАГИ/ШАГ_2026-03-21_005.md Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
150 lines
7.7 KiB
Markdown
150 lines
7.7 KiB
Markdown
# План спринтов
|
||
|
||
**Дата:** 2026-03-21
|
||
**Статус:** Согласовано
|
||
|
||
---
|
||
|
||
## Принцип
|
||
|
||
Каждый спринт — это готовое работающее приложение (frontend + backend), которое можно запустить локально командой `docker compose up` и протестировать вручную в браузере.
|
||
|
||
---
|
||
|
||
## Спринт 1 — Инфраструктура + Создание тестов
|
||
|
||
**Результат:** Поднят весь стек, можно зайти на страницу и создать тест.
|
||
|
||
### Инфраструктура
|
||
- [ ] Структура репозитория: `backend/`, `frontend/`, `nginx/`, `docker-compose.yml`
|
||
- [ ] `docker-compose.yml`: сервисы `db`, `backend`, `frontend`, `nginx`
|
||
- [ ] PostgreSQL: контейнер, volume для данных
|
||
- [ ] FastAPI: контейнер, `GET /api/health` → `{"status": "ok"}`
|
||
- [ ] Alembic: инициализирован, первая миграция (пустая схема)
|
||
- [ ] React + Vite: контейнер, базовая страница открывается в браузере
|
||
- [ ] Nginx: `/` → React SPA, `/api/` → FastAPI
|
||
|
||
### Создание тестов (без авторизации)
|
||
- [ ] Модели БД: `Test`, `Question`, `Answer`
|
||
- [ ] API: `POST /api/tests` — создать тест с вопросами и ответами
|
||
- [ ] API: `GET /api/tests` — список тестов
|
||
- [ ] API: `GET /api/tests/{id}` — детали теста
|
||
- [ ] Фронт: страница создания теста (название, вопросы, варианты, настройки)
|
||
- [ ] Фронт: список тестов
|
||
- [ ] Фронт: страница просмотра теста
|
||
|
||
**Настройки теста:** порог зачёта (%), таймер (опционально), разрешить возврат к предыдущему вопросу
|
||
|
||
---
|
||
|
||
## Спринт 2 — Прохождение теста
|
||
|
||
**Результат:** Можно выбрать тест из списка и пройти его, увидеть результат и разбор ошибок.
|
||
|
||
- [ ] Модели БД: `TestAttempt`, `AttemptAnswer`
|
||
- [ ] API: `POST /api/attempts` — начать попытку (фиксируем время начала)
|
||
- [ ] API: `POST /api/attempts/{id}/submit` — завершить попытку, подсчитать результат
|
||
- [ ] API: `GET /api/attempts/{id}/result` — результат с разбором ошибок
|
||
- [ ] Фронт: страница прохождения теста
|
||
- Случайный порядок вопросов
|
||
- Таймер с обратным отсчётом (если задан) — автосабмит по истечении
|
||
- Навигация назад (если разрешена настройкой теста)
|
||
- [ ] Фронт: страница результата
|
||
- Балл и процент
|
||
- Сдал / Не сдал (относительно порога)
|
||
- Разбор ошибок: вопрос, ответ сотрудника, правильный ответ
|
||
|
||
---
|
||
|
||
## Спринт 3 — Трекер результатов
|
||
|
||
**Результат:** Таблица всех попыток прохождения тестов.
|
||
|
||
- [ ] API: `GET /api/attempts` — все попытки (с фильтрами по тесту, дате)
|
||
- [ ] Фронт: страница трекера
|
||
- Таблица: сотрудник, тест, № попытки, начало, завершение, результат, зачёт
|
||
- Фильтрация по тесту и дате
|
||
- Пагинация
|
||
|
||
---
|
||
|
||
## Спринт 4 — Авторизация и управление пользователями
|
||
|
||
**Результат:** Вход по логину/паролю, роли ограничивают доступ. Можно создавать сотрудников и подразделения.
|
||
|
||
### Авторизация
|
||
- [ ] Модели БД: `User`, `Department`
|
||
- [ ] API: `POST /api/auth/login` → JWT access token
|
||
- [ ] API: `POST /api/auth/logout`
|
||
- [ ] API: `GET /api/auth/me`
|
||
- [ ] Middleware: проверка JWT на защищённых эндпоинтах
|
||
- [ ] Фронт: страница входа
|
||
- [ ] Фронт: защищённые роуты (редирект на логин если нет токена)
|
||
|
||
### Роли и права
|
||
|
||
| Роль | Тесты | Назначение | Трекер |
|
||
|------|-------|-----------|--------|
|
||
| HR-менеджер / Директор | Создаёт, все тесты | Всем сотрудникам | Вся клиника |
|
||
| Руководитель подразделения | Создаёт, свои тесты | Только своему отделу | Только свой отдел |
|
||
| Сотрудник | Только назначенные | — | Только свои |
|
||
|
||
### Управление пользователями
|
||
- [ ] API: CRUD подразделений
|
||
- [ ] API: CRUD пользователей (создание, редактирование, деактивация)
|
||
- [ ] Фронт: страница управления подразделениями (HR)
|
||
- [ ] Фронт: страница управления сотрудниками (HR / руководитель)
|
||
|
||
### Назначение тестов
|
||
- [ ] Модели БД: `TestAssignment`
|
||
- [ ] API: `POST /api/assignments` — назначить тест (получатели, дедлайн, кол-во попыток)
|
||
- [ ] Фронт: форма назначения теста
|
||
- [ ] Фронт: дашборд сотрудника — список назначенных тестов со статусами (`Не начат`, `В процессе`, `Завершён`, `Просрочен`)
|
||
|
||
### Версионирование тестов
|
||
- [ ] При попытке редактировать назначенный тест — создаётся новая версия
|
||
- [ ] Результаты привязаны к конкретной версии теста
|
||
|
||
---
|
||
|
||
## Спринт 5 — Уведомления в MAX
|
||
|
||
**Результат:** Сотрудники получают уведомления в мессенджер MAX.
|
||
|
||
- [ ] Изучить документацию MAX API
|
||
- [ ] Реализовать сервис уведомлений в backend
|
||
- [ ] Уведомление при назначении теста сотруднику
|
||
- [ ] Уведомление за N дней до дедлайна (настраивается)
|
||
- [ ] Поле `max_user_id` в профиле пользователя
|
||
- [ ] Фронт: в профиле пользователя — поле для MAX ID
|
||
|
||
---
|
||
|
||
## Структура репозитория (целевая после Спринта 1)
|
||
|
||
```
|
||
qa_test_app/
|
||
├── backend/
|
||
│ ├── app/
|
||
│ │ ├── api/ ← роутеры FastAPI
|
||
│ │ ├── models/ ← SQLAlchemy модели
|
||
│ │ ├── schemas/ ← Pydantic схемы
|
||
│ │ ├── services/ ← бизнес-логика
|
||
│ │ └── main.py
|
||
│ ├── alembic/
|
||
│ ├── Dockerfile
|
||
│ └── requirements.txt
|
||
├── frontend/
|
||
│ ├── src/
|
||
│ │ ├── api/ ← Axios + TanStack Query
|
||
│ │ ├── components/ ← переиспользуемые компоненты
|
||
│ │ ├── pages/ ← страницы
|
||
│ │ └── main.tsx
|
||
│ ├── Dockerfile
|
||
│ └── package.json
|
||
├── nginx/
|
||
│ └── nginx.conf
|
||
├── docker-compose.yml
|
||
└── DOC/
|
||
```
|