سورس ربات فروشگاه ساز تلگرام به همراه درگاه های مختلف

سورس ربات فروشگاه ساز تلگرام یک سیستم کامل برای راه‌اندازی و مدیریت فروشگاه در تلگرام است که از
محصولات فیزیکی، محصولات دیجیتال، فایل‌ها، لایسنس‌ها، سرویس‌های اشتراکی، محصولات زمان‌دار و محصولات دارای تنوع
پشتیبانی می‌کند.

این محصول تنها یک سورس ربات ساده نیست؛ بلکه یک مجموعه یکپارچه شامل
ربات تلگرام، Telegram Mini App، پنل مدیریت تحت وب، سیستم مدیریت محصولات و سفارش‌ها، مدیریت مشتریان، پرداخت، کیف پول، سیستم چندزبانه و چندارزی، قیمت‌گذاری بر اساس بازار، Referral، Reward و Affiliate
است.

ساختار این سورس به‌گونه‌ای طراحی شده است که بتوان از آن برای یک فروشگاه کوچک تا یک سیستم فروش حرفه‌ای با چند بازار، چند کشور و چند ارز استفاده کرد.

---

⭐ امکانات اصلی سورس ربات فروشگاه ساز تلگرام

• ربات فروشگاهی حرفه‌ای تلگرام
• Telegram Mini App فروشگاهی
• پنل مدیریت کامل تحت وب
• نصب آسان با Setup Wizard تحت وب
• پشتیبانی از محصولات فیزیکی
• پشتیبانی از محصولات دیجیتال
• فروش فایل، نرم‌افزار، سورس‌کد و لایسنس
• پشتیبانی از سرویس‌های اشتراکی و زمان‌دار
• Service Provisioning برای فعال‌سازی خودکار سرویس‌ها
• محصولات Variable و Variant
• مدیریت مشتریان و سفارش‌ها
• مدیریت موجودی و انبار
• Multi-Warehouse
• سیستم چندزبانه قابل توسعه
• Multi-Country و Market Management
• پشتیبانی از چند ارز
• قیمت‌گذاری اختصاصی برای بازارهای مختلف
• FX Rate و مدیریت نرخ تبدیل ارز
• Tax Engine
• Gateway Routing هوشمند
• کیف پول چندارزی
• Coupon و Discount Engine
• Referral System
• Reward Engine
• Affiliate System
• Digital Delivery
• Invoice System
• Support و Returns
• SMS Integration
• Queue و Worker
• Health Center
• Backup و Restore
• Update Manager
• Role & Permission
• Audit Log
• TOTP Two-Factor Authentication

---

🛍️ فروش انواع محصول و سرویس

سورس ربات فروشگاه ساز تلگرام به یک نوع محصول محدود نیست و می‌توانید مدل‌های مختلف فروش را از یک سیستم واحد مدیریت کنید.

📦 محصولات فیزیکی

محصولات فیزیکی را همراه با قیمت، موجودی، SKU، تصاویر، دسته‌بندی، Variant، وزن و اطلاعات ارسال مدیریت کنید.

سیستم Inventory نیز امکاناتی مانند انبار، رزرو موجودی، انتقال موجودی، اصلاح موجودی و هشدار کاهش موجودی را در اختیار مدیر قرار می‌دهد.

💾 محصولات دیجیتال

امکان فروش فایل، نرم‌افزار، سورس‌کد، قالب، افزونه، فایل آموزشی، لایسنس و سایر محصولات دیجیتال وجود دارد.

پس از تکمیل سفارش، سیستم Digital Delivery می‌تواند فرآیند تحویل محصول دیجیتال به مشتری را مدیریت کند.

⏳ سرویس‌های اشتراکی و زمان‌دار

برای محصولات و سرویس‌های اشتراکی می‌توانید پلن‌های مختلفی بر اساس
مدت اعتبار، ظرفیت، محدودیت مصرف، تعداد دستگاه، تعداد کاربر یا سایر ویژگی‌های موردنیاز
تعریف کنید.

امکاناتی مانند تمدید، Grace Period، Early Renewal و مدیریت چرخه عمر اشتراک نیز در ساختار سیستم در نظر گرفته شده‌اند.

⚙️ Service Provisioning

برای کسب‌وکارهایی که پس از خرید نیاز به ایجاد یا فعال‌سازی خودکار یک سرویس دارند،
ساختار Service Provisioning در سورس در نظر گرفته شده است.

این بخش امکان اتصال به سیستم‌ها و سرویس‌دهنده‌های سازگار از طریق API یا Secure Bridge را فراهم می‌کند.

🔄 محصولات دارای Variant

برای هر محصول می‌توانید گزینه‌هایی مانند
مدت اشتراک، حجم، ظرفیت، پلن، رنگ، تعداد کاربر یا سایر ویژگی‌ها
تعریف کنید.

هر Variant می‌تواند قیمت، SKU، موجودی و وضعیت مستقل داشته باشد.

---

📱 Telegram Mini App فروشگاهی

در کنار ربات، یک Mini App فروشگاهی نیز در اختیار شما قرار می‌گیرد تا کاربران بتوانند مستقیماً داخل Telegram با یک رابط گرافیکی فروشگاه را مشاهده کنند.

• نمایش محصولات
• مرور دسته‌بندی‌ها
• صفحه اختصاصی محصول
• انتخاب Variant
• سبد خرید
• Checkout
• مشاهده سفارش‌ها
• مشاهده محصولات و سرویس‌های خریداری‌شده

Bot و Mini App به یک ساختار مشترک محصولات، مشتریان، سفارش‌ها، Market و Currency متصل هستند.

---

🖥️ پنل مدیریت حرفه‌ای تحت وب

مدیریت فروشگاه فقط از طریق دستورات Telegram انجام نمی‌شود.
همراه سورس یک پنل مدیریت تحت وب برای کنترل بخش‌های مختلف فروشگاه ارائه شده است.

• Dashboard
• Products & Variants
• Categories
• Orders
• Customers
• Inventory & Warehouses
• Payment Integrations
• Market & Currency
• Mini App
• Discounts
• Referral & Reward
• Affiliate
• Subscriptions
• Invoices
• Support
• Returns
• Health Center
• Logs & Audit
• Admins & Roles

---

🌍 سیستم چندزبانه و قابل ترجمه

سورس با معماری چندزبانه طراحی شده است و متن‌های رابط کاربری از منطق اصلی برنامه جدا هستند.

زبان‌های فارسی و انگلیسی به‌صورت پیش‌فرض در محصول قرار دارند و امکان افزودن زبان‌های جدید نیز وجود دارد.

برای محصولات، دسته‌بندی‌ها و Variantها نیز می‌توان محتوای ترجمه‌شده تعریف کرد.

---

🌐 Multi-Country و Market Management

Language، Country، Market و Currency در ساختار سیستم مستقل از یکدیگر هستند.

به همین دلیل می‌توانید برای بازارهای مختلف، تنظیمات متفاوتی برای قیمت، ارز، مالیات و روش پرداخت داشته باشید.

برای مثال کاربر می‌تواند رابط فارسی داشته باشد اما در یک Market دیگر قرار گرفته و قیمت محصولات را با Currency مربوط به همان بازار مشاهده کند.

---

💱 Multi-Currency و Market Pricing

برای یک محصول یا Variant می‌توانید بر اساس Market و Currency قیمت متفاوت تعریف کنید.

بنابراین لازم نیست قیمت یک محصول برای تمام کشورها و بازارها یکسان باشد.

FX Rate Engine نیز برای مدیریت نرخ تبدیل ارز، Markup و زمان اعتبار نرخ‌ها در نظر گرفته شده است.

---

🧮 Tax Engine

قوانین مالیاتی می‌توانند بر اساس Market، Country، Currency و Product Type تعریف شوند.

ساختار سیستم از Tax-inclusive و Tax-exclusive پشتیبانی می‌کند تا مدیر بتواند مدل مالیاتی مناسب بازار موردنظر را تنظیم کند.

---

💳 سیستم پرداخت و Gateway Routing

سورس ربات فروشگاه ساز تلگرام دارای ساختار قابل توسعه برای اتصال درگاه‌های مختلف است.

با Gateway Routing می‌توانید تعیین کنید چه درگاهی بر اساس
Market، Country، Currency، نوع محصول یا محدوده مبلغ در اختیار مشتری قرار بگیرد.

برخی Providerهای موجود در ساختار سیستم:

• Zarinpal
• Zibal
• IDPay
• NextPay
• Vandar
• AqayePardakht
• Pay.ir
• Sepal
• IranDargah

برای Providerهای دیگر نیز ساختار Secure Bridge در نظر گرفته شده است.

استفاده عملی از هر درگاه نیازمند حساب و اطلاعات API معتبر همان سرویس‌دهنده است.

