mirror of
https://github.com/gromlab-ru/slm-design.git
synced 2026-08-22 07:30:16 +03:00
84 lines
4.7 KiB
Markdown
84 lines
4.7 KiB
Markdown
|
---
|
|||
|
|
title: Runtime и lifecycle
|
|||
|
|
status: draft
|
|||
|
|
normative: true
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# Runtime и Lifecycle
|
|||
|
|
|
|||
|
|
Lifecycle является архитектурной частью любого mutable runtime, subscription и external resource. Эти правила не требуют создавать отдельный runtime или factory, если у module нет соответствующего состояния или resources.
|
|||
|
|
|
|||
|
|
## Definition, creation и activation
|
|||
|
|
|
|||
|
|
Для module с создаваемым runtime применима модель:
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
definition
|
|||
|
|
-> module объявляет creator
|
|||
|
|
|
|||
|
|
creation
|
|||
|
|
-> creator создаёт instance без external effects
|
|||
|
|
|
|||
|
|
activation
|
|||
|
|
-> scope owner запускает resources и получает cleanup
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**SLM-BASE-LIFE-001 - ЗАПРЕЩЕНО.** Module import не должен выполнять product I/O, открывать connection или регистрировать global listener.
|
|||
|
|
|
|||
|
|
**SLM-BASE-LIFE-002 - ОБЯЗАН.** Если module предоставляет factory или runtime creator, creation должна быть side-effect free относительно external resources.
|
|||
|
|
|
|||
|
|
**SLM-BASE-LIFE-003 - ОБЯЗАН.** Subscription, socket, timer и listener запускаются явной operation владельца scope.
|
|||
|
|
|
|||
|
|
**SLM-BASE-LIFE-004 - ОБЯЗАН.** Каждый запущенный resource должен иметь cleanup или dispose contract.
|
|||
|
|
|
|||
|
|
## Scope
|
|||
|
|
|
|||
|
|
| Scope | Примеры владельца |
|
|||
|
|
|---|---|
|
|||
|
|
| Application | Root composition/provider |
|
|||
|
|
| Route branch | Route layout composition |
|
|||
|
|
| Page | Page composition/provider |
|
|||
|
|
| Component flow | Nested composition module |
|
|||
|
|
| Request | Server composition/request builder |
|
|||
|
|
| Test | Test setup/wrapper |
|
|||
|
|
|
|||
|
|
**SLM-BASE-LIFE-005 - ОБЯЗАН.** Scope owner должен определить количество instances и duration каждого mutable runtime или resource.
|
|||
|
|
|
|||
|
|
**SLM-BASE-LIFE-006 - ЗАПРЕЩЕНО.** Module-level singleton не может использоваться как случайная замена application scope.
|
|||
|
|
|
|||
|
|
**SLM-BASE-LIFE-007 - МОЖЕТ.** Application singleton допустим только при явном application ownership и отсутствии request-, identity- и user-specific data.
|
|||
|
|
|
|||
|
|
## Activation и cleanup
|
|||
|
|
|
|||
|
|
**SLM-BASE-LIFE-009 - ОБЯЗАН.** Повторный mount/unmount, включая development Strict Mode, не должен оставлять duplicate subscription или abandoned resource.
|
|||
|
|
|
|||
|
|
**SLM-BASE-LIFE-010 - СЛЕДУЕТ.** `start` и cleanup следует проектировать idempotent либо явно защищать от повторного вызова.
|
|||
|
|
|
|||
|
|
**SLM-BASE-LIFE-018 - ОБЯЗАН.** Если activation составного resource set завершилась ошибкой, scope owner должен освободить уже успешно запущенную часть в обратном порядке.
|
|||
|
|
|
|||
|
|
**SLM-BASE-LIFE-019 - ОБЯЗАН.** Ошибка cleanup должна быть наблюдаемой и не должна препятствовать попытке освободить остальные resources scope.
|
|||
|
|
|
|||
|
|
## Events и sockets
|
|||
|
|
|
|||
|
|
Product event обрабатывается владельцем product semantics; socket остаётся technical transport.
|
|||
|
|
|
|||
|
|
**SLM-BASE-LIFE-011 - ЗАПРЕЩЕНО.** Framework component не может открывать product socket напрямую при render или module import.
|
|||
|
|
|
|||
|
|
**SLM-BASE-LIFE-012 - ОБЯЗАН.** Invalid event и connection failure должны преобразовываться в product state/outcome либо technical telemetry согласно их semantics; callback error нельзя терять через unobserved throw.
|
|||
|
|
|
|||
|
|
## Revalidation events
|
|||
|
|
|
|||
|
|
Event может содержать product update или только сообщать об устаревании данных.
|
|||
|
|
|
|||
|
|
**SLM-BASE-LIFE-014 - ОБЯЗАН.** Invalidation intent должен выражаться product language и не требовать import конкретной query library в public product contract.
|
|||
|
|
|
|||
|
|
## Server runtime
|
|||
|
|
|
|||
|
|
**SLM-BASE-LIFE-015 - ОБЯЗАН.** User-specific server runtime создаётся в request scope.
|
|||
|
|
|
|||
|
|
**SLM-BASE-LIFE-016 - ЗАПРЕЩЕНО.** Process singleton не может захватывать request headers, cookies, credentials, AbortSignal или user-specific cache.
|
|||
|
|
|
|||
|
|
**SLM-BASE-LIFE-017 - ОБЯЗАН.** Request cancellation должна передаваться external operations, если runtime и используемая integration поддерживают cancellation.
|
|||
|
|
|
|||
|
|
Overlay может вводить дополнительные lifecycle boundaries только внутри собственного delta.
|