Курс · IT и аналитика

Системный анализ: API, интеграции и данные

Продолжение курса «Бизнес- и системный анализ»: от требований к системе. Системные требования и измеримые НФТ, HTTP и REST, коды ответов, JSON Schema и OpenAPI, синхронные и асинхронные интеграции (очереди, Kafka, повторы, идемпотентность, outbox), sequence- и state-диаграммы UML, нормализация до 3НФ и проверка требований SQL-запросом — на сквозном кейсе сервиса доставки.

Авторы курса

PepelenАвтор курса

Пройдено 0 / 18 уроков

Новый урок →

От требований к спецификации системы

От user story к системным требованиям

7 упражнений · Разложить пользовательскую историю на системные требования, каждое из которых называет компонент, действие, данные и условие и не забывает поведение при отказе.

Нефункциональные требования, которые можно измерить

7 упражнений · Записать НФТ к системе через измеримую метрику — перцентиль времени ответа при заданной нагрузке, доступность в процентах и минутах простоя — и отнести его к характеристике качества ISO/IEC 25010.

Границы системы: контекстная диаграмма и интеграции

7 упражнений · Нарисовать контекстную диаграмму системы — что внутри, кто и что снаружи, какие данные и каким способом идут по каждой стрелке — и составить по ней реестр интеграций.

Как системы общаются: HTTP и REST

HTTP-запрос и REST-ресурсы глазами проектировщика

7 упражнений · Разобрать HTTP-запрос и ответ на части и спроектировать адреса REST-ресурсов кейса: существительные во множественном числе, иерархия, параметры пути и запроса.

Методы HTTP: безопасность, идемпотентность, PUT против PATCH

7 упражнений · Выбрать метод HTTP для операции по его свойствам — безопасный, идемпотентный — и объяснить на заказе разницу между POST, PUT и PATCH.

Коды ответов: выбрать код, который поймёт клиент

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

Данные в обмене: JSON, JSON Schema, OpenAPI

JSON и JSON Schema: форма данных и её правила

7 упражнений · Прочитать JSON-объект заказа, выбрать типы для денег, дат и статусов и описать правила объекта в JSON Schema так, чтобы сервер проверял запрос автоматически.

OpenAPI: читаем и пишем контракт метода

8 упражнений · Прочитать описание метода в OpenAPI 3.1 — путь, параметры, тело запроса, ответы с кодами и схемами — и составить такое описание для нового метода «Ромашки».

Списки и развитие API: пагинация, фильтры, версии

7 упражнений · Спроектировать метод списка с фильтрами, сортировкой и пагинацией и отличить изменение контракта, совместимое с клиентами, от ломающего, которое требует новой версии.

Интеграции: синхронно, асинхронно, надёжно

Синхронно или асинхронно: выбрать способ интеграции

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

Брокеры сообщений: очередь, топик, Kafka и RabbitMQ

8 упражнений · Спроектировать обмен через брокер: выбрать очередь или топик, ключ партиции для порядка событий и состав события, учитывая, что доставка «хотя бы раз» даёт дубли.

Сбои: таймауты, повторы и идемпотентность

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

Модели поведения и данных: UML и нормализация

Sequence-диаграмма: кто кого вызывает и в каком порядке

7 упражнений · Прочитать и составить sequence-диаграмму сценария «оформление и оплата заказа»: участники, синхронные и асинхронные сообщения, ответы и альтернативные ветки (alt).

Диаграмма состояний: жизненный цикл заказа

7 упражнений · Описать жизненный цикл заказа диаграммой состояний — состояния, переходы, события и условия — и вывести из неё правила API: что разрешено в каком статусе и что вернуть при запрещённом переходе.

Модель данных: нормализация до 3НФ

7 упражнений · Привести плоскую таблицу заказов к третьей нормальной форме — найти нарушения 1НФ, 2НФ и 3НФ и разнести данные по таблицам с ключами — и отличить дублирование от исторического значения.

SQL для аналитика и сквозной кейс

JOIN нескольких таблиц и ловушки соединений

7 упражнений · Соединить три таблицы модели «Ромашки» и предсказать результат: найти строки без пары через LEFT JOIN … IS NULL и не попасть в размножение строк при соединении один-ко-многим.

Проверяем требование на данных

7 упражнений · Перевести требование или бизнес-правило в SQL-проверку — «запрос должен вернуть ноль строк» или «доля не ниже порога» — и прочитать результат как подтверждение или нарушение требования.

Сквозной кейс: от истории к спецификации интеграции

7 упражнений · По пользовательской истории «Ромашки» составить мини-спецификацию — системные требования, измеримое НФТ, контракт метода, событие, последовательность вызовов, затронутые статусы и SQL-проверку — и самопроверить её по чек-листу курса.