Запросить разбор Покажем, где теряется архитектура
why.archivision.org

Почему архитектура должна быть моделью а не набором схем

Why ArchiVision показывает, почему зрелой ИТ-архитектуре нужен model-first подход: единая модель связывает C4, BPMN, UseCase, ERD, API, AI+MCP, документацию, ветки, visual merge, историю, подписки и аналитику в один управляемый контур.

0
Причины выбрать модель
0
Типов диаграмм
0
Источник истины
🏗️
CRM System
🔧
API Gateway
📦
Web App
📦
Mobile App
📦
Database
📦
Cache
⚙️
Auth Service
⚙️
Billing
⚙️
Notification
🗄️
User DB

Почему ArchiVision

Why ArchiVision отвечает на главный вопрос: почему архитектурная платформа должна быть не редактором схем, а рабочей моделью, вокруг которой живут диаграммы, AI, документация, ревью, история и аналитика.

i
Если диаграмма живет отдельно от модели, она быстро превращается в красивый снимок прошлого. ArchiVision связывает визуализацию с объектами, связями, атрибутами и историей изменений. Подробнее: Документация

Схемы стареют первыми

Если диаграмма живет отдельно от модели, она быстро превращается в красивый снимок прошлого. ArchiVision связывает визуализацию с объектами, связями, атрибутами и историей изменений.

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

Модель держит смысл

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

i
C4-диаграммы перестают быть набором файлов. Через них можно проваливаться в элементы, смотреть связи, атрибуты, историю, задачи и связанные обсуждения. Подробнее: Документация

C4 становится навигацией

C4-диаграммы перестают быть набором файлов. Через них можно проваливаться в элементы, смотреть связи, атрибуты, историю, задачи и связанные обсуждения.

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

BPMN не выпадает из архитектуры

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

i
AI и MCP работают поверх архитектурной модели: можно спрашивать систему, уточнять устройство ландшафта, генерировать документацию и находить пробелы в описании. Подробнее: Документация

AI знает контекст

AI и MCP работают поверх архитектурной модели: можно спрашивать систему, уточнять устройство ландшафта, генерировать документацию и находить пробелы в описании.

i
Интеграции с AI-помощниками полезны только тогда, когда у них есть структура модели, права и ограничения. Так меньше случайных правок и больше проверяемых результатов. Подробнее: Документация

MCP не меняет модель вслепую

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

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

Документация собирается из фактов

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

i
Обсуждения идут рядом с элементами архитектуры и диаграммами. Контекст решения не теряется в мессенджерах и доступен при следующем изменении. Подробнее: Документация

Чаты остаются у решения

Обсуждения идут рядом с элементами архитектуры и диаграммами. Контекст решения не теряется в мессенджерах и доступен при следующем изменении.

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

Share без полного доступа

Диаграммой можно поделиться точечно: показать нужную часть модели, не открывая весь рабочий контур и не заставляя получателя разбираться в проекте целиком.

i
Когда диаграмму нужно стабилизировать на время согласования, блокировка защищает ее от параллельных правок и снижает риск конфликтов. Подробнее: Документация

Блокировки для ревью

Когда диаграмму нужно стабилизировать на время согласования, блокировка защищает ее от параллельных правок и снижает риск конфликтов.

i
При слиянии веток добавленные, измененные и удаленные элементы подсвечиваются прямо на диаграмме. Ревью становится визуальным, а не только текстовым. Подробнее: Документация

Merge видно глазами

При слиянии веток добавленные, измененные и удаленные элементы подсвечиваются прямо на диаграмме. Ревью становится визуальным, а не только текстовым.

i
Журнал операций показывает, кто и что поменял в модели. Это помогает разбирать инциденты, восстанавливать контекст и понимать эволюцию архитектуры. Подробнее: Документация

История объясняет изменения

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

i
Ошибочную операцию можно отменить из истории. Команда быстрее экспериментирует и меньше боится точечных исправлений в модели. Подробнее: Документация

Undo снижает цену ошибки

Ошибочную операцию можно отменить из истории. Команда быстрее экспериментирует и меньше боится точечных исправлений в модели.

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

Аналитика показывает зрелость

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

i
Можно подписаться на изменения в домене или ландшафте и получать регулярные отчеты на почту без ручного мониторинга. Подробнее: Документация

Подписки держат владельцев в курсе

Можно подписаться на изменения в домене или ландшафте и получать регулярные отчеты на почту без ручного мониторинга.

