Amirali Yaghoutiمهندس ارشد نرم‌افزار

مطالعه موردی مهندسی

همگام‌سازی موجودی و قیمت مارکت‌پلیس

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

مسئله تجاری

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

آنچه تحویل دادم

  • a2-excel-price-sync، یک افزونه‌ی عملیات ووکامرس که به‌روزرسانی‌های دسته‌ای قیمت و موجودی را از ورودی‌های CSV تولیدشده از گردش کار اکسل پردازش می‌کند.
  • قوانین تطبیق برند و مرجع برای یافتن محصولی که یک ردیف به آن اشاره دارد، به‌جای تکیه بر یک شناسه‌ی واحد.
  • داده‌ی گارانتی و سایر ویژگی‌ها که از همان خط لوله عبور می‌کنند، تا فهرست‌های مارکت‌پلیس با فروشگاه هماهنگ بمانند.
  • مدیریت تایم‌اوت ساخته‌شده برای ایمپورت‌های طولانی، چون یک به‌روزرسانی به اندازه‌ی کاتالوگ در یک درخواست تمام نمی‌شود.
  • اعتبارسنجی پیش از تغییر، تا فایلی که تمیز تطبیق نمی‌خورد گزارش شود نه اینکه نیمه‌اعمال شود.

رویکرد فنی

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

نتیجه و شواهد

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

اهمیت برای کارفرما

دقت قیمت در کانال‌های مختلف جایی است که فروش در مارکت‌پلیس برده یا باخته می‌شود، و کاملاً یک مسئله‌ی عملیاتی است نه استراتژیک.

خلاصه-اجرایی-پروژه

خلاصه اجرایی خوانا

خلاصه_اجرایی {
  پروژه: "Marketplace Stock and Pricing Sync"
  افزونه: "a2-excel-price-sync (عملیات ووکامرس)"
  ورودی: "CSV تولیدشده از گردش کار اکسل تأمین‌کننده"
  تطبیق: "قوانین لایه‌ای برند + مرجع، نه یک فیلد"
  ترتیب: "کامل اعتبارسنجی کن، سپس تغییر بده؛ هرگز نیمه‌اعمال"
  مدت: "طراحی‌شده برای ایمپورت طولانی؛ تایم‌اوت مورد انتظار است"
  خارج_از_مخزن: "فایل تأمین‌کننده، لیست قیمت، خروجی،
                 لاگ، اعتبارنامه"
}

ارزش حرفه‌ای این پروژه

اعتبارسنجی پیش از تغییر ثابتی است که از آن دفاع می‌کنم. روی یک کاتالوگ زنده، توانایی ردکردن یک فایل بد از توانایی پردازش سریع یک فایل خوب ارزشمندتر است.

قوانین تطبیق لایه‌ای وجود دارند چون داده‌ی تأمین‌کننده واقعاً ناهماهنگ است. فرض یک شناسه‌ی تمیز همان اشتباهی است که به‌روزرسانی‌های با اطمینانِ غلط تولید می‌کند.