Skip to content

PROSHIP_KNOWLEDGE.md

Latest commit

 

History

History
185 lines (137 loc) · 9.95 KB

PROSHIP_KNOWLEDGE.md

File metadata and controls

185 lines (137 loc) · 9.95 KB

ProShip Easy — Knowledge Base

สรุปทุกอย่างที่บีรู้เกี่ยวกับ ProShip Easy อัปเดต: 2026-02-28

1. ภาพรวมโปรเจกต์

ProShip Easy คือ white-label ของระบบ FlashSub ที่สร้างให้ K. Jiaw (คุณจิ๋ว) ใช้บริหารเครือข่ายร้านรับพัสดุ ~500 สาขา

โครงสร้างผู้ใช้

K. Jiaw (Master Admin)
    └── สาขา 1..500 (Branch Users)
            └── ลูกค้าที่มาส่งพัสดุ
  • Master: ตั้งราคาต้นทุน, อนุมัติเติมเงิน, ดูรายงานทุกสาขา
  • Branch: ตั้งราคาขาย, สร้างออเดอร์, เติมเงิน, ดูกำไรตัวเอง
  • กำไรสาขา = ราคาขาย − ราคาต้นทุน (master ตั้ง)
  • กำไร master = ราคาต้นทุนที่ขายให้สาขา − ต้นทุนจริงจากขนส่ง

2. หน้าจอในระบบ (5 หน้า)

หน้า URL ผู้ใช้ หน้าที่
Login /index.html ทุกคน เลือก role (Master/สาขา) + login
Master Dashboard /master-dashboard.html Master บริหารสาขา, อนุมัติเติมเงิน, รายงาน, สร้างออเดอร์ด่วน
Branch /branch.html สาขา สร้างออเดอร์, ดูรายการ, เติมเงิน, รายงาน
Settings /settings.html Master only ตั้งราคาต้นทุน, lock ราคาสาขา
Reports /reports.html Master สรุปยอดทุกสาขา, export

Live: https://proship-jiew.netlify.app/

3. ฟีเจอร์หลัก

Master Dashboard

  • Sidebar เมนู: Dashboard, สาขา, อนุมัติเติมเงิน, รายงานการใช้งาน, รายงานการเงิน, ตั้งค่า
  • จัดการสาขา: ดูรายการสาขาทั้งหมด, สถานะ, ยอดใช้งาน, ปุ่มเข้าระบบแทนสาขา
  • สร้างสาขาใหม่: กรอกชื่อสาขา + username + password + ราคาต้นทุนแยกตามกิโล
  • ราคาต้นทุน: ตั้งเป็นช่วงกิโล (0-3 กก., 3-5 กก., 5-10 กก., ...) ทั้ง 4 ขนส่ง เพิ่มช่วงได้
  • อนุมัติเติมเงิน: ดูสลิป, ยืนยัน, หรือปฏิเสธ (พร้อมกรอกเหตุผล)
  • ⚡ ทางลัดออเดอร์: Master ลงออเดอร์เองได้ มีข้อมูลผู้ส่ง + ผู้รับ + ขนส่ง + COD
  • รายงาน: แยกเป็น "การใช้งาน" (ออเดอร์/สาขา) และ "การเงิน" (เติมเงิน/wallet)

Branch

  • Sidebar: สร้างรายการ, รายการทั้งหมด, รายงาน, เติมเงิน
  • Wallet Badge: แสดงยอดเงินบน header ตลอดเวลา (🟢 ปกติ / 🟠 < ฿500)
  • สร้างออเดอร์: ผู้ส่ง + ผู้รับ + ขนส่ง + น้ำหนัก + ประกัน + COD + สรุปราคา
  • ประกันสินค้า: สวิตช์เปิด/ปิด → คำนวณอัตโนมัติ 0.5% ขั้นต่ำ ฿5
  • COD: สวิตช์เปิด/ปิด → กรอกยอด (ไม่เปิดไม่ต้องกรอก)
  • ตารางราคา: ราคาขาย (แก้ได้), ต้นทุน (🔒 lock), กำไร (คำนวณอัตโนมัติ)
  • รายการทั้งหมด: ตารางออเดอร์ + filter ขนส่ง/สถานะ + tracking number
  • เติมเงิน: อัปโหลดสลิป → รอ master อนุมัติ → ดูประวัติ (สำเร็จ/รอ/ปฏิเสธ+เหตุผล)

4. ขนส่งที่รองรับ

ขนส่ง สีใน UI ราคาต้นทุนโดยประมาณ
J&T Express 🔴 แดง 18-25 ฿
Flash Express 🟡 เหลือง 13-23 ฿
Kerry Express 🟢 เขียว 12-27 ฿
ไปรษณีย์ไทย 🟠 ส้ม 17-28 ฿

