4.9 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, документы описывают проектируемую архитектуру и не заменяют действующую документацию в docs/.
Нормативный язык
| Термин | Значение |
|---|---|
ОБЯЗАН |
Требование необходимо выполнить для соответствия спецификации |
ЗАПРЕЩЕНО |
Действие является нарушением спецификации |
СЛЕДУЕТ |
Рекомендуемое решение; отступление требует явного обоснования |
МОЖЕТ |
Допустимый, но необязательный вариант |
Правила имеют стабильные идентификаторы. Base использует формат SLM-AREA-NNN, Advanced - SLM-ADV-AREA-NNN, Pro - SLM-PRO-AREA-NNN. Точное нормативное требование принадлежит только той главе, где объявлен его rule ID.
Architecture modes
Base SLM не требует overlay. Если команда выбирает дополнительную архитектурную политику, она подключает ровно один независимый mode согласно Архитектурным modes:
SLM Advanced = SLM + Advanced rules
SLM Pro = SLM + Pro rules
Приоритет
SLM-DOC-001 - ОБЯЗАН. При конфликте между главами спецификации и любым ненормативным материалом приоритет имеет спецификация.
SLM-DOC-002 - ЗАПРЕЩЕНО. Ненормативный документ не может вводить новое обязательное правило, исключение или архитектурную границу.
SLM-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.