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/Invite/ViewControllers/InviteViewControllers.swift

@@ -20,6 +20,7 @@ final class PhotographerInviteViewController: UIViewController {
     private let rulesLabel = UILabel()
     private let activityIndicator = UIActivityIndicatorView(style: .medium)
 
+    /// 视图加载完成后的 UI 初始化与数据绑定。
     override func viewDidLoad() {
         super.viewDidLoad()
         title = "邀请摄影师"
@@ -29,6 +30,7 @@ final class PhotographerInviteViewController: UIViewController {
         Task { await viewModel.reload(api: services.inviteAPI) }
     }
 
+    /// 初始化UI相关 UI 或状态。
     private func setupUI() {
         navigationItem.rightBarButtonItems = [
             UIBarButtonItem(title: "复制码", style: .plain, target: self, action: #selector(copyCode)),
@@ -64,6 +66,7 @@ final class PhotographerInviteViewController: UIViewController {
         contentStack.addArrangedSubview(rulesLabel)
     }
 
+    /// render 业务逻辑。
     private func render() {
         activityIndicator.isHidden = !viewModel.loading
         if viewModel.loading { activityIndicator.startAnimating() } else { activityIndicator.stopAnimating() }
@@ -76,7 +79,9 @@ final class PhotographerInviteViewController: UIViewController {
         }
     }
 
+    /// 复制验证码。
     @objc private func copyCode() { viewModel.copyInviteCode() }
+    /// 复制链接。
     @objc private func copyURL() { viewModel.copyInviteUrl() }
 }
 
@@ -87,6 +92,7 @@ final class InviteRecordViewController: ModuleTableViewController {
     private let viewModel = InviteRecordViewModel()
     private let summaryLabel = UILabel()
 
+    /// 视图加载完成后的 UI 初始化与数据绑定。
     override func viewDidLoad() {
         title = "邀请记录"
         navigationItem.rightBarButtonItem = UIBarButtonItem(
@@ -103,6 +109,7 @@ final class InviteRecordViewController: ModuleTableViewController {
         }
     }
 
+    /// 初始化Header相关 UI 或状态。
     private func setupHeader() {
         summaryLabel.font = .systemFont(ofSize: 14)
         summaryLabel.textColor = AppDesign.textSecondary
@@ -112,10 +119,12 @@ final class InviteRecordViewController: ModuleTableViewController {
         tableView.tableHeaderView = summaryLabel
     }
 
+    /// table行Count相关逻辑。
     override func tableRowCount() -> Int {
         viewModel.displayRows.count
     }
 
+    /// 配置Cell展示内容。
     override func configureCell(_ cell: TitleSubtitleTableViewCell, at indexPath: IndexPath) {
         let row = viewModel.displayRows[indexPath.row]
         cell.configure(
@@ -125,6 +134,7 @@ final class InviteRecordViewController: ModuleTableViewController {
         )
     }
 
+    /// 刷新Content。
     override func reloadContent() async {
         await viewModel.reload(
             inviteAPI: services.inviteAPI,
@@ -134,11 +144,13 @@ final class InviteRecordViewController: ModuleTableViewController {
         updateSummary()
     }
 
+    /// 更新Summary状态。
     private func updateSummary() {
         summaryLabel.text = "累计奖励 \(viewModel.totalRewardText) · 可提现 \(viewModel.withdrawableText)"
         navigationItem.rightBarButtonItem?.title = viewModel.tab == .invite ? "奖励明细" : "邀请用户"
     }
 
+    /// toggleTab相关逻辑。
     @objc private func toggleTab() {
         Task {
             let next: InviteRecordTab = viewModel.tab == .invite ? .reward : .invite

suixinkan_ios/Features/Invite/ViewModels/InviteViewModels.swift

@@ -61,6 +61,7 @@ final class PhotographerInviteViewModel {
         return UIImage(cgImage: cgImage)
     }
 
+    /// 清空。
     private func clear() {
         inviteCode = ""
         inviteUrl = ""
@@ -128,6 +129,7 @@ final class InviteRecordViewModel {
         await reload(inviteAPI: inviteAPI, walletAPI: walletAPI, refresh: true)
     }
 
+    /// 加载InviteRows数据。
     private func loadInviteRows(api: any InviteServing, refresh: Bool) async throws {
         let users = try await api.inviteUserList(page: refresh ? 1 : invitePage, pageSize: invitePageSize)
         let mapped = users.map {
@@ -152,6 +154,7 @@ final class InviteRecordViewModel {
         hasMore = users.count >= invitePageSize
     }
 
+    /// 加载RewardRows数据。
     private func loadRewardRows(api: any WalletServing, refresh: Bool) async throws {
         let response = try await api.walletEarningDetail(
             startDate: "2025-01-01",
@@ -183,6 +186,7 @@ final class InviteRecordViewModel {
         hasMore = rewardRows.count < response.total && !mapped.isEmpty
     }
 
+    /// 清空。
     private func clear() {
         totalRewardText = "¥ 0.00"
         withdrawableText = "¥ 0.00"