daarion-admin/microdao-daarion
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
codex/docs-standardization-pr
microdao-daarion/docs/microdao-admin-console.md
Apple c552199eed 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
2025-11-15 04:08:35 -08:00

12 KiB
Raw Permalink Blame History

title, version, status, last_updated
title version status last_updated
MicroDAO Admin Console — Unified Admin UI Spec 1.0.0 canonical 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. Доступ до адмін-панелі

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

/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 View Git Blame Copy Permalink