docs: simplify system documentation
This commit is contained in:
@@ -4,8 +4,10 @@
|
||||
|
||||
Backend генерирует OpenAPI из собственного публичного API. Frontend использует
|
||||
предоставленный OpenAPI snapshot как актуальный вход и локально генерирует
|
||||
типизированный клиент. Направление описано в
|
||||
[OpenAPI contract flow](../development/runtime-openapi-verification.md).
|
||||
типизированный клиент. Backend владеет контрактом, а подготовка и доставка
|
||||
схемы находятся вне frontend. Это разделение принято в
|
||||
[ADR 002](../adr/002-nest-generated-openapi-contract.md) и
|
||||
[ADR 014](../adr/014-trusted-openapi-input.md).
|
||||
API имеет prefix `/api/v1`; Swagger публикуется для локальной разработки по
|
||||
environment policy, а не используется frontend в runtime.
|
||||
|
||||
@@ -54,15 +56,6 @@ T-Bank token failure и временная недоступность имеют
|
||||
[Connection API](../integrations/tbank.md#состояние-и-ошибки). Raw upstream/Prisma errors
|
||||
и secrets не передаются frontend.
|
||||
|
||||
## Граница доказательства
|
||||
|
||||
OpenAPI snapshot задаёт frontend transport types, но сам по себе не доказывает
|
||||
результат каждого запроса. Безопасная обработка неожиданной ошибки проверяется
|
||||
отдельно. Валидация, доступ, статусы и cookie требуют проверки полного
|
||||
HTTP-потока; атомарность хранения — проверки с изолированной реальной базой.
|
||||
Известное ограничение сквозных проверок описано в
|
||||
[проверке backend](../development/verification.md).
|
||||
|
||||
## Наблюдаемость
|
||||
|
||||
Backend пишет структурированные JSON-события в stdout через Pino. Обработка
|
||||
|
||||
Reference in New Issue
Block a user