Zimmer Samarqand — QR-kodli aksiya va Telegram-bot

Samarqand brendi uchun Telegram-botli QR-kodli aksiya ishga tushirdik: xaridor stikerni skanerlaydi va bazaga hamda sovrinli o'yinga qo'shiladi. Xodimlar uchun 150 000 tagacha kodli partiyalar va o'yinlar boshqariladigan admin panel yaratdik.

Mijoz
Zimmer Samarqand
Loyiha turi
Veb-ilova
Ilovani ochish
Zimmer Samarqand — QR-kodli aksiya va Telegram-bot

Vazifa

Zimmer Samarqand — Samarqanddagi brend: u o'z mahsulotlariga QR-stiker yopishtiradi va har bir stikerda alohida kod bor. Xaridor bu kodni Telegram-botda ro'yxatdan o'tkazadi va sovrinli o'yinlar o'tkaziladigan aksiya ishtirokchisiga aylanadi. Aksiyani brend xodimlarining o'zi yuritadi: kod chiqaradi, stiker chop etadi va g'oliblarni aniqlaydi.

Brend o'z xaridorlarini tanishni va ularni sovrinlar bilan rag'batlantirishni xohladi. QR-kodli aksiya g'oyasi oddiy: har bir mahsulotda kodli stiker bor, xaridor uni telefon bilan skanerlaydi va ishtirokchiga aylanadi. Buning uchun sayt ham, mobil ilova ham kerak emas — QR-koddagi havola Telegram-botni ochadi, odam hech narsa o'rnatmaydi, ro'yxatdan o'tmaydi va anketa to'ldirmaydi. Butun yo'l — kodni skanerlash va bitta tugmani bosish. Ro'yxatdan o'tgan har bir kod xaridorlar bazasini to'ldiradi: ism, Telegramdagi username va, agar odam xohlasa, telefon raqami. Brend shu baza bo'yicha sovrinli o'yin o'tkazadi, g'oliblar bilan bog'lanadi va aksiyaga nechta xaridor qo'shilganini ko'radi.

Eng qiyin joyi — aksiyaga ishonch. Stikerni do'konda suratga olish, do'stga yuborish yoki ikki marta skanerlash mumkin. Ikki kishi bitta kodni bir soniyada yuborishi mumkin, Telegram esa ba'zan bitta xabarni qayta yetkazadi. Shunday holatlarda kod ikki marta hisoblansa, o'yin adolatli bo'lmay qoladi. Ikkinchi qat'iy shart: chop etilgan stikerlar doim ishlashi kerak. Chop etilgandan keyin kod formati, havola va bot nomini o'zgartirib bo'lmaydi, aks holda mahsulotlardagi minglab stikerlar foydasiz bo'lib qoladi. Bazani yo'qotish esa chop etilgan barcha kodlarni birdaniga qadrsizlantirardi. Do'konda ko'rinib turgan stikerni istalgan odam ro'yxatdan o'tkazishi mumkin, shuning uchun QR-kodli aksiyada uni qadoq ichiga yopishtirishni, g'oliblardan esa stikerni ko'rsatishni so'rashni tavsiya qilamiz.

Partiyalar o'n minglab stikerlardan iborat va ular turlicha chop etiladi: A4 varaqlarda yoki termoprinterda etiketka rulonlarida. Har bir printer tasvirni biroz siljitadi, ammo kichik stikerdagi QR-kod baribir telefon kamerasida ishonchli o'qilishi kerak. Admin panelda dasturchilar emas, brend xodimlari ishlaydi — o'zbek yoki rus tilida va nafaqat kompyuterdan. Server boshqa loyihalar bilan umumiy, shuning uchun aksiya qo'shnilarning protsessori va xotirasini egallab olmasligi kerak edi. Ishtirokchilarning ismi va telefoni — shaxsiy ma'lumot, botning kirish kaliti esa bot ustidan to'liq nazorat beradi: ikkalasi ham begona qo'lga tushmasligi kerak.

