Botxona

Tekshiruv natijasini o'qish (🟒/🟑/πŸ”΄)

Har safar ZIP yoki GitHub orqali kod yuklaganingizda, Botxona avtomatik tekshiruv o'tkazadi va har bir band uchun natija ko'rsatadi:

  • 🟒 Yashil (pass) β€” hammasi joyida, hech narsa qilish shart emas.
  • 🟑 Sariq (warn) β€” bot baribir ishga tushadi, lekin diqqat qilinishi kerak bo'lgan nuqta bor.
  • πŸ”΄ Qizil (fail) β€” jiddiy muammo, bot qurilmaydi. Muammoni tuzatib qayta yuklashingiz kerak.

Sariq yoki qizil natija chiqsa, hisobot ostida "AI-tuzatish prompti" tugmasi chiqadi β€” uni nusxalab ChatGPT/Claude/Gemini'ga bersangiz, ular muammoni tushuntirib, tuzatilgan kodni qaytaradi.

Arxiv tekshiruvi

ZIP faylning hajmi, fayllar soni va turlari belgilangan chegaralarga mos kelishini tekshiradi. Qizil bo'lsa β€” arxiv juda katta yoki ruxsat etilmagan fayl turi (masalan .exe) bor.

GitHub orqali ulaganda bu bosqich "Manba kodini olish" deb ataladi. Qizil bo'lsa β€” repozitoriya topilmadi, yopiq (private) yoki ko'rsatilgan branch yo'q. Havolani brauzerda ochib tekshiring, repozitoriyani ochiq qiling yoki kodni ZIP qilib yuklang. Bu holatda AI-prompt kerak emas β€” muammo kodda emas, havolada.

Til aniqlash

Loyiha Python, Node.js yoki Go ekanini aniqlaydi. Qizil bo'lsa β€” arxiv ildizida requirements.txt (Python), package.json (Node.js) yoki go.mod (Go) topilmadi. Ko'pincha sabab: bu fayllar arxivga qo'shilmagan yoki noto'g'ri papkadan ZIP qilingan. Arxivni to'g'ri tayyorlash bo'yicha yo'riqnomani ko'ring.

1. Token faqat BOT_TOKEN dan

Kodda ochiq (qattiq yozilgan) token borligini tekshiradi. Topilsa β€” qizil, chunki bu xavfsizlik xatari. Tuzatish: 6 qoida β€” 1-band.

2. Telegram API ulanishi

Har doim yashil β€” avtomatik. Bot Telegramga qanday ulanmasin (kutubxonaning odatiy sozlamasi bilan api.telegram.org ga bo'lsa ham), so'rovlar platforma proksisi orqali o'tadi, shuning uchun hech narsa sozlash shart emas. Batafsil: 6 qoida β€” 2-band.

3. Kutubxonalar versiyasi

requirements.txt, package.json yoki go.mod (+ go.sum) borligi va versiyalar aniq ko'rsatilganini tekshiradi. Fayl umuman yo'q bo'lsa β€” qizil. Versiyasiz kutubxonalar bo'lsa β€” sariq. Go'da go.sum yo'q bo'lsa ham sariq (build go mod tidy ni o'zi ishga tushiradi, lekin go.sum ni qo'shgan ma'qul). Tuzatish: 6 qoida β€” 3-band.

4. Kirish nuqtasi

Qaysi fayl ishga tushirilishini aniqlaydi (main.py, bot.py, package.json dagi start skripti, Go'da ildizdagi main paket (main.go) yoki yagona cmd/<nom>/, yoki botxona.yaml). Bir nechta nomzod topilsa β€” sariq (birinchisi tanlanadi, lekin aniqlik uchun botxona.yaml qo'shing). Hech narsa topilmasa β€” qizil. Tuzatish: botxona.yaml.

5. DATA_DIR

