Мини-сериал о реальной работе системного аналитика, пример проекта "Музыкальный магазин"!

Третья часть мини-сериала о реальной работе системного аналитика. Генерируем веб-интерфейс музыкального магазина через ChatGPT и разбираем его глазами аналитика: какие API-запросы здесь нужны и почему.

✔️ Показываю, зачем системному аналитику ChatGPTI: генерируем HTML-интерфейс по модели БД и разбираем, что за данные и логика за каждой кнопкой.

✔️ Разбираем сущности нотификации, настройки, каталог треков и карточку трека глазами аналитика и перекладыаем их на методы HTTP: GET, POST, PUT, PATCH

✔️ Объясняю разницу между path-параметром и query-параметром на реальном примере, пагинацию и фильтры в API, а также что хранится на фронте, а что запрашивается с бэка.

✔️ Показываю достаточный уровень проектирования REST HTTP-запроса на собеседовании

Таймкоды:

0:02 - Зачем аналитику ChatGPT для проектирования API

0:46 - Генерируем HTML-интерфейс музыкального магазина

1:11- Что будем проектировать в этой части

2:31- Итерации с ChatGPT: смотрим, что получилось

7:32- Разбор интерфейса глазами аналитика: шапка, уведомления, настройки

9:22 - GET/notifications: список и карточка уведомления

15:22 - Как системный аналитик читает интерфейс

18:21 - Поддержка чата: почему здесь не REST, а WebSocket

20:25 - GET/settings: настройки профиля, режим админа, безопасность

22:03 - PATCH/profile: обновление настроек безопасности

24:40 - GET/tracks: список в response. Пагинация, фильтры как query-параметры

27:38 - GET/track/{trackId}: path-параметр, откуда фронт берёт ID

30:26 - POST/track: создание трека, валидация полей

31:51 - PUT/track/{trackId}

34:37 - Итог по всем разделам

38:26 - Критика интерфейса ChatGPT

Четвёртая часть мини-сериала о реальной работе системного аналитика. Описываем задачу на разработку нового GET/tracks запроса на получение списка треков с нуля: query-параметры, сортировка, пагинация, структура JSON-ответа и коды ошибок.

✔️ Разбираю URL и query-параметры: поиск, фильтр по медиатипу и артисту, передача нескольких значений

✔️ Объясняю, как передать сортировку в одном параметре

✔️ Проектируем пагинацию: page, limit, current_page, total_pages, total_items, page_size, has_next - что запрашиваем и что возвращаем в ответе.

✔️ Разбираем структуру JSON-ответа: массив объектов, вложенные объекты (артист, альбом с ID и названием), типы данных из БД и полный набор кодов ошибок (400, 401, 404, 500)

Таймкоды:

0:00 - Инструменты: Холст для работы, draw.io для собеседования

0:35 - URL и версионирование: правила именования эндпоинта

1:06 - Query-параметры: поиск, фильтрация

1:43 - Path vs query: обязательные и опциональные

2:40 - Передача нескольких значений в одном query-параметре через запятую

4:14 - Фильтры по треку: search, mediatype, artist

5:49 - Параметр sort: поле и направление сортировки в одном параметре

8:17 - Фильтр для фронтового компонента “чипсы”

9:10 - Добавляем пагинацию: page и limit

10:56 - Заголовок Authorization

11:27 - Примеры запросов: без фильтров, со страницей, с search

13:02 -Структура JSON-ответа: массив items с объектами

15:16 - Вложенные объекты в ответе: артист и альбом с ID

17:00 - Коды ошибок: 400, 401, 404, 500

17:45 - Что достаточно показать на собеседовании

18:39 - Пагинация в ответе: current_page, total_pages, total_items, page_size, has_next