feat: Добавить VitePress

docs/ru/specification/layers/app.md

@@ -0,0 +1,70 @@
+---
+title: Слой App
+status: draft
+normative: true
+---
+
+# Слой App
+
+`app` является boundary между framework routing/runtime и SLM-модулями приложения.
+
+## Ответственность
+
+`app` может содержать:
+
+- route files;
+- framework layout/error/loading/not-found entries;
+- framework metadata и route parameters;
+- bootstrap imports;
+- подключение global styles/assets;
+- framework-required middleware и handlers.
+
+## Правила
+
+**SLM-BASE-APP-001 - ОБЯЗАН.** Route entry должен оставаться тонким adapter, нормализующим framework input и делегирующим готовому composition module.
+
+```text
+framework route
+  → composition entry
+```
+
+**SLM-BASE-APP-002 - ЗАПРЕЩЕНО.** `app` не может владеть product page, screen, widget, product scenario, store или application wiring.
+
+**SLM-BASE-APP-003 - ЗАПРЕЩЕНО.** Route entry не должен напрямую собирать product integrations, вызывать SDK или формировать product model.
+
+**SLM-BASE-APP-004 - ОБЯЗАН.** Framework-specific input должен быть считан в `app` и передан вниз в минимальной нормализованной форме.
+
+Механическая нормализация включает извлечение route params, headers и framework wrappers. Product validation, создание value objects и выбор product outcome остаются у владельца product semantics.
+
+Запрет другим SLM-слоям импортировать `app` определяется base-правилом `SLM-BASE-ARCH-003`.
+
+**SLM-BASE-APP-006 - СЛЕДУЕТ.** Framework behavior, которому нужны product dependencies или product UI, следует реализовать готовым composition entry и только подключить из `app`.
+
+**SLM-BASE-APP-007 - МОЖЕТ.** `app` может напрямую импортировать framework APIs и static/global resources из `shared`, если framework требует подключить их в root entry.
+
+## Допустимая структура
+
+Структуру `app` определяет framework. SLM не требует превращать framework directories в SLM modules и не требует `index.ts` для route folders.
+
+```text
+app/
+├── layout.tsx
+├── error.tsx
+├── not-found.tsx
+├── api/
+└── products/
+    └── [product]/
+        └── page.tsx
+```
+
+## Примеры нарушений
+
+Следующие сущности являются примерами нарушений `SLM-BASE-APP-002` и `SLM-BASE-APP-003`:
+
+- `ProductPage`;
+- product Provider;
+- application service creator;
+- page-local store;
+- product mapper;
+- reusable product component;
+- concrete product integration.

docs/ru/specification/layers/compositions.md

@@ -0,0 +1,85 @@
+---
+title: Слой Compositions
+status: draft
+normative: true
+---
+
+# Слой Compositions
+
+`compositions` собирает application flows из module public APIs, technical capabilities и UI modules и может владеть product logic в пределах своей ответственности.
+
+## Ответственность
+
+Composition может быть:
+
+- page;
+- route composition entry;
+- layout;
+- screen;
+- widget;
+- provider composition;
+- multi-module hook;
+- non-visual application wiring owner.
+
+Структура слоя свободна и отражает продуктовую навигацию приложения.
+
+```text
+compositions/
+├── pages/
+├── layouts/
+├── screens/
+├── widgets/
+└── providers/
+```
+
+Эти папки являются groups, а не отдельными слоями.
+
+## Product ownership
+
+**SLM-BASE-CMP-001 - ОБЯЗАН.** Product flow и его локальная product logic должны принадлежать минимальной composition, охватывающей всех consumers этой ответственности.
+
+Composition может использовать public API `infra` для external operations, сохраняя product mapping, outcomes и fallback semantics у себя.
+
+## Public boundaries
+
+**SLM-BASE-CMP-005 - ЗАПРЕЩЕНО.** Composition не может импортировать private services, integrations, stores, Context или другие internal paths используемого module.
+
+## Product UI
+
+**SLM-BASE-CMP-006 - ОБЯЗАН.** UI, объединяющий несколько самостоятельных modules, route/page scope либо application flow, принадлежит `compositions`.
+
+Примеры:
+
+- application header;
+- order flow, объединяющий несколько product responsibilities;
+- page screen;
+- route guard с navigation outcome;
+- widget, использующий public APIs двух самостоятельных modules.
+
+**SLM-BASE-CMP-007 - МОЖЕТ.** Composition может использовать product UI, опубликованный другими modules, и universal UI, передавая props, callbacks и slots.
+
+## State
+
+**SLM-BASE-CMP-008 - ОБЯЗАН.** Page-local presentation state принадлежит минимальной composition, охватывающей всех его consumers.
+
+Примеры page-local state:
+
+- открытие sidebar;
+- активная вкладка;
+- route-local wizard step;
+- presentation filters;
+- состояние раскрытия section.
+
+**SLM-BASE-CMP-009 - ЗАПРЕЩЕНО.** Page store не может становиться параллельным владельцем product model или canonical product cache другого owner.
+
+## Imports
+
+**SLM-BASE-CMP-010 - МОЖЕТ.** Composition module может импортировать public API других composition modules, infra, ui и shared.
+
+Runtime-циклы между composition modules запрещены base-правилом `SLM-BASE-API-016`.
+
+**SLM-BASE-CMP-015 - ОБЯЗАН.** Client и server composition entries должны иметь раздельные public entrypoints и environment markers, если composition участвует в обоих runtime graphs.
+
+## Scope
+
+Composition может владеть application, route, page, request или test scope. Выбор scope должен следовать правилам [runtime и lifecycle](../runtime-and-lifecycle.md).