i
Глобальный поиск находит элементы, связи, атрибуты, сценарии и диаграммы. Это быстрее, чем вспоминать, где именно лежит нужная схема. Подробнее: Документация

Поиск заменяет ручной обход

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

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

Интерфейсы связаны с моделью

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

i
Импорт и описание OpenAPI помогают держать интерфейсы, модель и документацию в одном контуре вместо отдельной папки со спецификациями. Подробнее: Документация

Swagger не живет отдельно

Импорт и описание OpenAPI помогают держать интерфейсы, модель и документацию в одном контуре вместо отдельной папки со спецификациями.

i
Элементы модели можно обогащать владельцами, критичностью, технологиями, статусами, ссылками и любыми полями, нужными для управления. Подробнее: Документация

Атрибуты превращают схему в данные

Элементы модели можно обогащать владельцами, критичностью, технологиями, статусами, ссылками и любыми полями, нужными для управления.

i
Изменения архитектуры связываются с задачами и договоренностями. Так понятнее, почему элемент появился, что еще нужно сделать и кто отвечает. Подробнее: Документация

Задачи замыкают контур

Изменения архитектуры связываются с задачами и договоренностями. Так понятнее, почему элемент появился, что еще нужно сделать и кто отвечает.

i
Сценарии использования описывают, как люди и системы взаимодействуют с решением. Это помогает быстрее вводить команды в предметную область. Подробнее: Документация

UseCase помогает онбордингу

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

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

ERD и Domain class дополняют C4

Данные и предметные классы описываются рядом с системной архитектурой, чтобы структура решения была полной, а не только инфраструктурной.

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

Курс ускоряет внедрение

Обновленный учебный курс помогает командам быстрее освоить методологию, договориться о правилах моделирования и начать вести архитектуру одинаково.

i
ArchiVision можно связывать с внешними системами через API: наполнять модель, синхронизировать данные и встраивать архитектурный контур в процессы компании. Подробнее: Документация

API оставляет путь к интеграциям

ArchiVision можно связывать с внешними системами через API: наполнять модель, синхронизировать данные и встраивать архитектурный контур в процессы компании.

Когда нужен model-first подход

Если схемы, документы, ревью и решения живут отдельно, команда тратит время на восстановление контекста. Эти симптомы показывают, что архитектуру пора переводить в управляемую модель.

01 Документация перестала быть живой

Схемы обновляются после факта

Диаграммы расходятся с реальностью, wiki устаревает, а новые участники узнают архитектуру через устные объяснения.

Нет единого источника истины

Один и тот же сервис описан в нескольких местах, но никто не уверен, где актуальная версия.

Документы пишутся вручную

Архитектор тратит время не на проектирование, а на перенос фактов из схем, задач и обсуждений в текст.

02 Изменения стало опасно принимать

Не видно, что поменялось

Без веток, visual merge и истории сложно понять, какие элементы добавлены, изменены или удалены.

Ревью идет по скриншотам

Команда обсуждает картинки, но не проверяет связи, атрибуты, интерфейсы и последствия для доменов.

Ошибки дорого исправлять

Когда нет истории операций и undo, даже небольшая правка становится риском для модели.

03 Архитектура стала управленческим активом

Нужна аналитика зрелости

Руководству важно видеть качество модели, развитие доменов и вклад сотрудников, а не только набор диаграмм.

Владельцам нужны уведомления

Подписки на домены и ландшафты позволяют получать отчеты на почту без ручного мониторинга.

AI должен знать контекст

AI+MCP раскрывает ценность только тогда, когда работает поверх полной модели, прав, истории и связей.

Why ArchiVision не противопоставляет себя всем инструментам. Он показывает, где заканчивается редактор схем и начинается управляемая архитектурная платформа.

Model-first vs diagram-first

Возможность
ArchiVision
PlantUML
Miro
Draw.io
Structurizr
ArchiMate
Модель как источник истины
Единая модель хранит все знания — элементы, связи, метаданные. Любое изменение автоматически отражается на всех диаграммах.

Зачем это нужно: Без единой модели диаграммы быстро расходятся с реальностью, и команды работают с устаревшей документацией.

