📘 คู่มือการใช้งาน MobileHub v2

ระบบจัดการร้านมือถือ Multi-Tenant SaaS

เวอร์ชัน 2.0 | อัปเดตล่าสุด: 14 พฤษภาคม 2569 (รับเครื่อง 3-step guided flow: intake → checklist → receipt + auto-preview / print colors fix / intake & warranty 1-page / SMALL_RECEIPT logo / repair-intake required fields)

📋 สารบัญ

1. บทนำ

1.1 ภาพรวมระบบ

MobileHub v2 เป็นระบบจัดการร้านมือถือแบบ Multi-Tenant SaaS ที่ออกแบบมาสำหรับร้านมือถือทุกขนาด ตั้งแต่ร้านสาขาเดียวจนถึงเชนร้านค้าหลายสาขา ระบบครอบคลุมการทำงานตั้งแต่การรับซื้อมือถือมือสอง การซ่อมบำรุง การขายสินค้าแบบ POS ไปจนถึงการจัดการบุคลากรและรายงานทางการเงิน

ระบบพัฒนาด้วย Next.js 16 + React 19 + Mantine v8 ทางฝั่งหน้า และ Fastify + Prisma + PostgreSQL ทางฝั่งหลัง รองรับการใช้งานแบบ Real-time ผ่าน Socket.IO และออกแบบตามมาตรฐาน Mobile-First เพื่อให้ใช้งานสะดวกบนมือถือ

โดเมน: mobilehub.ajsoftwaredev.com

1.2 ความสามารถหลัก

1.3 บทบาทในระบบ (7 Roles)

1.4 ตารางสิทธิ์การเข้าถึง

1.5 แพ็คเกจ (Plans) และฟีเจอร์

ระบบมี 3 แพ็คเกจ ต่างกันที่ ขีดจำกัด (limits) + ฟีเจอร์ขั้นสูง (advanced features)

ฟีเจอร์ตามแพ็คเกจ

พฤติกรรมเมื่อเกินขีดจำกัด

ถ้าสร้างสาขา / ผู้ใช้ / สินค้าเกินจำนวนที่แพ็คเกจกำหนด ระบบจะตอบกลับ:

ถึงขีดจำกัดจำนวนสาขา (แพ็คเกจ มืออาชีพ) 3/3 — กรุณาอัพเกรดแพ็คเกจเพื่อเพิ่ม

→ ต้องลบรายการเก่าออก หรือ อัพเกรดแพ็คเกจ

2. เริ่มต้นใช้งาน

2.1 สมัครใช้งาน

📍 หน้า: /register 👤 สิทธิ์: สาธารณะ (ไม่ต้องเข้าสู่ระบบ)

วัตถุประสงค์: สร้าง Tenant ใหม่ (ร้านค้า) ในระบบ MobileHub

ขั้นตอน:

1. เปิดเบราว์เซอร์ไปที่ https://mobilehub.ajsoftwaredev.com/register
2. กรอกข้อมูลร้านค้า:
   • ชื่อร้าน — ชื่อธุรกิจของคุณ
   • อีเมล — ใช้สำหรับเข้าสู่ระบบและรับ OTP
   • รหัสผ่าน — ขั้นต่ำ 8 ตัวอักษร
   • ยืนยันรหัสผ่าน — กรอกซ้ำให้ตรงกัน
3. กดปุ่ม "สมัครใช้งาน"
4. ระบบส่ง OTP 6 หลักไปยังอีเมลที่กรอก
5. ไปยังหน้า ยืนยันอีเมล เพื่อกรอก OTP

2.2 ยืนยันอีเมล OTP

📍 หน้า: /verify-email 👤 สิทธิ์: ผู้ที่เพิ่งสมัครใหม่

วัตถุประสงค์: ยืนยันความเป็นเจ้าของอีเมลก่อนเข้าใช้งานระบบ

ขั้นตอน:

1. ตรวจสอบอีเมล (กล่อง Inbox หรือ Spam)
2. พบอีเมลจาก MobileHub หัวข้อ "ยืนยันอีเมลของคุณ"
3. คัดลอก OTP 6 หลักจากอีเมล
4. กรอก OTP ในช่อง PinInput บนหน้า Verify Email
5. ระบบยืนยันอัตโนมัติเมื่อกรอกครบ 6 หลัก
6. เปลี่ยนหน้าไปยัง Dashboard โดยอัตโนมัติ

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

📍 หน้า: /login 👤 สิทธิ์: สาธารณะ

วัตถุประสงค์: เข้าสู่ระบบด้วยอีเมลและรหัสผ่าน

ขั้นตอน:

1. ไปที่ https://mobilehub.ajsoftwaredev.com/login
2. กรอก อีเมล ที่ใช้สมัคร
3. กรอก รหัสผ่าน
4. กดปุ่ม "เข้าสู่ระบบ"
5. ระบบตรวจสอบ JWT Token (อายุ 24 ชั่วโมง)
6. เปลี่ยนหน้าไปยัง Dashboard

2.4 แดชบอร์ด

📍 หน้า: /dashboard 👤 สิทธิ์: ทุก Role

วัตถุประสงค์: ภาพรวมสถิติและข้อมูลสำคัญของร้าน แสดงข้อมูลตาม Role ของผู้ใช้

การแสดงผลตาม Role:

การ์ดสถิติหลัก (Admin/Owner):

• 💰 ยอดขายวันนี้ — รายได้จากการขายสินค้า
• 🔧 งานซ่อมรอ — จำนวนงานซ่อมที่ยังไม่เสร็จ
• 📦 สินค้าในสต็อก — จำนวนมือถือทั้งหมด
• 👥 ลูกค้าใหม่ — ลูกค้าที่เพิ่มวันนี้
• 📈 กราฟรายได้ — แสดงรายได้ย้อนหลัง
• 🏆 สินค้าขายดี — Top Products ประจำเดือน
• ⚠️ สินค้าใกล้หมด — สินค้าที่ Stock ต่ำ
• 🕐 ประกันใกล้หมดอายุ — แสดง Expiring Warranties

2.5 แนะนำระบบ (Onboarding Tour)

📍 เปิดได้ที่: เด้งเองครั้งแรกหลังเข้าสู่ระบบ + ปุ่ม "แนะนำระบบ" ในเมนูซ้าย (มี Badge "ใหม่" สีฟ้า) 👤 สิทธิ์: ทุก Role (เนื้อหาแตกต่างกันตาม Role)

วัตถุประสงค์: ช่วยผู้ใช้ใหม่เริ่มต้นใช้งานเร็ว — ระบบจะแสดง Welcome Modal พร้อม Checklist สิ่งที่ควรทำก่อน + Guided Tour พาไล่ดูเมนูสำคัญทีละข้อ

Welcome Modal — เด้งครั้งเดียวต่อ User:

ครั้งแรกที่ Login จะเห็น Modal สีเทา-ฟ้า กลางจอ ประกอบด้วย:

1. หัวข้อต้อนรับ + คำอธิบายตาม Role (เช่น OWNER เห็น "ตั้งค่าระบบและจัดการร้านของคุณ" / TECHNICIAN เห็น "รับงานซ่อม เบิกอะไหล่ และอัปเดตสถานะ")
2. Checklist 2-4 รายการ — สิ่งที่ควรตั้งค่า/เปิดใช้ก่อน (เช่น ตั้งค่าร้าน → เพิ่มสาขา → เพิ่มผู้ใช้ → ข้อมูลหลัก สำหรับ OWNER)
   • คลิกแต่ละรายการ → ระบบจะ navigate ไปหน้านั้นทันที + mark ว่า "เสร็จแล้ว" (Badge เขียว)
3. 2 ปุ่ม:
   • "ข้ามไปก่อน" — ปิด Modal ชั่วคราว (ไม่เด้งซ้ำ)
   • "เริ่ม Tour แนะนำ" — เริ่ม Guided Tour พาไล่ดูเมนูทีละข้อ

Guided Tour — Spotlight แต่ละเมนู:

เมื่อเริ่ม Tour ระบบจะ:

• ทำให้พื้นหลังดำลง (overlay)
• Highlight เมนูทีละข้อ ตามลำดับ พร้อม Popover คำอธิบายภาษาไทย
• มีปุ่ม ก่อนหน้า / ถัดไป / เสร็จสิ้น + แสดงความคืบหน้า "ขั้นตอน N จาก M"
• ถ้า Role ของผู้ใช้ไม่มีเมนูนั้น (เช่น TECHNICIAN ไม่เห็น POS) ระบบจะ ข้าม step นั้นอัตโนมัติ

Tour ตาม Role (สรุป):

เปิดดูซ้ำได้ตลอด:

ถ้าปิดไปแล้วต้องการดูใหม่ — คลิก "แนะนำระบบ" ในเมนูซ้าย (อยู่ด้านล่างใกล้กับ "คู่มือการใช้งาน") → Welcome Modal เปิดอีก

2.6 โปรไฟล์ส่วนตัว

📍 หน้า: /profile 👤 สิทธิ์: ทุก Role

วัตถุประสงค์: ดูและแก้ไขข้อมูลส่วนตัว เปลี่ยนรหัสผ่าน อัปโหลดรูปโปรไฟล์

ฟิลด์ที่แก้ไขได้:

3. คลังสินค้า

3.1 สต็อกมือถือ

📍 หน้า: /stock 👤 สิทธิ์: OWNER, ADMIN, MANAGER, CASHIER, SALES, SALESTECH

วัตถุประสงค์: จัดการสินค้ามือถือในคลัง — เพิ่ม แก้ไข ดูสต็อก

คุณสมบัติหน้านี้:

• ดูรายการสต็อกทั้งหมด พร้อมกรองตามสาขา
• ค้นหาสินค้าด้วยชื่อ รุ่น บาร์โค้ด
• เพิ่ม/แก้ไข/ลบสินค้า
• อัปโหลดรูปภาพสินค้าหลายรูป (Carousel)
• แสดง Badge สาขาเพื่อระบุที่อยู่ของสินค้า
• ดู Cross-branch availability (สต็อกจากสาขาอื่น)

ขั้นตอนเพิ่มสินค้าใหม่:

1. กดปุ่ม "+ เพิ่มสินค้า" มุมบนขวา
2. กรอกข้อมูลสินค้า:

1. กดปุ่ม "บันทึก"

การสแกน Barcode:

• กดไอคอน Barcode เพื่อเปิด Camera Scanner
• สแกน IMEI/Serial Number โดยอัตโนมัติ
• รองรับทั้ง QR Code และ Barcode

มุมมองมือถือ:

• แสดงเป็น Card แทนตาราง
• Card แสดงรูปภาพ, ยี่ห้อ/รุ่น, ราคา, สถานะ, สาขา
• ปุ่มแก้ไข/ลบแสดงเป็นไอคอน

3.2 อุปกรณ์เสริม

📍 หน้า: /accessories 👤 สิทธิ์: OWNER, ADMIN, MANAGER, CASHIER, SALES, SALESTECH

วัตถุประสงค์: จัดการสินค้าประเภทอุปกรณ์เสริม เช่น เคส สายชาร์จ หูฟัง กระจก

คุณสมบัติ:

• จัดการสินค้าอุปกรณ์เสริมพร้อม Stock จำนวน
• แบ่งหมวดหมู่ตาม Category
• กำหนดยี่ห้อจาก Master Brands
• ตั้งราคาทุน/ราคาขาย

ฟิลด์สินค้าอุปกรณ์เสริม:

ประเภทธุรกรรมอุปกรณ์เสริม:

• IN — รับสินค้าเข้าคลัง
• OUT — ตัดสต็อกออก
• SELL — ขายสินค้า (ผ่าน POS)

3.3 รอบนับสต็อก (Stock Count) ⭐ NEW

📍 หน้า: /stock-count (list) + /stock-count/[id] (counting) 👤 สิทธิ์: OWNER, ADMIN, MANAGER

วัตถุประสงค์: ตรวจสต็อกจริง vs ระบบ — ตรวจของหาย, ตรวจ data integrity, audit trail สำหรับผู้สอบบัญชี (มาตรฐาน auditor ขอ stock count log เป็นปกติ)

3 ประเภทการนับ:

Workflow:

1. เริ่มรอบ ที่ /stock-count → กด + เริ่มรอบนับใหม่ → เลือกประเภท
2. ระบบ snapshot สต็อกในระบบ ณ ตอนนั้น → list ทุกรายการ (Product + Accessory + SparePart) ของสาขาให้นับ
3. ไป /stock-count/[id] (mobile-first interface):
   • search box (พิมพ์ / สแกน barcode)
   • แต่ละ row แสดง: ชื่อ + expected qty + ช่องกรอกนับจริง + สีตามสถานะ (เทา/เขียว/ส้ม/แดง)
   • กรอกนับ → auto-save (debounce 400ms) → คำนวณ variance ทันที
   • ถ้า variance ≠ 0 → ช่อง "เหตุผล" โผล่ขึ้นใน inline (กรอกเหตุผล เช่น "ของหาย / ปลอม / นับผิดเดิม")
4. Progress bar แสดง x/total นับแล้ว
5. กด ปิดรอบนับ เมื่อนับครบ:
   • Alert ฟ้องถ้ามี variance ที่ยังไม่กรอกเหตุผล
   • ระบบบันทึก totals snapshot: expected/counted/missing/extra
   • ปิดเป็น COMPLETED ไม่สามารถแก้ได้อีก (audit trail)

ข้อดี:

• หา cashier ที่ขาย off-the-book (เครื่องไม่ได้บันทึก SOLD แต่หาย)
• หา shrinkage rate (% ของสินค้าที่หาย)
• ใช้คุยกับ supplier ตอนรับของไม่ครบ (เปรียบใบส่งของกับสต็อกจริง)

3.4 โอนสินค้าระหว่างสาขา (Stock Transfer) ⭐ NEW

📍 หน้า: /stock-transfer 👤 สิทธิ์: ขอโอน = ทุก role; อนุมัติ/ยกเลิก = MANAGER+

วัตถุประสงค์: Multi-branch ใช้ได้แล้ว แต่ก่อนหน้านี้ โอนของระหว่างสาขาไม่ได้ — ของอยู่สาขา A ลูกค้าอยากซื้อที่สาขา B → ต้องลบ-สร้างใหม่ (ไม่มี audit trail). ระบบ Stock Transfer แก้ปัญหานี้

Workflow 3 stages:

สร้างคำขอโอน:

1. ไป /stock-transfer → กด ขอโอนสินค้า (ต้องมี ≥ 2 สาขา)
2. เลือกสาขาปลายทาง
3. เพิ่มรายการจาก stock ที่สาขาปัจจุบัน — มี 3 tabs (อุปกรณ์ / อะไหล่ / มือถือ)
4. กรอก qty (มือถือ = 1 เครื่อง = 1 row, อุปกรณ์/อะไหล่ปรับได้ตาม max stock)
5. หมายเหตุ + บันทึก → status = PENDING
6. ส่ง notification ไปที่ manager ของสาขาต้นทาง

Auto stock movement:

• Approve (PENDING → IN_TRANSIT): มือถือ status=RESERVED, อุปกรณ์/อะไหล่ qty -= n
• Receive (IN_TRANSIT → RECEIVED):
  • มือถือ: เปลี่ยน branchId + status=AVAILABLE
  • อุปกรณ์/อะไหล่: upsert ที่สาขาปลายทาง (match by name+sku)

transferNumber format: TR-{branchCode}-{BEyear}-{seq:04} — running serial ตาม docSerial system

Tabs: ทั้งหมด / ขาเข้า (รับ) / ขาออก (ส่ง) — filter ดูตามทิศทาง

4. รับซื้อ-ตีราคา

📍 หน้า: /purchase 👤 สิทธิ์: OWNER, ADMIN, MANAGER, CASHIER, SALES, SALESTECH

วัตถุประสงค์: บันทึกการรับซื้อมือถือมือสองจากลูกค้า พร้อมตีราคา และออกใบรับซื้อ

ขั้นตอนรับซื้อมือถือ:

1. กดปุ่ม "+ รับซื้อสินค้า"
2. เลือกลูกค้า (หรือเพิ่มลูกค้าใหม่ในฟอร์มเดียวกัน)
3. กรอกข้อมูลอุปกรณ์:

1. กรอก Checklist อุปกรณ์ เพื่อบันทึกว่ามาพร้อมอะไรบ้าง:
   • กล่อง, ที่ชาร์จ, หูฟัง, สายชาร์จ, คู่มือ ฯลฯ
2. กดปุ่ม "บันทึกรับซื้อ"
3. ระบบเพิ่มสินค้าเข้า Stock อัตโนมัติ

คุณสมบัติเพิ่มเติม:

