🗺 Карта интеграций 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. • Закрепить правило: любое изменение интеграции - сначала согласование схемы и описания, потом разработка.
📌 Итоги Один лист убирает основную неопределенность и ускоряет согласование. Роли и простые ожидания по времени возвращают предсказуемость без новых инструментов. Храним как код - карта живет, а не пылится в презентации.
