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/Orders/ViewControllers/OrderCodeScannerViewController.swift

@@ -32,6 +32,7 @@ final class OrderCodeScannerViewController: UIViewController {
 
     private let scannerController = OrderScannerCaptureViewController()
 
+    /// 视图加载完成后的 UI 初始化与数据绑定。
     override func viewDidLoad() {
         super.viewDidLoad()
         view.backgroundColor = .black
@@ -49,6 +50,7 @@ final class OrderCodeScannerViewController: UIViewController {
         #endif
     }
 
+    /// embed扫码相关逻辑。
     private func embedScanner() {
         scannerController.onScanResult = { [weak self] result in
             self?.onScanResult?(result)
@@ -77,6 +79,7 @@ final class OrderCodeScannerViewController: UIViewController {
         }
     }
 
+    /// 展示UnavailablePlaceholder。
     private func showUnavailablePlaceholder() {
         let stack = UIStackView()
         stack.axis = .vertical
@@ -109,6 +112,7 @@ final class OrderCodeScannerViewController: UIViewController {
         }
     }
 
+    /// 点击close的处理逻辑。
     @objc private func closeTapped() {
         dismiss(animated: true)
     }
@@ -145,6 +149,7 @@ final class OrderScannerCaptureViewController: UIViewController, AVCaptureMetada
         return button
     }()
 
+    /// 视图加载完成后的 UI 初始化与数据绑定。
     override func viewDidLoad() {
         super.viewDidLoad()
         view.backgroundColor = .black
@@ -152,17 +157,20 @@ final class OrderScannerCaptureViewController: UIViewController, AVCaptureMetada
         checkPermissionAndStart()
     }
 
+    /// 子视图布局完成后调整依赖 frame 的 UI。
     override func viewDidLayoutSubviews() {
         super.viewDidLayoutSubviews()
         previewLayer?.frame = view.layer.bounds
     }
 
+    /// 视图即将消失，保存或清理临时状态。
     override func viewWillDisappear(_ animated: Bool) {
         super.viewWillDisappear(animated)
         updateTorch(enabled: false)
         stopSession()
     }
 
+    /// check权限并启动相关逻辑。
     private func checkPermissionAndStart() {
         switch AVCaptureDevice.authorizationStatus(for: .video) {
         case .authorized:
@@ -185,6 +193,7 @@ final class OrderScannerCaptureViewController: UIViewController, AVCaptureMetada
         }
     }
 
+    /// 启动Session流程。
     private func startSession() {
         hasFinishedScan = false
         guard !session.isRunning else { return }
@@ -199,11 +208,13 @@ final class OrderScannerCaptureViewController: UIViewController, AVCaptureMetada
         }
     }
 
+    /// 停止Session流程。
     private func stopSession() {
         guard session.isRunning else { return }
         session.stopRunning()
     }
 
+    /// 创建ScannerButton实例。
     private static func makeScannerButton(title: String) -> UIButton {
         var config = UIButton.Configuration.filled()
         config.title = title
@@ -213,6 +224,7 @@ final class OrderScannerCaptureViewController: UIViewController, AVCaptureMetada
         return UIButton(configuration: config)
     }
 
+    /// 配置Session展示内容。
     private func configureSession() throws {
         if previewLayer != nil { return }
         guard let videoDevice = AVCaptureDevice.default(for: .video) else {
@@ -242,6 +254,7 @@ final class OrderScannerCaptureViewController: UIViewController, AVCaptureMetada
         torchButton.isEnabled = videoDevice.hasTorch
     }
 
+    /// metadataOutput相关逻辑。
     func metadataOutput(_ output: AVCaptureMetadataOutput, didOutput metadataObjects: [AVMetadataObject], from connection: AVCaptureConnection) {
         guard !hasFinishedScan else { return }
         guard let metadataObject = metadataObjects.first as? AVMetadataMachineReadableCodeObject,
@@ -253,6 +266,7 @@ final class OrderScannerCaptureViewController: UIViewController, AVCaptureMetada
         onScanResult?(.success(code))
     }
 
+    /// 初始化Controls相关 UI 或状态。
     private func setupControls() {
         view.addSubview(scanFrameView)
         view.addSubview(torchButton)
@@ -273,10 +287,12 @@ final class OrderScannerCaptureViewController: UIViewController, AVCaptureMetada
         }
     }
 
+    /// toggleTorch相关逻辑。
     @objc private func toggleTorch() {
         updateTorch(enabled: !(videoDevice?.isTorchActive ?? false))
     }
 
+    /// 更新Torch状态。
     private func updateTorch(enabled: Bool) {
         guard let device = videoDevice, device.hasTorch else { return }
         do {
@@ -293,6 +309,7 @@ final class OrderScannerCaptureViewController: UIViewController, AVCaptureMetada
         }
     }
 
+    /// restart扫码相关逻辑。
     @objc private func restartScan() {
         hasFinishedScan = false
         updateTorch(enabled: false)