PRO шаблон описания REST-методов, который спасет от хаоса в API-документации📋

Каждый системный аналитик, на мой взгляд, рано или поздно сталкивается с задачей формирования или доработки шаблона описания, в частности, rest-метода. В интернете можно найти примеры таких шаблонов, но большинство из них являются только начальным приближением.

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

И вот почему: подробнее по ссылке ⬇️

https://teletype.in/@denischemeris/73GK7dZW3xq

А что ты ещё бы добавил в такой шаблон? Какие элементы помогают твоей команде быстрее разобраться в API?

Поделись своим опытом в комментариях. 👇

—————

Понравился материал? Ставь 👍

Всем хорошего 🍁 понедельника и продуктивной недели!

made in: @pro_system_analysis

PRO взаимодействие СА с командой (часть 1. Бизнес-аналитик).

Бизнес-аналитик (БА) — ключевая роль в команде, отвечающая за требования, которые должны быть собраны, систематизированы и переданы системному аналитику (СА). От их качества зависит эффективность команды 🚀.

Представьте задачу: необходимо принять заявку от пользователя через веб-форму 🌐 и предоставить доступ пользователю CRM для просмотра 👀.

❗️Абстрагируемся от архитектуры решения.

В результате от СА потребуется описание двух маппингов:
✅ Получить данные с веб-формы и сохранить в хранилище.
✅ Извлечь данные из хранилища и отобразить их на форме в CRM.

Для этого от БА потребуется описание одного маппинга:
☑️ Поля веб-формы на поля формы в CRM.

Если ты БА или фулстек-аналитик, ты согласен с такой постановкой?👇

Дальше последовательно пройдусь по всем взаимодействиям СА с командой.

—————

Понравился материал? Ставь 👍

Всем хорошего 🍁 понедельника и продуктивной недели!

made in: @pro_system_analysis

PRO фишки в первую неделю на новом месте.

Топ-10 🔝 рекомендаций для начинающего системного аналитика, чтобы сделать первую неделю на новом проекте максимально продуктивной:

✅ Пойми цели проекта:

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

✅ Познакомься с командой:

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

✅ Получи необходимые доступы:

Проверь, что есть всё, что нужно для работы: JIRA, Confluence, Git и другие инструменты. Скачай Swagger в Postman и проверь, как работают методы. Посмотри, что есть в базах данных, как настроены брокеры и всё такое.

✅ Изучи документацию:

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

✅ Пойми как всё работает:

Узнай, как движется задача, какие существуют правила оформления документов в компании или команде.

✅ Участвуй во встречах команды:

Не опаздывай на встречи, приходи раньше. Тогда ты сможешь пообщаться с командой неформально.

✅ Побудь тестировщиком:

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

✅ Запроси обратную связь:

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

✅ Будь проактивным:

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

✅ Наблюдай:

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

—————

Как тебе материал? Ставь 👍, если годится)

Спасибо за обратную связь и отличного ☃️ дня!

made in: @pro_system_analysis

PRO нейросети в работе системного аналитика (часть 1)🦾

Ранее уже описывал этот способ ускорения рутины: [первая версия].

Стало понятно: что нужно показывать то, что нужно показывать.

Исправляюсь!

Промт из видео:

Сделай из следующей таблицы JSON. Учти, что если в колонке type указано boolean, то тип должен быть boolean. Добавь для строковых типов подходящий по смыслу пример.

—————

Как тебе материал? Ставь 👍, если годится)

Спасибо за обратную связь и отличной ☃️ недели!

made in: @pro_system_analysis

Спасибо за активность в предыдущем опросе!🔥

Хочу сделать канал максимально полезным и интересным для вас. Для этого мне нужно знать, какие темы и вопросы интереснее всего.

✍️ Напишите в комментариях или личные сообщения:

❓Какие темы вам интересны?
❓Какие советы вы хотите получить?
❓Какие материалы или форматы вы считаете наиболее полезными?

💡 Не стесняйтесь высказывать любые идеи! Даже если кажется, что вопрос слишком простой или слишком сложный, ваши сообщения нужны мне.

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

Спасибо за обратную связь🤝

PROдолжение следует...

Всем привет! 👋

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

Готов поделиться свежими обновлениями:

0️⃣ Преподавание в Политехе
Провел курс по управлению данными в СПб Политехе, вошедшем по версии Forbes в 🔝-10 лучших российских вузов в 2025 г. Получился интересный семестр с живыми обсуждениями и практическими кейсами. Планирую делиться материалами и инсайтами и здесь.

1️⃣ Индивидуальное обучение
Запустил персональное обучение системному анализу. Есть первые результаты и отзыв (см. отзыв по 👉 ссылке). После обучения и успешных собеседований Юрий выбрал интересный для себя оффер и готовится к выходу. Скоро открою возможность записаться ко мне на обучение — планирую взять 1–2 человек, которым действительно надо. Следите за анонсами.

2️⃣ Вебинар для новичков
Совместно с опытным системным аналитиком готовим вебинар для тех, кто хочет войти в профессию (история у него просто 🔥 - из МВД перейти в СА и преуспеть). Расскажем, с чего начать, какие навыки развивать и как строить карьеру. Это будет мой первый вебинар — волнуюсь и жду)

3️⃣ Интеграция ИИ в процессы
Активно внедряю ИИ в рабочие процессы. Есть наработки и наблюдения, которыми хочу поделиться. Обсудим, что действительно работает, а что — нет.

4️⃣ Подготовка лидов
Есть понимание, как эффективно готовить лидов в системном анализе. Разработал "рецепт", которым поделюсь в ближайших постах.

🌀 "Всё хорошее когда-нибудь заканчивается..."
…а мой канал — продолжается.

Возвращаюсь уже очень скоро.
А пока — можете задать свои вопросы или предложить темы в сообщения канала (новая фишка телеги) или в комментарии к сообщению (по-старинке).