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/Schedule/ViewControllers/ScheduleViewControllers.swift

@@ -11,6 +11,7 @@ import UIKit
 final class ScheduleManagementViewController: ModuleTableViewController {
     private let viewModel = ScheduleManagementViewModel()
 
+    /// 视图加载完成后的 UI 初始化与数据绑定。
     override func viewDidLoad() {
         title = "排班管理"
         navigationItem.rightBarButtonItems = [
@@ -27,10 +28,12 @@ final class ScheduleManagementViewController: ModuleTableViewController {
         wireViewModel(viewModel) { [weak self] in self?.updateTitle() }
     }
 
+    /// table行Count相关逻辑。
     override func tableRowCount() -> Int {
         viewModel.items.count
     }
 
+    /// 配置Cell展示内容。
     override func configureCell(_ cell: TitleSubtitleTableViewCell, at indexPath: IndexPath) {
         let item = viewModel.items[indexPath.row]
         cell.configure(
@@ -40,6 +43,7 @@ final class ScheduleManagementViewController: ModuleTableViewController {
         )
     }
 
+    /// didSelectTableRow 回调处理。
     override func didSelectTableRow(at indexPath: IndexPath) {
         let item = viewModel.items[indexPath.row]
         let alert = UIAlertController(title: item.name, message: "删除该排班？", preferredStyle: .alert)
@@ -51,24 +55,29 @@ final class ScheduleManagementViewController: ModuleTableViewController {
         present(alert, animated: true)
     }
 
+    /// 刷新Content。
     override func reloadContent() async {
         await viewModel.reload(api: services.scheduleAPI, scenicId: services.currentScenicId)
         updateTitle()
     }
 
+    /// 更新Title状态。
     private func updateTitle() {
         let month = viewModel.monthDate.scheduleYearMonthText
         title = "排班 \(month)"
     }
 
+    /// previousMonth相关逻辑。
     @objc private func previousMonth() {
         Task { await viewModel.previousMonth(api: services.scheduleAPI, scenicId: services.currentScenicId) }
     }
 
+    /// nextMonth相关逻辑。
     @objc private func nextMonth() {
         Task { await viewModel.nextMonth(api: services.scheduleAPI, scenicId: services.currentScenicId) }
     }
 
+    /// add排班相关逻辑。
     @objc private func addSchedule() {
         navigationController?.pushViewController(ScheduleAddViewController(), animated: true)
     }
@@ -82,6 +91,7 @@ final class ScheduleAddViewController: ModuleTableViewController {
     private let nameField = UITextField()
     private let remarkField = UITextField()
 
+    /// 视图加载完成后的 UI 初始化与数据绑定。
     override func viewDidLoad() {
         title = "新增排班"
         navigationItem.rightBarButtonItem = UIBarButtonItem(
@@ -95,6 +105,7 @@ final class ScheduleAddViewController: ModuleTableViewController {
         setupFormHeader()
     }
 
+    /// 初始化FormHeader相关 UI 或状态。
     private func setupFormHeader() {
         nameField.placeholder = "日程名称"
         nameField.borderStyle = .roundedRect
@@ -109,10 +120,12 @@ final class ScheduleAddViewController: 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.draft.selectedOrder?.orderNumber == order.orderNumber
@@ -120,15 +133,18 @@ final class ScheduleAddViewController: ModuleTableViewController {
         cell.accessoryType = selected ? .checkmark : .none
     }
 
+    /// didSelectTableRow 回调处理。
     override func didSelectTableRow(at indexPath: IndexPath) {
         viewModel.draft.selectedOrder = viewModel.availableOrders[indexPath.row]
         reloadTable()
     }
 
+    /// 刷新Content。
     override func reloadContent() async {
         await viewModel.loadOrders(api: services.scheduleAPI, scenicId: services.currentScenicId)
     }
 
+    /// 提交。
     @objc private func submit() {
         viewModel.draft.name = nameField.text ?? ""
         viewModel.draft.remark = remarkField.text ?? ""

suixinkan_ios/Features/Schedule/ViewModels/ScheduleViewModels.swift

@@ -99,6 +99,7 @@ final class ScheduleManagementViewModel {
         }
     }
 
+    /// 重置状态。
     private func reset() {
         markedDays = []
         items = []
@@ -174,6 +175,7 @@ final class ScheduleAddViewModel {
         return text
     }
 
+    /// 记录校验失败并返回 false。
     private func fail(_ error: ScheduleValidationError) -> Bool {
         errorMessage = error.localizedDescription
         return false