Skip to content

# 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-агенти — обличчя міста.

Документ завершено.