Как делать связи и API в модулях?

Question

[Максим]

Всем привет! Планирую делать различные модули? Которые должны как-то взаимодействовать друг с другом. Получать какие-то данные для логики.

Для этого у меня есть два варианта:
Сделать виджеты
Сделать API

Как вы используете? Подскажите...

Например, делаю модуль гео. Он будет отвечать за хранение информации о городах, странах и регионах. Он независим от других.

Далее делаю модуль мероприятий. Где город нужно получить из другого модуля. Желательно в базе ещё и хранить id, вместо строки.

Как соблюсти не связанность модулей и при этом чтоб все функционировало. Возможно придётся использовать и виджет и api, ведь нужно ещё и выводить на странице название города, а не id.

В общем подскажите как лучше сделать.

И второй вопрос как правильно реализовать api в модуле?

Было бы не плохо посмотреть на примеры)

Благодарю!

Answer 1

[Андрей]

по уму все в микросервисы, если 1 БД то можно и сервисами, а уже если надо апи дернуть то апи в сервис ходит!

Comments

[Максим]

Хотелось бы разобраться как правильно это реализовать. Зависимости и предоставление данных)

[Андрей]

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

[Максим]

Андрей, а почему нельзя сделать один сервис и пользоваться им и в api и в самом модуле. Ведь чаще всего логика одна

[Андрей]

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

[Максим]

Андрей, ну например заказы. Сервис заказов используем в api и в самом модуле.

Суть вообще такая. Я делаю модуль городов, регионов и стран. Возможно его потом опубликую. А может вообще дам api своих городов, типа клард и буду использовать эти данные в других проектах и модулях. Но это отступление.

Далее я хочу использовать этот модуль в другом модуле. Например, на мероприятие мне нужно указать в каком городе проходит. Через api получаю массив с данными и заношу id города из моего api. Затем. Использую виджет чтобы вывести его название.

Правильно ли я мыслю?)

[Андрей]

Да. правильно.. т.е. что у вас там в модуле городов творится другому не важно знать.. т.е москва будет 1 или 10000 не важно.. главное что он возвращает массив данных который структурирован и ясен как использовать! по поводу городов, dadata чем не нравится? не так имхо дорого в ком. использовании.

[Максим]

Андрей, да вроде нравится, но пока не использовал) Вообще не использовал никакие api по городом. Всегда лепил готовый дамп базы и делал к ним модели. Сейчас смотрю в сторону api vk. Хорошая у них база. То что пока нудно и бесплатно)

Можете показать какой-нибудь открытый код как в модуле интегрируете с dadata, например)

Хочется сразу сделать хороший код, чтобы не переделывать) Я ещё не такой профи в написании) Бужу очень благодарен.

[Андрей]

У дадаты если подсказки то 10к вроде в сутки бесплатно.. а там почти все есть!
https://packagist.org/?query=dadata
ну или их варианты!

у нас тупо проксик(микросервис) сделан, что бы свои ключи не показывать, т.е любое обращение к городам идет через него.. он возвращает нам данные (мы там чутка модифицуруем) как то так

[Андрей]

У нас - https://packagist.org/packages/glendemon/dadata-su...

[Максим]

Андрей, понял примерно) Поразбираюсь)) но все таки зависимость от этого api не исчезает...

[Андрей]

от дадаты? ну да... но можно всегда преобразовать если что.. за 4 года не видел проблем!

[Андрей]

+ можете свою сделать кешовую базу )))) в общем вариантов много!

[Максим]

Андрей, а в базе как храните тогда города?) я хранил ID. А вы получается просто храните само название города. Не по ID. Верно? Это не усложняет вывод информации для одного города? Например всех пользователей Москвы...

[Андрей]

Ну стандартно!
как возвращают так и мы.. ну чутка своег оприписываем

СREATE TABLE `address` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `account_id` int(11) unsigned NOT NULL,
  `country` varchar(3) COLLATE utf8_unicode_ci NOT NULL,
  `country_subdivision` varchar(15) COLLATE utf8_unicode_ci NOT NULL,
  `city` varchar(128) COLLATE utf8_unicode_ci NOT NULL,
  `district` varchar(255) CHARACTER SET utf8 DEFAULT NULL,
  `street` varchar(128) COLLATE utf8_unicode_ci NOT NULL,
  `house` varchar(64) COLLATE utf8_unicode_ci DEFAULT NULL,
  `flat` varchar(64) COLLATE utf8_unicode_ci DEFAULT NULL,
  `entrance` varchar(64) COLLATE utf8_unicode_ci DEFAULT NULL,
  `floor` varchar(64) COLLATE utf8_unicode_ci DEFAULT NULL,
  `intercome_code` varchar(64) COLLATE utf8_unicode_ci DEFAULT NULL,
  `geo_lat` float(10,6) DEFAULT NULL,
  `geo_lon` float(10,6) DEFAULT NULL,
  `fias` varchar(64) COLLATE utf8_unicode_ci DEFAULT NULL,
  `delivery_area` tinyint(1) DEFAULT NULL,
  `beltway_distance` smallint(5) DEFAULT '0',
  `comments` text COLLATE utf8_unicode_ci,
  `hidden` tinyint(1) unsigned NOT NULL DEFAULT '0',
  `created_at` int(11) DEFAULT NULL,
  `updated_at` int(11) DEFAULT NULL,

Суть в том что по внутреннему ид можем найти что нам нужно ) Ну и можем сделать кеш.. по имеющимся данным. )))

Вся Москва, все равно идет через ДАДАТУ.. если надо сделать внутнренее, ну приводить город к вашему ид.. и области или району.. дальше уже группируйте как надо!

[Максим]

Андрей, понял) получается вы парусите данные в свою базу и подставляете id и выводите имя уже своего id) а я думаю вообще в своей базе ничего не храните из данных) вот как раз и интересно было как это все связать и при этом использовать в разных модулях НЕЗАВИСИМЫХ))

[Андрей]

Так я же сказал у нас прокси.. взяли во внешке, сохранили у нас.. связали как нам надо и показали.. а по поводу не хранить, расскажите как же будете искать данные по городу?
приведете к городу из дадаты (из сервиса) потом пойдете искать по своим полям и т.д.?

[Максим]

Андрей, завтра ещё тогда раз перечитаю. Все равно не до конца понимаю) Разберусь думаю) Но все равно благодарен, что так активно помогаете)) тут просто и api и зависимости в модулях в общем все в одно место)

[Андрей]

Максим Ворожцов, Обращайтесь ))))

Answer 2

[Максим Тимофеев]

1. Виджет должен работать с данными, которые в него передали. Так что он явно не подходит для Вашей задачи.
2. Если Ваш модуль A нуждается в api или виджете или еще чем-то еще из модуля B, то это зависимость. И тут надо понимать что не важно как реализована зависимость, виджетом или использованием Модели из другого модуля. Это зависимость. Но зависимость модулей - это не плохо.
Делать абстракции - это отлично. Но делать это надо с прицелом на переиспользование в других проектах и без фанатизма.

Comments

[Максим]

То есть лучше зависимости делать абстракцией? А потом в Bootstrap загрузке определять эту абстракцию через DI контейнер. Верно?)

[Максим]

Я уже задавал вопрос про города. Сделал модуль городов. Теперь думаю как связывать его с другими модулями) Где я просто записываю id.