Add order tail flows and migrate queue, message, settlement, and audit modules.

Wire deposit orders, historical shooting, and multi-travel uploads into Orders, and replace home placeholders for queue management, message center, scenic settlement, and withdrawal audit.

Co-authored-by: Cursor <cursoragent@cursor.com>

suixinkan/Features/Orders/API/OrdersAPI.swift

@@ -32,6 +32,30 @@ protocol OrderServing {
 
     /// 获取门店订单详情。
     func storeOrderDetail(storeId: Int, orderNumber: String) async throws -> StoreOrderDetailResponse
+
+    /// 获取押金订单列表。
+    func depositOrderList(scenicId: Int, page: Int, pageSize: Int) async throws -> ListPayload<DepositOrderListItem>
+
+    /// 核销押金订单。
+    func depositOrderWriteOff(orderNumber: String) async throws
+
+    /// 申请押金订单退款。
+    func depositOrderRefund(orderNumber: String, refundReason: String) async throws
+
+    /// 获取订单某个拍摄点的底片、成片和评价信息。
+    func storeOrderShootingDetail(storeId: Int, orderNumber: String, scenicSpotId: Int, photogUid: Int) async throws -> StoreOrderShootingDetailResponse
+
+    /// 申请普通订单退款。
+    func orderRefund(orderNumber: String, refundType: OrderRefundMode, refundAmount: String, refundReason: String) async throws
+
+    /// 获取订单历史拍摄信息。
+    func multiTravelShootHistory(orderNumber: String) async throws -> MultiTravelShootHistoryResponse
+
+    /// 获取多点旅拍订单已核销打卡点列表。
+    func multiTravelVerifiedScenicSpotList(orderNumber: String) async throws -> [MultiTravelVerifiedScenicSpotItem]
+
+    /// 提交多点旅拍任务素材。
+    func multiTravelUploadMaterial(_ request: MultiTravelUploadMaterialRequest) async throws
 }
 
 @MainActor
@@ -131,4 +155,106 @@ final class OrdersAPI: OrderServing {
             )
         )
     }
+
+    /// 获取押金订单列表。
+    func depositOrderList(scenicId: Int, page: Int = 1, pageSize: Int = 10) async throws -> ListPayload<DepositOrderListItem> {
+        try await client.send(
+            APIRequest(
+                method: .get,
+                path: "/api/yf-handset-app/photog/order/deposit-list",
+                queryItems: [
+                    URLQueryItem(name: "scenic_id", value: "\(scenicId)"),
+                    URLQueryItem(name: "page", value: "\(max(page, 1))"),
+                    URLQueryItem(name: "page_size", value: "\(max(pageSize, 1))")
+                ]
+            )
+        )
+    }
+
+    /// 核销押金订单。
+    func depositOrderWriteOff(orderNumber: String) async throws {
+        let _: EmptyPayload = try await client.send(
+            APIRequest(
+                method: .post,
+                path: "/api/yf-handset-app/photog/order/deposit-writeoff",
+                body: DepositOrderWriteOffRequest(orderNumber: orderNumber)
+            )
+        )
+    }
+
+    /// 申请押金订单退款。
+    func depositOrderRefund(orderNumber: String, refundReason: String) async throws {
+        let _: EmptyPayload = try await client.send(
+            APIRequest(
+                method: .post,
+                path: "/api/yf-handset-app/photog/order/deposit-refund",
+                body: DepositOrderRefundRequest(orderNumber: orderNumber, refundReason: refundReason)
+            )
+        )
+    }
+
+    /// 获取订单某个拍摄点的底片、成片和评价信息。
+    func storeOrderShootingDetail(storeId: Int, orderNumber: String, scenicSpotId: Int, photogUid: Int) async throws -> StoreOrderShootingDetailResponse {
+        try await client.send(
+            APIRequest(
+                method: .get,
+                path: "/api/app/store/order/shooting-detail",
+                queryItems: [
+                    URLQueryItem(name: "store_id", value: "\(storeId)"),
+                    URLQueryItem(name: "order_number", value: orderNumber),
+                    URLQueryItem(name: "scenic_spot_id", value: "\(scenicSpotId)"),
+                    URLQueryItem(name: "photog_uid", value: "\(photogUid)")
+                ]
+            )
+        )
+    }
+
+    /// 申请普通订单退款。
+    func orderRefund(orderNumber: String, refundType: OrderRefundMode, refundAmount: String, refundReason: String) async throws {
+        let _: EmptyPayload = try await client.send(
+            APIRequest(
+                method: .post,
+                path: "/api/yf-handset-app/photog/order/refund",
+                body: OrderRefundRequest(
+                    orderNumber: orderNumber,
+                    refundType: refundType.rawValue,
+                    refundAmount: refundAmount,
+                    refundReason: refundReason
+                )
+            )
+        )
+    }
+
+    /// 获取订单历史拍摄信息。
+    func multiTravelShootHistory(orderNumber: String) async throws -> MultiTravelShootHistoryResponse {
+        try await client.send(
+            APIRequest(
+                method: .get,
+                path: "/api/yf-handset-app/photog/order/multi-travel/shoot-history",
+                queryItems: [URLQueryItem(name: "order_number", value: orderNumber)]
+            )
+        )
+    }
+
+    /// 获取多点旅拍订单已核销打卡点列表。
+    func multiTravelVerifiedScenicSpotList(orderNumber: String) async throws -> [MultiTravelVerifiedScenicSpotItem] {
+        try await client.send(
+            APIRequest(
+                method: .get,
+                path: "/api/yf-handset-app/photog/order/multi-travel/verified-scenic-spot-list",
+                queryItems: [URLQueryItem(name: "order_number", value: orderNumber)]
+            )
+        )
+    }
+
+    /// 提交多点旅拍任务素材。
+    func multiTravelUploadMaterial(_ request: MultiTravelUploadMaterialRequest) async throws {
+        let _: EmptyPayload = try await client.send(
+            APIRequest(
+                method: .post,
+                path: "/api/yf-handset-app/photog/order/multi-travel/upload-material",
+                body: request
+            )
+        )
+    }
 }