# 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).