رایمان - Persian Voting Bot

🗳️ ربات رای‌گیری فارسی برای پلتفرم بله (Bale) و تلگرام

ویژگی‌ها

• ✅ ایجاد رای‌گیری با چندین گزینه
• 📊 نمایش نتایج به صورت زنده
• ⏹️ امکان پایان دادن به رای‌گیری
• 🔄 امکان از سرگیری رای‌گیری
• 🏷️ پشتیبانی از فارسی/پارسی
• 👥 کار با گروه‌ها و کانال‌ها

نصب و راه‌اندازی

پیش‌نیازها

pip install -r requirements.txt

تنظیمات

1. یک ربات در بله یا تلگرام ایجاد کنید
2. توکن ربات را در متغیر محیطی BOT_TOKEN قرار دهید یا مستقیماً در کد تغییر دهید
3. فایل پایگاه داده db.db به صورت خودکار ایجاد می‌شود

اجرا

python bot.py

یا با متغیر محیطی:

export BOT_TOKEN="your_bot_token_here"
python bot.py

نحوه استفاده

ایجاد رای‌گیری

در گروه یا کانال خود پیام زیر را ارسال کنید:

رای کدام گزینه درست است؟
گزینه اول
گزینه دوم  
گزینه سوم

دستورات مدیریتی

• پایان: پایان دادن به رای‌گیری (باید روی پیام رای‌گیری ریپلای شود)
• ازسرگیری: باز کردن مجدد رای‌گیری (باید روی پیام رای‌گیری ریپلای شود)
• رایمان یا /start: نمایش راهنما

ساختار پروژه

persian-voting-bot/
├── bot.py              # فایل اصلی ربات
├── requirements.txt    # وابستگی‌های پایتون
├── README.md          # مستندات
├── LICENSE            # مجوز اوپن سورس
└── db.db             # فایل پایگاه داده (خودکار ایجاد می‌شود)

مشارکت

1. پروژه را Fork کنید
2. شاخه جدیدی ایجاد کنید (git checkout -b feature/amazing-feature)
3. تغییرات خود را Commit کنید (git commit -m 'Add some amazing feature')
4. شاخه را Push کنید (git push origin feature/amazing-feature)
5. یک Pull Request ایجاد کنید

مجوز

این پروژه تحت مجوز MIT منتشر شده است. برای جزئیات بیشتر فایل LICENSE را مطالعه کنید.

حمایت

اگر این پروژه برای شما مفید بود، می‌تونید:

• ⭐ ستاره بدهید
• 🐛 باگ‌ها را گزارش دهید
• 💡 ایده‌های جدید پیشنهاد دهید
• 🤝 در توسعه مشارکت کنید

تماس

اگر سؤال یا پیشنهادی دارید، می‌تونید از طریق Issues ارتباط برقرار کنید.

---

ساخته شده با ❤️ برای جامعه فارسی‌زبان