https://kkucherenkov.github.io/tags/openapi/Recent content in Openapi on Kirill's homepageHugoru<a href="https://creativecommons.org/licenses/by-nc/4.0/" target="_blank" rel="noopener">CC BY-NC 4.0</a>Sun, 27 Sep 2026 14:40:00 +0400https://kkucherenkov.github.io/posts/spec_first_monorepo/Sun, 27 Sep 2026 14:40:00 +0400https://kkucherenkov.github.io/posts/spec_first_monorepo/<p>Три моих проекта стоят на одном каркасе: <a href="https://kkucherenkov.github.io/projects/course_shelf/">Course Shelf</a>, <a href="https://kkucherenkov.github.io/projects/coriolis/">Coriolis Companion</a> и <a href="https://kkucherenkov.github.io/projects/burkmak/">burkmak</a>. В каждом бэкенд на NestJS и два клиента: SPA на Nuxt и приложение на Flutter. Все три клиента ходят в один API, и у этого API должно быть одно описание.</p> <p>Обычно описание живёт в трёх местах: в контроллере, в TypeScript-типах веба и в Dart-моделях приложения. Держится это на дисциплине. Если переименовать поле в DTO, бэкенд не соберётся, а оба клиента получат <code>undefined</code> в рантайме, и при рефакторинге такое расхождение легко пропустить.</p>