Skip to content

# 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. Доступ до адмін-панелі

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

    /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 або будь-який інший проект.