Add Infra Automation Pack v1: docs infrastructure, logging stack, sync scripts
This commit is contained in:
36
docs/public/architecture-overview.md
Normal file
36
docs/public/architecture-overview.md
Normal 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.
|
||||
|
||||
21
docs/public/daiS_daos_overview.md
Normal file
21
docs/public/daiS_daos_overview.md
Normal 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.
|
||||
|
||||
40
docs/public/getting-started.md
Normal file
40
docs/public/getting-started.md
Normal 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
21
docs/public/index.md
Normal 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).
|
||||
|
||||
Reference in New Issue
Block a user