Add Infra Automation Pack v1: docs infrastructure, logging stack, sync scripts

This commit is contained in:
Apple
2025-11-27 09:29:42 -08:00
parent 6bd769ef40
commit 2a6112fc42
22 changed files with 595 additions and 0 deletions

View File

@@ -0,0 +1,36 @@
# Architecture Overview
## Сервери
| Нода | Роль | Розташування |
|------|------|--------------|
| NODE1 | Production + Gateway | Hetzner GEX44 (144.76.224.179) |
| NODE2 | Development / Multimodal | MacBook Pro M4 Max |
## Головні сервіси
- **City Service (FastAPI)** — міські кімнати, Matrix bootstrap.
- **Matrix Gateway** — видача токенів, presence heartbeat.
- **Matrix Presence Aggregатор** — збір online + агентів → SSE.
- **Agents Service / MicroDAO Service** — профілі агентів та DAO.
- **Next.js фронтенд** — `apps/web`, Vite dev server.
## Потік користувача
1. Login через Auth Service.
2. `/city` → City Map з live presence.
3. `/city/[slug]` → Matrix Chat (matrix-js-sdk).
4. Presence Heartbeat → Matrix Gateway → Synapse.
5. Aggregator читає presence + agents та транслює SSE.
## Мережа
- Docker network `dagi-network`.
- Nginx/Traefik на 80/443.
- Matrix Synapse всередині мережі, доступ через `app.daarion.space` проксі.
## Дані
- PostgreSQL (`dagi-postgres`).
- Redis (presence/cache).
- NATS JetStream (події).
## Моніторинг
- Prometheus, Grafana (локально на NODE1).
- Infra Automation Pack додає Loki + Promtail.

View File

@@ -0,0 +1,21 @@
# DAIS & DAOS Overview
DAIS (Decentralized AI Identity Stack) — стандарт для агентів DAARION. DAOS — їхня система автономності.
## DAIS Модулі
1. **CORE** — цифрова ідентичність, ключі, профіль.
2. **VIS** — аватар, voice, мультимедійні прояви.
3. **COG** — LLM + пам'ять, RAG, аналітика.
4. **ACT** — Matrix, DAO, зовнішні API, wallet.
## DAOS
- Регламентує життєвий цикл агента.
- Визначає permissions, audit trail, self-upgrade.
- Працює поверх Node Registry та MicroDAO governance.
## План впровадження
1. **Infra Automation Pack v1** → стабільна база для документації й логів.
2. **Agent Presence v2** → агенти + DAIS статуси.
3. **DAIS Framework** → реєстрація та керування агентами.
4. **DAOS Governance** → мульти-агентні DAO, MetaMorph.

View File

@@ -0,0 +1,40 @@
# Getting Started
Цей гайд допоможе розгорнути DAARION локально або на сервері.
## 1. Клонування репозиторію
```bash
git clone https://github.com/IvanTytar/microdao-daarion.git
cd microdao-daarion
```
## 2. Необхідні залежності
- Docker / Docker Compose 1.29+
- Node.js 20+
- Python 3.11+
- pnpm або npm (для фронтенду)
## 3. Основні команди
```bash
# Бекенд сервіси
docker compose up -d
# City frontend (Next.js)
cd apps/web
pnpm install
pnpm dev
```
## 4. Ноди
- **NODE1 (production):** `/opt/microdao-daarion`, IP `144.76.224.179`.
- **NODE2 (dev MacBook):** `/Users/apple/github-projects/microdao-daarion`.
## 5. CI/CD
1. Код → `main`.
2. `git pull` на NODE1.
3. `docker compose up -d --build`.
## 6. Корисні скрипти
- `smoke.sh` — базовий health check.
- `scripts/docs/docs_sync.sh` — автоматичний pull (див. Infra Pack).

21
docs/public/index.md Normal file
View File

@@ -0,0 +1,21 @@
# DAARION.city — MicroDAO Infrastructure
DAARION.city — це міське середовище для мікро-спільнот з агентами, Matrix-чатами та модульною інфраструктурою. Ця документація описує ядро платформи, архітектурні принципи та дорожню карту розвитку.
## Чим є DAARION
- **Мультисерверна інфраструктура:** NODE1 (продакшн) + NODE2 (дев) зі спільним кодовим репозиторієм.
- **Міські сервіси:** City Service, MicroDAO Service, Agents Core, Matrix Gateway.
- **Realtime-шар:** Matrix presence, Global Presence Aggregator, 2D City Map.
- **Дорога до DAIS/DAOS:** Ідентичності агентів, агенти-горожани, автономні модулі.
## Як читати документацію
- Розділ **Getting Started** допоможе швидко підняти репозиторій локально.
- **Architecture Overview** описує основні сервіси, мережеві правила й деплой.
- **DAIS & DAOS** — вступ до наступної фази агентів.
- **Internal** — інфраструктура, специфікації, стандарти (лише для внутрішнього користування).
## Поточний статус
- Production-ready основний стек (FastAPI + React + Matrix).
- City Map з live presence та агентами — впроваджено.
- Наступний крок: Infra Automation Pack v1 (документація, логінг, sync).