รายงานแสดงรายได้

ภาพ: หน้ารายงานแสดงรายได้

เมนู รายงานแสดงรายได้ ใช้สำหรับสรุปรายได้ของพนักงานขับรถในระดับรายงาน ต่างจากหน้า รายได้นักขับ ตรงที่หน้านี้เรียกข้อมูลด้วย groupKey=report เพื่อทำมุมมองสำหรับการตรวจสอบและ export รายงานโดยเฉพาะ

ข้อมูลบังคับของหน้า

จาก schema จริง หน้า report บังคับอย่างน้อย

• month

และมีตัวกรองเสริมอีก 1 ชั้นผ่านฟิลด์ condition

• ถ้าเลือก vehicle ต้องเลือกรหัสรถ
• ถ้าเลือก customer ต้องเลือกรหัสลูกค้า
• ถ้าเลือก area ต้องเลือกพื้นที่ทำงาน

ตัวกรองที่รองรับ

1. เดือน
2. เงื่อนไขการกรองเพิ่มเติม
   • รหัสรถ
   • รหัสลูกค้า
   • พื้นที่ทำงาน

ระบบดึงข้อมูลอย่างไร

หน้า report ใช้ hook useDriverIncomesQuery และยิง GET /trip-records/driver-income พร้อม groupKey=report

query ที่ส่งขึ้นจริงคือ

• month
• vehicleId
• customerId
• workAreaId
• page
• pageSize

วิธีใช้งาน

1. เลือกเดือนที่ต้องการ
2. ถ้าต้องการกรองเพิ่มเติม ให้เลือก condition
3. กรอกค่าตัวกรองตาม condition ที่เลือก
4. กด แสดงรายงาน
5. ตรวจสอบผลลัพธ์ในตาราง
6. กด Export Excel เมื่อต้องการดาวน์โหลด

:::info หมายเหตุ หากรอบรายได้ยังมีรายการที่รออนุมัติ ระบบอาจแสดงสถานะว่าข้อมูลยังอยู่ระหว่างประมวลผล ควรตรวจสอบการอนุมัติเที่ยวรถและงาน Standby ให้ครบก่อน :::

การ Export Excel

ปุ่ม export ใช้ endpoint

• GET /trip-records/driver-income/export?groupKey=report&month=...

โดยส่ง filter ชุดเดียวกับที่ใช้ในหน้ารายงาน

จุดที่ต้องระวัง

warning

• ถ้าเลือก condition แล้วไม่กรอกค่าที่เกี่ยวข้อง หน้า form จะไม่ผ่าน validation
• หน้านี้ใช้ endpoint เดียวกับ รายได้นักขับ แต่เปลี่ยน groupKey เป็น report
• ถ้าต้องการ drill down รายคน ให้ไปที่หน้า รายได้นักขับ ไม่ใช่หน้านี้

อ้างอิงโค้ด

• atp30-tos-frontend/src/views/pages/income-report/index.tsx
• atp30-tos-frontend/src/hooks/useDriverIncome.ts
• atp30-tos-frontend/src/api/driver-incomes.ts