Browse Source

docs: update ТЗ to v1.2 and README with new sprint plan

ТЗ v1.2:
- Versioning logic: 'after first attempt' instead of 'after assignment'
- Added section 4.7 AI assistant (DeepSeek)
- Removed 'auto question generation' from out-of-scope

README:
- Sprint table updated: 7 sprints, statuses, Sprint 4 = AI/DeepSeek
- Added AI and MAX to stack table

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
master
Aleksey Razorvin 1 week ago
parent
commit
c1a38bfef8
  1. 26
      DOC/ТЗ.md
  2. 19
      README.md

26
DOC/ТЗ.md

@ -1,7 +1,7 @@
# Техническое задание
## Система тестирования сотрудников клиники
**Версия:** 1.1
**Версия:** 1.2
**Дата:** 2026-03-21
**Статус:** Согласовано
@ -59,9 +59,10 @@
- Разрешить возврат к предыдущему вопросу: да / нет
**Правила работы с тестом:**
- Автор может редактировать тест пока он не назначен никому
- После назначения тест редактированию не подлежит — создаётся новая версия теста
- Автор может редактировать тест пока никто его не проходил
- Если тест уже проходили — создаётся новая версия (`version + 1`), старая сохраняется
- Все версии теста хранятся; результаты привязаны к конкретной версии
- Активная версия — та, которую видят сотрудники; автор может вручную переключить активную версию
- Тест можно деактивировать (скрыть из списка, не удалять)
### 4.3. Назначение теста
@ -110,6 +111,24 @@ HR-менеджер может назначить тест сотрудника
HR-менеджер видит трекер по всей клинике.
Сотрудник видит только свои попытки.
### 4.7. AI-помощник при создании и редактировании тестов
Интеграция с LLM (DeepSeek) доступна авторам тестов в форме создания и редактирования.
**Функции AI-помощника:**
| Функция | Описание |
|---------|----------|
| Генерация теста | Автор вводит тему — AI генерирует готовый набор вопросов с вариантами ответов |
| Улучшение формулировки | AI переформулирует выбранный вопрос более чётко и однозначно |
| Добавление дистракторов | AI генерирует правдоподобные неправильные варианты ответов к вопросу |
| Проверка качества | AI анализирует весь тест и выдаёт рекомендации по улучшению |
**Настройки:**
- API-ключ DeepSeek вводится на странице `/settings` и хранится в базе данных
- Страница настроек содержит кнопку «Проверить подключение» — выполняет тестовый запрос к API
- Ключ хранится только на бэкенде и не передаётся на фронтенд
---
## 5. Нефункциональные требования
@ -141,5 +160,4 @@ HR-менеджер видит трекер по всей клинике.
- Интеграция с AD/LDAP
- Мобильное приложение
- Вопросы с вложениями (изображения, видео)
- Автоматическая генерация вопросов
- Экспорт отчётов в Excel / PDF

19
README.md

@ -34,19 +34,22 @@
| База данных | PostgreSQL 16 |
| Frontend | React 18 + TypeScript + Vite + Ant Design + TanStack Query |
| Инфраструктура | Docker Compose + Nginx |
| Уведомления | Мессенджер MAX (Спринт 5) |
| AI-помощник | DeepSeek API (openai-совместимый) — Спринт 4 |
| Уведомления | Мессенджер MAX — Спринт 7 |
---
## План спринтов
| Спринт | Содержание |
|--------|-----------|
| **1** | Инфраструктура (Docker, FastAPI, React, PostgreSQL) + создание тестов |
| **2** | Прохождение теста + результаты и разбор ошибок |
| **3** | Трекер результатов |
| **4** | Авторизация, роли, подразделения, управление пользователями |
| **5** | Уведомления в MAX |
| Спринт | Содержание | Статус |
|--------|-----------|--------|
| **1** | Инфраструктура (Docker, FastAPI, React, PostgreSQL) + создание тестов | ✅ |
| **2** | Прохождение теста + результаты и разбор ошибок | ✅ |
| **3** | Редактирование тестов + версионность | ✅ |
| **4** | AI-помощник при создании/редактировании тестов (DeepSeek) | ⬜ |
| **5** | Трекер результатов | ⬜ |
| **6** | Авторизация, роли, подразделения, управление пользователями | ⬜ |
| **7** | Уведомления в MAX | ⬜ |
---

Loading…
Cancel
Save