POS-стартер для современных продаж в офлайн-магазине

Medusa POS Starter

Легковесное мобильное приложение кассы (POS) с открытым кодом для Medusa v2. Собрано на Expo и React Native и подключается напрямую к Admin REST API вашей Medusa, чтобы продавать в торговом зале без лишних прослоек.

Попробовать демо

1. Установите на телефон или планшет приложение Expo Go из App Store (iOS) или Google Play Store.

2. Отсканируйте QR-код ниже камерой устройства. Откроется приложение Medusa POS в Expo Go.

Обратите внимание: чтобы попробовать приложение целиком, нужен работающий инстанс Medusa. Если его нет, поднимите новый в Medusa Cloud.

Скриншоты

Обзор

Medusa POS переносит работу розницы на мобильное устройство и не требует менять бэкенд. Продавец сканирует товары, ведёт корзину, привязывает покупателя и оформляет заказ. Всё это работает на вашей текущей установке Medusa.

Стартер подойдёт розничной точке с высоким темпом работы: он расширяет headless-коммерцию на офлайн-магазин почти без настройки.

Возможности

• Надёжный вход: авторизация по данным администратора Medusa.
• Мастер настройки: регионы, каналы продаж и склады настраиваются при первом запуске.
• Поиск товаров: по названию или сканированием штрихкода камерой устройства.
• Работа с корзиной: создание черновиков заказов, добавление позиций, скидки и привязка покупателя.
• Оформление заказа: заказ оформляется прямо в приложении.
• История заказов: просмотр прошлых заказов с фильтрами и подробностями.
• Настройки: смена канала продаж, региона и склада, выход из приложения.
• Адаптивный интерфейс: оптимизирован для планшетов и смартфонов на iOS 15+ или Android 11+.

Требования

• Node.js 18+
• npm
• Бэкенд Medusa v2, у которого Admin REST API доступен по HTTPS
• Хотя бы один аккаунт администратора
• Устройство с задней камерой для сканирования штрихкодов

Быстрый старт

1. Клонируйте репозиторий:

2. Установите зависимости:

3. Запустите сервер разработки:

   npm start

Подробнее о настройке читайте в документации Expo.

Как поучаствовать

Мы рады вкладу сообщества в развитие Medusa POS. Ценно всё: исправление ошибок, новые возможности, улучшение документации.

Порядок работы

1. Сделайте fork репозитория и создайте от master ветку под свою задачу.
2. Сначала откройте issue (GitHub Issues), чтобы обсудить идею или сообщить об ошибке.
3. Отправьте pull request (Pull Requests) с понятным описанием изменений.
4. Следите, чтобы код соответствовал нашим правилам оформления и, где это применимо, был покрыт тестами.

Правила

• Мы принимаем только те PR, которые полезны для общего применения POS. Доработки под отдельные нужды не принимаются, иначе кодовая база теряет целостность.
• Следуйте существующему стилю и принятым соглашениям.
• Пишите понятные и короткие сообщения коммитов.
• Тщательно проверяйте свои изменения.

FAQ

Подойдёт ли это моему уже работающему магазину Medusa?

Да, конечно. Medusa POS рассчитан на любой стандартный магазин Medusa v2 и не требует менять бэкенд. Достаточно подключиться через Admin API.

Какая минимальная версия Medusa нужна?

Medusa POS работает с Medusa v2. Он интегрируется напрямую с Admin REST API, поэтому убедитесь, что на бэкенде запущена Medusa v2 или новее.

Почему нельзя указать адрес Medusa по HTTP?

Из соображений безопасности Medusa POS требует защищённого соединения по HTTPS. HTTP не поддерживается, чтобы данные были защищены, а требования современных стандартов безопасности выполнены.

Как обрабатывается оплата?

Сейчас Medusa POS сосредоточен на управлении заказами, встроенной обработки платежей в MVP нет. Мы разрабатываем экран оплаты с поддержкой наличных через плагин ручной оплаты Medusa. Кроме того, мы работаем над плагинами и интеграциями с платёжными терминалами Stripe и Adyen.

Поддерживается ли работа без сети?

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

Как распространять приложение?

Скоро мы опубликуем Medusa POS в App Store и Google Play Store. Если вам нужны особые условия распространения или своя сборка приложения, Agilo оказывает такие услуги. У нас уже несколько POS-приложений в продакшене, напишите нам, и мы подберём решение.

Можно ли доработать приложение?

Да, вы вправе сделать fork репозитория и доработать его под себя. Кроме того, Agilo берёт доработку Medusa POS на себя: правки интерфейса, интеграции с оборудованием (сканеры штрихкодов, принтеры) и связь с другими системами (ERP, учёт товаров и прочее). По конкретным доработкам напишите в Agilo.

Какие PR будут приняты?

Мы принимаем вклад, полезный для общего применения Medusa POS: исправления ошибок, ускорение работы, возможности, нужные большинству. Pull request с доработками под конкретного клиента не принимаются, чтобы основную кодовую базу можно было поддерживать.

Как сообщить об ошибке или предложить возможность?

Откройте issue в нашем репозитории с подробностями об ошибке или предложении. По срочным вопросам напишите нам напрямую.

Можно ли поучаствовать в проекте?

Да. Правила описаны в разделе выше. Мы ценим вклад в код, улучшения документации и отзывы сообщества.

Лицензия

Распространяется по лицензии MIT.

---

Сделано с ❤️ командой Agilo для сообщества Medusa.