استودیوی وب پیشرفته SinTime — نسخه توسعه‌یافته
================================================

این بسته بر پایه همان پروژه SinTime v16 (نسخه PERSISTENCE-FIX) ساخته شده است. ربات جدیدی ساخته نشده و منطق اصلی فروش، وبهوک، دیتابیس و فایل‌های storage حفظ شده‌اند. تغییر bot.php محدود به افزودن دکمه ورود به استودیوی وب در پنل مدیریت تلگرام و ساخت URL امن HTTPS برای آن است.

ورود از داخل پنل مدیریت بات
----------------------------
1) بات را در گفت‌وگوی خصوصی باز کنید و پنل مدیریت را نمایش دهید.
2) دکمه «🚀 ورود به استودیوی وب پیشرفته» را بزنید.
3) وب‌اپ با Telegram WebApp initData و امضای HMAC تلگرام اعتبارسنجی می‌شود. فقط حسابی که شناسه آن با ADMIN_CHAT_ID تنظیمات نصب یکی باشد مجاز است.
4) اگر به هر دلیل وب‌اپ تلگرام در مرورگر معمولی باز شود، ورود جایگزین با کد یک‌بارمصرف به چت ادمین همچنان در دسترس است.
5) سایت باید HTTPS معتبر داشته باشد. اگر آدرس وب‌اپ به‌صورت خودکار تشخیص داده نشد، در تب «تنظیمات ربات» مقدار WEBPANEL_URL را با URL کامل مثل https://example.com/webpanel.php تنظیم کنید. سپس پنل مدیریت بات را دوباره باز کنید.

بخش‌های وب‌اپ
-------------
- داشبورد: کاربران، سفارش‌ها، فروش تکمیل‌شده، فروش امروز، سفارش‌های امروز، موجودی کاربران و تراکنش‌ها.
- دکمه‌ها و چیدمان: بیش از ۱۰۰ شناسه دکمه در دسته‌های مختلف، ویرایش عنوان، رنگ‌های پشتیبانی‌شده توسط Telegram، فعال/غیرفعال‌سازی و ترتیب منوی اصلی. فهرست قابل جستجو است.
- متن‌های ربات: متن شروع، صفحات پریمیوم/استارز/گیفت/TON، متن‌های فاکتور، درخواست گیرنده، ثبت و تکمیل سفارش، پیام‌های شارژ و موجودی ناکافی.
- قیمت‌گذاری: قیمت پایه استارز و TON، درصد سود، حداقل خرید استارز و قیمت/مقدار استارز پلن‌های پریمیوم.
- محصولات: ویرایش نام، ایموجی، توضیح، تعداد استارز، دسته و وضعیت گیفت‌ها؛ مدیریت دکمه‌های سفارشی و پاسخ آن‌ها.
- تخفیف و شماره مجازی: ساخت/ویرایش/فعال/غیرفعال‌کردن/حذف کد تخفیف، محدودیت مصرف و تاریخ انقضا، مدیریت کشورهای شماره مجازی.
- کاربران و سفارش‌ها: جستجو و مشاهده داده‌های ثبت‌شده در بات.
- تنظیمات: وضعیت بات، کانال‌ها، پشتیبانی، کارت‌به‌کارت، آدرس کیف پول‌های رمزارزی، URL وب‌اپ و پاداش دعوت.

ذخیره‌سازی
-----------
تغییرات در همان storage/config.json و در صورت فعال بودن اتصال دیتابیس در کلید config جدول sintime_store ذخیره و پس از نوشتن دوباره‌خوانی/اعتبارسنجی می‌شوند. داده کاربران و سفارش‌ها از همان app_state دیتابیس یا storage/sintime_data.json خوانده می‌شوند. قبل از آپلود حتماً از storage نسخه پشتیبان بگیرید و storage فعلی را با نسخه خالی جایگزین نکنید.

نصب/به‌روزرسانی
----------------
1) ابتدا از تمام پروژه و به‌خصوص پوشه storage نسخه پشتیبان بگیرید.
2) فایل‌های این ZIP را در همان پوشه نصب فعلی SinTime بارگذاری کنید. برای اضافه‌شدن دکمه وب‌اپ باید bot.php به نسخه موجود در این بسته به‌روزرسانی شود؛ این تغییر فقط در تابع کیبورد پنل مدیریت و تابع ساخت URL وب‌اپ است. فایل storage/config.json، فایل داده کاربران و دیتابیس خود را جایگزین نکنید.
3) مطمئن شوید HTTPS فعال است.
4) از داخل پنل مدیریت تلگرام روی دکمه ورود به استودیوی وب بزنید.
5) اگر URL تشخیص داده‌شده صحیح نبود، مستقیماً webpanel.php را با ورود یک‌بارمصرف باز کنید و مقدار WEBPANEL_URL را تنظیم کنید.
6) پس از اطمینان از نصب اصلی، install.php را طبق روال امنیتی پروژه حذف کنید.

محدودیت‌های صادقانه این نسخه
-----------------------------
- Telegram Bot API رنگ HEX دلخواه برای دکمه‌های Inline را پشتیبانی نمی‌کند؛ گزینه‌های رنگی همان آبی/سبز/قرمز هستند.
- فهرست کاربران و سفارش‌ها در وب‌اپ برای مشاهده و جستجو است. گردش‌کارهای مالی/عملیاتی که نیاز به ارسال اعلان یا ثبت تراکنش دارند، همچنان از پنل مدیریت تلگرام انجام می‌شوند تا با منطق اصلی بات تداخل پیدا نکنند.
- این محیط به هاست زنده، توکن تلگرام و دیتابیس واقعی دسترسی نداشته؛ بنابراین ارسال واقعی WebApp/OTP و ذخیره‌سازی روی هاست باید پس از آپلود آزمایش شود.

آزمون ساخت
----------
- `php -l bot.php` موفق.
- `php -l webpanel.php` موفق.
- صفحه‌های داشبورد، دکمه‌ها، متن‌ها، قیمت‌ها، محصولات، تخفیف/شماره مجازی، کاربران، سفارش‌ها و تنظیمات با داده آزمایشی رندر شدند.
- اعتبارسنجی امضای Telegram WebApp initData با امضای آزمایشی معتبر/نامعتبر بررسی شد.

به‌روزرسانی رابط موبایل (v18)
- در موبایل منوی بخش‌ها به شبکه‌ای فشرده تبدیل می‌شود.
- جدول‌ها در موبایل به کارت‌های برچسب‌دار تبدیل می‌شوند تا برای مشاهدهٔ فیلدها اسکرول افقی لازم نباشد.
- آیکون‌های تزئینی رابط وب با SVG جایگزین شده‌اند. ایموجی‌های نام دکمه‌های تلگرام و داده‌های گیفت/محصول حفظ شده‌اند چون بخشی از محتوای واقعی بات هستند.
