Пятая часть мини-сериала о реальной работе системного аналитика. Заполняем шаблон постановки задачи разработчику по GET/tracks запросу на получение списка треков: от параметров в таблице до алгоритма обработки запроса бэкендом.

✔️ Разбираю структуру шаблона постановки задачи: метод, URL, заголовки, таблица параметров (тип, обязательность, описание, пример, маппинг на БД, комментарии для фронта)

✔️ Показываю, как заполнить query-параметры в таблице: search, mediatype, artist, sort, genre, page, limit

✔️ Разбираем типы данных JSON: string, number, object, array, boolean, null — как определить нужный тип

✔️ Прописываем все коды ошибок (400, 401, 403, 404, 500) с конкретными текстами и алгоритм обработки запроса бэкендом: проверка токена → роль из JWT → валидация query → запрос в БД → обработка → формирование ответа.

Таймкоды:

0:00 - Цель этой части: шаблон постановки задачи для разработчиков

0:35 - Структура шаблона: метод, URL, заголовки, таблица параметров, JSON, алгоритм

2:00 - Комментарии в шаблоне: алгоритм обработки для бэкенда

2:30 - Откуда брать названия полей JSON: привязка к модели данных в БД

4:00 - Authorization header:токен показываю в Postman

5:46 - Request parameters: query-параметры в шаблоне

6:53 - Параметр search

9:10 - Маппинг на БД: таблица track, столбец name

10:15 - Параметр mediatype: enum-значения, допустимые значения из БД

12:17 - Параметры artist и sort: строковые, необязательные, поле + направление

13:42 - Типы данных JSON

18:39 - Response 200: описание массива items в табличном виде

20:40 - Многоуровневые параметры в таблице

24:05 - Что делать, если поле обязательно на фронте, но необязательно в БД

25:17 - Что делать, если фронт показывает поле, которого нет в бэке

27:40 - Ошибка 400: некорректный параметр

30:14 - Ошибка 401: невалидный токен и/или токен протух

31:08 - Ошибка 403: ролевая модель

31:42 - Ошибка 404: ресурс не найден

32:02 - Ошибка 500: сервер недоступен

33:22 - Логика: проверка токена

36:11 - Логика: запрос в БД и формирование ответа по шаблону

37:43 - Что не хватает для фронта: пользовательский путь и навигация

Финальная часть мини-сериала о реальной работе системного аналитика. Подводим итог всего пути!

Таймкоды:

0:00 - Итог: полный путь системного аналитика от данных до постановки задач

0:17 - Альтернатива 1: нет модели данных - проектируем с нуля

0:24 - Альтернатива 2: новая функциональность

0:58 - Альтернатива 3: чисто бэковая задача - интеграция двух систем без макетов

1:15 - Итог