MSBGROUP · Marketplace widget
MSB Marketplace Tool.
Универсальный встраиваемый инструмент маркетплейса для любого сайта. Витрина, каталог, карточки товаров и система заказов на базе единого FastAPI-сервера.
Что это
Маркетплейс, который встраивается на любой сайт.
Это не отдельный магазин «с нуля», а готовый виджет: каталог, карточки, корзина и оформление заказа. Хост-сайт отдаёт только контейнер, бизнес-логика живёт на FastAPI.
Демо логики
Как это работает
Нажимайте кнопки слева — в окне справа мгновенно отображается интерактивный интерфейс витрины и карточки товара.
Витрина
Каталог, поиск, фильтры и карточка товара.
Покупатель видит витрину как часть вашего сайта. Поиск, категории и карточки приходят с одного API, без отдельной витрины на стороне хоста.
Каталог
Сетка товаров с ценой, остатком, бейджами и коротким описанием.
- поиск по названию и артикулу
- фильтры по категории и наличию
- карточка открывается внутри виджета
Карточка товара
Галерея, цена, количество, характеристики и кнопка «В корзину».
- остаток и статус наличия
- количество с лимитом по складу
- быстрый переход обратно в каталог
Заказы
От корзины до заявки в Telegram.
Корзина выезжает поверх страницы клиента. Оформление собирает контакты и адрес, заказ сохраняется на сервере и уходит боту.
Витрина
Покупатель выбирает товары в каталоге или сразу с карточки.
Корзина
Боковая панель показывает состав, количество и сумму.
Оформление
Имя, телефон и адрес доставки. Заказ уходит на FastAPI.
Уведомление
Telegram-бот присылает новый заказ команде магазина.
Встраивание
Одна строка скрипта — и витрина на вашем сайте.
Хост не реализует каталог, корзину и заказы. Он подключает виджет, а виджет сам ходит на FastAPI.
Что подключает сайт
Что остаётся на сервере
Архитектура
Один FastAPI на витрину, карточку и заказы.
Виджет не хранит отдельную базу. Каталог, корзина и оформление заказа идут на тот же сервер, что и админка товаров.
Widget
Встраиваемый интерфейс: витрина, карточка, корзина-drawer.
- Browser / iframe preview
- postMessage между экранами
- fullscreen-режим демо
API
FastAPI отдаёт товары, принимает заказ и отдаёт статус.
- JWT и HTTP-only cookies
- products + orders
- единая бизнес-логика
Ops
Production-схема без отдельного бэкенда на каждом сайте.
- Linux / Docker / HTTPS
- persistent volumes
- секреты и backup
Telegram и AI
Заказы в чат. Рекомендации — по желанию.
Telegram-бот закрывает операционку: новый заказ сразу уходит команде. AI-рекомендации опциональны и не блокируют витрину.
Orders bot
Каждый оформленный заказ приходит в Telegram с составом и контактами.
- новый заказ
- состав корзины
- телефон и адрес
AI recommendations
При наличии API система может подсказывать похожие товары на карточке.
- optional provider
- витрина работает без AI
- рекомендации не ломают checkout
Без лишнего
Хост-сайт не подключает ни бота, ни AI — это зона сервера маркетплейса.
- один backend
- секреты только на сервере
- виджет остаётся тонким
Безопасность
Сессии, лимиты и защита production.
Админка товаров и заказов закрыта серверной проверкой. Публичный виджет ходит только в нужные API.
Auth
- JWT-сессия
- HTTP-only cookies
- logout удаляет cookie
Rate limits
- /login — 5 запросов за 5 минут
- /api — 60 запросов в минуту
- остальное — 120 запросов в минуту
Data model
- products, categories, stock
- cart, orders, customers
- telegram notifications
Контакты
Готовы обсудить задачу?
Оставьте контакт и короткое описание.
Ответим удобным способом и подскажем следующий шаг.
Локация
Как нас найти.
M.E.R.Y.O.S.A.B Electronics
Откройте маршрут в Google Maps и выберите удобный способ добраться до точки.
Перед визитом
Лучше заранее написать: уточним задачу, наличие специалиста и удобное время.
Быстрые действия
Постройте маршрут или напишите нам перед визитом, чтобы мы заранее подготовились к вашей задаче.