diff --git a/DOC/СПРИНТЫ.md b/DOC/СПРИНТЫ.md index 5f13980..471eb03 100644 --- a/DOC/СПРИНТЫ.md +++ b/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.