Забавный плагин к VSCode для визуализации json
https://marketplace.visualstudio.com/items?itemName=AykutSarac.jsoncrack-vscode
https://jsoncrack.com/
До XMLSpy ему, конечно, как до луны, но выглядит симпатично, когда нужно осознать структуру JSON-документа может быть полезно
#инструменты #json #vscode

На днях обнаружил, что неправильно трактовал понятие Application Interface в нотации Archimate. Я как-то по инерции (и пиктограмма это поддерживала) думал, что это примерно то же самое, что и Interface в UML или SysML. Однако внимательное изучение определения показало, что это понятие ближе к понятию Port из UML или SysML.

Archimate: An application interface represents a point of access where application services are made available to a user, another application component, or a node.

Сходство с портом подчеркивается отношением composition, которое принято использовать, чтобы показать, что интерфейс (точка контакта) - это часть приложения.

SysML: Ports are points at which external entities can connect to and interact with a block in different or more limited ways than
connecting directly to the block itself.

UML: port is a structural feature of a classifier and specifies a kind of gate that represents an opening between the environment in which the classifier is embedded and the interior of the classifier.

Т.е. в SysML/UML точка контакта приложения/класса/блока с внешним миром обозначается портом, а интерфейс описывает протокол взаимодействия с этой точкой (точнее даже, между двумя точками/портами - на одной указываем, что интерфейс provided, а на другой, что он required).
Но вот в Archimate есть элемент Interface, который точка контакта, причем, судя по Cookbook, он обозначает только тот порт, который Provide какой-то интерфейс/сервис, но вот элемента, обозначающего программный интерфейс в смысле "контракт, протокол, правила взаимодействия", похоже, что нет☹️
Т.е. я не понимаю как корректно выразить утверждение, что два сервиса реализуют один и тот же интерфейс в смысле "контракт", а другой сервис этот контракт потребляет. Ведь интерфейсы в смысле "точки контакта" у них объективно разные. Может показаться, что Application Service - хороший кандидат на такую роль. Но мне кажется, это более абстрактная сущность. Сервис может быть, например, управление информацией о заказах, к нему может прилагаться несколько интерфейсов - REST, асинхронные команды через кафку и GRPC. И в каждом интерфейсе будет своя спецификация.
🤔 Коллеги, что думаете?

#archimate

Запоздалая картинка для иллюстрации

