Command Palette

Search for a command to run...

Сопровождение плагинов, модулей и стартеров Gorgo

Здесь описано, как мы тестируем, обновляем и исправляем плагины интеграций, Модуль интеграций и DTC-стартер для Medusa.

Эта страница не является юридическим обязательством.


Открытый код

Плагины, модуль и стартер мы разрабатываем в открытых репозиториях gorgojs/medusa-integrations и gorgojs/medusa-dtc-starter под лицензией MIT. Код можно использовать в коммерческих проектах, дорабатывать под свой магазин и форкать.

Открыт не только код. Тесты и их прогоны в GitHub Actions, issues и журналы изменений тоже публичны, поэтому почти всё, что описано ниже, вы можете проверить сами.

Нашли ошибку или хотите улучшить плагин? Пришлите pull request, порядок описан в разделе Contribution README.


Тесты каждую ночь

Каждую ночь GitHub Actions прогоняет юнит-, интеграционные и контрактные тесты всех плагинов и модуля, а на pull request проверяет пакеты, которые он затрагивает. Контрактные тесты обращаются к тестовым API ЮKassa, Т-Кассы, Robokassa, Stripe, PayPal и ApiShip и замечают изменения у провайдера, даже если наш код не менялся. Подробнее в статье Как мы тестируем наши плагины для Medusa.

За изменениями, которые тесты не поймают заранее, например в требованиях 54-ФЗ к чекам, мы следим по объявлениям провайдеров.


Совместимость с новыми версиями Medusa

Каждый день воркфлоу плагинов обновляет Medusa в проектах-примерах и прогоняет тесты, а воркфлоу стартера собирает с новой версией бэкенд и витрину. То, что прошло проверку, попадает в pull request с обновлением.

Плагины и модуль указывают Medusa в диапазоном версий, поэтому ставятся рядом с новой минорной версией без .


Ревью и версии

Каждое изменение перед релизом читает разработчик Gorgo. Версии плагинов и модуля следуют семантическому версионированию, у каждого плагина есть журнал изменений в документации. Прежде чем что-то удалить, мы отмечаем это устаревшим и сохраняем рабочим до следующей мажорной версии.

Стартер вы копируете в свой проект, поэтому его обновления переносите сами из истории коммитов репозитория.


Вопросы, ошибки и уязвимости

Куда сообщать об ошибках и задавать вопросы, описано на странице Поддержка. Обычно мы отвечаем в течение рабочего дня.

Первыми мы исправляем уязвимости и ошибки, из-за которых магазин не принимает оплату, не создаёт отправления, теряет или дублирует заказы. Такое исправление выходит отдельным патч-релизом.

Об уязвимости не пишите в открытом issue. Сообщите о ней конфиденциально на вкладке Security репозитория, порядок описан в SECURITY.md.


Что сюда не входит

  • Сбои и изменения на стороне провайдера. Мы поможем найти причину, но исправить чужой сервис не можем.
  • Код плагина или стартера, изменённый в вашем проекте, и форки.
  • Версии Medusa вне диапазона в .
  • Доработки под конкретный магазин и вопросы о самой Medusa. С последними приходите в чат разработчиков @medusajs_chat.
Изменено 31 октября 2026 г.·Редактировать страницу