slm-design/DRAFT/architecture/validation.md

# Проверка SLM

> Граница автоматической проверки и архитектурного ревью SLM.

## Автоматическая проверка

Проект, заявляющий соответствие SLM, сопоставляет физические пути с SLM root, слоями, модулями, Groups, вложенными модулями, публичными фасетами, точками входа `app` и ресурсами `shared`. Такое сопоставление задаётся стайлгайдом или конфигурацией проверки и не изменяет нормативный смысл сущностей.

Каждое правило класса `A` должно быть реализовано проверкой проекта и блокировать её при нарушении. SLM не навязывает конкретный инструмент.

Скрипт `draft-rules.js` проверяет только целостность документов: формат и уникальность кодов, ссылки и наличие тематических упоминаний. Он не проверяет архитектуру приложения.

Актуальный список правил скрипт получает из [канонического реестра](../rules/registry.md).

## Архитектурное ревью

Правила класса `R` проверяются вручную. Статический анализ может обнаружить подозрительный код, но не способен окончательно определить:

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

## Проверка фасетов

Автоматическая проверка сопоставляет публичные пути модуля с фасетами `index`, `client`, `browser` и `server`, запрещает остальные внешние пути и проверяет их runtime-импорты и реэкспорты, включая транзитивные.

Для проверки сред инструмент различает runtime imports, type-only imports и dynamic imports. Окончательное решение о соответствии экспортируемого кода назначению фасета принимается на ревью.

На ревью проверяется:

- экспортирует ли `index` только универсальные типы и runtime-код;
- остаётся ли `client` совместимым с server prerender и browser hydration;
- достигается ли `browser` только через dynamic boundary с отключённым SSR;
- остаётся ли `server` недоступным через `index`, `client` и `browser`;
- существует ли каждый специализированный фасет ради реального потребителя;
- не дублируется ли один runtime-export между фасетами.

Название файла, директива `use client`, tree shaking или локальная проверка `typeof window` сами по себе не доказывают совместимость кода со средой выполнения.

## Проверка слоя domains

На ревью определяется:

- соответствует ли ответственность модуля предметной роли слоя `domains`;
- не разделена ли одна область на соседние модули без самостоятельных владельцев;
- не объединены ли в одном модуле несвязанные предметные области;
- остаются ли страницы, маршруты и UI нескольких предметных ответственностей в `compositions`;
- остаются ли самостоятельные технические сервисы без предметной модели в `infra`.