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/Features/QueueManagement/Models/ScenicQueueModels.swift

@@ -13,6 +13,7 @@ struct ScenicQueueStatsData: Decodable, Equatable {
     let avgWaitMin: Double
     let time: String
 
+    /// 枚举，定义相关常量或状态。
     enum CodingKeys: String, CodingKey {
         case queueCount = "queue_count"
         case avgWaitMin = "avg_wait_min"
@@ -41,6 +42,7 @@ struct ScenicQueueHomeData: Decodable, Equatable {
     let list: ScenicQueueHomeListBlock?
     let time: String?
 
+    /// 枚举，定义相关常量或状态。
     enum CodingKeys: String, CodingKey {
         case stats
         case list
@@ -73,6 +75,7 @@ struct ScenicQueueHomeData: Decodable, Equatable {
 struct ScenicQueueHomeStats: Decodable, Equatable {
     let type: Int
 
+    /// 枚举，定义相关常量或状态。
     enum CodingKeys: String, CodingKey {
         case type
     }
@@ -96,6 +99,7 @@ struct ScenicQueueHomeListBlock: Decodable, Equatable {
     let page: Int
     let pageSize: Int
 
+    /// 枚举，定义相关常量或状态。
     enum CodingKeys: String, CodingKey {
         case list
         case total
@@ -174,6 +178,7 @@ struct ScenicQueueTicket: Decodable, Equatable, Identifiable {
         isMissRequeue == 1
     }
 
+    /// 枚举，定义相关常量或状态。
     enum CodingKeys: String, CodingKey {
         case id
         case queueCode = "queue_code"
@@ -198,6 +203,7 @@ struct ScenicQueueTicket: Decodable, Equatable, Identifiable {
         case missRequeueText = "is_miss_requeue_text"
     }
 
+    /// 枚举，定义相关常量或状态。
     enum AlternateCodingKeys: String, CodingKey {
         case queueNo = "queue_no"
         case queueNumber = "queue_number"
@@ -289,6 +295,7 @@ struct ScenicQueueTicket: Decodable, Equatable, Identifiable {
         missRequeueText = try container.decodeLossyString(forKey: .missRequeueText).trimmingCharacters(in: .whitespacesAndNewlines)
     }
 
+    /// 格式化排队时间。
     private static func formatQueueTime(_ raw: String) -> String {
         let text = raw.trimmingCharacters(in: .whitespacesAndNewlines)
         guard !text.isEmpty else { return "--" }
@@ -317,6 +324,7 @@ struct ScenicQueueActionRequest: Encodable {
 struct SocketTokenResponse: Decodable, Equatable {
     let socketToken: String
 
+    /// 枚举，定义相关常量或状态。
     enum CodingKeys: String, CodingKey {
         case socketToken = "socket_token"
     }
@@ -340,6 +348,7 @@ struct ScenicQueueActionData: Decodable, Equatable {
     let statusText: String
     let calledAt: String?
 
+    /// 枚举，定义相关常量或状态。
     enum CodingKeys: String, CodingKey {
         case id
         case status
@@ -375,6 +384,7 @@ struct ScenicQueueRequeueInsertBeforeRequest: Encodable {
     let recordId: Int64
     let operatorId: Int
 
+    /// 枚举，定义相关常量或状态。
     enum CodingKeys: String, CodingKey {
         case recordId = "record_id"
         case operatorId = "operator_id"
@@ -389,6 +399,7 @@ struct ScenicQueueUserMarkRequest: Encodable, Equatable {
     let queueBanDays: Int?
     let operatorId: Int?
 
+    /// 枚举，定义相关常量或状态。
     enum CodingKeys: String, CodingKey {
         case uid
         case scenicId = "scenic_id"
@@ -433,6 +444,7 @@ struct ScenicQueueRemoteCallAnnouncement: Identifiable, Equatable {
 }
 
 private extension KeyedDecodingContainer {
+    /// 解码宽松字符串。
     func decodeLossyString(forKey key: Key) throws -> String {
         if let value = try? decodeIfPresent(String.self, forKey: key) {
             return value
@@ -449,6 +461,7 @@ private extension KeyedDecodingContainer {
         return ""
     }
 
+    /// 解码宽松整数。
     func decodeLossyInt(forKey key: Key) throws -> Int? {
         if let value = try? decodeIfPresent(Int.self, forKey: key) {
             return value
@@ -467,6 +480,7 @@ private extension KeyedDecodingContainer {
         return nil
     }
 
+    /// 解码宽松Double。
     func decodeLossyDouble(forKey key: Key) throws -> Double? {
         if let value = try? decodeIfPresent(Double.self, forKey: key) {
             return value
@@ -484,6 +498,7 @@ private extension KeyedDecodingContainer {
 }
 
 private extension String {
+    /// non空或默认相关逻辑。
     func nonEmptyOrDefault(_ fallback: String) -> String {
         let text = trimmingCharacters(in: .whitespacesAndNewlines)
         return text.isEmpty ? fallback : text