ราคาจริงจากขนส่ง (ข้อมูลอ้างอิง)

Flash Express

  • <1,000 ชิ้น/เดือน: 23 ฿
  • 1,000: 22 ฿ | 3,000: 17 ฿ | 10,000+: 13 ฿
  • COD: 2.5% (<1500 ชิ้น) → 1% (6000+)

Kerry

  • 5-9 ชิ้น/วัน: 27 ฿ | 50-99: 20 ฿ | 300+: 12 ฿
  • COD: 2% → 1%

ไปรษณีย์

  • Retail: 28 ฿ | Volume 10k+: 17 ฿
  • Remote areas: +15 ฿

J&T

  • ราคาง่าย ไม่ซับซ้อน: 18-25 ฿ ขึ้นกับปลายทาง

5. ระบบราคา (Pricing Logic)

ต้นทุนจริง (จากขนส่ง)
    ↓ [master set เป็นราคาต้นทุนให้สาขา]
ราคาต้นทุน (locked, สาขาเห็นแต่แก้ไม่ได้)
    ↓ [สาขา set ราคาขายเอง]
ราคาขาย (ที่สาขาคิดลูกค้า)

กำไรสาขา = ราคาขาย − ราคาต้นทุน
กำไร master = ราคาต้นทุน (ที่ขายให้สาขา) − ต้นทุนจริง

ราคาตั้งตาม น้ำหนักกิโลกรัม ไม่ใช่กรัม:

  • 0-3 กก., 3-5 กก., 5-10 กก., 10-15 กก., 15-20 กก.
  • เพิ่มช่วงน้ำหนักได้ตามต้องการ

6. ระบบ Wallet / เติมเงิน

  • สาขาแต่ละสาขามี wallet ของตัวเอง
  • ระบบ wallet แยกต่างหาก ไม่ใช้ wallet ของ ProShip
  • สาขาส่งสลิป → master เห็นใน dashboard → อนุมัติ/ปฏิเสธ
  • หาก master ปฏิเสธ → ต้องกรอกเหตุผล (สาขาเห็นเหตุผลใน history)
  • ประวัติการเติมเงินทุกรายการอยู่ในรายงานการเงิน

7. ประกันสินค้า

  • สวิตช์ เปิด/ปิด ต่อออเดอร์
  • อัตรา: 0.5% ของมูลค่าพัสดุ
  • ขั้นต่ำ: ฿5
  • สูตร: max(5, มูลค่าพัสดุ × 0.005)
  • ผู้กรอกออเดอร์ (สาขา) เป็นคนเปิด/ปิดเองได้

8. ใบเสร็จรับเงิน

  • ออกใบเสร็จ แยกตามผู้ส่ง/ร้านค้า
  • ข้อมูลในใบเสร็จ: ชื่อร้าน, ที่อยู่, เลขประจำตัวผู้เสียภาษี, เบอร์โทร
  • ตั้งค่าได้ใน Master Dashboard (Shop/Sender Settings)
  • Filter รายงานแยกตามร้านค้าเพื่อออกใบเสร็จได้

9. Tech Stack (Reference: FlashSub)

ส่วน เทคโนโลยี
Frontend HTML5, Tailwind CSS, Alpine.js
Backend Node.js + Express
Database Supabase (PostgreSQL + Auth + RLS)
Hosting Frontend Netlify
Hosting Backend Render.com
Shipping API ProShip API
Printing PDF (standard) + Paperang (thermal Bluetooth)

Mockup ปัจจุบัน: HTML5 + Tailwind CSS (CDN) + Vanilla JS

10. สิ่งที่ยังรอ (Open Questions)

หัวข้อ สถานะ
ใบเสร็จ format ตัวอย่าง ⏳ รอจากสิงห์
Me2plus คืออะไร ⏳ รอ reference
JT + Flash API integration detail ⏳ รอ spec
Backend/database จริง ⏳ mockup เท่านั้น ยังไม่มี backend
Authentication จริง ⏳ ยังเป็น mock (admin/1234)
Printer integration (Paperang) ⏳ ยังไม่ได้คุย
Mobile app ⏳ ยังไม่ได้คุย

11. ข้อมูล ProShip Platform

ปัญหาที่พบบ่อย

  • "ทำออเดอร์ไม่ได้" → ลืมเลือกร้านค้า / รหัสไปรษณีย์ผิด
  • "ระบบช้า" → clear browser cache
  • "เข้าไม่ได้" → ต้องติดต่อ support (ไม่มี self-reset)

จัดทำโดย: บี (ProShip-Singh Agent) GitHub: https://github.com/viktv159-lab/proship-integration