6bd769ef40
- Add migration 013_city_map_coordinates.sql with map coordinates, zones, and agents table - Add /city/map API endpoint in city-service - Add /city/agents and /city/agents/online endpoints - Extend presence aggregator to include agents[] in snapshot - Add AgentsSource for fetching agent data from DB - Create CityMap component with interactive room tiles - Add useCityMap hook for fetching map data - Update useGlobalPresence to include agents - Add map/list view toggle on /city page - Add agent badges to room cards and map tiles
260 lines
6.2 KiB
Markdown
260 lines
6.2 KiB
Markdown
# 🌌 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
|
||
|
||
```bash
|
||
# З кореня проєкту
|
||
./scripts/start-city-space-services.sh
|
||
```
|
||
|
||
### Локально (Development)
|
||
|
||
```bash
|
||
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]`
|
||
|
||
```json
|
||
[
|
||
{
|
||
"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]`
|
||
|
||
```json
|
||
[
|
||
{
|
||
"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]`
|
||
|
||
```json
|
||
[
|
||
{
|
||
"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
|
||
|
||
```bash
|
||
# 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
|
||
```
|
||
|
||
---
|
||
|
||
## 🧪 Тестування
|
||
|
||
```bash
|
||
# 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 ✅
|
||
- [x] FastAPI application
|
||
- [x] Mock planets/nodes/events
|
||
- [x] OpenAPI documentation
|
||
- [x] 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
|
||
|
||
|
||
|
||
|
||
|