Sync migrated iOS modules

2026-06-22 15:35:12 +08:00
parent ace9c94359
commit 484566d27e
48 changed files with 4455 additions and 15 deletions
--- a/suixinkan/Features/Orders/API/OrdersAPI.swift
+++ b/suixinkan/Features/Orders/API/OrdersAPI.swift
@ -0,0 +1,112 @@
+//
+//  OrdersAPI.swift
+//  suixinkan
+//
+//  Created by Codex on 2026/6/22.
+//
+
+import Foundation
+import Observation
+
+@MainActor
+/// 订单服务协议，抽象订单列表、核销列表和核销操作以便测试替换。
+protocol OrderServing {
+    /// 获取订单管理列表。
+    func orderList(
+        scenicId: Int,
+        page: Int,
+        pageSize: Int,
+        orderStatus: Int?,
+        userPhone: String?,
+        startTime: String?,
+        endTime: String?,
+        isRefined: Int?,
+        isScenicAdmin: Bool
+    ) async throws -> ListPayload<OrderEntity>
+
+    /// 获取核销订单列表。
+    func writeOffList(scenicId: Int, page: Int, pageSize: Int) async throws -> ListPayload<WriteOffOrderItem>
+
+    /// 核销指定订单号。
+    func writeOff(orderNumber: String) async throws
+}
+
+@MainActor
+@Observable
+/// 订单 API，封装订单管理、核销订单和订单核销接口。
+final class OrdersAPI: OrderServing {
+    @ObservationIgnored private let client: APIClient
+
+    /// 初始化订单 API，并注入共享网络客户端。
+    init(client: APIClient) {
+        self.client = client
+    }
+
+    /// 获取订单管理列表。
+    func orderList(
+        scenicId: Int,
+        page: Int = 1,
+        pageSize: Int = 20,
+        orderStatus: Int? = nil,
+        userPhone: String? = nil,
+        startTime: String? = nil,
+        endTime: String? = nil,
+        isRefined: Int? = nil,
+        isScenicAdmin: Bool = false
+    ) async throws -> ListPayload<OrderEntity> {
+        var query = [
+            URLQueryItem(name: "scenic_id", value: "\(scenicId)"),
+            URLQueryItem(name: "page", value: "\(max(page, 1))"),
+            URLQueryItem(name: "page_size", value: "\(max(pageSize, 1))")
+        ]
+        if let orderStatus, orderStatus > 0 {
+            query.append(URLQueryItem(name: "order_status", value: "\(orderStatus)"))
+        }
+        if let userPhone, !userPhone.isEmpty {
+            query.append(URLQueryItem(name: "user_phone", value: userPhone))
+        }
+        if let startTime, !startTime.isEmpty {
+            query.append(URLQueryItem(name: "start_time", value: startTime))
+        }
+        if let endTime, !endTime.isEmpty {
+            query.append(URLQueryItem(name: "end_time", value: endTime))
+        }
+        if let isRefined, isRefined > 0 {
+            query.append(URLQueryItem(name: "is_refined", value: "\(isRefined)"))
+        }
+
+        return try await client.send(
+            APIRequest(
+                method: .get,
+                path: isScenicAdmin ? "/api/app/scenic-admin/order/list" : "/api/yf-handset-app/photog/order/listv2",
+                queryItems: query
+            )
+        )
+    }
+
+    /// 获取核销订单列表。
+    func writeOffList(scenicId: Int, page: Int = 1, pageSize: Int = 20) async throws -> ListPayload<WriteOffOrderItem> {
+        try await client.send(
+            APIRequest(
+                method: .get,
+                path: "/api/yf-handset-app/photog/order/order-verification-list",
+                queryItems: [
+                    URLQueryItem(name: "scenic_id", value: "\(scenicId)"),
+                    URLQueryItem(name: "page", value: "\(max(page, 1))"),
+                    URLQueryItem(name: "page_size", value: "\(max(pageSize, 1))")
+                ]
+            )
+        )
+    }
+
+    /// 核销指定订单号。
+    func writeOff(orderNumber: String) async throws {
+        let _: EmptyPayload = try await client.send(
+            APIRequest(
+                method: .post,
+                path: "/api/yf-handset-app/photog/order/order-verify",
+                body: WriteOffRequest(orderNumber: orderNumber)
+            )
+        )
+    }
+}