G-OnsiteUAT

คู่มือทดสอบระบบ (UAT)

ระบบ Tracking งาน Onsite Support — สำหรับทีมทดสอบ ก่อน Go Live ทำตามสถานการณ์ทดสอบในเอกสารนี้ทีละขั้น และติ๊ก checklist เมื่อผ่าน

เข้าใช้งานg-onsite.pages.dev
LoginGoogle OAuth (เฉพาะ email ใน Whitelist)
เวอร์ชันUAT · อัปเดต ก.ค. 2026

ภาพรวม

G-Onsite จัดการ workflow งาน Onsite ครบวงจร: HQ เปิดงาน → Admin จ่ายช่าง → ช่างรับงาน เดินทาง (บันทึก GPS) ถึงสาขา ทำงาน เซ็นปิดเคส พร้อมระบบ Spare Parts และ AI Chatbot

1 เข้าสู่ระบบ

เปิดเว็บ ไปที่ g-onsite.pages.dev
กด "เข้าสู่ระบบด้วย Google" แล้วเลือกบัญชี email ที่ได้ลงทะเบียนไว้สำหรับ UAT
ต้องอยู่ใน Whitelist ถ้า email ไม่อยู่ในรายชื่อที่ Admin เพิ่มไว้ จะขึ้น "ไม่มีสิทธิ์เข้าใช้งาน" — แจ้งผู้ดูแลให้เพิ่ม email
ℹ️ บัญชี UAT เดียวทดสอบได้ทั้ง 3 บทบาท ไม่ต้อง login หลายบัญชี — ใช้ตัวสลับมุมมองมุมขวาบน (ดูข้อ 3)

2 3 บทบาทในระบบ

AO

Admin Onsite

ฝ่ายปฏิบัติการ

จ่ายงานให้ช่าง · ดึงงานกลับ · จ่าย Spare / รับคืนของเสีย · ดู Dashboard

HQ

HQ Manager

ฝ่ายกำกับดูแล

สร้างงาน (Create Job) · ดู Dashboard oversight · ประวัติงาน · Branch Master · คลัง Spare กลาง

ช่างทดสอบ (Technician)

ช่างหน้างาน

รับงาน · Onsite (GPS) · ถึงสาขา · บันทึก Log · พักงาน · เซ็นปิดเคส · เบิก/ใช้ Spare · ถาม AI

3 สลับมุมมอง (UAT)

คลิกที่ ชื่อผู้ใช้ + avatar มุมขวาบน จะมีเมนู "สลับมุมมอง" ให้เลือก 3 แบบ:

G-Onsite HQ Onsite Admin HQ Manager HQ สลับมุมมอง AO Admin Onsite จ่ายงาน · Spare · Dashboard HQ HQ Manager Dashboard · Settings · Spare Stock ช่างทดสอบ (Technician) My Jobs · AI Chat · Stock ออกจากระบบ
คลิก ชื่อผู้ใช้ + avatar มุมขวาบน → เลือกมุมมอง Admin Onsite / HQ Manager / ช่างทดสอบ
ℹ️ มุมมองช่างใน UAT เห็นทุกงาน เพราะบัญชีเป็น Admin (ไม่ได้ scope เป็นช่างคนเดียว) — ใช้ดู UI/flow ได้ครบ ถ้าต้องการทดสอบข้อมูลของช่างจริงคนเดียว ให้ login ด้วยบัญชี technician จริง

4 ทดสอบบทบาท HQ Manager

4.1 สร้างงานใหม่ (Create Job)

สร้างงานใหม่ (Create Job) HQ เปิดงาน → ไปรอที่ Dashboard Admin เลข JOB (JB ID) เช่น JB26-0012345 รายละเอียดปัญหา เช่น เครื่อง POS เปิดไม่ติด LOCATION (สาขาจากฐานข้อมูล) บางกะปิ 1111 · The Mall บางกะปิ ยกเลิก Submit — สร้างงาน
กรอก เลข Job · รายละเอียดปัญหา · พิมพ์ค้นหา Location แล้วคลิกเลือกสาขา → Submit

4.2 Dashboard กำกับดูแล + ประวัติ

