Инженерная лаборатория «Микрофабрика» применила методологию C4 и инструмент Structurizr для борьбы с техническим долгом, возникающим при написании кода с помощью ИИ. Использование нейросетей ускоряет разработку, но приводит к дублированию функций, нарушению инкапсуляции и потере архитектурной целостности проекта.
Модель C4 предлагает четыре уровня абстракции: контекст системы, контейнеры, компоненты и код. Такой подход позволяет разработчикам удерживать фокус на конкретном уровне системы, не пытаясь охватить все связи сразу. Это дает ИИ-агентам и людям единое представление о структуре проекта.
Structurizr разделяет семантику и визуальное расположение блоков. Описание элементов хранится в текстовом файле workspace.dsl, который удобно версионировать в Git, а координаты блоков — в файле workspace.json. Это исключает появление «мусора» в diff и сохраняет ручную настройку диаграмм.
Команда использует Structurizr в Docker для просмотра интерактивных диаграмм в браузере с возможностью навигации между уровнями. От генерации статических файлов вроде PNG или SVG разработчики отказались в пользу «живых» схем, которые обновляются при каждом сохранении файла с описанием.
Применение этого метода в проекте «Трафаретка» позволило команде визуализировать текущее состояние системы. Понимание архитектурных границ помогло выявить проблемные участки, благодаря чему рефакторинг занял один вечер вместо запланированной недели.
