slm-design/DRAFT/level-1/segments.md

Сегменты Level 1

Пояснение нормативной модели сегментов Level 1.

Сегмент организует внутреннее содержимое модуля. Level 1 определяет роль сегмента, но не задаёт обязательный список имён.

Связанное правило

• SLM-L1-SEGMENT-R008
• SLM-L1-MODULE-A004

Файловая форма

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

Файлы и компоненты сегмента принадлежат родительскому модулю. Вложенный модуль внутри сегмента сохраняет собственные ответственность, публичный API и узел графа зависимостей.

Пример

landing/                  # Модуль
└── ui/                   # Сегмент модуля
    └── hero/             # Каталог компонента
        ├── hero.tsx
        ├── styles/       # Вспомогательный каталог компонента
        └── types/        # Вспомогательный каталог компонента

styles/ и types/ внутри каталога компонента не обязаны считаться сегментами SLM. Их форму определяет стайлгайд компонентов.