Andijon Murojaat Boti (aiogram 3)

Andijon viloyati bo'yicha murojaatlarni qabul qilish, ko'rib chiqish va nazorat qilish uchun Telegram bot.

Asosiy imkoniyatlar

• Bitta panel xabar orqali forma (har qadamda xabar edit qilinadi)
• Inline tugmalar + matn/fayl kiritish bosqichlari
• Murojaatlarni SQLite bazaga saqlash (data/appeals.db)
• Review guruhiga yuborish va adminlar uchun panel
• Foydalanuvchi murojaatlari: status ko'rish (/status) va ro'yxat (/my_requests)
• Admin statistikasi: XLSX eksport (/stat)

Talablar

• Python 3.10+ (tavsiya: 3.11+)
• aiogram 3.x

Sozlash

1. .env.example dan .env yarating:

Copy-Item .env.example .env

2. .env ichida quyidagilarni to'ldiring:

BOT_TOKEN=PASTE_YOUR_TELEGRAM_BOT_TOKEN_HERE
ADMIN_IDS=123456789,987654321
REVIEW_GROUP_ID=-1001234567890
DATABASE_PATH=data/appeals.db

Eslatma:

• ADMIN_IDS - admin Telegram IDlari (vergul/bo'sh joy bilan ajratiladi).
• REVIEW_GROUP_ID - review superguruh/chat IDsi (ko'pincha -100... ko'rinishida).
• Moslik uchun ADMIN_CHAT_ID (bitta admin ID) ham qabul qilinadi.

Ishga tushirish (Windows)

python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -r requirements.txt
python bot.py

Ishga tushirish (Linux/macOS)

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python bot.py

Buyruqlar

Foydalanuvchi:

• /start - boshlash
• /cancel - jarayonni bekor qilish
• /my_requests - oxirgi murojaatlar ro'yxati
• /status ID - murojaat holatini ko'rish (masalan: /status 12)

Admin:

• /panel - ochiq murojaatlar paneli (filterlar: ochiq, admin bo'yicha, tuman bo'yicha)
• /stat - admin statistikasi (XLSX)

Review guruhida admin ishni qabul qilgach odatda quyidagi tugmalar ishlaydi:

• Yakunladim
• Ishni boshqasiga topshirish
• Murojaatda xatolik bor

Loyiha tuzilishi

• bot.py - bot logikasi (handlerlar, panel, statuslar)
• app/config.py - konfiguratsiya (.env orqali)
• app/storage.py - SQLite saqlash va statistikalar
• app/keyboards.py - inline klaviaturalar
• app/states.py - FSM state'lar

Xavfsizlik

• Token va IDlarni hech qachon kodga yozmang; faqat .env dan foydalaning.
• .env GitHub'ga yuklanmasin (.gitignore ichida).