docs: add technical specification and step 002 log

- Create DOC/ТЗ.md with full system requirements
- Add DOC/ШАГИ/ШАГ_2026-03-21_002.md with step log

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Aleksey Razorvin
2026-03-21 11:20:22 +05:00
parent c1406c4ed1
commit 7ff7d9b1d0
2 changed files with 221 additions and 0 deletions
+80
View File
@@ -0,0 +1,80 @@
# ШАГ 002 — Создание технического задания
**Дата:** 2026-03-21
**Контекст:** Мастер-класс по разработке системы тестирования сотрудников клиники.
---
## Запрос
> переходим к следующему шагу: создание тз
В ходе диалога уточнены требования:
**О ролях:**
> разделение по ролям у нас устроено так: есть руководители подразделений, к примеру руководитель службы администраторов, главный врач, руководитель службы администраторов. это те сотрудники, которые создают тесты. каждый тест это не менее 7 вопросов и не менее трёх вариантов ответов на вопрос, один или несколько из которых правильные. руководители подразделений назначают свои тесты сотрудникам своих подразделений, при этом у меня, как у директора клиники есть руководитель службы HR, который может создать и назначить тест сотрудникам сразу же всех подразделений.
**О времени:**
> обычно мы даём время в днях на прохождение теста. но я подумал, и решил, что некоторые из тестов надо настроить на время.
**О результатах:**
> (выбрано: свой балл/%, свои ошибки)
> мы должны вести трекер всех попыток сдачи теста: какой сотрудник, какой тест, когда начал выполнение теста, когда закончил, с каким результатом. преодолел ли сотрудник заданный порог правильных ответов.
---
## Ответ
### Подход
Перед написанием ТЗ проведён диалог с заказчиком (директором клиники) для уточнения требований по ролям, формату теста, ограничениям по времени и логике результатов.
ТЗ сохранено в отдельный файл: `DOC/ТЗ.md`
### Ключевые решения, принятые в ТЗ
**Роли:**
- `HR-менеджер` — создаёт тесты и назначает их всем сотрудникам клиники
- `Руководитель подразделения` — создаёт тесты и назначает только своему подразделению
- `Сотрудник` — проходит назначенные тесты
**Формат теста:**
- Минимум 7 вопросов
- Минимум 3 варианта ответа на вопрос
- Один или несколько правильных ответов (смешанный тип)
- Порог зачёта — задаётся в % при создании теста
**Временны́е ограничения:**
- Срок сдачи — дедлайн в днях (обязательно при назначении)
- Таймер прохождения — лимит в минутах (опционально, настраивается в тесте)
**После завершения теста сотрудник видит:**
- Свой балл и процент
- Зачёт / незачёт
- Разбор ошибок (где ответил неверно и правильный ответ)
**Трекер попыток фиксирует:**
- Сотрудник, тест, № попытки
- Время начала и завершения
- Результат и факт зачёта
### Что создано
- `DOC/ТЗ.md` — полное техническое задание
### Открытые вопросы (зафиксированы в ТЗ)
Ряд деталей требует уточнения на следующих шагах:
- Роль директора клиники
- Редактирование теста после назначения
- Случайный или фиксированный порядок вопросов
- Возможность вернуться к предыдущему вопросу
- Уведомления о назначении и дедлайне
- Экспорт отчётов
### Следующие шаги
- [x] Написать ТЗ
- [ ] Обсудить и закрыть открытые вопросы из ТЗ
- [ ] Выбрать технологический стек
- [ ] Составить план спринтов