Skip to content

# TASK_PHASE_FOUNDATION_UPDATE.md

## DAARION.city — Fundamental Architecture Update (Non-Breaking)

Ціль: зафіксувати онтологію системи (Agent → MicroDAO → Node → District), стандартизувати онбординг, DAIS-ідентичність, типи агентів, події та базовий Data Model — без порушення існуючого коду / документації.

# 0. Принципи фази

1. Нічого не ламаємо, лише додаємо надбудову поверх існуючих документів.
2. Усе, що створюється в цій фазі — фундаментальна архітектура DAARION.
3. Cursor і DAGI-агенти повинні мати єдине джерело істини щодо реєстрації, агентів, мікроДАО, нод, ролей, подій.

# 1. Вихідні файли після завершення фази

Фаза повинна створити або оновити 13+ документів.

## Головні

1. `DAARION_Ontology_Core_v1.md`
2. `User_Onboarding_And_Identity_Layer_v1.md`
3. `Technical_Description_microdao_PATCH_Ontology.md`
4. `microdao_Data_Model_UPDATE_v1.md`
5. `microdao_Event_Catalog_EXTENDED_v1.md`
6. `microdao_Governance_And_Permissions_v1.md`
7. `DAARION_Identity_And_Access_Draft_v1.md`
8. `Rooms_Layer_Architecture_v1.md`
9. `MicroDAO_Interface_Architecture_v1.md`
10. `City_Interface_Architecture_v1.md`
11. `Agents_Interface_Architecture_v1.md`
12. `Nodes_Interface_Architecture_v1.md`

## Допоміжні

- `helpers/ontology-summary.md`
- `helpers/onboarding-flow-diagram.mermaid`
- `helpers/agent-types-matrix.md`
- `helpers/microdao-lifecycle.md`
- `helpers/node-lifecycle.md`
- `helpers/event-schemas.json`

## Патчі

- `patches/DAARION_Person_Agent_DAIS_CoreTeam_PATCH_v1.md`

# 2. Tasks

1. TASK 1 — Ontology Core → створити базову онтологію (файл №1).
2. TASK 2 — Onboarding & Identity → email/wallet/SIWE/DAIS (файл №2).
3. TASK 3 — Patch Technical Description → секції онтології в існуючому описі microdao.
4. TASK 4 — Data Model Update → agents/microdaos/nodes/assignments.
5. TASK 5 — Event Catalog → додати 6 нових подій та схеми.
6. TASK 6 — Governance Layer → ролі, ACL, district, assignments.
7. TASK 7 — Identity & Access Draft → DAIS як IAM.
8. TASK 8 — Rooms Layer → city/microdao/district rooms.
9. TASK 9 — MicroDAO Interface → повний UI шару.
10. TASK 10 — City Interface → City Square, public rooms, portals.
11. TASK 11 — Agents Interface → agent-centric UI.
12. TASK 12 — Nodes Interface → node dashboards/control rooms.
13. TASK 13 — Helper Files → TL;DR, mermaid, lifecycles, event schemas.

# 3. Порядок виконання

1. Ontology → Onboarding → Patch → Data Model → Event Catalog → Governance → Identity & Access.
2. Після цього Rooms Layer та UI документи (MicroDAO/City/Agents/Nodes).
3. Завершити helper-файлами та README.

# 4. Гарантії «Non-Breaking Update»

- Неторкнені частини коду/документації залишаються валідними.
- Усі інваріанти вводяться як надбудова.
- Уся логіка створення MicroDAO/агента/нод залишається робочою.

# Acceptance checklist

1. Документи
2. [x] Створено/оновлено всі файли, перелічені вище. ✅ (20 файлів)
3. [x] README у `docs/foundation/` описує структуру. ✅
4. Посилання
5. [x] Перехресні посилання між онтологією, моделлю даних, подіями, інтерфейсами. ✅
6. Helper-файли
7. [x] TL;DR, діаграма онбордингу, матриця агентів, lifecycles, event schemas. ✅ (6 файлів)
8. Патчі
9. [x] Застосовано патч Human vs Agent vs DAIS vs Core-Team. ✅
10. Task readiness
11. [x] `TASK_PHASE_FOUNDATION_UPDATE.md` описує всі deliverables. ✅
12. [x] Можна давати Cursor-таски для реалізації MVP на основі цих документів. ✅

## ✅ PHASE COMPLETE

Дата завершення: 2024-11-29

Статистика: - Основних документів: 12 - Helper-файлів: 6 - Патчів: 1 - README: 1 - Всього: 20 файлів