+
-
-
نوع:
-
جهت:
-
-
فرستنده:
-
-
-
گیرنده:
-
-
-
-
-
تاریخچه رهگیری
-
+
+
+
+ نوع
+
-
+
+ جهت
+
+
+
+ فرستنده
+
+
+
+ گیرنده
+
+
+
+ مبدأ
+
+
+
+ مقصد
+
+
+
+ وزن
+ kg
+
+
+ تاریخ ثبت
+
+
+
+
+
+
+
🚚 تاریخچه رهگیری
+
+
+
+
+
+
+
+
+
+
+
+
📍
+
+
+
+
+
+
+
+
+
+
+
🚚 تاریخچه رهگیری
+
+ هنوز رویداد ترکینگی ثبت نشده است.
+
+
+
+
+
+
+
🏢 شرکتهای حمل
+
+
+
+
+ | کد رهگیری:
+
+
+ | وضعیت:
+
+
+
+
+
true, 'html' => $html));
}
@@ -253,47 +473,8 @@ function ifnex_get_transactions_ajax() {
return;
}
- // ساخت HTML لیست تراکنشها
- if (empty($transactions['transactions'])) {
- wp_send_json(array(
- 'success' => true,
- 'html' => '
هنوز تراکنشی ثبت نشده است.
',
- ));
- return;
- }
-
- ob_start();
- ?>
-
-
-
-
-
-
-
-
-
-
-
-
کد پیگیری:
-
-
-
-
-
- true,
- 'html' => $html,
+ 'transactions' => $transactions['transactions'] ?? array(),
));
}
diff --git a/04_Laravel/README.md b/04_Laravel/README.md
index 88256fd..191736b 100644
--- a/04_Laravel/README.md
+++ b/04_Laravel/README.md
@@ -22,7 +22,7 @@
## 🎯 نمای کلی
-این پوشه شامل **هسته مرکزی سیستم IFNEX** است که شامل چهار بخش اصلی میشود:
+این پوشه شامل **هسته مرکزی سیستم IFNEX** است که شامل پنج بخش اصلی میشود:
### ۱. REST API کامل
ارتباط با WordPress از طریق Sanctum Token + Bridge Auth (بدون رمز عبور) — ۳۰+ endpoint برای تمام عملیات مشتری (سفارش، پرداخت، کیف پول، نوتیفیکیشن، رهگیری).
@@ -36,6 +36,9 @@
### ۴. سیستم مالی و سندسازی
کیف پول دیجیتال، درگاه پرداخت Zarinpal، تولید خودکار PDF (AWB, Invoice, Label) با بارکد استاندارد و سیستم نوتیفیکیشن دیتابیس.
+### ۵. Multi-Package و Invoice (فاز ۳.۵)
+پشتیبانی از چند بسته در یک سفارش، فرم اقلام گمرکی (Invoice) برای محمولههای PARCEL، و محاسبه خودکار وزن حجمی از ابعاد.
+
---
## 🚀 نصب و راهاندازی سریع
@@ -298,11 +301,11 @@ curl -X POST http://localhost:8000/api/v1/customer/orders \
| Model | جدول | توضیح | فاز |
|-------|------|--------|-----|
| Country | countries | ۲۳۳ کشور با ۴ زون + calling_code | ۰ |
-| Shipment | shipments | مرسولهها (مدل مرکزی) | ۰ |
-| ShipmentItem | shipment_items | اقلام گمرکی | ۰ |
-| ShipmentPackage | shipment_packages | بستههای چندگانه | ۲ |
+| Shipment | shipments | مرسولهها (مدل مرکزی) | ۰+۲+۳.۵ |
+| ShipmentItem | shipment_items | اقلام گمرکی (Invoice) | ۰+۳.۵ |
+| ShipmentPackage | shipment_packages | بستههای چندگانه (Multi-Package) | ۳.۵ |
| ShipmentCarrierMapping | shipment_carrier_mappings | نگاشت شرکتهای حمل | ۰ |
-| ShipmentTrackingEvent | shipment_tracking_events | رویدادهای ترکینگ | ۰ |
+| ShipmentTrackingEvent | shipment_tracking_events | رویدادهای ترکینگ | ۰+۲ |
| ShipmentStatusHistory | shipment_status_histories | تاریخچه تغییرات وضعیت | ۲ |
| ShippingRate | shipping_rates | تعرفههای حمل | ۰ |
| SystemSetting | system_settings | تنظیمات key-value | ۰ |
diff --git a/04_Laravel/app/Filament/Resources/ShipmentResource.php b/04_Laravel/app/Filament/Resources/ShipmentResource.php
index 296fb88..d615bfd 100644
--- a/04_Laravel/app/Filament/Resources/ShipmentResource.php
+++ b/04_Laravel/app/Filament/Resources/ShipmentResource.php
@@ -514,7 +514,7 @@ class ShipmentResource extends Resource
->success()
->send();
})
- ->deselectAfterCompletion(),
+ ->deselectRecordsAfterCompletion(),
]),
]);
}
diff --git a/04_Laravel/app/Http/Controllers/Api/TrackController.php b/04_Laravel/app/Http/Controllers/Api/TrackController.php
index 191bded..ae48b18 100644
--- a/04_Laravel/app/Http/Controllers/Api/TrackController.php
+++ b/04_Laravel/app/Http/Controllers/Api/TrackController.php
@@ -2,57 +2,73 @@
namespace App\Http\Controllers\Api;
+use App\Http\Controllers\Controller;
use App\Models\Shipment;
-use App\Services\TrackingService;
use Illuminate\Http\JsonResponse;
-class TrackController
+/**
+ * API ترکینگ مرسولات — فاز ۰
+ *
+ * GET /api/v1/track/{awb_no}
+ *
+ * خروجی: تایملاین کامل رویدادهای ترکینگ + اطلاعات پایه مرسوله + نگاشتهای شرکت حمل
+ */
+class TrackController extends Controller
{
- public function __construct(protected TrackingService $tracking) {}
-
+ /**
+ * دریافت تایملاین ترکینگ یک مرسوله
+ */
public function show(string $awb_no): JsonResponse
{
- $shipment = Shipment::where('awb_no', $awb_no)->firstOrFail();
+ $shipment = Shipment::where('awb_no', $awb_no)
+ ->with([
+ 'fromCountry:id,name,iso_code',
+ 'toCountry:id,name,iso_code',
+ 'carrierMappings:id,shipment_id,carrier_code,carrier_tracking_number,booking_number,direction,delivery_status,notes',
+ 'trackingEvents' => fn ($query) => $query->orderBy('event_date', 'desc')->orderBy('event_time', 'desc'),
+ ])
+ ->first();
- $events = $shipment->trackingEvents()
- ->orderByDesc('event_date')
- ->orderByDesc('event_time')
- ->get();
-
- $mappings = $shipment->carrierMappings;
+ if (!$shipment) {
+ return response()->json([
+ 'success' => false,
+ 'message' => 'مرسولهای با این کد یافت نشد',
+ 'awb_no' => $awb_no,
+ ], 404);
+ }
return response()->json([
- 'awb_no' => $shipment->awb_no,
- 'direction' => $shipment->direction->value,
- 'type' => $shipment->type->value,
- 'status' => $shipment->status->value,
- 'sender' => [
- 'name' => $shipment->sender_name,
- 'company' => $shipment->sender_company,
- 'phone' => $shipment->sender_phone,
- 'city' => $shipment->sender_city,
+ 'success' => true,
+ 'data' => [
+ 'shipment' => [
+ 'awb_no' => $shipment->awb_no,
+ 'direction' => $shipment->direction?->value,
+ 'type' => $shipment->type?->value,
+ 'status' => $shipment->status?->value,
+ 'status_label' => $shipment->status?->label(),
+ 'from_country' => $shipment->fromCountry?->name,
+ 'to_country' => $shipment->toCountry?->name,
+ 'sender_name' => $shipment->sender_name,
+ 'receiver_name' => $shipment->receiver_name,
+ 'weight' => $shipment->weight,
+ 'created_at' => $shipment->created_at?->toIso8601String(),
+ ],
+ 'carrier_mappings' => $shipment->carrierMappings->map(fn ($mapping) => [
+ 'carrier_code' => $mapping->carrier_code,
+ 'carrier_tracking_number' => $mapping->carrier_tracking_number,
+ 'booking_number' => $mapping->booking_number,
+ 'delivery_status' => $mapping->delivery_status,
+ 'notes' => $mapping->notes,
+ ]),
+ 'tracking_events' => $shipment->trackingEvents->map(fn ($event) => [
+ 'date' => $event->event_date?->toDateString(),
+ 'time' => $event->event_time ? ($event->event_time instanceof \Carbon\Carbon ? $event->event_time->format('H:i') : $event->event_time) : null,
+ 'location' => $event->location,
+ 'description' => $event->event_description,
+ 'status' => $event->delivery_status,
+ 'source' => $event->source,
+ ]),
],
- 'receiver' => [
- 'name' => $shipment->receiver_name,
- 'company' => $shipment->receiver_company,
- 'phone' => $shipment->receiver_phone,
- 'city' => $shipment->receiver_city,
- ],
- 'carrier_mappings' => $mappings->map(fn ($m) => [
- 'carrier_code' => $m->carrier_code->value,
- 'tracking_number' => $m->carrier_tracking_number,
- 'booking_number' => $m->booking_number,
- 'delivery_status' => $m->delivery_status?->value,
- 'notes' => $m->notes,
- ]),
- 'timeline' => $events->map(fn ($e) => [
- 'date' => $e->event_date->format('Y-m-d'),
- 'time' => $e->event_time->format('H:i'),
- 'location' => $e->location,
- 'description' => $e->event_description,
- 'delivery_status' => $e->delivery_status?->value,
- 'source' => $e->source->value,
- ]),
]);
}
}
diff --git a/04_Laravel/app/Models/Shipment.php b/04_Laravel/app/Models/Shipment.php
index 37b4369..204e868 100644
--- a/04_Laravel/app/Models/Shipment.php
+++ b/04_Laravel/app/Models/Shipment.php
@@ -61,6 +61,9 @@ class Shipment extends Model
'weight' => 'decimal:3',
'volumetric_weight' => 'decimal:3',
'chargeable_weight' => 'decimal:3',
+ 'status' => \App\Enums\ShipmentStatus::class,
+ 'direction' => \App\Enums\ShipmentDirection::class,
+ 'type' => \App\Enums\ShipmentType::class,
];
// === Relationships ===
diff --git a/README.md b/README.md
index d44c0c1..afab767 100644
--- a/README.md
+++ b/README.md
@@ -179,11 +179,15 @@ IFNEX-Logistics/
- اصلاح متدهای Enum (isPaid, canBeCancelledByCustomer)
- میدلور API برای بازگرداندن JSON 401 به جای redirect
-### فاز ۳.۵ — اصلاحات اساسی 🔄 (در دست اقدام)
-- Multi-Package در فرم سفارش مشتری (چند بسته در یک سفارش)
-- فرم Invoice برای محمولههای PARCEL (اقلام گمرکی)
-- پشتیبانی کامل چندزبانه (i18n) با Polylang
-- تست و نهاییسازی
+### فاز ۳.۵ — اصلاحات اساسی ✅ (تکمیل شده - 90%)
+- **Multi-Package** در فرم سفارش مشتری (چند بسته در یک سفارش)
+- **فرم Invoice** برای محمولههای PARCEL (اقلام گمرکی با HS Code)
+- **بازطراحی PDFها** (AWB, Invoice, Label) با بارکد مطابق نمونه کارفرما
+- **تست ترکینگ** کامل با timeline زیبا و چندمرحلهای
+- محاسبه خودکار وزن حجمی از ابعاد (فرمول: L×W×H/5000)
+- ساختار ۵ مرحلهای فرم سفارش (مسیر → تماس → اقلام → تخفیف → تأیید)
+- اصلاحات فنی (Enum casts, migration, model)
+- پشتیبانی چندزبانه (i18n) — به زمان دیپلوی منتقل شد
### فاز ۴ (آینده) — سیستم نمایندگی 📋
- مدل نمایندگی کامل با کمیسیون و پنل جداگانه
@@ -334,9 +338,7 @@ php artisan serve
## 🚀 مراحل بعدی
-### فاز ۳.۵ (فوری — قبل از ارائه به کارفرما)
-- Multi-Package در فرم سفارش مشتری
-- فرم Invoice برای محمولههای PARCEL
+### فاز ۳.۵ — باقیمانده (زمان دیپلوی)
- پشتیبانی کامل چندزبانه (i18n) با Polylang
### فاز ۴ (آینده)