Один из важнейших принципов, который позволяет снизить темпы нарастания сложности, это принцип неразрастания кодовой базы без необходимости, который еще принято формулировать как YAGNI («You aren't gonna need it»).

👉Каждый кусок кода, любая запрограммированная функциональность кроме потенциальной пользы несет в себе безусловный вред, выражающийся в необходимости этот код где-то хранить, тратить энергию на его анализ и сборку, тестировать и учитывать при последующих изменениях. Хорошо, если польза от этого кода не потенциальная, а действительная - т.е. он реально приносит кому-то пользу, повышает ценность, уменьшает чьи-то затраты или повышает удовлетворенность.

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

Тут, конечно, есть определенное лукавство 😳. Всегда есть вероятность, что придет потенциальный заказчик с каким-то запросом и, если нужного функционала у нас нет, то он уйдет к другим, а мы так и будем сидеть. Поэтому некоторые команды стараются наращивать функционал продуктов и платформ "на всякий случай", чтобы было что показать потенциальным клиентам. Ловушка в том, что, делая абстрактный функционал, вероятность сделать то, что будет востребовано реальными заказчиками, минимальна, как бы грустно ни было это осознавать. Даже если на первый взгляд покажется, что это прямо то что нужно, в реальности приходится долго и нудно все переделывать (а это гораздо сложнее, чем делать начисто)

Что же делать? Общего решения, как всегда нет, но есть несколько стратегий, которые позволяют хоть как-то двигаться, а не сидеть и ждать.
- Демонстрационная реализация. Совершенно не обязательно делать потенциальный функционал в production ready качестве, чтобы только его продемонстрировать и продать. Такая демонстрационная реализация имеет единственную цель - показать наличие функционала и найти потенциальных покупателей. После продажи его все равно придется переделывать, так давайте хотя бы не будем на него тратить сильно много времени и сил, не так жалко будет выкинуть. Так мы сильно улучшаем отношение польза/вред, но надо понимать, что в этом подходе мы разрабатываем не функционал продукта, а инструмент продаж, и требования (НФТ) к такого рода реализации будут другими.
- Развитие продукта вслед за продажами/проектами. Делать функционал не сразу, а по мере появления клиентов, которые будут им пользоваться, набивать шишки и развивать. Так мы при разработке приносим не только вред, но и пользу.

❗️P.S. Не надо думать, что "демонстрационная" реализация чем-то хуже чем "настоящая". Это не менее важная часть процесса разработки продукта, просто это немного другой продукт и у него другие пользователи.

Коллеги, 20-21 апреля, в выходные дни, планирую выступить на онлайн-конференции «Systems Design» по проектированию ИТ-систем с докладом «Роль аналитика в создании информационных систем».

🔺Какой формат конференции?
В первый день Вас будут ждать 3 секции докладов:
— Enterprise Solution Architecture & Design
— Software Architecture & Design
— Data Engineering

Сейчас уже собрано 13 докладов от ведущих экспертов в разработке, проектировании, анализе и архитектуре.

Во второй день будут организованы воркшопы, где Вы сможете освоить новые методики и сразу же отработать их на практике.

🔺Кому конференция будет особенно полезна?
— Разработчикам
— Архитекторам
— Системным аналитикам
— ИТ-специалистам, которые интересуются вопросами проектирования

Более подробно про конференцию, воркшопы и доклады Вы можете узнать в отдельном TG-канале и на сайте.

Присоединяйтесь, чтобы не пропускать важную информацию!

В прошедшую субботу выступил на конференции «Systems Design»
📎презентация во вложении

Большое спасибо организаторам за приглашение и возможность выступить.
Попытался краешком зацепить кусочек большого айсберга про моделирование и декомпозицию окружающей действительности. В докладе практически ничего не было про архитектуру, скорее про подготовительные мероприятия. Архитектура - это способ решения некоторой задачи, и часто вижу, что у многих есть склонность приступать к решению задачи без формулировки исходных условий. Это как если бы в школьной задаче по физике мы услышали несколько слов и чисел и, не вникая в то, откуда они взялись, как связаны с реальностью, кинулись бы подставлять их в формулы и получать какие-то ответы. Поведение школьника "Разделили какие-то метры на какие-то секунды и получили какую-то скорость" превратилось в "Услышали какие-то слова, сделали какие-то микросервисы и формочки с этими словами, получили какую-то программную систему".
Зато быстро, технично и с применением всех правильных технологий.
А это точно то, что надо было сделать?
https://www.youtube.com/watch?v=XaKtt3eIkkg&t=3s

О, как это ехидно и точно...

—
Офлайн-встреча об AI для предпринимателей: https://xn--r1a.website/aioftheday/1331

Многие рисуют диаграммы в Draw.io и радуются. А я что-то чем дальше, тем реже пользуюсь этим инструментом.
Попытался сформулировать почему.

🔸 Что такое архитектурная диаграмма? Это модель, представление, форма описания какого-то аспекта будущего или существующего решения.
Диаграммы мы обычно рисуем в какой-то нотации, которая задает язык, понятия и смыслы, с помощью которых мы формируем модель.
С помощью выразительных средств выбранной нотации мы формулируем набор утверждений, например:
- Наша система состоит из 5 сервисов, которые называются вот так
- Нашей системе для работы необходима Kafka, которая обеспечивает функционирование топиков, через которые наши сервисы обмениваются данными
- Сервис "А" взаимодействует с сервисом "Б" по интерфейсу "И"
- Сервис "С" использует СУБД "У"
ну и так далее.

Да, нарисовать такую схемку в Draw.io легко и просто почти в любой нотации. А дальше начинаются многочисленные "НО".

🔹 Во-первых, Draw.io - это просто рисовалка квадратиков и стрелочек. Она не контролирует корректность утверждений с точки зрения выбранного языка. Запросто можно нарисовать, что интерфейс "И" реализует Сервис "Б", и ничего за это не будет. Отсюда два возможных последствия - либо архитектор сам строго и внимательно следит за корректностью диаграммы с точки зрения нотации, либо строгость и точность диаграмм будет "плавать", и как следствие, будет снижаться точность принятых решений, ведь неточности и расплывчатости каждый "читатель" будет трактовать по-своему. И что-то мне подсказывает, что второй кейс будет встречаться существенно чаще.

🔹 Во-вторых, такие модели просто невозможно поддерживать в сколько-нибудь сложных проектах. Ну вот, нарисовали мы такую диаграммку, обсудили с коллегами и решили, что нужно сделать разбиение чуть-чуть иначе, функции сервисов чуть-чуть по другому разложить. Теперь нужно это решение отразить в модели. Хорошо, когда у нас одна, ну две диаграммы. А если их десятки, а то и сотни, причем один и тот же элемент системы в разных видах представлен на разных диаграммах? Конечно, можно на это забить, и поменять только ту пару диаграмм, которые обсуждали, но дальше это приводит к тому, что накапливается большое число диаграмм непонятного статуса: невозможно понять, отражают они реальность или нет?

По итогу, я для себя выбрал два подхода к моделям, и ни для одного из них Draw.io не подошел:
- Нестрогие диаграммы, картинки, схемки и прочие наброски, которые делаются "в моменте", для текущих обсуждений и не поддерживаются в дальнейшем.
Тут нужен инструментарий максимально простой, легковесный, доступный. Чаще всего я использую легковесные рисовалки типа Excalidraw или yEd. Попытки использовать в этом качестве Draw.io не увенчались успехом, чтобы сделать даже простенький набросок нужно очень много всего нажимать и корректировать.

- Строгое моделирование для документирования решений и отслеживания изменений. Делается в специализированных моделерах, которые контролируют нотацию, отслеживают представления, в которых используются элементы модели.
Вносить изменения в модель может быть трудоемко, поэтому все изменения вносятся после того, как ключевые моменты уже обсуждены и приняты на уровне набросков. В качестве моделера Draw.io использовать не получается, каждая диаграмма - сама по себе. Тут я использую что-то вроде Archi, Visual Paradigm, Sparx EA, для таких инструментов диаграмма - это лишь интерфейс для работы с моделью.
#инструменты

Всем привет!

Я сейчас повторяю одно исследование про диаграммы (в частности, UML), и прошу вас принять в нем участие. Что именно я воспроизвожу: в 2014 году исследователи из Трирского университета проводили опрос про использование диаграмм, эскизов и набросков при разработке и проектировании ПО в Германии и США. Я взял их опросник и перевел на русский: https://forms.gle/zU7PncWsWc9u3cXZ6

Я был бы вам очень признателен, если бы вы прошли его. Это займет буквально 5-7 минут. В опросе у германских исследователей приняло участие 390 респондентов, и я надеюсь, мы сможем собрать не меньшее по мощности исследование. В результате мы точно узнаем — кто и как использует диаграммы при разработке ПО.

В анкете есть несколько вопросов именно про UML — возможно, для архитекторов это не так актуально, но заодно мы как раз и это узнаем). Если вы создаёте диаграммы в другой нотации — напишите в последнем ответе, там в свободной форме можно дописать комментарии.

