← к элементу · к схеме

Архитектура H2 (схема)

Полный текст

# Архитектура H2 v0.2

Сводная схема платформы H2. Составлено Оператором (01.10.2026, сессия 7c7f2694), оформлено ИИ-Архитектором без изменения смысла. Этот документ — источник главной страницы wiki (wiki.h2platform.ru): схема ниже кликабельна на wiki, каждый элемент привязан к странице элемента и к своим документам в ADB по их координатам.

## Слоёная схема (кликабельная)

На wiki каждый элемент схемы — ссылка. Ниже — слои сверху вниз; сквозные контуры справа. Ключ элемента — адрес его страницы на wiki.

```
┌──────────────────────────────────────────────────────────────────────┐
│ СЛОЙ 1. ОПЕРАТОТОР [operator]                                        │
│ Вход: https://chat.h2platform.ru (учётная запись, токен, права)      │
│ Уровни использования: A · B · C · D                                  │
├──────────────────────────────────────────────────────────────────────┤
│ СЛОЙ 2. OWUI [owui]                                                  │
│   chat [owui-chat] · files [owui-files] · functions [owui-functions] │
│   chat — интерфейс, роли, контекст, запуск AHO                       │
│   files — единое хранилище по id (H2_API_KEY, доступ из NATS)        │
│   functions — слой API и тулзов; оркестратор ниже не ходит           │
├──────────────────────────────────────────────────────────────────────┤
│ СЛОЙ 3. АГЕНТСКИЙ КОНТУР [agents]                                    │
│   AHO [aho] → ACO [aco] → мосты [bridges]                            │
│   owui_roo_bridge (ROO в VS Code) · owui_perl_bridge (ПерпКомп)      │
│   Роли [roles]: ии-оркестратор · ии-архитектор · ии-кодер · ии-эксперт│
├──────────────────────────────────────────────────────────────────────┤
│ СЛОЙ 4. ДАННЫЕ И СОБЫТИЯ [data]                                      │
│   ADB ai_docs_broker [adb] — единая документация; все агенты читают  │
│   и пишут; SQL на prod; визуально — wiki.h2platform.ru [wiki]        │
│   NATS [nats] — на всех серверах, стримы для доставки                │
├──────────────────────────────────────────────────────────────────────┤
│ СЛОЙ 5. СЕРВЕРА И СРЕДЫ [nodes]                                      │
│   node.json на каждом сервере [node-json]                            │
│   h2_shared [h2-shared] — ring 0, читает node.json                   │
│   Продукты ring 3 [ring3] · среды env [env]: у продукта 1 dev,        │
│   остальные prod; ADB — только один prod                             │
└──────────────────────────────────────────────────────────────────────┘
  СКВОЗНЫЕ КОНТУРЫ:
  Мониторинг Grafana [monitor] — собирает только из owui functions
  VPS Selectel [vps] — вход в VPN H2 (h2-edge-test, 161.104.53.48)
  Промпт как код [paa] — h2_agent_monitor: логи прохождения гайдов,
  разбор ошибок владельцем
  Wiki [wiki] — визуальная проекция ADB
```

## Элементы схемы и их ключи

| Ключ | Элемент | Слой | Что на странице элемента |
|---|---|---|---|
| operator | Оператор | 1 | Вход, токен, уровни A/B/C/D |
| owui, owui-chat, owui-files, owui-functions | OWUI и его части | 2 | Назначение каждой части; доки фасада |
| aho, aco, bridges, roles | Агентский контур | 3 | Продукт, его доки, роли агентов |
| adb, nats | Данные и события | 4 | ADB: онтология, гайды, UEPR; NATS: канон контрактов |
| wiki | Wiki | 4 | Этот документ, концепт wiki, таблицы MariaDB |
| nodes, node-json, h2-shared, ring3, env | Сервера и среды | 5 | Узлы, node.json, h2_shared, продукты, env |
| monitor, vps, paa | Сквозные | — | Мониторинг, VPS, промпт как код |

Правило ссылок: страница элемента показывает документы элемента только по их ADB-координатам (JSON-маршрут `{"op":"get_document",...}`); если дока нет — «нет в ADB». Никаких ссылок на файлы OWUI.

## Оператор

Учётная запись на h2platform.ru, токен, определяющий права и доступы.

## H2 платформа

Платформа мультиагентов с полным современным harness. Уровни использования:

- **A** — использование готового: только запуск функций, тулзов в слое OWUI без погружения.
- **B** — создание/развитие пользовательского продукта на H2, от dev до prod, по гайдам ADB, промпт как код.
- **C** — доработка самой платформы, платформенные продукты, от dev до prod, по гайдам ADB, промпт как код.
- **D** — разработка сторонних продуктов (сайты, 1С, инженерговые продукты и т.п.). Адаптация ADB к другим продуктам.

## OWUI