---

💰 کیف پول چندارزی

سیستم Wallet دارای Ledger مستقل برای Currencyهای مختلف است.

عملیات Credit و Debit ثبت می‌شوند و موجودی ارزهای مختلف به‌صورت ناخواسته با یکدیگر ترکیب نمی‌شوند.

---

🎟️ Coupon و Discount Engine

برای ایجاد کمپین‌های فروش می‌توانید کد تخفیف و Ruleهای مختلف تعریف کنید.

محدودیت محصول، دسته‌بندی، تعداد استفاده، زمان اعتبار، Market و Currency می‌توانند در منطق تخفیف مورد استفاده قرار بگیرند.

---

👥 Referral و Reward Engine

سیستم Referral برای دعوت کاربران جدید طراحی شده و می‌تواند همراه Reward Engine استفاده شود.

پاداش‌ها می‌توانند شامل امتیاز، اعتبار کیف پول، Coupon یا Reward کمپین باشند.

---

🤝 سیستم Affiliate

Affiliate از Referral جدا شده است.
Referral برای دعوت و پاداش کاربران کاربرد دارد، در حالی که Affiliate برای همکاری در فروش و محاسبه کمیسیون طراحی شده است.

• Affiliate Account
• Referral Attribution
• Commission
• Approval Delay
• Payout Request
• Settlement
• Rejection
• Commission Reversal

---

📦 Inventory و Multi-Warehouse

سیستم مدیریت موجودی شامل Warehouse، Stock، Reservation، Movement، Transfer، Adjustment و Low Stock است.

در صورت نیاز می‌توان ساختار Multi-Warehouse را نیز برای مدیریت چند انبار استفاده کرد.

---

🔄 مدیریت سرویس‌های اشتراکی

برای محصولات اشتراکی امکاناتی مانند ایجاد اشتراک از سفارش، تاریخ شروع و پایان، تمدید،
Early Renewal، Grace Period، Lifecycle Notification و Expiration در نظر گرفته شده است.

---

⬇️ Digital Delivery

برای محصولات دیجیتال، Asset و Delivery به‌صورت مستقل مدیریت می‌شوند.

امکان استفاده از Tokenهای محدودشده برای تحویل امن‌تر فایل نیز در ساختار سیستم وجود دارد.

---

🧾 Invoice System

برای سفارش‌ها امکان ایجاد Invoice وجود دارد و اطلاعات فروشنده مانند نام، آدرس، شماره تماس، شناسه مالیاتی و Prefix فاکتور قابل تنظیم است.

---

💬 Support و Returns

سیستم دارای بخش پشتیبانی برای مدیریت Ticket، Message و Media Message است.

درخواست‌های بازگشت نیز دارای Workflow و وضعیت مستقل هستند و Refund Ledger برای ثبت فرآیند بازپرداخت در نظر گرفته شده است.

---

📨 اتصال سرویس پیامکی

ساختار Integration امکان اتصال سرویس‌های پیامکی مختلف را نیز فراهم می‌کند.

• Kavenegar
• SMS.ir
• IPPanel
• FarazSMS
• Ghasedak
• MeliPayamak
• Custom HTTP Bridge

---

⚡ Queue، Cron و Worker

عملیات پس‌زمینه مانند Broadcast، SMS و برخی فرآیندهای فروش از Queue و Worker استفاده می‌کنند.

نمونه Cron برای هاست‌های اشتراکی و نمونه systemd Service برای VPS همراه محصول ارائه شده است.

---

🩺 Health Center

Health Center برای بررسی وضعیت Telegram API، Webhook، Queue، Worker و سایر اجزای عملیاتی سیستم طراحی شده است.

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

---

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

• Admin Accounts
• Role & Permission
• TOTP Two-Factor Authentication
• Login Rate Limit
• Audit Log
• Webhook Secret
• محافظت از اطلاعات حساس Integrationها

برای هر مدیر می‌توانید فقط دسترسی‌های موردنیاز او را فعال کنید.

---

💾 Backup و Restore

زیرساخت Backup و Restore برای نگهداری و بازیابی اطلاعات در سیستم در نظر گرفته شده است.

پیشنهاد می‌شود علاوه بر Backup روی سرور، نسخه‌ای خارج از سرور نیز نگهداری شود.

---

🔄 Update Manager

برای مدیریت نسخه‌های آینده، Update Manager در سورس قرار دارد.

