# Начало работы

Wiki объединяет компоненты, правила интерфейса и спецификации WB Logistics. Начните с задачи пользователя, выберите подходящий компонент и проверьте его контракт перед сборкой экрана.

## Найти компонент

В [каталоге компонентов](/components/) собраны все записи текущего inventory. Поиск открывается кнопкой в шапке или сочетанием **⌘ K / Ctrl K** и ищет по названию и тексту документации.

- **Angular** — компонент существует в локальной библиотеке. Его API описан в разделе Local component contract.
- **Figma** — компонент представлен в дизайн-каталоге; локальной Angular-реализации нет.
- **Паттерн** — правило композиции, а не отдельный Angular-компонент.

Статус описывает доступность компонента. Он сам по себе не подтверждает проверку конкретного сценария или готовность к production.

## Прочитать контракт

На странице компонента приведён его актуальный Git-документ: назначение, поведение, состояния, доступность и локальный API. Когда есть отдельный контракт сборки в Figma, он доступен по ссылке «Сборка в Figma».

Свойства в Figma и Angular описывают разные поверхности. Перед использованием прочитайте контракт соответствующей поверхности.

## Проверить пример

Живые примеры загружаются из [опубликованного Storybook](https://logisticsdesign.ru/storybook/). Можно выбрать историю или открыть полный каталог с настройками.

Опубликованный Storybook может отставать от текущих Git-спеков. Wiki не меняет его компоненты и не обещает наличие всех новых состояний в опубликованной версии.

## Собрать экран

В разделе [спецификаций](/specifications/) найдите продуктовую область, экран и связанный сценарий. Раздел Readiness отдельно описывает состояние спецификации, Figma, локального прототипа и проверок.

Используйте стандартную композицию доступных компонентов. Локальные прототипы работают на fixtures; их наличие не подтверждает интеграцию с production.

## Обновить документацию

Источники Wiki — актуальные документы `specs/ux` и `specs/ux/components/inventory.json` в Git. Правки проходят через Team Workflow. После сборки и публикации Wiki изменения появятся на сайте.

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

## Тема Wiki

Кнопка с луной или солнцем справа в шапке переключает светлую и тёмную темы.
До первого переключения Wiki следует системной теме. Выбор сохраняется в этом
браузере и применяется на всех страницах до показа содержимого. Если браузер
блокирует локальное хранилище, переключение работает в пределах текущей страницы.
Примеры из опубликованного Storybook используют собственное оформление.