77 lines
4.5 KiB
Markdown
77 lines
4.5 KiB
Markdown
# NODE.DC Design Guideline
|
|
|
|
Единый источник компонентов и правил интерфейса NODE.DC.
|
|
|
|
Это не архив скриншотов и не описание того, как разные приложения когда-то стилизовали одинаковый контрол. Репозиторий содержит реальные переиспользуемые пакеты, машинный реестр и живой каталог. Новые приложения должны подключать эти пакеты, выбирать тему/акцент и собирать предметный интерфейс из готовых элементов.
|
|
|
|
На том же каталоге развивается **NDC Module Foundry**: контур создания экземпляров готовых приложений из `Page Library`. Foundry не заменяет Design Guideline: он использует его как каноническую визуальную библиотеку и runtime-правило для будущих модулей.
|
|
|
|
## Что здесь является каноном
|
|
|
|
- общая геометрия приложения и верхней панели;
|
|
- glass-материал, поверхности и слои;
|
|
- кнопки, поля, чекеры, range, select и dropdown;
|
|
- модальные окна, подтверждения и боковые окна;
|
|
- segmented navigation и статусы;
|
|
- Hub header и левая admin navigation panel;
|
|
- launcher-style ApplicationShell без обязательной нижней витрины;
|
|
- единый state-controller открытия navigation/content окон;
|
|
- CMS/Launcher media field: файл, URL, превью и storage-adapter;
|
|
- Engine workflow sharing и BIM share-link modal;
|
|
- каталог form/confirmation/action/detail/history modal-паттернов;
|
|
- аудированный общий набор иконок;
|
|
- инспектор/панель настроек нового поколения;
|
|
- поведение portal-слоёв, Escape, outside click и фокуса;
|
|
- контракт темы: приложения меняют цветовую схему, а не геометрию компонентов.
|
|
|
|
## Что не является каноном
|
|
|
|
- старые инспекторы и старые плашки Engine;
|
|
- legacy dropdown/menu реализации Task Manager;
|
|
- доменная логика нод, BIM-моделей, SEO pipeline или задач;
|
|
- локальные копии компонентов внутри приложений.
|
|
|
|
## Пакеты
|
|
|
|
- `@nodedc/tokens` — JSON и CSS custom properties.
|
|
- `@nodedc/ui-core` — общие стили, тема, контраст и расчёт floating-layer.
|
|
- `@nodedc/ui-react` — React-компоненты.
|
|
- `@nodedc/ui-dom` — JS/DOM-контроллеры для BIM Viewer, CMS и других приложений без React.
|
|
- `@nodedc/ui-catalog` — живой стенд всех канонических компонентов.
|
|
|
|
## Быстрый запуск каталога
|
|
|
|
```bash
|
|
npm install
|
|
npm run dev
|
|
```
|
|
|
|
Полная проверка:
|
|
|
|
```bash
|
|
npm run check
|
|
npm run build
|
|
```
|
|
|
|
## Статус
|
|
|
|
Версия `0.5.x` — розовый NODE.DC accent, runtime MP4 stage media, workflow/BIM sharing modals и полная карта оконных паттернов. Исходные приложения на первом этапе не изменяются.
|
|
|
|
Подробности:
|
|
|
|
- [Архитектура](docs/ARCHITECTURE.md)
|
|
- [Компоненты](docs/COMPONENTS.md)
|
|
- [Шаблон приложения](docs/APPLICATION_TEMPLATE.md)
|
|
- [Иконки](docs/ICONS.md)
|
|
- [Темы](docs/THEMING.md)
|
|
- [Окна и слои](docs/WINDOWS_AND_LAYERS.md)
|
|
- [Границы исходного аудита](docs/SOURCE_BASELINE.md)
|
|
- [Правила развития](docs/GOVERNANCE.md)
|
|
- [План подключения приложений](docs/ADOPTION.md)
|
|
- [Как подключать пакеты в новый проект](docs/CONSUMPTION.md)
|
|
- [Инвентарь следующих компонентов](docs/CANDIDATES.md)
|
|
- [NDC Module Foundry](docs/MODULE_STUDIO.md)
|
|
- [Production-канон Foundry Map Page, Cesium, TileCache и AMD egress](docs/FOUNDRY_MAP_CESIUM_CANON.md)
|
|
- [Базовый MCP-контур Foundry](docs/MODULE_FOUNDRY_MCP.md)
|
|
- [Привязки Data Product к Foundry](docs/FOUNDRY_DATA_PRODUCT_BINDINGS.md)
|