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>
This commit is contained in:
@@ -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
|
||||
|
||||
@@ -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 | ⬜ |
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user