chore: organize documentation structure for monorepo

- Create /docs structure (microdao, daarion, agents)
- Organize 61 cursor technical docs
- Add README files for each category
- Copy key documents to public categories
- Add GitHub setup instructions and scripts
This commit is contained in:
Apple
2025-11-15 04:08:35 -08:00
parent 5520665600
commit c552199eed
138 changed files with 39624 additions and 40 deletions

25
docs/daarion/README.md Normal file
View File

@@ -0,0 +1,25 @@
# DAARION.city — Документація
Ця папка містить документацію про DAARION.city: roadmap, governance, токеноміку міста, інтеграцію з MicroDAO.
## Структура
### Стратегія та roadmap
- `vision.md` — бачення DAARION.city
- `roadmap.md` — roadmap розвитку
- `governance.md` — система управління та governance
### Токеноміка
- `tokenomics.md` — токеноміка міста (DAAR, DAARION)
- `tokenomics-city.md` — детальна токеноміка (з `/docs/tokenomics/city-tokenomics.md`)
### Інтеграція
- `integration-microdao.md` — інтеграція з MicroDAO
- `platforms-catalog.md` — каталог платформ (GREENFOOD, EnergyUnion, WaterUnion)
## Посилання
- [MicroDAO документація](../microdao/README.md)
- [Агентська система](../agents/README.md)
- [Технічна документація](../cursor/README.md)

View File