Если у вас есть возможность — отправьте опросник своим коллегам и знакомым, в том числе программистам; так мы обеспечим представительство большего числа профессий в ИТ. У меня уже есть ответы системных и бизнес-аналитиков, теперь собираю архитекторов и программистов.

Итоговые результаты опубликую у себя в канале и здесь тоже обязательно продублирую.

Пост согласован с @mxsmirnov

Промежуточные итоги по опросу:

164 ответа (надеюсь, наберем ещё)
47% — системные аналитики, 24.4% — архитекторы, 16.5% — бизнес- или фуллстеки.
Почти все из средних (37,2%) или крупных (48,8) компаний, почти все из России.
По отраслям: 38,4% — финтех(!), 11,6% — ритейл, 11% — госпроекты, 9,1% — автоматизация производства.
Проекты в основном крупные: от 11 человек и выше (суммарно 58,5%), и 33,5% — от 4 до 10 человек.

Теперь самое интересное:
🔹 67,1% составляли диаграммы буквально на днях или в этом месяце, 10,4% — прямо в течение дня, когда проходили опрос.
🔹 88,4% вносили несколько изменений в диаграмму после создания(!)
🔹 Суммарно потраченное время на диаграмму: несколько часов (43,3%) или даже дней! (11,6%). За час уложились 34,8%.
🔹 При этом в основном над диаграммой работает 1-3 человека (51,2% работают в одиночку).
🔹 Срок жизни диаграммы в основном около года (34,8%) или больше (25,6%), и здесь впервые значимая величина ответов "не знаю" (10,4%)