ساختار Update برای بررسی Release Manifest، نسخه PHP، Compatibility، Checksum،
Backup، Migrationهای نسخه‌های آینده و Rollback طراحی شده است.

---

🚀 نصب آسان با Setup Wizard

نصب اولیه از طریق Installer تحت وب انجام می‌شود.

در مراحل نصب اطلاعات اصلی مانند Database، Bot Token، Admin ID، Store Name،
APP URL و تنظیمات اولیه دریافت شده و سیستم راه‌اندازی می‌شود.

---

📚 مستندات کامل فارسی و انگلیسی

همراه سورس دو راهنمای کامل HTML ارائه می‌شود:

• GUIDE_FA.html — مستندات کامل فارسی
• GUIDE_EN.html — Complete English Documentation

راهنماها از نصب اولیه تا تنظیم محصولات، پرداخت، Market، Currency، Tax، FX،
Mini App، Cron، Worker، امنیت، Backup، Update و عیب‌یابی را پوشش می‌دهند.

---

🖥️ قابل استفاده روی انواع هاست و سرور

• cPanel
• DirectAdmin
• Linux VPS
• سرورهای دارای systemd

---

📋 پیش‌نیازهای فنی

• PHP 8.1 یا جدیدتر
• MySQL / MariaDB
• HTTPS معتبر
• Telegram Bot Token
• PDO MySQL
• cURL
• JSON
• OpenSSL
• mbstring
• fileinfo
• امکان اجرای Cron Job یا Worker
• دسترسی سرور به Telegram API

---

🎯 مناسب چه کسب‌وکارهایی است؟

• فروشگاه‌های تلگرامی
• فروشندگان محصولات دیجیتال
• فروشندگان فایل و سورس‌کد
• فروشندگان نرم‌افزار و لایسنس
• ارائه‌دهندگان سرویس‌های اشتراکی
• فروشندگان محصولات زمان‌دار
• فروشگاه‌های محصولات فیزیکی
• کسب‌وکارهای چندزبانه
• فروشگاه‌های چندارزی و چندبازاری
• توسعه‌دهندگان و آژانس‌هایی که برای مشتریان خود فروشگاه Telegram راه‌اندازی می‌کنند

---

📦 اطلاعات نسخه

نسخه: 1.0.0
نوع محصول: سورس ربات فروشگاه ساز تلگرام
انتشار: اولین نسخه عمومی

---

⚠️ نکات مهم قبل از خرید

• Telegram Bot باید توسط خریدار از BotFather ایجاد شود.
• Bot Token اختصاصی فروشگاه است و همراه محصول ارائه نمی‌شود.
• حساب و اطلاعات API درگاه‌های پرداخت همراه سورس ارائه نمی‌شوند.
• استفاده از هر درگاه نیازمند حساب معتبر و اطلاعات اتصال همان Provider است.
• برخی Providerها یا سرویس‌های خارجی ممکن است به Secure Bridge یا تنظیمات اختصاصی نیاز داشته باشند.
• فعال‌سازی خودکار سرویس‌های خارجی نیازمند API یا Bridge سازگار سرویس‌دهنده است.
• استفاده از SMS نیازمند حساب و API سرویس‌دهنده پیامکی است.
• سرور باید امکان ارتباط با Telegram و سرویس‌های مورد استفاده فروشگاه را داشته باشد.
• تنظیم مالیات، روش‌های پرداخت و قوانین فروش هر بازار بر عهده مدیر فروشگاه است.

---

✨ فراتر از یک سورس ربات ساده

سورس ربات فروشگاه ساز تلگرام برای پروژه‌هایی طراحی شده است که یک Bot ساده پاسخگوی نیازهای آن‌ها نیست.

ترکیب

Telegram Bot، Mini App، پنل مدیریت تحت وب، محصولات فیزیکی و دیجیتال،
سرویس‌های اشتراکی، Market Pricing، Multi-Currency، Tax، FX،
Gateway Routing، Wallet، Referral، Reward، Affiliate، Inventory،
Digital Delivery، Service Provisioning، Backup و Update Manager

یک زیرساخت یکپارچه برای راه‌اندازی و مدیریت فروش در Telegram ایجاد می‌کند.

به‌جای استفاده از چند سیستم جداگانه برای محصولات، مشتریان، سفارش‌ها، پرداخت،
تخفیف، همکاری در فروش و مدیریت سرویس‌ها، می‌توانید بخش بزرگی از فرآیند فروش خود را
از یک سیستم واحد مدیریت کنید.