Advance UIKit rewrite with AMap integration and core UI modules.

Integrate高德 SDK with simulator-safe build flags, add map views for operating area and punch points, refactor main tabs and key feature screens to UIKit with Diffable lists, and document Swift concurrency defaults in AGENTS.md.

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

suixinkan_ios/Core/Push/PushNotificationManager.swift

@@ -21,6 +21,7 @@ final class PushNotificationManager: NSObject, UNUserNotificationCenterDelegate
     private let tokenDefaultsKey = "apns_device_token"
     private let uploadedTokenDefaultsKey = "apns_uploaded_token"
 
+    /// 初始化实例。
     override init() {
         super.init()
     }
@@ -99,6 +100,7 @@ final class PushNotificationManager: NSObject, UNUserNotificationCenterDelegate
         route(from: payload)
     }
 
+    /// user通知Center相关逻辑。
     nonisolated func userNotificationCenter(
         _ center: UNUserNotificationCenter,
         willPresent notification: UNNotification,
@@ -111,6 +113,7 @@ final class PushNotificationManager: NSObject, UNUserNotificationCenterDelegate
         completionHandler([.banner, .list, .sound, .badge])
     }
 
+    /// user通知Center相关逻辑。
     nonisolated func userNotificationCenter(
         _ center: UNUserNotificationCenter,
         didReceive response: UNNotificationResponse,
@@ -123,6 +126,7 @@ final class PushNotificationManager: NSObject, UNUserNotificationCenterDelegate
         }
     }
 
+    /// 根据执行路由跳转。
     private func route(from payload: PushPayload) {
         guard let router else { return }
 
@@ -142,6 +146,7 @@ final class PushNotificationManager: NSObject, UNUserNotificationCenterDelegate
         }
     }
 
+    /// 导航至HomeRoute页面。
     private func navigateHomeRoute(_ route: HomeRoute) {
         guard let router else { return }
         router.select(.home)

suixinkan_ios/Core/Push/PushPayload.swift

@@ -9,6 +9,7 @@ import Foundation
 
 /// APNs token 工具，把系统返回的 Data 转成后端可接收的小写十六进制字符串。
 enum APNsDeviceToken {
+    /// 将二进制数据转为十六进制字符串。
     static func hexString(from data: Data) -> String {
         data.map { String(format: "%02x", $0) }.joined()
     }
@@ -16,6 +17,7 @@ enum APNsDeviceToken {
 
 /// 推送 payload 解析器，兼容顶层字段和第三方通道常见 extras/data 嵌套结构。
 struct PushPayload: Sendable {
+    /// 枚举，定义相关常量或状态。
     enum Route: Sendable, Equatable {
         case payment
         case order
@@ -64,6 +66,7 @@ struct PushPayload: Sendable {
         return .messageCenter
     }
 
+    /// mergeJSON相关逻辑。
     nonisolated private static func mergeJSON(_ value: Any, into result: inout [String: String]) {
         if let dict = value as? [String: Any] {
             for (key, value) in dict {
@@ -84,6 +87,7 @@ struct PushPayload: Sendable {
         }
     }
 
+    /// 安全地将任意值转为字符串。
     nonisolated private static func stringValue(_ value: Any?) -> String {
         switch value {
         case let string as String: