Files
microdao-daarion/docs/foundation/City_Interface_Architecture_v1.md
Apple 7b91c8e83c 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.
2025-11-29 15:24:38 -08:00

4.9 KiB
Raw Blame History

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

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