Skip to main content

На пути к публичному API

На пути к публичному API выясни, кому оно нужно.

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

Если заказчик платит только за интеграции с выбранными партнерами, то все эти затраты излишни. Если заказчик думает только в терминах краткосрочной окупаемости, то публичное API ему не нужно. Выдав партнеру аннотацию swagger/raml, ты достигаешь 80/20 эффекта и пусть партнер ругает, но пишет. Разработчики с обеих сторон недовольны, каждый апдейт лишь увеличивает технический долг, но деньги от интеграций идут и KPI соблюдаются. Так к чему перфекционизм? Отринь его, смирись и понимай, что цель бизнеса в получении прибыли, а не создании более прекрасного мира.

Comments

Post a Comment

Popular posts from this blog

Архитектурное ревью

Зачем архитектурное ревью? В ходе архитектурного ревью проект получает независимую экспертизу по принятым архитектурным решениям. Это может стать отправным моментом для создания плана работ по повышению качества ПО и выходу проекта на новый уровень зрелости. В качестве минимальной пользы ревью можно назвать разработку архитектурной проектной документации, которая облегчит коммуникацию между участниками проекта (отделом тестирования, системными интеграторами, техническими писателями, аналитиками, новыми разработчиками). Ожидаемые эффекты от участия в архитектурном ревью: перенимание архитектурных методологий интеграция методологий в процессы команды/компании* создание архитектурных артефактов, в том числе формулирование необходимых критериев качества продукта (описанных и измеримых) и предложений по их достижению, базирующихся на текущем состоянии качества продукта и ограничениях от бизнеса * Наличие архитектурных процессов позволяет поддерживать качество проекта в заданных р...
Post a Comment
Read more

ACDM

" A key concept of ACDM (Architecture Centric Design Method) is to accept the fact that these unknowns (precise production and cost estimates) exist and the architecture is used to reduce the period of uncertainty. Because of the period of uncertainty and the role architecture design has in mitigating the uncertainty, architectural design (like any kind of discovery) cannot be a one-time activity. ACDM provides specific techniques geared toward using the architecture to aggressively explore unknowns and overcome the period of uncertainty as quickly as possible " © Anthony Lattanze  "Architecting software intensive systems:  A Practitioner's Guide" Две вещи зацепили в этом кусочке: Архитектор - как борец с неопределенностью. Архитектор и вправду не может сказать "не знаю". Он (и команда) отвечают за свойства системы. И он дает гарантии. И за это ему платят. То есть, иногда архитектор может и не изменить значительно существующий дизайн, но...
Post a Comment
Read more

Личность архитектора в контексте Дао Дэ Цзин

Бронислав Виногродский (крупнейший русский китаист и очень интересная личность ) написал книгу с прозаическим названием "Искусство управления миром" . Книга про управление собой и своим миром, но через это "сопрягающиеся" миры неизбежно претерпевают изменения. Книга базируется на его осмыслении Дао Дэ Цзина . Бронислав Брониславович вводит собственные(?) понятия для описания человеческой личности: Художник осмысленных действий, Мастер управляемых совпадений и Художник творческих состояний. Некоторые из приведенных зарисовок/размышлений уровня Мастера управляемых совпадений и Художника осмысленных действий созвучны с тем, что составляет личные качества архитектора и наглядно демонстрирует состояния. Вообще крайне рекомендую к прочтению книгу. И к повторному, многократному перепрочтению. И к последующему осмыслению прочитанного. "     На пути принятия решений можно принять любое решение, но ни одно решение не решает всех вопросов.      Пытаясь воплотить...
Post a Comment
Read more