feat: Add Nanaxe server with Docker, GitHub Actions CI/CD, and auto-deployment

- Add complete server infrastructure with Gitea, API, PostgreSQL - Implement Obsidian-compatible markdown mindmap converter - Add Flutter service for server synchronization - Configure GitHub Actions for automated build and deploy - Add production docker-compose with health checks - Include VPS setup and deployment scripts - Add comprehensive deployment documentation
2026-04-19 22:18:25 +05:00
parent 52aea9ac87
commit f1e0f6b5ef
56 changed files with 8892 additions and 397 deletions
@@ -0,0 +1,162 @@
+# 🔄 Как включить реальный API DeepSeek
+
+## Текущий режим: MOCK ✅
+
+Сейчас приложение работает с **mock данными** (без реальных запросов к API).
+
+Это означает:
+- ✅ Все функции работают без интернета
+- ✅ Не расходуется баланс DeepSeek
+- ⚠️ Ответы не от AI, а заготовленные шаблоны
+
+---
+
+## Когда включить реальный API
+
+### Шаг 1: Проверьте баланс DeepSeek
+
+1. Зайдите на https://platform.deepseek.com/billing
+2. Убедитесь что на счету есть средства (минимум $1-2)
+3. Если баланс пуст - пополните счёт
+
+### Шаг 2: Измените режим в коде
+
+Откройте файл: `lib/core/deepseek_service.dart`
+
+Найдите строку (примерно строка 12):
+```dart
+final bool useMockMode = true;
+```
+
+Измените на:
+```dart
+final bool useMockMode = false;
+```
+
+### Шаг 3: Перезапустите приложение
+
+```bash
+flutter run
+```
+
+---
+
+## Как это работает
+
+### Mock режим (useMockMode = true)
+```
+Запрос → DeepSeek Service → Mock данные → Ответ
+         (без API запросов)
+```
+
+**Плюсы:**
+- Быстро (без сетевых задержек)
+- Бесплатно (не нужен API)
+- Стабильно (всегда работает)
+
+**Минусы:**
+- Ответы не от AI
+- Не адаптированы под контекст
+
+### Реальный API (useMockMode = false)
+```
+Запрос → DeepSeek Service → DeepSeek API → AI ответ
+         (реальный запрос)
+```
+
+**Плюсы:**
+- Умные ответы от AI
+- Адаптация под контекст
+- Качественные описания
+
+**Минусы:**
+- Расходует токены (~$0.001-0.01 за запрос)
+- Нужен интернет
+- Медленнее (1-3 секунды)
+
+---
+
+## Проверка работы API
+
+После включения реального API, запустите тест:
+
+```bash
+dart run test_deepseek_api.dart
+```
+
+Если видите ✅ вместо ❌ - API работает!
+
+---
+
+##Fallback режим
+
+Даже при `useMockMode = false`, если API запрос не прошёл (нет баланса, ошибка сети), 
+сервис автоматически вернётся к mock данным.
+
+В консоли увидите:
+```
+DeepSeek API Error: 402 - Insufficient Balance
+⚠️ Используется mock режим как fallback
+```
+
+---
+
+## Стоимость запросов
+
+Примерные расходы на DeepSeek API:
+
+| Действие | Токенов | Стоимость |
+|----------|---------|-----------|
+| Генерация подзадач | ~500 | $0.0001 |
+| Приоритизация | ~100 | $0.00003 |
+| Описание задачи | ~200 | $0.00006 |
+| Планирование | ~1000 | $0.0003 |
+| Mind-карта | ~1500 | $0.0004 |
+
+**При $2 на счету** можно сделать примерно:
+- 20,000 генераций подзадач
+- 60,000 приоритизаций
+- 5,000 mind-карт
+
+---
+
+## Рекомендации
+
+### Для разработки и тестирования
+Оставьте **mock режим** (`useMockMode = true`)
+- Быстрее цикл разработки
+- Не тратите токены
+
+### Для продакшена
+Включите **реальный API** (`useMockMode = false`)
+- Пользователи получат AI функции
+- Расходы минимальные
+
+---
+
+## Troubleshooting
+
+### Ошибка 402: Insufficient Balance
+```
+1. Проверьте баланс: https://platform.deepseek.com/billing
+2. Пополните счёт
+3. Или верните useMockMode = true
+```
+
+### Ошибка 401: Invalid API Key
+```
+1. Проверьте что ключ в .env начинается с 'sk-'
+2. Нет лишних пробелов
+3. Ключ активен в Dashboard
+```
+
+### Ошибка сети
+```
+1. Проверьте интернет-соединение
+2. DeepSeek может быть недоступен в вашем регионе
+3. Сервис автоматически переключится на mock
+```
+
+---
+
+**Готово! 🚀**