# iTzAYDiN-BOT V8 Commerce

V7 پروژه را از یک ربات Feature-Heavy به یک **Modular Control Plane** تبدیل می‌کند؛ تمام قابلیت‌های V6 شامل Rebecca، PasarGuard، 3x-ui 3.6.0، Multi-Backend، Mini App، Payment و Premium Emoji حفظ شده‌اند و یک لایه معماری جدید روی آن‌ها اضافه شده است.

## V7 Architect
- Module Registry و Module State
- Feature Flags با Rollout درصدی و Kill Switch
- Event Bus پایدار و Event Timeline
- Automation Studio: Event → Condition → Action
- Customer 360، Tags و Admin Tasks
- Observability: Metrics + Audit + Telemetry
- Kill Switch جداگانه برای Commerce و Payments
- Runtime Config API برای Mini App
- Instrumentation مسیر Telegram و Provisioning

برای جزئیات معماری `V7-RELEASE.md` و `MIGRATION-V7.md` را بخوانید.

---

# iTzAYDiN-BOT V6 — Rebecca + 3x-ui 3.6.0

**Multi-Backend Telegram commerce, provisioning and operations suite.**

V6 معماری **Capability-Driven Multi-Backend** را با پشتیبانی First-Class از Rebecca و سازگاری 3x-ui v3.6.0 ادامه می‌دهد. هر Backend قابلیت‌های خودش را اعلام می‌کند و رابط مدیریت بر اساس همان قابلیت‌ها عمل می‌کند؛ در نتیجه 3x-ui فقط یکی از Backendهاست، نه مرکز معماری.

## هویت نسخه

- Product: **iTzAYDiN-BOT**
- Core namespace: **AYCore**
- Edition: **OMNI Multi-Backend + Rebecca**
- Release: **6.0.0-rebecca-3xui360**
- Web Control Suite: `panel/`
- Telegram Mini App: `app/`
- Web installer: `installer/`
- CLI installer: `install.sh`

## V6 چه چیزهایی اضافه می‌کند؟

- **Backend Capability Hub**: رجیستری قابلیت‌ها برای Marzban، PasarGuard، Marzneshin، Hiddify، 3x-ui Modern/Legacy، Alireza، Guard، WGDashboard، S-UI، IBSng، MikroTik و Manual.
- **iTz Rebecca Hub**: API Key/Legacy auth، Service-driven provisioning، User lifecycle، Service/Node/Host/Inbound/System/Maintenance diagnostics و Live OpenAPI Console.
- **iTz PasarGuard Hub**: اتصال اختیاری با API Key رسمی، Username/Password یا Bearer؛ تست اتصال، Roles، API Key Manager، User lifecycle و Remote Admin/Reseller lifecycle.
- **فروش نمایندگی PasarGuard**: محصول مستقل `pasarguard_reseller` که بعد از پرداخت Remote Admin واقعی را در PasarGuard Provision و وضعیت آن را در ربات Track می‌کند.
- **3x-ui Hub v3.6**: Modern و Legacy کاملاً جدا؛ Sync/Auto/Repair Inbound، Telegram-ID lookup، Custom Monthly Reset Day، Live `?format=info` و Raw Subscription.
- **Premium Emoji Diagnostics**: اعتبارسنجی `custom_emoji_id` با Telegram و Live Render Test از داخل مدیریت ربات؛ در ارسال عادی fallback امن به Emoji معمولی وجود دارد.
- **iTz Text Studio**: جستجو و ویرایش متن‌ها، Premium Emoji mapping و متن‌های تحویل قابل تنظیم.
- **iTz Control Suite**: مدیریت Backendها، محصولات، سفارش‌ها، کاربران، مالی، متن‌ها، Broadcast، ظاهر، Diagnostics و ابزارهای عملیاتی.
- **Mini App OMNI**: پوسته فعلی Mini App با assetهای سازگار `assets/v5.0.0/` بدون شکستن کلاینت‌های موجود.
- **TetraPay Diagnostics**: API URL/API Key، HTTP/HTTPS و گزارش دقیق transport/HTTP بدون نمایش Secret.

## نصب امن

قبل از هر Upgrade از Database و `config.php` بکاپ بگیرید. برای نصب تازه، Database را بسازید و `installer/` را اجرا کنید. Installer از شما Bot Token، Telegram Admin ID و credential اختصاصی iTz Control Suite را می‌گیرد و credential ثابت عمومی داخل Release وجود ندارد.

## سازگاری

V6 یک ارتقای سازگار و افزایشی روی معماری مستقل پروژه است، اما برای حفظ سفارش‌ها و سرویس‌های فعلی **قراردادهای دیتابیس، statusهای ذخیره‌شده و بعضی callbackهای legacy به‌صورت compatibility contract حفظ شده‌اند**. تغییرات ساختاری جدید از طریق migrationهای `table.php` اضافه می‌شوند و داده‌های قبلی نباید کورکورانه حذف شوند.

## مجوز

فایل `LICENSE` پروژه پایه بدون تغییر نگه داشته شده است. هر استفاده، تغییر یا توزیع باید مطابق همان مجوز انجام شود.

## V8 Commerce
- Optional multi-site Website Connector with per-site API Key + signed HMAC requests.
- Website orders and verified payments are synchronized to the bot and Web Control Suite.
- Arbitrary pre-payment/post-payment product parameters for manual/API/reseller products.
- Dedicated Commerce order ledger, fulfillment queue and Telegram admin/customer notifications.
- Safe Payment Bridge: gateway status/capabilities can be synced without exposing merchant/API secrets.
- PasarGuard reseller products can be fulfilled asynchronously by the Commerce worker when configured.
- `commerce-site-kit/` documents the only required values for customers who want to connect a website.
- No website/domain settings are mandatory in the Installer; users without a website install the bot exactly as before.
