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