Bot fayl yozayotgan bo'lsa, DATA_DIR ishlatilayotganini tekshiradi. DATA_DIRsiz to'g'ridan-to'g'ri diskka yozish β€” sariq (fayl tizimi faqat o'qish uchun, bunday yozuv ishlamaydi). Tuzatish: 6 qoida β€” 5-band.

Tashqi ma'lumotlar bazasi serveri uchun kutubxona yoki manzil topilsa ham β€” sariq: Python'da asyncpg, psycopg, pymongo, motor, redis, pymysql; Node.js'da pg, mongoose, mongodb, ioredis, redis, mysql2; Go'da lib/pq, pgx, go-redis, mongo-driver, go-sql-driver/mysql; yoki postgres://, mongodb://, redis://, mysql:// manzillari, REDIS_URL, MONGO_URI. Botlar internetga chiqmaydi, shuning uchun bunday serverlarga ulanib bo'lmaydi β€” ma'lumotlarni SQLite bilan DATA_DIR ichida saqlang (nega va qanday). Faqat DATABASE_URL o'zi ogohlantirish bermaydi β€” SQLAlchemy va Prisma uni SQLite uchun ham ishlatadi.

6. .env.example

Bot ishlatadigan barcha muhit o'zgaruvchilari .env.example da hujjatlashtirilganini tekshiradi. Fayl yo'q yoki ba'zi o'zgaruvchilar tushib qolgan bo'lsa β€” sariq (bot ishlaydi, lekin panelda sozlamalar formasi to'liq bo'lmasligi mumkin β€” ularni qo'lda qo'shishingiz mumkin). Tuzatish: 6 qoida β€” 6-band.

Xavfsizlik skaneri

Kod ichida mayning, reverse-shell, obfuskatsiyalangan exec/eval, curl | sh kabi zararli naqshlar qidiriladi. Bunday narsa topilsa β€” qizil va build to'xtatiladi (bu muzokara qilinmaydigan qoida). Ba'zi zararsiz, lekin diqqat talab qiladigan holatlar (masalan SMTP, 25-port) β€” sariq. To'liq ro'yxat: Xavfsizlik (texnik).

Build

Kod uchun avtomatik Dockerfile yaratilib, konteyner quriladi. Build xatosi (masalan kutubxona o'rnatilmadi) bo'lsa β€” qizil, va loglarning oxirgi qatorlari hisobotda ko'rsatiladi.

Smoke-test

Build muvaffaqiyatli bo'lgach, bot bir necha soniya (odatda 30 soniya) davomida sinov rejimida ishga tushiriladi: konteyner darhol qulab tushmasligi, xotira yetarli bo'lishi tekshiriladi. Bu bosqichda muammo chiqsa β€” bot production'ga chiqmaydi, sabab ko'rsatiladi.

Nima uchun smoke-test muhim?

Ba'zi xatolar faqat ishga tushgandan keyin ko'rinadi (masalan noto'g'ri import, ishlamaydigan token). Smoke-test shu xatolarni real foydalanuvchilarga yetib borishidan oldin tutib qoladi.

Yangilanishlar (polling / webhook)

Bu bandda hech qachon xato bo'lmaydi β€” u faqat botingiz yangilanishlarni qanday olishini ko'rsatadi: "Long polling (getUpdates)" yoki webhook kodi topilgani. Bot setWebhook chaqirsa, smoke-test paytida konteynerda ochiq port qidiriladi: topilsa "Webhook server :8080 portda tinglayapti", topilmasa sariq belgi β€” server 0.0.0.0: da tinglashi kerak. Telegram IP filtri yoki TLS/sertifikat topilsa ham sariq ogohlantirish chiqadi (Botxonada ular kerak emas). Batafsil: Webhook yoki long-polling.

Keyingi qadam

Natija sariq yoki qizil bo'lsa: hisobotdagi AI-tuzatish promptini nusxalab AI'ga bering, yoki qo'lda 6 qoida bo'yicha tuzating va qayta yuklang. Hammasi joyida bo'lsa: botni sinab ko'ring, so'ng to'lovga o'ting.