اصلاح لینک و بازیابی شناسه محصولات ناب‌پارت — ۱۲ نوامبر ۲۰۲۶ نصب روی هاست: ۱. کرون cron_sync.php را موقتاً غیرفعال کنید و اجازه دهید اجرای در حال کار تمام شود. ۲. از پوشه ربات و دیتابیس پشتیبان بگیرید. ابزار ترمیم نیز قبل از تغییر نگاشت‌ها پشتیبان خودکار می‌گیرد. ۳. این پنج فایل بسته اصلاح را در پوشه فعلی bot3 جایگزین/اضافه کنید: product_identity.php nobparts.php cron_sync.php mixin_api.php repair_product_identity.php فایل config.php و پوشه data سرور را جایگزین نکنید. دیتابیس را پاک نکنید. ۴. اجرای روی هاست، با همان نسخه PHP که کرون قبلی استفاده می‌کرد: cd /home/aminzari/public_html/bot3 php repair_product_identity.php --apply اگر FAILED=0 و INVALID=0 بود و برنامه با خطا تمام نشد: php cron_sync.php ۵. پس از اجرای موفق، کرون قبلی را دوباره فعال کنید. اگر ALREADY_RUNNING دیدید، اجرای قبلی هنوز قفل را دارد؛ آن اجرا باید تمام شود. فایل cron.lock را حذف نکنید. گزارش بدون اعمال تغییرات (اختیاری، قبل از --apply): php repair_product_identity.php این حالت محصولات و نگاشت‌ها را تغییر نمی‌دهد، اما برای بررسی مالکیت محصولات از مقصد GET می‌گیرد. چه چیزی اصلاح می‌شود: - لینک نسبی با / صحیح به دامنه وصل می‌شود؛ لینک کامل دوباره به دامنه چسبانده نمی‌شود. - لینک فارسی، لینک درصدگذاری‌شده، http/https و دامنه با/بدون www برای تطبیق یک هویت دارند. - شکل خراب مشاهده‌شده در حادثه، یعنی چسبیدن مستقیم نام فارسی محصول به nobparts.com، برای بازیابی شناخته می‌شود. - تطبیق بر اساس آدرس معادل است؛ شباهت عنوان به‌تنهایی مجوز انتخاب محصول نیست. - نگاشت‌های دارای چند شناسه مقصد، اجرای معمول را متوقف می‌کنند تا ترمیم شوند. - پاسخ 404 محصول دارای نگاشت دیگر مجوز ساخت مجدد نیست. - ایجاد محصول جدید قبل از POST یک نشانگر پایدار می‌گیرد؛ پاسخ نامطمئن یا قطع ارتباط باعث POST مجدد خودکار نمی‌شود. - پاسخ به‌روزرسانی با GET مقصد بررسی می‌شود؛ فقط تغییر عنوان معیار موفقیت نیست. - در اسکن ناقص، صفحه تکراری یا خالی شدن زودرس صفحه، ناموجودسازی محصولات غایب اجرا نمی‌شود. - سابقه محلی کالا هنگام تغییر شکل لینک دوباره استفاده می‌شود؛ برای همین تفاوت، رکورد و اعلان محصول جدید ساخته نمی‌شود. - لینک‌های قدیمی کدگذاری‌شده صرفاً به‌خاطر تفاوت نگارش، حذف‌شده محسوب نمی‌شوند. رفتار ترمیم: ابزار ابتدا از جدول‌های site_sync_map، site_sync_category_map، products و جدول پیگیری ترمیم پشتیبان JSON می‌گیرد. برای هر گروه، فقط وقتی یک شناسه دارای آدرس صحیح قدیمی و شناسه‌های دارای آدرس خراب وجود داشته باشند، آن را آماده ترمیم می‌داند. شناسه NP_ محصول مقصد باید با آدرس ثبت‌شده آن در نگاشت تطبیق داشته باشد. شناسه مشترک بین دو کالای متفاوت یا مالکیت نامطابق رد می‌شود. جزئیات کامل محصولات مقصد نیز قبل از اصلاح هر گروه ذخیره می‌شود. نگاشت‌های گروه به شناسه کالای اصلی برمی‌گردند و وضعیت عضویت دسته برای همگام‌سازی دوباره پاک می‌شود. ابزار ترمیم در این مرحله موجودی کالای اصلی را حدس نمی‌زند و محصول مقصد را حذف فیزیکی نمی‌کند. در اجرای بعدی cron_sync.php، داده و موجودی روز مبدا روی کالای اصلی با همان شناسه اعمال می‌شود. فقط پس از موفقیت و تأیید کالای اصلی، نسخه‌های تکراری همان گروه ناموجود می‌شوند. اگر درخواست ناموفق شد، وضعیت ترمیم برای اجرای بعد باقی می‌ماند. محل گزارش و پشتیبان: data/identity_repair_<تاریخ>_<شماره>/report.csv در همان پوشه، snapshot جدول‌ها و فایل remote_.json قرار دارد. پوشه‌ها را برای امکان بررسی و بازگردانی نگه دارید. اگر FAILED یا INVALID غیرصفر بود، موارد مبهم در گزارش مشخص می‌شوند و ترمیم آن موارد خودکار انجام نمی‌شود. در حالت --apply، فایل data/identity_repair.pause مانع اجرای کرون می‌شود تا موارد مبهم بررسی شوند. این فایل را برای عبور از خطا حذف نکنید؛ report.csv لازم است بررسی شود. پس از رفع مشکل، ابزار را دوباره اجرا کنید. اجرای مجدد برای گروه‌هایی که نگاشتشان قبلاً اصلاح شده، محصول جدیدی ایجاد نمی‌کند. محدودیت‌ها: ترمیم روی دیتابیس واقعی همان هاست اجرا می‌شود؛ ZIP ارسالی شامل دیتابیس MySQL نیست. محصولی که واقعاً در مقصد حذف شده یا نشانگر NP_ آن عوض شده، خودکار بازسازی یا تصاحب نمی‌شود و نیازمند بررسی است. تغییر کامل slug به نام نامرتبط با لینک قبلی، صرفاً از روی شباهت عنوان به هم متصل نمی‌شود. پیغام UNCERTAIN_CREATE_REVIEW_REQUIRED یعنی نتیجه یک ایجاد قبلی نامطمئن بوده؛ قبل از هر تلاش دیگر باید وجود آن محصول در مقصد بررسی شود. بررسی هزاران محصول ممکن است طولانی باشد؛ خروجی CHECKED_READY و PROGRESS پیشرفت را نشان می‌دهد. اعتبارسنجی انجام‌شده: PHP 8.3.6: همه فایل‌های PHP از نظر نحوی صحیح‌اند. تست‌های تشخیص موجودی قبلی و به‌روزرسانی عنوان موفق بودند. تست‌های هویت لینک، انتخاب شناسه قدیمی، رد تطبیق مبهم، بازیابی اصلی قبل از ناموجودسازی تکراری، توقف در خطای اصلی، عدم ساخت پس از 404، جلوگیری از تکرار POST نامطمئن و تأیید موجودی مقصد موفق بودند. تست ذخیره‌سازی با PDO شبیه‌سازی‌شده انجام شده است؛ روی MySQL یا سایت زنده شما اجرا نشده است. هیچ پیام واقعی یا تغییر محصول واقعی از این محیط ارسال نشده است. نسخه کامل شامل فایل‌ها و لاگ‌های زمان ارسال شماست. برای نصب روی ربات موجود از بسته اصلاح پنج‌فایلی استفاده کنید. فایل‌های ZIP قدیمی داخل پوشه، نسخه‌های پیشین‌اند و نباید برای این اصلاح نصب شوند.