مفاهیم اصلی

Quote (استعلام) → Book (ثبت) → Track (ردیابی) → (Cancel — لغو)

if ($provider instanceof SupportsCOD) {
    $booking = $booking->withCashOnDelivery(Amount::fromToman(250_000));
}

$ersal = new Ersal(
    httpClient: $myHttpClient,
    logger: $myLogger,
    eventDispatcher: $myDispatcher,
    soapFactory: $mySoapFactory,
);

⁅هر مرسوله در ارسال از چرخه یکسانی پیروی کرد فارغ از اینکه کدا provider را انتخاب کرد quote استعلام book ثبت track ردیابی cancel لغو 1 quote قیمتگذاری قیمت گذاری مرسوله بدون ثبت لیستی از quote برمیگرد رمید گرداند گاهی یکی به ازای هر سطح سرویس 2 book ایجاد مرسوله کد رهگیری و شناسه مرسوله از طرف شرکت حمل دریافت شد 3 track دریافت وضعیت فعلی تاریخچه زمانی رویداد 4 cancel لغو در صورت مجاز بود توسط شرکت حمل و وضعیت مرسوله تما provider shippinginterface را پیادهسازی پیاد سازی کرد با تعویض یک رشت توانست provider را عوض کرد باقی کد شما دست نخورد ماند supportslabel provider که برچسب قابل چاپ داد supportspickup provider که جمعآوری جمعاوری جمع آوری از مبدا را برنامهریزی برنامه ریزی کرد supportsbranches provider که شعب فیزیکی داشت supportscod provider که پسکرایه پس کرایه cod را پذیرفت if provider instanceof supportscod booking booking withcashondelivery amount fromtoman 250 000 shipmentstatus یک enum با 10 حالت است وضعیت پایانی معنا draft خیر ساخت شد ولی هنوز ارسال نشد quoted خیر قیمتگذاری قیمت گذاری شد ثبت نشد booked خیر پذیر توسط شرکت حمل pickedup خیر جمعآوری جمعاوری جمع آوری توسط پیک intransit خیر در حال حرکت در شبکه outfordelivery خیر در حال تحویل نهایی delivered بله تحویل موفق failed بله تحویلناپذیر تحویل ناپذیر returned بله بازگشت به مبدا cancelled بله لغو شد shipmentstatus isterminal گفت آیا ایا polling بایست متوقف شد یا نه برای حذف خطا ممیز شناور parcel weightgrams گرم int parcel lengthmm widthmm heightmm میل میلی متر int amount ریال int هر provider خود واحد را به شکل مورد نیاز api تبدیل کرد تما value object و dto تغییرناپذیرند withstatus withhistory withcost نسخه جدید ساخت نسخه اصلی ثابت ماند ersal new ersal httpclient myhttpclient logger mylogger eventdispatcher mydispatcher soapfactory mysoapfactory همه اختیاری پیشفرض پیش فرض از ext curl و ext soap استفاد کرد ارسال هر دو را پشتیبانی کرد provider providerه soap پست ایران و rest بقیه تمایز از دید کد شما نامریی است همه shippinginterface را پیادهسازی پیاد سازی کرد⁆

⁅مفاهی اصلی⁆

⁅چرخه حیات مرسولهانتزاع providerقابلیت اختیاریمدل وضعیتواحد بدون اعداد اعشاری تغییرناپذیری immutability تزریق وابستگیsoap در مقابل rest⁆