Add TravelAlbum, ProfileSpace, and wired camera transfer modules.

Introduce travel album entry with Sony PTP tethering pipeline, profile space settings page, home routing updates, Launch Screen storyboard, and related tests/docs.

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

suixinkan/Features/TravelAlbum/API/TravelAlbumAPI.swift

@@ -0,0 +1,130 @@
+//
+//  TravelAlbumAPI.swift
+//  suixinkan
+//
+//  Created by Codex on 2026/6/29.
+//
+
+import Foundation
+
+private let travelAlbumBase = "/api/yf-handset-app/photog/travel-album"
+
+/// 旅拍相册服务协议，便于 ViewModel 测试替换。
+@MainActor
+protocol TravelAlbumServing {
+    func availableOrders() async throws -> [TravelAlbumAvailableOrder]
+    func createAlbum(_ request: TravelAlbumCreateRequest) async throws -> TravelAlbumCreateResponse
+    func albumList(page: Int, pageSize: Int) async throws -> ListPayload<TravelAlbumItem>
+    func albumInfo(id: Int) async throws -> TravelAlbumItem
+    func editAlbum(_ request: TravelAlbumEditRequest) async throws
+    func deleteAlbum(_ request: TravelAlbumDeleteRequest) async throws
+    func materialList(userEquityTravelId: Int, page: Int, pageSize: Int) async throws -> ListPayload<TravelAlbumMaterial>
+    func uploadMaterial(_ request: TravelAlbumUploadMaterialRequest) async throws -> TravelAlbumMaterial
+    func deleteMaterial(_ request: TravelAlbumDeleteMaterialRequest) async throws
+    func mpCode(id: Int) async throws -> TravelAlbumMpCodeResponse
+}
+
+/// 旅拍相册 API，封装 travel-album 相关接口。
+@MainActor
+final class TravelAlbumAPI: TravelAlbumServing {
+    private let client: APIClient
+
+    /// 初始化旅拍相册 API。
+    init(client: APIClient) {
+        self.client = client
+    }
+
+    /// 获取可绑定订单列表。
+    func availableOrders() async throws -> [TravelAlbumAvailableOrder] {
+        try await client.send(
+            APIRequest(method: .get, path: "\(travelAlbumBase)/available-order")
+        )
+    }
+
+    /// 创建旅拍相册任务。
+    func createAlbum(_ request: TravelAlbumCreateRequest) async throws -> TravelAlbumCreateResponse {
+        try await client.send(
+            APIRequest(method: .post, path: "\(travelAlbumBase)/create", body: request)
+        )
+    }
+
+    /// 获取旅拍相册列表。
+    func albumList(page: Int, pageSize: Int) async throws -> ListPayload<TravelAlbumItem> {
+        try await client.send(
+            APIRequest(
+                method: .get,
+                path: "\(travelAlbumBase)/list",
+                queryItems: [
+                    URLQueryItem(name: "page", value: "\(max(page, 1))"),
+                    URLQueryItem(name: "page_size", value: "\(max(pageSize, 1))")
+                ]
+            )
+        )
+    }
+
+    /// 获取旅拍相册详情。
+    func albumInfo(id: Int) async throws -> TravelAlbumItem {
+        try await client.send(
+            APIRequest(
+                method: .get,
+                path: "\(travelAlbumBase)/info",
+                queryItems: [URLQueryItem(name: "id", value: "\(id)")]
+            )
+        )
+    }
+
+    /// 编辑旅拍相册。
+    func editAlbum(_ request: TravelAlbumEditRequest) async throws {
+        _ = try await client.send(
+            APIRequest(method: .post, path: "\(travelAlbumBase)/edit", body: request)
+        ) as EmptyPayload
+    }
+
+    /// 删除旅拍相册。
+    func deleteAlbum(_ request: TravelAlbumDeleteRequest) async throws {
+        _ = try await client.send(
+            APIRequest(method: .post, path: "\(travelAlbumBase)/delete", body: request)
+        ) as EmptyPayload
+    }
+
+    /// 获取相册素材列表。
+    func materialList(userEquityTravelId: Int, page: Int, pageSize: Int) async throws -> ListPayload<TravelAlbumMaterial> {
+        try await client.send(
+            APIRequest(
+                method: .get,
+                path: "\(travelAlbumBase)/material-list",
+                queryItems: [
+                    URLQueryItem(name: "user_equity_travel_id", value: "\(userEquityTravelId)"),
+                    URLQueryItem(name: "page", value: "\(max(page, 1))"),
+                    URLQueryItem(name: "page_size", value: "\(max(pageSize, 1))"),
+                    URLQueryItem(name: "order_by", value: "2")
+                ]
+            )
+        )
+    }
+
+    /// 登记已上传 OSS 的素材。
+    func uploadMaterial(_ request: TravelAlbumUploadMaterialRequest) async throws -> TravelAlbumMaterial {
+        try await client.send(
+            APIRequest(method: .post, path: "\(travelAlbumBase)/upload-material", body: request)
+        )
+    }
+
+    /// 删除相册素材。
+    func deleteMaterial(_ request: TravelAlbumDeleteMaterialRequest) async throws {
+        _ = try await client.send(
+            APIRequest(method: .post, path: "\(travelAlbumBase)/delete-material", body: request)
+        ) as EmptyPayload
+    }
+
+    /// 获取小程序码。
+    func mpCode(id: Int) async throws -> TravelAlbumMpCodeResponse {
+        try await client.send(
+            APIRequest(
+                method: .get,
+                path: "\(travelAlbumBase)/mp-code",
+                queryItems: [URLQueryItem(name: "id", value: "\(id)")]
+            )
+        )
+    }
+}