اصلاح ناموجود نشدن محصولات حذف‌شده سیکا — ۲۲ اکتبر ۲۰۲۶ نسخه: confirmed-missing-sync-2026-10-22 نصب روی ربات موجود: ۱. از check_sikair_monitor.php فعلی یک نسخه پشتیبان بگیرید. ۲. فقط check_sikair_monitor.php داخل بسته اصلاح را روی فایل هم‌نام در پوشه ربات جایگزین کنید: /home/aminzari/public_html/sikair_monitor_bundle/check_sikair_monitor.php ۳. پوشه data_sikair، فایل state.json، فایل site_sync_map.json و کانفیگ‌های سرور را حذف یا جایگزین نکنید. ۴. همان کرون قبلی کافی است. اجرای دستی: php -q /home/aminzari/public_html/sikair_monitor_bundle/check_sikair_monitor.php علت مشکل: کد قبلی فقط محصولات حاضر در فهرست جدید را روی مقصد سینک می‌کرد. ناپدید شدن محصول از API صرفاً اعلان داشت و دستور ناموجودسازی مقصد نداشت. پس از ذخیره فهرست جدید، محصول غایب از state نیز کنار می‌رفت؛ نگاشت دائمی آن هنوز موجود بود. رفتار جدید: - پس از اسکن کامل، فهرست جدید با نگاشت‌های دائمی مقصد مقایسه می‌شود؛ حذف‌های قدیمی نیز بررسی می‌شوند. - نبودن در فهرست به تنهایی مجوز ناموجودسازی نیست؛ صفحه خود محصول بررسی می‌شود. - HTTP 404/410، غیرفعال شدن محصول اصلی صفحه یا اتمام موجودی همه تنوع‌هایش، مبنای تأیید است. - برخی محصولات غایب همچنان صفحه HTTP 200 دارند ولی enabled=false هستند؛ این حالت از داده ساختاری همان محصول خوانده می‌شود. - موجودی محصولات پیشنهادی صفحه ملاک قرار نمی‌گیرد. - صفحه‌ای که محصول اصلی‌اش هنوز موجود است، خطای اتصال، پاسخ 403/5xx یا اطلاعات نامعتبر باعث ناموجودسازی نمی‌شود. - اسکن ناقص، صفحه تکراری، تعداد نامطابق یا تمام شدن سقف صفحات باعث توقف بخش ناموجودسازی می‌شود. - ناموجودسازی فقط روی ID ثبت‌شده در site_sync_map انجام می‌شود؛ محصول جدید ساخته و محصول مقصد حذف نمی‌شود. - available=false، stock_type=out_of_stock و stock=0 اعمال می‌شود؛ موجودی تمام تنوع‌های مقصد نیز صفر می‌شود. - عنوان، توضیحات، دسته و قیمت برای ناموجودسازی بازنویسی نمی‌شوند. - نتیجه با GET مقصد بررسی می‌شود. فقط موفقیت تأییدشده ثبت می‌شود؛ خطا برای اجرای بعد باقی می‌ماند و محصول بعدی بررسی می‌شود. - محصولی که دوباره در فهرست مبدا ظاهر شود، با همان نگاشت مقصد همگام می‌شود. کنترل اختیاری: بخش site_sync کانفیگ می‌تواند شامل گزینه زیر باشد؛ اگر نباشد، رفتار جدید فعال است: 'mark_missing_out_of_stock' => true, برای نصب عادی نیازی به تغییر کانفیگ نیست. لاگ‌ها در data_sikair/monitor.log: PATCH_VERSION=confirmed-missing-sync-2026-10-22 MISSING_SYNC_OK: ناموجودسازی تأیید شده یا محصول مقصد قبلاً حذف شده است. MISSING_SYNC_KEEP: موجودی مبدا برقرار بوده یا نبودن موجودی قابل تأیید نبوده است؛ تغییری اعمال نشده. MISSING_SYNC_FAIL: خطای اعمال یا تأیید مقصد؛ در اجرای بعد دوباره بررسی می‌شود. MISSING_SYNC_DONE: جمع‌بندی تعداد بررسی‌شده، موفق و ناموفق. اعتبارسنجی انجام‌شده: - بررسی نحوی تمام فایل‌های PHP با PHP 8.3.6 موفق بود. - تست‌های آفلاین برای نگاشت قدیمی بدون state، 404/410، enabled=false با موجودی مثبت بعضی تنوع‌ها، محصول موجود، timeout، صفحه نامعتبر، شناسه نامطابق، اسکن ناقص، صفر شدن موجودی تنوع‌ها، حفظ قیمت و محتوا، ادامه پس از خطا، تلاش دوباره پس از PATCH ناموفق یا تأیید ناموفق و بازگشت محصول موفق بودند. - استخراج اطلاعات از سه HTML کامل واقعی مبدا با درخواست خواندنی بررسی شد. - هیچ درخواست تغییردهنده‌ای به مقصد و هیچ پیام واقعی به روبیکا ارسال نشده است. تست آفلاین اختیاری در نسخه کامل: php tests/missing_products_test.php نکته نصب: نسخه کامل شامل داده‌های زمان ارسال شماست. برای به‌روزرسانی ربات موجود فقط فایل PHP اصلاح‌شده را جایگزین کنید. نگاشت دائمی باید حفظ شود تا محصولات غایب قدیمی قابل پیگیری بمانند. بررسی اولیه نگاشت‌های قدیمی ممکن است از اجراهای عادی طولانی‌تر باشد.