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

Архитектура wiki

Полный текст

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

Составлено по решениям Оператора (01.10.2026, сессия 7c7f2694), оформлено ИИ-Архитектором. Часть архитектуры продукта ADB ai_docs_broker. Проверяется по стандарту «Описание документа „Архитектура"» (координаты — в конце дока).

## Роль в «Архитектуре H2»

Wiki — визуальная проекция ADB: интерфейс для просмотра всей документации ADB. На схеме «Архитектура Платформы» v0.2 wiki — это элемент [wiki] в СЛОЕ 4 «Данные и события» (рядом с [adb] и [nats]) и одновременно сквозной контур показа. Всё, что видит пользователь wiki, приходит из ADB; wiki не производит знание, она показывает знание, уже записанное в ADB.

Координаты схемы: `{"op":"get_document","env":"dev","product":"adb_meta","doc_type":"Архитектура Платформы","latest":true}`.

## Wiki — интерфейс просмотра документации ADB

- **У wiki нет своих документов.** Все документы — в ADB (метаданные в его таблицах, тела в owui files). Wiki показывает документы только по их ADB-координатам (JSON-маршрут `{"op":"get_document",...}`). Ссылок на файлы OWUI и на внешние адреса wiki не показывает.
- **У wiki нет своих таблиц.** Всё, что нужно для показа, лежит в таблицах MariaDB продукта ADB. Таблицы проекции (привязки элементов схемы, индекс поиска, кеш страниц, срезы счётчиков) — таблицы продукта ADB: заводятся и меняются только миграциями ADB по его ЖЦ. Отдельная база, отдельная схема или отдельный сервисный пользователь для wiki не заводятся.
- **Wiki только читает.** Данные реестра wiki получает через read-only операции фасада OWUI functions. Прямой SQL к таблицам ADB из wiki запрещён (правило Гайда Архитектора ADB). Пишет в ADB только сам ADB-агент по своим правилам.
- **Wiki — интерфейсный контур продукта ADB.** Приложение wiki — это развёртывание продукта ADB (веб-интерфейс), не отдельный продукт. Доработка, сборка и деплой — по ЖЦ ADB.

## Слои wiki (визуально)

```
┌────────────────────────────────────────────────────────────────────┐
│ СЛОЙ 1. ДОСТУП                                                     │
│ Браузер → https://wiki.h2platform.ru → Caddy на VPS h2-edge-test   │
│ → приложение wiki — контейнер на VPS; сборка и деплой с heavy01    │
│ по SSH (образец — h2_obs_stack)                                    │
├────────────────────────────────────────────────────────────────────┤
│ СЛОЙ 2. ПОКАЗ                                                       │
│ Главная = кликабельная слоёная схема H2 (источник — док            │
│ «Архитектура Платформы») + счётчики реестра                        │
│ Страницы элементов схемы → страницы документов (полный текст,      │
│ версия, контрольная сумма, координаты чтения)                      │
├────────────────────────────────────────────────────────────────────┤
│ СЛОЙ 3. ДАННЫЕ ПОКАЗА                                               │
│ Таблицы MariaDB ПРОДУКТА ADB: привязки элементов схемы к докам,    │
│ индекс поиска, кеш страниц, срезы счётчиков, журнал синхронизации  │
│ (вносятся миграциями ADB; правило непересечения — см. Концепт)     │
├────────────────────────────────────────────────────────────────────┤
│ СЛОЙ 4. ЧТЕНИЕ                                                      │
│ OWUI functions — read-only операции ADB:                           │
│ get_document, list_documents, list_products, list_nodes,           │
│ list_doc_types, list_deploys, list_wheels, list_validation_runs,    │
│ list_live_scenario_runs, list_agent_work_log                       │
├────────────────────────────────────────────────────────────────────┤
│ ИСТОЧНИК: ADB ai_docs_broker (таблицы в MariaDB) + owui files      │
│ (тела документов) — единственный источник истины                   │
└────────────────────────────────────────────────────────────────────┘
```

## Элементы wiki

