7b91c8e83c
## Documentation (20 files) - DAARION Ontology Core v1 (Agent → MicroDAO → Node → District) - User Onboarding & Identity Layer (DAIS) - Data Model UPDATE, Event Catalog, Governance & Permissions - Rooms Layer, City/MicroDAO/Agents/Nodes Interface Architecture - Helper files: ontology-summary, lifecycles, event-schemas ## Database Migration (027) - DAIS tables: dais_identities, dais_emails, dais_wallets, dais_keys - agent_assignments table for Assignment Layer - rooms table for Rooms Layer - event_outbox for NATS event delivery - New enums: agent_role, microdao_type, node_kind, node_status, etc. - Updated agents, microdaos, nodes tables with ontology fields ## Backend - DAIS service & routes (/api/v1/dais/*) - Assignment service & routes (/api/v1/assignments/*) - Domain types for DAIS and Ontology ## Frontend - Ontology types (Agent, MicroDAO, Node, DAIS, Assignments) - API clients for DAIS and Assignments - UI components: DaisProfileCard, AssignmentsPanel, OntologyBadge Non-breaking update - all existing functionality preserved.
214 lines
7.1 KiB
Markdown
214 lines
7.1 KiB
Markdown
# Technical_Description_microdao_PATCH_Ontology.md
|
||
|
||
## Patch Update: DAARION Ontology, Agent Model, MicroDAO Rules, Node Structure
|
||
|
||
**Version:** 1.0
|
||
**Status:** Patch Addendum (Non-Breaking Update)
|
||
**Applies to:** Existing "Технічний опис microdao" документ
|
||
|
||
---
|
||
|
||
# 0. Мета патча
|
||
|
||
Цей документ додає нові архітектурні розділи та уточнення, які:
|
||
|
||
* узгоджують microDAO з повною онтологією DAARION.city,
|
||
* визначають інваріанти Agent/MicroDAO/Node,
|
||
* вводять механізм Assignment,
|
||
* уточнюють ролі та типи агентів,
|
||
* визначають, що District — не нова сутність, а режим MicroDAO,
|
||
* роблять архітектуру послідовною та розширюваною.
|
||
|
||
Патч нічого не ламає в існуючій логіці, лише додає розділи і правила.
|
||
|
||
---
|
||
|
||
# 1. Новий розділ: «Онтологія DAARION»
|
||
|
||
## 1.1. Ієрархія сутностей
|
||
|
||
Уся екосистема microdao існує в контексті онтології:
|
||
|
||
**Agent → MicroDAO → Node → District**
|
||
|
||
Інші об'єкти (канали, кімнати, governance, токени) належать цим сутностям.
|
||
|
||
## 1.2. Інваріанти онтології
|
||
|
||
* Кожен Agent належить до однієї MicroDAO.
|
||
* Кожна MicroDAO має одного primary Orchestrator-Agent.
|
||
* Кожна Node належить конкретній MicroDAO.
|
||
* District — це режим MicroDAO, а не окремий тип сутності.
|
||
* У системі не існує «сервісних», «віртуальних» або «нічийних» нод.
|
||
* Root MicroDAO (DAARION) — предок для всіх MicroDAO.
|
||
|
||
---
|
||
|
||
# 2. Новий розділ: «Agent Model (оновлений)»
|
||
|
||
## 2.1. Базові властивості Agent
|
||
|
||
* `agent_id`
|
||
* `dais_identity_id` (DAIS прив'язка)
|
||
* `home_microdao_id`
|
||
* `home_node_id`
|
||
* `role`: `regular` або `orchestrator`
|
||
* `service_scope` (нове поле; не обов'язкове)
|
||
|
||
## 2.2. Типи агентів
|
||
|
||
### A) Personal Agent
|
||
|
||
Агент конкретного користувача.
|
||
Приписаний до MicroDAO (за замовчанням — DAARION).
|
||
|
||
### B) Service/Infrastructure Agent
|
||
|
||
Агент, який забезпечує роботу сервісів міста.
|
||
Приписаний до MicroDAO, де він розміщений (частіше — DAARION).
|
||
Виконується на конкретних нодах.
|
||
|
||
### C) Core-City Agent (DAARION108)
|
||
|
||
108 агентів-експертів, що працюють для всього міста.
|
||
`service_scope = "city"`
|
||
|
||
### D) Orchestrator Agent
|
||
|
||
Агент, що має право створювати MicroDAO.
|
||
Перехід у Orchestrator створює подію: `agent.promoted_to_orchestrator`.
|
||
|
||
---
|
||
|
||
# 3. Новий розділ: «MicroDAO (оновлена модель)»
|
||
|
||
## 3.1. Структура
|
||
|
||
* `microdao_id`
|
||
* `type`: `root` | `standard` | `district`
|
||
* `primary_orchestrator_agent_id`
|
||
* `parent_microdao_id` (для district)
|
||
* `wallet_address`
|
||
* `metadata`
|
||
|
||
## 3.2. Інваріанти MicroDAO
|
||
|
||
* MicroDAO не може існувати без Orchestrator-Agent.
|
||
* `primary_orchestrator_agent_id` завжди існує і валідний.
|
||
* Root MicroDAO «DAARION» існує завжди.
|
||
* District = MicroDAO з розширеними правами.
|
||
* Усі ноди MicroDAO належать лише їй.
|
||
|
||
---
|
||
|
||
# 4. Новий розділ: «Node Model»
|
||
|
||
## 4.1. Структура ноди
|
||
|
||
* `node_id`
|
||
* `microdao_id`
|
||
* `node_kind`: `smartphone`, `laptop`, `edge`, `datacenter`, `iot`, `gpu-cluster`
|
||
* `capabilities` (json)
|
||
* `status`: `provisioning`, `active`, `draining`, `retired`
|
||
|
||
## 4.2. Інваріанти
|
||
|
||
* Нода завжди належить MicroDAO.
|
||
* Немає абстрактних/віртуальних нод.
|
||
* При реєстрації генерується подія `node.registered`.
|
||
|
||
---
|
||
|
||
# 5. Новий розділ: «District Model»
|
||
|
||
## 5.1. District = MicroDAO з type = district
|
||
|
||
Має розширені можливості:
|
||
|
||
* керування підлеглими MicroDAO,
|
||
* право мати власну мережу нод,
|
||
* роль «платформи» (галузь / район / екосистема).
|
||
|
||
## 5.2. Інваріанти District
|
||
|
||
* District не змінює власність нод MicroDAO.
|
||
* District — не новий тип сутності, не нова таблиця.
|
||
* Перехід MicroDAO → District фіксується подією `microdao.promoted_to_district`.
|
||
|
||
---
|
||
|
||
# 6. Новий розділ: «Assignment Layer (агенти, які працюють у різних MicroDAO)»
|
||
|
||
## 6.1. Призначення
|
||
|
||
Деякі агенти можуть:
|
||
|
||
* працювати у чужих MicroDAO,
|
||
* виконувати ролі у District,
|
||
* діяти від імені міста (DAARION108).
|
||
|
||
## 6.2. Структура сутності agent_assignment
|
||
|
||
```yaml
|
||
agent_assignment:
|
||
id: uuid
|
||
agent_id: string
|
||
target_microdao_id: string
|
||
scope: microdao | district | city
|
||
role: advisor | security | mentor | ops | core-team
|
||
start_ts: datetime
|
||
end_ts: datetime
|
||
```
|
||
|
||
## 6.3. Інваріанти Assignment
|
||
|
||
* Assignment не змінює перманентну приписку агента (`home_microdao_id`).
|
||
* Assignment є записом «тимчасової роботи/сервісу».
|
||
* DAARION108 мають `scope = city`.
|
||
|
||
---
|
||
|
||
# 7. Оновлення існуючих розділів документа microdao
|
||
|
||
Cursor при інтеграції повинен додати:
|
||
|
||
## 7.1. У розділ «Agents»
|
||
|
||
* поля: `home_microdao_id`, `home_node_id`, `service_scope`
|
||
* ролі: `regular`, `orchestrator`
|
||
* типи агентів (Personal, Service, Core-City)
|
||
|
||
## 7.2. У розділ «Teams/MicroDAO»
|
||
|
||
* обов'язкове поле `primary_orchestrator_agent_id`
|
||
* `type = root | standard | district`
|
||
* `parent_microdao_id`
|
||
* уточнення про DAARION (root)
|
||
|
||
## 7.3. У розділ «Nodes»
|
||
|
||
* додати інваріанти
|
||
* додати типи нод
|
||
* заборону абстрактних нод
|
||
|
||
## 7.4. У розділ «Governance»
|
||
|
||
* правило: MicroDAO створюється лише Orchestrator-Agent
|
||
* District — це не окрема таблиця
|
||
|
||
---
|
||
|
||
# 8. Підсумок патча
|
||
|
||
Після інтеграції цього патча:
|
||
|
||
* онтологія DAARION вплетена в microdao,
|
||
* всі сутності мають однакову семантику в документах та коді,
|
||
* нові типи агентів (service, core-city) офіційно описані,
|
||
* модель Assignment додана,
|
||
* MicroDAO, Node та District узгоджені з фундаментальним баченням,
|
||
* існуючі системи не змінюються, тільки розширюються.
|
||
|
||
Документ №3 завершений.
|
||
|