توسعهٔ افزونه حمل‌ونقل Yurtiçi Kargo برای nopCommerce

شرح کوتاه: برای فروشگاه nopCommerce [نسخه 4.8] یک افزونه می‌خواهیم که به وب‌سرویس Yurtiçi Kargo وصل شود و این امکانات را بدهد: ایجاد مرسولهٔ تک‌کُلی، لغو قبل از صدور بارنامه شعبه، دریافت وضعیت/رهگیری و چاپ لیبل. پیکربندی Test/Live، نگاشت وضعیت‌ها به سفارش، و مدیریت خطا/لاگ لازم است. چندکُلی نداریم. (در صورت نیاز، پشتیبانی COD هم می‌خواهیم.) مهارت‌ها: C#, .NET, nopCommerce Plugin Dev، SOAP/REST، تجربهٔ افزونه‌های حمل‌ونقل. درخواست ها: رزومه نمونه‌کار مشابه، طرح فنی کوتاه، زمان‌بندی و برآورد مرحله‌ای. SOW / Brief مفصل (برای قرارداد و اجرا) 1) هدف پروژه پیاده‌سازی افزونهٔ حمل‌ونقل Yurtiçi Kargo برای nopCommerce [نسخه: 4.8] با قابلیت‌های زیر: ایجاد مرسوله تک‌کُلی (تک بسته ای) (هر سفارش → یک cargoKey). (نیازی به امکان چند بسته در یک مرسوله نیست.) لغو مرسوله قبل از صدور بارنامه/فاکتور شعبه. دریافت وضعیت/رهگیری و همگام‌سازی با وضعیت سفارش در nopCommerce. چاپ لیبل ارسال. (اختیاری) پشتیبانی پرداخت در محل (COD/TT). 2) محدودهٔ دقیق کار (Scope) 2.1 پیکربندی در ادمین صفحهٔ تنظیمات افزونه با این موارد: آدرس سرویس‌ها (Test/Live)، نام‌کاربری/رمز، زبان سرویس. انتخاب حالت محیط (Test/Live) و ذخیرهٔ امن کرِدِنشال‌ها. نگاشت شهر/استان (در صورت نیاز) و فرمت لیبل. (در صورت COD) گزینه‌های COD و فیلدهای مربوط. IPهای مجاز/نکات امنیتی (راهنما). 2.2 ایجاد مرسوله (Create) ایجاد مرسوله فقط تک‌کُلی (تک بسته ای) با تولید cargoKey یکتا از شناسهٔ سفارش. اعتبارسنجی فیلدهای گیرنده (نام، آدرس کامل، شهر/استان، کدپستی، تلفن). ثبت نتیجه در سفارش (شماره مرسوله، کد/پیام بازگشت، زمان). عدم پشتیبانی از چندکُلی (UI و API بر همین اساس ساده‌سازی شود). 2.3 لغو مرسوله (Cancel) امکان لغو مرسوله با همان cargoKey تا قبل از قطعی‌شدن در شعبه. نمایش پیام وضعیت لغو و ثبت در نُت‌های سفارش. 2.4 رهگیری/گزارش (Query/Tracking) دریافت وضعیت جاری و پیام عملیاتی. بروزرسانی خودکار وضعیت سفارش (مثلاً: ایجاد شد/در حال ارسال/تحویل‌شده/لغوشده). رعایت فاصلهٔ زمانی منطقی بین درخواست‌های رهگیری (Rate Limit). لینک سریع «مشاهده رهگیری» در جزئیات سفارش ادمین. 2.5 چاپ لیبل تولید/چاپ لیبل شامل بارکد شماره مرسوله، نام و آدرس گیرنده، وزن/ابعاد (در صورت موجود)، تاریخ. امکان سفارشی‌سازی سادهٔ قالب (Logo/آدرس فرستنده). 2.6 COD (اختیاری) اگر فروشگاه COD فعال دارد: پُر کردن فیلدهای الزامی مبلغ/نوع جمع‌آوری، اعتبارسنجی مقادیر. نمایش واضح در UI که COD روی همان یک بسته اعمال می‌شود. 2.7 همگام‌سازی وضعیت سفارش نگاشت کُدهای وضعیت سرویس یورتچی به وضعیت‌های سفارش nopCommerce. ثبت تاریخچهٔ رویدادها (Log/Notes) برای پشتیبانی. 2.8 مدیریت خطا و لاگ هندل جامع خطاهای سرویس (کُد و پیام) + پیام کاربرپسند. ماسک‌کردن داده‌های شخصی در لاگ‌ها (PII). Retry محدود و Timeout معقول. 3) معماری و کیفیت کد افزونهٔ استاندارد nopCommerce (DI/Permissions/Settings). Service Layer مجزا برای فراخوانی وب‌سرویس (SOAP/REST هرچه داک می‌گوید). جداسازی DTO/Mapper و پوشش Unit Testهای کلیدی. قابل ارتقا برای افزودن «چندکُلی» در آینده (اما فعلاً غیرفعال). 4) تحویل‌دادنی‌ها (Deliverables) سورس‌کد کامل افزونه + بستهٔ نصب (.nop). سند نصب و راه‌اندازی (پیش‌نیاز IP، تنظیمات Test/Live، گام‌های تست). اسکریپت‌های تست Postman/SOAP UI برای سناریوهای ایجاد/لغو/رهگیری. قالب(های) لیبل + پیش‌نمایش. راهنمای نگاشت وضعیت‌ها و عیب‌یابی رایج. Changelog و راهنمای ارتقا. 5) معیارهای پذیرش (Acceptance Criteria) ایجاد مرسوله تک‌کُلی با فیلدهای صحیح → پاسخ موفق و ثبت cargoKey. لغو موفق قبل از صدور بارنامه شعبه → پیام وضعیت درست در سفارش. رهگیری: نمایش وضعیت به‌روز و نگاشت صحیح به سفارش؛ محدودیت درخواست‌ها رعایت شود. چاپ لیبل: بارکد و اطلاعات کلیدی درست باشند. (در صورت COD) ثبت موفق مرسوله با مقادیر COD و پیام خطای مناسب در صورت نقص. هیچ مسیر/دکمه/فیلدی برای چندکُلی وجود نداشته باشد و هر تلاش برای بیش از یک بسته با اعتبارسنجی رد شود. کد تمیز، مستندسازی‌شده، Build پایدار، بدون لاگ‌کردن PII. 6) برنامهٔ زمان‌بندی پیشنهادی (Milestones) M1 – طراحی و اسکلت افزونه، تنظیمات ادمین: [x روز] M2 – پیاده‌سازی Create/Cancel/Query + نگاشت وضعیت‌ها: [x روز] M3 – لیبل و (در صورت نیاز) COD: [x روز] M4 – تست یکپارچه با محیط Test و مستندسازی: [x روز] M5 – تحویل نهایی و پشتیبانی Go-Live: [x روز] 7) سناریوهای تست Happy Path: ایجاد → رهگیری → تحویل. Validation: آدرس/تلفن ناقص → خطای مناسب. Cancel: لغو پیش از قطعی‌شدن شعبه. COD (اگر فعال): بدون مبلغ/شناسه → خطای اعتبارسنجی. Timeout/شبکه: Retry محدود و پیام مناسب. 8) پیش‌نیازها و مفروضات ارائهٔ IP ثابت سرور برای ثبت در allowlist سرویس یورتچی. دسترسی‌های Test/Live (نام‌کاربری/رمز) از سوی کارفرما. نسخهٔ دقیق nopCommerce و لیست پلاگین‌های تداخل‌زا. داکیومنت‌های رسمی یورتچی (نسخه‌های ترکی/انگلیسی) در اختیار توسعه‌دهنده قرار می‌گیرد. 9) موارد درخواستی از فریلنسر در پیشنهاد تجربهٔ پروژه‌های مشابه (ترجیحاً افزونه‌های حمل‌ونقل nopCommerce). طراحی فنی مختصر: کتابخانهٔ SOAP/REST، مدیریت خطا، Rate Limit، ساختار DTO. زمان/هزینه به تفکیک Milestone. ماکاپ ساده از UI تنظیمات افزونه و صفحهٔ سفارش. 10) شرایط همکاری پشتیبانی پس از تحویل: [30/60/90] روز برای باگ‌فیکس. SLA رفع خطای بحرانی: [مثلاً 1 روز کاری]. مالکیت سورس کد برای کارفرما + NDA در صورت نیاز.