• สแกน IMEI ด้วยกล้อง Barcode Scanner
• อัปโหลดรูปสภาพเครื่องหลายรูป
• ดูประวัติการรับซื้อย้อนหลัง
• กัน IMEI ซ้ำในร้าน — เครื่องที่เคยรับเข้าระบบแล้ว ระบบไม่ให้บันทึกซ้ำ (ภายในร้านตัวเองเท่านั้น)

5. งานซ่อม

5.1 รับเครื่อง (3-step guided flow) ⭐ ปรับปรุง 2026-05-14

📍 เส้นทาง: /repair-intake → /repair-checklist → /repair-documents (preview) 👤 สิทธิ์: OWNER, ADMIN, MANAGER, SALESTECH (ช่างธรรมดา ไม่เห็น เมนูรับเครื่อง)

วัตถุประสงค์: รับเครื่องจากลูกค้า บันทึกข้อมูล + เช็คสภาพก่อนซ่อม + ออกใบรับซ่อมพร้อมพิมพ์ ภายในชุดเดียวกัน (ไม่ต้องสลับหน้าหลายครั้ง)

ขั้นที่ 1 — รับเครื่อง (กรอกข้อมูล + เซ็น)

ที่ /repair-intake กด "+ รับเครื่อง" → modal เปิด

ฟิลด์ในฟอร์ม:

Validation: ถ้าฟิลด์ที่บังคับขาด → toast แดง "ข้อมูลไม่ถูกต้อง" รวมทุกฟิลด์ที่ขาดเป็น bullet list + แต่ละ Select มี error message ใต้ label. แก้ไขฟิลด์ใดก็ตาม → error ของฟิลด์นั้นหายอัตโนมัติ

กด "บันทึก" → ระบบสร้างงานซ่อม → toast เขียว "รับเครื่องสำเร็จ — ต่อไปเช็คสภาพเครื่องก่อนซ่อม" → redirect อัตโนมัติไปขั้นที่ 2

ขั้นที่ 2 — เช็คสภาพเครื่อง (PRE_REPAIR checklist)

ระบบพาไป /repair-checklist?repairId=...&autoOpen=PRE_REPAIR — modal เปิดเองทันที (ไม่ต้องคลิก)

สิ่งที่ทำ:

• 24 รายการ default (Bluetooth / WiFi / กล้อง / แบตเตอรี่ / ลำโพง / Face ID / สแกนลายนิ้วมือ ... ตาม master items ของสาขา)
• แต่ละรายการเลือก: ✅ ปกติ / ❌ ไม่ปกติ / — ไม่เกี่ยวข้อง
• ถ้าเลือก ไม่ปกติ ต้องกรอกหมายเหตุอธิบาย (ระบบบังคับ ห้าม save ทิ้งไว้)
• หมายเหตุภาพรวม (ถ้ามี) — เช่น "เคสมีรอย", "หน้าจอมีรอยเล็กน้อย"
• ลายเซ็นลูกค้า อีกครั้ง — ยืนยันสภาพที่เห็นด้วยกัน (เก็บใน RepairChecklist.customerSignature)

กด "บันทึก" → toast "บันทึกสำเร็จ — เช็คก่อนซ่อม + ออกใบรับซ่อมเรียบร้อย" → redirect ไปขั้นที่ 3

ขั้นที่ 3 — preview ใบรับซ่อม (พร้อมพิมพ์)

ระบบพาไป /repair-documents?repairId=...&autoPreview=intake — modal ตัวอย่างเอกสารเปิดเองพร้อมเนื้อหาครบ:

• 🏪 logo + ชื่อร้าน + ที่อยู่ + เลขประจำตัวผู้เสียภาษี
• 🏷️ Title bar "ใบรับซ่อม" (สี slate gray)
• 👤 ข้อมูลลูกค้า + 📱 ข้อมูลเครื่อง 2-col
• 📷 รูปถ่ายเครื่องตอนรับ (สูงสุด 6 รูป)
• 📋 สภาพเครื่องตอนรับ (ลูกค้ายืนยัน) — 24-item checklist 3-col + badge สีเขียว/แดง
• ⚠️ Note "ราคาซ่อมจะแจ้งในใบเสนอราคาภายหลัง" (กล่องเหลือง)
• 📜 เงื่อนไขและข้อตกลง 4 ข้อ
• ✍️ ลายเซ็นพนักงาน + ลายเซ็นลูกค้า (รูปลายเซ็นจาก checklist embed อัตโนมัติ)
• 📦 QR tracking code (Kerry-style) — สำหรับให้ลูกค้าติดตามสถานะออนไลน์
• 🙏 footer "ขอบคุณที่ใช้บริการ"

ทั้งหมด อยู่ใน 1 หน้า A4 (ใช้ .intake-receipt CSS scope compactions) → กดปุ่ม "พิมพ์" → printer dialog เปิด

ทำไมต้อง 3 ขั้น:

• ขั้น 1 = บันทึก identity ของงาน (ใคร / อะไร / ปัญหา)
• ขั้น 2 = หลักฐานยืนยัน "สภาพที่รับมา" — ป้องกันข้อพิพาทตอนคืนเครื่อง ("ตอนนั้นแบตปกติ ตอนนี้แบตเสีย!")
• ขั้น 3 = เอกสารส่งให้ลูกค้า — มีลายเซ็น 2 จุด (intake + checklist) + checklist embed = ลูกค้าและร้านมีหลักฐานชุดเดียวกัน

5.2 งานช่าง

📍 หน้า: /technician-repairs 👤 สิทธิ์: OWNER, ADMIN, MANAGER, TECHNICIAN, SALESTECH

วัตถุประสงค์: ดูงานซ่อมที่ได้รับมอบหมาย อัปเดตสถานะ เบิกอะไหล่

สถานะงานซ่อม:

ขั้นตอนอัปเดตงานซ่อม:

1. คลิกที่รายการงานซ่อม
2. เปลี่ยนสถานะตามความเป็นจริง
3. เพิ่มรายละเอียดการซ่อม (อะไหล่ที่ใช้ ค่าใช้จ่าย)
4. กดปุ่ม "บันทึก"
5. ระบบแจ้งเตือน Real-time ไปยังเจ้าของร้านและ Manager

การเบิกอะไหล่:

1. คลิกปุ่ม "เบิกอะไหล่" ในรายการงาน
2. เลือกอะไหล่จากคลังอะไหล่
3. กรอกจำนวนที่ใช้
4. ระบบตัด Stock อะไหล่อัตโนมัติ

5.3 รายการทั้งหมด

📍 หน้า: /repair 👤 สิทธิ์: OWNER, ADMIN, MANAGER, SALESTECH (ช่างธรรมดา ไม่เห็น)

วัตถุประสงค์: ดูรายการงานซ่อมทั้งหมด กรอง/ค้นหา สร้างงานซ่อมใหม่

ฟีเจอร์:

• ดูรายการงานซ่อมทั้งหมดของสาขา
• ค้นหาด้วยชื่อลูกค้า, ยี่ห้อ, รุ่น, หมายเลขงาน
• กรองตามสถานะ
• เพิ่มงานซ่อมใหม่ (เหมือน Repair Intake)
• อัปเดตสถานะและรายละเอียด
• ดูประวัติการซ่อมย้อนหลัง
• แสดงรูปภาพก่อน-หลังซ่อม

5.4 คลังอะไหล่

📍 หน้า: /spare-parts 👤 สิทธิ์: OWNER, ADMIN, MANAGER, TECHNICIAN, SALESTECH

วัตถุประสงค์: จัดการคลังอะไหล่สำหรับงานซ่อม — เพิ่ม, รับเข้า, เบิกออก

ฟิลด์อะไหล่:

การจัดการสต็อกอะไหล่:

• รับเข้า: กดปุ่ม "รับอะไหล่เข้า" เพื่อเพิ่ม Stock (manual)
• สั่งจาก Supplier: ใช้หน้า /reorders (§5.4B) — track DRAFT → SENT → RECEIVED + auto bump stock
• เบิกออก: ระบบตัดอัตโนมัติเมื่อใช้ในงานซ่อม
• แจ้งเตือน Stock ต่ำ: ระบบแจ้งเตือนเมื่อ Stock ต่ำกว่าขั้นต่ำ

5.4A Template ราคาซ่อม (Repair Pricing Template) ⭐ NEW

📍 หน้า: /masters/repair-price-templates (CRUD) + quick-pick ใน /repair-intake 👤 สิทธิ์: OWNER, ADMIN

วัตถุประสงค์: ทุกร้านมีงานซ่อมยอดฮิต 20-30 รายการที่ทำซ้ำทุกวัน เช่น "iPhone 13 จอแตก = ฿2,500" — Template ทำให้ช่าง quick-pick แทนการพิมพ์ทุกครั้ง

สร้าง template:

1. ไป /masters → กด Template ราคาซ่อม
2. กดปุ่ม + เพิ่ม template
3. กรอก: ชื่อ template (เช่น "iPhone 13 จอแตก") + ยี่ห้อ/รุ่น (เว้น = ทุกยี่ห้อ) + ประเภทซ่อม + ค่าแรง + ค่าอะไหล่ + อาการ default + ระยะประกัน
4. กด บันทึก

ใช้งาน:

• ไป /repair-intake รับเครื่อง
• บนสุดของส่วน "ข้อมูลเครื่อง" → Select 🚀 Quick-pick template
• เลือก template → ระบบ auto-fill: ยี่ห้อ + รุ่น + ค่าแรง + ค่าอะไหล่ + อาการ
• ช่างยังแก้ field แต่ละช่องได้ก่อนบันทึก
• ทุกครั้งที่ใช้ template → popularityScore += 1 (เรียงขึ้นบนใน list ครั้งถัดไป)
• 🔥 Badge สำหรับ template ใช้ > 5 ครั้ง (popular)

ประโยชน์:

• ลดเวลารับเครื่องจาก 2-3 นาที → 30 วินาที
• ราคามาตรฐานทั้งร้าน (ลูกค้าไม่งง)
• analytics: รู้งานยอดฮิตของร้านจาก popularityScore

5.4B ผู้จัดหา (Suppliers) + สั่งซื้ออะไหล่ (Reorders) ⭐ NEW

📍 หน้า: /suppliers (CRUD ผู้จัดหา) + /reorders (สั่งซื้อ + ติดตาม) 👤 สิทธิ์: OWNER, ADMIN (suppliers); + MANAGER (reorders)

วัตถุประสงค์: ก่อนหน้านี้สั่งอะไหล่ต้องจดเองใน LINE → จำเลขส่งของไม่ได้ → ส่งมาแล้วลืมเช็ค → stockout ตอนช่างต้องการ. ระบบ Reorder ช่วย:

1. Auto-detect อะไหล่ที่เหลือต่ำกว่า min stock
2. Track lifecycle: DRAFT → SENT → RECEIVED + auto bump stock
3. เก็บประวัติทุก order ผูกกับ supplier

5.4B.1 Suppliers (/suppliers)

จัดการ supplier ที่สั่งอะไหล่ประจำ:

• ชื่อร้าน/บริษัท + ผู้ติดต่อ + เบอร์/email/LINE/ที่อยู่
• เลขประจำตัวผู้เสียภาษี
• เงื่อนไขการชำระ: เงินสด / net-7 / net-15 / net-30 / net-60
• หมายเหตุ + active toggle

ลบ supplier ไม่ได้ถ้ายังมีอะไหล่ผูกอยู่ — ต้องตั้ง active=false แทน

5.4B.2 ผูก Supplier กับอะไหล่

ใน /spare-parts form:

• เพิ่ม field: supplierId (Select), reorderQuantity (จำนวนที่ควรสั่งทุกครั้ง), leadTimeDays (กี่วันถึง), unitCost (ราคาต่อหน่วยจาก supplier)

5.4B.3 Reorders (/reorders) — Workflow

Tab "ใกล้หมด" — auto-detect:

• list อะไหล่ที่ quantity ≤ minStock
• แสดง suggested quantity = max(reorderQuantity, minStock × 2 - currentQty)
• กด + สร้างคำสั่ง → modal เปิดพร้อมรายการ pre-fill

Workflow 3 stages:

Create modal — มี search/picker แบบ:

• เลือก supplier
• list ที่ pre-fill จาก low-stock + สามารถเพิ่มอื่น ๆ จาก list ใต้
• แต่ละ row: name + qty + unitCost + total (auto-calc)
• หมายเหตุ
• บันทึกเป็น DRAFT → ส่งทีหลัง

Performance: modal ใช้ uncontrolled refs (qty/unitCost) — ไม่ lag แม้มีหลายรายการ

5.5 Repair Checklist (เช็คสภาพก่อน/หลังซ่อม + ลายเซ็นลูกค้า)

📍 หน้า: /repair-checklist 👤 สิทธิ์: OWNER, ADMIN, MANAGER, SALESTECH (ช่างธรรมดา ไม่เห็น)

วัตถุประสงค์: เก็บหลักฐานสภาพเครื่องก่อน/หลังซ่อม พร้อมลายเซ็นลูกค้า — ป้องกัน customer dispute ("ของผมก่อนเอามาซ่อมไม่เป็น พอซ่อมเสร็จกลับเป็น") + เป็นใบ QC ก่อนส่งมอบ

🔄 Workflow ที่ถูกต้อง (ตามขั้นตอน — สำคัญมาก!)

ระบบบังคับลำดับการเช็คตามมาตรฐานร้านมือถือสากล — ห้ามข้ามขั้นตอน:

1. รับเครื่อง (status = รับเครื่อง / PENDING)
   ↓
2. ✅ เช็คก่อนซ่อม (PRE_REPAIR) ← ทำตอนนี้! ก่อนเริ่มซ่อม + ขอลายเซ็นลูกค้า
   ↓
3. ประเมินราคา (status = เสนอราคา)
   ↓
4. ลูกค้าอนุมัติ (status = อนุมัติ)
   ↓
5. ช่างซ่อม (status = กำลังซ่อม / รออะไหล่)
   ↓
6. ซ่อมเสร็จ (status = เสร็จแล้ว) ← ปุ่ม pre จะ lock ตอนนี้แล้ว!
   ↓
7. ✅ เช็คหลังซ่อม (POST_REPAIR) ← ทำตอนนี้ + ขอลายเซ็นลูกค้ารับเครื่อง
   ↓
8. ส่งเครื่อง (status = ส่งคืนแล้ว)
   ↓
9. ✅ ปุ่ม "เปรียบเทียบ" pre vs post จะโผล่ที่ตาราง

กฎเหล็ก 3 ข้อ:

1. PRE check ทำได้เฉพาะก่อนงานเสร็จ — สถานะ รับเครื่อง / เสนอราคา / อนุมัติ / กำลังซ่อม / รออะไหล่ เท่านั้น. พอซ่อมเสร็จ (เสร็จแล้ว / ส่งคืนแล้ว) ปุ่ม pre จะกลายเป็นเทา (disabled) ตลอดกาล
2. POST check ทำได้หลังงานเสร็จ — ต้องเปลี่ยนสถานะเป็น เสร็จแล้ว หรือ ส่งคืนแล้ว ก่อน ปุ่ม post ถึงจะกดได้
3. เปรียบเทียบ ต้องครบทั้ง 2 ฝั่ง — ถ้าทำแค่ฝั่งเดียว (pre หรือ post อย่างเดียว) ปุ่มเปรียบเทียบจะไม่โผล่

เหตุผลของกฎ (ทำไมเข้มขนาดนี้):

• กฎหมาย/หลักฐาน: ลายเซ็นลูกค้าใน PRE = สภาพเครื่อง "ตอนรับเข้า" → ถ้าให้แก้ย้อนหลังหลังซ่อมเสร็จ ลายเซ็นนี้จะไม่ valid (ลูกค้าไม่ได้อยู่ตอนนั้น)
• กัน fraud: ช่างไม่สามารถ "เพิ่ม" รายการ NOT_OK ย้อนหลังเพื่อ avoid claim ได้
• มาตรฐาน QC: PRE = baseline ก่อนแตะเครื่อง / POST = สภาพหลังแก้ — ต้องบันทึก pre ก่อนเริ่มซ่อม ถึงจะมี baseline เปรียบเทียบ

ผลถ้าลืมเช็ค PRE: ถ้าซ่อมเสร็จแล้วเพิ่งนึกได้ว่าลืมเช็ค PRE → ทำไม่ได้แล้ว ระบบ lock ตลอดกาล. แถวนี้จะไม่มีปุ่มเปรียบเทียบเลย เป็นบทเรียนให้ครั้งหน้าเช็คก่อน

โครงสร้าง 2 แท็บ:

