BA / SA Materials

Мы перешли на API-first, и это не помогло Автор: Никита Миронов Главная мысль: границы контрактов нужно явно фиксировать в самих контрактах. О чём: - В контракте указали integer, но не определили минимальное и максимальное значения. - По спецификации сгенерировали код: в Go получилось int64, в iOS — int64, в Android — int32. - Позже понадобилось добавить к значению префикс. В Android новое значение уже перестало помещаться в выбранный тип. - Ещё была часть про форматно-логический контроль. - Было много мемов. Мемы понравились. - Нашел его сайт: https://analystexe.ru/

Архитектурные решения и компромиссы — почему мы всё время делаем систему хуже Автор: Андрей Бураков Главная мысль: придумайте несколько вариантов решения, сравните их плюсы и минусы и отдельно подумайте не только о том, что каждый вариант улучшает, но и о том, что он ухудшает. О чём: - У каждого решения есть плюсы и минусы. Поэтому практически любое изменение в чём-то делает систему лучше, а в чём-то хуже. - Идеальное, но несуществующее решение - система, которой вообще нет, но которая при этом выполняет бизнес-задачу. - Предлагаемый подход: определяем важные характеристики первого пришедшего в голову решения → приоритизируем их → добавляем вариант «оставить как есть» → генерируем альтернативы → сравниваем варианты → выбираем наиболее подходящий → документируем принятое решение. - Если решение ничего не ухудшает, скорее всего, вы ещё не нашли его минусы. Если вариант решения только один, стоит придумать ещё. - По возможности характеристики решений стоит выражать количественно. - Доклад очень понравился, хот

Spec Driven Development для системного аналитика: как превратить неполные вводные в проверяемую API-спецификацию Автор: Виктория Золотарёва Главная мысль: ИИ помог одновременно ускорить разработку требований и повысить их качество. О чём: - Рассказ о том, как в команде использовали ИИ для улучшения качества документации. - Аналитик с помощью ИИ пишет спецификацию в GitLab. В качестве контекста ИИ получает стайл-гайды в .md-файлах и документацию проекта. Спецификация хранится в отдельной ветке. - На основе спецификации генерируется документация в Confluence, а разработчик пишет код. Затем изменения аналитика и разработчика объединяются. - Использовали Cursor, а не локальные модели. Применение сторонних моделей для проекта предварительно согласовали с ИБ. - По словам автора, скорость работы выросла, команда результатом довольна. Интересно, что сама инициатива изначально пришла от бэкенд-разработчика. - Подробнее: https://habr.com/ru/companies/alfa/articles/1059296/

Как системному аналитику не спроектировать утечку данных в API Автор: Елизавета Акманова Главная мысль: Продумывайте риски и не бойтесь отказываться от решений, которые могут породить много проблем в будущем. О чём: - Кейс из работы компании: с какой проблемой столкнулись и как её решали. - Иногда лучше вообще не делать фичу, если потенциальные проблемы от неё перевешивают пользу. - Перед реализацией стоит несколько раз подумать, чем решение может аукнуться в будущем.

Сегодня посетил митап Т1 x ГК «Юзтех»: «Системный анализ» https://pro.t1.ru/event/JCPCjAwF?code=CFNUDP Общие впечатления: - Офлайн посещать подобные мероприятия куда интереснее, чем сидеть и слушать очередной онлайн-митап. - Бесплатные еда и вода. Такое любим, такое уважаем. Ещё выдавали подарки за интересные вопросы. - Узнал не так много нового, но сходить определённо стоило. - Времени на общение было не очень много, но кое-что успели пообсуждать. - Если приглашают на мероприятия по адресу Москва, м. Динамо, Ленинградский пр-т, 36, стр. 41 (БЦ «Арена», 23-й этаж), советую сходить. Лекционный зал там довольно красивый. Выжимка из докладов:

Some showcases of how requirements look

You might ask: who cares? Where are the results of that system prompt usage? Here they are https://github.com/arlagonix/todo-app-generated-requirements Model used for generation: deepseek-v4-flash (it's free, the endpoint is https://opencode.ai/zen/v1) Harness: Molten Forge

Although that's only half of the story. That video inspired me to create with help of AI a system prompt for systems analysis that might help to write in this style. I like concise and easy to understand language in requirements Here's the system prompt: