7b91c8e83c
## Documentation (20 files) - DAARION Ontology Core v1 (Agent → MicroDAO → Node → District) - User Onboarding & Identity Layer (DAIS) - Data Model UPDATE, Event Catalog, Governance & Permissions - Rooms Layer, City/MicroDAO/Agents/Nodes Interface Architecture - Helper files: ontology-summary, lifecycles, event-schemas ## Database Migration (027) - DAIS tables: dais_identities, dais_emails, dais_wallets, dais_keys - agent_assignments table for Assignment Layer - rooms table for Rooms Layer - event_outbox for NATS event delivery - New enums: agent_role, microdao_type, node_kind, node_status, etc. - Updated agents, microdaos, nodes tables with ontology fields ## Backend - DAIS service & routes (/api/v1/dais/*) - Assignment service & routes (/api/v1/assignments/*) - Domain types for DAIS and Ontology ## Frontend - Ontology types (Agent, MicroDAO, Node, DAIS, Assignments) - API clients for DAIS and Assignments - UI components: DaisProfileCard, AssignmentsPanel, OntologyBadge Non-breaking update - all existing functionality preserved.
153 lines
4.9 KiB
Markdown
153 lines
4.9 KiB
Markdown
# City_Interface_Architecture_v1.md
|
||
|
||
## DAARION.city — City Layer & Public Space Interface
|
||
|
||
**Version:** 1.0
|
||
**Status:** Foundation Spec (MVP)
|
||
**Scope:** City Hub, City Square, public rooms, civic agents, MicroDAO portals, 2D/3D map
|
||
|
||
---
|
||
|
||
# 0. Мета документа
|
||
|
||
Визначити інтерфейс міського рівня DAARION.space:
|
||
|
||
* City Hub, City Square, публічні кімнати,
|
||
* ролі DARIO, DARIA, DAARWIZZ та інших civic-агентів,
|
||
* публічні кіоски/портали MicroDAO та District,
|
||
* взаємодію з Rooms Layer і MicroDAO Interface,
|
||
* 2D/3D представлення.
|
||
|
||
---
|
||
|
||
# 1. Роль City Layer
|
||
|
||
* верхній публічний шар DAARION.space;
|
||
* перша точка входу для мешканців;
|
||
* спільний простір для всіх MicroDAO/District/агентів;
|
||
* місце, де користувачі бачать мапу, кімнати, портали, події.
|
||
|
||
---
|
||
|
||
# 2. Основні об’єкти
|
||
|
||
## 2.1. City Hub
|
||
|
||
* належить root MicroDAO `DAARION`;
|
||
* містить City Square, City Rooms, City Map, реєстр порталів.
|
||
|
||
## 2.2. City Square
|
||
|
||
* головна публічна сцена;
|
||
* `primary_agent = DARIO`, `team_agents = [DARIA, DAARWIZZ, civic agents]`;
|
||
* блоки: привітання, підтримка, публічні кімнати, кіоски MicroDAO та District.
|
||
|
||
## 2.3. City Rooms
|
||
|
||
* `city.lobby`, `city.news`, `city.events`, `city.help` тощо;
|
||
* `space_scope='city'`, `owner_type='city'`.
|
||
|
||
## 2.4. MicroDAO Portals
|
||
|
||
* публічні кімнати `front-room` у місті (Energyunion, GREENFOOD);
|
||
* ведуть до інтерфейсу конкретного MicroDAO.
|
||
|
||
## 2.5. District Portals
|
||
|
||
* портали для платформ/екосистем;
|
||
* ведуть у District Space.
|
||
|
||
---
|
||
|
||
# 3. Агентність міського інтерфейсу
|
||
|
||
* **DARIO** — primary_agent City Square (community manager).
|
||
* **DARIA** — assistant_agent (tech support).
|
||
* **DAARWIZZ** — мер міста; бере участь у подіях.
|
||
* Публічні DAO агенти (Helion, ERP) мають власні front-room.
|
||
|
||
---
|
||
|
||
# 4. Основні екрани
|
||
|
||
1. `/city` — City Square (центральна сцена).
|
||
2. `/city/rooms` — список публічних кімнат.
|
||
3. `/city/map` — 2D-мапа з маркерами кімнат і порталів.
|
||
4. `/city/agents` — каталог публічних агентів (DARIO, DARIA, DAARWIZZ, DAO-агенти).
|
||
|
||
---
|
||
|
||
# 5. City Square Layout (MVP)
|
||
|
||
* **Центр:** DARIO (вітання, пропозиції, вибір MicroDAO).
|
||
* **Праворуч:** DARIA (FAQ, підтримка, навігація).
|
||
* **Низ:** публічні кімнати (Новини, Події, Допомога, Лобі).
|
||
* **Ліворуч:** кіоски MicroDAO (Energyunion, GREENFOOD).
|
||
* **Верх:** DAARWIZZ + глобальні оголошення.
|
||
|
||
---
|
||
|
||
# 6. Публічність та присутність
|
||
|
||
* City Square — місце, де можуть бути всі авторизовані користувачі, їх агенти та публічні DAO.
|
||
* MVP: список «хто онлайн» та лічильник присутніх (без 3D).
|
||
|
||
---
|
||
|
||
# 7. Портали MicroDAO
|
||
|
||
* кожне MicroDAO може опублікувати front-office (`space_scope='city'`);
|
||
* користувач бачить:
|
||
* якщо не член — публічний профіль + «Приєднатися»;
|
||
* якщо член — кнопка «Увійти в MicroDAO».
|
||
|
||
---
|
||
|
||
# 8. Civic Layer
|
||
|
||
* DARIO — community manager.
|
||
* DARIA — технічна підтримка.
|
||
* DAARWIZZ — мер; участь у «city.events`.
|
||
|
||
---
|
||
|
||
# 9. API (чернетка)
|
||
|
||
* `GET /api/city/rooms`
|
||
* `GET /api/city/portals`
|
||
* `GET /api/city/map`
|
||
* `GET /api/city/agents/public`
|
||
|
||
---
|
||
|
||
# 10. MVP Scope
|
||
|
||
* `/city` з базовими блоками DARIO/DARIA, публічні кімнати, два front-office.
|
||
* `/city/rooms` як таблиця.
|
||
* `/city/map` — статична 2D-мінімапа.
|
||
* Каталог публічних агентів.
|
||
|
||
Не входить: повна 3D-мапа, аватари, гейміфікація.
|
||
|
||
---
|
||
|
||
# 11. Взаємодія з іншими рівнями
|
||
|
||
* City Layer → Rooms Layer (`city-room`, `front-room`).
|
||
* City Layer → MicroDAO Interface (front-office).
|
||
* City Layer → Agents Layer (primary/team agents).
|
||
|
||
---
|
||
|
||
# 12. Підсумок
|
||
|
||
City Layer робить DAARION.city зрозумілим для мешканців:
|
||
|
||
* City Square — головна сцена;
|
||
* публічні кімнати — спільний простір;
|
||
* портали MicroDAO — міст між містом і організаціями;
|
||
* civic-агенти — обличчя міста.
|
||
|
||
Документ завершено.
|
||
|