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,63 @@
+# Шаг 11: Страница настроек
+
+## Цель
+
+Реализовать страницу настроек для управления API ключами и системными параметрами.
+
+---
+
+## Задачи
+
+### 11.1. Страница настроек
+
+| Эндпоинт | Метод | Описание |
+|----------|-------|----------|
+| `/api/settings` | GET | Получить настройки |
+| `/api/settings` | PUT | Обновить настройки |
+
+### 11.2. Поля настроек
+
+| Поле | Описание |
+|------|----------|
+| deepseek_api_key | API ключ DeepSeek (скрыт на фронтенде) |
+
+### 11.3. Проверка подключения
+
+| Эндпоинт | Метод | Описание |
+|----------|-------|----------|
+| `/api/settings/test-connection` | POST | Проверить подключение к DeepSeek |
+
+**Ответ:**
+```json
+{
+  "success": true,
+  "message": "Подключение успешно"
+}
+```
+
+или
+
+```json
+{
+  "success": false,
+  "message": "Ошибка: неверный API ключ"
+}
+```
+
+### 11.4. Безопасность
+
+- API ключ никогда не передаётся в ответах GET `/api/settings`
+- При GET возвращается `***hidden***` вместо ключа
+- PUT принимает новый ключ и сохраняет в БД
+
+### 11.5. Права доступа
+
+- Только HR может изменять настройки
+
+---
+
+## Результат
+
+- Страница `/settings`
+- Ввод и сохранение API ключа
+- Проверка подключения к DeepSeek