docs folder with steps

This commit is contained in:
Константин Лебединский
2026-03-21 16:06:24 +05:00
commit b42a3c3d55
14 changed files with 910 additions and 0 deletions
+50
View File
@@ -0,0 +1,50 @@
# Шаг 6: Назначение тестов
## Цель
Реализовать функционал назначения тестов сотрудникам и подразделениям.
---
## Задачи
### 6.1. Назначение теста
| Эндпоинт | Метод | Описание |
|----------|-------|----------|
| `/api/assignments` | GET | Список назначений |
| `/api/assignments` | POST | Назначить тест |
| `/api/assignments/:id` | GET | Детали назначения |
| `/api/assignments/:id` | PUT | Редактировать |
| `/api/assignments/:id` | DELETE | Удалить |
### 6.2. Параметры назначения
- `test_version_id` — активная версия теста
- `deadline` — срок сдачи (дата)
- `max_attempts` — допустимое количество попыток
- `targets` — получатели:
- Тип: `department` или `user`
- Список ID подразделений/сотрудников
### 6.3. Ограничения
- **HR:** может назначить любому сотруднику любого подразделения
- **Manager:** может назначить только сотрудникам своего подразделения
### 6.4. API для сотрудника
- **GET** `/api/my-assignments` — список назначенных тестов для текущего пользователя
- Статусы:
- `not_started` — не начат
- `in_progress` — в процессе
- `completed` — завершён
- `expired` — просрочен
---
## Результат
- Назначение тестов подразделениям или сотрудникам
- Ограничение по дедлайну и попыткам
- Список назначений для сотрудника