تست‌ها (اختیاری)
================
این تست‌ها روی هاست لازم نیستند و فقط برای بررسی در محیط توسعه‌اند.
پوشهٔ tests/ را می‌توانید بعد از نصب حذف کنید.

نیازمندی: Node.js + jsdom برای تست‌های .js · خودِ PHP برای تست‌های .php
    npm install jsdom

اجرا:
    # ۱) تب‌ها، فیلتر، کیبورد، تم، کارت، تب وبلاگ، نبود فوتر
    curl -s "http://localhost/"     -o /tmp/page.html
    node tests/tabs.test.js                    → ۳۷ موفق، ۰ ناموفق

    # ۲) قواعد سازگاری اندروید/ویندوز + پیوندهای مرده + صفحهٔ ۴۰۴
    curl -s "http://localhost/nope" -o /tmp/page404.html
    node tests/platform.test.js                → ۲۳ موفق، ۰ ناموفق

    # ۳) افزودن/ویرایش/حذف و ذخیرهٔ تنظیمات در پنل مدیریت
    TEST_DB=/مسیر/نصب/storage/database.sqlite php tests/admin-crud.test.php
                                               → ۱۴ موفق، ۰ ناموفق

    # ۴) وبلاگ: اسلاگ، یکتایی، ویرایش بدون رکورد تکراری، جست‌وجو، صفحه‌بندی
    #    (روی دیتابیس موقت کار می‌کند؛ به سایت شما دست نمی‌زند)
    php tests/blog.test.php                    → ۳۴ موفق، ۰ ناموفق

    # ۵) دستیار هوش مصنوعی: طبقه‌بندی خطا، سلامت مدل، مدارشکن،
    #    فهرست سفید ابزارها، ممیزی، گزارش، برنامه
    php tests/ai.test.php                      → ۴۷ موفق، ۰ ناموفق، ۲ رد شد

    # ۶) پشتیبان‌گیری: ساخت دامپ SQL، بازیابی، رد کردن فایل نامعتبر،
    #    محافظت از مسیر، سقف تعداد، یکسان‌بودن ساختار دو درایور
    #    (روی دیتابیس موقت کار می‌کند؛ به سایت شما دست نمی‌زند)
    php tests/backup.test.php                  → ۷۵ موفق، ۰ ناموفق

    # ۷) درایور MySQL — اختیاری، فقط اگر سرور MySQL/MariaDB دارید
    #    انتقال SQLite→MySQL، نوشتن روی MySQL، بازیابی بین دو درایور، بازگشت
    MYSQL_HOST=127.0.0.1 MYSQL_NAME=rezume_test \
    MYSQL_USER=rezume MYSQL_PASS=رمز php tests/mysql.test.php
                                               → ۵۰ موفق، ۰ ناموفق

    # ۸) تقویم شمسی: نقاط لنگر، رفت‌وبرگشت تبدیل، کبیسه، پیوستگی ۱۲۰۰ روز،
    #    هفتهٔ شنبه‌محور، قالب‌بندی فارسی، پارس ورودی، شبکهٔ تقویم
    #    (کاملاً مستقل؛ به دیتابیس کاری ندارد)
    php tests/jalali.test.php                  → ۹۲ موفق، ۰ ناموفق

    # ۹) ربات گزارش‌گیری تلگرام: امن‌سازی متن، رویدادها، مقصدها، ساخت گزارش‌ها،
    #    فرمان‌های وبهوک، صف و سرریز، آمار بازدید، پل اطلاع‌رسانی
    #    (کاملاً آفلاین — هیچ درخواستی به تلگرام نمی‌رود)
    php tests/telegram.test.php                → ۱۳۵ موفق، ۰ ناموفق

    # ۵ب) تست کامل دستیار همراه با «رفتن به مدل زاپاس» روی HTTP واقعی:
    #     ترمینال ۱:
    php -S 127.0.0.1:8123 tests/fake-openrouter.php
    #     ترمینال ۲:
    AI_TEST_URL=http://127.0.0.1:8123/ php tests/ai.test.php
                                               → ۵۴ موفق، ۰ ناموفق

اگر سایت روی دامنه یا زیرپوشهٔ دیگری است:
    TEST_BASE=https://example.com  →  برای تست‌های جاوااسکریپت، BASE را در
    ابتدای tests/platform.test.js و tests/tabs.test.js (متغیر SRC) عوض کنید.
    TEST_BASE و TEST_DB            →  برای تست PHP از راه متغیرهای محیطی.