docs/ru/specification/layers/index.md

@@ -0,0 +1,44 @@
+---
+title: Слои
+status: draft
+normative: true
+---
+
+# Слои
+
+Слой определяет вид ответственности, допустимые зависимости и типы modules внутри верхнеуровневой папки `src`.
+
+## Матрица ответственности
+
+| Слой | Владеет | Не владеет |
+|---|---|---|
+| [`app`](./app.md) | Framework routes, bootstrap, глобальные framework boundaries | Product UI, product logic, page state, application wiring |
+| [`compositions`](./compositions.md) | Pages, layouts, screens, widgets, product flows, application wiring и scope | Universal UI primitives, technical transports |
+| [`infra`](./infra.md) | Technical services, transports, platform integrations | Product semantics и application wiring |
+| [`ui`](./ui.md) | Product-agnostic UI modules | Product scenarios и data sources |
+| [`shared`](./shared.md) | Детерминированные общие resources | Runtime state, I/O и product knowledge |
+
+## Общие правила
+
+**SLM-BASE-LAY-001 - ОБЯЗАН.** Module должен располагаться в слое, который владеет его основной ответственностью.
+
+**SLM-BASE-LAY-002 - ЗАПРЕЩЕНО.** Нельзя выбирать слой по техническому типу файла без определения владельца поведения и данных.
+
+**SLM-BASE-LAY-003 - ОБЯЗАН.** Межслойный import должен одновременно соответствовать общей dependency direction и public API импортируемого module.
+
+**SLM-BASE-LAY-004 - ЗАПРЕЩЕНО.** Нельзя создавать proxy module в разрешённом слое только для обхода запрещённого направления import.
+
+**SLM-BASE-LAY-005 - СЛЕДУЕТ.** При смешанной ответственности module следует разделить по реальным владельцам. Application flow и UI нескольких самостоятельных modules следует собирать в `compositions`.
+
+## Выбор слоя
+
+| Вопрос | Слой |
+|---|---|
+| Код существует только из-за framework route/bootstrap? | `app` |
+| Код собирает page, route или несколько самостоятельных modules? | `compositions` |
+| Код выражает product flow или product responsibility без owner, введённого overlay? | `compositions` |
+| Код предоставляет technical capability приложения? | `infra` |
+| Компонент не содержит product semantics и scenario? | `ui` |
+| Код детерминирован, не знает продукт и не имеет runtime state? | `shared` |
+
+Overlay может добавлять собственный слой и изменять ownership только в явно объявленном delta.

docs/ru/specification/layers/infra.md

