📦 ระบบรับส่งพัสดุ

Flow การทำงาน

1. ลูกค้าฝากพัสดุที่สาขาต้นทาง — พนักงานกรอกข้อมูลในระบบ → ระบบสร้างรหัส PR + YYMMDD + 6 chars + PIN 6 หลัก
2. พิมพ์ใบฝากส่งให้ลูกค้า + ใบฉลากแปะกล่อง
3. มอบหมายให้เที่ยวรถ — เลือกเที่ยวที่จะส่ง
4. พิมพ์ใบสรุปคนรถ — รายการพัสดุทั้งหมดในเที่ยวนั้น
5. รถออก → status = in_transit
6. ถึงสาขาปลายทาง → สแกน QR เข้าสาขา → ระบบแจ้งเตือนสาขาอัตโนมัติ
7. ผู้รับมารับ → สแกน QR + กรอก PIN 6 หลัก → ส่งมอบเสร็จ

รับพัสดุใหม่

เมนู: พัสดุ → + รับพัสดุใหม่

กรอกข้อมูลใน 4 ส่วน:

การ์ดราคา (ฝั่งขวา) — Live calc

ระบบคำนวณราคาแบบ realtime เมื่อเปลี่ยนต้นทาง/ปลายทาง/น้ำหนัก/ประเภท/มูลค่าประกัน

• ระยะทาง
• ค่าส่งพื้นฐาน
• ค่าน้ำหนัก
• ค่าธรรมเนียมประเภท
• ค่าประกัน
• ยอดรวม (ปัดเศษ 5 บาท)

เลือกวิธีชำระ

กด "บันทึก + พิมพ์ใบฝากส่ง" → save → redirect ไปหน้า detail พร้อมปุ่ม:

• 🧾 พิมพ์ใบฝากส่ง (parcel_receipt.php)
• 🏷️ พิมพ์ฉลากพัสดุ (parcel_label.php)

รายการพัสดุ

เมนู: พัสดุ

Stat cards ด้านบน

• 🔵 รับแล้ว — ที่ต้นทาง รอมอบหมายเที่ยว
• 🟡 อยู่ระหว่างขนส่ง — บนรถแล้ว
• 🔵 ถึงสาขาปลายทาง — รอผู้รับมารับ
• 🟢 ส่งมอบแล้ว — เสร็จ

Filter

• ค้นหา รหัสพัสดุ / ชื่อผู้ส่ง / ผู้รับ / เบอร์
• กรองสถานะ
• กรองสาขาปลายทาง

Action ในแต่ละแถว

• 👁️ ดูรายละเอียด (timeline + actions ตามสถานะ)
• 🖨️ พิมพ์ใบฝากส่งซ้ำ
• 🏷️ พิมพ์ฉลากซ้ำ

หน้ารายละเอียดพัสดุ

คลิกรหัสพัสดุ → หน้านี้แสดง:

• ข้อมูลพัสดุ — ต้นทาง/ปลายทาง น้ำหนัก ประเภท คำอธิบาย
• ผู้ส่ง / ผู้รับ — ชื่อ + โทร
• Timeline — ประวัติทุก event มี timeline เป็นจุดสี + เวลา + สถานี + ผู้ดำเนินการ
• ราคา breakdown + สถานะการชำระ
• QR + PIN ใหญ่ๆ

Actions (ทำได้ตามสถานะ)

สแกน QR Code

เมนู: สแกนพัสดุ — มี 3 tabs

📷 Tab 1: สแกนผ่านกล้อง

1. กด "เริ่มสแกน" → เบราว์เซอร์ขออนุญาตกล้อง → อนุญาต
2. หันกล้องไปที่ QR บนใบฝากส่ง/ฉลาก
3. ระบบอ่าน QR อัตโนมัติ → load ข้อมูลพัสดุ

🖼️ Tab 2: สแกนจากรูปภาพ

• คลิกเลือกไฟล์ — PNG, JPG, WebP
• Drag & Drop — ลากรูปเข้าโซน
• Ctrl+V — วางรูปจาก clipboard (แชต / สกรีนช็อต)
• ระบบสแกนและ load ข้อมูลอัตโนมัติ

⌨️ Tab 3: กรอกรหัสด้วยมือ

กรอก PR260517XXXXXX → กดค้นหา

หลังสแกนเจอแล้วทำอะไรได้?

• ถ้าพัสดุยังเดินทาง (in_transit/loaded): ปุ่ม "สแกนเข้าสาขา" — อัปเดต status = arrived + แจ้งเตือนสาขา
• ถ้าพัสดุถึงสาขาแล้ว (arrived): ฟอร์มกรอก PIN 6 หลัก + ชื่อผู้รับจริง → ส่งมอบ → status = delivered + เก็บเงิน COD (ถ้ามี)

ใบสรุปส่งของให้คนรถ

เมนู: ใบสรุปส่งของ

1. เลือกวันที่ที่ต้องการดู
2. ตารางแสดงทุกเที่ยวในวันนั้นพร้อม:
   • รหัสเที่ยว + เส้นทาง + เวลาออก
   • ทะเบียนรถ
   • จำนวนพัสดุ + น้ำหนักรวม + รายได้รวม
3. กดปุ่ม "พิมพ์" สำหรับเที่ยวที่มีพัสดุ → เปิด manifest_print.php

ใบสรุปคนรถมีอะไร?

• หัวเอกสาร: รหัสเที่ยว วันที่ เวลาออก
• ข้อมูลรถ + พนักงานขับ
• ตารางพัสดุ: รหัส, ปลายทาง (highlight), ผู้รับ+โทร, ประเภท, น้ำหนัก, ชิ้น, ราคา, COD ที่ต้องเก็บ (สีแดง)
• Total row: น้ำหนักรวม + จำนวนชิ้น + รายได้
• ลายเซ็น 3 ช่อง: เจ้าหน้าที่ส่ง · พนักงานขับ · เจ้าหน้าที่รับ (ปลายทาง)

สถานะพัสดุทั้ง 8 แบบ

การคำนวณราคา

$base       = max(min_price, distance × baht_per_km)
$weight     = max(0, weight − free_kg) × baht_per_kg
$type_mult  = doc 0.8× | parcel 1× | fragile 1.3× | oversized 1.5×
$surcharge  = ($base + $weight) × ($type_mult − 1)
$insurance  = max(10, declared_value × 0.01)
$total      = round(($base + $weight + max(0,$surcharge) + $insurance) / 5) × 5

ค่า settings (แก้ได้)