docs: trust supplied OpenAPI snapshot

This commit is contained in:
2026-09-13 19:08:13 +03:00
parent 7bc8792b98
commit 2ef375919b
9 changed files with 91 additions and 43 deletions
+7 -6
View File
@@ -3,8 +3,9 @@
## Источник контракта
Backend генерирует OpenAPI из собственного публичного API. Frontend использует
производное описание контракта и типизированный клиент. Изменения проходят
[contract workflow](../development/runtime-openapi-verification.md).
предоставленный OpenAPI snapshot как актуальный вход и локально генерирует
типизированный клиент. Направление описано в
[OpenAPI contract flow](../development/runtime-openapi-verification.md).
API имеет prefix `/api/v1`; Swagger публикуется для локальной разработки по
environment policy, а не используется frontend в runtime.
@@ -55,10 +56,10 @@ T-Bank token failure и временная недоступность имеют
## Граница доказательства
Сравнение OpenAPI подтверждает согласованность схем, а не результат каждого
запроса. Безопасная обработка неожиданной ошибки проверяется отдельно.
Валидация, доступ, статусы и cookie требуют проверки полного HTTP-потока;
атомарность хранения — проверки с изолированной реальной базой.
OpenAPI snapshot задаёт frontend transport types, но сам по себе не доказывает
результат каждого запроса. Безопасная обработка неожиданной ошибки проверяется
отдельно. Валидация, доступ, статусы и cookie требуют проверки полного
HTTP-потока; атомарность хранения — проверки с изолированной реальной базой.
Известное ограничение сквозных проверок описано в
[проверке backend](../development/verification.md).