แท็บที่ 1: งานซ่อม

• แสดงรายการงานซ่อมทั้งหมดในตาราง 9 คอลัมน์ (Desktop) / Card (Mobile):
  • เลขที่ + วันที่รับ — id + ตอนที่รับเครื่อง
  • ลูกค้า + เบอร์ — ชื่อ + เบอร์โทรกดเพื่อโทรได้ทันที
  • เครื่อง + IMEI — ยี่ห้อ/รุ่น + IMEI
  • อาการ — สิ่งที่ลูกค้าแจ้ง (มี Tooltip ดูเต็มถ้ายาว)
  • ช่าง — Avatar + ชื่อช่างที่รับผิดชอบ
  • สถานะ — Badge สีตามสถานะ
  • เช็คก่อนซ่อม — ปุ่ม + timestamp ที่เช็ค
  • เช็คหลังซ่อม — ปุ่ม + timestamp ที่เช็ค
  • เปรียบเทียบ — เปิด modal เทียบ pre vs post

กลไก lock-edit: เมื่อเช็คครบทั้ง pre + post แล้ว ปุ่มแก้ไขจะหายไป — เหลือแค่ "✓ เช็คแล้ว" + ปุ่ม "เปรียบเทียบ" — กันแก้หลักฐานย้อนหลัง

แท็บที่ 2: รายการเช็ค (Master List — admin only)

• จัดการรายการที่ต้องเช็ค (เช่น: หน้าจอ, ลำโพง, กล้อง, USB, Wi-Fi, แบตเตอรี่)
• หมวดหมู่: DISPLAY, AUDIO, CAMERA, CONNECTIVITY, BATTERY, ฯลฯ
• Sort order ปรับลำดับการแสดง
• Active/Inactive toggle

ขั้นตอนการเช็ค (ใน modal):

1. คลิกปุ่ม "เช็คก่อนซ่อม" หรือ "เช็คหลังซ่อม" → modal เปิดมาพร้อมรายการที่ admin ตั้งไว้ทั้งหมด
2. แต่ละรายการมี 3 สถานะให้เลือก:
   • ปกติ (เขียว) — ทำงานได้
   • ไม่ปกติ (แดง) — มีปัญหา → บังคับใส่หมายเหตุ อธิบายว่าผิดปกติยังไง (เช่น "จอแตกที่มุมซ้ายบน") — กดบันทึกไม่ได้ถ้าเลือก NOT_OK แล้วไม่ใส่ note
   • ไม่เกี่ยวข้อง (เทา) — ไม่ตรวจรายการนี้
3. กรอก หมายเหตุรวม (ถ้ามี — เช่น "ลูกค้าแจ้งว่าจอกระพริบเป็นช่วงๆ")
4. ลายเซ็นลูกค้า — ลูกค้าเซ็นในกรอบบน touchscreen (มือถือ/iPad) หรือใช้เมาส์ (PC):
   • ลูกค้าจะ "เซ็นลายเซ็นจริง" หรือ "เขียนชื่อ" ก็ได้ — เก็บเป็นรูป PNG อัตโนมัติ
   • มีปุ่ม "ล้างลายเซ็น" ถ้าเซ็นผิดต้องการเซ็นใหม่
   • บันทึกแล้วลายเซ็นจะปรากฏในเอกสาร (ใบรับซ่อม, ใบเสร็จซ่อม, ใบส่งคืนหลังเครม)
5. กด บันทึก → ระบบเก็บผลพร้อม timestamp + ชื่อช่างที่เช็ค

Compare modal (เทียบก่อน/หลัง):

• ตารางเทียบรายการต่อรายการ — ก่อนซ่อม | หลังซ่อม | เปลี่ยนแปลง
• รายการที่สถานะเปลี่ยน → highlight bg เหลือง + Badge "เปลี่ยนแปลง"
• รายการที่ NOT_OK → แสดงหมายเหตุที่ช่างจดไว้ใต้ Badge (กรอบแดงอ่อน italic)

ผลกับเอกสารที่พิมพ์:

Mobile-friendly:

• Modal เช็ครายการ: ปุ่ม 3 สถานะ stack vertically + full-width grow บนมือถือ (Desktop เป็น row)
• ลายเซ็น canvas: รองรับนิ้วบน iPad/iPhone (touchAction: none กัน scroll ตอนเซ็น)
• Card view บนมือถือ: ปุ่มอยู่ล่างเสมอ (consistent layout — ไม่กระโดดขึ้นบนเหมือน wrap)

5.6 ออกเอกสาร

📍 หน้า: /repair-documents 👤 สิทธิ์: OWNER, ADMIN, MANAGER, SALESTECH (ช่างธรรมดา ไม่เห็น)

วัตถุประสงค์: ออกเอกสารเกี่ยวกับงานซ่อม 5 ประเภท — รับเครื่อง / เสนอราคา / เสร็จรับเงิน / ใบเล็ก / ประกัน

ประเภทเอกสาร 5 แบบ:

เปิดเอกสาร 2 วิธี:

1. Auto จาก guided intake flow (default) — เมื่อ /repair-intake save + /repair-checklist save → ใบรับซ่อมออกเอง + preview เปิดทันที (ดู §5.1)
2. Manual — ไปหน้า /repair-documents → กดแถว repair ที่ต้องการ → modal "ออกเอกสาร" เปิด → เลือกชนิดเอกสาร → กรอกข้อมูลเฉพาะ (VAT / ค่าแรง / ระยะประกัน) → กด "สร้างเอกสาร" → preview เปิดให้พิมพ์

Soft workflow ordering: ระบบมี order แนะนำ INTAKE → QUOTATION → RECEIPT → WARRANTY. ถ้าจะข้ามขั้น (เช่น ออก RECEIPT โดยยังไม่ได้ออก QUOTATION) → card จะเทาๆ + Badge "ข้ามลำดับ" + คลิกได้แต่ confirm modal ขึ้นก่อน. ใบรับซ่อมออกได้เสมอ (ไม่มี prereq)

สีพิมพ์: ทุก doc type ใช้ print-color-adjust: exact — สีพื้นหลัง title bar + table header + accent borders จะพิมพ์ออกสีครบแม้ผู้ใช้ไม่ติ๊ก "Background graphics" ใน print dialog ของ Chrome

ลายเซ็นลูกค้า (Priority chain — ใช้ตัวที่มีตามลำดับ):

1. ลายเซ็นที่กรอกใน modal สร้างเอกสารตอนนั้น (ถ้ามี)
2. ลายเซ็นจาก checklist (PRE สำหรับใบรับซ่อม / POST สำหรับใบเสร็จ)
3. ลายเซ็น repair.intakeSignature (สำหรับใบรับซ่อม) / repair.deliverySignature (สำหรับใบเสร็จ)

5.7 ติดตามสถานะออนไลน์สำหรับลูกค้า (Customer Tracking) — สาธารณะ

📍 หน้า (ลูกค้าใช้): /track และ /track/{slug}/{repairId} 👤 สิทธิ์: ลูกค้า — ไม่ต้องล็อกอิน (public, anyone with link)

วัตถุประสงค์: ให้ลูกค้าติดตามสถานะการซ่อมแบบเรียลไทม์เอง ไม่ต้องโทรถามร้าน — เหมือนติดตามพัสดุ Kerry/Flash

กลไก 3 ช่องทางที่ลูกค้ารู้ URL:

Single-field UX (เหมือน Kerry/Flash/ไปรษณีย์):

• ใบรับซ่อมจะแสดง หมายเลขติดตาม ตัวใหญ่ (เช่น F340-38A4) ในกรอบ cyan/teal เด่นชัด
• ลูกค้ากรอกเลขเดียวที่ /track → ระบบค้นข้าม tenant (UUID unique ทั้งระบบ) → redirect ไปหน้า detail อัตโนมัติ
• ถ้าซ้ำ (rare) ระบบขอเลขเพิ่มจนกว่าจะ unique
• รองรับทั้ง F34038A4, F340-38A4, f34038a4 (case + dash insensitive)

ข้อมูลที่ลูกค้าเห็น (ก่อนยืนยัน):

• Timeline 6 ขั้นตอน (รับเครื่อง → เสนอราคา → อนุมัติ → ซ่อม → เสร็จ → ส่งมอบ) พร้อมเวลา + animation pulse ขั้นตอนปัจจุบัน
• ยี่ห้อ/รุ่นเครื่อง + IMEI 4 ตัวท้าย (mask)
• ชื่อช่างที่รับผิดชอบ
• ชื่อลูกค้า masked (ส*****น) + เบอร์ masked (******1234)

ข้อมูลเพิ่ม (หลังยืนยันด้วย 4 ตัวท้ายเบอร์โทร):

• ราคาประเมิน + รายการอะไหล่ + ค่าแรง
• IMEI เต็ม + ชื่อ-เบอร์ลูกค้าเต็ม
• อาการที่แจ้ง + การวินิจฉัย
• ที่อยู่สาขา + เบอร์โทรร้าน (กดโทรได้)

การออกแบบใบรับซ่อม:

• ใบรับซ่อม (INTAKE_RECEIPT) มี block QR + URL ที่ footer (cyan/teal gradient) แสดง:
  • QR encode https://โดเมน/track/{tenant.slug}/{repairId} (สแกนเปิดได้เลย)
  • 3 ขั้นตอน manual fallback (สแกน QR / เข้าเว็บ /track / กรอกชื่อร้าน + เลขใบ)
  • Note ว่าใส่ 4 ตัวท้ายเบอร์เพื่อดูราคา

ความปลอดภัย:

• Rate limit: 30 req/นาที ต่อ IP — ป้องกัน scraping
• Phone verify: 4 ตัวท้ายเบอร์เท่านั้น — ไม่ต้องเก็บ session/JWT
• Generic error message — ไม่บอกว่าเลขใบมีหรือไม่ ป้องกัน enumeration
• Backend exclude internal fields (cost basis, internal notes, signature)

5.8 ประกันงานซ่อม

📍 หน้า: /repair-warranty 👤 สิทธิ์: OWNER, ADMIN, MANAGER, SALESTECH (ช่างธรรมดา ไม่เห็น)

วัตถุประสงค์: บันทึกและติดตามประกันงานซ่อม รับเรื่องเคลมประกัน

ฟิลด์ประกันงานซ่อม:

การเคลมประกัน:

1. ลูกค้าแจ้งปัญหาภายในระยะประกัน
2. พนักงานค้นหาใบประกันด้วยเลขงานซ่อม
3. ตรวจสอบวันหมดอายุและเงื่อนไข
4. บันทึกการเคลมพร้อมรายละเอียด
5. สร้างงานซ่อมใหม่แบบ "เคลมประกัน"

6. ขายสินค้า (POS)

📍 หน้า: /sales 👤 สิทธิ์: OWNER, ADMIN, MANAGER, CASHIER, SALES, SALESTECH

วัตถุประสงค์: ระบบขายสินค้าหน้าร้าน (Point of Sale) รองรับสินค้าทั้งมือถือและอุปกรณ์เสริม

6.1 การขายสินค้า

Layout — Split Screen (Shopify POS pattern):

หน้าจอแบ่งเป็น 2 คอลัมน์ — ตะกร้าอยู่ขวาเสมอ ไม่ต้อง scroll หาข้อมูล

┌─ ซ้าย (lg=8) ─────────────┐ ┌─ ขวา (lg=4) ──────┐
│ [ทั้งหมด][โทรศัพท์][อุปกรณ์] │ │ ตะกร้าสินค้า (3) [⛌][🗑]│
│ 🔍 ค้นหา...           [สแกน]│ │ ────────────────│
│ ┌──────────────────────┐ │ │ ► iPhone 13     │
│ │ 📱 iPhone 13 ┃ ฿17,900│ │ │ ► เคสกัน        │
│ │   IMEI ...   ┃ พร้อมขาย│ │ │ ────────────────│
│ │ 📱 iPhone 14 ┃ ฿24,900│ │ │ สรุปการชำระเงิน  │
│ │ 🎧 เคสกัน    ┃ ฿690   │ │ │ ลูกค้า: ...      │
│ │              ┃ 5 ชิ้น│ │ │ ยอดรวม ฿xxx     │
│ └──────────────────────┘ │ │ ส่วนลด: 0       │
│   (scroll ในกล่องผลค้นหา)  │ │ ─────────────── │
└──────────────────────────┘ │ ยอดชำระ ฿xxx    │
                              │ [เงินสด][PP][โอน]│
                              │ [ ยืนยันการขาย ] │
                              └─────────────────┘

ขั้นตอนการขาย:

1. ค้นหาสินค้าด้วยชื่อ / IMEI / SKU หรือสแกน Barcode
2. คลิกรายการในผลค้นหา → เพิ่มเข้าตะกร้า (เห็นทันทีในการ์ดขวา)
3. ปรับจำนวน (อุปกรณ์เสริม) จากปุ่ม +/− ในตะกร้า
4. เลือกลูกค้า หรือใช้ "ลูกค้าทั่วไป (Walk-in)" default
5. ใส่ส่วนลดถ้ามี
6. เลือกวิธีชำระ (เงินสด / PromptPay / โอน / บัตร)
7. กรอกรับเงิน (ถ้าเงินสด) → ดูเงินทอน
8. กด "ยืนยันการขาย" → ใบเสร็จเปิดอัตโนมัติให้พิมพ์

ค้นหาสินค้า — 3 ทาง:

• พิมพ์ค้นหา — ชื่อสินค้า / IMEI / SKU / รหัส (debounce 300ms — debug ได้ทันทีไม่ต้องรอ Enter) + ปุ่ม × ล้างคำค้นหา
• สแกน Barcode/QR — ปุ่ม "สแกน" ข้างช่องค้นหา → ใช้กล้องโทรศัพท์/แท็บเล็ต
• Filter ประเภท — ทั้งหมด / โทรศัพท์ / อุปกรณ์เสริม (SegmentedControl ใต้ช่องค้นหา)

Visual Catalog Grid (โหลดสินค้าทั้งหมดไว้ตั้งแต่เริ่ม):

ระบบ pre-load สินค้าพร้อมขาย + อุปกรณ์เสริมทั้งหมดของสาขาไว้แล้ว แสดงเป็น การ์ดรูปภาพ ทันทีที่เปิดหน้า — cashier ไม่ต้องพิมพ์ก็เห็นทุกอย่าง — เลือกแตะได้เลย หรือพิมพ์เพื่อกรอง

Header แสดงจำนวน:

• ก่อนค้นหา: สินค้าทั้งหมด N รายการ
• ขณะค้นหา: ผลการค้นหา N รายการ

Card layout (compact 2-4 cols ตามขนาดจอ):

Interaction:

• Hover การ์ด → border cyan-4 + bg cyan-0 (ไม่มี scale = ไม่ขยับ layout)
• Click → addToCart ทันที, การ์ด cart ขวาอัพเดทเรียลไทม์
• สินค้าหมด (สต็อก = 0) → opacity 55% + cursor not-allowed + กดไม่ได้
• ↑↓ Enter — keyboard nav

ตะกร้าสินค้าขวา (Cart Card):

• หัว: "ตะกร้าสินค้า (N ชิ้น)" + ActionIcon พักบิล (ส้ม) + ล้างตะกร้า (แดง)
• Body: scrollable list ของรายการในตะกร้า (mah=320px) — ปรับจำนวนได้ + ลบทีละอัน
• Empty state: "ไม่มีสินค้าในตะกร้า" + คำแนะนำ

สรุปการชำระเงิน (Summary Card — ใต้ตะกร้า):

• ลูกค้า dropdown + ปุ่มเพิ่มลูกค้าใหม่
• ยอดรวม (auto จากตะกร้า)
• ส่วนลด (NumberInput)
• ยอดชำระ (xl cyan)
• ปุ่มเลือกวิธีชำระ 4 ปุ่ม
• Cash: NumberInput รับเงิน + ปุ่ม +20/+50/+100/+500/+1000 + พอดี/ล้าง + กล่องเงินทอน
• PromptPay: QR Code 200×200 + ยอดเงิน
• ปุ่มใหญ่ "ยืนยันการขาย" (disabled ถ้าตะกร้าว่างหรือยังไม่เลือกวิธีชำระ)

Empty + Loading states:

• กำลังโหลด catalog → Loader + "กำลังโหลดสินค้า..."
• กำลังค้นหา → Loader + "กำลังค้นหา..."
• ค้นหาแล้วไม่พบ → IconSearch + "ไม่พบสินค้าตรงกับ '{query}' — ลอง IMEI / SKU / ชื่อรุ่น หรือกดปุ่มสแกน"
• สาขายังไม่มีสินค้า → IconInbox + "ไม่มีสินค้าในสาขานี้ — เพิ่มสินค้าได้ที่ สต็อกมือถือ หรือ อุปกรณ์เสริม"

