# راهنمای کاربر FinanceGPT

پنل مدیریت دو بخش اصلی دارد: **ارسال پیام (Forward)** و **تعامل‌ها (Interactions)**.

## ورود

1. `python run.py` را اجرا کنید.
2. به `http://localhost:5000` بروید و با `admin / admin123` وارد شوید (رمز را تغییر دهید).
3. برای تغییر تم روشن/تاریک، از دکمهٔ ماه/خورشید در نوار بالا استفاده کنید.

---

## بخش ۱: ارسال پیام (Forward)

تمام قابلیت‌های قبلی این‌جا هستند و رفتارشان تغییر نکرده است:

- **کانال‌ها و انتخابگر**: کانال‌های مبدأ و مقصد را مدیریت کنید. در تب «انتخابگر تلگرام» می‌توانید همهٔ گفتگوهای حساب متصل را بارگذاری، فیلتر (همه/کانال/گروه/خصوصی)، جستجو و مرتب‌سازی کنید و چند مورد را هم‌زمان به‌عنوان منبع اضافه کنید. ستون «ارسال پیام» نشان می‌دهد آیا با آن چت می‌توان پیام فرستاد.
- **تنظیمات فوروارد، پرامپت هوش مصنوعی، پروکسی، وضعیت سرویس، گزارش‌ها، لاگ‌ها**: مثل قبل.

> تغییرات کانال‌ها پس از **راه‌اندازی مجدد سرویس** اعمال می‌شوند.

---

## بخش ۲: تعامل‌ها (Interactions)

گفتگوی خودکار و طبیعی بین چند اکانت تلگرام با کمک هوش مصنوعی.

### گام ۱ — اکانت‌ها
از زیربخش **اکانت‌ها** هر تعداد اکانت اضافه کنید:
- نوع **Mother** (مدیریت/مبدأ) یا **Worker** (شرکت‌کننده).
- `Session String`، `API ID`، `API Hash` و نام. این اطلاعات رمزنگاری‌شده ذخیره می‌شوند.
- با دکمهٔ ❤️ «بررسی سلامت»، اتصال هر اکانت بررسی و وضعیت (متصل/خطای احراز/خطا) با نام اکانت نمایش داده می‌شود.

### گام ۲ — AI Providerها
از زیربخش **AI Providerها** هر تعداد Provider بسازید (OpenAI، Claude، Gemini، DeepSeek، OpenRouter، مدل‌های Local و…). برای هرکدام Base URL، API Key، Model و پارامترها را تنظیم کنید. هر اکانت می‌تواند Provider مخصوص خود را داشته باشد.

### گام ۳ — کتابخانه
از زیربخش **کتابخانه**:
- **Persona**: شخصیت، سن، شغل، لحن، میزان ایموجی، سبک نگارش، علایق و…
- **Role**: نقش گفتگو (مدیر، تحلیل‌گر، منتقد، موافق، مخالف، معلم و…). ۱۱ نقش پیش‌فرض موجود است.
- **Scenario**: سناریوی گفتگو با هدف برای هر نقش.

### گام ۴ — ساخت تعامل (جادوگر ۱۰ مرحله‌ای)
دکمهٔ **تعامل جدید** را بزنید و مراحل را طی کنید:
1. انتخاب Mother Account
2. انتخاب مقصد (بارگذاری چت‌های اکانت مادر) + نام، موضوع و پیام اولیه
3. بررسی خودکار دسترسی Workerها (عضویت، امکان ارسال، Ban، فقط‌خواندنی)
4. انتخاب اکانت‌های شرکت‌کننده
5. انتخاب AI هر اکانت
6. Persona، Role و هدف هر اکانت
7. تأخیر، تأخیر تصادفی، حافظه و Rate Limiter (سقف ساعتی/روزانه، Anti-Flood)
8. شرایط پایان (تعداد پیام، پیام هر اکانت، زمان، بی‌فعالیتی، تشخیص جمع‌بندی AI، جمع‌بندی پایانی)
9. مرور تنظیمات
10. ساخت تعامل

### گام ۵ — اجرا و پایش
در صفحهٔ تعامل:
- دکمه‌های **اجرا / توقف موقت / ادامه / پایان**.
- **داشبورد زنده**: تعداد پیام، خطاها، اکانت در حال تایپ، آخرین پیام و وضعیت هر اکانت (به‌روزرسانی خودکار).
- **گزارش**: مدت، تعداد پیام موفق/ناموفق، میانگین زمان پاسخ، مصرف توکن، هزینهٔ تقریبی و تعداد Retry.
- **متن گفتگو**: کل پیام‌های رد و بدل‌شده.

### نکات
- هیچ اکانتی دو بار پشت‌سرهم پیام نمی‌دهد؛ ترتیب طبیعی است و تأخیرها رعایت می‌شوند.
- اگر AI یا ارسال ناموفق شود، دوباره تلاش می‌شود و خطا با نام اکانت ثبت می‌گردد.
- گفتگو با هر شرط پایان برآورده‌شده، به‌صورت ایمن خاتمه می‌یابد.
