Когда в компании десять микросервисов, у каждого свой «временный» API, а документация живёт дольше только в ле

Когда в компании десять микросервисов, у каждого свой «временный» API, а документация живёт дольше только в легендах — архитектурное обсуждение обычно выглядит так:

— А где это кэшируем?
— Вроде в gateway.
— А gateway это уже система или ещё «просто прокси»?

Вот тут C4 и спасает от коллективного UX на грани нервного срыва.

Логика простая: не лезем сразу в внутренности, а раскладываем систему по уровням. Сначала границы: кто с кем говорит и зачем. Потом контейнеры: где живут API, шлюз, БД, кэш. Потом компоненты: кто за что отвечает внутри сервиса. И только потом — детали, где уже можно спорить, как именно TTL повлияет на свежесть данных и что сломается, если кэш внезапно решит уйти в отпуск.

Особенно полезно для кейсов вроде кэширования в API-шлюзе:
1) фиксируем основной сценарий;
2) отдельно описываем сбои — таймауты, устаревшие данные, cache miss;
3) документируем не в «красивой схеме на всегда», а как код, который можно обновить вместе с системой.

Итог: меньше архитектурной магии, больше общей картины. А это уже редкая роскошь в мире, где «согласовать за два дня» — почти жанр фантастики.