initial commit

docs/ARCHITECTURE.md

@@ -0,0 +1,42 @@
+# Архитектурные границы
+
+Это целевое разделение; modules ещё предстоит реализовать после выбора стека.
+
+```text
+UI components / routes
+        ↓ commands                 ↑ view models
+Application use cases / lifecycle
+        ↓ ports
+Domain models / pure policies
+        ↕ adapters
+IndexedDB / XMPP WSS / crypto worker / media worker / browser APIs
+        ↕
+External XMPP + upload + TURN + maps + push gateway
+```
+
+## Каталоги реализации
+
+- `src/domain/`: модели и pure policies без UI/network.
+- `src/application/`: use cases, event reducers, account-bound operation context.
+- `src/ports/`: интерфейсы, errors, capability contracts.
+- `src/adapters/`: xmpp, storage, crypto, media, notifications.
+- `src/ui/`: tokens, primitive components, feature views, routes.
+- `src/workers/`: crypto/media off-main work.
+- `src/platform/`: browser lifecycle, permission, multi-tab coordination.
+- `services/push/`: минимальный Web Push gateway; не messaging backend и не OMEMO endpoint.
+- `infra/`: local fixtures/server/HTTPS/WSS/turn and deployment configuration.
+- `tests/`: unit, contract, integration, browser, interoperability, security, tooling.
+
+Расширения файлов/commands определяет accepted stack ADR. В карточках scope без расширения обозначает logical module stem: после ADR создаётся файл с принятым расширением, не файл без расширения.
+
+## Направления зависимостей
+
+Domain не импортирует adapters/UI. UI вызывает application commands, не Signal/session/network internals. Adapters реализуют ports. Event содержит accountId, conversationId/eventId и generation/cancellation context; поздний результат старого аккаунта отбрасывается.
+
+Durable history mutations и checkpoint — одна transaction boundary. Внешняя доставка и локальная запись не образуют общей distributed transaction: retries должны учитывать факт возможной успешной отправки.
+
+Gateway хранит только необходимые push subscription/registration metadata; encrypted message plaintext ему недоступен. CORS не обходится скрытым decrypting proxy.
+
+## Governance
+
+Любое изменение shared contract требует ADR/contract update и focused contract tests. До этого downstream owner не угадывает поля интерфейса. Интерфейсы сначала фиксируются в S01, затем implementers добавляют concrete code.