vault backup: 2025-08-04 15:15:23

This commit is contained in:
Andrey Epifancev
2025-08-04 15:15:23 +04:00
parent 6a241479bd
commit f2983ded62

View File

@@ -7,7 +7,7 @@
- Создание заметок из текстовых и голосовых сообщений
- Семантический поиск по базе знаний
- Дополнение существующих заметок
- Автоматическое форматирование через GPT
- Автоматическое форматирование через YandexGPT
- Интеграция с Git для версионирования
- Автоматическая публикация через Quartz
@@ -41,13 +41,13 @@
**Ключевые зависимости:**
- `telegram-bot-api/v5` - Telegram Bot API
- `go-openai` - OpenAI API интеграция
- `yandexcloud-sdk-go` - YandexGPT API интеграция
- `go-git/v5` - Git операции
- `viper` - конфигурация
- `logrus` - структурированное логирование
**Внешние сервисы:**
- OpenAI API (GPT-4, Whisper)
- YandexGPT API (YandexGPT Lite/Pro, SpeechKit для голоса)
- Telegram Bot API
- Векторная база данных (Qdrant/Chroma)
@@ -134,7 +134,7 @@ User Message Flow:
▼ │ ▼
┌─────────────┐ │ ┌─────────────┐
│ Format │ │ │ Find & │
│ with GPT │ │ │ Update │
│ with YandexGPT │ │ │ Update │
└─────────────┘ │ └─────────────┘
│ │ │
▼ │ ▼
@@ -186,12 +186,12 @@ User Message Flow:
**Voice Service**
- Ответственность: Обработка голосовых сообщений, транскрипция
- Интерфейсы: Audio processing API
- Зависимости: Whisper API, File Service
- Зависимости: Yandex SpeechKit API, File Service
**LLM Service**
- Ответственность: Интеграция с GPT, форматирование, генерация контента
- Ответственность: Интеграция с YandexGPT, форматирование, генерация контента
- Интерфейсы: Text processing API
- Зависимости: OpenAI API
- Зависимости: YandexGPT API
### 4.3 Infrastructure Layer
@@ -209,11 +209,12 @@ User Message Flow:
### 5.1 Внешние интеграции
**OpenAI API**
- Назначение: GPT-4 для форматирования, Whisper для транскрипции
**YandexGPT API**
- Назначение: YandexGPT Lite/Pro для форматирования, SpeechKit для транскрипции
- Протокол: HTTPS REST API
- Аутентификация: API Key
- Аутентификация: API Key (IAM токен)
- Обработка ошибок: Retry with exponential backoff
- Модели: yandexgpt-lite, yandexgpt-pro
**Telegram Bot API**
- Назначение: Получение сообщений, отправка ответов
@@ -321,13 +322,13 @@ VPS Server
**Метрики:**
- Application health status
- Message processing time
- OpenAI API response times
- YandexGPT API response times
- Git operation success/failure rates
**Алерты:**
- Application down
- High error rate
- OpenAI API quota exceeded
- YandexGPT API quota exceeded
- Git push failures
## 8. Безопасность
@@ -347,11 +348,11 @@ VPS Server
### 9.1 Производительность
- Время отклика бота: < 2 секунды для текстовых сообщений
- Время создания заметки: < 5 секунд включая GPT обработку
- Время создания заметки: < 5 секунд включая YandexGPT обработку
- Голосовые сообщения: < 10 секунд для транскрипции и создания заметки
### 9.2 Надежность
- Graceful degradation при недоступности OpenAI API
- Graceful degradation при недоступности YandexGPT API
- Retry mechanisms для внешних API
- Data consistency через atomic git operations
@@ -364,7 +365,7 @@ VPS Server
## 10. Риски и ограничения
### 10.1 Технические риски
- **OpenAI API limits:** Rate limiting может замедлить обработку
- **YandexGPT API limits:** Rate limiting может замедлить обработку
- **Vector DB performance:** Поиск может замедляться с ростом количества заметок
- **VPS resources:** Ограниченная память и CPU для vector operations
@@ -378,3 +379,24 @@ VPS Server
- Регулярные backups Git repository
- Graceful fallbacks при недоступности внешних сервисов
- Resource monitoring для предотвращения исчерпания ресурсов VPS
## 11. Конфигурация YandexGPT
### 11.1 API Ключи и аутентификация
- **IAM Token:** Основной способ аутентификации для YandexGPT API
- **API Key:** Альтернативный способ для некоторых сервисов
- **Folder ID:** Идентификатор каталога в Yandex Cloud
### 11.2 Модели YandexGPT
- **yandexgpt-lite:** Быстрая модель для базового форматирования
- **yandexgpt-pro:** Продвинутая модель для сложных задач
- **speechkit:** Для обработки голосовых сообщений
### 11.3 Переменные окружения
```
YANDEX_API_KEY=your_api_key
YANDEX_FOLDER_ID=your_folder_id
YANDEX_IAM_TOKEN=your_iam_token
TELEGRAM_BOT_TOKEN=your_bot_token
VAULT_PATH=/path/to/obsidian/vault
```