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

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

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

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

مسئله تجاری

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

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

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

رویکرد فنی

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

نتیجه و شواهد

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

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

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

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

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

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

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

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

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