Dashboard HQ · กำกับดูแล + สร้างงาน (Create Job) กำลัง Onsite ตอนนี้1 ค้างรับ > 1 ชม.0 ETA เฉลี่ย (งาน active)~26 น. งานที่ยังไม่ปิด · read-only JB IDสาขาสถานะONSITE เมื่อค้างดูประวัติ JB26-9000003 The Mall บางกะปิ Onsite 21 ก.ค. 09:49 4 วัน ประวัติ JB26-0000012 Lotus รังสิต New 0 วัน ประวัติ
แถบ oversight ด้านบน + ตารางงานที่ยังไม่ปิด (read-only) — กด "ประวัติ" เพื่อดู timeline เต็ม

4.3 คลัง Spare กลาง

5 ทดสอบบทบาท Admin Onsite

5.1 จ่ายงาน / ดึงกลับ

5.2 Spare — จ่าย / คืน / ยอดช่าง

6 ทดสอบบทบาทช่าง (Technician)

สลับเป็น "ช่างทดสอบ" → เปิดงานที่สถานะ Accepted แล้วไล่ตาม flow

6.1 flow หลัก

สถานะงาน รับมอบหมาย (Assigned) ยอมรับงาน (Accepted) Onsite / เดินทาง ⏸ พักงาน (Pending) รอเซ็นปิดเคส ปิดเคส (Closed) ประวัติการทำงาน 09:56สร้าง Job (New) 16:25Admin มอบหมายงาน 16:30ช่างยอมรับงาน 09:49กด Onsite · GPS · คาดถึง ~10:15 10:29📍 ถึงสาขาแล้ว 10:40⏸ พักงาน · รออะไหล่ พักงาน 📍 ถึงสาขาแล้ว 📍 กด Onsite — เริ่มออกเดินทาง ↑ ปุ่มเปลี่ยนตามสถานะ: Accept → Onsite → ถึงสาขา → งานเสร็จ
Stepper (ซ้าย) · Timeline ที่ persist จริง (ขวา) · ปุ่มปฏิบัติงานเปลี่ยนตามสถานะ — Onsite → ถึงสาขาแล้ว → งานเสร็จ

6.2 พักงาน (Pending)

แจ้งพักงาน (Pending) JB26-9000003 เหตุผลที่พักงาน เช่น รออะไหล่, ลูกค้าไม่อยู่... วัน–เวลานัดใหม่ (ถ้ามี) 22/07/2026, 14:30 📅 ยกเลิก ยืนยันพักงาน
ใส่เหตุผล + วัน–เวลานัดใหม่ (datetime — มีทั้งวันและเวลา) → ยืนยันพักงาน

6.3 อื่นๆ

7 ข้อควรรู้ช่วง UAT

เรื่องพฤติกรรมช่วง UAT
กด Onsite / Accept / งานเสร็จ ในมุมมองช่างบัญชี Admin กดแทนช่างได้ (UAT_MODE เปิด) — ตอน Go Live เฉพาะช่างที่ถูกมอบหมาย
ปุ่ม "ถึงสาขาแล้ว"กดได้จากทุกที่ — ตอน Go Live ต้องอยู่ในระยะ 300 ม.จากสาขา (เช็ค GPS)
ETAคำนวณจาก Google Maps (เส้นทางจริง + จราจรสด) — ต้องเปิด billing ของ Maps API ให้ครบ
งานทดสอบสร้างเองผ่าน "Create Job" ได้ · ไม่เขียนกลับ Google Sheet
⚠️ สำหรับผู้ดูแลระบบ — ก่อน Go Liveต้องตั้ง UAT_MODE = "false" เพื่อ (1) กันไม่ให้ Admin ทำ action ของช่าง และ (2) เปิดการเช็ค GPS ระยะ 300 ม. ของปุ่มถึงสาขา

8 แจ้งปัญหาที่พบ

เมื่อเจอบั๊กหรือจุดที่ใช้งานไม่สะดวก ให้บันทึกข้อมูลต่อไปนี้แล้วส่งให้ทีมพัฒนา:

  1. บทบาท ที่ใช้ตอนเกิดปัญหา (Admin / HQ / ช่าง)
  2. เลข Job (JB ID) และหน้าจอที่อยู่
  3. ขั้นตอนที่ทำ ก่อนเกิดปัญหา (1-2-3)
  4. สิ่งที่คาดหวัง vs สิ่งที่เกิดขึ้นจริง
  5. ภาพหน้าจอ (screenshot) ถ้ามี
✅ เคล็ดลับถ้าเจอ error ให้ดูข้อความในกรอบสีส้ม/แดง — ระบบพยายามบอกสาเหตุจริง (เช่น "ต้องเปิด GPS" vs "ไม่มีสิทธิ์") ช่วยระบุปัญหาได้เร็วขึ้น