README

این پکیج یک زیرسیستم ماژولار برای مدیریت حمل‌ونقل در پروژه‌های لاراولی است و در حال حاضر درایور Snapp Box را پیاده‌سازی می‌کند. ساختار به گونه‌ای طراحی شده که اضافه‌کردن سرویس‌های جدید مانند تی‌باکس در آینده ساده باشد.

نصب

1. پوشه را داخل مسیر packages/arnavision/shipping قرار دهید.
2. دستور composer dump-autoload را اجرا کنید تا اتولود به‌روزرسانی شود.
3. در صورت نیاز، کانفیگ را منتشر کنید:

php artisan vendor:publish --tag=shipping-config

متغیرهای محیطی

SHIPPING_DEFAULT_DRIVER=snappbox
SNAPPBOX_BASE_URI=https://api.snappbox.ir
SNAPPBOX_CLIENT_ID=...
SNAPPBOX_CLIENT_SECRET=...
SNAPPBOX_USERNAME=...
SNAPPBOX_PASSWORD=...
SNAPPBOX_WEBHOOK_SECRET=...
SNAPPBOX_PRICING_BASE_URI=https://b2b.snapp-box.com
SNAPPBOX_PRICING_PATH=/v1/pricing
SNAPPBOX_PRICING_AUTHORIZATION=Bearer ...
# یا در صورت نیاز:
# SNAPPBOX_PRICING_TOKEN=Bearer ...
SNAPPBOX_PICKUP_LATITUDE=...
SNAPPBOX_PICKUP_LONGITUDE=...
SNAPPBOX_PICKUP_ADDRESS=...
SNAPPBOX_PICKUP_PHONE=...
SNAPPBOX_PICKUP_CONTACT=...

استفاده

use Arnavision\Shipping\Facades\Shipping;

$response = Shipping::driver()->createDelivery($payload);

اضافه‌کردن درایور جدید

1. یک کلاس در مسیر src/Drivers/<Vendor>/<DriverName>Driver.php بسازید و از Arnavision\Shipping\Abstracts\Driver ارث‌بری کنید.
2. متدهای قرارداد ShippingGatewayInterface را پیاده‌سازی کنید.
3. کانفیگ مربوط به درایور را داخل config/shipping.php اضافه کنید.
4. در صورت نیاز، در ShippingManager::resolve یا با استفاده از Shipping::driver()->extend() درایور جدید را رجیستر کنید.

به این ترتیب می‌توانید تی‌باکس یا سایر سرویس‌های لجستیک را نیز به سادگی متصل نمایید.