Muvaffaqiyatni shunday belgiladik. Xaridor kodni skanerlaydi va bitta bosish bilan o'zbek tilida tushunarli javob oladi. Xodim o'zi partiya chiqaradi, stiker chop etadi, ishtirokchilarni ko'radi va ularni Excelga yuklaydi. O'yin shaffof o'tadi: har bir kod — bitta imkoniyat, bir kishi esa bitta partiyada ikki marta yutmaydi. G'oliblarga xodimlar o'zi qo'ng'iroq qiladi yoki Telegramda yozadi, shuning uchun telefon va username doim qo'l ostida bo'lishi kerak. Egasi ma'lumotlar uchun xotirjam: baza har soatda nusxalanadi, tekshiruvdan o'tmagan yangilanish esa o'zi oldingi versiyaga qaytadi. QR-kodli aksiya har qanday tirajga chidashi va kundalik ish uchun dasturchini talab qilmasligi kerak.

Yechim

QR-kodli aksiyani uch qismdan yig'dik: Telegram-bot kodlarni ro'yxatdan o'tkazadi, admin panel partiyalar, chop etish va o'yinlarni boshqaradi, ma'lumotlar bazasi esa har bir kod faqat bir marta ishlashini o'zi kuzatadi.

Server qismini C++ tilida Drogon freymvorkida yozdik va unga qat'iy chegara qo'ydik: umumiy serverda u bitta protsessor yadrosi va 512 MB xotira oladi, shunda qo'shni saytlar zarar ko'rmaydi. Telegram unga har bir xabarni yuboradi, u esa bitta qadamda kodni va ishtirokchini ro'yxatdan o'tkazadi va javobni shu almashuvning o'zida qaytaradi, shuning uchun unga bot kaliti umuman kerak emas — kalit faqat yangilanishlarni chiqarishda ishlatiladi. Bot faqat o'zbek tilida gapiradi, uning 8 ta xabarini xodimlar admin panelda tahrirlaydi va o'zgarish keyingi javobdanoq kuchga kiradi. Telefon raqamini bot tugma orqali so'raydi, lekin majburlamaydi, guruhlardan va boshqa botlardan kelgan xabarlarga esa e'tibor bermaydi.

