TRO Suite · Pilot / Staging
ศูนย์ช่วยเหลือและคู่มือการใช้งาน
เอกสารนี้สรุปเฉพาะ Phase 1 ตามขอบเขตหน้าร้าน:
รับรถ → เปิดใบงาน → รับชำระเงิน → ออกเอกสาร → เจ้าของร้านดูรายงานเบื้องต้น
ในทุก URL ด้านล่าง ให้แทนที่ tenant ด้วยรหัสร้านของคุณ (เช่น banpong ในระบบทดลอง)
ภาพรวม flow Phase 1
- รับรถ — พนักงานเปิดหน้ารับรถ กรอกข้อมูลลูกค้า/รถ/บริการ แล้วบันทึกเพื่อสร้างใบงาน (service order)
- เปิดใบงาน — ตรวจสอบรายละเอียดใบงาน สถานะ และพิมพ์ใบสั่งงาน A4 ได้เมื่อต้องการ
- รับชำระเงิน — เปิดหน้ายืนยันการรับเงิน บันทึกวิธีชำระและจำนวนเงิน
- ออกเอกสาร — หลังชำระสำเร็จ ระบบสร้างใบเสร็จและลิงก์ไปหน้าพิมพ์ A5 / ใบกำกับภาษี A4 / 80mm
- เจ้าของร้านดูรายงาน — เข้า owner dashboard เพื่อดูยอดวันนี้ จำนวนใบเสร็จ และสรุปช่องทางชำระเงิน
ฟีเจอร์นอก Phase 1 (เช่น CRM เต็มรูปแบบ การจัดซื้อสต็อก หลายสาขา production) ไม่ได้อยู่ในคู่มือนี้
การเข้าสู่ระบบ
- เปิดหน้า เข้าสู่ระบบ (
/auth/login)
- กรอกอีเมลและรหัสผ่าน แล้วกดปุ่มส่งฟอร์ม (ฟอร์ม POST ไปที่
/auth/login/form)
- หลังเข้าสำเร็จ ระบบจะ redirect ไป dashboard ตามบทบาท เช่นเจ้าของไปที่
/{tenant}/owner/dashboard พนักงานไปที่ /{tenant}/ops/dashboard
- ออกจากระบบ: ใช้ปุ่มออกจากระบบในหน้า dashboard (ส่ง POST ไป
/auth/logout)
รับรถ / เปิดใบงาน (พนักงาน)
เปิดหน้ารับรถ
- ไปที่
/{tenant}/ops/vehicle-intake (ต้อง login แล้ว)
- กรอกข้อมูลตามฟอร์ม แล้วบันทึก — ระบบจะสร้างใบงานและพาไปหน้ารายละเอียดใบงาน
ดูรายละเอียดใบงาน
- เปิดจากรายการล่าสุดในหน้ารับรถ หรือใช้ URL รูปแบบ
/{tenant}/ops/service-orders/{id} โดย {id} คือเลข internal ของใบงาน
รับชำระเงิน
- จากใบงานที่ต้องการเก็บเงิน เปิดหน้า
/{tenant}/ops/payment-confirmation/{service_order_id}
- เลือกวิธีชำระ (เงินสด โอน บัตร ฯลฯ ตามที่ระบบแสดง) กรอกจำนวนและรายการ แล้วยืนยัน
- เมื่อสำเร็จ ระบบมัก redirect ไปหน้ารวมใบเสร็จพร้อมเลือกใบที่เพิ่งสร้าง เช่น
/receipts?selected_receipt_id=...
พิมพ์เอกสาร (Phase 1)
ทุกลิงก์ด้านล่างเป็นเส้นทางจริงของระบบ ต้อง login ตามสิทธิ์ของแต่ละหน้า
ใบสั่งงาน / ใบตรวจ A4 (Service order)
- HTML:
/{tenant}/ops/service-orders/{service_order_id}/print
- PDF (ถ้าเซิร์ฟเวอร์รองรับ headless browser):
/{tenant}/ops/service-orders/{service_order_id}/print.pdf
ใบเสร็จ A5 / ใบกำกับภาษี A4 / 80mm
แทน {receipt_id} ด้วยเลข id ของใบเสร็จในระบบ (ดูได้จากหน้า /receipts หลังชำระเงิน)
- A5 ใบเสร็จ (HTML):
/receipts/{receipt_id}/print
- A5 ใบเสร็จ (PDF):
/receipts/{receipt_id}/print.pdf
- A4 ใบกำกับภาษี / ใบเสร็จ (HTML):
/receipts/{receipt_id}/tax-invoice
- A4 ใบกำกับภาษี (PDF):
/receipts/{receipt_id}/tax-invoice.pdf
- 80mm (HTML):
/receipts/{receipt_id}/receipt-80mm
- 80mm (PDF):
/receipts/{receipt_id}/receipt-80mm.pdf
บางสภาพแวดล้อม (โดยเฉพาะ Linux บน cloud) การส่งออก PDF อาจต้องมี Chrome/Chromium แบบ headless — ถ้า PDF เปิดไม่ได้ ให้ลองพิมพ์จากหน้า HTML ก่อน หรือแจ้งผู้ดูแลระบบ
ดูรายการใบเสร็จ / พิมพ์ซ้ำ
- เปิด
/receipts เพื่อดูรายการและเลือกใบเพื่อพิมพ์ซ้ำ
- ถ้ามีพารามิเตอร์
selected_receipt_id ใน URL ระบบจะโฟกัสใบนั้นโดยอัตโนมัติ
Owner dashboard (เจ้าของร้าน)
- สรุปภาพรวม:
/{tenant}/owner/dashboard หรือ /{tenant}/owner/executive-summary (ทั้งคู่แสดง dashboard เดียวกันในรอบนี้)
- ดูยอดเงินวันนี้ จำนวนใบเสร็จที่ใช้งาน และสรุปช่องทางชำระเงิน
- มีลิงก์ไปประวัติใบเสร็จผ่าน
/receipts
ตั้งค่าข้อมูลร้าน (Business / seller profile)
- เปิด
/{tenant}/settings/profile (ต้อง login และมีสิทธิ์เข้าถึง tenant นั้น)
- ใช้แก้ชื่อร้าน ที่อยู่ เลขผู้เสียภาษี สาขา และข้อมูลที่แสดงบนเอกสาร Phase 1
FAQ / Pilot notes
เข้าระบบไม่ได้
- ตรวจอีเมล/รหัสผ่าน และว่าเบราว์เซอร์ไม่บล็อกคุกกี้ session
- ถ้าเห็นข้อความเกี่ยวกับฐานข้อมูล auth ให้ติดต่อผู้ดูแล (ฝั่ง shared auth DB)
เอกสารพิมพ์ไม่ออกหรือ PDF ว่าง
- ลองเปิดเวอร์ชัน HTML ก่อน (ลิงก์ที่ลงท้ายด้วย
/print หรือ /tax-invoice ฯลฯ)
- บนเซิร์ฟเวอร์บางแพลตฟอร์ม ไฟล์
.pdf อาจต้องการเบราว์เซอร์แบบ headless — ถ้าไม่แน่ใจให้แจ้งผู้ดูแล
เลขเอกสารไม่ตรงที่คาด
- ระบบออกเลขใบงานและใบเสร็จตามกฎในระบบ — หากตัวเลขกระโดดหลังรีเซ็ต DB หรือข้ามปี ให้ถือว่าเป็นพฤติกรรมของ seed/ฐานข้อมูลทดลอง
ข้อมูลร้านบนเอกสารไม่ขึ้น
- ตรวจ
/{tenant}/settings/profile ว่าบันทึกแล้ว และลองเปิดพิมพ์ใหม่
เข้า path ร้านแล้วขึ้นให้ login
- ส่วนใหญ่หมายถึง session หมดอายุหรือออกจากระบบแล้ว — เข้า
/auth/login ใหม่