77 lines
4.5 KiB
Markdown
77 lines
4.5 KiB
Markdown
# Подключение приложений
|
||
|
||
## Текущее состояние
|
||
|
||
Первый этап не меняет существующие приложения. Репозиторий фиксирует baseline и создаёт пакетный контракт. Это позволяет продолжать текущую разработку без одномоментной переделки Engine, Ops, BIM, CMS, SEO и Launcher.
|
||
|
||
## Рекомендуемый порядок
|
||
|
||
### 1. Catalog validation
|
||
|
||
Сначала компоненты проверяются как самостоятельная система в dark/light и нескольких accent. До этого они не объявляются заменой production-кода.
|
||
|
||
### 2. Launcher/Hub pilot
|
||
|
||
Первый consumer — Launcher/Hub как основной visual reference. Подключение выполняется по одному вертикальному набору:
|
||
|
||
- tokens/theme;
|
||
- Button/IconButton;
|
||
- Dropdown/Select;
|
||
- Window/Confirmation;
|
||
- AppHeader.
|
||
- ApplicationShell/ApplicationPanel;
|
||
- useApplicationWorkspace;
|
||
- Icon/IconButton.
|
||
|
||
Локальные реализации удаляются только после функционального и визуального сравнения.
|
||
|
||
### 3. CMS и SEO
|
||
|
||
Используют те же компоненты и механику окон. CMS подключает DOM-layer, SEO — React-layer. Первым общим admin pattern подключается `MediaSourceField`/`createMediaSourceController`; storage API остаётся в приложении. Цветовые различия оформляются theme overrides.
|
||
|
||
### 4. Engine
|
||
|
||
Сначала библиотека заменяет компоненты только в уже новом Environment Settings и NDC Agent Inspector. Затем остальные инспекторы переводятся на Inspector/ControlRow постепенно. Legacy UI не переносится в библиотеку и не используется как reference.
|
||
|
||
### 5. Task Manager / Ops
|
||
|
||
Подключение начинается с floating-layer и modal primitives, где уже сформулирован канон. Массовая замена Plane UI не выполняется одним изменением.
|
||
|
||
### 6. BIM Viewer
|
||
|
||
Подключает tokens/styles и `@nodedc/ui-dom`. React в BIM ради дизайн-системы не добавляется.
|
||
|
||
## Новые приложения
|
||
|
||
Новый React-проект начинает с `ApplicationShell`:
|
||
|
||
- установить опубликованные NODE.DC UI packages;
|
||
- выбрать theme и accent;
|
||
- передать фиксированный AppHeader, stage, navigation и content;
|
||
- управлять shell через `useApplicationWorkspace`, а не набор локально связанных boolean;
|
||
- передавать storage/upload в `MediaSourceField` как adapter callback;
|
||
- использовать Window/Dropdown и канонический Icon вместо локальных реализаций;
|
||
- проверять registry перед созданием локального control;
|
||
- хранить доменные компоненты у себя.
|
||
|
||
Нижняя service rail добавляется только продуктам с витриной сервисов. В обычном оконном приложении она отсутствует.
|
||
|
||
## Adoption matrix
|
||
|
||
| Приложение | Текущий источник | Целевой adapter | Первый набор |
|
||
| --- | --- | --- | --- |
|
||
| Launcher/Hub | React/local shared | React | header, button, dropdown, window |
|
||
| SEO | React/local overrides | React | theme, window, field, select |
|
||
| CMS | Vanilla DOM | DOM | theme, header, modal, select |
|
||
| Engine | React/mixed generations | React | new inspector and environment settings only |
|
||
| Ops | React/Plane packages | React | floating behavior and modal primitives |
|
||
| BIM Viewer | Vanilla JS | DOM | tokens, glass select, settings surfaces |
|
||
|
||
## Не делать
|
||
|
||
- не переписывать все приложения одновременно;
|
||
- не копировать `packages/ui-react/src` в consumer;
|
||
- не поддерживать отдельную тему путём fork компонента;
|
||
- не использовать legacy Engine inspector как промежуточный канон;
|
||
- не удалять production local component до проверки package replacement.
|