microdao-daarion/MVP_DEPLOY_PACKAGE_READY.md

🚀 MVP DEPLOYMENT PACKAGE — READY TO DEPLOY!

Дата: 25 листопада 2025
Статус: ✅ READY FOR EXECUTION
Target: NODE1 (144.76.224.179)

---

📦 Що створено:

1. Deployment Script ⭐

scripts/deploy-mvp-node1.sh

Автоматизований deployment з 7 фазами:

• Phase 0: Pre-flight checks (git status, push)
• Phase 1: Backup PostgreSQL
• Phase 2: Sync code from GitHub
• Phase 3: Apply migrations (007, 008, 010)
• Phase 4: Build Docker images
• Phase 5: Start services
• Phase 6: Health checks
• Phase 7: Summary

Використання:

cd /Users/apple/github-projects/microdao-daarion
./scripts/deploy-mvp-node1.sh

---

2. Rollback Script 🔄

scripts/rollback-mvp-node1.sh

Швидкий rollback якщо щось пішло не так:

• Зупиняє MVP сервіси
• Видаляє контейнери
• Опційно відновлює backup БД

Використання:

./scripts/rollback-mvp-node1.sh

---

3. Nginx Configuration 🌐

nginx/mvp-routes.conf

Ready-to-use Nginx routes для:

• /api/city/ → City Service (7001)
• /ws/city/ → City WebSocket
• /api/secondme/ → Second Me (7003)
• /api/agents/ → Agents Service (7014)
• /ws/agents/ → Agents WebSocket
• /api/microdao/ → MicroDAO Service (7015)

Manual installation (на NODE1):

# 1. Backup existing config
sudo cp /etc/nginx/sites-available/daarion /etc/nginx/sites-available/daarion.backup.$(date +%Y%m%d_%H%M%S)

# 2. Add routes from nginx/mvp-routes.conf to your Nginx config

# 3. Test and reload
sudo nginx -t
sudo systemctl reload nginx

---

4. Service Specifications 📄

docs/services/

• AGENTS_SERVICE_SPEC.md (7014)
• CITY_SERVICE_SPEC.md (7001)
• SECONDME_SERVICE_SPEC.md (7003)
• MICRODAO_SERVICE_SPEC.md (7015)

---

🎯 Фінальні Порти (РЕАЛЬНІ з коду):

Service	Port	Health Check	Notes
City	7001	/health	Public Rooms, Presence, WebSocket
Second Me	7003	/health	Personal AI assistant
Agents	7014	/health	Agent Core, invoke/reply
MicroDAO	7015	/health	Governance, proposals, voting

⚠️ Note: Порти відрізняються від початкових специфікацій! Використовуємо реальні порти з коду.

---

✅ Pre-Deployment Checklist:

На NODE2 (MacBook):

• Всі зміни committed і pushed до GitHub
• scripts/deploy-mvp-node1.sh має executable права
• scripts/rollback-mvp-node1.sh має executable права

На NODE1 (перевірити перед deployment):

• PostgreSQL працює (port 5432)
• NATS працює (port 4222)
• Redis працює (port 6379)
• Є вільне місце (docker images ~2GB)
• Nginx працює і доступний

---

🚀 DEPLOYMENT PROCEDURE:

Варіант A: Automatic (Рекомендовано)

# На NODE2 (MacBook)
cd /Users/apple/github-projects/microdao-daarion

# Commit changes (if any)
git add .
git commit -m "MVP Phase 1-3: Ready for deployment"
git push origin main

# Run deployment script
./scripts/deploy-mvp-node1.sh

Тривалість: ~10-15 хвилин

Що робить:

• ✅ Автоматичний backup БД
• ✅ Sync коду з GitHub
• ✅ Міграції БД
• ✅ Build Docker images
• ✅ Start сервісів
• ✅ Health checks

---

Варіант B: Manual (Step-by-step)

Якщо хочеш повний контроль:

1. На NODE2: Commit & Push

git add .
git commit -m "MVP Phase 1-3: Ready for deployment"
git push origin main

2. SSH на NODE1

ssh root@144.76.224.179
cd /opt/microdao-daarion

3. Backup БД

mkdir -p /root/backups
docker exec daarion-postgres pg_dump -U postgres daarion > \
  /root/backups/daarion_$(date +%Y%m%d_%H%M%S).sql

4. Sync Code

git pull origin main

5. Міграції

docker exec -i daarion-postgres psql -U postgres -d daarion < migrations/007_create_agents_tables.sql
docker exec -i daarion-postgres psql -U postgres -d daarion < migrations/008_create_microdao_core.sql
docker exec -i daarion-postgres psql -U postgres -d daarion < migrations/010_create_city_backend.sql

6. Build Images

