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

---

## ✅ PHASE COMPLETE

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

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