microdao-daarion/docs/DEPLOY_STRATEGY_MULTIMODAL_MVP.md

🚀 Deployment Strategy: MVP + Multimodal Integration

Версія: 1.0.0
Дата: 25 листопада 2025
Мета: Безпечна інтеграція MVP (Phase 1-3) та Multimodal системи

---

🎯 Стратегічний Підхід

Принцип: Decoupled Deployment

MVP та Multimodal — окремі системи, які інтегруються поступово.

PHASE 1: MVP Deploy (Phase 1-3) ✅ ЗАРАЗ
  ├── Agents Service
  ├── City Service
  ├── Second Me
  └── MicroDAO Service

PHASE 2: Multimodal Preparation ⏳ НАСТУПНИЙ КРОК
  ├── Router v2.0 (multimodal support)
  ├── Telegram Gateway Enhanced
  └── API унификація

PHASE 3: Multimodal Deployment 🔮 ПОТІМ
  ├── STT Service
  ├── OCR Service
  ├── Web Search
  └── Vector DB

PHASE 4: Full Integration 🔮 ФІНАЛ
  └── MVP ↔ Multimodal ↔ DAGI Stack

---

📊 Поточна Ситуація

✅ Готово:

• MVP код (Phase 1-3) готовий на НОДА2
• Міграції БД 007-010 створені
• Docker Compose з MVP сервісами
• Multimodal сервіси працюють на НОДА2 (STT, OCR, Web Search, Vector DB)

⚠️ В процесі:

• Router v1.1.0 multimodal API (в доках, поки не deployed)
• Telegram Gateway Enhanced (в доках, поки не deployed)
• Multimodal документація завантажується

❓ Невідомо:

• Стан production БД на НОДА1
• Чи є конфлікти в існуючому Router/Gateway
• Повний обсяг змін в multimodal системі

---

🎯 Рекомендована Послідовність

ЗАРАЗ: Phase 1 — MVP Deploy (WITHOUT Multimodal)

Що робимо:

1. Deploy MVP сервісів (Agents, City, Second Me, MicroDAO) на НОДА1
2. Інтегрувати з існуючим Router/Gateway (без multimodal)
3. Перевірити що все працює стабільно
4. Моніторити 48 годин

Що НЕ робимо:

• ❌ Не чіпаємо Router (залишаємо поточну версію)
• ❌ Не змінюємо Telegram Gateway
• ❌ Не інтегруємо STT/OCR/Web Search
• ❌ Не переносимо multimodal сервіси на НОДА1

Переваги:

• ✅ Мінімальний ризик
• ✅ MVP працює незалежно
• ✅ Легко rollback
• ✅ Існуюча система не постраждає

Документація:

• DEPLOY_MVP_NODE1_COMPREHENSIVE_ANALYSIS.md (створено вище)

---

НАСТУПНИЙ КРОК: Phase 2 — Multimodal Preparation

Коли: Після успішного MVP deployment + 48 годин стабільності

Що робимо:

1. Аналіз multimodal документації (коли завантажиться)
2. Створення Router v2.0 з multimodal API
3. Створення unified API для STT/OCR/Web Search/Vector DB
4. Тестування на НОДА2 (dev environment)
5. Документування змін та API contracts

Що створюємо:

• services/router-v2/ (новий Router з multimodal)
• services/multimodal-gateway/ (unified API для всіх multimodal)
• docs/MULTIMODAL_API_SPEC.md (API специфікація)
• docs/ROUTER_V2_MIGRATION.md (план міграції)

Критерії готовності:

• Router v2.0 працює на НОДА2
• Multimodal Gateway працює на НОДА2
• Всі API тести пройдені
• Документація повна
• Rollback plan готовий

---

ПОТІМ: Phase 3 — Multimodal Deployment на НОДА1

Коли: Після Phase 2 + approval

Що робимо:

1. Deploy Router v2.0 на НОДА1 (side-by-side з v1.0)
2. Deploy Multimodal Gateway на НОДА1
3. Перенести multimodal сервіси з НОДА2 на НОДА1 (або залишити розподіленими)
4. Поступове переключення (canary deployment)
5. Моніторинг + rollback готовність

Етапи переключення:

1. 10% трафіку → Router v2.0 (1 година)
2. 50% трафіку → Router v2.0 (6 годин)
3. 100% трафіку → Router v2.0 (24 години)
4. Видалити Router v1.0 (якщо стабільно)

Rollback:

• Переключити трафік назад на Router v1.0
• Зупинити multimodal сервіси
• Система повертається до Phase 1 стану

---

ФІНАЛ: Phase 4 — Full Integration

Коли: Після Phase 3 + 1 тиждень стабільності

Що робимо:

1. Інтегрувати MVP ↔ Multimodal:

   • City Service → Web Search (для пошуку в кімнатах)
   • Agents Service → STT/OCR (для voice/image commands)
   • Second Me → Vector DB (для semantic memory)

2. Telegram Gateway Enhanced:

   • Voice messages → STT → Agents
   • Photos → OCR/Vision → Agents
   • Documents → Parser → Knowledge Base

3. Frontend Enhancement:

   • Upload voice → STT
   • Upload image → OCR/Vision
   • Semantic search в City

Acceptance Criteria:

• Telegram bot приймає voice/photo/documents
• Frontend має multimodal UI
• City має semantic search
• Second Me використовує Vector DB
• All services stable 99.9% uptime

---

🔍 Dependency Analysis

MVP → Multimodal Dependencies

Agents Service:

• Потребує: LLM Proxy (існуючий), NATS (існуючий)
• Може використати: STT (опційно), OCR (опційно), Vector DB (опційно)
• Блокер: Немає

City Service:

• Потребує: PostgreSQL (існуючий), Redis (існуючий), NATS (існуючий)
• Може використати: Web Search (опційно для пошуку), Vector DB (опційно)
• Блокер: Немає

Second Me:

• Потребує: Agents Service (буде deployed), PostgreSQL
• Може використати: Vector DB (для довгої пам'яті)
• Блокер: Agents Service (тому Second Me в Phase 3)

MicroDAO Service:

• Потребує: PostgreSQL, Auth Service (існуючий)
• Може використати: DAO Service (існуючий, опційно)
• Блокер: Немає

Multimodal → Infrastructure Dependencies

Router v2.0:

• Потребує: Multimodal Gateway, LLM Proxy, існуючий Router v1.0 (для fallback)
• Блокер: Multimodal Gateway має бути готовий

Telegram Gateway Enhanced:

• Потребує: Router v2.0, STT Service, OCR Service
• Блокер: Router v2.0

STT/OCR/Web Search/Vector DB:

• Потребує: Тільки базову інфраструктуру (Docker, Network)
• Блокер: Немає (можуть працювати автономно)

---

🚨 Risk Matrix

Risk	Probability	Impact	Mitigation
MVP deployment breaks existing DAGI	Low	High	Staged deployment, health checks, rollback
DB migrations fail	Medium	High	Backup before, test on staging, rollback SQL
Router v2.0 не сумісний з v1.0	Medium	Medium	Side-by-side deployment, gradual switch
Multimodal сервіси споживають багато ресурсів	High	Medium	Start on NODE2, monitor, scale on NODE1
Nginx config помилка	Low	High	Test config, backup old, gradual reload
Network issues між NODE1 ↔ NODE2	Medium	Low	Fallback to local, health checks

---

📈 Monitoring Strategy

Key Metrics (для кожної Phase)

Phase 1 (MVP):

- http_requests_total{service="agents"}
- http_requests_total{service="city"}
- active_connections{service="city"}
- db_connections{service="agents"}
- websocket_connections{service="city"}

Phase 3 (Multimodal):

- multimodal_requests_total{type="stt"}
- multimodal_requests_total{type="ocr"}
- multimodal_latency_seconds{type="web_search"}
- router_v2_requests_total
- router_v2_fallback_total (до v1.0)

Alerts:

- name: MVP Services Down
  expr: up{service=~"agents|city|secondme"} == 0
  duration: 2m

- name: High Latency
  expr: http_request_duration_seconds{quantile="0.95"} > 5
  duration: 5m

- name: Router Fallback Rate High
  expr: rate(router_v2_fallback_total[5m]) > 0.1
  duration: 5m

---

🎯 Decision Points

Після Phase 1 (MVP Deploy):

Питання: Чи готові до Phase 2?

Критерії:

• MVP сервіси healthy 48 годин без перерв
• Немає критичних помилок в логах
• Existing DAGI Stack працює стабільно
• Performance metrics в нормі
• Multimodal документація повністю завантажена

Якщо НІ → зупинитися, debugати, стабілізувати

---

Після Phase 2 (Multimodal Prep):

Питання: Чи готові deploy multimodal на production?

Критерії:

• Router v2.0 протестований на NODE2
• API contracts задокументовані
• Performance тести пройдені
• Rollback plan готовий
• Team готова до deployment

Якщо НІ → продовжити тестування на NODE2

---

Після Phase 3 (Multimodal Deploy):

Питання: Чи готові до Full Integration?

Критерії:

• Multimodal сервіси stable 1 тиждень
• Router v2.0 обробляє 100% без fallback
• Resource usage прийнятний
• No regressions в MVP або DAGI

Якщо НІ → optimize, tune, monitor

---

📝 Execution Plan Summary

ЦЯ НЕДІЛЯ (Week 48):

• ✅ MVP Deploy на НОДА1 (Phase 1)
• ✅ Smoke tests
• 📊 Monitor 48 годин

НАСТУПНИЙ ТИЖДЕНЬ (Week 49):

• 📖 Аналіз multimodal документації (коли завантажиться)
• 🔧 Створення Router v2.0 (Phase 2)
• 🧪 Тестування на НОДА2

ТИЖДЕНЬ 50:

• 🚀 Multimodal Deploy на НОДА1 (Phase 3)
• 📊 Canary deployment (10% → 50% → 100%)

ТИЖДЕНЬ 51-52:

• 🔗 Full Integration (Phase 4)
• 📈 Performance tuning
• 📝 Documentation updates

---

✅ Success Criteria (Загальні)

MVP+Multimodal вважається успішно deployed якщо:

1. ✅ Всі MVP сервіси працюють стабільно
2. ✅ Multimodal сервіси інтегровані
3. ✅ Router v2.0 обробляє всі типи запитів
4. ✅ Telegram bot приймає voice/photo/text
5. ✅ Frontend має multimodal UI
6. ✅ Uptime > 99.5% за останні 7 днів
7. ✅ Немає критичних issues
8. ✅ Performance metrics в SLA
9. ✅ Документація актуальна
10. ✅ Team може підтримувати систему

---

🔮 Long-term Vision

Q1 2026: Distributed Architecture

• NODE1 (Production) — MVP + Multimodal
• NODE2 (Dev + AI Lab) — Experimental models
• NODE3 (Federation) — Matrix + City Federation

Q2 2026: Auto-scaling

• Kubernetes deployment
• Horizontal Pod Autoscaling
• Multi-region (EU + US)

Q3 2026: Advanced AI

• Multi-agent orchestration
• Chain-of-thought reasoning
• Long-term memory (Vector DB clusters)

---

Документ створено: Cursor AI Assistant
Для проєкту: MicroDAO DAARION
Останнє оновлення: 2025-11-25
Статус: Ready for Execution — Phase 1 (MVP Deploy)