Диаграммы в основном скорее формальные, но не идеально формальные.
Чисто UML-ных диаграмм около трети, с некоторыми элементами — больше половины. Совсем без UML — 18,4%

Для чего рисуют (только ответы >50%):
➡️ Зафиксировать требование
➡️ Презентовать решение
➡️ Объяснить задачу
➡️ Спроектировать архитектуру
➡️ Проанализировать требования

Что чаще всего описывает диаграмма:
➡️ Архитектуру
➡️ API / интеграцию

Понятно, что с большим отрывом лидирует Sequence Diagram: более 70% ответов, следующие за ней — Use Case (45,7%) и State Machine (43,9%). Совсем не используют UML 6,7%.


Средний возраст респондентов — 35 лет, средний стаж — 5 (правда, есть выбросы на 20, 25 и 30 — видимо, на таких сроках уже пятилетками считают, детали смазываются 😂).

Корреляции показателей пока не считал, там должно быть интересно.

Ещё очень интересные комментарии — спасибо огромное всем, кто развернуто написал!


В общем, что хочу сказать — пока каких-то крупных инсайтов нет, но что бы я выделил:

⭐️ Большинство аналитиков рисуют диаграммы, но многие не для того, чтобы разобраться или что-то спроектировать, а потому, что в документации есть такой раздел. Некоторые даже не знают, куда эта документация дальше пойдет. Такие дела.

⭐️ UML жив, тут даже сомнений нет. Но жив он частично. И используется совсем не так, как был придуман. От всего UML осталась диаграмма последовательности (и она ого-го как используется!), диаграмма вариантов использования (вот это меня удивило, думал, её мало кто использует) и диаграмма состояний. При этом сиквенс в основном фиксирует уже спроектированное решение — тут, конечно, нужен корреляционный анализ, но пока кажется это так.

⭐️ С другой стороны, почти 20% живут без всякого UML, и им норм.

⭐️ Лично меня удивила популярность диаграммы юскейсов — правда так много людей её используют? А зачем?

В чём результаты опроса сошлись с экспертами индустрии:
Sequence diagrams, the only good thing UML brought to software development. Это статья от создателя mermaid.js. Там и про смерть UML с разных позиций, и про пользу сиквенсов, и про то, как их использовать. С цитатами типа "The reward of the clarity of sequence diagrams is worth the pain and boredom of learning all the others at university" и "Sequence diagrams are the only type of diagrams I use anymore."

Статья классная, попробую перевести её, как будет время.

А итоговый вывод: UML — как латынь для некоторых наук. Мёртв-не мёртв, а лучше знать хотя бы основы и понимать, как его правильно применять сейчас. Lingua Franca для разработки.

Красивое пошаговое визуальное объяснение как работает алгоритм Raft для достижения согласованного состояния распределенных систем.
https://thesecretlivesofdata.com/raft/
#distributed #raft

Не удержался, вступил в холивар про хореографию и орекстрацию https://xn--r1a.website/c/1120099288/159035

Вставлю свои 15 копеек.
Видится мне, что разница между оркестрацией и хореографией не столько техническая, сколько идеологическая. Вопрос в том, каков принцип организации взаимодействия между компонентами системы. Это тема столь же холиварная, как синхронное/асинхронное взаимодействие. Ничего не мешает организовать синхронное взаимодействие поверх синхронных протоколов обмена данными, так же как асинхронное взаимодействие поверх синхронных протоколов.

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

Хореография же, в противовес этому явлению, заключается в том, что каждый компонент - участник хореографии делает свою часть работы в ответ на какие-то внешние по отношению к нему раздражители, выдает какие-то данные наружу (в шину, в топики и т.п.) и не особо осведомлен о том, что с ними потом будет происходить. При этом комбинация таких слабо связанных друг с другом поведений формирует некоторый общий полезный результат. Красивый пример оркестрации, не имеющий отношения к ИТ - это всякие ролики, когда что-то куда-то катится, за что-то задевает, ручка проворачивается, вода наливается и в итоге получается красиво. Или взять к примеру древнюю игру "Жизнь" - чистая хореография и никакой оркестрации, а какие интересные эффекты.

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