- **chat** — вход пользователя: интерфейс с выбором ролей + контекст сущности. Запуск AHO (ai_helper_operator). https://chat.h2platform.ru/
- **files** — единое хранилище по id; доступ и снаружи по токену H2_API_KEY owui и из NATS.
- **functions** — единый слой, через который все ии-агенты используют H2; фактически слой API и тулзов H2. Роль «оркестратор» запускает только functions OWUI, не имея доступа ниже.

## Мониторинг состояния H2

https://monitor.h2platform.ru/ на Grafana. Собирает только данные из owui functions и выводит их.

## VPS сервер

На Selectel — вход в VPN H2.

## Документация: ADB ai_docs_broker

Единый для всех продукт ADB ai_docs_broker. Содержит всю информацию про сервера, продукты, все изменения и т.п. Любой агент читает, пишет и отражает все свои действия в ADB.

Визуально — https://wiki.h2platform.ru

Все доки хранятся в owui files. Все данные — в SQL в продукте ADB на сервере prod.

## NATS

Стоят на всех серверах, используют стримы для доставки.

## Сервера — node

node.json — единственный уникальный на сервере файл, который описывает всю специфику сервера.

Универсальные пакеты + платформенные ит-продукты:

- **h2_shared** — единственный пакет, читает node.json. Ring 0.
- Остальные продукты — ring 3.

- **ai_helper_operator (AHO)** — ит-продукт, который связывает chat OWUI с ии-агентом оркестратором; оркестратор действует с ролью и контекстом сущности.
- **AHO запускает ACO — ai_connect_orchestrator** — продукт, который запускает nssm-сервис, держащий связь между двумя точками: оператор (chat OWUI) --> ии-агент исполнитель, и ии-агент постановщик --> ии-агент исполнитель.
- **ACO использует мосты** — ит-продукты (owui_roo_bridge, owui_perl_bridge), которые связывают с ПерпКомп (браузер playwright) и ROO в VS Code.

## Среды env

У каждого продукта — один сервер, который dev; на нём происходит его доработка и проверка. На остальных серверах — prod.

Бывают продукты, которые должны стоять на всех серверах (например, h2_shared, мост owui_roo_bridge) или на части серверов. Но есть продукты, у которых только один prod, — например, ADB ai_docs_broker.

## Роли ии-агентов

| Агентная роль | Назначение | Продукты ии-агентов |
| --- | --- | --- |
| ии-оркестратор | пользователь продукта — постановщик с Оператором | ПерпКомп, ROO |
| ии-архитектор | архитектор продукта | ПерпКомп, ROO |
| ии-кодер | кодер продукта — исключительный доступ к коду на сервере (ии-арх кода не видит) | ROO |
| ии-эксперт | эксперт продукта (только web-поиск) | ПерпПоиск по мосту owui_perl_bridge |

ИИ-агенты работают только по документации ADB.

## Основные документы продукта

Онтология; Гайд арх; Гайд пользователя; Лив Сценарий; Концепт развития; Дор Карта.

UEPR = гайд, аудит и файлы — продукт + нода.

## Типы доков

В системе каждый тип дока имеет инструкцию и проверку, что в нём должно быть.

### Проверка при внесении доков в ADB

При внесении дока проверяется:

- продолжение старого по версии, полный, корректность ченджлога;
- состав документа на отсутствие ошибок по инструкции на этот тип дока;
- корректность ссылок на ADB;
- изменение дока — проверяется по всем ссылкам, откуда на него ссылаются, что везде новые изменения не конфликтуют.

## Процессные доки

- Гайд арх h2_shared — как запустить новый ит-продукт.
- Жизненный Цикл разработки продукта h2_shared — для пакета h2_shared.
- Жизненный Цикл разработки продукта — для любого ring 3.
- Открытка онбординга ии-арх; Онбординг ии-арх; Закрытие сессии ии-арх.
- Открытка онбординга ии-кодера; Онбординг ии-кодера.

## Промпт как код

Все ии-агенты работают только по докам, гайдам из ADB и пишут в h2_agent_monitor логи о том, как прошли гайд, какие ошибки. Этот лог разбирает каждый агент — владелец и устраняет ошибки, проверяя, что исправлено.

## NON-ACTIVE HISTORY: v0.1 (2026-10-01, doc 1875)

Первая редакция (конспект Оператора, оформленный без изменения смысла). Отличия v0.2: добавлены слоёная кликабельная схема, ключи элементов и правило кликабельности; текст разделов ниже схемы не менялся.

## Changelog

- v0.2 (2026-10-01): слоёная кликабельная схема (5 слоёв + сквозные контуры), ключи элементов для wiki, таблица «элемент → слой → наполнение». Решение Оператора от 01.10 10:44. Смысл v0.1 не менялся.
- v0.1 (2026-10-01): первая редакция. Источник — конспект Оператора «Архитектура H2» (сессия 7c7f2694). Оформление в markdown без изменения смысла.