# ШАГ 002 — Создание технического задания

**Дата:** 2026-03-21
**Контекст:** Мастер-класс по разработке системы тестирования сотрудников клиники.

---

## Запрос

> переходим к следующему шагу: создание тз

В ходе диалога уточнены требования:

**О ролях:**
> разделение по ролям у нас устроено так: есть руководители подразделений, к примеру руководитель службы администраторов, главный врач, руководитель службы администраторов. это те сотрудники, которые создают тесты. каждый тест это не менее 7 вопросов и не менее трёх вариантов ответов на вопрос, один или несколько из которых правильные. руководители подразделений назначают свои тесты сотрудникам своих подразделений, при этом у меня, как у директора клиники есть руководитель службы HR, который может создать и назначить тест сотрудникам сразу же всех подразделений.

**О времени:**
> обычно мы даём время в днях на прохождение теста. но я подумал, и решил, что некоторые из тестов надо настроить на время.

**О результатах:**
> (выбрано: свой балл/%, свои ошибки)
> мы должны вести трекер всех попыток сдачи теста: какой сотрудник, какой тест, когда начал выполнение теста, когда закончил, с каким результатом. преодолел ли сотрудник заданный порог правильных ответов.

---

## Ответ

### Подход

Перед написанием ТЗ проведён диалог с заказчиком (директором клиники) для уточнения требований по ролям, формату теста, ограничениям по времени и логике результатов.

ТЗ сохранено в отдельный файл: `DOC/ТЗ.md`

### Ключевые решения, принятые в ТЗ

**Роли:**
- `HR-менеджер` — создаёт тесты и назначает их всем сотрудникам клиники
- `Руководитель подразделения` — создаёт тесты и назначает только своему подразделению
- `Сотрудник` — проходит назначенные тесты

**Формат теста:**
- Минимум 7 вопросов
- Минимум 3 варианта ответа на вопрос
- Один или несколько правильных ответов (смешанный тип)
- Порог зачёта — задаётся в % при создании теста

**Временны́е ограничения:**
- Срок сдачи — дедлайн в днях (обязательно при назначении)
- Таймер прохождения — лимит в минутах (опционально, настраивается в тесте)

**После завершения теста сотрудник видит:**
- Свой балл и процент
- Зачёт / незачёт
- Разбор ошибок (где ответил неверно и правильный ответ)

**Трекер попыток фиксирует:**
- Сотрудник, тест, № попытки
- Время начала и завершения
- Результат и факт зачёта

### Что создано

- `DOC/ТЗ.md` — полное техническое задание

### Открытые вопросы (зафиксированы в ТЗ)

Ряд деталей требует уточнения на следующих шагах:
- Роль директора клиники
- Редактирование теста после назначения
- Случайный или фиксированный порядок вопросов
- Возможность вернуться к предыдущему вопросу
- Уведомления о назначении и дедлайне
- Экспорт отчётов

### Следующие шаги

- [x] Написать ТЗ
- [ ] Обсудить и закрыть открытые вопросы из ТЗ
- [ ] Выбрать технологический стек
- [ ] Составить план спринтов