Auto-refresh + Cart-aware:

• หลังขายสำเร็จ (checkout) → catalog reload อัตโนมัติ — IMEI ที่ขายไปแล้วหายจาก grid ทันที
• ระหว่างคีย์ (real-time): ใส่สินค้าลงตะกร้าแล้ว → grid hide รายการนั้นทันที (มือถือ unique IMEI หายเลย / อุปกรณ์ลดยอดเหลือ N − cart) — ไม่ขายซ้ำ + cashier เห็นยอดแม่นยำ
• ลบจาก cart → กลับมาแสดงใน grid อีกครั้ง

Performance optimizations (สำหรับร้านที่สต็อกเยอะ):

• โหลด 60 ตัวต่อประเภท สูงสุด (120 รวม) — สมัยใหม่หา IMEI/SKU ผ่าน search box ได้
• รูปภาพ loading="lazy" — โหลดเฉพาะการ์ดที่อยู่ใน viewport (ลดภาระ network ลง 80% สำหรับร้านสต็อก 100+)
• Hover ใช้ DOM mutation ไม่ผ่าน React state — ไม่ re-render การ์ดอื่นเวลา cursor เคลื่อนไหว

6.2 วิธีชำระเงิน

6.3 PromptPay QR Code

ขั้นตอน:

1. เลือกวิธีชำระ "PromptPay"
2. ระบบสร้าง QR Code จากหมายเลข PromptPay ของร้าน (ตั้งค่าใน Settings)
3. แสดง QR Code บนหน้าจอ
4. ลูกค้าสแกนด้วยแอป Banking
5. ยืนยันการรับเงิน กดปุ่ม "ยืนยันชำระ"

6.4 หน้าจอแสดงราคาลูกค้า (Customer Display) — Pro+

📍 หน้า: /customer-display 📦 แพ็คเกจ: Professional หรือ Enterprise (ฟีเจอร์นี้ถูกล็อคในแพ็คเกจ Starter)

• เปิดหน้าจอแยกบนจอที่หันหาลูกค้า
• แสดงรายการสินค้าในตะกร้าแบบ Real-time (Socket.IO)
• แสดงราคารวมและส่วนลด
• แสดง QR Code PromptPay เมื่อเลือกชำระ

การใช้งาน:

1. ที่หน้า ขายสินค้า (POS) → กดปุ่ม "เปิดจอลูกค้า" มุมขวาบน
2. ระบบเปิดหน้าต่างใหม่ขนาดเต็มจอ
3. ตั้งจอที่ 2 / แท็บเล็ตหันหาลูกค้า
4. ระบบจะแสดงข้อมูลตะกร้าแบบ Real-time โดยอัตโนมัติ + Badge "เชื่อมต่อแล้ว"

6.5 พักบิล (Park / Hold Bill)

📍 เปิดได้ที่: ปุ่ม "พักบิล" ในตะกร้า + ปุ่ม "บิลที่พักไว้ (N)" มุมขวาบน

วัตถุประสงค์: เก็บตะกร้าค้างไว้ก่อนชำระ — เช่น ลูกค้าเดินไปดูเคสเพิ่ม, หาเงินก่อน, ขอเปลี่ยนใจ → cashier กดพักบิลเพื่อรับลูกค้าคนถัดไปได้ทันที, ตอนกลับมาเปิด "บิลที่พักไว้" → restore cart → ชำระต่อ

ขั้นตอน:

1. คีย์ตะกร้าตามปกติ → กดปุ่ม "พักบิล" (สีส้ม)
2. ใส่ note (ไม่บังคับ) เช่น "ลูกค้าไปดู iPhone อีกอัน" หรือ "รอลูกค้ากลับมาจ่าย"
3. กด "พักบิล" ยืนยัน → ตะกร้าเคลียร์ทันที พร้อมรับลูกค้าคนถัดไป
4. ตอนลูกค้ากลับมา → กดปุ่ม "บิลที่พักไว้ (N)" มุมขวาบน → Drawer แสดงรายการ
5. กด "เปิดบิลนี้" → ตะกร้าถูก restore ทุกรายการ + ลูกค้า + ส่วนลด → ชำระต่อตามปกติ

สิ่งที่บันทึก:

• รายการสินค้าทั้งหมด (มือถือ + อุปกรณ์เสริม)
• ส่วนลดที่กรอกไว้
• ลูกค้าที่เลือก (ถ้ามี)
• ผู้พักบิล + เวลา
• Note

สิ่งที่ ยังไม่ทำ ตอนพักบิล:

• ไม่ตัดสต็อก — สินค้ายังขายให้คนอื่นได้ปกติ (ตัดเฉพาะตอน checkout จริง)
• ไม่สร้าง Sale record — ไม่นับยอดในรายงาน

ข้อสังเกต:

• จำนวนบิลที่พักไว้แสดงในปุ่มที่มุมขวาบนตลอดเวลา ([พัก 0] / [พัก 3])
• บิลที่พักไว้ เห็นข้าม cashier — Cashier A พักไว้, Cashier B เปิดต่อได้
• กรอง ตามสาขา อัตโนมัติ — สาขาอื่นไม่เห็นบิลของสาขานี้
• Real-time refresh ผ่าน Socket.IO เมื่อ cashier อื่นพักหรือเปิดบิล
• ลบบิลที่พักไว้โดยตรงได้จาก Drawer (กดถังขยะข้างปุ่ม "เปิดบิลนี้")

6.6 ประวัติการขาย (Sales History)

📍 หน้า: /sales-history 👤 สิทธิ์: OWNER, ADMIN, MANAGER, CASHIER, SALES, SALESTECH

วัตถุประสงค์: รวมงาน post-checkout ทั้งหมดในที่เดียว — ดูประวัติบิล / พิมพ์ใบเสร็จซ้ำ / ยกเลิกบิล / คืนเงิน / ปิดยอดสิ้นวัน

เลขที่ใบเสร็จ: ทุกบิลใหม่จะได้เลขรูปแบบ RC-{branchCode}-{BEyear}-{seq:04} (เช่น RC-HQ-2569-0001 = บิลใบแรกของสาขา HQ ปี พ.ศ. 2569) — เลขรันต่อเนื่อง ทั้งปีภาษี (reset 1 ม.ค.) แยกต่อสาขา ตามกฎสรรพากร (ประกาศอธิบดี ว.196/2553) ดูรายละเอียดที่ §12.0

หน้าหลัก /sales-history

ตัวกรอง:

• ช่วงวันที่ (date range — Thai พ.ศ.)
• สถานะบิล: ทุกสถานะ / ใช้งาน / ยกเลิก / คืนเงินทั้งบิล / คืนเงินบางส่วน
• วิธีชำระ: ทุกวิธี / เงินสด / โอนเงิน / บัตรเครดิต
• ค้นหา: เลขใบเสร็จ / IMEI / ชื่อลูกค้า / เบอร์โทรลูกค้า (debounce 300ms)

ตาราง (desktop) / Card (mobile):

• เลขใบเสร็จ (cyan)
• วันที่ + เวลา
• ชื่อลูกค้า + เบอร์
• จำนวนรายการ + ยอดรวม
• วิธีชำระ + ผู้ขาย
• Badge สถานะ: 🟢 ใช้งาน / 🔴 ยกเลิก / 🟠 คืนเงินทั้งบิล / 🟡 คืนเงินบางส่วน
• กดแถว → SaleDetailModal

พิมพ์ใบเสร็จซ้ำ (Reprint)

ใน SaleDetailModal → ปุ่ม "พิมพ์ใบเสร็จ" (สีฟ้า) → เปิด Receipt modal เดียวกับตอนขาย → เลือก thermal 80mm หรือ A4 → พิมพ์

ยกเลิกบิล (Void) — ADMIN เท่านั้น

📍 ปุ่ม "ยกเลิกบิล" (สีแดง) ใน SaleDetailModal — แสดงเฉพาะบิลสถานะ ใช้งาน + role ADMIN/OWNER

ขั้นตอน:

1. กด "ยกเลิกบิล" → Modal เตือน
2. กรอก เหตุผลการยกเลิก (บังคับ — เช่น "คีย์ผิดบิล", "ลูกค้าเปลี่ยนใจ")
3. กด "ยืนยันยกเลิกบิล"
4. ระบบ: คืนสต็อก (มือถือ → AVAILABLE, อะไหล่ → +quantity) + บันทึก audit log + Badge เปลี่ยนเป็น 🔴 "ยกเลิก"

บิลที่ยกเลิกแล้ว: ดูได้ตลอด แต่พิมพ์ใบเสร็จไม่ได้ + ไม่นับยอดในรายงาน + ไม่นับใน Z report

คืนเงิน / รับคืนสินค้า (Refund) — MANAGER+

📍 ปุ่ม "คืนเงิน" (สีส้ม) ใน SaleDetailModal — role MANAGER/ADMIN/OWNER

Wizard 3 ขั้นตอน:

Step 1 — เลือกรายการที่คืน:

• Checkbox + จำนวน + ปุ่ม "คืนเข้าสต็อก" (toggle)
• ถ้าสินค้าเสียหาย/ใช้แล้ว → ปิด toggle "คืนเข้าสต็อก" → ระบบจะคืนเงินแต่ไม่เพิ่มสต็อกกลับ

Step 2 — วิธี + เหตุผล:

• เลือกวิธีคืน: เงินสด / โอนคืนเข้าบัญชี / เก็บเครดิตร้าน
• กรอกเหตุผล (บังคับ)

Step 3 — ตรวจสอบ:

• แสดงสรุปก่อนยืนยัน
• กด "ยืนยันคืนเงิน" → ระบบสร้าง Refund record + คืนสต็อก + ออก ใบลดหนี้ (Credit Note) อัตโนมัติให้พิมพ์

สถานะหลังคืนเงิน:

• คืนทุกชิ้น → 🟠 "คืนเงินทั้งบิล" (REFUNDED)
• คืนบางชิ้น → 🟡 "คืนเงินบางส่วน" (PARTIALLY_REFUNDED) — ยังคืนเงินเพิ่มได้ในชิ้นที่เหลือ
• รายการ Refund ปรากฏในประวัติของ SaleDetailModal (Alert สีส้ม)

ปิดยอดสิ้นวัน (Z Report)

📍 ปุ่ม "ปิดยอดวันนี้" มุมขวาบนของหน้า /sales-history

ใช้ทำอะไร: สรุปยอดทุกอย่างของวันนั้น สำหรับเช็คเงินสดในลิ้นชัก / นำส่งหัวหน้า / เก็บเป็นหลักฐาน — มาตรฐาน retail ทั่วโลก เรียกว่า "Z Report"

เนื้อหา:

พิมพ์ Z Report: A4 — มี 2 ช่องลายเซ็น (Cashier ผู้ปิดยอด + ผู้ตรวจสอบ) เก็บไว้เป็นเอกสารตอนปิดร้าน

เลือกวันได้: Default เป็นวันนี้ — เปลี่ยนวันที่เพื่อดู Z Report ย้อนหลังได้

6.7 รับเทรดเครื่องเก่า (Trade-in) ⭐ NEW

📍 ตำแหน่ง: ปุ่มในหน้า /sales POS (ใต้ cart summary) 👤 สิทธิ์: ทุก role ที่ขายได้

วัตถุประสงค์: ลูกค้าที่ซื้อเครื่องใหม่มักอยากเอาเครื่องเก่ามาตีเครดิต. ก่อนหน้านี้ cashier ต้องทำ 2 transactions แยก (Purchase + Sale) → cashier งง + ตีเงินไปกลับไปกลับมา + ไม่มี link ระหว่างเครื่องเก่ากับ sale

Workflow ใหม่ — เซลเดียว:

1. ขายเครื่องใหม่ → เพิ่มสินค้าลงตะกร้าตามปกติ (เช่น iPhone 15 ฿35,000)
2. กดปุ่ม + รับเทรดเครื่องเก่า ใต้ summary
3. Modal เปิด → กรอก:
   • ยี่ห้อ + รุ่นเครื่องเก่า (Select จาก master)
   • IMEI (ไม่บังคับ — ระบบ auto-gen ถ้าเว้น)
   • สภาพ (NEW / LIKE_NEW / GRADE_A/B/C/D)
   • ราคาตั้งต้น (basePrice) + หัก (deductions) → ราคาสุทธิ auto-calc
4. Preview card สีฟ้าแสดง:
   • ยอดเครื่องใหม่ ฿35,000
   • − ตีเครดิตเครื่องเก่า ฿10,000
   • = ลูกค้าจ่ายเพิ่ม ฿25,000
   • (ถ้าตีเครดิตมากกว่าเครื่องใหม่ → Alert orange เตือนต้องคืนเงินส่วนต่าง)
5. กด ใช้ตีเครดิต ฿X → modal ปิด → ใน cart มีบรรทัด violet "เครื่องเทรด" + ราคาติดลบ
6. ยอดชำระ (total) แสดงเฉพาะ net amount due = สิ่งที่ลูกค้าต้องจ่ายเพิ่ม
7. กด checkout → backend atomic transaction:
   • สร้าง Purchase (เครื่องเก่าเข้าระบบ)
   • สร้าง Product ใหม่จาก purchase (status=AVAILABLE in stock, source=TRADE_IN)
   • สร้าง Sale ของเครื่องใหม่ + เซ็ต tradeInPurchaseId, tradeInValue, netAmountDue
   • คืน sale record + เปิดใบเสร็จ

ข้อดี:

• Cashier ทำขั้นตอนเดียว ไม่งง
• Audit trail: ต้นทุน iPhone 12 เก่า = ฿10,000 (จาก trade-in) — ตอนขายต่อในอนาคต กำไรคิดถูกต้อง
• Sale receipt มีทั้ง 2 รายการ (เครื่องใหม่ + ตีเครดิต) + net amount due
• Reduce double-counting ในรายงานกำไร

ลบเครื่องเทรด: กดไอคอนถังขยะที่บรรทัด violet → ลบออกก่อน checkout (ก่อน save = แก้ได้)

6.8 การคืนเงิน — Analytics (Refunds list) ⭐ NEW

📍 หน้า: /refunds 👤 สิทธิ์: OWNER, ADMIN, MANAGER

วัตถุประสงค์: ระบบ Refund มีอยู่แล้วฝังใน /sales-history (refund per sale) แต่ไม่มีหน้า list รวม + analytics — ตอนนี้มี

Stat cards:

• จำนวนรายการ refund
• เงินที่คืนรวม

Filters:

• ค้นหา: receipt number / customer name / phone
• ช่วงวันที่ (default 30 วันล่าสุด)
• วิธีคืน: ทุกวิธี / CASH / TRANSFER / CREDIT_CARD / STORE_CREDIT / EXCHANGE

List view:

• แต่ละ row: badge วิธีคืน + receipt number + status (คืนเต็ม/บางส่วน) + customer + วันที่ + เหตุผล + ผู้ทำ refund + จำนวนเงินคืน
• คลิก → modal detail แสดง returnedItems + เหตุผลเต็ม

ใช้สำหรับ:

• Audit trail (auditor ขอ refund log บ่อย)
• Detect fraud — cashier ทำ refund บ่อยผิดปกติ
• Detect quality issues — มือถือยี่ห้อ X รุ่น Y refund เยอะ → อาจมีปัญหา

6.9 ใบแจ้งหนี้ B2B (SalesInvoice) ⭐ NEW

📍 หน้า: /invoices 👤 สิทธิ์: OWNER, ADMIN

วัตถุประสงค์: ลูกค้าบุคคลจ่ายทันที — ลูกค้าบริษัท (ตัวแทน, ออฟฟิศซื้อยกล็อต) อยากได้ "ใบแจ้งหนี้" + เครดิต net-30/60 จ่ายภายหลัง. ระบบนี้รองรับ B2B workflow ครบ

Customer setup ก่อน: ใน /customers form เพิ่ม fields ใหม่:

• type: INDIVIDUAL (default) / CORPORATE
• taxId (13 หลัก)
• contactPerson
• paymentTerms: cash / net-7 / net-15 / net-30 / net-60
• creditLimit (วงเงินเครดิต)
• currentDebt — ยอดค้างทั้งหมด (auto-update)

6.9.1 ออก Invoice (/invoices → ออก invoice)

Workflow:

1. กด ออก invoice
2. เลือกลูกค้า (B2B จะมี badge "B2B")
3. เพิ่มรายการ — มี 2 modes:
   • ค้นหา product/accessory — type ≥2 chars → search → click result → auto-fill ชื่อ + ราคา + qty=1
   • + รายการเอง — สำหรับ service/labor ที่ไม่มีในสต็อก (พิมพ์เอง)
