slm-design/docs2/specification/layers/app.md

title, status, normative

title	status	normative
Слой App	draft	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-APP-001 - ОБЯЗАН. Route entry должен оставаться тонким adapter, нормализующим framework input и делегирующим готовому composition module.

framework route
  → composition entry

SLM-APP-002 - ЗАПРЕЩЕНО. app не может владеть product page, screen, widget, product scenario, store или application wiring.

SLM-APP-003 - ЗАПРЕЩЕНО. Route entry не должен напрямую собирать product integrations, вызывать SDK или формировать product model.

SLM-APP-004 - ОБЯЗАН. Framework-specific input должен быть считан в app и передан вниз в минимальной нормализованной форме.

Механическая нормализация включает извлечение route params, headers и framework wrappers. Product validation, создание value objects и выбор product outcome остаются у владельца product semantics.

Запрет другим SLM-слоям импортировать app определяется base-правилом SLM-ARCH-003.

SLM-APP-006 - СЛЕДУЕТ. Framework behavior, которому нужны product dependencies или product UI, следует реализовать готовым composition entry и только подключить из app.

SLM-APP-007 - МОЖЕТ. app может напрямую импортировать framework APIs и static/global resources из shared, если framework требует подключить их в root entry.

Допустимая структура

Структуру app определяет framework. SLM не требует превращать framework directories в SLM modules и не требует index.ts для route folders.

app/
├── layout.tsx
├── error.tsx
├── not-found.tsx
├── api/
└── products/
    └── [product]/
        └── page.tsx

Примеры нарушений

Следующие сущности являются примерами нарушений SLM-APP-002 и SLM-APP-003:

• ProductPage;
• product Provider;
• application service creator;
• page-local store;
• product mapper;
• reusable product component;
• concrete product integration.