# Tài liệu API Driver App

Tài liệu này mô tả các API mới dành cho ứng dụng Lái xe (Driver App), được chia thành các Controller chuyên biệt.

## 1. DriverDashboardController
Cung cấp các API liên quan đến màn hình Dashboard.

- **Endpoint:** `GET /api/DriverDashboard/GetDashboard`
- **Quyền:** `DriverApp.GetDashboard`
- **Mô tả:** Lấy thông tin tổng quan cho Dashboard (Đơn hàng chờ, đang giao, hoàn thành,...).

## 2. DriverOrderController
Cung cấp các API truy vấn thông tin đơn hàng.

- **Endpoint:** `POST /api/DriverOrder/SearchOrders`
- **Quyền:** `DriverApp.SearchOrders`
- **Mô tả:** Tìm kiếm danh sách đơn hàng của lái xe (có phân trang).
- **Endpoint:** `GET /api/DriverOrder/GetOrder/{id}`
- **Quyền:** `DriverApp.GetOrder`
- **Mô tả:** Lấy thông tin chi tiết một đơn hàng.

## 3. DriverOrderOpsController
Cung cấp các API thao tác nghiệp vụ trên đơn hàng.

- **Endpoint:** `POST /api/DriverOrderOps/Pickup`
- **Quyền:** `DriverApp.Pickup`
- **Mô tả:** Cập nhật trạng thái lấy hàng thành công.
- **Endpoint:** `POST /api/DriverOrderOps/PickupFail`
- **Quyền:** `DriverApp.PickupFail`
- **Mô tả:** Cập nhật trạng thái lấy hàng thất bại.
- **Endpoint:** `POST /api/DriverOrderOps/Delivery`
- **Quyền:** `DriverApp.Delivery`
- **Mô tả:** Cập nhật trạng thái giao hàng thành công.
- **Endpoint:** `POST /api/DriverOrderOps/DeliveryFail`
- **Quyền:** `DriverApp.DeliveryFail`
- **Mô tả:** Cập nhật trạng thái giao hàng thất bại.

## 4. DriverFinanceController
Cung cấp các API liên quan đến tài chính của lái xe.

- **Endpoint:** `GET /api/DriverFinance/GetFinancialInfo`
- **Quyền:** `DriverApp.GetFinancialInfo`
- **Mô tả:** Lấy thông tin tài chính cá nhân (số dư ví, thu nhập).
- **Endpoint:** `POST /api/DriverFinance/SearchFinancialOrders`
- **Quyền:** `DriverApp.SearchFinancialOrders`
- **Mô tả:** Tìm kiếm danh sách đơn hàng liên quan đến tài chính.

## 5. DriverProfileController
Cung cấp các API quản lý tài khoản, hồ sơ và chấm công.

- **Endpoint:** `POST /api/DriverProfile/Login`
- **Quyền:** Không yêu cầu (AllowAnonymous)
- **Mô tả:** Đăng nhập ứng dụng.
- **Endpoint:** `POST /api/DriverProfile/ChangePassword`
- **Quyền:** Yêu cầu đăng nhập
- **Mô tả:** Đổi mật khẩu.
- **Endpoint:** `GET /api/DriverProfile/Renewal`
- **Quyền:** Yêu cầu đăng nhập
- **Mô tả:** Gia hạn phiên đăng nhập (Token).
- **Endpoint:** `POST /api/DriverProfile/UpdateProfile`
- **Quyền:** Yêu cầu đăng nhập
- **Mô tả:** Cập nhật thông tin hồ sơ lái xe.
- **Endpoint:** `POST /api/DriverProfile/Attendance`
- **Quyền:** Yêu cầu đăng nhập
- **Mô tả:** Thực hiện chấm công (Check-in/Check-out).
- **Endpoint:** `POST /api/DriverProfile/Payroll`
- **Quyền:** Yêu cầu đăng nhập
- **Mô tả:** Xem bảng công/bảng lương (dựa trên năng suất).
