---
title: MicroDAO Admin Console — Unified Admin UI Spec
version: 1.0.0
status: canonical
last_updated: 2024-11-14
---

# MicroDAO Admin Console — Unified Admin UI Spec

**Цей документ описує стандартизовану адмін-панель для всіх MicroDAO в екосистемі DAARION.city.**

Адмінка має бути:

* однаково структурованою для A1, A2, A3, A4/F4 DAO,
* з обовʼязковою присутністю головного агента DAO на Overview-сторінці,
* розширюваною (можна додавати вкладки, але не прибирати базові),
* адаптивною (від A1 SuperDAO до маленького приватного DAO).

---

# 1. Цілі та принципи

1. **Уніфікація** — будь-яке MicroDAO має однакову логіку налаштувань.

2. **Agent-first Admin** — головний агент DAO присутній на кожній адмін-сторінці як помічник.

3. **Role-aware** — доступ до консолі залежить від ролі користувача (Owner/Admin тощо).

4. **Safe-by-default** — всі критичні дії проходять через PDP та підтвердження.

5. **Composable** — модулі адмінки можна вмикати/вимикати залежно від рівня DAO (A1/A2/A3/A4).

---

# 2. Доступ до адмін-панелі

Адмін-панель доступна за маршрутом:

```text
/dao/:dao_id/admin
```

Доступ мають користувачі з ролями:

* **Owner**
* **Admin**

Опційно (тільки для читання):

* **Auditor / Observer** (якщо така роль буде додана пізніше).

Агенти можуть "бачити" адмін-панель через окремий API, але **ніколи не відкривають її як UI**.

---

# 3. Загальний layout адмінки

Адмінка складається з трьох основних зон:

1. **Header (верхня панель)**
2. **Sidebar (ліва навігація)**
3. **Main Content (центральна зона)**

## 3.1 Header

Містить:

* Назву DAO: `DAO Name`
* Рівень: `A1 / A2 / A3 / A4/F4`
* Статус: `active | paused | archived | private`
* Інформація про супідпорядкування:
  * якщо `parent_dao_id != null`, показати: `Частина SuperDAO: <Parent DAO Name>`
  * якщо це A1: `SuperDAO Root (DAARION.city)`

Опційно:

* кнопка швидкого перемикання між DAO (для адмінів, що керують кількома DAO)

## 3.2 Sidebar (навігація)

Базові розділи (обовʼязкові для всіх DAO):

1. **Overview**
2. **Members & Roles**
3. **Tokenomics & Wallet**
4. **Agents**
5. **Integrations**
6. **Settings**
7. **Security & Logs**

Для A1/A2 можуть зʼявлятися додаткові вкладки (наприклад: `Platforms`, `Federation`, `City Config`).

## 3.3 Main Content (залежить від обраної вкладки)

Основна зона використовується кожним розділом по-різному.

---

# 4. Overview (головний екран адміна)

**Overview** — це центральна точка входу для будь-якого адміна DAO.

## 4.1 Блок "Головний агент DAO"

У верхній частині Overview **завжди** присутній блок із головним агентом DAO.

* Для A1: **DAARWIZZ**
* Для A2-платформ: головний платформний агент, напр. `Helion.CoreAgent`
* Для A3/A4: агент, обраний власником DAO (наприклад `Main DAO Agent`)

Блок містить:

* аватар/іконку агента
* імʼя та короткий опис ролі
* статус (online / busy / maintenance)
* кнопку "Поставити запитання" або "Попросити рекомендацію"

Головний агент може:

* показувати TODO для адміна ("налаштуйте ролі", "додайте інтеграцію").
* пояснювати налаштування адмінки простими словами.

## 4.2 Стан DAO (Status & Health)

Секція з основними метриками:

* кількість учасників DAO
* рівень DAO (A2/A3/A4)
* чи є DAO частиною SuperDAO (і якого)
* основні активні інтеграції
* стан токенів (базово: наявність DAAR/DAARION для роботи DAO)

## 4.3 Останні події

Лог останніх важливих подій:

* зміни ролей
* включення/відключення агентів
* підключення інтеграцій
* спроби критичних дій (успішні/відхилені PDP)

---

# 5. Members & Roles

Розділ для управління учасниками DAO.

Функції:

* перегляд списку учасників (імʼя, роль, статус)
* призначення/зміна ролей (Owner, Admin, Member, Guest)
* запрошення нових учасників (e-mail/handle/ID)
* видалення/бан учасників

Особливості:

* лише **Owner** може передавати роль Owner іншому користувачу
* лише **Owner/Admin** можуть змінювати ролі інших

У майбутньому тут може зʼявитися інтеграція з токенами репутації (REP).

---

# 6. Tokenomics & Wallet

Розділ для перегляду й управління економічною частиною DAO.

Елементи:

* баланс DAAR / DAARION (для DAO, якщо це передбачено)
* індикатор відповідності токеноміці (чи достатньо DAAR/DAARION для поточних функцій)
* інформація про локальні токени DAO (якщо DAO використовує GOV/UTIL/REP)

Обмеження:

* фінансові операції (перекази, стейкінг, виплати) мають відкривати окремий безпечний флоу, де всі дії проходять через Wallet Service + PDP.
* агенти можуть лише пропонувати дії ("запропонувати транзакцію"), але не виконувати їх самостійно.

---

# 7. Agents

Розділ для управління агентами DAO.

Елементи:

* список агентів DAO (назва, тип, статус, рівень доступу)
* позначка "Main Agent" (головний агент DAO)
* кнопки:
  * **Додати агента** (з каталогу типів або кастомний)
  * **Увімкнути/вимкнути** агента
  * **Налаштувати** (деталі поведінки, рівень автономії, дозволені дії)

Обовʼязкові правила:

* головний агент DAO завжди має бути один
* вилучення головного агента має вимагати підтвердження та, можливо, участі A1 (для A2)-рівня DAO
* усі зміни конфігурації агентів логуються в Security & Logs

---

# 8. Integrations

Розділ для підключення зовнішніх сервісів та міських платформ.

Приклади:

* інтеграція з GreenFood ERP
* інтеграція з Helion (енергетика)
* інтеграція з WaterAGI
* інтеграція з зовнішніми сервісами (наприклад, CRM/Notion/Jira у майбутньому)

Механіка:

* список доступних інтеграцій (каталог)
* кнопка "Підключити"
* статус: `connected | disconnected | error`

Усі інтеграції мають описуватися як capability-keys для агентів.

---

# 9. Settings

Розділ для налаштувань DAO.

Параметри:

* назва DAO, опис, аватар/лого
* тип DAO: `platform | public | private`
* рівень видимості (чисто для UI): `public catalog | invite-only`
* налаштування онбордингу (чи можна подати заявку на вступ)

Для A2/A3/A4 можуть бути додаткові поля.

Зміна критичних налаштувань:

* вимагає підтвердження (наприклад, повторне введення пароля/підпису транзакції)
* логуються в Security & Logs

---

# 10. Security & Logs

Розділ для аудиту дій.

Містить:

* список останніх важливих дій (зміни ролей, агентів, налаштувань)
* логи спроб доступу
* результат перевірок PDP (allow/deny)

Мета:

* прозорість
* можливість розслідування інцидентів

---

# 11. Специфіка для рівнів A1 / A2 / A3 / A4

## 11.1 A1 (DAARION.city)

Додаткові розділи:

* **Federation / SuperDAO** (коли буде описано)
* **City Config** — міські політики, глобальні ліміти, токеноміка

Головний агент: **DAARWIZZ** — завжди відображається на Overview.

## 11.2 A2 (платформи)

Додаткові опції:

* керування продуктами/сервісами платформи
* керування вендорами

Головний агент: головний агент відповідної платформи.

## 11.3 A3/A4 (публічні та приватні DAO)

Стандартний набір вкладок, мінімалістичний:

* Overview, Members, Agents, Settings, Security

Головний агент: вибирається засновником DAO.

---

# 12. Використання цього документа

Ця специфікація використовується для:

* проектування UI/UX адмін-панелі для всіх MicroDAO
* уніфікації досвіду адміністрування в DAARION.city
* інтеграції агентів у адмінку (Agent-as-Admin-Assistant)
* узгодження між frontend/backend/архітекторами

Будь-які зміни в ролях, аґентній архітектурі чи токеноміці мають синхронізуватися з цим документом, щоб адмінка залишалась єдиною для всієї екосистеми.

---

## 13. Integration with Other Docs

Цей документ інтегрується з:

- `microdao-architecture.md` — архітектура A1-A4
- `agents.md` — агенти та їх права
- `pdp_access.md` — PDP та система доступів
- `superdao-federation.md` — SuperDAO та федерації
- `api.md` — API для адмін-консолі
- `tokenomics/city-tokenomics.md` — токеноміка

---

## 14. Changelog

### v1.0.0 — 2024-11-14
- Початкова версія специфікації MicroDAO Admin Console
- Додано структуру layout (Header, Sidebar, Main Content)
- Додано розділи: Overview, Members & Roles, Tokenomics & Wallet, Agents, Integrations, Settings, Security & Logs
- Додано обов'язковий блок головного агента на Overview
- Додано специфіку для рівнів A1/A2/A3/A4

---

**Версія:** 1.0.0  
**Останнє оновлення:** 2024-11-14  
*Документ готовий до інтеграції у Cursor, GitHub або будь-який інший проект.*


