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/App/ViewControllers/RootViewController.swift

@@ -14,6 +14,7 @@ final class RootViewController: UIViewController {
     private var currentChild: UIViewController?
     private let restoringView = UIView()
 
+    /// 初始化实例。
     init(services: AppServices = .shared) {
         self.services = services
         super.init(nibName: nil, bundle: nil)
@@ -24,6 +25,7 @@ final class RootViewController: UIViewController {
         fatalError("init(coder:) has not been implemented")
     }
 
+    /// 初始化视图、监听登录阶段变化并启动会话恢复。
     override func viewDidLoad() {
         super.viewDidLoad()
         view.backgroundColor = .systemBackground
@@ -38,11 +40,13 @@ final class RootViewController: UIViewController {
         configurePushNotifications()
     }
 
+    /// 窗口展示后将 Toast 与全局 Loading 挂载到 window 层级。
     override func viewDidAppear(_ animated: Bool) {
         super.viewDidAppear(animated)
         attachGlobalOverlays()
     }
 
+    /// 冷启动时恢复本地会话，并在已登录时申请推送权限。
     private func bootstrapSession() {
         Task {
             await services.globalLoading.withLoading {
@@ -62,16 +66,19 @@ final class RootViewController: UIViewController {
         }
     }
 
+    /// 配置推送管理器与路由跳转回调。
     private func configurePushNotifications() {
         services.configurePushNotifications()
     }
 
+    /// 将全局 Toast 与 Loading 视图附加到当前 window。
     private func attachGlobalOverlays() {
         guard let window = view.window else { return }
         services.toastCenter.attachToWindow(window)
         services.globalLoading.attachToWindow(window)
     }
 
+    /// 登录阶段变化时切换子页面，并在登出时清理各上下文状态。
     private func handleSessionPhaseChange() {
         mountChild(for: services.appSession.phase)
 
@@ -82,6 +89,7 @@ final class RootViewController: UIViewController {
             }
             Task { await reloadScenicSpotContextIfNeeded() }
         case .loggedOut:
+            // 登出后重置账号、权限、路由与排队运行时，避免残留旧状态
             services.accountContext.reset()
             services.permissionContext.reset()
             services.scenicSpotContext.reset()
@@ -93,6 +101,7 @@ final class RootViewController: UIViewController {
         }
     }
 
+    /// 登录成功后按当前景区 ID 刷新景区上下文。
     private func reloadScenicSpotContextIfNeeded() async {
         guard services.appSession.isLoggedIn else {
             services.scenicSpotContext.reset()
@@ -104,6 +113,7 @@ final class RootViewController: UIViewController {
         )
     }
 
+    /// 按登录阶段挂载对应子控制器：登录页、恢复占位或主 Tab。
     private func mountChild(for phase: AuthPhase) {
         let nextChild: UIViewController
         switch phase {
@@ -130,6 +140,7 @@ final class RootViewController: UIViewController {
         currentChild = nextChild
     }
 
+    /// 会话恢复阶段的空白占位页，避免闪烁登录页。
     private func restoringViewController() -> UIViewController {
         let controller = UIViewController()
         controller.view.backgroundColor = .systemBackground