feat(foundation): FOUNDATION_UPDATE implementation
## 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.
This commit is contained in:
Apple
152
docs/foundation/City_Interface_Architecture_v1.md
Normal file
152
docs/foundation/City_Interface_Architecture_v1.md
Normal file
@@ -0,0 +1,152 @@
|
||||
# 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-агенти — обличчя міста.
|
||||
|
||||
Документ завершено.
|
||||
|
||||
Reference in New Issue
Block a user