ماژول همگام‌سازی موجودی در سطح محصول با موجودی در سطح ترکیب برای پرستاشاپ 1.0.0

ماژول همگام‌سازی موجودی برای پرستاشاپ یک ابزار حرفه‌ای و هوشمند است که با هدف رفع مغایرت بین موجودی سطح محصول اصلی و موجودی ترکیبات آن ساخته شده است. در سیستم پرستاشاپ، هر محصول می‌تواند ترکیب‌های مختلفی داشته باشد، مانند رنگ، سایز یا مدل، که هرکدام دارای موجودی مجزا هستند. اگر مجموع موجودی این ترکیبات با موجودی سطح محصول هماهنگ نباشد، داده‌های انبار، گزارش‌ها و خروجی‌های فروشگاهی دچار خطا می‌شوند. این ماژول دقیقاً برای حل همین مسئله طراحی شده است.

ما زمانی متوجه این موضوع شدیم که داشتیم با صفحه ساز سایت بیلدر ( Element Flow ) کار میکردیم و میخواستیم تنظیم کنیم که بر اساس ناموجود بودن محصولات جزئیاتی مثل قیمت رو به مشتری نمایش ندهیم. مشکل این بود که ماژول سایت بیلدر به موجودی ها در سطح محصول نگاه میکرد و به موجودیها در سطح ترکیبات نگاه نمیکرد. بنابراین با وجود آنکه یک محصول همه ترکیباتش ناموجود بودند اما جون موجودی در سطح محصول غیر صفر بود دیگه آن محصول رو ناموجود تشخیص نمیداد و به اشتباه قیمت محصول رو برای محصول ناموجود نمایش میداد. 

هدف و عملکرد ماژول

هدف اصلی ماژول، ایجاد هماهنگی دائمی میان موجودی سطح محصول و موجودی ترکیب‌هاست.

با استفاده از این افزونه، موجودی محصولات به‌طور خودکار با جمع موجودی ترکیبات آن‌ها همسو می‌شود تا هیچ اختلاف عددی در فروشگاه باقی نماند. این فرآیند از خطاهای انبارداری جلوگیری کرده و عملکرد سیستم فروش، گزارش‌ها و همگام‌سازی با مآژول ها و پلتفرم‌های خارجی (مانند صفحه سازها مارکت‌پلیس‌ها یا ERPها) را دقیق‌تر و قابل‌اعتمادتر می‌کند.

فرآیند فنی و منطق SQL

درون کد ماژول، کلاس مدیریتی PsSoftStockManager وظیفه جمع‌آوری اطلاعات از جداول پایه پرستاشاپ را دارد:

• جدول محصولات (product)
• جدول ترکیبات (product_attribute)
• جدول موجودی‌ها (stock_available)

ماژول با اجرای کوئری هوشمند، مجموع موجودی ترکیب‌های هر محصول را محاسبه و آن را با موجودی سطح اصلی (id_product_attribute = 0) جایگزین می‌کند.

فقط محصولاتی که اختلاف عددی دارند (یعنی «مغایرت» وجود دارد) در لیست مدیریتی نمایش داده می‌شوند.

قابلیت‌های مدیریتی در بک‌آفیس پرستاشاپ

پس از نصب ماژول، گزینه‌ی جدیدی با نام Stock Sync در زیرمنوی «کاتالوگ» اضافه می‌شود. در این صفحه، مدیریت فروشگاه لیست محصولات دارای اختلاف موجودی را می‌بیند.

در جدول مدیریت، ستون‌هایی برای شناسه محصول، نام، موجودی سطح محصول، مجموع موجودی ترکیبات و اختلاف عددی وجود دارد.

در کنار هر محصول دکمه‌هایی برای:

• همگام‌سازی تکی (Sync)
• صفر کردن موجودی (Zero)

و همچنین در بالا:

• همگام‌سازی همه (Sync All)
• صفر کردن همه (Zero All)

نمایش داده می‌شوند.

در پایین جدول، مجموع تعداد محصولات دارای مغایرت به‌صورت عددی قابل‌مشاهده است.

اتصال به Cron Job برای اجرای خودکار

ماژول دارای دو فایل کران داخلی است:

• cron_sync.php که کار همگام‌سازی خودکار را انجام می‌دهد.
• cron_zero.php برای صفر کردن دوره‌ای موجودی‌ها در فرآیندهای خاص یا تستی.

در صفحه‌ی مدیریت ماژول، دستورهای curl جهت اجرای کران نمایش داده می‌شوند، مانند:

curl -s https://yourshop.com/modules/pssoft_stock_management/cron_sync.php > /dev/null 2>&1

این ساختار باعث می‌شود که کران همیشه سبک و سازگار با انواع هاست‌ها اجرا شود. توصیه می‌شود به‌جای اجرای مستقیم PHP CLI، از همین دستور curl در Cron هاست استفاده شود تا هم پایدارتر و هم ایمن‌تر باشد.

سازگاری کامل با نسخه ۸ پرستاشاپ و حالت چندفروشگاهی