@@ -0,0 +1,53 @@
+---
+title: Слой Infra
+status: draft
+normative: true
+---
+
+# Слой Infra
+
+`infra` содержит technical capabilities приложения, не определяющие product model и scenarios.
+
+## Примеры modules
+
+```text
+infra/
+├── http/
+├── backend-api/
+├── realtime/
+├── analytics/
+├── logger/
+├── app-config/
+├── storage/
+├── i18n/
+└── theme/
+```
+
+## Правила
+
+**SLM-BASE-INF-001 - ОБЯЗАН.** Infra module должен описывать technical capability, а не product semantics или scenario.
+
+**SLM-BASE-INF-002 - МОЖЕТ.** Infra module может импортировать public API другого infra module и `shared`.
+
+Запрет infra импортировать `compositions` или `app` определяется base-правилом `SLM-BASE-ARCH-003`.
+
+**SLM-BASE-INF-004 - ЗАПРЕЩЕНО.** Infra не может владеть product wiring, собирать application graph или предоставлять generic product service locator.
+
+**SLM-BASE-INF-005 - ЗАПРЕЩЕНО.** Infra не создаёт product errors, product fallback и product model из transport DTO.
+
+**SLM-BASE-INF-006 - МОЖЕТ.** Infra может экспортировать technical client, transport, event source, storage primitive или platform wrapper через собственный public API.
+
+**SLM-BASE-INF-007 - ОБЯЗАН.** Generated SDK и transport details должны оставаться внутри technical или private integration boundary владельца и не становиться частью public product contract.
+
+## Product integration
+
+Infra знает technical mechanism:
+
+```text
+HTTP client
+WebSocket transport
+local storage primitive
+analytics SDK
+```
+
+Product owner определяет semantics использования capability; infra предоставляет механизм через public API. Один infra module может использоваться несколькими product owners без знания их semantics.

docs/ru/specification/layers/shared.md

@@ -0,0 +1,42 @@
+---
+title: Слой Shared
+status: draft
+normative: true
+---
+
+# Слой Shared
+
+`shared` является детерминированным фундаментом приложения и не знает о SLM-модулях верхних слоёв.
+
+## Допустимое содержимое
+
+- pure utilities;
+- value predicates;
+- product-agnostic types;
+- styling foundation и tokens;
+- static resources;
+- compile-time constants без product ownership;
+- deterministic formatting primitives.
+
+## Правила
+
+**SLM-BASE-SHR-001 - ОБЯЗАН.** Результат shared utility должен определяться явными аргументами и не зависеть от скрытого runtime environment.
+
+**SLM-BASE-SHR-002 - ЗАПРЕЩЕНО.** `shared` не может импортировать `app`, `compositions`, `infra` или `ui`.
+
+**SLM-BASE-SHR-003 - ЗАПРЕЩЕНО.** `shared` не может владеть product types, product rules, runtime state, I/O, storage access или event subscriptions.
+
+**SLM-BASE-SHR-004 - ЗАПРЕЩЕНО.** Нельзя переносить product helper, DTO, integration contract или product config в `shared` для обхода import boundary.
+
+**SLM-BASE-SHR-005 - СЛЕДУЕТ.** Код следует поднимать в `shared` только при подтверждённой product-agnostic semantics, а не из-за повторения нескольких строк.
+
+## Отличие от других слоёв
+
+| Код | Владелец |
+|---|---|
+| Email validator с product rules | Владеющий product module |
+| Generic string trim utility | `shared` |
+| Browser storage wrapper | `infra` |
+| Product storage integration | Product owner; storage primitive - `infra` |
+| UI spacing tokens | `shared` |
+| Button consuming spacing tokens | `ui` |

docs/ru/specification/layers/ui.md

@@ -0,0 +1,48 @@
+---
+title: Слой UI
+status: draft
+normative: true
+---
+
+# Слой UI
+
+`ui` содержит reusable presentation modules без product scenario и product ownership.
+
+## Примеры
+
+```text
+ui/
+├── button/
+├── input/
+├── icon/
+├── modal/
+├── carousel/
+├── tabs/
+└── tooltip/
+```
+
+## Правила
+
+**SLM-BASE-UI-001 - ОБЯЗАН.** UI module должен быть применим без product-specific knowledge.
+
+**SLM-BASE-UI-002 - ЗАПРЕЩЕНО.** UI module не может импортировать `compositions`, `app` или product-specific infra.
+
+**SLM-BASE-UI-003 - МОЖЕТ.** UI module может импортировать public API других UI modules и `shared`.
+
+**SLM-BASE-UI-004 - ЗАПРЕЩЕНО.** UI module не выбирает product data source, не вызывает product scenario и не владеет multi-module behavior.
+
+**SLM-BASE-UI-005 - МОЖЕТ.** UI module может владеть локальным interaction state, необходимым только для собственной presentation mechanics.
+
+**SLM-BASE-UI-006 - ОБЯЗАН.** Компонент с product semantics должен принадлежать владеющему product module, а не `ui`.
+
+## Классификация
+
+| Сущность | Владелец |
+|---|---|
+| `Button`, `Input`, `Modal` | `ui` |
+| `LoginForm` одной auth responsibility | Владеющий product module |
+| Application header | `compositions` |
+| Generic date picker | `ui` |
+| Medication schedule | Владеющий product module согласно ownership |
+
+Универсальность определяется отсутствием product knowledge, а не количеством текущих consumers.