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