پنل مدیریت تلگرام با پایتون: جمع‌آوری مخاطبین از گروه‌های مبدأ، ذخیره در دیتابیس و افزودن خودکار آن‌ها به گروه یا کانال مقصد — همراه پنل وب برای شروع/توقف کار، آپلود CSV و لاگ زنده.

🚀 این بسته شامل چه چیزهایی است؟

• **سورس کامل و خوانا** با کامنت‌های فارسی در همهٔ فایل‌ها

• فایل `requirements.txt` (فهرست پکیج‌های لازم)

• فایل نمونهٔ `.env.example` برای تنظیمات (بدون اطلاعات محرمانه)

• فایل `schema.sql` برای ساخت جدول‌های دیتابیس

• اسکریپت اجرای آماده برای ویندوز (`run.bat`) و لینوکس (`run.sh`)

• **راهنمای فارسی** نصب، تنظیمات و اجرا در `README.md`

🧩 امکانات

• افزودن خودکار مخاطبین به گروه و کانال مقصد

• پنل وب مدیریت (شروع/توقف/آمار/لاگ زنده)

• آپلود فایل CSV آیدی‌ها و ورود دسته‌ای به دیتابیس

• جمع‌آوری اعضا از گروه‌های مبدأ با Telethon

• محدودیت‌های ایمنی: تأخیر تصادفی، سقف ساعتی و روزانه، مدیریت FloodWait

• حالت آزمایشی DRY_RUN برای تست بدون تغییر واقعی

• ذخیره‌سازی کامل در دیتابیس + خروجی CSV

• کار با API رسمی تلگرام (api_id/api_hash خودتان)

🗄 دیتابیس

این پروژه با **SQLite** کار می‌کند؛ دیتابیس یک فایل روی سیستم شماست و هیچ سروری لازم نیست.

ساختار جدول (فایل `schema.sql`) و لایهٔ دیتابیس جدا نوشته شده است؛ برای تغییر دیتابیس فقط مقدار `DATABASE_URL` را عوض کنید.

⚙️ پیش‌نیازها

• پایتون ۳٫۱۰ یا بالاتر

• pip و دسترسی به اینترنت برای نصب پکیج‌ها (فقط در مرحلهٔ نصب)

• دیتابیس SQLite در صورت استفاده از حالت سروری

🛠 نصب و اجرا

۱) پکیج‌ها را نصب کنید:

```bash

pip install -r requirements.txt

```

۲) فایل نمونهٔ تنظیمات را کپی کنید و مقادیر را بگذارید:

```bash

cp .env.example .env

```

۳) اجرا:

```bash

python main.py run --target @your_group یا python main.py panel

```

📁 ساختار پروژه

```

py-telegram-manager/

README.md

requirements.txt

schema.sql

.env.example

run.bat | run.sh

main.py panel.py session.py core/manager.py core/scraper.py db.py templates/

```

💡 نکته‌های اجرایی

• همهٔ مقدارهای پیش‌فرض طوری انتخاب شده‌اند که پروژه بدون تنظیمات هم بالا بیاید (حالت محلی با SQLite).

• کد کاملاً ماژولار است: هر فایل یک وظیفهٔ مشخص دارد و می‌توانید بدون دست‌زدن به بقیه، بخش دلخواه را تغییر دهید.

• برای اجرا روی سرور، همان مراحل کافی است؛ پیشنهاد می‌شود پشت Nginx و با systemd یا supervisor اجرا شود.

💬 پشتیبانی

اگر در نصب یا اجرا سؤال یا مشکلی داشتید از پنل کاربری تیکت بزنید؛ در اولین فرصت پاسخ می‌دهیم و در صورت نیاز راهنمایی نصب انجام می‌شود.

🖼️ تصاویر محیط برنامه

برای دیدن تصویر در اندازهٔ کامل روی آن بزنید — با کلیدهای جهت‌دار هم می‌توانید بین تصاویر جابه‌جا شوید.