ماژول بر اساس ساختار کلاس‌ها و قالب‌های جدید PrestaShop 8 طراحی شده است تا هیچ خطا، ناسازگاری یا مشکل در بارگذاری فایل‌ها وجود نداشته باشد.

همچنین به‌طور کامل از حالت Multi-Shop پشتیبانی می‌کند. یعنی اگر فروشگاه شما چنددامنه‌ای باشد، موجودی هر فروشگاه به‌صورت مستقل و جداگانه همگام‌سازی می‌شود.

ترجمه‌پذیری و چندزبانه بودن

تمام رشته‌های متنی در قالب TPL و PHP با ساختار استاندارد ترجمه ({l s='' mod='pssoft_stock_management'}) نوشته شده‌اند.

برای زبان‌های فارسی و انگلیسی دو فایل ترجمه آماده وجود دارد:

• translations/fa.php
• translations/en.php

زبان فارسی کاملاً طبیعی، روان و مطابق استاندارد UI پرستاشاپ و زبان انگلیسی مناسب نمایش در محیط‌های بین‌المللی است.

ویژگی منحصربه‌فرد هنگام تبدیل محصولات ترکیب‌دار به استاندارد

اگر مدیر فروشگاه محصولی دارای ترکیبات را حذف کند یا تصمیم بگیرد آن را به محصول استاندارد (بدون ترکیب) تبدیل کند، ماژول به‌صورت خودکار موجودی سطح جدید را برابر مجموع موجودی ترکیبات قبلی تنظیم می‌کند.

این مکانیزم از خطاهای رایج جلوگیری می‌کند؛ برای مثال، اگر یک محصول دارای سه ترکیب با موجودی‌های ۲، ۵ و ۳ باشد، بعد از حذف ترکیب‌ها و تبدیل محصول به حالت استاندارد، موجودی کل محصول به‌طور خودکار ۱۰ تنظیم می‌شود — یعنی جمع مجموع قبلی.

این مورد یکی از ویژگی‌های تخصصی و مهم ماژول به‌شمار می‌رود و باعث اعتماد بیشتر مدیران فروشگاه در زمان تغییر ساختار محصولات می‌شود.

مزایای کلیدی ماژول

• حذف دائمی مغایرت‌های موجودی
• تضمین هماهنگی عددی در تمامی محصولات
• همگام‌سازی خودکار، دستی و فله‌ای
• سازگاری کامل با پرستاشاپ 8 و چند فروشگاهی
• ترجمه فارسی و انگلیسی آماده
• نصب آسان و بدون نیاز به تنظیمات یا توابع اضافی
• نمایش دقیق تعداد محصولات ناسازگار در پنل
• اجرای مطمئن کران‌جاب با دستورات Curl
• امکان صفرسازی سریع موجودی‌ها برای کنترل دوره‌ای

نحوه نصب و راه‌اندازی

۱. فایل ZIP ماژول را از بخش مدیریت ماژول‌های پرستاشاپ بارگذاری و نصب کنید.

۲. پس از نصب، تب مدیریتی جدید با نام Stock Sync یا با نام "همگام سازی موجودی" در کاتالوگ ظاهر می‌شود.

۳. وارد صفحه مدیریت شوید و عملیات همگام‌سازی یا صفر کردن را اجرا کنید.

۴. اگر نیاز به عملکرد خودکار دارید، دستور کران را در سی‌پنل یا دایرکت ادمین هاست ثبت نمایید.

تمام این مراحل بدون نیاز به کدنویسی و از طریق رابط کاربری انجام می‌شود.

الزامات سیستم

• نسخه‌های سازگار: پرستاشاپ 8 و بالاتر
• نسخه پی اچ پی : ‎7‎٫‎4‎ تا ‎8‎٫‎2‎
• هاست دارای قابلیت اجرای Curl و Cron Job
• فعال بودن تابع curl_exec() در PHP

درباره توسعه‌دهنده

توسعه توسط تیم نرم‌افزاری PSSoft انجام شده است؛ تیمی باتجربه در توسعه افزونه‌های بهینه‌سازی داده و انبار برای سیستم پرستاشاپ.

تمرکز تیم بر ارائه ابزارهایی برای دقت بیشتر در داده‌ها و سهولت مدیریت موجودی فروشگاه‌هاست.

نتیجه‌گیری

با نصب ماژول همگام‌سازی موجودی در سطح محصول با موجودی در سطح ترکیب برای پرستاشاپ، مغایرت‌های موجودی در فروشگاهتان برای همیشه رفع می‌شود.

این افزونه تضمین می‌کند عدد موجودی هر محصول اصلی دقیقاً برابر مجموع موجودی تمام ترکیبات آن باشد و حتی در شرایط تغییر ساختار (تبدیل به محصول استاندارد)، هماهنگی کامل حفظ شود.

در نتیجه، انبار شما همیشه منطبق با واقعیت است، گزارش‌ها صحیح‌اند، و هیچ اختلالی در فیدهای خروجی یا سیستم‌های فروش خارجی رخ نخواهد داد.