4. ปรับ qty / unitPrice ที่ NumberInput (lag-free — uncontrolled refs)
5. กรอก VAT (ถ้ามีใบกำกับเต็มรูป) + เลือก payment terms
6. Subtotal / VAT / รวม auto-calc
7. กด ออก invoice → ระบบ:
   • Auto-detect dueDate จาก paymentTerms (net-30 → +30 วัน)
   • ตั้ง status=ISSUED + เลขที่ INV-{branchCode}-{BEyear}-{seq:04}
   • Increment Customer.currentDebt
   • ตรวจ creditLimit — ถ้าเกิน → block + Alert (เฉพาะ CORPORATE)

6.9.2 รับเงิน (Payment)

ใน detail modal กด บันทึกรับเงิน:

• กรอก: จำนวนเงิน + วันที่ + วิธีชำระ (cash/transfer/cheque/credit_card) + อ้างอิง (เลขที่เช็ค/slip)
• ระบบ:
  • สร้าง InvoicePayment record
  • Update Invoice.paidAmount += amount
  • Auto status: PARTIAL_PAID (ถ้า paidAmount < totalAmount) / PAID (ถ้าเต็ม)
  • Decrement Customer.currentDebt
• รับเงินได้หลายครั้ง — ทุกครั้งบันทึก

6.9.3 Status & Aging

4 Stat cards บน list: จำนวน / รวมยอด / รับเงินแล้ว / คงค้าง (สีส้มถ้า > 0)

Tabs: ทั้งหมด / รอจ่าย / เกินกำหนด / จ่ายแล้ว

UI hints:

• ครบกำหนดในอีก ≤ 7 วัน → text สีส้ม "เหลือ X วัน"
• Overdue → text สีแดง "เกิน X วัน"

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

📍 หน้า: /warranty 👤 สิทธิ์: OWNER, ADMIN, MANAGER, CASHIER, SALES, SALESTECH

วัตถุประสงค์: บันทึกและติดตามประกันสินค้าที่ขายออกไป (มือถือและอุปกรณ์เสริม)

ขั้นตอนเพิ่มประกัน:

1. กดปุ่ม "+ เพิ่มประกัน"
2. เลือกลูกค้า
3. เลือกประเภท: มือถือ หรือ อุปกรณ์เสริม
4. เลือกสินค้าที่ต้องการออกประกัน
5. เลือกระยะเวลาประกัน (เลือกจาก Master Warranty Periods)
6. วันเริ่มต้น — วันหมดอายุ (คำนวณอัตโนมัติ)
7. กรอกหมายเหตุเงื่อนไขประกัน
8. กดปุ่ม "บันทึก"

สถานะประกัน:

Expiring Warranties Widget:

• แสดงอยู่ใน Dashboard
• แจ้งเตือนประกันที่จะหมดอายุใน 30 วัน
• คลิกเพื่อดูรายละเอียดและติดต่อลูกค้า

8. ลูกค้า

📍 หน้า: /customers 👤 สิทธิ์: OWNER, ADMIN, MANAGER, CASHIER, SALES, SALESTECH

วัตถุประสงค์: จัดการฐานข้อมูลลูกค้า ค้นหา เพิ่ม แก้ไข และดูประวัติ

ขั้นตอนเพิ่มลูกค้าใหม่:

1. กดปุ่ม "+ เพิ่มลูกค้า"
2. กรอกข้อมูล:

1. กดปุ่ม "บันทึก"

ฟีเจอร์ค้นหาลูกค้า:

• ค้นหาด้วยชื่อ, เบอร์โทร, อีเมล
• Debounce Search (รอ input หยุดก่อนค้นหา)
• ค้นหาจากตัวอักษรแรก

ประวัติลูกค้า:

• คลิกที่ลูกค้าเพื่อดูประวัติ
• ประวัติการซื้อ (Sales)
• ประวัติการซ่อม (Repairs)
• ประกันที่ยังใช้งาน
• ยอดซื้อทั้งหมด

9. ลงเวลาทำงาน

9.1 หน้าลงเวลา

📍 หน้า: /attendance 👤 สิทธิ์: OWNER, ADMIN, MANAGER

วัตถุประสงค์: ดูรายการการลงเวลาของพนักงาน กรอง ค้นหา และแก้ไข

ฟีเจอร์:

• ดูรายการการลงเวลาทั้งหมดตาม Branch
• กรองตามวันที่, พนักงาน
• ดูเวลาเข้า-ออกงาน
• ตรวจสอบ Late (สาย) และ Early Leave (ออกก่อนเวลา)
• แก้ไขการลงเวลาด้วยตนเอง (เมื่อระบบผิดพลาด)
• Export รายงานการลงเวลา

การลงเวลาผ่านระบบ (Admin):

1. กดปุ่ม "เปิดสแกน QR" เพื่อสแกน QR Code พนักงาน
2. เลือก ลงเวลาเข้า หรือ ลงเวลาออก
3. ระบบบันทึกเวลาอัตโนมัติพร้อม Timestamp

ฟิลด์การลงเวลา:

9.2 Kiosk Attendance (QR Code) — Pro+

📍 หน้า: /kiosk/login → /kiosk 👤 สิทธิ์: ระบบแยกสำหรับพนักงาน (ไม่ต้อง Login หลัก) 📦 แพ็คเกจ: Professional หรือ Enterprise (ฟีเจอร์นี้ถูกล็อคในแพ็คเกจ Starter)

วัตถุประสงค์: หน้าจอ Kiosk สำหรับพนักงานสแกน QR Code เพื่อลงเวลาเข้า-ออก โดยไม่ต้องล็อกอินระบบหลัก — เหมาะกับ tablet/iPad วางหน้าร้าน

การเปิดใช้งาน Kiosk:

1. ไปที่หน้า ลงเวลา (/attendance) ในฐานะ Admin/Manager
2. ดูแถบ "โหมด Kiosk ลงเวลา" ด้านบนของหน้า
3. กดปุ่ม "คัดลอก URL" เพื่อ copy ลิงก์ Kiosk (เช่น https://shop.com/kiosk/login)
4. หรือกดปุ่ม "เปิด Kiosk" เปิดในแท็บใหม่
5. นำ URL ไปเปิดบนแท็บเล็ตที่หน้าร้าน → login ครั้งเดียวด้วยบัญชีร้าน

ขั้นตอนลงเวลาพนักงาน:

1. เปิดหน้า /kiosk บนแท็บเล็ตหรือคอมพิวเตอร์หน้าร้าน
2. พนักงานสแกน QR Code ส่วนตัว (ดูได้จากหน้าผู้ใช้งานหรือโปรไฟล์)
3. ระบบแสดงชื่อพนักงาน
4. กดปุ่ม "ลงเวลาเข้า" หรือ "ลงเวลาออก"
5. ระบบบันทึกเวลาและแจ้งผล (เสียงและ Visual)

QR Code พนักงาน:

• แต่ละพนักงานมี QR Code เฉพาะตัว
• ดูได้จากหน้า ผู้ใช้งาน → คลิกพนักงาน → QR Code
• พิมพ์ QR Code เป็นบัตรลงเวลาได้

10. เงินเดือน

📍 หน้า: /payroll 👤 สิทธิ์: OWNER, ADMIN, MANAGER 📦 แพ็คเกจ: ENTERPRISE (PAYROLL feature)

วัตถุประสงค์: คำนวณเงินเดือนพนักงาน เพิ่ม/หักรายการ อนุมัติ บันทึกการจ่าย และพิมพ์สลิป

10.1 การเตรียมข้อมูล (ทำก่อนใช้งานครั้งแรก)

1. ตั้งเงินเดือนพื้นฐานของพนักงาน ที่ /users → แก้ไข → ช่อง "เงินเดือนพื้นฐาน" → บันทึก. ระบบจะสร้าง EmployeeSalary record อัตโนมัติเมื่อ baseSalary > 0

2. (แนะนำ) ตั้งค่าประเภทรายการเงินเดือน ที่ /masters/deduction-types:

   • รายได้เพิ่ม (toggle "เป็นรายการหัก" = ปิด): OT, ค่าคอมมิชชั่น, โบนัส, ค่าเดินทาง, เบี้ยขยัน
   • รายการหัก (toggle "เป็นรายการหัก" = เปิด): ภาษีหัก ณ ที่จ่าย, ประกันสังคม, กองทุนสำรอง, มาสาย, ขาดงาน

10.2 ขั้นตอนคำนวณเงินเดือน

1. กดปุ่ม "คำนวณเงินเดือน" มุมขวาบน
2. เลือก เดือน + ปี (พ.ศ.) + พนักงาน (เว้นว่าง = คำนวณทุกคน)
3. กด "คำนวณ" → ระบบสร้าง record Payroll สำหรับพนักงานที่ยังไม่มีรอบนี้
4. Toast จะรายงานสาเหตุ ถ้าพนักงานบางคนถูกข้าม (ยังไม่ตั้งเงินเดือนพื้นฐาน · มีรอบนี้แล้ว) — ตามเหตุผลแล้วลองใหม่

10.3 เพิ่ม/หักรายการ (Adjustments) — สถานะ PENDING เท่านั้น

ตาราง 4 columns: เงินเดือนพื้นฐาน · รายได้เพิ่ม · รายการหัก · รวมสุทธิ — ค่าจริงดึงจาก totalAdditions / totalDeductions

1. กด ไอคอน 📊 "รายละเอียด" ในแถวพนักงาน
2. ใน Modal:
   • Hero card — ชื่อ + รอบเดือน + status badge
   • 3 KPI cards — เงินเดือนพื้นฐาน / รายได้เพิ่ม / รายการหัก
   • Form เพิ่ม adjustment (เห็นเฉพาะ PENDING):
     • ประเภท — เลือกจาก master ที่ตั้งใน /masters/deduction-types (auto-detect รายได้เพิ่ม/หัก จาก isDeduction ของประเภท)
     • รายละเอียด — เช่น "OT 8 ชม. วันที่ 15"
     • จำนวนเงิน — บาท
     • กด "+ เพิ่ม" → backend recompute totalAdditions/totalDeductions/netSalary ทันที
   • List แยก 2 sections — ▲ รายได้เพิ่ม (เขียว) · ▼ รายการหัก (แดง) — แต่ละ row มีปุ่ม 🗑️ ลบ (PENDING เท่านั้น)
   • Net Pay box — สีฟ้าเข้ม + จำนวนเงินใหญ่ + breakdown formula

10.4 สถานะเงินเดือน + Workflow

ขั้นตอน:

1. ตรวจ adjustments ใน detail modal → กด "อนุมัติ" → status APPROVED (ตัวเลข lock)
2. หลังจ่ายเงินจริง (โอนเข้าบัญชีพนักงาน) → กด "จ่ายเงิน" → ใส่ note (เลขอ้างอิง/วันที่จริง) → status PAID
3. กด ไอคอน 🖨️ "พิมพ์สลิปเงินเดือน" ในแถว → เปิด Modal preview สลิป A4 → กด "พิมพ์"

10.5 พิมพ์สลิปเงินเดือน (Payslip)

• เปิดผ่านปุ่ม 🖨️ ในแถว หรือใน detail modal (ปุ่ม "พิมพ์สลิป")
• รูปแบบ A4 — Hero header + ข้อมูลพนักงาน + 2-col earnings/deductions + Net Pay พร้อมข้อความไทย ("สามหมื่นห้าพันบาทถ้วน") + 2 ลายเซ็น (HR/พนักงาน)
• บนมือถือ — เลื่อนแนวนอนได้ (slip เป็น A4 width — ห้ามบีบเป็น mobile)

10A. ค่าใช้จ่ายดำเนินงาน (Operating Expenses)

📍 เส้นทาง: เมนูซ้าย → "พนักงาน & การเงิน" → ค่าใช้จ่าย (/expenses) 👤 สิทธิ์: OWNER, ADMIN

วัตถุประสงค์: บันทึกค่าใช้จ่ายดำเนินงาน (ค่าเช่าร้าน, ค่าน้ำ-ไฟ, ค่าน้ำมัน, marketing, ฯลฯ) ที่ไม่ใช่ค่าซื้อสินค้าหรือเงินเดือน — เพื่อให้:

1. PIT ACTUAL deduction ครบถ้วน — ภ.ง.ด.94/90 วิธี ACTUAL ต้องบวก expense รายการนี้เข้าด้วย ไม่งั้นหักได้น้อยเกินจริง
2. ภาษีซื้อใน ภ.พ.30 — ค่าใช้จ่ายที่มีใบกำกับเต็มรูป (เช่น ค่าน้ำ-ไฟ-เน็ต) ใช้เป็น input VAT ลด net VAT ที่ต้องส่ง
3. WHT (ภ.ง.ด.3/53) — ถ้าจ่ายค่าจ้าง freelance / outsource → กรอก hasWht + อัตรา → ระบบเก็บข้อมูลเตรียม export ภ.ง.ด.3
4. CIT (ภ.ง.ด.50/51) — บริษัทใช้คำนวณกำไรสุทธิ (รายได้ − รายจ่าย)

10A.1 หมวดเริ่มต้น (9 หมวด)

ระบบ auto-seed 9 หมวดเมื่อสร้าง tenant ใหม่:

จัดการเพิ่ม/แก้ไข/ลบหมวดได้ที่ /masters/expense-categories

10A.2 บันทึกค่าใช้จ่ายใหม่

1. กดปุ่ม + เพิ่มค่าใช้จ่าย
2. กรอกข้อมูล:

1. ถ้าเปิด หัก ณ ที่จ่าย → กรอกเพิ่ม:
   • อัตรา WHT: 1% ดอกเบี้ย / 3% บริการ / 5% เช่า / 15% วิชาชีพอิสระ
   • ชื่อผู้รับเงิน + เลขประจำตัวผู้เสียภาษี — ใช้สำหรับกรอก ภ.ง.ด.3/53
   • ระบบคำนวณ whtAmount อัตโนมัติ (amount × rate ÷ 100)
2. กด บันทึก

10A.3 รายงาน + Export

• Stat cards 4 ใบบนหน้า /expenses — จำนวนรายการ / รวมก่อน VAT / ภาษีซื้อ / WHT รวม
• Filter — ค้นหา + หมวด + เดือน/ปี + WHT toggle
• Export to /tax/pit — ค่าใช้จ่ายในช่วงเวลานั้นถูกรวมเข้า "ACTUAL deduction" อัตโนมัติเมื่อ tenant ใช้วิธี ACTUAL
• Export to /tax/vat — ค่าใช้จ่ายที่มี vatAmount > 0 ถูกรวมเข้า "ภาษีซื้อ" ของ ภ.พ.30 อัตโนมัติ

10B. กะการขาย + ลิ้นชักเงินสด (Cashier Shift)

📍 เส้นทาง: เมนูซ้าย → "ขาย & ลูกค้า" → กะการขาย (/shift) 👤 สิทธิ์: ทุก role ที่ขายได้ (CASHIER, SALES, MANAGER, ADMIN, OWNER) — เปิด-ปิดกะของตัวเอง; ADMIN/MANAGER ดูประวัติของพนักงานคนอื่นได้

วัตถุประสงค์: ทุกร้าน POS ต้องนับเงินสดในลิ้นชักตอนเปิด-ปิดงาน เทียบกับยอดที่ระบบบันทึก เพื่อ:

• จับ cashier ที่นับผิด/ทอนผิด/ลืมรับ → variance
• จับการขโมยเงินจากลิ้นชัก
• มี audit trail ละเอียด ตามข้อกำหนดของผู้สอบบัญชี (CIT/PIT)

10B.0 นโยบายการบังคับเปิดกะ (Shift Enforcement)

ตามมาตรฐาน POS สากล (Microsoft Dynamics 365 Commerce, Shopify POS, Lightspeed) — "POS requires that users have an active and open shift to perform any operations that produce a financial transaction"

กฎ default ใน MobileHub:

ปรับแก้นโยบายได้ที่ /settings → "นโยบายกะการขาย (POS Shift)" — MultiSelect ให้เลือกบทบาทใดบ้างที่ต้องบังคับ. เคลียร์ทั้งหมด = ปิดการบังคับ (ทุก role ขายได้ตรง).

สิ่งที่เกิดถ้าบังคับ + ยังไม่เปิดกะ:

• หน้า /sales แสดง banner สีส้ม + ปุ่ม "ไปเปิดกะการขาย" → กดเข้า /shift
• ปุ่ม "ยืนยันการขาย" ถูกซ่อน (Grid ของ POS UI ถูก hide)
• ถ้ายิง POST /sales ตรง API → backend ตอบ 403 SHIFT_REQUIRED พร้อม message ภาษาไทย
• การคืนเงิน (refund) ก็ถูก block เหมือนกัน (เงินออกจากลิ้นชัก → ต้อง audit)

10B.1 Workflow 3 ขั้นตอน

(1) เปิดกะ — ตอนเริ่มงาน

1. นับเงินสดในลิ้นชัก ณ ตอนเริ่มงาน
2. ไป /shift → กดปุ่ม เปิดกะ
3. กรอก เงินทอนเริ่มต้น (จำนวนเงินสดที่นับได้) → Submit
4. ระบบสร้าง CashierSession (status=OPEN) — sale ใหม่ที่ user นี้ขายในสาขานี้จะ link เข้า session อัตโนมัติ

(2) ระหว่างกะ — POS ทำงานปกติ

• ขายผ่าน /sales ตามปกติ — ไม่ต้องคิดเรื่อง shift
• ทุก checkout จะถูก link เข้า session ของ user (ถ้ามีกะที่เปิดอยู่)
• บทบาทที่อยู่ใน list บังคับ (default = CASHIER/SALES) — ถ้ายังไม่เปิดกะจะขายไม่ได้ ตามนโยบาย §10B.0
• บทบาทที่ bypass (OWNER/ADMIN/MANAGER) — ขายได้ตรง; ถ้าบังเอิญเปิดกะไว้ก็ link เข้า session ของตัวเองอัตโนมัติ; ถ้าไม่เปิด — sale ลอย (ไม่ link)

(3) ปิดกะ — ตอนเลิกงาน

1. ไป /shift → กดปุ่ม ปิดกะ ที่ card "กะที่เปิดอยู่"
2. ระบบโชว์ ยอดที่ควรจะมี (Expected) — breakdown:

   เงินทอนเริ่มต้น        ฿ 2,000.00
   + เงินสดที่ขาย (15 ออเดอร์)  ฿ 18,500.00
   − เงินสดที่ refund     ฿     500.00
   ─────────────────────
   = ที่ควรจะมี           ฿ 20,000.00
   

   พร้อมยอดอื่น (โอน/PromptPay/บัตร) ที่ ไม่ต้องนับในลิ้นชัก
3. นับเงินสดในลิ้นชักจริง → กรอกในช่อง "เงินสดที่นับจริง"
4. ระบบคำนวณ variance อัตโนมัติ:
   • variance = 0 → 🟢 OK ยอดตรง
   • ±฿1 ขึ้นไป → 🟠 ต้องระบุเหตุผล
   • >฿100 → 🔴 alert สีแดง (อาจมีปัญหาจริง)
5. กรอกเหตุผล (ถ้ามี variance) → ยืนยันปิดกะ
6. ระบบบันทึก expected/actual/variance + snapshot ของ totalCashSales/totalTransferSales/totalCardSales/totalCashRefunds + saleCount

10B.2 ความสัมพันธ์กับ Z Report

10B.3 Variance threshold

ระบบเตือนเมื่อ variance > ฿1 แต่ไม่ block — ยังปิดกะได้ถ้ากรอกเหตุผล. เหตุผลทั่วไป:

• ลูกค้าจ่ายเกินไม่รับเงินทอน
• เงินทอนเริ่มต้นกะก่อนนับผิด
• ลืมบันทึก sale ในระบบ (จ่ายเงินสดแต่ไม่ออกใบเสร็จ — discouraged)
• เก็บเงินไว้ในกระเป๋าตัวเอง (เคยมีกรณีที่ใช้คำนี้ → admin ต้องสอบสวน)

10B.4 Best practices

• เปิด-ปิดกะ ทุกวัน 1 ครั้ง — ไม่ใช่หลายวันต่อกะ (variance สะสมยากตรวจ)
• นับเงินจริงด้วยตา — อย่า assume = expected (ระบบ pre-fill เพื่อความเร็ว แต่ต้องนับจริง)
• Variance > ฿100 → admin ต้องเรียกมาคุย ไม่ปล่อย
• Audit trail ไม่สามารถลบ/แก้กะที่ปิดแล้ว — ต้องสร้าง adjustment entry ภายหลัง

11. รายงาน

📍 หน้า: /reports 👤 สิทธิ์: OWNER, ADMIN, MANAGER

วัตถุประสงค์: ดูรายงานสรุปในรูปแบบต่างๆ เลือกช่วงวันที่ Export Excel ได้

ประเภทรายงาน:

ขั้นตอนดูรายงาน:

1. เลือก ประเภทรายงาน จาก Dropdown
2. เลือก ช่วงวันที่ ด้วย CustomDatePicker (ปฏิทินพุทธศักราช)
3. กดปุ่ม "โหลดรายงาน"
4. ดูข้อมูลในตาราง (Desktop) หรือ Card (Mobile)
5. กดปุ่ม "Export Excel" เพื่อดาวน์โหลดไฟล์ .xlsx (📦 Pro+ เท่านั้น)

11.1 ภาษีเงินได้บุคคลธรรมดา (ภ.ง.ด.94/90) ⭐ ใหม่

📍 เลือก: /reports → ภาษีเงินได้บุคคลธรรมดา (ภ.ง.ด.94/90) 👤 สำหรับ: ร้านที่ไม่ได้จดเป็นนิติบุคคล (บุคคลธรรมดา) — ทั้งร้านที่จด VAT และไม่จด VAT

วัตถุประสงค์: คำนวณภาษีเงินได้สำหรับเจ้าของกิจการที่เป็น<strong>บุคคลธรรมดา</strong> ภายใต้มาตรา 40(8) (เงินได้จากการพาณิชย์) — ครอบคลุมทั้ง ภ.ง.ด.94 (กลางปี) และ ภ.ง.ด.90 (เต็มปี)

ก่อนใช้งาน — ตั้งค่าที่ /settings → ภาษีเงินได้ (ภ.ง.ด.):

1. ประเภทผู้เสียภาษี — เลือก "บุคคลธรรมดา" (นิติบุคคลยังไม่รองรับ)
2. วิธีหักค่าใช้จ่าย — เลือก:
   • หักเหมา 60% (แนะนำ) — ระบบหักให้อัตโนมัติ ไม่ต้องเก็บใบเสร็จรายจ่าย
   • หักตามจริง — ใช้ต้นทุนจริง (รับซื้อ + อะไหล่ที่เบิก + เงินเดือนพนักงาน) เหมาะถ้ารายจ่าย > 60%
3. เลขผู้เสียภาษี 13 หลัก (ใช้บัตรประชาชนเจ้าของ — optional แต่จะแสดงในเอกสาร)
4. ค่าลดหย่อน — แบ่ง 4 กลุ่ม ตามแบบ ภ.ง.ด.90 ปี 2568:
   • กลุ่ม 1 ส่วนตัวและครอบครัว: ส่วนตัว 60k, คู่สมรส, จำนวนบุตร, จำนวนพ่อแม่
   • กลุ่ม 2 การออมและการลงทุน: ประกันสังคม, ประกันชีวิต/สุขภาพ, RMF, SSF, กองทุนสำรองเลี้ยงชีพ
   • กลุ่ม 3 สินทรัพย์และมาตรการรัฐ: ดอกเบี้ยบ้าน, Thai ESG, ช้อปดีมีคืน/Easy E-Receipt, Solar rooftop
   • กลุ่ม 4 เงินบริจาค: บริจาคทั่วไป, บริจาคการศึกษา (×2), พรรคการเมือง

ขั้นตอนดูรายงาน:

1. เลือก ประเภทรายงาน: "ภาษีเงินได้บุคคลธรรมดา (ภ.ง.ด.94/90)"
2. เลือก ช่วงเวลา: ครึ่งปีแรก (ภ.ง.ด.94) / ทั้งปี (ภ.ง.ด.90) / ช่วงที่กำหนด
3. เลือก ปีภาษี (ปฏิทินพุทธ-คริสต์)
4. กด "โหลดรายงาน"

ผลลัพธ์ที่แสดง:

• 4 การ์ดสรุป — รายได้รวม / หักค่าใช้จ่าย / หักค่าลดหย่อน / ภาษีต้องชำระ (สีฟ้าเด่น)
• คอลัมน์ซ้าย — math chain: รายได้ → หักค่าใช้จ่าย → หักค่าลดหย่อน → เงินได้สุทธิที่ต้องเสียภาษี
  • ค่าลดหย่อนแสดงแบ่งตาม 4 กลุ่ม ตามแบบ ภ.ง.ด.90 ราชการ
  • กรณีรายได้เกิน 1 ล้าน — มีกล่องเปรียบเทียบ ม.48(2) (วิธีก้าวหน้า vs 0.5%) แสดงว่าใช้วิธีไหน
• คอลัมน์ขวา — ตารางอัตราภาษีก้าวหน้า 8 ขั้น (0/5/10/15/20/25/30/35%) แต่ละช่วงแสดงฐาน + ภาษีในช่วงนั้น
• กล่องสรุปสุดท้าย — ภาษีรวมสีฟ้า cyan-7 + ฉลาก ภ.ง.ด.94/90 ปีภาษี + วิธีคำนวณที่ใช้

พิมพ์เอกสาร ภ.ง.ด. (ใหม่):

1. กดปุ่ม "พิมพ์ ภ.ง.ด.94" หรือ "พิมพ์ ภ.ง.ด.90" ที่มุมขวา
2. หน้าต่าง Modal preview เปิดขึ้น — A4 portrait, accountant-summary style
3. มี 4 sections: ก. รายได้ / ข. ค่าใช้จ่าย / ค. ค่าลดหย่อน / ง. การคำนวณภาษีก้าวหน้า
4. กล่องสรุปสุดท้าย "ภาษีที่ต้องชำระ" สีฟ้า + ลายเซ็น 2 ช่อง (ผู้เสียภาษี / ผู้ทำบัญชี)
5. กด "พิมพ์" → เปิด print dialog ของเบราว์เซอร์

กำหนดการยื่นจริง:

• ภ.ง.ด.94 (ครึ่งปีแรก ม.ค.–มิ.ย.) — ยื่นช่วง 1 ก.ค. – 30 ก.ย.
• ภ.ง.ด.90 (เต็มปี) — ยื่นช่วง 1 ม.ค. – 31 มี.ค. ของปีถัดไป

ทำไมเหมาะกับร้านมือถือ?

• ร้านส่วนใหญ่รายได้ต่ำกว่า 1.8 ล้าน/ปี ไม่ต้องจด VAT แต่<strong>ยังต้องยื่นภาษีเงินได้</strong>
• การหักเหมา 60% ช่วยให้คำนวณง่าย ไม่ต้องเก็บใบเสร็จรายจ่ายแยก
• ใช้ข้อมูลจากระบบ MobileHub ที่มีอยู่แล้ว (Sale + Repair → รายได้, Purchase + Parts + Payroll → รายจ่าย)
• ตารางอัตราก้าวหน้าโชว์ให้เห็นชัด: คุณจ่าย 35% เฉพาะส่วนเกิน 5 ล้าน ไม่ใช่ทั้งก้อน

11A. ภาษี (เมนูใหม่ — /tax) ⭐ NEW

📍 เมนูใหม่บน sidebar: "ภาษี" — section header + 4 sub-items 👤 สิทธิ์: ADMIN, OWNER

วัตถุประสงค์: รวบรวมเมนูที่เกี่ยวกับ<strong>ภาษี</strong>ทั้งหมดไว้ที่เดียว — ตั้งค่า, คำนวณ, พิมพ์เอกสาร เพื่อใช้งานในช่วงเตรียมยื่นภาษี

โครงสร้างเมนู

📊 ภาษี
├── 🏛 ภาพรวม                /tax           — Dashboard + กำหนดยื่น + Quick stats
├── 🧮 ภ.ง.ด.94/90 (PIT)      /tax/pit       — คำนวณภาษีเงินได้บุคคลธรรมดา (8-tier progressive + ม.48(2))
├── 🏢 ภ.ง.ด.50/51 (CIT)      /tax/cit       — คำนวณภาษีเงินได้นิติบุคคล (SME 0/15/20% หรือ Non-SME 20%)
├── ⚖️  ภ.พ.30 (VAT)           /tax/vat       — สรุปภาษีมูลค่าเพิ่มรายเดือน
├── 💰 ภ.ง.ด.3/53 (WHT)       /tax/wht       — สรุปหัก ณ ที่จ่ายตามผู้รับ + Export CSV
└── ⚙️  ตั้งค่าภาษี              /tax/settings  — entityType + วิธีหักค่าใช้จ่าย + ค่าลดหย่อน 4 กลุ่ม

11A.1 ภาพรวมภาษี (/tax)

หน้าศูนย์กลางสำหรับงานภาษี แสดง:

• Status alert — แจ้งเตือนถ้าตั้งค่ายังไม่ครบ (entityType / taxId / ค่าลดหย่อน)
• 4 stat cards — รายได้ YTD / ภาษีเงินได้ประมาณการ / VAT สุทธิเดือนนี้ / สถานะการตั้งค่า
• กำหนดยื่นถัดไป — รายการ ภ.พ.30 / ภ.ง.ด.94 / ภ.ง.ด.90 พร้อมวันที่ + จำนวนวันที่เหลือ (สีแดงถ้า ≤ 7 วัน)
• เครื่องมือภาษี 4 cards — คลิกไป sub-page ตามต้องการ

11A.2 ภ.ง.ด.94/90 (/tax/pit)

หน้าคำนวณภาษีเงินได้บุคคลธรรมดา (รายละเอียดเดียวกับ §11.1 ก่อนแยกเมนู) — กดปุ่มภายในหน้าเพื่อพิมพ์เอกสารอ้างอิง

11A.3 ภ.ง.ด.50/51 — ภาษีเงินได้นิติบุคคล (/tax/cit) ⭐ NEW

📍 เส้นทาง: /tax/cit (sub-menu ของ /tax) 👤 เงื่อนไข: tenant.entityType = CORPORATION เท่านั้น (เปลี่ยนได้ที่ /tax/settings)

คำนวณภาษีจากกำไรสุทธิ (Net Profit = รายได้ − รายจ่าย) ตามอัตรา:

Workflow:

1. ไปที่ /tax/cit
2. เลือกรอบบัญชี (H1 = ภ.ง.ด.51 ครึ่งปี / FULL = ภ.ง.ด.50 ทั้งปี) + ปี
3. ระบบโหลดข้อมูลและแสดง:
   • 4 stat cards: รายได้รวม / รายจ่ายรวม / กำไรสุทธิ (เขียวถ้า > 0, แดงถ้าขาดทุน) / ภาษีต้องชำระ + SME badge
   • งบกำไรขาดทุน (P&L) — แยก revenue 2 ตัว (ขาย + ซ่อม) − expense 4 ตัว (ต้นทุนสินค้า + อะไหล่ + เงินเดือน + operating)
   • Tax bracket table — แสดงทุก bracket พร้อม taxable + tax — เห็นชัดว่าเสียในแต่ละช่วงเท่าไร
4. ถ้าขาดทุน → Alert แจ้งว่าไม่ต้องเสียภาษี + ข้อแนะนำ loss carry forward 5 ปี
5. ถ้าครึ่งปี (ภ.ง.ด.51) → Alert แจ้งว่าใช้เป็นเครดิตหักจาก ภ.ง.ด.50 ตอนสิ้นปี

Deadline:

• ภ.ง.ด.51: ภายใน 2 เดือนหลังสิ้นรอบครึ่งปีบัญชี (ปกติ 31 ส.ค.)
• ภ.ง.ด.50: ภายใน 150 วันหลังสิ้นรอบบัญชี (ปกติ 30 พ.ค.)

11A.4 ภ.พ.30 (/tax/vat)

หน้าสรุปภาษีมูลค่าเพิ่มรายเดือน สำหรับร้านที่จดทะเบียน VAT — เลือกช่วงเดือน + ปุ่มพิมพ์ ภ.พ.30 + Card รายเดือน

11A.5 ภ.ง.ด.3/53 — หัก ณ ที่จ่าย (/tax/wht) ⭐ NEW

📍 เส้นทาง: /tax/wht 👤 สิทธิ์: ADMIN, OWNER

สรุปการหัก ณ ที่จ่ายรายเดือน สำหรับยื่น ภ.ง.ด.3 (จ่ายให้บุคคลธรรมดา) และ ภ.ง.ด.53 (จ่ายให้นิติบุคคล)

ใช้ข้อมูลจาก: /expenses ที่กรอก hasWht=true + whtRate + whtPayeeName + whtPayeeTaxId

การจำแนกแบบ:

Workflow:

1. ไป /tax/wht → เลือก เดือน + ปี + กรองแบบ (ทั้งหมด/ภ.ง.ด.3/ภ.ง.ด.53)
2. ระบบแสดง:
   • 4 stat cards: จำนวนรายการ / เงินที่จ่าย / ภาษีที่หัก (สีส้มเด่น) / จำนวนผู้รับ unique
   • สรุปตามอัตรา (1% / 3% / 5% / 15%)
   • Tab "ตามผู้รับเงิน" — group by payee + taxId พร้อม badge แบบ
   • Tab "รายการทั้งหมด" — transaction list
3. กดปุ่ม CSV → ดาวน์โหลด CSV format ที่ใช้กรอก e-Filing ได้
4. ยื่นที่ https://efiling.rd.go.th ภายในวันที่ 7 ของเดือนถัดไป

11A.6 ตั้งค่าภาษี (/tax/settings)

หน้าฟอร์มตั้งค่าภาษี (entityType + deduction method + 4-group allowance) — เดิมอยู่ใน /settings ย้ายมาที่นี่เพื่อให้เป็นกลุ่มเดียวกัน

12. เอกสารพิมพ์ในระบบ

ระบบ MobileHub ออกเอกสารพิมพ์ A4/Thermal ได้ทั้งหมด 12 ประเภท ใช้รูปแบบ design system เดียวกัน (header 2-col + accent color cascade ผ่าน CSS variable + ลายเซ็นมาตรฐาน + ฟอนต์ Kanit). ทุกเอกสารพิมพ์ผ่านเบราว์เซอร์ — ไม่ต้องลง driver พิเศษ

12.0 เลขที่เอกสาร (Document Numbering)

ทุกเอกสารทางการเงินในระบบใช้เลขที่ running serial ต่อเนื่องตลอดปีภาษี ตามประกาศอธิบดีสรรพากร ว.196/2553 (ใบกำกับภาษีต้องมีเลขเรียงต่อเนื่อง)

Format มาตรฐาน: {PREFIX}-{branchCode}-{BEyear}-{seq:04}

ตัวอย่าง:

• RC-HQ-2569-0001 — ใบเสร็จขายใบแรกของสาขา HQ ปี 2569
• RCV-CM01-2569-0042 — ใบรับซ่อมใบที่ 42 ของสาขาเชียงใหม่ ปี 2569
• WRT-HQ-2569-0015 — ใบประกันใบที่ 15 ของสาขา HQ ปี 2569

กฎการ reset:

• Counter reset อัตโนมัติทุก 1 มกราคม (เริ่ม 0001 ใหม่ในปี พ.ศ. ถัดไป)
• แยก counter ต่อสาขา — สาขา HQ กับ CM01 มีลำดับเลขของตัวเอง ไม่กวนกัน
• แยก counter ต่อประเภทเอกสาร — RC กับ RCV คนละ counter

ป้องกัน race condition:

• ใช้ Postgres INSERT ... ON CONFLICT DO UPDATE RETURNING (atomic upsert) → 2 POS เปิดพร้อมกันไม่ได้เลขซ้ำกันเลย
• ตาราง DocumentSerial (tenantId + branchId + docType + year พ.ศ.) เก็บ counter ปัจจุบัน

12.1 เอกสารฝั่งขาย-รับซื้อ

12.2 เอกสารงานซ่อม (/repair-documents)

12.3 ใบเครมประกัน (/repair-warranty)

ทั้ง 2 ใบมี: warranty linkbox + days-remaining badge สี dynamic, ลายเซ็น 2-3 ฝ่าย, QC checklist 6 ข้อ (resolution mode)

12.4 สลิปเงินเดือน (Payslip)

📍 หน้า: /payroll (ปุ่ม 🖨️ "พิมพ์สลิปเงินเดือน" ในแถว + ในปุ่ม detail modal) 👤 สิทธิ์: OWNER, ADMIN, MANAGER 🎨 ธีม: cyan (ตรงกับสีแบรนด์ของแอป)

• Block: header → ข้อมูลพนักงาน → 2-col earnings/deductions → net pay box (สีฟ้าเข้ม + จำนวนเงินเป็นข้อความไทย เช่น "สามหมื่นห้าพันบาทถ้วน") → ลายเซ็น HR + พนักงาน
• รายการเพิ่ม/หัก ดึงจาก PayrollAdjustment (split อัตโนมัติด้วย isDeduction)
• รูปแบบ A4 — บนมือถือเลื่อนแนวนอนได้ (ScrollArea scrollbars="xy")
• Gate การพิมพ์: ปุ่มจะ disabled เมื่อ status = PENDING (ตัวเลขยังเปลี่ยนได้) — ต้องอนุมัติก่อนถึงพิมพ์ได้ (ดูรายละเอียดเพิ่มในหัวข้อ 10.4-10.5)

12.5 ใบสรุปการมาทำงานรายเดือน (Attendance Summary)

📍 หน้า: /attendance (ปุ่ม "ใบสรุปรายเดือน" ใน header) 👤 สิทธิ์: ADMIN, MANAGER

• เลือกพนักงาน + เดือน + ปี (พ.ศ.) → ดึง /attendance/report API → พิมพ์ A4 1 หน้า
• Block: header → KPI 5 cards (วันทำงาน/ชั่วโมง/มาสาย/เลิกก่อน/ขาด) → ตาราง 28-31 rows (1 row = 1 วัน) → ลายเซ็น 3 ฝ่าย (พนักงาน/หัวหน้า/HR)
• เสาร์-อาทิตย์มี bg เทา, สาย/ขาดแสดงสีแดง bold

12.6 ใบเบิก/รับเข้าอะไหล่ (Spare Part Movement)

📍 หน้า: /spare-parts → Modal "ประวัติการเคลื่อนไหว" (ปุ่มพิมพ์ในแต่ละ transaction row)

• Block: header → reference linkbox (issue: REP-xxx + customer + device + IMEI / receive: supplier + ผู้รับเข้า) → items table (1 row) → totals → reason note → inspection checklist 5 ข้อ (receive only) → ลายเซ็น 3 ฝ่าย

12.7 ใบลดหนี้ (Credit Note) — มาตรา 86/10

📍 เปิดได้ที่: เปิดอัตโนมัติหลังกด "ยืนยันคืนเงิน" ใน RefundWizard (§6.6)

สีธีม: แดง (#dc2626) — แสดงการคืนเงิน/เงินไหลออก ฐานทางกฎหมาย: มาตรา 86/10 แห่งประมวลรัษฎากร (ส่วนที่ 10 ใบกำกับภาษี ใบเพิ่มหนี้ ใบลดหนี้)

ใบลดหนี้ออกได้เมื่อ:

• ผู้ขายเป็น ผู้จดทะเบียน VAT (ถ้าสาขาไม่จด VAT — เอกสารใช้เป็นหลักฐานภายในร้านเท่านั้น ไม่มีผลทางภาษี)
• เคยออกใบกำกับภาษีไปแล้ว (มี receiptNumber อ้างอิง)
• เกิดเหตุการณ์ที่เป็นเหตุให้ ภาษีขายลดลง เช่น ลูกค้าคืนสินค้า / สินค้าชำรุด / ตกลงลดราคา

โครงสร้างเอกสาร (compliance ตามมาตรา 86/10):

1. คำว่า "ใบลดหนี้" — Banner ใหญ่สีแดง gradient + ระบุ "ออกตามมาตรา 86/10"
2. เลขที่ใบลดหนี้ (CN-xxxxxxxx) + วันที่ออก
3. อ้างอิงใบกำกับภาษีเดิม: เลขใบ + วันที่เดิม (กรอบแดงเด่น)
4. ผู้ออก (ผู้ขาย): ชื่อ + ที่อยู่ + เบอร์ + เลขประจำตัวผู้เสียภาษี (จาก branch.taxId, format X-XXXX-XXXXX-XX-X)
5. ผู้รับ (ผู้ซื้อ): ชื่อ + ที่อยู่ + เบอร์ + เลขประจำตัวผู้เสียภาษี (จาก customer.idCard 13 หลัก)
6. รายการที่ลดหนี้ — ตาราง: ชื่อสินค้า/IMEI + จำนวน + ราคา/หน่วย + รวม (ค่าลบ)
7. โครงสร้าง 3-cell บังคับ:
   • มูลค่าเดิม (ก่อนลด)
   • มูลค่าที่ถูกต้อง (หลังลด)
   • ผลต่าง (ยอดที่คืน)
8. VAT split (ถ้าสาขาจด VAT):
   • มูลค่าผลต่างก่อน VAT
   • VAT 7% ของผลต่าง (ใช้สูตร amount × rate / (100 + rate) สำหรับราคา VAT-inclusive)
   • ยอดเงินที่คืนรวม (กล่องแดงใหญ่เด่น)
9. วิธีคืนเงิน (เงินสด/โอน/เครดิตร้าน — pill เขียว)
10. เหตุผลในการออกใบลดหนี้ (กล่องเหลือง + ข้อความที่ user กรอกใน RefundWizard)
11. ลายเซ็น 2 ฝ่าย: ลูกค้า + ผู้รับคืนสินค้า (พร้อมช่องวันที่)
12. Legal note (เฉพาะ VAT-registered): "ผู้ซื้อต้องนำใบลดหนี้นี้ไปใช้ภายในเดือนที่ได้รับ" + "เก็บ 5 ปี (paper) / 10 ปี (electronic)"

12.8 Z Report (ปิดยอดสิ้นวัน)

📍 เปิดได้ที่: ปุ่ม "ปิดยอดวันนี้" มุมขวาบน /sales-history (§6.6)

สีธีม: ฟ้า (#0891b2) + กล่องเงินสดเขียว มาตรฐาน: Retail Z Report (ทั่วโลก) + Thai VAT compliance สำหรับ ภ.พ.30

โครงสร้างเอกสาร (เรียงลำดับการอ่าน):

1. Banner — "รายงานปิดยอดสิ้นวัน (Z Report)" + ชื่อร้าน + สาขา
2. Meta strip — เลขที่รายงาน Z-YYYYMMDD-{branchCode} + วันที่ (ภาษาไทย, พ.ศ.)
3. กล่องเงินสดในลิ้นชัก (คาดหมาย) — เด่นที่สุด เพราะนี่คือเหตุผลหลักของการปิดยอด:
   • ตัวเลขใหญ่ 32px สีเขียว
   • Breakdown: เงินสดเข้า − เงินสดคืน = ยอดคาดหมาย
   • Reminder: "นับเงินสดในลิ้นชักจริง แล้วเทียบกับตัวเลขนี้"
4. 3 KPI cards — บิลที่ใช้งาน / บิลยกเลิก / ครั้งที่คืนเงิน (พร้อมจำนวน + ยอด)
5. สรุปยอดเงิน — running total style:
   • ยอดขายรวม (รวม VAT)
   • − VAT รวมในราคา (ถ้าจด VAT)
   • − คืนเงินรวม (ถ้ามี)
   • = รายได้สุทธิ (กล่องฟ้าเด่น)
6. VAT compliance section (เฉพาะสาขาจด VAT) — สำหรับ ภ.พ.30 reconciliation:
   • มูลค่าก่อน VAT (taxable sales)
   • VAT ขาย (Output VAT)
   • − VAT ของยอดคืน (จากใบลดหนี้ในวันนั้น)
   • = VAT สุทธิที่ต้องนำส่ง (ตรงกับยอดที่ใส่ใน ภ.พ.30)
7. รายรับ — แยกตามวิธีชำระ — ตาราง: เงินสด/โอน/บัตร พร้อมจำนวนบิล + ยอด + subtotal
8. จ่ายออก — แยกตามวิธีคืนเงิน — ตาราง: เงินสด/โอน/เครดิตร้าน พร้อมจำนวนครั้ง + ยอด (สีส้ม)
9. ลายเซ็น 2 ฝ่าย: Cashier ผู้ปิดยอด + ผู้จัดการ/ผู้ตรวจสอบ
10. Footer note — "เก็บ 5 ปี (paper) / 10 ปี (electronic)"

Workflow ปิดร้านมาตรฐาน:

1. ก่อนปิดร้าน → กด "ปิดยอดวันนี้" บน /sales-history
2. ตรวจตัวเลขในระบบ (ทุกบิล/ยกเลิก/คืน) ว่าถูกต้อง
3. นับเงินสดจริงในลิ้นชัก
4. เทียบกับ "ยอดเงินสดในลิ้นชัก (คาดหมาย)" สีเขียว
5. ถ้าตรง → กดพิมพ์ → ลายเซ็น Cashier → เก็บเอกสาร
6. ถ้าไม่ตรง → ตรวจหาสาเหตุก่อนเลิกงาน (อาจมีบิลยังไม่ปิด, ใบ refund หาย, ฯลฯ)

12.9 รายงาน Export Excel (/reports)

นอกเหนือจากเอกสารพิมพ์ ระบบยัง export รายงานเป็น Excel ได้ 6 ประเภท:

• รายงานยอดขาย / การซ่อม / การรับซื้อ / สินค้าคงเหลือ / สรุปการเงิน / ภาษี VAT

💡 เคล็ดลับการพิมพ์

• ตั้งค่า browser ก่อนพิมพ์ครั้งแรก: Chrome/Edge → ปิด "Headers and footers" + เปิด "Background graphics" (เพื่อให้ accent color + กล่องสีพิมพ์ออก)
• Thermal printer 80mm (สำหรับ POS): ตั้ง paper size = "80mm × auto" + Margin = "None"
• A4 documents: ตั้ง paper size = A4, Margin = Default (ระบบมี @page margin: 12mm ในตัวเอง)
• PDF export: ทุกเอกสารกด "Save as PDF" ใน print dialog ได้

🏷️ White Label (ลบโลโก้ MobileHub) — Enterprise

📦 แพ็คเกจ: Enterprise เท่านั้น

ในแพ็คเกจ Enterprise ระบบจะ ลบเครื่องหมาย "MobileHub" / "AJ Software Dev." อัตโนมัติ จาก:

• Sidebar footer ("Powered by AJ Software Dev." → ซ่อน)
• ใบเสร็จขายสินค้า (POS) — A4 footer ลบ "เอกสารนี้พิมพ์โดยระบบ MobileHub POS"
• ใบรับซื้อโทรศัพท์ — footer เหลือแค่เลขเอกสาร (ลบ "พิมพ์โดยระบบ MobileHub")

→ เอกสารและหน้าจอทั้งหมดจะเหมือน "ระบบของร้านคุณเอง" ไม่มี branding ของ MobileHub ปรากฏให้ลูกค้าเห็น

13. Portal (Tenant Self-Service)

12.1 Support Tickets

📍 หน้า: /portal/tickets 👤 สิทธิ์: ทุก Role

วัตถุประสงค์: ยื่น Ticket เพื่อขอความช่วยเหลือหรือรายงานปัญหาไปยังทีมงาน MobileHub

ขั้นตอนสร้าง Ticket:

1. กดปุ่ม "+ สร้าง Ticket ใหม่"
2. กรอก:
   • หัวข้อ — สรุปปัญหาสั้นๆ
   • ประเภท — Bug Report, Feature Request, ขอความช่วยเหลือ
   • ระดับความสำคัญ — LOW, MEDIUM, HIGH, CRITICAL
   • รายละเอียด — อธิบายปัญหาอย่างละเอียด
3. กดปุ่ม "ส่ง Ticket"

สถานะ Ticket:

12.2 ประกาศ

📍 หน้า: /portal/announcements 👤 สิทธิ์: ทุก Role

วัตถุประสงค์: รับข่าวสารประกาศจากทีมงาน MobileHub — อัปเดต, การบำรุงรักษา, โปรโมชั่น

ฟีเจอร์:

• ดูประกาศล่าสุดจากทีมงาน
• กรองตามประเภทประกาศ
• ทำเครื่องหมายว่า "อ่านแล้ว"
• ประกาศสำคัญแสดงไฮไลท์สีแดง

12.3 Billing

📍 หน้า: /portal/billing 👤 สิทธิ์: OWNER, ADMIN

วัตถุประสงค์: ดูสถานะ Subscription ปัจจุบัน ประวัติการชำระเงิน ดาวน์โหลดใบเสร็จ

ข้อมูลที่แสดง:

• แพ็กเกจปัจจุบัน (Plan Name)
• วันหมดอายุ Subscription
• Storage ที่ใช้/ที่มี
• จำนวนผู้ใช้งาน/ที่อนุญาต
• ประวัติ Invoice และการชำระเงิน

ขั้นตอนชำระค่าบริการ:

1. คลิกที่ Invoice ที่ต้องการชำระ
2. เลือกวิธีชำระ
3. อัปโหลด Slip การโอนเงิน
4. ระบบส่งเรื่องให้ Admin ตรวจสอบ

สถานะการชำระ:

การแจ้งเตือน (real-time bell + Web Push):

เมื่อ admin ตรวจสลิปแล้ว — ระบบจะส่ง notification ไปที่ OWNER + ADMIN ของ tenant ทันที (Socket.IO real-time + Web Push ถ้า subscribe):

คลิก notification จาก bell → deep link ไป /portal/billing ดูสถานะใหม่ + เหตุผลปฏิเสธ (ถ้ามี)

OCR Auto-verify (admin ตั้งค่าได้ที่ /admin/settings → Slip Verify):

ถ้า admin เปิดโหมด ocr_auto ระบบจะส่งสลิปไป EasySlip API ตรวจอัตโนมัติ — ถ้า:

• ✓ amount ตรงกับ payment.amount + receiver account ตรง → APPROVED ทันที
• ✗ ไม่ตรง → status SLIP_UPLOADED + admin เห็นเหตุผลใน reviewNote เช่น OCR easyslip: amount_mismatch (slip ฿657.43 ≠ expected ฿1499) แล้วตัดสินใจ approve/reject เอง

12.4 อัปเกรดแพ็กเกจ

📍 หน้า: /portal/upgrade 👤 สิทธิ์: OWNER, ADMIN

วัตถุประสงค์: ดูและเปรียบเทียบแพ็กเกจ เลือกอัปเกรดหรือดาวน์เกรด

แพ็กเกจที่ให้บริการ:

14. การจัดการระบบ (Admin)

14.1 สาขา

📍 หน้า: /branches 👤 สิทธิ์: OWNER, ADMIN

วัตถุประสงค์: เพิ่ม แก้ไข จัดการสาขาของร้าน

ขั้นตอนเพิ่มสาขาใหม่:

1. กดปุ่ม "+ เพิ่มสาขา"
2. กรอกข้อมูล:

1. กดปุ่ม "บันทึก"

14.2 ผู้ใช้งาน

📍 หน้า: /users 👤 สิทธิ์: OWNER, ADMIN

วัตถุประสงค์: เพิ่ม แก้ไข จัดการบัญชีผู้ใช้งานและกำหนด Role

ขั้นตอนเพิ่มผู้ใช้ใหม่:

1. กดปุ่ม "+ เพิ่มผู้ใช้"
2. กรอกข้อมูล:

1. ระบบสร้าง QR Code สำหรับลงเวลาอัตโนมัติ

การจัดการ Role:

• แต่ละ User มีได้หลาย Role (MultiSelect)
• ตัวอย่าง: พนักงานคนหนึ่งอาจมีทั้ง SALES และ TECHNICIAN (= SALESTECH)

QR Code พนักงาน:

• ระบบสร้าง QR Code unique ให้ทุก User
• กดปุ่ม "ดู QR" หรือ "พิมพ์ QR"
• ใช้สำหรับสแกนลงเวลาที่ Kiosk

เปิด/ปิดบัญชี:

• Toggle Switch เพื่อปิดใช้งานชั่วคราว
• ผู้ใช้ที่ปิดใช้งานจะ Login ไม่ได้

14.3 ข้อมูลหลัก (Master Data)

📍 หน้า: /masters 👤 สิทธิ์: OWNER, ADMIN, MANAGER

วัตถุประสงค์: จัดการข้อมูลอ้างอิงที่ใช้ทั่วทั้งระบบ เช่น ยี่ห้อ รุ่น สี ประเภทการซ่อม ฯลฯ

รายการ Master Data:

ขั้นตอนเพิ่ม Master Data:

1. คลิกที่ Card ของ Master Data ที่ต้องการ
2. กดปุ่ม "+ เพิ่ม"
3. กรอกชื่อและรายละเอียด
4. กดปุ่ม "บันทึก"

14.4 ตั้งค่า

📍 หน้า: /settings 👤 สิทธิ์: OWNER, ADMIN

วัตถุประสงค์: ตั้งค่าข้อมูลร้านค้า, เป้าหมายยอดขาย, PromptPay, VAT

ส่วนที่ตั้งค่าได้:

14.5 Audit Log

📍 หน้า: /audit-logs 👤 สิทธิ์: OWNER, ADMIN

วัตถุประสงค์: ดูบันทึกกิจกรรมทั้งหมดในระบบ — ใครทำอะไร เมื่อไหร่

ข้อมูลที่บันทึก:

การใช้งาน:

• กรองตามผู้ใช้, การกระทำ, โมดูล
• ค้นหาด้วย keyword
• Export เป็น CSV ได้

15. การแจ้งเตือน

📍 ไอคอน: Bell 🔔 ด้านบนขวาของหน้าจอ 👤 สิทธิ์: ทุก Role

วัตถุประสงค์: รับการแจ้งเตือนแบบ Real-time สำหรับเหตุการณ์สำคัญในระบบ

ประเภทการแจ้งเตือน:

วิธีใช้งาน:

1. คลิกไอคอน Bell มุมบนขวา (Bell ringing 🔔 เมื่อมี unread)
2. ดูรายการแจ้งเตือน — items ยังไม่อ่านมี เส้นขอบซ้ายสีฟ้า + ตัวหนา
3. คลิกแต่ละรายการ → mark-as-read + navigate ไปหน้าที่เกี่ยวข้อง (เช่น คลิก "ประกาศใหม่" → ไปหน้า /portal/announcements)
4. Header actions (3 ปุ่มมุมขวาบนของ dropdown):
   • ✓ อ่านทั้งหมด — mark-as-read ทุก unread (แสดงเฉพาะตอนมี unread)
   • 🗑 ลบที่อ่านแล้ว — ลบเฉพาะ items ที่ isRead=true (แสดงเมื่อมี read item)
   • ↻ รีเฟรช — โหลด list + count ใหม่จาก server
5. Per-item × delete — กดเครื่องหมาย × ที่ขวาสุดของแต่ละ item → ลบทันที (กัน accidentally — มี stopPropagation ไม่ให้ navigate)
6. Items ที่อ่านแล้วแสดง stamp "✓ อ่านแล้ว" สีเทาที่แถวเวลา

15.1 แจ้งเตือนทันที แม้ปิดเว็บอยู่ (Push Notifications)

📍 เปิดได้ที่: Banner ที่ Dashboard (ครั้งแรก) หรือหน้า Profile → การแจ้งเตือน Push 👤 สิทธิ์: ทุกแพ็คเกจ STARTER+ (รวมทั้ง Super Admin)

วัตถุประสงค์: รับแจ้งเตือนเหตุการณ์สำคัญทันที แม้ปิดแท็บหรือปิดเบราว์เซอร์อยู่ — เด้งเหมือน notification ของ LINE/Facebook

อุปกรณ์ที่รองรับ:

• ✅ Desktop — Chrome / Edge / Firefox / Safari (Mac)
• ✅ Android — Chrome / Edge / Firefox
• ✅ iPhone / iPad — Safari 16.4 ขึ้นไป แต่ต้องติดตั้งเป็นแอป (Add to Home Screen) ก่อน

วิธีเปิดใช้งาน:

1. เข้า Dashboard ครั้งแรก → จะเห็น Banner สีฟ้า ด้านบนพร้อมไอคอนระฆัง
2. คลิกปุ่ม "เปิดการแจ้งเตือน"
3. เบราว์เซอร์ขึ้นถาม "Allow notifications?" → กด Allow
4. เสร็จ — ทดลองได้โดยปิดแท็บแล้วให้เพื่อนสร้างงานซ่อมใหม่ (จะเด้งบนเครื่องคุณ)

สำหรับ iPhone / iPad:

1. เปิดเว็บใน Safari → กดปุ่ม Share (ลูกศรขึ้น)
2. เลื่อนหา "Add to Home Screen" → กด Add
3. เปิดแอปจากไอคอนบน Home Screen (ไม่ใช่จาก Safari)
4. Login → เปิด Push Notifications ตามขั้นตอนปกติ

เปิด-ปิดเองได้ตลอดเวลา:

ไปที่หน้า Profile → การ์ด "การแจ้งเตือน Push" → เลื่อน Switch เปิด/ปิด

กรณี blocked:

ถ้าเผลอกด "Block" → คลิกไอคอน 🔒 ข้างซ้ายของ URL ในเบราว์เซอร์ → การตั้งค่าไซต์ → การแจ้งเตือน → Allow → รีเฟรชหน้า

Multi-device:

Login จาก 3 เครื่อง (เช่น Desktop ที่ร้าน + มือถือคุณ + แท็บเล็ตช่าง) แล้วเปิด Push ทั้ง 3 เครื่อง — ระบบจะส่งแจ้งเตือนทุกเครื่องพร้อมกัน

15.2 ติดตั้งเป็นแอป (PWA Install)

📍 เปิดได้ที่: Banner สีฟ้าด้านล่างจอใน Dashboard (เด้งเองตอน browser พร้อม) หรือเมนู "ติดตั้งแอป" ใน Chrome 👤 สิทธิ์: ทุก Role

วัตถุประสงค์: ติดตั้ง MobileHub เป็นแอปบน Home Screen / Desktop เพื่อให้:

• เปิดเร็วเหมือนแอปจริง (ไม่ต้องเปิดเบราว์เซอร์)
• มีไอคอนแยกบนหน้าจอ
• รับ Push Notifications ได้แม้ปิดเว็บ
• ใช้ Shortcut ลัดเข้าฟีเจอร์หลัก (POS / รับเครื่อง / งานช่าง / ติดตามซ่อม)

Banner ที่เด้งเอง — Chrome / Edge / Android:

หลังเปิด Dashboard ใช้งาน 2-3 นาที จะเห็น Paper สีฟ้า fixed ด้านล่างจอ ประกอบด้วย:

• ไอคอนระบบ (gradient ฟ้า-เขียว) + หัวข้อ "ติดตั้งเป็นแอป"
• คำอธิบาย: "ติดตั้ง MobileHub บนมือถือ เปิดเร็วเหมือนแอป และรับการแจ้งเตือน"
• ปุ่ม "ติดตั้งเลย" — เปิด install dialog ของเบราว์เซอร์ → ยืนยัน → ติดตั้งทันที
• ปุ่ม "ไว้ก่อน" หรือ × ปิด — ซ่อน Banner 24 ชั่วโมง (วันถัดไปเด้งใหม่)

iPhone / iPad — ติดตั้งผ่าน Safari:

ปุ่ม "ติดตั้งเลย" จะเปลี่ยนเป็น "ดูวิธีติดตั้ง" เมื่อตรวจพบว่าเปิดผ่าน Safari → กดเพื่อเปิด Modal คำแนะนำ 3 ขั้นตอน:

1. กดปุ่ม Share ที่แถบล่างของ Safari (รูปสี่เหลี่ยม + ลูกศรชี้ขึ้น)
2. เลื่อนหา "Add to Home Screen" → กด Add
3. กด "เพิ่ม" ที่มุมขวาบน → ไอคอน MobileHub ปรากฏบนหน้าโฮม

Shortcuts บน Home Screen (Android / iOS):

หลังติดตั้งแล้ว — กดค้างที่ไอคอน MobileHub บน Home Screen → จะเห็น 4 ทางลัด:

• 🛒 POS → เปิด /sales ขายสินค้าทันที
• 🔧 รับซ่อม → เปิด /repair-intake รับเครื่อง
• 🔨 งานช่าง → เปิด /technician-repairs ดูงานที่มอบหมาย
• 📋 ติดตาม → เปิด /track ค้นหาสถานะใบรับซ่อม

ตอนติดตั้งแล้ว:

• เปิดจากไอคอนบน Home Screen → จะเห็นเป็นแอปเต็มจอ (ไม่มี URL bar)
• Banner ติดตั้งจะหยุดเด้งอัตโนมัติ (ตรวจจาก display-mode: standalone)
• iOS user ต้องเปิดจากไอคอนแอป (ไม่ใช่ Safari) ถึงจะรับ Push Notifications ได้

ถอนการติดตั้ง:

• Android / Desktop Chrome / Edge — กดค้างที่ไอคอน → "Uninstall app" / "Remove from Chrome"
• iOS — กดค้างที่ไอคอน → "Remove App" → "Delete App"

16. Multi-Tenant และ Multi-Branch

16.1 Tenant Isolation

MobileHub ใช้สถาปัตยกรรม Multi-Tenant SaaS ที่ข้อมูลของแต่ละร้านถูกแยกกันอย่างสมบูรณ์ (Tenant Isolation)

หลักการสำคัญ:

• ข้อมูลทุกประเภทมี tenantId กำกับ
• ผู้ใช้งานไม่สามารถเข้าถึงข้อมูลของ Tenant อื่นได้
• Unique Constraint เป็นแบบ Compound: เช่น (tenantId, username) ไม่ใช่แค่ username
• JWT Token บรรจุ tenantId เพื่อตรวจสอบทุก Request

สิ่งที่แยกกันตาม Tenant:

• ลูกค้า, สินค้า, การขาย, งานซ่อม, อะไหล่
• ผู้ใช้งาน, สาขา
• Master Data (ยี่ห้อ, รุ่น, สี ฯลฯ)
• ตั้งค่าร้าน, Subscription

16.2 Branch Selector

ตำแหน่ง: Header ด้านบนของหน้า (ทุกหน้า)

วัตถุประสงค์: เลือกสาขาที่ต้องการดูข้อมูล

วิธีใช้:

1. คลิก Dropdown Branch ด้านบน
2. เลือกสาขาที่ต้องการ — หรือเลือก "ทุกสาขา" (📦 Pro+) เพื่อดู aggregate
3. ข้อมูลทั่วทั้งระบบกรองตามสาขาที่เลือกอัตโนมัติ

option "ทุกสาขา" (Multi-Branch Dashboard) — Pro+:

📦 แพ็คเกจ: Professional หรือ Enterprise

• เงื่อนไขแสดง option นี้: ต้องมีฟีเจอร์ MULTI_BRANCH_DASHBOARD และ มีสาขา ≥ 2 (สาขาเดียวจะไม่เห็นเพราะ redundant)
• มี badge "รวม" สีฟ้าเพื่อแยกออกจากสาขาทั่วไป
• เมื่อเลือก "ทุกสาขา" → Dashboard / Reports / etc. แสดงข้อมูลรวมของ tenant ทั้งหมด

หมายเหตุ:

• OWNER/ADMIN เห็นทุกสาขา
• พนักงานทั่วไปเห็นเฉพาะสาขาที่ตัวเองสังกัด
• บางรายงานสามารถ "รวมทุกสาขา" ได้

17. ภาคผนวก

17.1 API Endpoints หลัก

Prefix: /api/v1

17.2 Tech Stack

17.3 Deployment

Docker Compose

ไฟล์: docker-compose.yml (root)

# Start production
docker-compose up -d

# View logs
docker-compose logs -f

Services:

• backend — Fastify API (port 3001)
• frontend — Next.js App (port 3000)
• postgres — PostgreSQL Database
• nginx — Reverse Proxy (port 80/443)

PM2 (Node.js Process Manager)

# Backend
cd backend
pm2 start ecosystem.config.js

# Frontend
cd frontend
pm2 start ecosystem.config.js

Config:

• backend/ecosystem.config.js — Cluster mode
• frontend/ecosystem.config.js — Cluster mode

Environment Variables

Backend (backend/.env):

DATABASE_URL=postgresql://...
JWT_SECRET=your-secret-key
PORT=3001
ALLOWED_ORIGINS=https://mobilehub.ajsoftwaredev.com
UPLOAD_DIR=/app/uploads

Frontend (.env.production):

NEXT_PUBLIC_API_URL=https://api.mobilehub.ajsoftwaredev.com
NEXT_PUBLIC_SOCKET_URL=wss://api.mobilehub.ajsoftwaredev.com

17.4 Backup & Restore

สร้าง Backup

ผ่าน Command Line (สำหรับผู้ดูแลระบบที่มีสิทธิ์ SSH):

cd /opt/mobilehub
bash scripts/backup.sh

Restore จาก Backup

# Decrypt backup
openssl enc -d -aes-256-cbc -in backup.sql.gz.enc -out backup.sql.gz

# Decompress
gunzip backup.sql.gz

# Restore to PostgreSQL
psql -U mobilehub -d mobilehub_db < backup.sql

17.5 Security Rules (สรุปสำหรับผู้ดูแล)

17.6 การแก้ปัญหาเบื้องต้น

คู่มือนี้จัดทำสำหรับ MobileHub v2 เวอร์ชัน 2.0 อัปเดตล่าสุด: 27 เมษายน 2569 สอบถามเพิ่มเติม: support@mobilehub.ajsoftwaredev.com