📖 Документация
⚠️
Диаграммы хранятся как текст и хорошо версионируются, но PlantUML не ведёт единую архитектурную модель с объектами, атрибутами и жизненным циклом.
Miro силён как доска для совместной работы, комментариев и воркшопов, но не хранит семантическую архитектурную модель C4/EA.
⚠️
Draw.io поддерживает страницы, ссылки и свойства фигур, но не ведёт единый реестр архитектурных объектов между диаграммами.
Structurizr работает от модели/workspace и C4 DSL: несколько диаграмм строятся из одного описания архитектуры.
⚠️
ArchiMate-инструменты могут быть сильны в формальной модели и viewpoints, но конкретные функции зависят от продукта и редакции.
Живые интерактивные диаграммы
Интерактивные C4-диаграммы с навигацией между уровнями одним кликом. Элементы связаны с моделью.

Зачем это нужно: Классические C4-диаграммы быстро устаревают. Интерактивные диаграммы позволяют новым сотрудникам погружаться в архитектуру за минуты.

📖 Документация
⚠️
C4 возможен через C4-PlantUML, ссылки и интерактивный SVG, но это собирается как diagram-as-code, не как нативная платформенная модель.
⚠️
В Miro можно вручную связать фреймы, объекты и комментарии, но архитектурная семантика и проверки модели не являются нативной функцией.
⚠️
Draw.io поддерживает страницы, ссылки, слои и интерактивные элементы, но C4-навигация собирается вручную.
Structurizr поддерживает интерактивный просмотр C4-диаграмм и навигацию по workspace, хотя визуальное редактирование ограничено.
⚠️
ArchiMate-инструменты поддерживают views/viewpoints, но интерактивность и C4-навигация зависят от конкретного продукта.
Горячие клавиши для скорости
Полная клавиатурная навигация для быстрого создания элементов и навигации.

Зачем это нужно: Профессиональный архитектор создаёт сотни элементов в день. Горячие клавиши ускоряют работу в 3-5 раз.

📖 Документация
PlantUML редактируется как текст, поэтому скорость зависит от редактора, шаблонов и навыков работы с кодом.
⚠️
В Miro есть горячие клавиши, но они универсальные для доски, а не специализированные под архитектурную модель.
⚠️
В Draw.io есть клавиатурные операции редактора диаграмм, но нет специализированного C4/model workflow.
Structurizr DSL удобно редактировать в IDE с автодополнением, поиском и командами редактора.
⚠️
ArchiMate — язык и класс инструментов, а не один продукт. Возможности зависят от редактора: Archi, Sparx EA, BiZZdesign и других.
Встроенный чат
Чат интегрирован в контекст модели — обсуждайте решения прямо на элементах, тегайте коллег.

Зачем это нужно: Обсуждения в Slack/Telegram теряют контекст. Встроенный чат сохраняет связь между решением и элементом модели.

📖 Документация
PlantUML сам по себе не является средой совместной работы; обсуждения обычно живут в Git, wiki или issue tracker.
⚠️
Miro поддерживает комментарии, упоминания и совместную работу, но это контекст доски, не архитектурных объектов модели.
⚠️
Draw.io может работать совместно через облачные платформы, но обсуждения обычно привязаны к файлу или странице.
⚠️
Есть публикация workspace, diagram review и ADR, но обсуждения и согласования часто уходят в Git/PR или внешние инструменты.
⚠️
ArchiMate — язык и класс инструментов, а не один продукт. Возможности зависят от редактора: Archi, Sparx EA, BiZZdesign и других.
Управление версиями
Отслеживайте изменения, сравнивайте версии, откатывайтесь к предыдущим состояниям.

Зачем это нужно: Архитектура живёт и меняется. Без версионирования невозможно понять, кто и когда внёс изменение.

📖 Документация
⚠️
Версионирование обычно делается через Git для .puml-файлов. Это сильный инженерный workflow, но не нативная история архитектурной модели.
⚠️
У Miro есть история доски и права доступа, но это управление доской, а не diff/merge архитектурных объектов.
⚠️
Версии и права обычно зависят от Google Drive, OneDrive, Confluence или Git. Это уровень файла/страницы, а не архитектурной модели.
Сильная сторона Structurizr — model-as-code: Git, DSL/JSON, CLI и CI/CD. Часть lifecycle остаётся во внешнем инженерном workflow.
⚠️
ArchiMate — язык и класс инструментов, а не один продукт. Возможности зависят от редактора: Archi, Sparx EA, BiZZdesign и других.
Гибкое управление доступом
Гранулярные права к моделям, диаграммам и элементам. Роли для корпоративной работы.

