docs: add ENERGYUNION District Protocol + Nodes Interface Architecture UPDATE
- ENERGYUNION: DePIN/Energy/Compute District with Helion & Energia agents - Nodes UPDATE: Unified node model (physical object + local brain + DAIS agent) - No auto-created nodes - all nodes registered dynamically
This commit is contained in:
Apple
285
docs/foundation/ENERGYUNION_District_Protocol_v1.md
Normal file
285
docs/foundation/ENERGYUNION_District_Protocol_v1.md
Normal file
@@ -0,0 +1,285 @@
|
||||
# ENERGY UNION — DISTRICT PROTOCOL v1
|
||||
|
||||
DePIN • Energy Grid • Compute Grid • AI District of DAARION.city
|
||||
Version: 1.1
|
||||
Status: Active
|
||||
Lead Agent: Helion
|
||||
Energy Agent: Energia
|
||||
|
||||
---
|
||||
|
||||
# 1. МЕТА ТА МІСІЯ
|
||||
|
||||
Energy Union — це інженерно-науковий District у DAARION.city, який об'єднує:
|
||||
|
||||
- децентралізовані енергетичні об'єкти (зелена генерація),
|
||||
- децентралізовані обчислювальні модулі,
|
||||
- автономні AI-лабораторії,
|
||||
- climate-positive інфраструктуру.
|
||||
|
||||
Місія District:
|
||||
|
||||
- створення відновлюваної енергетично-обчислювальної мережі,
|
||||
- підтримка наукових AI-комп'ютинг-процесів,
|
||||
- формування DePIN-економіки участі,
|
||||
- забезпечення міста DAARION багаторівневими ресурсами.
|
||||
|
||||
---
|
||||
|
||||
# 2. МОДЕЛЬ ПЛАТФОРМИ (DePIN + Energy + Compute)
|
||||
|
||||
## 2.1. Компоненти District
|
||||
|
||||
- **Energy Grid Layer**
|
||||
Зелена генерація (BioMiner та інші установки), датчики, телеметрія.
|
||||
|
||||
- **Compute Layer**
|
||||
Обчислювальні потужності різних учасників та AI-лабораторій.
|
||||
|
||||
- **DePIN Layer**
|
||||
Фізичні ресурси, що належать учасникам і реєструються децентралізовано.
|
||||
|
||||
- **AI Compute Layer**
|
||||
Три реальні лабораторії District:
|
||||
- PhysMath1.0 — фізика/математика;
|
||||
- Alatheia — аналіз знань;
|
||||
- DAARQode — інженерія моделей.
|
||||
|
||||
- **Resource Sharing Layer**
|
||||
Спільний доступ до енергетичних та обчислювальних ресурсів.
|
||||
|
||||
---
|
||||
|
||||
# 3. КЛЮЧОВІ СУБ'ЄКТИ
|
||||
|
||||
## 3.1 District Agents
|
||||
|
||||
### Helion (District Lead)
|
||||
|
||||
- маршрутизація запитів,
|
||||
- реєстрація нод,
|
||||
- контроль SLA та режимів.
|
||||
|
||||
### Energia (Energy Agent)
|
||||
|
||||
- обробка телеметрії від енергетичних вузлів,
|
||||
- аналітика потужностей,
|
||||
- координація енергетичних ресурсів.
|
||||
|
||||
## 3.2 Participants
|
||||
|
||||
- постачальники енергії (власники BioMiner або інших установок),
|
||||
- оператори обчислювальних модулів,
|
||||
- науково-дослідні групи,
|
||||
- сервісні агенти District,
|
||||
- користувачі AI-лабораторій.
|
||||
|
||||
---
|
||||
|
||||
# 4. ПРОДУКТИ ТА МОЖЛИВОСТІ DISTRICT
|
||||
|
||||
## 4.1 Energy Module
|
||||
|
||||
- облік енергії в одиницях **kWt**,
|
||||
- енергопрофілі,
|
||||
- telemetry stream від фізичних об'єктів.
|
||||
|
||||
## 4.2 Compute Module
|
||||
|
||||
- облік compute в одиницях **1T**,
|
||||
- запуск AI-процесів у PhysMath1.0, Alatheia, DAARQode.
|
||||
|
||||
## 4.3 Climate Module
|
||||
|
||||
- **carbon+** — одиниця кліматичної ефективності.
|
||||
|
||||
## 4.4 Node Participation Module
|
||||
|
||||
- реєстрація фізичних енергетичних/compute-об'єктів,
|
||||
- формування capability-профілю.
|
||||
|
||||
## 4.5 AI Operations Module
|
||||
|
||||
- планування обчислень,
|
||||
- маршрутизація AI-лабораторій,
|
||||
- аналіз навантаження.
|
||||
|
||||
---
|
||||
|
||||
# 5. DATA MODEL
|
||||
|
||||
| Entity | Опис |
|
||||
|--------|-------|
|
||||
| EnergyUnit | kWt одиниця енергії |
|
||||
| ComputeUnit | 1T одиниця обчислень |
|
||||
| CarbonUnit | climate-positive одиниця |
|
||||
| Provider | учасник, що надає ресурс |
|
||||
| Consumer | учасник, що отримує ресурс |
|
||||
| Session | взаємодія учасника з сервісом |
|
||||
| Allocation | виділення compute/energy |
|
||||
| Job | AI/compute процес |
|
||||
| ResourceProfile | потужності ноди |
|
||||
| TelemetryRecord | телеметрія з пристрою |
|
||||
| SLA | статус доступності |
|
||||
|
||||
---
|
||||
|
||||
# 6. НОДА У ENERGY UNION
|
||||
|
||||
**(Загальний принцип — без вигаданих ID чи назв)**
|
||||
|
||||
Нода в Energy Union =
|
||||
**фізичний об'єкт (енергетичний або обчислювальний) + локальний комп'ютер ("мозок") + DAIS-агент + запис у таблиці `nodes`**.
|
||||
|
||||
## 6.1. Типи нод
|
||||
|
||||
- `energy` — енергетична установка з IoT-датчиками;
|
||||
- `compute` — обчислювальна станція;
|
||||
- `hybrid` — енергія + compute в одному місці;
|
||||
- `iot_gateway` — шлюз сенсорів.
|
||||
|
||||
## 6.2. Capability-профілі
|
||||
|
||||
- для energy: `{ max_kWt, sensors[], telemetry_mode }`
|
||||
- для compute: `{ gpu_vram, cpu_cores, ram, storage }`
|
||||
|
||||
## 6.3. Правило реєстрації
|
||||
|
||||
> Нода з'являється в системі тільки після фактичного приєднання фізичного об'єкта через `/nodes/register`.
|
||||
|
||||
---
|
||||
|
||||
# 7. AI АГЕНТИ ENERGY UNION
|
||||
|
||||
## 7.1 AI Energy Scheduler
|
||||
|
||||
- оптимізація розподілу енергії,
|
||||
- обробка kWt-профілів.
|
||||
|
||||
## 7.2 AI Compute Allocator
|
||||
|
||||
- розподіл compute-потужностей 1T,
|
||||
- пріоритезація задач.
|
||||
|
||||
## 7.3 AI Load Balancer
|
||||
|
||||
- балансування навантажень,
|
||||
- контроль SLA.
|
||||
|
||||
## 7.4 AI Monitoring Agent
|
||||
|
||||
- контроль телеметрії,
|
||||
- anomaly detection.
|
||||
|
||||
## 7.5 AI Failure Recovery Agent
|
||||
|
||||
- реагування на інциденти,
|
||||
- пропозиції сценаріїв перемикання.
|
||||
|
||||
## 7.6 AI Lab Router
|
||||
|
||||
- маршрутизація задач PhysMath1.0, Alatheia, DAARQode.
|
||||
|
||||
---
|
||||
|
||||
# 8. GOVERNANCE
|
||||
|
||||
## 8.1 Повноваження Helion
|
||||
|
||||
- управління всіма District-процесами,
|
||||
- модерація Room Layer,
|
||||
- участь у рішенні City Governance.
|
||||
|
||||
## 8.2 Права учасників
|
||||
|
||||
- членство через DAIS identity,
|
||||
- доступ до District Rooms,
|
||||
- можливість запускати compute/AI задачі.
|
||||
|
||||
## 8.3 Revocation
|
||||
|
||||
- ноди/агенти можуть бути відключені при порушенні протоколів.
|
||||
|
||||
---
|
||||
|
||||
# 9. ROOM SYSTEM
|
||||
|
||||
- `energyunion-lobby`
|
||||
- `energyunion-news`
|
||||
- `energyunion-help`
|
||||
- `energyunion-telemetry`
|
||||
- `energyunion-compute`
|
||||
- `energyunion-labs`
|
||||
- `energyunion-providers`
|
||||
- `energyunion-governance`
|
||||
|
||||
---
|
||||
|
||||
# 10. DISTRICT MAP
|
||||
|
||||
Мапа містить **логічні зони** (без фізичних нод):
|
||||
|
||||
- Energy Zone
|
||||
- Compute Zone
|
||||
- Labs Zone
|
||||
- Providers Zone
|
||||
- Telemetry Zone
|
||||
- DAO Zone
|
||||
|
||||
Фізичні точки з'являються тільки після реальної реєстрації нод.
|
||||
|
||||
---
|
||||
|
||||
# 11. SECURITY & DAIS
|
||||
|
||||
- кожна нода має свій DAIS-агент,
|
||||
- всі операції підписуються DAIS-ключами,
|
||||
- повна історія в Audit Layer,
|
||||
- інциденти обробляються AI Recovery Agent.
|
||||
|
||||
---
|
||||
|
||||
# 12. CITY INTEGRATION
|
||||
|
||||
- портал у City Square,
|
||||
- публічні Rooms,
|
||||
- District-панель управління,
|
||||
- інтеграція з City Governance через Helion.
|
||||
|
||||
---
|
||||
|
||||
# 13. MVP SCOPE
|
||||
|
||||
## Входить до MVP:
|
||||
|
||||
- Реєстрація District ENERGYUNION
|
||||
- Portal у City Square
|
||||
- District Rooms (8 базових)
|
||||
- Helion Agent (базова логіка)
|
||||
- Energia Agent (телеметрія)
|
||||
- Energy Module (kWt облік)
|
||||
- Compute Module (1T облік)
|
||||
- Node Participation (реєстрація)
|
||||
|
||||
## Не входить до MVP:
|
||||
|
||||
- Повна AI-оптимізація енергії
|
||||
- ML-балансування навантажень
|
||||
- Carbon+ токеноміка
|
||||
- Автоматичний failover
|
||||
- Multi-lab orchestration
|
||||
|
||||
---
|
||||
|
||||
# 14. Cross-References
|
||||
|
||||
- **DAARION_Ontology_Core_v1.md** — базова онтологія
|
||||
- **District_Interface_Architecture_v1.md** — архітектура District UI
|
||||
- **Agent_Governance_Protocol_v1.md** — права та ролі агентів
|
||||
- **DAIS_Layer_Architecture_v1.md** — система ідентичності
|
||||
- **Nodes_Interface_Architecture_UPDATE_v1.md** — модель нод
|
||||
|
||||
---
|
||||
|
||||
**Document Status:** ✅ Ready for Implementation
|
||||
|
||||
Reference in New Issue
Block a user