ArchDays

1 ноября пройдет конференция ArchDays. Мы продолжаем отбор выступлений.

Темы выступлений:
- Процессы проектирования
- Практики проектирования
- Инструменты проектирования
- Обучение архитектуре
- Собственная разработка

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

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

Ссылка: https://archdays.ru

Если кого-то хотите увидеть на конференции, пишите в тред, отправлю персональное приглашение.

Увидимся на ArchDays!

Репост приветствуется :)

📖 В последнее время меня что-то потянуло на шпионские романы 🕵️. Нет, не про Джеймса Бонда и всякие технические ухищрения. А про тайный сбор информации, секретные встречи, агентурные сети, поддельные паспорта и обмен сообщениями, при котором ни получатель, ни отправитель не знают друг друга, и все такое.

Особенно меня завораживает концепция построения агентурной сети, в которой участники взаимодействуют по некоторым правилам, обмениваются через специальные "почтовые ящики", но при этом могут и не знать ничего друг о друге. Каждый агент знает только тех, кого сам завербовал. И ни один человек не знает всю сеть. Это свойство делает сеть в целом довольно устойчивой к отказу провалу её отдельных элементов.

Примерно такие же соображения заставляют нас при проектировании информационных систем четко определять обязанности её элементов и ограничивать объем знаний отдельных компонентов системы о своих соседях. Так, когда вдруг выяснится, что отдельный компонент системы "провалился", т.е. не справился с возложенными на него обязанностями, и его нужно заменить, то это не приведет к необходимости создания новой агентурной сети системы целиком. Можно будет ограничиться перестройкой только проблемной её части.

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

Значит ли это что всегда нужно проектировать системы как агентурные сети? Конечно же, нет. Все, как принято говорить у архитекторов, зависит от контекста 😆😆😆.

#метафоры

Чем круче джип - тем дальше бежать за трактором

У любой архитектуры есть пределы развития. Как бы хороша ни была архитектура, со временем она устареет и систему придется заменять полностью.🏗️

🚜Чем более продуманная и хорошо проработанная архитектура у вашей системы, тем дольше система остаётся в строю и продолжает приносить пользу, адаптируясь под изменения окружения, железа, требований и т.п.🚚

🤔Неожиданный вывод. Чем более древняя, устаревшая, ни на что, казалось бы, не годная система находится в эксплуатации, тем лучше её архитектура. Была бы плохая - её бы давно списали.💣

Вот так вот...

Про принятие архитектурных решений
#мысливслух

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

Опыт показывает, что на практике все устроено сильно иначе.
Во-первых, решение чаще всего не "придумывается", а лишь выбирается из доступных вариантов. Да, изредка случаются ситуации, когда нужно именно придумать хитрый финт, но это бывает крайне редко.
А во-вторых, выбор обычно иллюзорный. Т.е. выбор, вроде бы, и есть, но на самом деле в данной, конкретной ситуации, с учётом ограничения сроков, доступных ресурсов, технологий, требований ИБ, ожиданий других стейкхолдеров и т.п., выбора, на самом-то деле, и нет. И это, как ни странно звучит, очень хорошая и комфортная ситуация, ибо принятое решение можно внятно и рационально обосновать.

Если кажется, что если есть выбор, то, скорее всего, какие-то требования и ограничения просто еще не выявлены. И вот это, как по мне, самая сложная часть работы архитектора. Принять архитектурное решение таки нужно, но в условиях недостаточных знаний о реальных требованиях и ограничениях невозможно сделать это обоснованно, Приходится опираться на ненадежный фундамент - опыт, экспертное мнение и ощущения в особо чувствительных частях тела. Обосновать такое решение сложно иначе, чем "я художник, я так вижу". Некоторые прячут это за более красивыми формами "это отраслевой стандарт", "все так делают", "у меня 50 лет опыта", но сути это не меняет.

снова #мысливслух

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

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

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

В общем-то, при должном старании, достаточно сильный архитектор сможет любое решение засунуть в любое отверстие применить к любой ситуации.

Но та ли эта сила, которую мы ждем от архитектора?

А вот и запись доклада подъехала