新增景区权限模块，集成 AMap CocoaPods 并支持模拟器

将景区选择与权限申请流程接入首页路由，集成高德 SDK 用于真机构建，并通过 Podfile post_install 钩子保证 arm64 模拟器可编译。

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

suixinkan/Features/ScenicPermission/API/ScenicPermissionAPI.swift

@@ -0,0 +1,121 @@
+//
+//  ScenicPermissionAPI.swift
+//  suixinkan
+//
+//  Created by Codex on 2026/6/23.
+//
+
+import Foundation
+import Observation
+
+/// 景区权限模块服务协议，定义景区选择、权限申请和景区申请所需接口。
+@MainActor
+protocol ScenicPermissionServing {
+    /// 获取所有可申请景区列表。
+    func scenicListAll() async throws -> ScenicListAllResponse
+
+    /// 获取省市区地区树。
+    func areas() async throws -> [ScenicAreaNode]
+
+    /// 获取当前用户的景区申请记录。
+    func scenicApplicationPendingAll() async throws -> ScenicApplicationPendingsResponse
+
+    /// 提交新增景区入驻申请。
+    func scenicSubmit(_ request: ScenicApplicationSubmitRequest) async throws
+
+    /// 提交景区申请图片占位信息。
+    func scenicApplicationUploadPlaceholder(_ items: [ScenicApplicationUploadPlaceholder]) async throws
+
+    /// 获取当前用户的角色权限申请记录。
+    func roleApplyAll() async throws -> [RoleApplyPendingResponse]
+
+    /// 提交角色景区权限申请。
+    func roleApplySubmit(roleId: Int, scenicIds: [Int]) async throws
+}
+
+@MainActor
+@Observable
+/// 景区权限 API，封装景区选择和申请相关网络请求。
+final class ScenicPermissionAPI {
+    @ObservationIgnored private let client: APIClient
+
+    /// 初始化景区权限 API，并注入共享网络客户端。
+    init(client: APIClient) {
+        self.client = client
+    }
+
+    /// 获取所有可申请景区列表。
+    func scenicListAll() async throws -> ScenicListAllResponse {
+        try await client.send(
+            APIRequest(
+                method: .get,
+                path: "/api/yf-handset-app/photog/scenic/list-all"
+            )
+        )
+    }
+
+    /// 获取省市区地区树。
+    func areas() async throws -> [ScenicAreaNode] {
+        try await client.send(
+            APIRequest(
+                method: .get,
+                path: "/api/app/config/areas"
+            )
+        )
+    }
+
+    /// 获取当前用户的景区申请记录。
+    func scenicApplicationPendingAll() async throws -> ScenicApplicationPendingsResponse {
+        try await client.send(
+            APIRequest(
+                method: .get,
+                path: "/api/yf-handset-app/photog/scenic-apply/all"
+            )
+        )
+    }
+
+    /// 提交新增景区入驻申请。
+    func scenicSubmit(_ request: ScenicApplicationSubmitRequest) async throws {
+        let _: EmptyPayload = try await client.send(
+            APIRequest(
+                method: .post,
+                path: "/api/yf-handset-app/photog/scenic-apply/submit",
+                body: request
+            )
+        )
+    }
+
+    /// 提交景区申请图片占位信息。
+    func scenicApplicationUploadPlaceholder(_ items: [ScenicApplicationUploadPlaceholder]) async throws {
+        let _: EmptyPayload = try await client.send(
+            APIRequest(
+                method: .post,
+                path: "/api/yf-handset-app/photog/scenic-apply/upload-placeholder",
+                body: ["files": items]
+            )
+        )
+    }
+
+    /// 获取当前用户的角色权限申请记录。
+    func roleApplyAll() async throws -> [RoleApplyPendingResponse] {
+        try await client.send(
+            APIRequest(
+                method: .get,
+                path: "/api/yf-handset-app/photog/role-apply/all"
+            )
+        )
+    }
+
+    /// 提交角色景区权限申请。
+    func roleApplySubmit(roleId: Int, scenicIds: [Int]) async throws {
+        let _: EmptyPayload = try await client.send(
+            APIRequest(
+                method: .post,
+                path: "/api/yf-handset-app/photog/role-apply/submit",
+                body: RoleApplySubmitRequest(scenicId: scenicIds, roleId: roleId)
+            )
+        )
+    }
+}
+
+extension ScenicPermissionAPI: ScenicPermissionServing {}