StoreCRM: tovar va qoldiqlarni hisobga olish uchun Telegram-first platforma

Muammo

Chakana savdo va e-commerce'da tovarlar, qoldiqlar va ombor, do‘konlar hamda kontragentlar o‘rtasidagi harakatni hisobga olish ko‘pincha tarqoq vositalarga — Excel jadvallari, Telegram chatlari va xodimlar xotirasiga — tayanadi. Biznesda bitta sotuv nuqtasidan ko‘p bo‘lishi yoki tovarni realizatsiyaga oladigan distribyutor paydo bo‘lishi bilanoq qoldiqlarni qo‘lda sinxronlash deyarli imkonsiz bo‘lib qoladi — turli joylardagi raqamlar bir-biridan farqlanadi va aslida hech kim aynan hozir qancha tovar va qayerda borligini aniq ayta olmaydi.

Alohida murakkablik — distribyutorlar bilan ishlash: tovarni realizatsiyaga topshirish, sotuv hisobotlari va sotilmagan tovarni qaytarish odatda qo‘lda, qoldiqlarni avtomatik qayta hisoblamasdan rasmiylashtiriladi — bu omborda bo‘lishi kerak bo‘lgan narsa bilan haqiqatda bor narsa o‘rtasida farq yaratadi.

Bitta ma'lumotlar yadrosiga uchta kirish kanali

StoreCRM buni har bir stsenariy uchun alohida ilova bilan emas, balki modulli platforma bilan hal qiladi: Telegram-bot, REST API va veb-admin panel — bitta ma'lumotlar yadrosiga uchta turli kirish kanali. Bir xil tovar, qoldiq yoki harakat hujjati qaysi kanal orqali ishlanishidan qat'i nazar bir xil ko‘rinadi va bir xil yangilanadi.

Telegram-first yondashuv ongli ravishda tanlangan: messenjerdagi buyruqlar (`/add_product`, `/inventory`, `/report`) operatsiyalarni brauzer ochib admin paneldagi shaklni to‘ldirishdan tezroq kiritish imkonini beradi — bu ayniqsa omborda yoki sotuv nuqtasida muhim, u yerda odatda qo‘l ostida ish kompyuteri emas, telefon bo‘ladi.

Modulli arxitektura va ochiq kod

Platforma modulli tamoyilda qurilgan: Identity & Access (foydalanuvchilar, tashkilotlar, rollar), Catalog (tovarlar, artikullar, narxlar), Inventory (omborlar, do‘konlar, qoldiqlar, harakat hujjatlari) va Integration (Telegram, REST API, webhooklar) — Stage 1'da allaqachon amalga oshirilgan va ishlaydi. CRM (mijozlar, muloqot tarixi) va Sales (bitimlar, voronkalar) modullari roadmap'da «rejalashtirilgan» deb belgilangan — ya'ni joriy versiyada aynan tovar va ombor hisobi haqida gap boradi, to‘liq sotuv voronkalariga ega sales-CRM haqida emas.

StoreCRM — MIT litsenziyasiga ega open-source loyiha, bu hujjatlarda alohida ta'kidlangan: kod ochiq, mustaqil joylashtirish (shu jumladan Docker orqali) va tijorat maqsadida foydalanish uchun mavjud, demo-kirish ortiga yashirilmagan.

Distribyutorlar bilan ishlash

Platformaning alohida stsenariysi — tovarni distribyutorlar va hamkor-do‘konlarga realizatsiyaga topshirish: tovar harakati hujjatlashtiriladi, sotuv hisobotlari va sotilmagan tovarni qaytarish esa har ikki tomon jadvallarini qo‘lda solishtirmasdan qoldiqlarni avtomatik qayta hisoblaydi.

REST API va texnologik stack

Backend og‘ir framework o‘rniga PHP 8.1+ va MySQL 5.7+ hamda o‘zining yengil bootstrap qatlamida yozilgan — o‘rnatish bir necha buyruqda tasvirlangan: repozitoriyni klonlash → composer install → migratsiyalar → serverni ishga tushirish. Tashqi integratsiyalar uchun (masalan, 1C yoki marketpleyslar bilan) `GET /api/v1/products`, `GET /api/v1/inventory`, `POST /api/v1/inventory/movement`, `GET /api/v1/reports` kabi endpointlarga ega REST API v1 mavjud — avtorizatsiya Bearer token orqali.

StoreCRM hujjatlari — repozitoriydagi oddiy README emas, balki saytning o‘z mundarijasiga ega alohida ommaviy bo‘limi (platforma sharhi, tez boshlash, REST API, Telegram integratsiyasi, modullar, joylashtirish) — ya'ni loyiha platformani mustaqil integratsiya qiladigan yoki joylashtiradigan tashqi dasturchi uchun mo‘ljallangan.

Natija

Tovarlar, qoldiqlar va ombor, do‘konlar hamda kontragentlar o‘rtasidagi harakat uchta kirish kanaliga — Telegram, REST API va veb-admin panelga — ega bitta ma'lumotlar yadrosiga keltirildi. Qoldiqlar qo‘lda solishtirilmasdan har bir operatsiyadan keyin avtomatik qayta hisoblanadi, distribyutor stsenariysi esa realizatsiyaga topshirish va sotilmagan tovarni qaytarishni hujjat va haqiqat o‘rtasida farqsiz yopadi.

Ommaga loyiha yopiq ichki panelning namoyishi sifatida emas, balki real API endpointlari, bot buyruqlari va joylashtirish bo‘yicha qo‘llanmaga ega ochiq, hujjatlashtirilgan platforma sifatida ko‘rsatilgan — bu StoreCRM'ning maxfiy mijoz vositasi emas, balki MIT litsenziyali open-source mahsulot sifatida pozitsiyalanishiga mos keladi.