Когда документация заканчивается, системный аналитик начинает читать код

#Когда #Git-репозиториям #Системному #Иногда #AS-IS
Когда документация заканчивается, системный аналитик начинает читать код

Как восстановить архитектуру распределенной системы по Git-репозиториям, конфигурации и исходному коду Системному аналитику далеко не всегда достается система с актуальной документацией и готовыми архитектурными схемами. Иногда единственным достоверным источником информации остается то, что реально работает в production: развернутые сервисы, их конфигурация и исходный код. В этой статье на практическом примере я покажу, как восстанавливал AS-IS архитектуру существующей подсистемы: от определения фактически работающих компонентов и поиска соответствующей версии исходного кода до анализа Java Spring-приложения, его Kafka-потоков, REST-интеграций, работы с MongoDB, retry и обработки ошибок. Результатом стала архитектурная модель и диаграмма последовательности, построенные на основании фактической реализации. Статья в первую очередь рассчитана на системных аналитиков. Ее цель не в том, чтобы научить читать Java-код как разработчик, а показать практическую методику: куда смотреть в незнаком

Как восстановить архитектуру распределенной системы по Git-репозиториям, конфигурации и исходному коду

Это продолжение статьи "Разработчики знали код. Никто не знал систему".

В первой части я рассказал, как задача на развитие подсистемы уперлась в отсутствие актуального и целостного описания ее архитектуры. Документация отражала отдельные функции, специалисты знали свои компоненты, но фактический состав системы, связи между сервисами и граница между старой и новой реализацией оставались неясными. Поэтому следующим источником фактов стали Git-репозитории, конфигурация и исходный код. Ниже - методика, с помощью которой я восстанавливал реальную AS-IS архитектуру.

Определяем состав подсистемы

Похожие статьи

Российская газета
Российская газета

Как швейная фабрика в Мстиславле стала одним из индустриальных флагманов

Экономический потенциал белорусско-российского сотрудничества успешно реализуется не только на уровне промышленных гигантов и крупных административных единиц, но и раскрывается в малых районных центра...

Российская газета
RT на русском
RT на русском

В ДТП с микроавтобусом в Грузии погибли четыре гражданина Белоруссии

В Грузии в результате дорожно-транспортного происшествия погибли четыре гражданина Белоруссии, сообщает «Интерпрессньюс». Читать далее

RT на русском
Результаты первого дня групповой стадии Esports World Cup 2026 по Counter-Strike 2 Чемпионат
Чемпионат

Результаты первого дня групповой стадии Esports World Cup 2026 по Counter-Strike 2

12 августа прошёл первый день группового этапа турнира по Counter-Strike 2 в рамках Esports World Cup 2026.

Чемпионат
Аргументы и Факты
Аргументы и Факты

В Испании увидели первое за 114 лет полное солнечное затмение

Первое за более чем 100 лет полное солнечное затмение, видимое с Пиренейского полуострова, можно было наблюдать на материковой части Испании.

Аргументы и Факты
Российский бренд Tenet Plus показал в Москве яркие кроссоверы L4 и L6 iXBT.com
iXBT.com

Российский бренд Tenet Plus показал в Москве яркие кроссоверы L4 и L6

Продажи стартуют в конце августа Российский бренд Tenet Plus провёл в Москве презентацию новых кроссоверов L4 и L6. Tenet Plus был создан российским холдингом «АГР» совместно с китайской компанией Def...

iXBT.com
Чемпионат
Чемпионат

Положение сборной России в медальном зачёте ЧЕ по водным видам спорта — 2026 на 12 августа

В среду, 12 августа, в Париже продолжился чемпионат Европы по водным видам спорта — 2026.

Чемпионат