Nasaf Digital — Tracker
Nasaf Digital jamoasi uchun Telegram Mini App: loyihalar bo'yicha post va
stories rejasini yuritish, vazifalar, tabel va Ncoin tizimi.
Ilova faqat Telegram orqali ishlaydi — alohida web-login ataylab yo'q.
Har bir so'rov Telegram'ning initData imzosi bilan tasdiqlanadi.
Nima qayerda
| Yo'l | Nima |
|---|
private/app.html | Butun frontend — bitta fayl (HTML + CSS + JS, build qadamisiz) |
netlify/functions/api.js | Butun backend — Express ilovasi. Papka nomi tarixiy, deploy Vercel'da |
netlify/functions/lib/ | auth (Telegram imzosi), db (Postgres), ncoin, notify (bot xabarlari), cycles (davrlar), xlsx (eksport) |
api/index.js | Vercel kirish nuqtasi — yuqoridagi Express ilovani qayta ishlatadi |
supabase/migrations/ | Baza sxemasi, tartib bilan qo'llanadigan SQL fayllar |
test/ | Integratsion testlar (alohida test bazasi talab qiladi) |
scripts/ | migrate (sxemani qo'llash), seed (boshlang'ich ma'lumot) |
docs/SETUP.md | Noldan sozlash qo'llanmasi |
Ishga tushirish
npm install
.env.local fayliga kerakli qiymatlarni yozing (.env.example ga qarang):
DATABASE_URL, BOT_TOKEN, APP_URL, CRON_SECRET, ADMIN_CHAT_IDS,
BLOB_READ_WRITE_TOKEN.
npm run db:migrate # sxemani qo'llash
npm run dev # lokal server
Testlar
Testlar haqiqiy yozuvlar yaratadi, shuning uchun alohida baza talab
qiladi — ishlab turgan bazada ishga tushmaydi:
# .env.local: TEST_DATABASE_URL='postgresql://...'
npm run db:migrate:test
npm run test:all
Batafsil: docs/SETUP.md → "Lokal test qilish".
Deploy
Vercel. vercel.json hamma /api/* so'rovini bitta funksiyaga
yo'naltiradi va kunlik cron'ni (/api/cron-daily, 03:00 UTC) belgilaydi.
Cron davrlarni yangilaydi, eslatma va tug'ilgan kun xabarlarini yuboradi,
hamda eski jurnal yozuvlarini tozalaydi.
Muhim qoidalar
BOT_TOKEN production'da majburiy. U bo'lmasa imzo tekshiruvi
o'chadi — shuning uchun production'da bunday holatda kirish butunlay
rad etiladi (lib/auth.js).- Ncoin balansi alohida saqlanmaydi — har doim
ncoin_transactions
jadvalidan yig'iladi, shu bilan balans va tarix hech qachon
bir-biridan uzilmaydi.
- Xodim "o'chirilganda" qatori o'chmaydi,
access_status = 'removed'
bo'ladi — tarix va coinlar saqlanib qoladi.
