microdao-daarion/services/space-service

🌌 DAARION Space Service

Версія: 1.0.0
Статус: Development (Mock Data)
Порт: 7002

---

📋 Опис

Space Service — це агрегатор даних для Space Dashboard в екосистемі DAARION. Відповідає за космічний шар візуалізації (planets, nodes, events).

Функціонал

• 🪐 Space Planets — DAO-планети з метриками
• 🖥️ Space Nodes — детальні метрики нод
• 📡 Space Events — події космічного рівня
• 🔭 Anomaly Detection — виявлення аномалій
• 🌠 Governance Temperature — активність управління

---

🚀 Швидкий старт

Через Docker Compose

# З кореня проєкту
./scripts/start-city-space-services.sh

Локально (Development)

cd services/space-service

# Створити віртуальне середовище
python -m venv venv
source venv/bin/activate

# Встановити залежності
pip install -r requirements.txt

# Запустити сервіс
python main.py

---

📡 API Endpoints

GET /health

Health check endpoint

---

GET /space/planets

Повертає DAO-планети у космічному шарі

Response: List[SpacePlanet]

[
  {
    "dao_id": "dao:3",
    "name": "Aurora Circle",
    "health": "good",
    "treasury": 513200,
    "activity": 0.84,
    "governance_temperature": 72,
    "anomaly_score": 0.04,
    "position": { "x": 120, "y": 40, "z": -300 },
    "node_count": 12,
    "satellites": [...]
  }
]

---

GET /space/nodes

Повертає детальні метрики усіх нод

Response: List[SpaceNode]

[
  {
    "node_id": "node:03",
    "name": "Quantum Relay",
    "microdao": "microdao:7",
    "gpu": {
      "load": 0.72,
      "vram_used": 30.1,
      "vram_total": 40.0,
      "temperature": 71
    },
    "cpu": { "load": 0.44, "temperature": 62 },
    "memory": { "used": 11.2, "total": 32.0 },
    "network": {
      "latency": 12,
      "bandwidth_in": 540,
      "bandwidth_out": 430,
      "packet_loss": 0.01
    },
    "agents": 14,
    "status": "healthy"
  }
]

---

GET /space/events

Поточні Space/DAO/Node події

Query Parameters:

• seconds (optional): Time window in seconds (default: 120)

Response: List[SpaceEvent]

[
  {
    "type": "dao.vote.opened",
    "dao_id": "dao:3",
    "timestamp": 1735680041,
    "severity": "info",
    "meta": {
      "proposal_id": "P-173",
      "title": "Budget Allocation 2025"
    }
  }
]

---

🗺️ Схема агрегації даних

┌─────────────────────────────────────────────────────────┐
│                   Space Service                         │
│                  (Port: 7002)                           │
└─────────────────────────────────────────────────────────┘
                         │
         ┌───────────────┼───────────────┐
         │               │               │
         ▼               ▼               ▼
┌─────────────┐  ┌─────────────┐  ┌──────────────┐
│  microDAO   │  │ Node        │  │   Agent      │
│  Service    │  │ Metrics     │  │   Registry   │
└─────────────┘  └─────────────┘  └──────────────┘
                        │
         ┌──────────────┴──────────────┐
         │                             │
         ▼                             ▼
┌──────────────┐             ┌──────────────┐
│ NATS         │             │ Redis /      │
│ JetStream    │             │ Timescale    │
└──────────────┘             └──────────────┘

---

📊 Джерела даних

Endpoint	Джерела	NATS Subject
/planets	microDAO service + Node metrics	dao.state.*
/nodes	NodeMetrics Agent → NATS	node.metrics.*
/events	JetStream Stream	events.space.*

---

🔧 Конфігурація

Environment Variables

# Service
LOG_LEVEL=INFO
ENVIRONMENT=development

# Redis
REDIS_URL=redis://redis:6379

# NATS
NATS_URL=nats://nats:4222

# CORS
CORS_ORIGINS=http://localhost:8899,https://daarion.city

---

🧪 Тестування

# Health check
curl http://localhost:7002/health

# Get planets
curl http://localhost:7002/space/planets

# Get nodes
curl http://localhost:7002/space/nodes

# Get events (last 60 seconds)
curl "http://localhost:7002/space/events?seconds=60"

# Через API Gateway
curl http://localhost:8080/space/planets

---

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

• OpenAPI Docs: http://localhost:7002/docs
• ReDoc: http://localhost:7002/redoc

---

🗺️ Roadmap

Phase 1: Mock Data ✅

• FastAPI application
• Mock planets/nodes/events
• OpenAPI documentation
• Docker setup

Phase 2: Real Data Integration (Current)

• NATS client integration
• Redis client for metrics
• Real-time node metrics
• DAO state integration
• Event stream from JetStream

Phase 3: Advanced Features

• Anomaly detection algorithm
• Governance temperature calculation
• Predictive analytics
• WebSocket support

---

📄 License

Proprietary — DAARION Ecosystem