способы описания контрактов для ПО

description_solution.md

Быстрый способ борьбы с докуентацией кода

1. апи генерируется по коду
2. диаграммы явялются илюстрацией к коду и нужны дял онбординга, а не для приняия решения
3. Интеграции описываются в конфигурации, а не вдокуметации

или

1. Контракты описываются до их реализации , что бы упростить жизнь всем остальным
2. диагаммы это систем дизайн, а не иллюстрация к коду. sequence позволяет определить что вообще происходит с данными
3. можно испоользоовать конфиг как арт для маппинга, но все равно это происходит до начала реализации