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/Tasks/ViewControllers/TaskViewControllers.swift

@@ -11,6 +11,7 @@ import UIKit
 final class TaskManagementViewController: ModuleTableViewController {
     private let viewModel = TaskManagementViewModel()
 
+    /// 视图加载完成后的 UI 初始化与数据绑定。
     override func viewDidLoad() {
         title = "任务管理"
         navigationItem.rightBarButtonItem = UIBarButtonItem(
@@ -23,15 +24,18 @@ final class TaskManagementViewController: ModuleTableViewController {
         wireViewModel(viewModel) { }
     }
 
+    /// table行Count相关逻辑。
     override func tableRowCount() -> Int {
         viewModel.tasks.count
     }
 
+    /// 配置Cell展示内容。
     override func configureCell(_ cell: TitleSubtitleTableViewCell, at indexPath: IndexPath) {
         let task = viewModel.tasks[indexPath.row]
         cell.configure(title: task.name, subtitle: task.statusName, detail: task.createdAt)
     }
 
+    /// didSelectTableRow 回调处理。
     override func didSelectTableRow(at indexPath: IndexPath) {
         let task = viewModel.tasks[indexPath.row]
         navigationController?.pushViewController(
@@ -40,15 +44,18 @@ final class TaskManagementViewController: ModuleTableViewController {
         )
     }
 
+    /// 刷新Content。
     override func reloadContent() async {
         try? await viewModel.reload(api: services.taskAPI, scenicId: services.currentScenicId)
     }
 
+    /// table视图相关逻辑。
     override func tableView(_ tableView: UITableView, willDisplay cell: UITableViewCell, forRowAt indexPath: IndexPath) {
         guard indexPath.row >= viewModel.tasks.count - 2 else { return }
         Task { try? await viewModel.loadMore(api: services.taskAPI, scenicId: services.currentScenicId) }
     }
 
+    /// 创建任务。
     @objc private func createTask() {
         navigationController?.pushViewController(TaskCreateViewController(), animated: true)
     }
@@ -62,6 +69,7 @@ final class TaskDetailViewController: ModuleTableViewController {
     private let summary: PhotographerTaskItem?
     private let viewModel = TaskDetailViewModel()
 
+    /// 初始化实例。
     init(taskId: Int, summary: PhotographerTaskItem?) {
         self.taskId = taskId
         self.summary = summary
@@ -73,6 +81,7 @@ final class TaskDetailViewController: ModuleTableViewController {
         fatalError("init(coder:) has not been implemented")
     }
 
+    /// 视图加载完成后的 UI 初始化与数据绑定。
     override func viewDidLoad() {
         title = summary?.name ?? "任务详情"
         super.viewDidLoad()
@@ -81,11 +90,13 @@ final class TaskDetailViewController: ModuleTableViewController {
         }
     }
 
+    /// table行Count相关逻辑。
     override func tableRowCount() -> Int {
         guard let detail = viewModel.detail else { return summary == nil ? 0 : 4 }
         return 6
     }
 
+    /// 配置Cell展示内容。
     override func configureCell(_ cell: TitleSubtitleTableViewCell, at indexPath: IndexPath) {
         if let detail = viewModel.detail {
             switch indexPath.row {
@@ -106,6 +117,7 @@ final class TaskDetailViewController: ModuleTableViewController {
         }
     }
 
+    /// 刷新Content。
     override func reloadContent() async {
         await viewModel.load(api: services.taskAPI, taskId: taskId)
     }
@@ -119,6 +131,7 @@ final class TaskCreateViewController: ModuleTableViewController {
     private let nameField = UITextField()
     private let remarkField = UITextField()
 
+    /// 视图加载完成后的 UI 初始化与数据绑定。
     override func viewDidLoad() {
         title = "发布任务"
         navigationItem.rightBarButtonItem = UIBarButtonItem(
@@ -132,6 +145,7 @@ final class TaskCreateViewController: ModuleTableViewController {
         wireViewModel(viewModel) { }
     }
 
+    /// 初始化Header相关 UI 或状态。
     private func setupHeader() {
         nameField.placeholder = "任务名称"
         nameField.borderStyle = .roundedRect
@@ -146,10 +160,12 @@ final class TaskCreateViewController: ModuleTableViewController {
         tableView.tableHeaderView = stack
     }
 
+    /// table行Count相关逻辑。
     override func tableRowCount() -> Int {
         viewModel.availableOrders.count
     }
 
+    /// 配置Cell展示内容。
     override func configureCell(_ cell: TitleSubtitleTableViewCell, at indexPath: IndexPath) {
         let order = viewModel.availableOrders[indexPath.row]
         let selected = viewModel.selectedOrder?.orderNumber == order.orderNumber
@@ -157,14 +173,17 @@ final class TaskCreateViewController: ModuleTableViewController {
         cell.accessoryType = selected ? .checkmark : .none
     }
 
+    /// didSelectTableRow 回调处理。
     override func didSelectTableRow(at indexPath: IndexPath) {
         viewModel.selectedOrder = viewModel.availableOrders[indexPath.row]
     }
 
+    /// 刷新Content。
     override func reloadContent() async {
         await viewModel.loadAvailableOrders(api: services.taskAPI, scenicId: services.currentScenicId)
     }
 
+    /// 提交。
     @objc private func submit() {
         viewModel.taskName = nameField.text ?? ""
         viewModel.remark = remarkField.text ?? ""

suixinkan_ios/Features/Tasks/ViewModels/TaskCreateViewModel.swift

@@ -166,6 +166,7 @@ final class TaskCreateViewModel {
 
     /// 校验表单并按需写入错误提示。
     private func validateForm(scenicId: Int?, shouldSetError: Bool) -> Bool {
+        /// 记录校验失败并返回 false。
         func fail(_ message: String) -> Bool {
             if shouldSetError { errorMessage = message }
             return false