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

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