Admin panelni React Admin asosida yig'dik — bu jadvallar, filtrlar va formalar uchun tayyor asos. Unda oltita bo'lim bor: QR-kod partiyalari, ishtirokchilar, o'yinlar, kodlar, bot matnlari va foydalanuvchilar. Panel o'zbek, rus va ingliz tillarida, yorug' va qorong'i mavzuda ishlaydi, telefonda esa jadvallar kartochkalarga aylanadi. Stikerli PDF to'g'ridan-to'g'ri brauzerda yig'iladi, shuning uchun bot xaridorlarga javob berayotganda chop etish serverni yuklamaydi. Xodimlar login va parol bilan kiradi, ochiq ro'yxatdan o'tish yo'q. Ilova Docker'ga joylangan: har bir versiya to'liq saqlanadi va oldingisini darhol qaytarish mumkin, GitHub Actions esa yangisini faqat barcha tekshiruvlardan keyin chiqaradi.

  1. Har bir kod bir marta ishlaydi

    Kodni qayta ro'yxatdan o'tkazish taqiqi ma'lumotlar bazasining o'ziga qo'yilgan, shuning uchun dasturda xato bo'lsa ham kod ikki marta hisoblanmaydi. Ikki kishi bitta kodni bir soniyada yuborsa, kod bittasiga tegadi, ikkinchisi rad javobini oladi — buni alohida avtotest tekshiradi. Kod egasining qayta bosishi hech narsani o'zgartirmaydi, o'chirilgan kod esa hech qachon qayta chiqarilmaydi.

  2. 150 000 tagacha kodli partiyalar

    1 dan 150 000 gacha kodli partiya bitta qadamda yaratiladi va yo to'liq paydo bo'ladi, yo umuman bo'lmaydi; ishchi serverda eng katta partiya taxminan 16 soniya oladi. Har bir kod — 16 ta tasodifiy harf va raqam, shuning uchun birovning kodini tanlab topish deyarli imkonsiz. Havola qisqa, QR-kod ixcham chiqadi va 20 mm stikerdan ham o'qiladi. Ishlatilgan kodlari bor partiyani o'chirib bo'lmaydi.

  3. Stikerlarni brauzerda chop etish

    Chop etish uchun PDF xodimning brauzerida, fonda, sahifani qotirmasdan yig'iladi: 30 mm lik 54 ta stikerli A4 varaqlar yoki termoprinter uchun har bir etiketkaga bittadan stiker. O'lcham 20 dan 50 mm gacha, chetlar, oraliqlar va siljish aniq printerga moslanadi, 50 mm chizg'ichli sinov varag'i sozlashni tekshiradi, kerakli raqamlar oralig'ini qayta chop etish mumkin. Kod varaqdan chiqib ketadigan joylashuv chop etishga yuborilmaydi.

  4. Ishtirokchilar bazasi va eksport

    Kodni ro'yxatdan o'tkazgan har bir kishi bazaga tushadi: ism, username, til, agar ulashgan bo'lsa telefon va kodlar soni. Ro'yxatda qidiruv va sana bo'yicha filtr bor, u Excelga 300 000 qatorgacha yoki CSV'ga cheklovsiz yuklanadi; server ortiqcha yuklanmasligi uchun fayl 20 000 qatordan bo'lib yig'iladi. Telegramdagi ismga yozilgan formula eksportda ishlamaydi, ishtirokchi kartochkasida esa uning barcha kodlari ko'rinadi.

  5. Adolatli sovrinli o'yin

    O'yin bitta qadamda bitta partiyadan 1 dan 1000 gacha turli odamni tanlaydi. Ro'yxatdan o'tgan har bir kod — alohida imkoniyat, boshqa partiyalar kodlari hisoblanmaydi, ma'lumotlar bazasining o'zi esa ikki o'yin bir vaqtda boshlansa ham bir kishining bitta partiyada ikki marta yutishiga yo'l qo'ymaydi. Partiyani oldingi g'oliblarsiz qayta o'ynash mumkin, partiya o'chirilsa ham natijalar saqlanadi.

  6. Xavfsiz yangilanish va baza nusxalari

    Har bir yangilanish avval avtotestlardan o'tadi: server tekshiriladi, admin panel yig'iladi, tayyor PDF'dagi QR-kodlar esa skaner o'qigandek qayta o'qiladi. Chiqarishdan oldin bazaning nusxasi olinadi, to'g'ri ishga tushmagan versiya esa o'zi oldingisiga qaytadi. Baza har soatda nusxalanadi, nusxalar 48 soat saqlanadi, admin panel esa faqat himoyalangan HTTPS ulanishi orqali ochiladi.

Natijalar

Loyihaning asosiy natijalari raqamlarda.

  • 150kKod bitta partiyada

    Eng katta partiya — 150 000 kod — ishchi serverda taxminan 16 soniyada paydo bo'ladi: yo to'liq, yo umuman bo'lmaydi.

  • 1Marta bosish kifoya

    Xaridorga stikerni skanerlab, Telegramda bitta tugmani bosish kifoya — ro'yxatdan o'tish, anketa va alohida ilovasiz.

  • 1000G'olib bitta o'yinda

    Bitta o'yin partiyadan 1000 tagacha turli ishtirokchini tanlaydi va bir kishi unda faqat bir marta yuta oladi.

  • 54Stiker bitta A4 varaqda

    Odatda A4 varaqqa 30 mm lik 54 ta stiker sig'adi, o'lcham, chetlar va siljish esa printerga moslanadi.

Loyiha texnologiyalari

Mijozning vazifasi uchun yechimni qurganimiz stek.

  • C++
  • Drogon
  • PostgreSQL
  • Docker
  • Nginx
  • GitHub Actions
  • TypeScript
  • React
  • Vite
  • MUI
  • React Admin
  • Telegram Bot API

Keyingi keys bo'lishga tayyormisiz?

Vazifani ayting — menejer jamoa yig'adi, smeta hisoblaydi va so'rovingizdan keyingi birinchi soat ichida taklif yuboradi. Majburiyatlarsiz va xat tarqatishsiz.