diff --git a/DOC/ТЗ.md b/DOC/ТЗ.md index d7c955f..7084550 100644 --- a/DOC/ТЗ.md +++ b/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 diff --git a/README.md b/README.md index 98d4cf8..531752a 100644 --- a/README.md +++ b/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 | ⬜ | ---