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
331
docs/microdao-admin-console.md
Normal file
331
docs/microdao-admin-console.md
Normal file
@@ -0,0 +1,331 @@
|
||||
---
|
||||
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 або будь-який інший проект.*
|
||||
|
||||
|
||||
Reference in New Issue
Block a user