К содержимому
BuildNexus
Сложный блок без монолита
Готово к работе · v1

Сложный блок без монолита

Lego-композиция связывает готовые секции декларацией module.compose.json. Координатор задаёт раскладку и именованные места для серверной отрисовки, существующий state_owner хранит данные, а модули представления и действий занимают свои места.

В примере каталога product_vitrine по-прежнему отвечает за товары, фильтры, пагинацию и состояние адреса. catalog_listing не выполняет второй запрос и не создаёт второе дерево Vue.

Основы модулей

Участники композиции

У каждой роли одна ясная ответственность.

Координатор

Владеет раскладкой и объявляет именованные места для серверной отрисовки, но не дублирует данные.

Владелец состояния

Единственный источник истины: данные, состояние, пагинация и адрес страницы.

Источник данных

Основная секция, которую координатор помещает в главное именованное место.

Представление

Показывает состояние владельца — например, панель фильтров.

Протокол

Версионированный договор совместимости всех участников.

Именованное место

Область координатора, предназначенная для целой дочерней секции.

Рабочий пример каталога

catalog_listing                 координатор, раскладка
├── filters
│   └── catalog_filter_panel    необязательное представление
└── listing
    └── product_vitrine         владелец состояния и источник данных

Координатор

{
  "composition": {
    "protocol": "catalog.view.v1",
    "role": "coordinator",
    "state_owner": "product_vitrine",
    "slot": "listing",
    "children": [
      {
        "slot": "filters",
        "module": "catalog_filter_panel",
        "optional": true
      }
    ]
  }
}

Владелец состояния и источник данных

{
  "composition": {
    "protocol": "catalog.view.v1",
    "role": "data_source",
    "state_owner": "product_vitrine",
    "slot": "listing"
  }
}

Дочернее представление

{
  "composition": {
    "protocol": "catalog.view.v1",
    "role": "presentation",
    "state_owner": "product_vitrine",
    "slot": "filters",
    "optional": true
  }
}

Все участники используют одну версию договора в поле protocol. Поле composition записывается штатно через module_update_compose.

Сначала серверная отрисовка, затем улучшения
Серверная отрисовка

Сначала серверная отрисовка, затем улучшения

После обычной отрисовки ядро находит координатор, проверяет стабильные ссылки, протокол и именованные места, выбирает ровно одного владельца и переносит готовые секции в маркеры. Браузер сразу получает содержательный HTML.

Если связь неполна, обязательная дочерняя секция отсутствует или участники неоднозначны, ядро ничего не поглощает: независимые секции остаются видимыми. Отсутствующая необязательная секция просто оставляет свободное место.

Шаблоны и Vue-HTML

Маркеры именованных мест в шаблоне

Каждое именованное место из поля slot должно присутствовать в шаблоне координатора в двух точных формах: атрибут для браузерной части и буквальный комментарий для серверного размещения.

<section data-bnx-composition-state="pending">
  <aside data-bnx-composition-slot="filters">
    <!-- bnx:composition-slot:filters -->
  </aside>
  <main data-bnx-composition-slot="listing">
    <!-- bnx:composition-slot:listing -->
  </main>
</section>

После успешного размещения ядро меняет состояние pending на mounted и убирает поглощённые секции с прежних позиций.

В v1 композиция переносит целые секции. Перенос внутреннего элемента остаётся улучшением в браузере, за которое отвечает сам модуль представления.

Как подключить готовую композицию

Пользователю достаточно подготовить основной блок и описать результат — совместимость и целостность установки проверит платформа.

01

Откройте нужную страницу

Выберите в Studio страницу, на которой должен появиться составной блок.

02

Добавьте основной блок

На странице уже должен быть раздел, которому принадлежат данные и состояние. Для каталога это витрина товаров.

03

Выберите дополнительные части

Решите, нужны ли панель фильтров и другие необязательные элементы готовой композиции.

04

Опишите желаемый результат

Попросите подключённого ИИ-помощника собрать готовую композицию на выбранной странице. Пример запроса приведён ниже.

05

Уточните основной блок

Если на странице несколько подходящих витрин, укажите, с какой из них нужно связать композицию.

06

Проверьте страницу

Откройте предпросмотр на широком и мобильном экране: данные не должны дублироваться, а все части должны занимать свои места.

Пример запроса к ИИ-помощнику

Вместо перечисления служебных команд опишите помощнику результат обычными словами:

На странице «Каталог» объедини существующую витрину товаров с панелью фильтров в композицию catalog_listing. Используй витрину как основной блок с данными, подключи необязательные части и проверь результат на настольной и мобильной ширине.

Что сделает платформа

  • сохранит витрину единственным владельцем товаров, фильтров, пагинации и адреса страницы;
  • проверит совместимость всех частей до изменения страницы;
  • добавит координатор и связанные разделы одной операцией;
  • не создаст дубликаты при повторной установке;
  • при удалении композиции сохранит основной блок с данными.

Если на странице несколько витрин, добавьте в запрос название или номер нужного раздела. Не редактируйте файл страницы вручную: тогда установка потеряет проверку целостности.

Что произойдёт в сложных случаях

Композиция устроена так, чтобы ошибка связи не скрывала полезный HTML, собранный сервером.

Ситуация
Поведение
Нет необязательной секции
Именованное место может остаться пустым
Композиция продолжает работать
Нет обязательной секции
Связь неполна
Секции остаются самостоятельными
Найдено два владельца
Выбор неоднозначен
Нужно указать parent_section_id
Повторная установка
Те же владелец и координатор
Дубликаты не создаются
Удалён координатор
Связанные дочерние секции удаляются
Владелец состояния сохраняется
Две композиции на странице
У каждой стабильные ссылки
Они не поглощают секции друг друга
Серверная логика

Нужна интеграция вместо визуального блока?

Вынесите API, доменную логику, закрытый RPC и события в изолированный Go-сервис проекта.