docs folder with steps

2026-03-21 16:06:24 +05:00
commit b42a3c3d55
14 changed files with 910 additions and 0 deletions
@@ -0,0 +1,89 @@
+# Шаг 10: AI-помощник (DeepSeek)
+
+## Цель
+
+Интегрировать LLM DeepSeek для помощи при создании тестов.
+
+---
+
+## Задачи
+
+### 10.1. Настройка API
+
+- Сохранить API ключ DeepSeek в таблице `settings`
+- Ключ хранится только на бэкенде, не передаётся на фронтенд
+
+### 10.2. Функции AI-помощника
+
+#### Генерация теста
+
+| Эндпоинт | Метод | Описание |
+|----------|-------|----------|
+| `/api/ai/generate-test` | POST | Сгенерировать тест |
+
+**Запрос:**
+```json
+{
+  "topic": "Оказание первой помощи",
+  "question_count": 10
+}
+```
+
+**Ответ:** готовый тест с вопросами и вариантами ответов
+
+#### Улучшение формулировки
+
+| Эндпоинт | Метод | Описание |
+|----------|-------|----------|
+| `/api/ai/improve-question` | POST | Улучшить вопрос |
+
+**Запрос:**
+```json
+{
+  "question": "Что делать при переломе?"
+}
+```
+
+#### Добавление дистракторов
+
+| Эндпоинт | Метод | Описание |
+|----------|-------|----------|
+| `/api/ai/add-distractors` | POST | Добавить неправильные варианты |
+
+**Запрос:**
+```json
+{
+  "question": "Признаки инфаркта:",
+  "correct_answer": "Боль в груди",
+  "count": 3
+}
+```
+
+#### Проверка качества
+
+| Эндпоинт | Метод | Описание |
+|----------|-------|----------|
+| `/api/ai/check-quality` | POST | Проверить качество теста |
+
+**Запрос:**
+```json
+{
+  "test": { ... }
+}
+```
+
+**Ответ:** рекомендации по улучшению
+
+### 10.3. Обработка ошибок
+
+- Timeout при длительном ответе API
+- Логирование ошибок
+- Fallback при недоступности DeepSeek
+
+---
+
+## Результат
+
+- AI-генерация вопросов
+- Улучшение формулировок
+- Рекомендации по качеству