# 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.