@@ -0,0 +1,403 @@
# DAARION_city_integration.md
DAARION.city як суперDAO над microDAO та інтеграція існуючих платформ
Цей документ описує, як:
1. DAARION.city розглядається як **міське superDAO**, побудоване на тих самих механізмах, що й microDAO.
2. DAARION.city є **реєстром мешканців** та "над-організацією", яка об'єднує microDAO.
3. Існуючі проєкти (наприклад, **greenfood.live**, **EnergyUnion**) стають **розвиненими microDAO-платформами**, а не окремими всесвітами.
Документ задає архітектурну модель і конкретні задачі для Cursor.
---
## 1. Модель: DAARION.city = microDAO типу "city" + SuperDAO над іншими microDAO
### 1.1. Розширення `teams` / `microdaos`
Базова сутність одна — `team`/`microdao`, але з типами:
```ts
type TeamType = "city" | "platform" | "community" | "guild" | "lab" | "personal";
```
Приклади:
* `DAARION.city``type = "city"` (city-level superDAO)
* `GreenFood``type = "platform"` (eco/food marketplace)
* `EnergyUnion``type = "platform"` (BioMiner + AI + DAO екосистема)
* Приватні microDAO → `type = "community"` або `personal`.
### 1.2. Ієрархія "місто → платформи → мікроDAO"
Додаткова таблиця:
```ts
city_links:
- id
- parent_team_id // зазвичай DAARION.city team_id
- child_team_id // microDAO або платформа
- relation_type // "platform", "community", "guild", "adapter"
- created_at
```
Інтерпретація:
* `DAARION.city` як `parent_team_id` для:
* платформ (GreenFood, EnergyUnion, інші платформи),
* приватних microDAO, які бажають "приписатися" до міста.
---
## 2. Реєстр мешканців DAARION.city
DAARION.city — це також **місце реєстрації всіх мешканців**.
### 2.1. Модель користувача
```ts
users:
- id
- city_handle // унікальний нік у DAARION.city
- display_name
- avatar_url
- created_at
```
### 2.2. Громадянство (citizenship)
```ts
citizenships:
- id
- user_id
- city_id // team_id DAARION.city
- status: "active" | "pending" | "revoked"
- joined_at
```
### 2.3. Членство в microDAO / платформах
```ts
memberships:
- id
- user_id
- team_id // будь-який microDAO (включно з платформами)
- role: "admin" | "member" | "guest"
- joined_at
```
DAARION.city у цьому сенсі — просто `team` із `type="city"`, де всі громадяни мають запис `citizenship`, а членство в платформах і microDAO моделюється через `memberships`.
---
## 3. DAARION.city як суперDAO: city-level агенти
DAARION.city має власний набір **city-level agentів**, які працюють поверх міських даних і child-microDAO:
* **City Governance Agent** — міські правила, дух міста.
* **City Registry Agent** — реєстр мешканців, громадянство.
* **City Bridges Agent** — зв'язки між city ↔ платформи ↔ microDAO.
* **City Co-Memory Agent** — загальноміський простір знань.
Ці агенти використовують ті самі механізми, що й агенти microDAO, але їх `team_id` = `DAARION.city`.
---
## 4. Перетворення існуючих платформ на microDAO
Мета: платформи **greenfood.live** та **EnergyUnion** стають microDAO-платформами в структурі DAARION.city.
### 4.1. GreenFood як microDAO-платформа
Факти про платформу:
* GreenFood — еко-система для невеликих виробників та переробників органічної й домашньої продукції та вимогливих покупців.
* Підтримка блокчейн-технологій та внутрішня бартерна криптовалюта DAAR.
#### Кроки перетворення GreenFood → microDAO:
1. **Створити запис `team`**:
* `name = "GreenFood"`
* `type = "platform"`
* `slug = "greenfood"`
2. **Прив'язати до DAARION.city**:
* `city_links.insert(parent_team_id = daarion_city_id, child_team_id = greenfood_id, relation_type = "platform")`
3. **Задати blueprint GreenFood**:
* агентська конфігурація:
* Marketplace/Orders Agent,
* Producers & Buyers Agent,
* Eco/Quality Knowledge Agent,
* інтеграція з існуючим мобільним додатком / API (через Bridges Agent).
4. **Bridges / adapters**:
* Connector до існуючого GreenFood backend:
* products → проєкти/категорії/knowledge,
* orders → tasks / workflows,
* farmers → окремий тип учасників.
5. **DAAR-валюта як доступ**:
* трактувати DAAR-токени як внутрішні "ключі доступу/бартерні одиниці" у Governance/Access, а не як фінансові активи.
### 4.2. EnergyUnion як microDAO-платформа
Факти про платформу:
* ENERGY UNION BioMiner = платформа, що поєднує чисту енергію, AI та DAO в одній екосистемі.
* BioMiner конвертує біомасу в електроенергію для дата-центрів та AI-лабів, токени відкривають доступ до енергії (kWt), AI-обчислень (1T) та carbon+.
#### Кроки перетворення EnergyUnion → microDAO:
1. **Створити `team`**:
* `name = "EnergyUnion"`
* `type = "platform"`
* `slug = "energyunion"`
2. **Прив'язати до DAARION.city**:
* `city_links.insert(parent_team_id = daarion_city_id, child_team_id = energyunion_id, relation_type = "platform")`
3. **Blueprint EnergyUnion**:
* агенти:
* Energy Sites & BioMiner Agent (облік енергії, біомодулі),
* AI Power Agent (1T обчислення),
* kWt / 1T / carbon+ access-keys інтегровані в Governance & Access (як символьні ключі ресурсу, не як фінансові інструменти).
4. **Bridges / adapters**:
* Connector до energyunion.io / EnergyUnion.AI API:
* energy production → knowledge/events,
* access tokens → capability keys у microDAO,
* DAO-логіка → DAO Agent (коли знадобиться).
---
## 5. City-level Co-Memory: загальні знання міста
DAARION.city має власний **Co-Memory**, побудований на основі модуля 17.
### 5.1. City Knowledge Spaces
Приклади city-spaces:
* `City.Ecology`
* `City.Energy`
* `City.Food`
* `City.Governance`
Кожна платформа-microDAO може:
* публікувати обрані факти/документи в City Co-Memory:
* `publish_to_city_memory(team_id, space_id, fact_id/doc_id)`
* читати загальноміський контекст:
* `get_city_knowledge(space_id, query)`.
### 5.2. Політики відкритості
Локальний Governance Agent платформи:
* визначає, які дані:
* залишаються тільки в локальному Co-Memory,
* можуть підніматися на рівень міста.
---
## 6. City Bridges: обмін подіями між DAARION.city і microDAO
### 6.1. Формат `city_event`
Спільний формат подій:
```ts
city_event: {
id: string;
source_team_id: string; // хто ініціював (microDAO або платформа)
target_team_id?: string; // куди адресовано (optionally)
type: string; // "announcement", "project_update", "energy_event", "market_update", ...
payload: Json;
ts: string;
}
```
### 6.2. City Bridges Agent
Агент з `team_id = DAARION.city`:
* приймає `city_event` від microDAO,
* ретранслює (broadcast / специфічним платформам),
* взаємодіє з Attention Agent на міському рівні.
---
## 7. Governance: трирівнева модель правил
1. **City Governance (DAARION.city)**:
* загальні принципи,
* базові етичні стандарти,
* міські ритуали узгодження.
2. **Platform Governance** (GreenFood, EnergyUnion):
* правила конкретної платформи,
* локальні символічні ключі доступу.
3. **Local microDAO Governance**:
* правила конкретної спільноти/групи.
DAO Agent і Wallet Agent можуть зʼявитися пізніше на міському шарі; наразі достатньо моделювати правила як політики доступу й ритуали узгодження без необхідної on-chain реалізації.
---
## 8. UX-рівень: як користувач це відчуває
1. Користувач реєструється в DAARION.city → отримує:
* міське громадянство,
* city-profile.
2. У міському інтерфейсі:
* секція "Платформи":
* GreenFood, EnergyUnion, інші платформи → всі це microDAO типу `platform`;
* секція "Мої microDAO":
* приватні/ком'юніті DAO.
3. Клік по платформі (GreenFood / EnergyUnion):
* відкривається Agent Hub цієї платформи (як microDAO),
* зі своїми агентами, каналами, проєктами.
4. Зі свого приватного microDAO користувач може:
* "Підключитися до платформи GreenFood":
* створюється запис у `city_links` + налаштовуються Bridges + Governance/Access.
---
## 9. Задачі для Cursor (Implementation Plan)
### 9.1. Базова інтеграція DAARION.city як microDAO
1. Додати поле `type` у `teams`:
* `"city" | "platform" | "community" | "guild" | "lab" | "personal"`.
2. Створити запис для DAARION.city:
* `type = "city"`, `slug = "daarion"`.
3. Створити таблицю `city_links`:
* parent/child team, relation_type.
### 9.2. Реєстр мешканців
1. Створити таблиці:
* `citizenships` (user ↔ city),
* `memberships` (user ↔ team).
2. Додати city-profile в UI:
* список платформ-microDAO,
* список власних microDAO.
### 9.3. Інтеграція платформ GreenFood та EnergyUnion
1. Створити `team` для GreenFood та EnergyUnion з `type="platform"`.
2. Створити `city_links` із `parent_team_id = daarion_city_id`.
3. Додати базові Agent Hub / Agent Cards для цих платформ.
4. Створити Bridges stubs:
* `greenfood_connector_agent`,
* `energyunion_connector_agent`,
щоб пізніше інтегрувати їхні API (поки достатньо каркасу).
### 9.4. City Co-Memory та City Bridges
1. Створити city-level Knowledge Space (`City.Global`).
2. Додати API:
* `POST /city/knowledge/publish`,
* `POST /city/events`.
3. Реалізувати City Bridges Agent:
* мінімально — логування `city_event`ів.
---
## 10. Інструкція для Cursor
```text
Use DAARION_city_integration.md together with:
- 12_agent_runtime_core.md
- 14_messenger_agent_module.md
- 15_projects_agent_module.md
- 17_comemory_knowledge_space.md
- 18_governance_access_agent.md
- 20_integrations_bridges_agent.md
- 22_operator_modes_and_system_agents.md
- 23_domains_wallet_dao_deepdive.md
- 10_agent_ui_system.md
- 05_coding_standards.md
Goal:
Unify DAARION.city and all platforms as microDAO instances, with DAARION.city as a "city" type superDAO and GreenFood / EnergyUnion as "platform" type microDAO.
Implement in stages:
1) Team types + city_links hierarchy.
2) Citizen registry (citizenships, memberships).
3) DAARION.city as city-level microDAO with its own Agent Hub.
4) GreenFood and EnergyUnion as platform-type microDAO.
5) City Co-Memory and City Bridges minimal skeletons.
For each step:
- list changed files,
- show diff,
- provide a short summary.
```
---
**Готово.**
Це **повна архітектура інтеграції DAARION.city з microDAO**, включаючи конкретні кроки перетворення GreenFood та EnergyUnion.

