28 lines
1.7 KiB
Markdown
28 lines
1.7 KiB
Markdown
# 014. Актуальная OpenAPI-схема как вход frontend
|
|
|
|
**Статус:** принято 2026-09-13.
|
|
|
|
## Контекст
|
|
|
|
Frontend и backend — независимые репозитории. Зависимость frontend от путей
|
|
и команд backend связывала бы их внутреннее устройство. Предоставленная
|
|
OpenAPI-схема служит границей между владельцем API и его потребителем.
|
|
|
|
## Решение
|
|
|
|
Backend остаётся источником HTTP-контракта согласно
|
|
[ADR 002](002-nest-generated-openapi-contract.md).
|
|
Frontend принимает предоставленную OpenAPI-схему как актуальную и генерирует
|
|
из неё типы локально, без доступа к соседнему backend checkout.
|
|
Подготовка и доставка схемы находятся вне frontend.
|
|
|
|
## Последствия
|
|
|
|
Frontend зависит от публичного контракта, а не от внутреннего устройства
|
|
backend. Соответствие типов входной схеме не гарантирует её актуальность:
|
|
рассинхронизацию предоставленной схемы и работающего API frontend не выявляет
|
|
сравнением схем. Актуальность входа остаётся принятым допущением.
|
|
OpenAPI endpoint не является runtime-зависимостью SPA.
|
|
|
|
Текущее взаимодействие описано в [HTTP API](../architecture/http-api.md).
|