⭐ Прежде чем сделать JSON: подготовительные шаги ⭐

На прошлой неделе поделилась с вами книгой по JSON (в комментарии добавила версию для печати). В ней я показываю все необходимые примеры, но…

Чтобы научить вас делать JSON к реальным проектам, давайте применять эту книгу к одному из них: онлайн-библиотека с покупкой книг по подписке #ElibraGA.



👉 От чего зависит вид JSON-объекта:
+ для какого экрана(-ов) мы его делаем,
+ какая БД в проекте,
+ для какого метода REST API мы его делаем.



👉 Знакомлю вас с #ElibraGA:

✅ Макеты приложения в Figma - основные экраны пользовательского МП (моб. прил.)
Ссылка на Figma

+ авторизация и регистрация
+ книги, поиск и фильтры
+ избранное
- экран оплаты подписки не показан, но он есть 🙂


✅ БД проекта (ER диаграмма в Draw.io)
Ссылка на dbdiagram.io

+ ключевые таблицы: user (пользователь), subscription_tariff (тарифы), user_subscription_tariff (история тарифов пользователя, включая текущий), book (книга), user_book_purchase_history (история покупок книг по подписке)

+ ‼️Обратите внимание, БД не просто в draw.io, а интегративная - сделана через код в dbdiagram.io (иногда нужен VPN): все связи можно проверить, каждое поле прокомментировано



👉 Как мы будем это использовать:
1. Выбираем экран и определяем, какое действие для него требуется — это метод REST API: тип и URL.

2. Анализируем данные, отображаемые на экране, и выделяем ключевую сущность.

3. Продумываем, на каких ещё экранах и в каких приложениях системы будут использоваться данные этой сущности.

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

5. Проектируем полный объект JSON, который будет использоваться для ответа метода GET /object/{objectId} с полной информацией о сущности.

6. На основе полного JSON начинаем формулировать требования к JSON-запросам и ответам для всех методов, связанных с этой сущностью, начиная с метода, выбранного в пункте 1.



👉 Подготовительную часть сделали!

Можем переходить к проектированию JSON-ов!

#RestApiGA