View File

@@ -0,0 +1,397 @@
# DAARION.city Platforms Catalog (MicroDAO)
Каталог платформ екосистеми DAARION.city
Цей документ містить каталог платформ екосистеми **DAARION.city**, які інтегруються з microdao, DAGI та Gift-економікою міста:
- опис домену кожної платформи;
- основні агентські модулі;
- ключі доступу (access keys + capabilities);
- Embassy-інтеграція;
- мінімальні флоу для MVP.
Це **живий документ** — при додаванні нових платформ/районів додаються нові записи.
---
## 1. Мета документа
Каталог платформ екосистеми **DAARION.city**, які інтегруються з microdao, DAGI та Gift-економікою міста:
- опис домену кожної платформи;
- основні агентські модулі;
- ключі доступу (access keys + capabilities);
- Embassy-інтеграція;
- мінімальні флоу для MVP.
Це **живий документ** — при додаванні нових платформ/районів додаються нові записи.
---
## 2. Структура запису про платформу
Для кожної платформи описуємо:
- `code` — короткий код (латиницею);
- `name` — назва;
- `domain` — предметна область;
- `owner` — хто курує (team/microDAO);
- `status` — idea / design / MVP / pilot / prod;
- основні **агентські ролі**;
- типи **access keys** і capabilities;
- Embassy-флоу (якщо є RWA/енергія/зовнішні мережі).
---
## 3. Перелік платформ
1. **DAARION Core**
2. **DAARWIZZ**
3. **GREENFOOD**
4. **Energy Union**
5. **Water Union**
6. **Essence Stream**
(інші додаються в наступних версіях: Atlas, DAARWIZZ verticals тощо).
---
## 4. DAARION Core
- `code`: `daarion_core`
- `name`: DAARION Core / Місто Дарів
- `domain`: ядро міста, Second Me, резидентство, токеноміка DAAR/DAARION, MJD.
- `owner`: DAARION DAO Core Team
- `status`: pilot → prod
### 4.1 Агентські модулі
- **Second Me Agent** — персональний цифровий двійник резидента.
- **Citizenship Agent** — керує резидентством, рівнями доступу, DAARION-статусом.
- **Gift Fabric Agent** — відстежує акти взаємодії й відгук міста (MJD).
- **Governance Agent** — DAO-процеси, пропозиції, голосування, політики.
### 4.2 Access keys & capabilities
Приклади capability-груп:
- `citizenship.status.view`
- `citizenship.level.upgrade`
- `gift.act.register`
- `governance.proposal.create`
- `governance.vote.cast`
- `governance.policy.manage` (лише для Guardian/Owner/DAO-агентів)
Embassy-ключі DAARION Core обмежені:
- `embassy.intent.read`
- `embassy.aggregate.metrics`
---
## 5. DAARWIZZ
- `code`: `daarwizz`
- `name`: DAARWIZZ — маршрутизатор агентів / планувальник Swarm-OS
- `domain`: оркестрація DAGI, роутинг запитів, multi-agent сценарії.
- `owner`: DAARION R&D Lab
- `status`: MVP / pilot
### 5.1 Агентські модулі
- **Router Agent** — розподіляє запити між моделями та агентами.
- **Planner Agent** — декомпозує задачі, запускає ланцюжки інструментів.
- **Observer/Telemetry Agent** — відстежує якість, латентність, бюджет.
### 5.2 Access keys & capabilities
- `router.invoke`
- `router.plan.run`
- `router.tool.call`
- `telemetry.events.write`
- `telemetry.events.read:aggregate`
Користувацькі microDAO отримують DAARWIZZ-keys:
- або через Wallet Agent (оплата DAAR / 1T);
- або через план Platformium.
---
## 6. GREENFOOD
- `code`: `greenfood`
- `name`: GREENFOOD — AI-ERP для крафтових виробників та кооперативів
- `domain`: склади, партії, логістика, кооперативні ланцюги постачання.
- `owner`: GREENFOOD microDAO
- `status`: design / MVP
### 6.1 Агентські модулі
- **Warehouse Agent** — облік партій/залишків.
- **Logistics Agent** — маршрути та хаби.
- **Accounting Agent** — автоматичні нарахування/розподіл по кооперативу.
- **Sales Agent** — інтеграція з маркетплейсами.
- **Community Coordinator Agent** — координація між учасниками спільноти.
### 6.2 Access keys & capabilities
Ключі типу:
- `platform.greenfood.inventory.view/update`
- `platform.greenfood.shipment.create`
- `platform.greenfood.coop.balance.view`
- `platform.greenfood.member.register`
Для інтеграції з microdao:
- public API-ключі для:
- синхронізації задач Projects (`projects.task.sync`);
- Co-Memory (звіти, накладні);
- Embassy Key для RWA:
- `rwa.claim` (сертифікати продуктів);
- `rwa.stock.update` (запаси на складах).
---
## 7. Energy Union
- `code`: `energy_union`
- `name`: Energy Union — енергетична платформа з токенізованими активами
- `domain`: енергетичні RWA, KWT/1T виплати, енергетичний бартер.
- `owner`: Energy Union microDAO / партнерські енергокомпанії
- `status`: pilot
### 7.1 Агентські модулі
- **Metering Agent** — читає лічильники генерації/споживання.
- **Oracle Agent** — агрегує дані, формує виплати KWT/1T.
- **Facility Agent** — агент об'єкта (сонячна станція, дата-центр).
- **Energy Market Agent** — узгоджує акти енергетичного дарообміну.
### 7.2 Access keys & capabilities
- `energy.asset.read`
- `energy.meter.read`
- `energy.meter.update` (лише для trusted oracles)
- `energy.payout.compute`
- `wallet.payout.view/claim`
Embassy-ключі:
- `embassy.energy.update`
- `embassy.rwa.claim` (сертифікати енергетичних часток).
---
## 8. Water Union
- `code`: `water_union`
- `name`: Water Union — платформа для управління водними ресурсами
- `domain`: моніторинг води, RWA на основі водних активів/інфраструктури.
- `owner`: Water Union microDAO / місцеві громади
- `status`: idea / early design
### 8.1 Агентські модулі
- **Sensor Agent** — збір даних з сенсорів (якість/об'єм води).
- **Infrastructure Agent** — стан насосів, резервуарів.
- **Community Water Agent** — координація доступу громад, планування ремонтів.
- **Water RWA Agent** — сертифікати дару на водні ініціативи.
### 8.2 Access keys & capabilities
- `water.sensor.read`
- `water.sensor.update`
- `water.infrastructure.view`
- `rwa.water.claim`
Embassy:
- інтеграція з місцевими дата-центрами/IoT-шлюзами;
- прев'язка водних RWA до DAAR/DAARION через Gift Fabric.
---
## 9. Essence Stream
- `code`: `essence_stream`
- `name`: Essence Stream — платформа для культурних/освітніх ініціатив
- `domain`: курси, події, контент-стріми, творчі квести.
- `owner`: Essence Stream microDAO / культурні куратори
- `status`: idea / design
### 9.1 Агентські модулі
- **Curator Agent** — формує програми, добирає контент.
- **Event Agent** — події, квитки (як сертифікати дару).
- **Mentor Agent** — персоналізовані навчальні траєкторії.
- **Quest Agent** — квести/ігрові сценарії в DAARION.city.
### 9.2 Access keys & capabilities
- `essence.event.publish`
- `essence.event.register`
- `essence.course.view`
- `essence.quest.progress.update`
Embassy:
- RWA-сертифікати на участь у подіях (офлайн/онлайн);
- взаємодія з Gift Fabric для Міського Джерела Дарів.
---
## 10. Зв'язок платформ з microdao
### 10.1 Common pattern
Кожна платформа:
1. Має **свій microDAO** (team/ком'юніті) у microdao-месенджері.
2. Має набір **public channel(s)** для публічних оголошень/стрімів.
3. Використовує:
- Projects (проекти/ланцюги постачання/ініціативи),
- Co-Memory (документи, договори, технічні описи),
- приватних агентів (Router, Domain-агенти).
### 10.2 Типи інтеграцій
- **Embedded microdao**: платформа має вкладку «Community/Chat», що відкриває microdao-інтерфейс її microDAO.
- **API integration**: платформа викликає microdao API (`/projects`, `/tasks`, `/wallet`, `/governance`) з власними access keys.
- **Embassy**: для RWA/енергетики/сертифікатів дару використовується Embassy Module.
---
## 10. Подальший розвиток каталогу
Наступні версії документа:
- додаємо нові платформи (Atlas, DAARWIZZ вертикалі, інші city-райони);
- деталізуємо capability-матриці (по аналогії з RBAC-таблицями);
- додаємо mapping до конкретних onchain-контрактів (RWA, EnergyNFT, DAAR/DAARION).
---
## 11. Мапінг платформ на Data Model (таблиці)
1. Усі платформи (DAARION Core, DAARWIZZ, GREENFOOD, Energy Union, Water Union, Essence Stream):
- представлені як `teams`:
```sql
create table teams (
id text primary key, -- t_...
name text not null,
slug text unique not null,
mode text not null check (mode in ('public','confidential')),
created_at timestamptz not null default now()
);
```
- учасники платформ → `team_members`:
- роль (`Owner`, `Guardian`, `Member`);
- `viewer_type` (`reader`, `commenter`, `contributor`).
2. DAARION Core:
- працює поверх:
- `users`, `teams`, `team_members`,
- `channels`, `messages`, `followups`,
- `projects`, `tasks`, `docs`, `meetings`,
- `wallets`, `staking_ringk`, `payouts`,
- `proposals` (governance).
3. GREENFOOD:
- свій microDAO → одна або кілька сутностей `teams`;
- бізнес-процеси відображаються як:
- `projects` (кооперативні програми, постачання);
- `tasks` (відвантаження, контроль партій);
- RWA-складські залишки → через `rwa_inventory` (із подією `rwa.inventory.updated`).
4. Energy Union:
- об'єкти енергетики — як `projects`/`tasks` + RWA-записи в `rwa_inventory`;
- зв'язок із виплатами — через `staking_ringk` та `payouts`.
5. Water Union / Essence Stream:
- Water Union: сенсори/інфраструктура агрегуються як задачі/проєкти, а водні активи — RWA-записи;
- Essence Stream: події/курси — `projects` + `meetings`/`docs`, участь резидентів потрапляє в Gift Fabric через події.
---
## 12. Мапінг платформ на Event Catalog (topics)
1. DAARION Core:
- використовує базові topics з `topic.enum`:
- `"chat.message.created"`, `"chat.message.edited"`, `"chat.message.deleted"`
- `"followup.created"`, `"followup.updated"`
- `"project.created"`, `"task.created"`, `"task.updated"`
- `"agent.run.started"`, `"agent.run.completed"`
- `"staking.locked"`, `"payout.generated"`
- `"rwa.inventory.updated"`
- `"governance.proposal.created"`, `"vote.cast"`
- `"audit.event"`
2. GREENFOOD:
- доменні події інвентарю/замовлень мапляться на:
- `"rwa.inventory.updated"` (оновлення складів/партій);
- `"project.created"` / `"task.created"` для логістичних ланцюжків.
3. Energy Union:
- енергетичні вимірювання та оракули:
- `"oracle.reading.published"` — агреговані дані з лічильників;
- далі → `"staking.locked"` / `"payout.generated"` для KWT/1T.
4. Water Union:
- якість/об'єм води → `"oracle.reading.published"` з типом `water`;
- видані водні сертифікати → `"rwa.inventory.updated"`;
- надалі можуть генерувати `"payout.generated"`, якщо є пов'язаний токенізований потік.
5. Essence Stream:
- участь у подіях/квестах платформи підписується як:
- `"reward.issued"` (Gift Fabric),
- `"audit.event"` для важливих соціальних/освітніх актів.
---
## 13. Завдання для Cursor
```text
You are a senior full-stack engineer. Implement platform integration patterns using:
- DAARION_city_platforms_catalog.md
- 24_access_keys_capabilities_system.md
- DAARION_city_integration.md
- 05_coding_standards.md
Tasks:
1) Create platform registry in database (platforms table).
2) Implement platform-specific capability bundles.
3) Create Embassy Module integration for RWA platforms (Energy Union, GREENFOOD).
4) Add platform switcher UI in microDAO interface.
5) Implement platform-specific agent modules (stub for MVP).
Output:
- list of modified files
- diff
- summary
```
---
## 14. Результат
Після впровадження каталогу:
- чітке розуміння всіх платформ екосистеми DAARION.city;
- стандартизовані патерни інтеграції;
- готовність до додавання нових платформ;
- інтеграція з Access Keys & Capabilities System.

View File

@@ -0,0 +1,393 @@
---
title: City Tokenomics
version: 1.0.0
status: canonical
last_updated: 2024-11-14
---
> **Цей документ є актуальною версією токеноміки міста.**
> Усі попередні документи з токеноміки вважаються застарілими.
# City Tokenomics — DAARION.city (Integration-Ready)
**Цей документ є обов'язковим для додавання у репозиторій під час інтеграції MicroDAO у DAARION.city.**
DAARION.city — це **перше MicroDAO у мережі** (A1-рівень), що очолюється системним агентом **DAARWIZZ**. Усі інші компоненти міської екосистеми — це наступні рівні MicroDAO-структури.
---
## 1. Загальний огляд токеноміки міста
Місто працює на **двоєдиній моделі токенів**:
- **DAAR** — утиліті-токен (оплата сервісів, платформи, транзакції)
- **DAARION** — civic / identity токен (громадянство, доступ, статус)
Ця пара створює повноцінну економіку доступів та взаємодій.
---
## 2. DAAR — Utility Token
### Використання
- оплата товарів та послуг
- взаємодія з міськими платформами (GreenFood, EnergyUnion, WaterUnion тощо)
- оплата агентів
- оплата створення та роботи microDAO
- внутрішні транзакції між користувачами та DAO
**DAAR — енергія міської економіки.**
### Tokenomics
- динамічний випуск
- джерело: DAARsales (USDT/POL → DAAR)
- комісія на транзакції DAAR: **0.5% → DAO Share Pool**
- APR: **20%** (в стейкінгу)
---
## 3. DAARION — Civic Token / Identity Token
### Використання
- підтвердження статусу громадянина міста
- доступ до глибинних рівнів інфраструктури
- ліцензійний ключ для створення платформ
- доступ до advanced API та інтеграцій
**DAARION — статус, права і розширені можливості.**
### Tokenomics
- стартова емісія: **500 DAARION**
- дефляція: **5% burn** при продажу
- APR: **4% + частка від комісій DAAR**
- джерело: DAARIONsales (100 DAAR → 1 DAARION)
---
## 4. Рівні доступу за DAAR та DAARION
### 4.1 Звичайні користувачі / Покупці
- доступ до платформ: **лише наявність DAAR**
- DAARION не потрібен
### 4.2 Постачальники / Вендори
- доступ до роботи на платформах: **0.01 DAARION у стейкінгу**
### 4.3 Створення платформ
- право створити платформу: **1 DAARION у стейкінгу**
### 4.4 Створення MicroDAO
- доступ: **1 DAAR або 0.01 DAARION**
---
## 4.5 MicroDAO Tokens (Local Layer)
Кожне microDAO має власні три токени, емітовані DAOFactory:
| Token | Function | Activation |
| -------- | ---------------------------------------------- | ---------------- |
| **GOV** | governance / voting key inside DAO | cost: **1 DAAR** |
| **UTIL** | внутрішня економіка DAO (операції, винагороди) | cost: **1 DAAR** |
| **REP** | репутаційний токен (невзаємозамінний) | cost: **1 DAAR** |
**Emission model:**
- DAO може емітувати будь-яку кількість, згідно з власною політикою
- DAOFactory перевіряє баланс користувача (1 DAAR або 0.01 DAARION)
- Емісія gas-free (off-chain), періодична синхронізація on-chain
**Economic Flow Inside MicroDAO:**
```text
DAAR → eMINT GOV/UTIL/REP → DAO Operations → UTIL Rewards → TokenBridge → DAAR
```
---
## 5. Ієрархія MicroDAO у DAARION.city
**ДАЖЕСТВА МІСТА — ЦЕ ДЕРЕВО MICRODAO.**
### **A1 — DAARION.city (перше MicroDAO)**
- кореневе DAO міста
- очолюється агентом **DAARWIZZ**
- керує реєстрами, платформами, правами доступу
### **A2 — Міські платформи (другий рівень)**
Платформи є MicroDAO другого порядку.
Поточний список:
- **Helion** — енергетика
- **GreenFood ERP** — агро/харчові продукти
- **Soul** — соціальна система
- **Dario** — міські сервіси
- **Nutra** — здоровʼя і нутриція
- **WaterAGI** — вода та очищення
Кожна платформа має власних агентів.
### **A3 — Публічні MicroDAO (третій рівень)**
- не підпорядковуються платформам
- доступні для всіх резидентів
- можуть взаємодіяти з A1 та A2 через DAAR
### **A4/F4 — Приватні MicroDAO (четвертий рівень)**
- повна автономія
- не мають підлеглості іншим DAO
- доступні лише за запрошенням
---
## 6. Логіка доступів на основі DAARION (Framework)
**Більше DAARION = більше можливостей**, зокрема:
- доступ до інституційних функцій
- доступ до створення платформ
- доступ до глибоких API
- доступ до керування DAO високого рівня
- більший пріоритет у DAGI
Це ядро формує модель: **Civic Token → Access Tier → City Expansion**.
---
## 7. Патерн розвитку токеноміки
Система спроектована так, що нові рівні доступу та права можуть додаватися з розвитком:
- запуск нових платформ
- нові типи агентів
- DAO-функції наступних фаз
- нові MetaDAO рівні
Токен DAARION — універсальний ключ для майбутньої інфраструктурної експансії.
---
## 8. Використання DAAR і DAARION у інтеграції MicroDAO
При підключенні MicroDAO до DAARION.city ця сторінка повинна бути додана у розділ:
```text
docs/tokenomics/city-tokenomics.md
```
MicroDAO використовує ці правила для:
- валідації доступу користувачів
- роботи DAOFactory
- роботи агентів DAARWIZZ
- контролю доступу до платформ
- ліцензування сервісів
DAARION.city — це **кореневе MicroDAO (A1)**, а вся міська екосистема — це дерево MicroDAO.
---
## 9. Інтеграція з іншими документами
Цей документ доповнює:
- `DAARION_city_integration.md` — архітектура інтеграції
- `50_daarion_city_website_integration.md` — інтеграція з сайтом
- `32_policy_service_PDP_design.md` — PDP token-gating
- `49_wallet_rwa_payouts_claims.md` — Wallet Service
> **Примітка:** Попередній документ `tokenomics/README.md` перенесено в `docs/_archive/tokenomics_legacy_v0.md`. Вся актуальна інформація об'єднана в цьому канонічному документі.
---
## 10. Завдання для Cursor
```text
You are a senior blockchain/full-stack engineer. Implement City Tokenomics using:
- docs/tokenomics/city-tokenomics.md (⭐ CANONICAL)
- 32_policy_service_PDP_design.md
- 49_wallet_rwa_payouts_claims.md
Tasks:
1) Implement access tier validation (DAAR ≥ 1.00 or DAARION ≥ 0.01 for MicroDAO creation).
2) Implement platform creation access (DAARION ≥ 1.00 staked).
3) Implement vendor access (DAARION ≥ 0.01 staked).
4) Implement DAARION.city as A1-level MicroDAO (root DAO).
5) Implement platform hierarchy (A2-level: Helion, GreenFood, Soul, Dario, Nutra, WaterAGI).
6) Implement public MicroDAO (A3-level) and private MicroDAO (A4-level) access rules.
7) Integrate DAARWIZZ agent as system agent for A1-level.
8) Add DAAR/DAARION balance checks in PDP for all access levels.
9) Implement tier-based access logic (more DAARION = more capabilities).
10) Add platform licensing system (1 DAARION staked = platform creation right).
Output:
- list of modified files
- diff
- summary
```
---
## 11. Підсумок
- **DAAR** = універсальна енергія економіки
- **DAARION** = статус, рівні доступу, громадянство
- платформи належать рівню A2
- публічні MicroDAO — A3
- приватні MicroDAO — A4
- DAARION.city — перше, головне DAO (A1), центр усієї мережі
Це формує стійку багаторівневу архітектуру міста та екосистеми MicroDAO.
---
## 12. Fees & Costs (MicroDAO Economics)
### City Fees (denominated in DAAR)
| Action | Cost |
| ------------------------------- | ------------- |
| Створення microDAO | **1 DAAR** |
| Емісія GOV | **1 DAAR** |
| Емісія UTIL | **1 DAAR** |
| Емісія REP | **1 DAAR** |
| Підключення агента DAGI | **0.25 DAAR** |
| Реєстрація DAO у каталозі міста | **0.05 DAAR** |
**90% DAO / 10% City Rule:** Діє для DePIN-DAO та DAO, що працюють з постійною DAGI-активністю.
---
## 13. Staking & Rewards
### DAAR Staking (APR: 20%)
- Rewards → DAAR
- Смартконтракт: `APRStaking`
### DAARION Staking (APR: 4% + revenue share)
- Rewards → DAAR
- Частка від DAAR-комісій (0.5%) розподіляється пропорційно до стейку DAARION
- Смартконтракт: `DAARDistributor`
---
## 14. Token Bridges & Onboarding
### Flow
```text
USDT/POL → DAAR → DAARION → DAO → DAGI → Rewards in DAAR
```
### Components
| Component | Function |
| ----------------- | ------------------------------ |
| **DAARsales** | Купівля DAAR за USDT/POL |
| **DAARIONsales** | 100 DAAR → 1 DAARION |
| **DAOFactory** | Створення MicroDAO |
| **TokenBridge** | UTIL ↔ DAAR обмін |
| **DAGI Registry** | Реєстрація DAO, агентів, знань |
### Primary Access Flow (Onboarding)
1. **Balance Check** — Wallet Agent перевіряє: ≥ 1 DAAR **або** ≥ 0.01 DAARION
2. **Eligibility**`eligible_for_MicroDAO = true`
3. **DAO Creation (DAOFactory)** — списується 1 DAAR, DAO отримує унікальний `dao_id`
4. **Token Activation** — користувач може емітувати GOV / UTIL / REP (1 DAAR за кожен тип)
5. **DAGI Sync** — DAO реєструється у DAGI Registry
---
## 15. Integration Points (Architecture)
### Wallet Service
- баланси DAAR / DAARION
- fee accounting (0.5%)
- DAOFactory calls
- staking
- token exchange
### PDP (Access Control)
- наявність токенів
- права доступу до DAO
- gas-free стани
- DAO governance rules
### Agents
**Можуть:**
- працювати з UTIL
- виконувати дії DAO
- розподіляти REP
- взаємодіяти з DAGI Registry
**Не можуть:**
- змінювати баланси DAAR/DAARION
- створювати DAO без користувача
- змінювати тарифні плани
### DAGI Registry
- DAO metadata
- Agent slots
- Knowledge mining rewards
- Off-chain/on-chain settlement
---
## 16. Security Rules
- тільки Owner може виконувати DAOFactory
- DAAR/DAARION операції виконуються он-чейн
- UTIL/GOV/REP — off-chain з періодичною валідацією
- burn 5% DAARION при продажі — обов'язковий
- reentrancy guard
- мінімальна кількість GOV для голосування встановлюється DAO
---
## 17. MVP Scope (Required for Launch)
### Must-have
- DAAR / DAARION баланс-чек
- DAOFactory (1 DAAR → create)
- eMINT GOV / UTIL / REP
- TokenBridge (UTIL ↔ DAAR)
- DAARsales, DAARIONsales
- Basic staking (DAAR, DAARION)
- PDP token-gating
- Wallet v1
### Optional MVP+
- Knowledge Mining Rewards
- REP reputation logic
- Multi-DAO bridges
---
## 18. Changelog
### v1.0.0 — 2024-11-14
- Початкова версія токеноміки міста
- Додано DAAR та DAARION токени
- Додано ієрархію MicroDAO (A1-A4)
- Додано рівні доступу
- Додано GOV/UTIL/REP токени для microDAO
- Додано DAOFactory та TokenBridge
- Додано staking та rewards
- Додано security rules
---
**Версія:** 1.0.0
**Останнє оновлення:** 2024-11-14
*Документ готовий до інтеграції у Cursor, GitHub або будь-який інший проект.*