# گزارش بررسی پروژه

تاریخ بررسی: 2026-08-29

## نتیجه بررسی‌های انجام‌شده

- همه 38 فایل PHP با `php -l` بررسی شدند و خطای Syntax نداشتند.
- Autoloader داخلی و Bootstrap بدون نیاز به Composer بارگذاری شدند.
- صفحه Installer در حالت GET بدون Warning/Fatal رندر شد.
- Self Check ساختار فایل‌ها و فایل‌های اصلی پروژه را تأیید کرد.
- اسکن کد، نشانه‌ای از بخش‌های نمونه‌ای یا نیمه‌کاره‌ی شناخته‌شده پیدا نکرد.
- سقف Callback برای کلیدهای قابل ساخت از پنل کنترل شد؛ Text Manager حداکثر 47 بایت و کلیدهای خودکار Button Manager حداکثر 52 بایت تولید می‌کنند.
- ساختار XLSX استفاده‌شده در Export با یک فایل OpenXML نمونه و `openpyxl` بازخوانی شد؛ Freeze Header، AutoFilter، RTL و Header Bold معتبر بودند.
- Migration Runner برای رفتار implicit commit در DDLهای MySQL به‌صورت statement-by-statement طراحی شده و Migration فقط پس از اجرای کامل ثبت می‌شود.
- فایل ZIP نهایی پس از ساخت با `unzip -t` بررسی می‌شود.

## محدودیت محیط بررسی

PHP محیط ساخت این بسته Extensionهای `curl`, `pdo_mysql`, `mbstring` و `zip` را بارگذاری نکرده است. به همین دلیل اتصال زنده به Bot API، MySQL و تولید XLSX توسط PHP در همین محیط اجرا نشد. Installer پروژه روی سرور مقصد این Extensionها را پیش از نصب بررسی می‌کند و در صورت نبودن آن‌ها نصب را متوقف می‌کند.

برای تست Production پس از نصب، Flowهای `/start`، Join Required، پرسش‌نامه، `/admin`، Export، Broadcast Worker و Webhook طبق README روی Bot و MySQL واقعی بررسی شوند.