1.7 KiB
014. Актуальная OpenAPI-схема как вход frontend
Статус: принято 2026-09-13.
Контекст
Frontend и backend — независимые репозитории. Зависимость frontend от путей и команд backend связывала бы их внутреннее устройство. Предоставленная OpenAPI-схема служит границей между владельцем API и его потребителем.
Решение
Backend остаётся источником HTTP-контракта согласно ADR 002. Frontend принимает предоставленную OpenAPI-схему как актуальную и генерирует из неё типы локально, без доступа к соседнему backend checkout. Подготовка и доставка схемы находятся вне frontend.
Последствия
Frontend зависит от публичного контракта, а не от внутреннего устройства backend. Соответствие типов входной схеме не гарантирует её актуальность: рассинхронизацию предоставленной схемы и работающего API frontend не выявляет сравнением схем. Актуальность входа остаётся принятым допущением. OpenAPI endpoint не является runtime-зависимостью SPA.
Текущее взаимодействие описано в HTTP API.