รายงานจำนวนเที่ยววิ่ง

ภาพ: หน้ารายงานจำนวนเที่ยววิ่ง

เมนู "รายงานจำนวนเที่ยววิ่ง" ใช้สรุปจำนวนเที่ยวรถในช่วงวันที่ที่เลือก และสามารถกรองตามลูกค้า, ประเภทรถ และพื้นที่ทำงานได้

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

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

• startDate
• endDate

และมี validation เพิ่มว่า

• endDate ต้องมากกว่าหรือเท่ากับ startDate

ตัวกรองหลัก

1. วันที่เริ่มต้นรายงาน
2. วันที่สิ้นสุดรายงาน
3. รหัสลูกค้า
4. ประเภทรถ
5. พื้นที่ทำงาน

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

หน้า report ใช้ GET /trip-records/trip-report และส่ง query ดังนี้

• startDate
• endDate
• customerId
• vehicleTypeId
• workAreaId
• page
• pageSize

การใช้งาน

1. ระบุช่วงวันที่
2. เลือกตัวกรองอื่นเพิ่มเติมตามต้องการ
3. กด แสดงรายงาน
4. ตรวจสอบข้อมูลในตาราง
5. กด Export Excel เพื่อดาวน์โหลดรายงาน

:::warning ข้อควรระวัง วันสิ้นสุดต้องมากกว่าหรือเท่ากับวันเริ่มต้น :::

การ Export Excel

ปุ่ม export ใช้ endpoint

• GET /trip-records/trip-report/export

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

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

info

ฟิลด์ ประเภทรถ และ พื้นที่ทำงาน แม้ในเอกสารธุรกิจมักใช้เป็นตัวกรองเสริม แต่ในหน้า UI จริงมี field แยกไว้ชัดเจนและส่งเป็น vehicleTypeId กับ workAreaId จึงควรเลือกค่าให้ตรงกับสิ่งที่ต้องการสรุป

อ้างอิงโค้ด

• atp30-tos-frontend/src/views/pages/trip-report/index.tsx
• atp30-tos-frontend/src/api/trip-report.ts