docs: reorganize system knowledge by domain
This commit is contained in:
@@ -3,7 +3,8 @@
|
||||
WealthLedger поставляется как локальное приложение: frontend работает
|
||||
в браузере, backend обслуживает API и обращается к SQLite и внешним источникам.
|
||||
Это описание предпосылок и ограничений работы, без привязки к устройству
|
||||
исходного кода. Production-развёртывание в текущую поставку не входит.
|
||||
исходного кода. Описано локальное окружение; production-топология по нему
|
||||
не подтверждается.
|
||||
|
||||
## Подготовка backend
|
||||
|
||||
@@ -16,7 +17,7 @@ WealthLedger поставляется как локальное приложен
|
||||
| Порт API | По умолчанию 3000 |
|
||||
| Секрет подписи сессий | Секрет не короче 32 символов; отличается от ключа шифрования подключения |
|
||||
| Ключ шифрования подключения | 32 байта в base64; требуется для чтения сохранённого T-Bank token |
|
||||
| Параметры интеграции | Адрес T-Bank, лимит запросов и при необходимости доверенный CA; [ограничения](../features/tbank-connection.md#конфигурация-и-ограничения) |
|
||||
| Параметры интеграции | Адрес T-Bank, лимит запросов и при необходимости доверенный CA; [ограничения](../integrations/tbank.md#конфигурация-и-ограничения) |
|
||||
|
||||
T-Bank token вводится пользователем через интерфейс после входа и не является
|
||||
общим параметром окружения. Существующая база и её ключ шифрования сохраняются
|
||||
@@ -24,11 +25,11 @@ T-Bank token вводится пользователем через интерф
|
||||
на отдельной копии. Потеря или замена ключа не является безвредным сбросом:
|
||||
прежнее подключение нельзя расшифровать новым ключом.
|
||||
|
||||
**Известное ограничение:** проверка новой временной SQLite-базы 12 сентября
|
||||
2026 года под Node 22 воспроизвела `Schema engine error` до создания схемы.
|
||||
Полный первый запуск на чистой базе пока не подтверждён; пользовательская база
|
||||
в этой проверке не использовалась. Условия пересмотра —
|
||||
[проверка backend](backend-workflow.md#локальная-проверка).
|
||||
**Известное ограничение:** ранее была зафиксирована ошибка `Schema engine error`
|
||||
на новой временной SQLite-базе до создания схемы. Условия проверки и пересмотра —
|
||||
в [ограничении сквозной проверки](verification.md#известное-ограничение-сквозной-проверки).
|
||||
Пользовательская база для такого воспроизведения не нужна; полный первый запуск
|
||||
на чистой базе этим свидетельством не подтверждён.
|
||||
|
||||
В development доступна [локальная Swagger UI](http://localhost:3000/api/docs)
|
||||
при стандартном порте API. Она показывает контракт, но не доказывает доступность
|
||||
@@ -43,7 +44,7 @@ backend — с origin браузера. Смена порта требует с
|
||||
|
||||
Локальный HTTP предполагает development-режим backend: в других режимах
|
||||
refresh-cookie получает Secure flag и требует защищённого соединения.
|
||||
Поведение сессии описано в [Authentication](../features/authentication.md).
|
||||
Поведение сессии описано в [Authentication](../domains/authentication/overview.md).
|
||||
|
||||
## Первый сценарий
|
||||
|
||||
@@ -79,6 +80,6 @@ HTTP-запросы связываются с безопасными журна
|
||||
## Проверка первого изменения
|
||||
|
||||
Успешная сборка, запуск и прохождение сценария — разные доказательства.
|
||||
Границы проверки описаны для [frontend](frontend-workflow.md),
|
||||
[backend](backend-workflow.md) и [HTTP-контракта](runtime-openapi-verification.md).
|
||||
Границы [проверок системы](verification.md) и
|
||||
[HTTP-контракта](runtime-openapi-verification.md) рассматриваются отдельно.
|
||||
Завершённость результата учитывает фактические проверки и остающиеся ограничения.
|
||||
|
||||
Reference in New Issue
Block a user