💥 Разбор спорных вопросов по REST API с проектов и собеседований: исследуем Trello и Todoist 💥

Как понять, что мы проектируем REST API правильно? Никак. Смотреть на публичную API‑документацию крупных систем, диссертацию Роя Филдинга, или на то, что уже есть в проекте. И исходя из этого принимать решения о том, как будут выглядеть новые REST API методы.

В этой статье я хочу представить результаты исследований REST API сервисов управления задачами Trello и Todoist, чтобы показать, какие решения являются хорошими стандартами проектирования, а какие нет, но их всё равно применяют на практике.


👉 Решенные вопросы с обоснованием ответов:

1. Какой HTTP-код ответа на метод POST: 200 или 201?

2. Какой метод лучше использовать для редактирования данных: POST, PUT или PATCH?

3. Как правильно строить структуру URL запросов (эндпоинтов)?

4. Как правильно именовать эндпоинты — ед. число или мн. число (/task или /tasks)?

5. Как строить эндпоинт и body в REST API методе, если нам нужно создать задачу, и она должна быть создана внутри проекта?

6. Что вернуть в ответ на запрос списка, если ничего не найдено — пустой массив или HTTP-404?

7. Какой код вернуть в ответ на запрос DELETE?

8. Может ли быть у DELETE тело запроса?

9. Чем отличается REST от RESTful API?


🔗 Ссылка на статью


На примерах из этой статьи можно отстаивать свою правоту на собеседованиях и для команды, при проектировании методов REST API 💪

#RestApiGA #АрхитектураGA

⚡️ Как выделять микросервисы? ⚡️

1️⃣ По группам функций
2️⃣ По доменам (Domain-driven Design, DDD)
3️⃣ По данным
4️⃣ По пользовательским сценариям
5️⃣ По уровню нагрузки

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

А подробнее и с примерами рассказала о них в мини-книге к посту 📚

#АрхитектураGA #BookingGA

🧐 Как системный аналитик влияет на проектирование архитектуры 🧐

Проектирование архитектуры систем вместе с разработчиками и архитекторами — одна из больших задач системного аналитика.

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

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

1. Исследования и анализ
2. Выбор подхода к проектированию архитектуры
3. Формирование концептуальной схемы архитектуры
4. Оценка влияния нефункциональных требований

🔗 Ссылка на статью

#АрхитектураGA

🔥 13 ошибок в использовании BPMN: разбор на примере задачи 🔥

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

🔗 Презентация и полезные ссылки

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

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

Видео эпизода доступно в:
⏯ RuTube
⏯ YouTube
⏯ VK Video

Аудио-эпизод доступен в:
⏯ Apple Podcast
⏯ Яндекс.Музыка
⏯ Telegram
⏯ Castbox
⏯ Spotify

Подписывайтесь на GetAnalyst, чтобы получать новые знания в системном анализе каждый день 🚀

🚀 Открытый урок по Архитектуре на этой неделе [1-3 марта] 🚀

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

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


Мы хотим помочь вам сделать шаги в изучении архитектуры на практике, и приглашаем на открытый урок, который будет доступен в записи:

💎 Проектирование архитектуры: от монолита к микросервисам
🗓 Доступ с 1 по 3 марта (сб-пн)
🔗 Зарегистрироваться

План:
1. Роль системного аналитика в проектировании архитектуры
2. Погружение в проект
3. Проектирование монолита
4. Переход к сервисной (SOA) и микросервисной (MSA) архитектуре
5. Проблемы при делении монолита на микросервисы
6. Базовые знания аналитика для работы с архитектурой


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

Регистрируйтесь, чтобы получить доступ к этому обучению!

⚡️ Подборка микросервисов под проект #BookingGA: практика выделения микросервисов ⚡️

Ранее я рассказала как выделять микросервисы. А сегодня хочу дать вам полную подборку под проект, которую мы затем представим на C4 / Container микросервисной архитектуры.

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

✅ Управление пользователями
Пользователь – отдельная сущность со своим жизненным циклом, которой можно управлять независимо от остальных данных системы

✅ Управление недвижимостью
Недвижимость – отдельная сущность со своим жизненным циклом и статусами, которой можно управлять независимо

✅ Поиск недвижимости
Фильтрация и поиск объектов с учетом занятости.
Самая высоконагруженная функция в системе, её стоит держать отдельно

✅ Бронирования
Бронирование – отдельная сущность и пользовательский сценарий, требующий сложной бизнес-логики

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

✅ Рейтинг и отзывы
Отзывы – это отдельный тип данных, с которым можно работать независимо, не нагружая основную часть системы

✅ Уведомления
Реализует общий для всех сервисов сценарий отправки email, push, SMS

✅ Отчетность и аналитика
Аналитика часто требует тяжелых запросов, которые не должны замедлять работу основной базы. Можно собирать события из всех других микросервисов (бронирования, платежи, отзывы) и обрабатывать их асинхронно

✅ Чаты и поддержка
Реализует общение пользователей с владельцами жилья и поддержку.
Позволяет реализовать обмен сообщениями с уведомлениями

✅ Лояльность
Скидки и промоакции – отдельные сущности со своим жизненным циклом и статусами, которыми можно управлять независимо

Можно ли выделить еще (или иначе) сервисы? Да.

Но уже в этом варианте мы распределили всю основную функциональность, и далее, при необходимости, можем развивать это решение 🙌

#АрхитектураGA

🙌 DBeaver и практика SQL-запросов 🙌

Уже в следующий понедельник пройдёт продвинутый онлайн-практикум по БД и SQL:

🙌 Инструмент DBeaver. Практика SQL-запросов
🗓 3 МАРТА 2025 (ПН)
🕖 19:00 (Мск)
🔗 Подробности и регистрация

План:
1*. Знакомство с инструментом DBeaver. Подключение тестовой БД
2*. О применении SQL аналитиками. Ключевые операторы SQL-запросов.
3. Практика SQL-запросов на получение данных в DBeaver.
4. Использование AI (искусственного интеллекта) в качестве помощника в работе с SQL-запросами.

* - самостоятельная подготовка по видео-уроку в платформе, на занятии максимально практикуемся с SQL.
** - т.к. есть пересечение с открытым уроком по архитектуре, то даем всем участникам практикума расширенный доступ до 10 марта.


Практикум подойдёт, если вы:
✔️ Умеете проектировать ER-диаграммы (логический уровень минимум)
✔️ Хотите освоить SQL с нуля, на практике, за одно занятие
✔️ Научиться упрощать свою жизнь с использованием Искусственного Интеллекта при работе с SQL

Этот важный практикум для системных аналитиков, который поможет понять что такое SQL и зачем он на примере работы с реальной базой данных 🙌

Материалы по БД для знакомства и подготовки к онлайн-практикуму по DBeaver + SQL:
🔗 Статья о том, зачем БД аналитику
🔗 Статья о прекрасных возможностях DBeaver
🔗 Обучающее видео "Проектирование БД - логический уровень"

До встречи на практикуме! 😉