c552199eed
- 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
332 lines
12 KiB
Markdown
332 lines
12 KiB
Markdown
---
|
||
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 або будь-який інший проект.*
|
||
|
||
|