Files
microdao-daarion/docs/foundation/ENERGYUNION_District_Protocol_v1.md
Apple 6864e1ce22 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
2025-11-30 04:27:45 -08:00

286 lines
8.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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