docs: simplify system documentation
This commit is contained in:
@@ -104,6 +104,20 @@ credentials не являются сохраняемым представлен
|
||||
[модель свежести](cross-cutting/data-freshness.md) отделяет это от хранения
|
||||
учётных данных.
|
||||
|
||||
## Сохранение и восстановление данных
|
||||
|
||||
Резервная копия SQLite должна быть согласованной: для работающей базы
|
||||
используется SQLite backup API с учётом WAL. Несогласованное копирование
|
||||
файлов базы и WAL не сохраняет целостный снимок. Восстановление проверяется
|
||||
на отдельной копии. Ключ шифрования подключения хранится отдельно от базы;
|
||||
его потеря делает сохранённый T-Bank token нечитаемым.
|
||||
|
||||
Откат приложения требует совместимости предыдущей версии с сохранённой
|
||||
схемой. Расширенная банковскими таблицами схема сохраняет пользователей,
|
||||
сессии и подключения. Возврат старого backup поверх новой истории удалил бы
|
||||
введённые банковские операции; откат приложения не равнозначен откату данных.
|
||||
Совместимость произвольных будущих версий этим не гарантируется.
|
||||
|
||||
## Стратегия решения и её основания
|
||||
|
||||
Локальная база и Prisma дают типизированный доступ к локальному состоянию
|
||||
@@ -137,8 +151,10 @@ access token и вращаемый refresh token. [Политика query-кэш
|
||||
и [HTTP API](http-api.md#error-contract).
|
||||
|
||||
Подтверждённая топология — локальная SPA и локальный API с файлом SQLite.
|
||||
Origin браузера, адрес API и cookie policy должны быть согласованы; условия
|
||||
и диагностика описаны в [локальном окружении](../development/local-workspace.md).
|
||||
Origin браузера, адрес API и cookie policy должны быть согласованы.
|
||||
`localhost` и `127.0.0.1` задают разные browser-границы для cookie и CORS.
|
||||
Локальный HTTP поддерживается в development-режиме backend; в остальных
|
||||
режимах refresh-cookie имеет Secure flag и требует защищённого соединения.
|
||||
Наличие локального запуска не задаёт production-топологию или гарантии SLA.
|
||||
|
||||
Кэши и лимитер T-Bank действуют на экземпляр backend. Ротация ключа шифрования
|
||||
|
||||
Reference in New Issue
Block a user