گزارش مرحله ۳ — انتخاب گیرنده و نمایش نام مشتری
پروژه: SinTime v31
مبنای تغییرات: نسخه مرحله ۲ Template Engine

تغییرات انجام‌شده در bot.php:
1) مسیر انتخاب گیرنده پرمیوم اکنون دکمه «برای شخص دیگر» را نیز در صفحه انتخاب گیرنده نمایش می‌دهد.
2) انتخاب «برای خودم» در پرمیوم به صفحه تأیید یوزرنیم منتقل می‌شود؛ قبل از ایجاد فاکتور، کاربر فرصت تأیید/تغییر گیرنده دارد.
3) ورود یوزرنیم برای پرمیوم به مرحله تأیید می‌رود و دیگر مستقیماً فاکتور نمی‌سازد.
4) یوزرنیم در مسیرهای پرمیوم و استارز قبل از ساخت سفارش نرمال‌سازی می‌شود.
5) سفارش‌های Premium و Stars فیلدهای recipient_type، recipient_name و buyer_name را ذخیره می‌کنند.
6) سفارش‌های Gift نیز recipient_name و buyer_name را کنار recipient_type ذخیره می‌کنند؛ داده‌های موجود گیرنده حفظ می‌شوند.
7) موتور متغیرها دو متغیر recipient_name و recipient_type را برای پیام‌های ثبت/اتمام سفارش فراهم می‌کند. مقدار recipient_type به «برای خودم» یا «برای شخص دیگر» تبدیل می‌شود.
8) راهنمای متغیرهای قابل استفاده در وب‌پنل برای پیام‌های مرتبط با Premium، Stars و Gift به‌روزرسانی شد.

فایل‌های اصلی تغییرکرده:
- bot.php
- tests/test_recipient_flow_static.php (تست ایستا جدید)

آزمایش‌های اجراشده:
- php -l روی تمام فایل‌های PHP بسته: موفق
- تست‌های ایستای مسیر گیرنده: 6/6 موفق
- node --check روی button_layout_editor.js: موفق
- node --check روی screen_studio.js: موفق

محدودیت‌ها:
- ربات به Telegram Bot API وصل نشده و جریان واقعی با کاربر آزمایش نشده است.
- پوشه storage و config.json نصب زنده در بسته مبنا موجود نبودند؛ سازگاری با داده‌های واقعی نصب هنوز تأیید نشده است.
- هیچ پرداخت یا داده زنده‌ای تغییر داده نشده است.
- آزمایش end-to-end خرید و ثبت سفارش انجام نشده است.

نصب:
1) از کل پروژه و پوشه storage هاست نسخه پشتیبان بگیرید.
2) ابتدا ZIP را در محیط آزمایشی استخراج کنید.
3) bot.php و فایل تست را با نسخه فعلی مقایسه کنید.
4) فایل‌های storage/config نصب فعلی را با چیزی از این بسته جایگزین نکنید.
5) پس از تست دستی مسیرهای Premium، Stars و Gift، تغییرات را روی محیط اصلی منتقل کنید.

بازگشت:
فایل bot.php را از بسته پشتیبان مرحله ۲ بازگردانید. داده‌های storage در این تغییر مهاجرت یا دست‌کاری نشده‌اند.