چه چیزی پوشش داده شده است
------------------------
admin-crud.test.php — دو باگ واقعی که قبلاً وجود داشت:
  • فرم ویرایش باید با دادهٔ موجود پر شود (وگرنه ذخیره، رکورد تکراری می‌سازد)
  • ذخیرهٔ تنظیمات در یک صفحه نباید مقادیر صفحهٔ دیگر را خالی کند

blog.test.php — سه نکتهٔ مهم:
  • ویرایش نوشته، رکورد تکراری نمی‌سازد
  • ویرایش عنوان، نشانی (slug) نوشته را عوض نمی‌کند تا لینک‌ها نشکنند
  • ویرایش از فرمِ ناقص، دسته/تصویر/سئوی نوشته را پاک نمی‌کند

ai.test.php — سه نکتهٔ امنیتی:
  • فقط ابزارهای فهرست سفید اجرا می‌شوند
  • کلید API هرگز با ابزارها قابل تغییر نیست
  • نوشتهٔ ساختهٔ دستیار همیشه «پیش‌نویس» می‌ماند تا مدیر تأیید کند
  و سه نکتهٔ پایداری:
  • خطای مدل اصلی → رفتن خودکار به مدل زاپاس
  • سه خطای پیاپی → مدارشکن، مدل خراب موقتاً کنار گذاشته می‌شود
  • خطای کلید (۴۰۱/۴۰۲) → زاپاس بی‌فایده است، پس تلاش اضافه نمی‌شود

tests/fake-openrouter.php — سرور جعلی OpenRouter برای تست زاپاس بدون اینترنت.
هر مدل با «bad» در نامش خطای ۵۰۳ می‌گیرد و بقیه پاسخ سالم.

backup.test.php — سه نکتهٔ مهم:
  • بازیابی روی SQLite در یک فایل موقت ساخته و اعتبارسنجی می‌شود و بعد
    جابه‌جا می‌شود؛ پس اگر فایل خراب باشد، دیتابیس فعلی دست‌نخورده می‌ماند
  • پیش از هر بازیابی، خودکار یک پشتیبان گرفته می‌شود
  • نام فایل‌های پشتیبان تصادفی است و پوشهٔ storage/backups از مرورگر مسدود است

mysql.test.php — این تست یک باگ واقعی را پیدا کرد و اصلاح شد:
  • ستون rows در MySQL واژهٔ رزرو است؛ نام ستون‌ها به row_count و
    table_count تغییر کرد
  • ساختار دو درایور (SQLite و MySQL) باید جدول و ستون هم‌نام داشته باشند
    تا دامپ یک درایور روی درایور دیگر قابل بازیابی باشد

jalali.test.php — نکته‌ها:
  • نقاط لنگر مستقل از پیاده‌سازی آزموده می‌شوند (۲۲ بهمن ۱۳۵۷، نوروز ۱۴۰۳/۱۴۰۴/۱۴۰۵،
    ۳۰ اسفند ۱۴۰۳ که کبیسه است، و…)، به‌علاوهٔ رفت‌وبرگشت هر تبدیل
  • پیوستگی ۱۲۰۰ روز پشت‌سرهم بررسی می‌شود تا مطمئن شویم هیچ روزی جا نمی‌افتد
  • هفته از شنبه آغاز می‌شود و جمعه تعطیل است
  • سازگاری با فراخوانی قدیمی حفظ شده: پارامتر دوم می‌تواند bool باشد
    (true = با ساعت، false = فقط تاریخ) یا رشتهٔ سبک («full»، «short»، «raw» و…)
  • به دیتابیس، شبکه یا هیچ کتابخانهٔ بیرونی وابسته نیست

telegram.test.php — نکته‌ها:
  • کاملاً آفلاین اجرا می‌شود: توکن عمداً خالی یا نامعتبر است تا هیچ درخواستی
    به api.telegram.org نرود؛ فقط منطق ماژول آزموده می‌شود
  • این تست یک باگ واقعی را پیدا کرد و اصلاح شد: tg_trim پسوند کوتاه‌سازی را
    جزو سقف حساب نمی‌کرد (پیام ۴ نویسه از حد تلگرام بلندتر می‌شد)
  • باگ دومی هم گرفت: tg_changes_text ستون‌های tool و note را می‌خواند که در
    جدول ai_actions وجود ندارند (نام درست: action و message)
  • نکتهٔ امنیتی آزموده‌شده: اگر هیچ مقصد (چت) تنظیم نشده باشد، هیچ‌کس مجاز
    نیست — وگرنه هر کسی با یافتن نشانی وبهوک می‌توانست با فرمان /ai اعتبار
    کلید OpenRouter را خرج کند
  • آمار بازدید: ربات‌ها، مدیر، درخواست POST و بازدید تکراری همان نشست
    شمرده نمی‌شوند؛ کلید روز به تقویم شمسی ذخیره می‌شود