Зачем это нужно: В больших компаниях разные команды видят разную информацию. Гибкое управление доступом позволяет открыть нужное и скрыть конфиденциальное.

📖 Документация
PlantUML не управляет доступом сам по себе; права задаются в Git, wiki, файловом хранилище или CI/CD.
Miro поддерживает роли, права доступа к доскам и командам. Ограничение — это права на доску, не на архитектурные объекты модели.
⚠️
Draw.io наследует доступ от хранилища или платформы: Google Drive, OneDrive, Confluence и т.п.
⚠️
Structurizr Cloud/on-prem поддерживает роли и доступ к workspace, но не является гранулярным RBAC на каждый архитектурный элемент.
⚠️
ArchiMate — язык и класс инструментов, а не один продукт. Возможности зависят от редактора: Archi, Sparx EA, BiZZdesign и других.
Контроль полноты данных
Контроль качества модели: обязательные свойства, задачи на заполнение, пустые диаграммы, объекты без связей и динамика качества по аналитике.

Зачем это нужно: Неполная модель ведёт к слепым зонам при принятии решений. Автоматическая проверка помогает владельцам доменов видеть, что нужно дозаполнить.

📖 Документация
PlantUML проверяет синтаксис диаграммы, но не полноту архитектурного описания.
Miro не знает обязательные архитектурные атрибуты без кастомных шаблонов или интеграций.
Draw.io позволяет добавить свойства к фигурам, но не проверяет полноту архитектурной модели.
⚠️
DSL валидируется структурно, но бизнес-правила полноты вроде владельца, SLA, интерфейса и статуса обычно задаются процессом команды.
⚠️
ArchiMate-инструменты могут проверять допустимость связей и viewpoints, но контроль полноты зависит от методологии и продукта.
Автогенерация документации
Документация строится из текущей модели: HTML-экспорт, экспорт диаграмм в PUML/SVG/PNG/PDF и описание элементов, связей, интерфейсов и сценариев. AI помогает готовить черновики разделов по модели, диаграммам, интерфейсам и сценариям.

Зачем это нужно: Ручное написание документации отнимает до 30% времени архитектора. Автогенерация высвобождает ресурсы для проектирования.

📖 Документация
⚠️
PlantUML генерирует диаграммы и хорошо встраивается в docs-as-code, но полноценную документацию нужно собирать внешними инструментами.
Miro экспортирует доски и фреймы, но не генерирует архитектурную документацию из модели.
Draw.io экспортирует диаграммы, но не генерирует документацию из архитектурной модели.
Structurizr поддерживает документацию/ADR и публикацию workspace из модели.
⚠️
Многие ArchiMate/EA-инструменты поддерживают отчёты и экспорт, но возможности зависят от продукта.
Интерактивное воспроизведение сценариев
Описывайте и воспроизводите UseCase сценарии прямо в модели.

Зачем это нужно: Onboarding нового разработчика в сложную систему занимает недели. Интерактивные UseCase сокращают время погружения до часов.

📖 Документация
PlantUML может описывать sequence/use-case диаграммы, но не воспроизводит сценарии интерактивно поверх модели.
Miro подходит для воркшопов и customer journey, но не воспроизводит сценарии как функцию архитектурной модели.
Draw.io позволяет нарисовать сценарий, но не имеет движка интерактивного проигрывания.
⚠️
Structurizr может описывать динамические/sequence views, но интерактивное проигрывание сценариев требует внешней реализации.
⚠️
ArchiMate включает поведенческие элементы, но интерактивное воспроизведение зависит от конкретного инструмента.

Материалы для выбора

Эти материалы помогают сравнить ArchiVision с привычными инструментами и подготовить аргументацию для команды, архитектурного комитета или руководства.

MODEL-FIRST VS DIAGRAM-FIRST
Сравнение подходов

Почему diagram-first инструменты не закрывают управление архитектурой

Miro, Draw.io, PlantUML и wiki полезны в своих задачах, но они не дают единой модели, visual merge, аналитики зрелости, подписок и AI-контекста.

СравнениеАргументы
CHOICE MAP PLATFORM FIT
Карта выбора

Где ArchiVision сильнее каталогов, схем и документационных порталов

Сводная карта показывает, почему архитектурная модель должна соединять C4, BPMN, API, ветки, права, историю, документацию и аналитику.

ПозиционированиеПлатформа

Проверьте, где теряется ваша архитектура

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

WHY