5.7 KiB
Executable file
5.7 KiB
Executable file
اصلاح و توسعه یکپارچهسازی با باشگاه مشتریان «دوباره»
در وبهوک و پایپلاین ارسال دیتای سفارشها و کاربران به سامانه دوباره (https://api-docs.dobare.me/redoc/)، اصلاحات زیر در ۳ بخش محاسبه مبالغ، سیستم برچسبگذاری (Tags) و بکفیل تاریخچه اعمال میشود.
۱. اصلاح منطق محاسبه و تفکیک مبالغ سفارش
در حال حاضر فقط مبلغ پرداختی نهایی به دوباره فرستاده میشود که باعث تحریف گزارشهای ارزش کل خرید (GMV) شده است. فیلدهای ارسالی باید به ۳ بخش تفکیک شوند:
- ارزش کل خرید (Gross Amount):
- جمع کل قیمت پایه و مصوب بلیتها، قبل از اعمال هرگونه کد تخفیف.
- این مبلغ باید در فیلد اصلی مبلغ سفارش دوباره (
total_paid_amount) فرستاده شود تا ستون «مبلغ سفارش» در پنل دوباره، رقم ناخالص واقعی را نشان دهد.
- مبلغ پرداختی مشتری (Paid Amount):
- رقم نهایی کسر شده از درگاه پرداخت مشتری (پس از اعمال کوپن).
- ارزش و کد تخفیف (Discount):
- اختلاف ارزش کل و پرداختی در فیلد
discount_amount. - عنوان کوپن استفاده شده در فیلد
discount_code.
- اختلاف ارزش کل و پرداختی در فیلد
- API هدف:
POST /v1/orders/
۲. ساختار برچسبهای سگمنتیشن (الگوی Prefix--Value--)
تمامی برچسبهای رفتاری، مکانی و مشخصات بازی باید با فرمت استاندارد زیر تولید و در آرایه member_labels_to_add ارسال شوند:
الف) نگاشت نوع بازی و سطح ترس (fear_level)
1→Fear--scary--(اتاق فرار ترسناک)2→Fear--notscary--(اتاق فرار غیرترسناک)3→Fear--semiscary--(اتاق فرار نیمهترسناک)658→Category--cinematars--(سینما ترس)683→Category--feartour--(تور وحشت)688→Category--angerroom--(اتاق خشم)746→Category--axethrowing--(پرتاب تبر)794→Category--cafecinema--(کافه سینما)867→Category--pottery--(تجربه سفالگری)1419→Category--karaoke--(کارائوکه)3375→Category--lasertag--(لیزرتگ)3438→Category--boardgame--(بردگیم)3487→Category--class--(کلاس آموزشی)3542→Category--travel--(سفر گروهی)3629→Category--tour--(تور)3803→Category--event--(رویداد / جلسه)house→Category--hauntedhouse--(هانتد هاوس)
ب) اطلاعات پروفایل کاربر
- جنسیت:
Gender--آقا--/Gender--خانم--/Gender--نامشخص-- - تاریخ تولد: ارسال در فیلد
birth_dateکاربر (فرمتYYYY-MM-DD).
ج) اطلاعات رزرو و متادیتا
- شهر:
City--[نام شهر]--(مثال:City--تهران--) - منطقه / محله:
Area--[نام محله]--(مثال:Area--صادقیه--) - ژانر بازی:
Genre--[عنوان ژانر]-- - سبک بازی:
Style--[عنوان سبک]-- - مناسب برای:
Suitable--[مخاطب]-- - تعداد نفرات:
Headcount--[تعداد]-- - روش پرداخت:
Payment--عادی--/Payment--اسنپپی--/Payment--اعتباری-- - پارامترهای تحلیلی:
CFC--[مقدار]--وGEN--[مقدار]--
۳. بررسی و همگامسازی دیتای گذشته (Backfill)
در حال حاضر فقط حدود ۱۳ هزار شماره در دوباره موجود است که نشاندهنده عدم انتقال دیتای کامل است.
- بررسی اولیه:
- بررسی لاگ و زمان اولین تراکنش سینک شده در سیستم جهت کشف بازه مفقود.
- اولویت اول:
- انتقال کامل کل تاریخچه کاربران و سفارشهای اکیپا از ابتدای فعالیت.
- اولویت دوم (حداقلی):
- انتقال کامل کلیه سفارشها و کاربران از تاریخ
۱۴۰۴/۰۱/۰۱تا کنون به همراه مبالغ اصلاحشده و تگهای جدید.
- انتقال کامل کلیه سفارشها و کاربران از تاریخ
- مدیریت ترافیک (Rate Limiting):
- ارسال دستهای (Batch) با محدودیت حداکثر ۵ الی ۱۰ ریکوئست در ثانیه جهت جلوگیری از خطای
429 Too Many Requests.
- ارسال دستهای (Batch) با محدودیت حداکثر ۵ الی ۱۰ ریکوئست در ثانیه جهت جلوگیری از خطای
نکات مهم فنی
- شناسه یکتا (
source_order_id): ارسال شناسه سفارش اکیپا الزامی است تا در صورت اجرای مجدد اسکریپت، سفارش تکراری ساخته نشود. - سقف برچسبها: حداکثر ۱۰۰ برچسب برای هر کاربر در دوباره مجاز است؛ برچسبهای تکراری پیش از ارسال حذف شوند (
Set). - تست نمونه اولیه: قبل از اجرای بکفیل کلی، ۳ الی ۵ سفارش نمونه از دستههای مختلف (ترسناک، سینما ترس، بردگیم و خرید تخفیفدار) در دوباره تست و تأیید محصول گرفته شود.
تخمین زمانی پیادهسازی
- تیم هدف: ۱ نفر برنامهنویس بکاند (Node.js)
- مدت زمان تخمینی: ۳ روز کاری (۲۴ ساعت کاری)