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
|
**Дата:** 2026-03-21
|
||||||
**Статус:** Согласовано
|
**Статус:** Согласовано
|
||||||
|
|
||||||
@@ -59,9 +59,10 @@
|
|||||||
- Разрешить возврат к предыдущему вопросу: да / нет
|
- Разрешить возврат к предыдущему вопросу: да / нет
|
||||||
|
|
||||||
**Правила работы с тестом:**
|
**Правила работы с тестом:**
|
||||||
- Автор может редактировать тест пока он не назначен никому
|
- Автор может редактировать тест пока никто его не проходил
|
||||||
- После назначения тест редактированию не подлежит — создаётся новая версия теста
|
- Если тест уже проходили — создаётся новая версия (`version + 1`), старая сохраняется
|
||||||
- Все версии теста хранятся; результаты привязаны к конкретной версии
|
- Все версии теста хранятся; результаты привязаны к конкретной версии
|
||||||
|
- Активная версия — та, которую видят сотрудники; автор может вручную переключить активную версию
|
||||||
- Тест можно деактивировать (скрыть из списка, не удалять)
|
- Тест можно деактивировать (скрыть из списка, не удалять)
|
||||||
|
|
||||||
### 4.3. Назначение теста
|
### 4.3. Назначение теста
|
||||||
@@ -110,6 +111,24 @@ HR-менеджер может назначить тест сотрудника
|
|||||||
HR-менеджер видит трекер по всей клинике.
|
HR-менеджер видит трекер по всей клинике.
|
||||||
Сотрудник видит только свои попытки.
|
Сотрудник видит только свои попытки.
|
||||||
|
|
||||||
|
### 4.7. AI-помощник при создании и редактировании тестов
|
||||||
|
|
||||||
|
Интеграция с LLM (DeepSeek) доступна авторам тестов в форме создания и редактирования.
|
||||||
|
|
||||||
|
**Функции AI-помощника:**
|
||||||
|
|
||||||
|
| Функция | Описание |
|
||||||
|
|---------|----------|
|
||||||
|
| Генерация теста | Автор вводит тему — AI генерирует готовый набор вопросов с вариантами ответов |
|
||||||
|
| Улучшение формулировки | AI переформулирует выбранный вопрос более чётко и однозначно |
|
||||||
|
| Добавление дистракторов | AI генерирует правдоподобные неправильные варианты ответов к вопросу |
|
||||||
|
| Проверка качества | AI анализирует весь тест и выдаёт рекомендации по улучшению |
|
||||||
|
|
||||||
|
**Настройки:**
|
||||||
|
- API-ключ DeepSeek вводится на странице `/settings` и хранится в базе данных
|
||||||
|
- Страница настроек содержит кнопку «Проверить подключение» — выполняет тестовый запрос к API
|
||||||
|
- Ключ хранится только на бэкенде и не передаётся на фронтенд
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 5. Нефункциональные требования
|
## 5. Нефункциональные требования
|
||||||
@@ -141,5 +160,4 @@ HR-менеджер видит трекер по всей клинике.
|
|||||||
- Интеграция с AD/LDAP
|
- Интеграция с AD/LDAP
|
||||||
- Мобильное приложение
|
- Мобильное приложение
|
||||||
- Вопросы с вложениями (изображения, видео)
|
- Вопросы с вложениями (изображения, видео)
|
||||||
- Автоматическая генерация вопросов
|
|
||||||
- Экспорт отчётов в Excel / PDF
|
- Экспорт отчётов в Excel / PDF
|
||||||
|
|||||||
@@ -34,19 +34,22 @@
|
|||||||
| База данных | PostgreSQL 16 |
|
| База данных | PostgreSQL 16 |
|
||||||
| Frontend | React 18 + TypeScript + Vite + Ant Design + TanStack Query |
|
| Frontend | React 18 + TypeScript + Vite + Ant Design + TanStack Query |
|
||||||
| Инфраструктура | Docker Compose + Nginx |
|
| Инфраструктура | Docker Compose + Nginx |
|
||||||
| Уведомления | Мессенджер MAX (Спринт 5) |
|
| AI-помощник | DeepSeek API (openai-совместимый) — Спринт 4 |
|
||||||
|
| Уведомления | Мессенджер MAX — Спринт 7 |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## План спринтов
|
## План спринтов
|
||||||
|
|
||||||
| Спринт | Содержание |
|
| Спринт | Содержание | Статус |
|
||||||
|--------|-----------|
|
|--------|-----------|--------|
|
||||||
| **1** | Инфраструктура (Docker, FastAPI, React, PostgreSQL) + создание тестов |
|
| **1** | Инфраструктура (Docker, FastAPI, React, PostgreSQL) + создание тестов | ✅ |
|
||||||
| **2** | Прохождение теста + результаты и разбор ошибок |
|
| **2** | Прохождение теста + результаты и разбор ошибок | ✅ |
|
||||||
| **3** | Трекер результатов |
|
| **3** | Редактирование тестов + версионность | ✅ |
|
||||||
| **4** | Авторизация, роли, подразделения, управление пользователями |
|
| **4** | AI-помощник при создании/редактировании тестов (DeepSeek) | ⬜ |
|
||||||
| **5** | Уведомления в MAX |
|
| **5** | Трекер результатов | ⬜ |
|
||||||
|
| **6** | Авторизация, роли, подразделения, управление пользователями | ⬜ |
|
||||||
|
| **7** | Уведомления в MAX | ⬜ |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user