۱۰) استودیوی خودکار
php tests/automation.test.php
۴۹ بررسی آفلاین؛ بدون کلید یا مصرف API. تولید واقعی مقاله و پیشنهاد واقعی کد نیازمند OpenRouter است.

php tests/automation-generation.test.php
۱۴ بررسی با مدل بدل قطعی؛ آزمون قرارداد تولید بدون تماس شبکه.

۱۱) کارمند هوشمند و تحویل مدل
php tests/employee.test.php
۵۳ بررسی با مدل بدل قطعی، SQLite و پشتیبان SQL واقعی؛ بدون تماس با OpenRouter.

۱۲) رگرسیون بازبینی ده‌محوره
php tests/review.test.php
۶۹ بررسی آفلاین؛ امنیت محتوا، SVG، رمز، مهاجرت، حافظه، کش و انتشار اتمی.

۱۳) Apache واقعی و نصب زیرمسیر
TEST_BASE_URL=http://127.0.0.1:8080 TEST_ALIAS_PATH=/subsite TEST_DOCROOT=/مسیر/نصب-آزمایشی python3 tests/http-review.test.py
۸۲ دروازه HTTP، نیازمند نصب آزمایشی و Alias واقعی؛ fixtureهای یکتا پس از تست پاک می‌شوند.

اصلاح روش JS: Node.js 18+ و jsdom@26 را فقط برای توسعه نصب کنید.
node tests/tabs.test.js
node tests/platform.test.js
TEST_BASE_URL اختیاری است (پیش‌فرض http://127.0.0.1:8000).
jsdom با روش معمول Node resolve می‌شود؛ NODE_PATH در صورت نصب جداگانه قابل تنظیم است.
HTML مستقیم از سرور دریافت می‌شود؛ دستورهای قدیمی ایجاد /tmp/page*.html دیگر لازم نیست.
برای نتایج نهایی و همه محدودیت‌ها ../REVIEW.md را بخوانید.

داشبورد (آفلاین، داده موقت):
    php tests/dashboard.test.php       → ۲۱ بررسی
    node tests/dashboard.test.js       → ۱۰ بررسی (نیازمند jsdom)

مدیریت خطا و چرخه خودکار (نسخه جدید):
    php tests/errors.test.php                  → ۴۳ بررسی
    php tests/workflow-auto.test.php           → ۲۱ بررسی
    TEST_DOCROOT=/مسیر/پیش‌نمایش python3 tests/operations-http.test.py
                                               → ۵۸ بررسی؛ فقط پیش‌نمایش یک‌بارمصرف
    node tests/operations-browser.test.js       → ۶۲ بررسی، نیازمند playwright و Chromium
تست‌های HTTP/مرورگر با admin/Pass1234 برای fixture توسعه نوشته شده‌اند؛ بسته نصب حساب آماده ندارد.
گزارش نهایی این انتشار در OPERATIONS-REVIEW.md است؛ شمارنده‌های قدیمی بالا تاریخی‌اند.

رگرسیون مخصوص [object HTMLInputElement] و کلودفلر:
    TEST_DOCROOT=/مسیر/پیش‌نمایش node tests/forms-browser.test.js
      Chromium واقعی؛ POSTها intercept می‌شوند، عملیات مخرب انجام نمی‌شود.
    TEST_DOCROOT=/مسیر/پیش‌نمایش node tests/model-telegram-browser.test.js
      ذخیره واقعی تنظیمات روی fixture، سپس بازگردانی مقادیر؛ روی سایت اصلی اجرا نکنید.
    php tests/providers-transport.test.php  → ۵۰ بررسی پنج سرویس با transport بدل
    node tests/cloudflare.test.mjs          → ۵۳ بررسی؛ D1/fetch بدل، نه حساب زنده
گزارش آخرین انتشار: HOTFIX-REVIEW.md. آزمون‌های مرورگر به playwright/Chromium نیاز دارند؛ نصب سایت هیچ‌کدام از این ابزارهای توسعه را نمی‌خواهد.

انتشار F5-NATIVE: نتایج قبلی این فایل تاریخی‌اند؛ HOTFIX-REVIEW.md نتیجه اجرای تازه است.
php tests/form-contract.test.php
node tests/native-edge-browser.test.js
forms-browser اکنون requestSubmit واقعی و ارسال native را با شنونده قدیمی شبیه‌سازی‌شده بررسی می‌کند.
workspace فقط AJAX خواندنی را می‌آزماید؛ POST نباید preventDefault شود.
