5.1 KiB
title, version, status, normative
| title | version | status | normative |
|---|---|---|---|
| SLM Design Specification | 0.1.0-draft | draft | true |
SLM Design Specification
Эта директория содержит единый нормативный корпус SLM Design 2.0. Base SLM является законченной минимальной архитектурой; дополнительные ограничения подключаются независимыми overlays SLM Advanced или SLM Pro.
Пока статус равен draft, документы описывают проектируемую архитектуру и не заменяют действующую документацию в old-docs/.
Нормативный язык
| Термин | Значение |
|---|---|
ОБЯЗАН |
Требование необходимо выполнить для соответствия спецификации |
ЗАПРЕЩЕНО |
Действие является нарушением спецификации |
СЛЕДУЕТ |
Рекомендуемое решение; отступление требует явного обоснования |
МОЖЕТ |
Допустимый, но необязательный вариант |
Правила имеют стабильные идентификаторы. Base использует формат SLM-BASE-AREA-NNN, Advanced - SLM-ADV-AREA-NNN, Pro - SLM-PRO-AREA-NNN. Точное нормативное требование принадлежит только той главе, где объявлен его rule ID.
Все объявления доступны в реестре правил. Для прямого перехода можно открыть поиск Ctrl/⌘ K и ввести полный rule ID.
Architecture modes
Base SLM не требует overlay. Если команда выбирает дополнительную архитектурную политику, она подключает ровно один независимый mode согласно Архитектурным modes:
SLM Advanced = SLM + Advanced rules
SLM Pro = SLM + Pro rules
Приоритет
SLM-BASE-DOC-001 - ОБЯЗАН. При конфликте между главами спецификации и любым ненормативным материалом приоритет имеет спецификация.
SLM-BASE-DOC-002 - ЗАПРЕЩЕНО. Ненормативный документ не может вводить новое обязательное правило, исключение или архитектурную границу.
SLM-BASE-DOC-003 - ОБЯЗАН. Изменение принятого архитектурного правила должно вноситься в главу, которая владеет соответствующим rule ID.
Base SLM
Основы
Слои
Общие правила
- Модули и группы
- Сегменты
- Public API и импорты
- State и data
- Runtime и lifecycle
- Тестирование и соответствие
- Монорепозитории
Overlays
SLM Advanced
SLM Pro
- Отличия Pro от base SLM
- Domains в SLM Pro
- Business
- Framework surface
- Ports и adapters
- Client и server assembly
- Cross-domain boundary
- Тестирование Pro domains
Область текущего draft
Base SLM фиксирует ownership, пять основных слоёв, public boundaries, state и lifecycle. Текущие версии Advanced и Pro в первую очередь определяют собственные независимые модели слоя domains; будущие mode-specific правила могут относиться к любому разделу архитектуры.
Точная форма React Providers, окончательная политика package extraction и единая модель query cache не фиксируются сверх явно объявленных инвариантов base или выбранного overlay.