Browse Source

docs: insert Sprint 4 LLM/DeepSeek, shift tracker to Sprint 5, auth to Sprint 6

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
master
Aleksey Razorvin 1 week ago
parent
commit
6cb2d527e1
  1. 38
      DOC/СПРИНТЫ.md

38
DOC/СПРИНТЫ.md

@ -102,7 +102,38 @@
---
## Спринт 4 — Трекер результатов
## Спринт 4 — AI-помощник (DeepSeek)
**Результат:** При создании и редактировании теста доступен AI-ассистент на базе DeepSeek. Ключ API настраивается через страницу настроек.
### Страница настроек (`/settings`)
- [ ] Модель БД: `Setting` (key-value, ключ `deepseek_api_key`)
- [ ] Миграция `004`
- [ ] API: `GET /api/settings/{key}`, `PUT /api/settings/{key}`
- [ ] API: `POST /api/llm/check` — проверить подключение (тестовый запрос к DeepSeek)
- [ ] Фронт: страница `/settings` — поле для ввода ключа + кнопка «Проверить подключение»
### AI-функции в форме создания/редактирования теста
- [ ] API: `POST /api/llm/generate` — сгенерировать вопросы и ответы по теме
- [ ] API: `POST /api/llm/improve` — улучшить формулировку вопроса
- [ ] API: `POST /api/llm/distractors` — добавить варианты-дистракторы к вопросу
- [ ] API: `POST /api/llm/review` — проверить качество всего теста
### Интеграция в UI
- [ ] Кнопка «Сгенерировать с AI» на странице создания теста — вводишь тему, получаешь готовый набор вопросов
- [ ] Кнопка «✨» рядом с каждым вопросом — улучшить формулировку
- [ ] Кнопка «+ Дистракторы» рядом с каждым вопросом — дополнить неправильные варианты
- [ ] Кнопка «Проверить тест» — AI анализирует весь тест и выдаёт рекомендации
- [ ] Ссылка на страницу `/settings` в шапке приложения
### Технические детали
- DeepSeek API совместим с форматом OpenAI — используем библиотеку `openai` с `base_url=https://api.deepseek.com`
- Модель: `deepseek-chat`
- Ключ хранится в таблице `settings`, передаётся из бэкенда — фронт ключ не видит
---
## Спринт 5 — Трекер результатов
**Результат:** Таблица всех попыток прохождения тестов.
@ -114,7 +145,7 @@
---
## Спринт 5 — Авторизация и управление пользователями
## Спринт 6 — Авторизация и управление пользователями
**Результат:** Вход по логину/паролю, роли ограничивают доступ. Можно создавать сотрудников и подразделения.
@ -149,7 +180,8 @@
---
## Спринт 6 — Уведомления в MAX
## Спринт 7 — Уведомления в MAX
**Результат:** Сотрудники получают уведомления в мессенджер MAX.

Loading…
Cancel
Save