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/MessageCenter/API/MessageCenterAPI.swift

@@ -0,0 +1,74 @@
+//
+//  MessageCenterAPI.swift
+//  suixinkan
+//
+//  Created by Codex on 2026/6/25.
+//
+
+import Foundation
+import Observation
+
+/// 消息中心服务协议，定义消息列表、已读和删除能力。
+@MainActor
+protocol MessageCenterServing {
+    /// 获取消息列表，使用 last_id 游标分页。
+    func messageList(lastId: Int, limit: Int, unread: Int) async throws -> MessageListResponse
+
+    /// 标记单条消息为已读。
+    func messageRead(id: Int) async throws
+
+    /// 删除单条消息。
+    func messageDelete(id: Int) async throws
+}
+
+@MainActor
+@Observable
+/// 消息中心 API，封装消息相关网络请求。
+final class MessageCenterAPI {
+    @ObservationIgnored private let client: APIClient
+
+    /// 初始化消息中心 API，并注入共享网络客户端。
+    init(client: APIClient) {
+        self.client = client
+    }
+
+    /// 获取消息列表，使用 last_id 游标分页。
+    func messageList(lastId: Int = 0, limit: Int = 20, unread: Int = 0) async throws -> MessageListResponse {
+        try await client.send(
+            APIRequest(
+                method: .get,
+                path: "/api/app/msg/list",
+                queryItems: [
+                    URLQueryItem(name: "last_id", value: String(max(lastId, 0))),
+                    URLQueryItem(name: "limit", value: String(max(limit, 1))),
+                    URLQueryItem(name: "unread", value: String(max(unread, 0)))
+                ]
+            )
+        )
+    }
+
+    /// 标记单条消息为已读。
+    func messageRead(id: Int) async throws {
+        let _: EmptyPayload = try await client.send(
+            APIRequest(
+                method: .post,
+                path: "/api/app/msg/read",
+                queryItems: [URLQueryItem(name: "id", value: String(id))],
+                body: EmptyPayload()
+            )
+        )
+    }
+
+    /// 删除单条消息。
+    func messageDelete(id: Int) async throws {
+        let _: EmptyPayload = try await client.send(
+            APIRequest(
+                method: .post,
+                path: "/api/app/msg/delete",
+                body: MessageDeleteRequest(id: id)
+            )
+        )
+    }
+}
+
+extension MessageCenterAPI: MessageCenterServing {}