docker build -t daarion-agents-service:latest ./services/agents-service
docker build -t daarion-city-service:latest ./services/city-service
docker build -t daarion-secondme-service:latest ./services/secondme-service
docker build -t daarion-microdao-service:latest ./services/microdao-service

7. Start Services

# Create docker-compose.mvp.yml (script creates it automatically)
docker compose -f docker-compose.mvp.yml up -d

8. Health Checks

curl http://localhost:7001/health  # City
curl http://localhost:7003/health  # Second Me
curl http://localhost:7014/health  # Agents
curl http://localhost:7015/health  # MicroDAO

9. Update Nginx

# Add routes from nginx/mvp-routes.conf
sudo vim /etc/nginx/sites-available/daarion
sudo nginx -t
sudo systemctl reload nginx

---

🧪 SMOKE TESTS:

# На NODE1 (або локально через SSH tunnel)

# 1. City Service
curl https://gateway.daarion.city/api/city/health
curl https://gateway.daarion.city/api/city/rooms

# 2. Second Me
curl https://gateway.daarion.city/api/secondme/health

# 3. Agents Service
curl https://gateway.daarion.city/api/agents/health
curl https://gateway.daarion.city/api/agents/registry

# 4. MicroDAO Service
curl https://gateway.daarion.city/api/microdao/health
curl https://gateway.daarion.city/api/microdao/

# 5. WebSocket (через wscat або websocat)
wscat -c wss://gateway.daarion.city/ws/city/rooms/general

---

📊 MONITORING:

Logs:

# На NODE1
docker logs -f daarion-city-service
docker logs -f daarion-agents-service
docker logs -f daarion-secondme-service
docker logs -f daarion-microdao-service

# All together
docker compose -f docker-compose.mvp.yml logs -f

Resource Usage:

docker stats --no-stream | grep daarion

Service Status:

docker ps | grep -E "agents|city|secondme|microdao"

---

🚨 ROLLBACK:

Якщо щось пішло не так:

# Automatic
./scripts/rollback-mvp-node1.sh

# Manual
ssh root@144.76.224.179
cd /opt/microdao-daarion
docker compose -f docker-compose.mvp.yml down
docker rm -f daarion-agents-service daarion-city-service daarion-secondme-service daarion-microdao-service

# Restore DB (if needed)
docker exec -i daarion-postgres psql -U postgres -d daarion < /root/backups/daarion_YYYYMMDD_HHMMSS.sql

---

⚠️ ВІДОМІ ОБМЕЖЕННЯ:

1. City Service - PostGIS

Міграція 010_create_city_backend.sql НЕ містить regions/areas таблиць з GEOMETRY.

• Поки що City працює без геопросторових функцій
• Living Map працює з простими JSON координатами
• PostGIS буде додано в Phase 2

2. Second Me - Vector DB

Код Second Me НЕ інтегрований з Vector DB (port 8898).

• Поки що працює без довгострокової пам'яті
• Тільки short-term memory в PostgreSQL
• Vector DB інтеграція - Phase 2

3. Config Files

Сервіси очікують config files:

• configs/AGENT_REGISTRY.yaml
• configs/team_definition.yaml
• configs/project_bus_config.yaml

Якщо їх немає — сервіси працюють з defaults.

4. Multimodal

Multimodal сервіси (STT, OCR, Web Search, Geo-agent) — Phase 2. MVP працює без них.

---

✅ SUCCESS CRITERIA:

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

1. ✅ Всі 4 сервіси запущені (docker ps)
2. ✅ Health checks повертають 200 OK
3. ✅ City Rooms API повертає список кімнат
4. ✅ Agents API повертає registry
5. ✅ Nginx routes працюють (публічні endpoints)
6. ✅ WebSocket з'єднання встановлюються
7. ✅ Немає критичних помилок в логах (перші 15 хв)
8. ✅ Існуючі DAGI сервіси працюють стабільно

---

📞 NEXT STEPS (після deployment):

Phase 2: Multimodal Integration

• Router v2.0 з multimodal API
• STT/OCR/Web Search/Vector DB на NODE1
• Geo-agent для City Service

Phase 3: Production Hardening

• Monitoring dashboards (Grafana)
• Alerting (Prometheus)
• Log aggregation (Loki)
• Performance tuning

Phase 4: Matrix Integration

• Matrix Synapse deployment
• Element Web client
• NATS ↔ Matrix bridge

---

🎉 READY TO GO!

Все готово для deployment!

Запуск:

cd /Users/apple/github-projects/microdao-daarion
./scripts/deploy-mvp-node1.sh

Нехай щастить! 🚀

---

Створено: Cursor AI Assistant
Проєкт: MicroDAO DAARION
Версія: MVP Phase 1-3
Дата: 2025-11-25