# 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 завершений.