StoreCRM: Telegram-first платформа для учёта товаров и остатков

Проблема

Учёт товаров, остатков и движения между складом, магазинами и контрагентами в рознице и e-commerce часто держится на разрозненных инструментах: Excel-таблицах, Telegram-чатах и памяти сотрудников. Как только у бизнеса появляется больше одной точки продаж или дистрибьютор, который берёт товар на реализацию, синхронизировать остатки вручную становится почти невозможно — цифры в разных местах расходятся, а по факту никто не может точно сказать, сколько товара есть прямо сейчас и где.

Отдельная сложность — работа с дистрибьюторами: передача товара на реализацию, отчёты о продажах и возврат непроданного обычно оформляются вручную, без автоматического пересчёта остатков, что создаёт разрыв между тем, что должно быть на складе, и тем, что там есть в реальности.

Три канала доступа к одному ядру данных

StoreCRM решает это не отдельным приложением под каждый сценарий, а модульной платформой, где Telegram-бот, REST API и веб-админка — это три разных канала доступа к одному ядру данных. Один и тот же товар, остаток или документ движения виден и обновляется одинаково независимо от того, через какой канал с ним работают.

Telegram-first подход выбран сознательно: команды в мессенджере (`/add_product`, `/inventory`, `/report`) позволяют вводить операции быстрее, чем открывать браузер и заполнять форму в админ-панели — особенно на складе или в точке продаж, где под рукой обычно телефон, а не рабочий компьютер.

Модульная архитектура и открытый код

Платформа построена по модульному принципу: Identity & Access (пользователи, организации, роли), Catalog (товары, артикулы, цены), Inventory (склады, магазины, остатки, документы движения) и Integration (Telegram, REST API, webhooks) — уже реализованы и работают в Stage 1. Модули CRM (клиенты, история взаимодействий) и Sales (сделки, воронки) отмечены в дорожной карте как «планируется» — то есть в текущей версии речь идёт именно о товарном и складском учёте, а не о полноценной sales-CRM с воронками продаж.

StoreCRM — open-source проект с лицензией MIT, что отдельно подчёркнуто в документации: код открыт, доступен для самостоятельного развёртывания (в том числе через Docker) и коммерческого использования, а не спрятан за демо-доступом.

Работа с дистрибьюторами

Отдельный сценарий платформы — передача товара дистрибьюторам и магазинам-партнёрам на реализацию: движение товара документируется, а отчёты о продажах и возврат непроданного пересчитывают остатки автоматически, без ручной сверки таблиц с каждой стороной.

REST API и технологический стек

Backend написан на PHP 8.1+ с MySQL 5.7+ и собственным лёгким bootstrap-слоем вместо тяжёлого фреймворка — установка описана буквально в несколько команд: клонировать репозиторий → composer install → миграции → запуск сервера. Для внешних интеграций (например, с 1С или маркетплейсами) есть REST API v1 с эндпоинтами вида `GET /api/v1/products`, `GET /api/v1/inventory`, `POST /api/v1/inventory/movement`, `GET /api/v1/reports` — авторизация по Bearer-токену.

Документация StoreCRM — отдельный публичный раздел сайта с оглавлением (обзор платформы, быстрый старт, REST API, Telegram-интеграция, модули, развёртывание), а не просто README в репозитории — то есть вход в проект рассчитан на внешнего разработчика, который будет интегрировать или разворачивать платформу самостоятельно.

Результат

Товары, остатки и движение между складом, магазинами и контрагентами сведены в одно ядро данных с тремя каналами доступа — Telegram, REST API и веб-админка. Остатки пересчитываются автоматически после каждой операции, а не сверяются вручную, а дистрибьюторский сценарий закрывает передачу на реализацию и возврат непроданного без разрыва между документом и фактом.

Публично проект показан как открытая документированная платформа — с реальными эндпоинтами API, командами бота и инструкцией по развёртыванию, а не как демонстрация закрытой внутренней панели: это соответствует тому, что StoreCRM заявлен как open-source продукт с лицензией MIT, а не приватный клиентский инструмент.