| Ключ | Элемент | Наполнение |
|---|---|---|
| main | Главная страница | Схема H2 («Архитектура Платформы», latest), счётчики реестра, время среза |
| element | Страница элемента схемы | Описание элемента; его доки по ADB-координатам; пометка «нет в ADB» |
| doc | Страница документа | Полный текст, версия, контрольная сумма, координаты чтения |
| search | Поиск (после MVP) | Поиск по всем докам через индекс в таблицах ADB; все кандидаты показываются, выбор не автоматический |
| links | Карта связей (после MVP) | Кто на кого ссылается по текстам доков; отчёт разрывов |
| llms | llms.txt (после MVP) | Машиночитаемый указатель актуальных документов с координатами |

## Среды и развёртывание

- Приложение wiki — контейнер на VPS h2-edge-test (161.104.53.48), рядом со стеком наблюдения и общим Caddy. Сборка и деплой — с узла heavy01 по SSH, тем же механизмом, которым разворачивался h2_obs_stack (его гайд и UEPR — в реестре). Исходники — рабочая область кодера на heavy01.
- Таблицы проекции — MariaDB продукта ADB на dev heavy02; приложение на VPS достигает её через VPN (VPS — вход в VPN H2). Живая проба связности — часть П1-МВП; при отказе — gap с evidence, без самодельных обходов.
- Данные реестра — через OWUI-фасад (HTTPS, доступен из edge-контура).
- Наружу — только 22/80/443 на VPS.
- VPS h2-edge-test — только Caddy-блок домена wiki.h2platform.ru (проксирование на heavy02 через VPN). DNS A-запись wiki → 161.104.53.48 добавлена на reg.ru 30.09.
- Показ реестров: dev и prod (по переключателю; в MVP — оба через координаты с env).
- Наружу — только 22/80/443 на VPS; приложение на heavy02 слушает только localhost/VPN.

## Правила

1. Ссылки на доки — только ADB-маршруты. Никаких ссылок на файлы OWUI и внешние адреса в наполнении страниц.
2. Нет своих доков, нет своих таблиц, нет отдельной базы. Всё показанное — из ADB.
3. Таблицы проекции — собственность продукта ADB: изменения только через миграции ADB по его ЖЦ (снимок до, живые пробы, учёт, обратный ход).
4. Правило непересечения (Концепт Развития, раздел «Проверка непересечения таблиц»): в wiki-проекции нет строк-фактов реестра; копии координат — снимки, сверяемые по контрольной сумме; истина — ADB.
5. Свежесть: пересбор затронутых страниц и срезов после каждого принятого документа; время среза видно на страницах.

## Приёмка

MVP и его приёмка — в Концепте Развития ADB (раздел «MVP wiki»): схема кликабельна, все слои видны, 10 первых доков открываются и совпадают с реестром, счётчики совпадают с живыми вызовами, изменения ADB — ноль (кроме внесённых доков). Дальнейшие итерации — только после сдачи MVP.

## Координаты связанных доков

- Схема платформы: `{"op":"get_document","env":"dev","product":"adb_meta","doc_type":"Архитектура Платформы","latest":true}`
- Концепт (MVP, итерации): `{"op":"get_document","env":"dev","product":"ai_docs_broker","doc_type":"Концепт Развития","latest":true}`
- Онтология ADB: `{"op":"get_document","env":"dev","product":"ai_docs_broker","doc_type":"Онтология","latest":true}`
- Гайд Архитектора ADB: `{"op":"get_document","env":"dev","product":"ai_docs_broker","doc_type":"Гайд Архитектора","latest":true}`
- Стандарт проверки архитектурных доков: `{"op":"get_document","env":"dev","product":"adb_meta","doc_type":"Стандарт","latest":true}` — «Описание документа „Архитектура"»

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

Первая редакция. Отличия v0.2: место приложения (контейнер на VPS, деплой с heavy01) и уточнение доступа к MariaDB через VPN; правила и слои чтения/показа не менялись.

## Changelog

- v0.2 (2026-10-01): уточнение Оператора «VPS на HEAVY01»: приложение — контейнер на VPS, сборка и деплой — с heavy01 по SSH (образец h2_obs_stack); таблицы проекции — MariaDB продукта ADB на heavy02 (через VPN). Смысл v0.1 не менялся.
- v0.1 (2026-10-01): первая редакция. Решения Оператора 01.10 11:04: wiki — интерфейс просмотра всей документации ADB; нет своих доков; нет своих таблиц — всё в таблицах MariaDB продукта ADB (замена решения об отдельной схеме wiki из Концепта v0.17/v0.18).