🗺 Карта интеграций 1С на одном листе: контекст + интерфейсы

Чем больше систем и данных, тем сложнее удерживать целостную картину интеграций. Одна страница решает большинство проблем: видно кто с кем обменивается, зачем, как часто и как это устроено. Стандартные инструменты - Markdown, PlantUML, дисциплина.

🎯 Зачем

Быстрее согласовывать изменения: одна картинка и один список вместо длинных переписок.
Понимать влияние изменений: сразу видно какие потоки затрагиваются.
Подготовить наблюдаемость: добавить идентификатор запроса, цель сервиса и версию обмена.

🧭 Принципы

Карта должна оставаться читаемой: только ключевые системы и связи, без перегрузки деталей.
На схеме только смысл обмена и укрупненные классы данных, технические детали держим в описаниях ниже.
Владелец по роли, не по ФИО; если один для всех - укажите это в шапке, не повторяйте в каждой строке.
Частота по-человечески: каждый час, ночью, по событию.
Храним описания в вики (Confluence/Obsidian/Notion) или в GitHub - правки через PR/ревью, ссылки на регламенты рядом.

🗂 Как описывать интерфейсы без таблиц

Формат - одна строка на обмен. Если за все потоки отвечает одна роль - укажите это один раз в шапке: “Владелец по умолчанию - Поддержка 1С”.
Примеры:

1C:ERP -> Bitrix24 - контрагенты, каждый час, http.
1C:Billing -> 1C:ERP - акты, оплаты, один раз в день в 23:00, ftp.
1C:ERP -> 1C:Документооборот - контрагенты и договоры, по событию, http.
Минимум, что указываем: что передаем, откуда и куда, как идет обмен (отправляем или забираем), как часто, каким протоколом. Если владелец отличается от общего - укажите его.

🧩 Контекстная схема C4

Инструмент выбирайте любой, понятный команде: PlantUML, drawio, figma. Главное - читаемость и общий язык уровня контекста.
Как не перегружать схему:

Не перечисляйте все справочники и документы на стрелках. Подписывайте потоки укрупненно: “справочники”, “документы”, “события”.
Если потоков много - объединяйте их в одну связь и раскрывайте уровнем ниже.
Для перегруженных зон тоже делайте отдельную детализацию.
Держите легенду с условными обозначениями рядом со схемой.

🚀 С чего начать

Выписать все известные обмены и системы - без перечисления полей БД.
Нарисовать контекст с ключевыми системами и каналами, без перечисления всех справочников и документов.
Описать критичные интерфейсы по формату одной строки. Пустоты пометить TBD.
Закрепить правило: любое изменение интеграции - сначала согласование схемы и описания, потом разработка.

📌 Итоги

Один лист убирает основную неопределенность и ускоряет согласование.
Роли и простые ожидания по времени возвращают предсказуемость без новых инструментов.
Храним как код - карта живет, а не пылится в презентации.