docs: expand lint scope batch6 (2 files)

docs/FINAL_INTEGRATION_SUMMARY.md

@@ -26,7 +26,7 @@
 **Результат**: Боти читають PDF файли та відповідають на питання про них!
 
 **Приклад**:
-```
+```text
 Ти → 📄 whitepaper.pdf
 Бот → ✅ Документ 'whitepaper.pdf' оброблено.
       [Перші 500 символів тексту]...
@@ -47,7 +47,7 @@
 **Результат**: Боти відповідають голосом на голосові повідомлення!
 
 **Приклад**:
-```
+```text
 Ти → 🎤 [Голосове] "Привіт, як справи?"
 Бот → 🔊 [Голосове відповідь] "Привіт! У мене все добре..."
 ```
@@ -74,14 +74,14 @@
 6. Voice Responses (1h)
 7. Documents Processed (1h)
 
-**Доступ**: http://144.76.224.179:3000  
+**Доступ**: [http://144.76.224.179:3000](http://144.76.224.179:3000)  
 **Login**: admin / admin
 
 ---
 
 ## 📊 Статистика змін
 
-### Файли створені:
+### Файли створені
 1. `/telegram-gateway/app/voice_handler.py` - обробка voice та document
 2. `/monitoring/grafana/dashboards/daarion_services_overview.json`
 3. `/monitoring/grafana/dashboards/telegram_bots.json`
@@ -89,7 +89,7 @@
 5. `/docs/testing/VOICE_PHOTO_READY.md`
 6. `/docs/FINAL_INTEGRATION_SUMMARY.md`
 
-### Файли оновлені:
+### Файли оновлені
 1. `/telegram-gateway/app/telegram_listener.py`:
    - Додано `send_voice()` метод (+40 рядків)
    - Додано handlers для voice, document, photo
@@ -129,7 +129,7 @@
 3. (Поки що заглушка - чекаємо multimodal LLM)
 
 ### Моніторинг 📊
-1. Відкрити http://144.76.224.179:3000
+1. Відкрити [http://144.76.224.179:3000](http://144.76.224.179:3000)
 2. Login: admin / admin
 3. Вибрати Dashboard:
    - "DAARION Services Overview" - загальний моніторинг
@@ -139,21 +139,21 @@
 
 ## 🐛 Відомі обмеження
 
-### Vision Encoder:
+### Vision Encoder
 - ⚠️ Поточний Vision Encoder робить тільки **embeddings** (векторизацію)
 - ⚠️ Для опису зображень потрібен **multimodal LLM** (GPT-4V, Claude Vision, LLaVA)
 - 💡 **Рішення**: Інтегрувати OpenAI GPT-4V або Claude 3 Vision API
 
-### Parser Service:
+### Parser Service
 - ⚠️ Обмеження на розмір PDF (зазвичай < 50 MB)
 - ⚠️ Для дуже великих документів потрібен chunking
 
-### TTS:
+### TTS
 - ⚠️ Відповіді обмежені до 500 символів (gTTS обмеження)
 - ⚠️ Для довших відповідей треба streaming TTS або chunking
 - 💡 **Рішення**: Додати більш потужний TTS (Coqui TTS, ElevenLabs API)
 
-### Grafana:
+### Grafana
 - ⚠️ Деякі метрики можуть бути порожні якщо endpoints ще не викликалися
 - ⚠️ `/metrics` endpoint відсутній в деяких сервісах (STT, TTS, Parser)
 
@@ -161,35 +161,35 @@
 
 ## 🎯 Наступні кроки (опційно)
 
-### Priority 🔴 HIGH:
-1. **Multimodal LLM для Vision**:
+### Priority 🔴 HIGH
+1. **Multimodal LLM для Vision**
    - Інтегрувати GPT-4V або Claude 3 Vision
    - Додати endpoint `/analyze` в vision service
    - Тестування з різними типами зображень
 
-2. **Додати /metrics до всіх сервісів**:
+2. **Додати /metrics до всіх сервісів**
    - STT: додати prometheus_client
    - TTS: додати prometheus_client
    - Parser: додати prometheus_client
 
-### Priority 🟡 MEDIUM:
-3. **RAG Integration для документів**:
+### Priority 🟡 MEDIUM
+3. **RAG Integration для документів**
    - Інгест PDF в RAG після парсингу
    - Підтримка follow-up питань з контекстом
    - Зберігання історії документів
 
-4. **Streaming TTS**:
+4. **Streaming TTS**
    - Замінити gTTS на Coqui TTS або ElevenLabs
    - Підтримка довших відповідей
    - Кращ качість голосу
 
-### Priority 🟢 LOW:
-5. **Grafana Alerts**:
+### Priority 🟢 LOW
+5. **Grafana Alerts**
    - Налаштувати Alertmanager
    - Email/Telegram notifications
    - Custom alert rules
 
-6. **Extended Monitoring**:
+6. **Extended Monitoring**
    - Додати більше custom metrics
    - User analytics (кількість користувачів, активність)
    - LLM usage tracking (tokens, cost)
@@ -236,7 +236,7 @@
 
 ## 🏆 Підсумок
 
-### Що працює:
+### Що працює
 - ✅ Голосові повідомлення (STT) → Бот
 - ✅ Бот → Голосові відповіді (TTS)
 - ✅ PDF парсинг та Q&A
@@ -246,12 +246,12 @@
 - ✅ 3 боти (DAARWIZZ, Helion, GREENFOOD)
 - ✅ Автоматичне визначення reply_mode (voice/text)
 
-### Готовність:
+### Готовність
 - 🟢 **Production Ready**: Voice, TTS, Parser, Monitoring
 - 🟡 **Partial Ready**: Vision (потрібен multimodal LLM)
 - 🔴 **Not Ready**: RAG integration, Advanced alerts
 
-### Технічний стек:
+### Технічний стек
 - **Backend**: Python 3.11, FastAPI, asyncio, httpx
 - **Telegram**: aiogram 3.x, Local Telegram Bot API
 - **AI/ML**: Whisper (STT), gTTS (TTS), DotsOCR (Parser), DAGI Router
@@ -282,4 +282,3 @@
 *Автор: Assistant (via Cursor)*  
 *Версія: 1.0*  
 *Тривалість імплементації: ~2 години*
-