SuvCRM
Операционная система для бизнеса по доставке воды.
Простыми словами
- Что это
- Онлайн-программа, в которой компания по доставке воды ведёт всю работу: принимает заказы, отдаёт их курьерам, считает бутыли и деньги.
- Для кого
- Владельцам и диспетчерам компаний по доставке питьевой воды и их курьерам. Сейчас на платформе 32 компании.
- Что это даёт
- Вместо тетрадей, звонков и таблиц — один экран: видно, кто что заказал, кто сколько должен, где бутыли и сколько заработано. Заказы можно принимать и через Telegram и WhatsApp.
SuvCRM — облачная платформа, на которой работает вся операционная деятельность компании по доставке воды: клиенты, заказы, курьеры, маршруты, возвратная тара, платежи и финансы — в одном месте. Каждая компания работает в своём изолированном пространстве на общей платформе.
Бизнес-контекст
Компании по доставке воды держатся на диспетчере, курьерах и возвратной таре. Заказы приходят по телефону и в мессенджерах, бутыли нужно возвращать, а наличные, долги и зарплату владельцы сводят вручную.
Проблема
Бизнес по доставке воды обычно живёт на телефонных звонках, тетрадях и таблицах. Заказы теряются, курьеры ездят неэффективными маршрутами, оборотные бутыли пропадают из учёта, а у владельцев нет достоверной картины долгов, выручки и поведения клиентов.
Решение
Мультиарендный SaaS, который оцифровывает весь цикл: заказы поступают из панели управления или мессенджеров, планируются в маршруты, доставляются курьерами через собственное приложение, оплачиваются и сверяются — при этом каждая единица тары отслеживается, а аналитика обновляется по ходу работы.
Что я сделал
Сделано в одиночку — архитектура, код и продакшен. Других разработчиков не было.
Архитектура
- Мультитенантная платформа: один аккаунт может вести несколько бизнесов, у каждого — изолированные данные
- Жизненный цикл заказа и четыре стратегии автоназначения курьеров
- Offline-first работа для курьеров и диспетчеров
Backend
- REST API на Laravel 13 / PHP 8.4 для рабочего кабинета, приложений и клиентского портала
- Бизнес-модули: заказы, клиенты, тара, финансы, зарплата, аналитика
- Назначение курьера по GPS-расстоянию, маршруту, загрузке или взвешенной оценке
Frontend и приложения
- Рабочий кабинет бизнеса на Vue 3 и экран диспетчера, который продолжает работать офлайн
- Приложение SuvCRM Work для курьеров, диспетчеров, агентов и директоров
- Клиентский портал со входом по OTP
API и интеграции
- Публичный API v1.5 (OpenAPI 3.1) с API-ключами по скоупам и лимитом 600/мин
- Исходящие вебхуки с подписью HMAC
- Telegram-боты, WhatsApp Cloud API, Payme и Click, вебхуки маркетплейсов, IP-телефония, выгрузка в 1С
База данных
- Схема MySQL с разграничением по бизнесам
- Залог за тару — баланс клиента, а не пометка в заказе
- Семь способов оплаты, включая смешанную оплату и долг
Безопасность
- Данные изолированы по бизнесам
- Скоупы API-ключей, например read:orders и write:orders
- Пополнения кошелька идемпотентны по внешнему идентификатору
Выпуск и эксплуатация
- В продакшене с февраля 2024 года; продолжаю поддерживать и развивать
Инженерный разбор: Жизненный цикл заказа — от сообщения до баланса тары
- Клиент оформляет заказ через Telegram- или WhatsApp-бота, клиентский портал или публичный API.
- Запрос привязывается к одному бизнесу; все последующие запросы ограничены его данными.
- Заказ появляется в очереди диспетчера со статусом «новый».
- Диспетчер назначает курьера — или стратегия автоназначения выбирает его по расстоянию, маршруту и загрузке.
- Заказ приходит в приложение курьера; статус меняется на «назначен», затем на «в пути».
- Доставка закрывается в приложении даже без связи: тара выдана и возвращена, оплата принята.
- Когда сеть появляется, приложение синхронизирует доставку, тару и оплату.
- Обновляются залоги за тару, баланс клиента и наличные курьера к сдаче.
- Клиент получает уведомление, а подписанные системы — вебхук order_delivered с подписью.
Технические решения и компромиссы
- Одна платформа, изолированные бизнесы — Каждый бизнес — тенант общей платформы; его данные отделяются в каждом запросе, а один владелец может вести несколько бизнесов из одного аккаунта. (Компромисс: Дешевле в эксплуатации и обновлении, чем отдельный деплой на каждый бизнес, — но изоляцию нужно обеспечивать централизованно и покрывать тестами.)
- Тара как учётная книга — Возвратные бутыли учитываются как залоговый баланс по клиенту и по заказу, с отдельным журналом потерь. (Компромисс: Больше учёта на каждой доставке — зато владельцы могут доверять количеству тары.)
- Сначала офлайн, потом онлайн — Приложение курьера закрывает заказы и принимает оплату без связи и синхронизирует данные позже; страница диспетчера, однажды открытая, продолжает принимать заказы. (Компромисс: Сервер видит офлайн-работу только после синхронизации, поэтому отчёты какое-то время отстают от реальности.)
- Интеграции по контракту — Версионируемый публичный API с ключами по скоупам и подписанными вебхуками позволяет маркетплейсам и внутренним системам подключаться без доработок под каждого. (Компромисс: Публичный контракт должен оставаться обратно совместимым, а это замедляет изменения модели заказа.)
Основные модули
- Мультиарендная архитектура
- Управление клиентами
- Управление заказами
- Управление доставкой
- Приложения для курьеров
- Оптимизация маршрутов
- Интеграция с Telegram и WhatsApp
- AI-рекомендации и прогноз повторного заказа
- Управление подписками
- Платежи и финансы
- B2B-функциональность
- Учёт оборотной тары
- Аналитика и отчётность
Результаты
- 32 компании работают на платформе
- ≈18 000 клиентов в их базах
- ≈193 000 обработанных заказов
- Приблизительные данные, ноябрь 2026
suvcrm.uz
Boburbek