Skip to main content

บทนำ (ผู้ดูแลระบบ)

เอกสารชุดนี้อธิบายการใช้งานฝั่ง Admin จากโค้ดจริงของระบบ ATP30 โดยยึด route, menu, guard, permission, และ data flow ที่พบใน implementation ปัจจุบัน

วัตถุประสงค์ของเอกสาร​

  • ทำให้ผู้ดูแลระบบเห็นภาพรวมของเมนูหลักและลำดับการทำงานจริง
  • อธิบายว่าข้อมูลจากฝั่งปฏิบัติการไหลไปสู่ billing และ reports อย่างไร
  • ใช้เป็นคู่มือสำหรับอ่านระบบจากมุมของผู้ใช้งานและผู้ดูแลระบบพร้อมกัน

ขอบเขตของคู่มือ Admin​

คู่มือนี้อ้างอิงจากโครงเมนูจริงที่ประกอบใน atp30-tos-frontend/src/menu-items/index.ts และ route ที่เปิดใช้งานจริงใน atp30-tos-frontend/src/routes/*.tsx

กลุ่มเมนูหลักที่มีจริงในระบบ:

  1. Operations
  2. Billing
  3. Reports
  4. Setting

โมดูลที่ผู้ดูแลระบบต้องเข้าใจ​

1. Dashboard​

  • ใช้ดูสรุปจำนวนลูกค้า รถ ผู้ใช้งาน เที่ยวรถ รายได้วางบิล รายได้รถร่วม รายได้นักขับ และ X-Ratio
  • เป็นหน้าแรกหลังเข้าสู่ระบบผ่าน /home

2. Operations​

  • ครอบคลุม oil-price, trip-record, trip-history, refuel, vehicle-record, standby-task, histories
  • ใช้บันทึก ตรวจสอบ และอนุมัติข้อมูลที่เกี่ยวกับการเดินรถจริง

3. Billing​

  • ครอบคลุม customer-invoice, contract-invoice, driver-income
  • ใช้ตรวจยอด ออกเอกสาร และตรวจผลลัพธ์ของข้อมูลที่ backend คำนวณแล้ว

4. Reports​

  • ครอบคลุม income-report, trip-report, contract-invoice-report, y-ratio-report
  • ใช้สรุปตัวเลขเชิงบริหารและ export ข้อมูล

5. Setting / Master Data​

  • ครอบคลุม customers, vehicles, users, areas, contract-bus-companies, vehicle-types, roles, fuel-cards, holidays
  • ใช้ตั้งค่าข้อมูลหลักที่หน้า operations, contract, billing และ report ต้องอ้างอิงร่วมกัน

6. Contract Management​

  • อยู่ภายใต้หน้ารายละเอียดลูกค้า
  • ใช้สร้างสัญญาแบบ step-by-step และกำหนด logic ที่มีผลต่อการวางบิลและรายได้

กลุ่มผู้ใช้งานที่เกี่ยวข้อง​

  • Admin / Backoffice ใช้จัดการข้อมูลหลัก สิทธิ์ และเอกสารทางธุรกิจ
  • Operation ใช้ตรวจสอบข้อมูลเที่ยวรถ งาน standby และข้อมูลเติมน้ำมัน/ชาร์จไฟ
  • Driver ใช้งานผ่านระบบ driver แยกอีก repo หนึ่ง และส่งข้อมูลกลับมาเป็นฐานคำนวณ

สิ่งที่ควรอ่านต่อ​

  1. อ่าน ภาพรวมระบบ เพื่อดู shell, route, menu, และ data flow
  2. อ่าน การจัดการพื้นฐานและการเข้าใช้งาน เพื่อเข้าใจ login, menu, และ permission
  3. อ่าน การจัดการสัญญา เพื่อเข้าใจ logic หลักก่อนลงงาน billing
  4. อ่าน สเปคการคำนวณใบวางบิล เมื่อจะตรวจสูตรและยอด

อ้างอิงโค้ด​

  • atp30-tos-frontend/src/menu-items/index.ts
  • atp30-tos-frontend/src/menu-items/dashboard.ts
  • atp30-tos-frontend/src/menu-items/billing.ts
  • atp30-tos-frontend/src/menu-items/reports.ts
  • atp30-tos-frontend/src/menu-items/settings.ts
  • atp30-tos-frontend/src/routes/*.tsx