Add OperatingArea and PilotCertification modules with live push readiness.

Migrate operating area and pilot certification from home placeholders, extend Live with playback and push readiness flows, and add pilot certificate OSS upload.

Co-authored-by: Cursor <cursoragent@cursor.com>

suixinkan/Features/Home/Home.md

@@ -33,6 +33,6 @@ Home 模块负责登录后的首页工作台，包括当前景区展示、工作
 
 ## 后续迁移
 
-目前 `payment_collection`、`payment_qr`、`payment_code` 已由 `Features/Payment` 的真实收款页面接管，`wallet` 已由 `Features/Wallet` 的真实钱包页面接管，`scenicselection`、`permission_apply`、`permission_apply_status`、`scenicapplication` 已由 `Features/ScenicPermission` 接管，`task_management`、`task_management_editor`、`task_create` 已由 `Features/Tasks` 接管，`cloud_management`、`cloud_storage_transit`、`asset_management`、`material_upload`、`album_list`、`album_trailer`、`sample_management`、`sample_upload` 已由 `Features/Assets` 接管，`checkin_points` 已由 `Features/PunchPoint` 接管，`location_report` 和 `location_report_history` 已由 `Features/LocationReport` 接管，`pm`、`project_edit` 已由 `Features/Projects` 的摄影师项目管理接管，`pm_manager` 已由店铺项目管理接管，`schedule_management` 已由 `Features/Schedule` 接管，`registration_invitation`、`photographer_invite`、`invite_record` 已由 `Features/Invite` 接管，`deposit_order_detail`、`deposit_order`、`deposit_order_shooting_info` 已由 `Features/Orders` 的押金订单页接管，`withdrawal_audit` 已由 `Features/WithdrawalAudit` 接管，`scenic_settlement` 和 `scenic_settlement_review` 已由 `Features/ScenicSettlement` 接管，`message_center` 已由 `Features/MessageCenter` 接管，`/scenic-queue` 和 `queue_management` 已由 `Features/QueueManagement` 接管，`live_stream_management` 和 `live_album` 已由 `Features/Live` 接管。
+目前 `payment_collection`、`payment_qr`、`payment_code` 已由 `Features/Payment` 的真实收款页面接管，`wallet` 已由 `Features/Wallet` 的真实钱包页面接管，`scenicselection`、`permission_apply`、`permission_apply_status`、`scenicapplication` 已由 `Features/ScenicPermission` 接管，`task_management`、`task_management_editor`、`task_create` 已由 `Features/Tasks` 接管，`cloud_management`、`cloud_storage_transit`、`asset_management`、`material_upload`、`album_list`、`album_trailer`、`sample_management`、`sample_upload` 已由 `Features/Assets` 接管，`checkin_points` 已由 `Features/PunchPoint` 接管，`location_report` 和 `location_report_history` 已由 `Features/LocationReport` 接管，`pm`、`project_edit` 已由 `Features/Projects` 的摄影师项目管理接管，`pm_manager` 已由店铺项目管理接管，`schedule_management` 已由 `Features/Schedule` 接管，`registration_invitation`、`photographer_invite`、`invite_record` 已由 `Features/Invite` 接管，`deposit_order_detail`、`deposit_order`、`deposit_order_shooting_info` 已由 `Features/Orders` 的押金订单页接管，`withdrawal_audit` 已由 `Features/WithdrawalAudit` 接管，`scenic_settlement` 和 `scenic_settlement_review` 已由 `Features/ScenicSettlement` 接管，`message_center` 已由 `Features/MessageCenter` 接管，`/scenic-queue` 和 `queue_management` 已由 `Features/QueueManagement` 接管，`live_stream_management` 和 `live_album` 已由 `Features/Live` 接管，`operating-area` 已由 `Features/OperatingArea` 接管，`pilot_cert` 已由 `Features/PilotCertification` 接管。
 
 后续迁移具体首页子模块时，应先在 `HomeRoute` 增加目标页面，再更新 `HomeMenuRouter.resolve` 对应 URI 的映射，并同步补充单元测试。

suixinkan/Features/Home/Models/HomeMenuItem.swift

@@ -62,6 +62,8 @@ enum HomeRoute: Hashable {
     case queueManagement
     case liveManagement
     case liveAlbum
+    case operatingArea
+    case pilotCertification
     case modulePlaceholder(uri: String, title: String)
 }
 

suixinkan/Features/Home/Routing/HomeMenuRouter.swift

@@ -143,6 +143,10 @@ enum HomeMenuRouter {
             return .destination(.liveManagement)
         case "live_album":
             return .destination(.liveAlbum)
+        case "operating-area":
+            return .destination(.operatingArea)
+        case "pilot_cert":
+            return .destination(.pilotCertification)
         case "store", "more_functions":
             return .destination(.moreFunctions)
         case "fly", "pilot_controller":
@@ -151,10 +155,6 @@ enum HomeMenuRouter {
                 title: title.isEmpty ? self.title(for: uri) : title,
                 reason: "DJI/飞控模块已明确不纳入 iOS 迁移和后续开发范围。"
             )
-        case "operating-area",
-             "pilot_cert":
-            let resolvedTitle = title.isEmpty ? self.title(for: uri) : title
-            return .destination(.modulePlaceholder(uri: uri, title: resolvedTitle))
         default:
             return .placeholder(uri: uri, title: title.isEmpty ? self.title(for: uri) : title)
         }

suixinkan/Features/Home/Views/HomeSupportViews.swift

@@ -100,6 +100,10 @@ extension HomeRoute {
             LiveManagementView()
         case .liveAlbum:
             LiveAlbumView()
+        case .operatingArea:
+            OperatingAreaView()
+        case .pilotCertification:
+            PilotCertificationView()
         case let .modulePlaceholder(uri, title):
             HomeMigrationModuleView(title: title, uri: uri)
         }

suixinkan/Features/Live/Live.md

@@ -2,18 +2,26 @@
 
 ## 模块职责
 
-`Features/Live` 承接首页 `live_stream_management` 和 `live_album` 权限入口，负责手动直播管理和直播相册素材管理。
+`Features/Live` 承接首页 `live_stream_management` 和 `live_album` 权限入口，负责手动直播管理和直播相册素材管理。旧 iOS 工程未接入真推流 SDK，本模块按旧 iOS 对齐，不新增腾讯 TRTC、RTMP 或其他推流 SDK 依赖。
 
 ## 代码结构
 
 - `LiveAPI`：封装 `/api/app/manual-live/...` 和 `/api/app/view-album/...` 接口。
 - `LiveManagementViewModel`：管理直播列表分页、创建、开始/暂停、结束和详情失败清理。
+- `LivePlaybackViewModel`：管理直播详情和直播相册视频的系统播放器 URL、播放、暂停和释放状态。
+- `LivePushReadinessViewModel`：诊断直播推流地址、相机/麦克风权限、网络状态和当前推流 SDK 接入状态，不触发本机采集推流。
 - `LiveAlbumViewModel`：管理直播相册日期筛选、分页和删除相册。
 - `LiveAlbumCreateViewModel`：管理本地图片/视频上传到 OSS 后创建直播相册。
 - `LiveAlbumPreviewViewModel`：进入相册预览时加载相册详情，并支持删除单个素材。
 
 ## 业务边界
 
-本模块不接入播放器或推流 SDK。直播详情展示推流地址、复制和控制能力；视频素材预览优先展示接口返回的封面，缺少封面时展示视频占位，并提供打开或复制原始 URL。
+直播详情会从 `play_url`、`pull_url`、`hls_url`、`live_url`、`flv_url` 中筛选系统播放器可处理的 http/https 播放地址；`push_url` 是给 OBS 或第三方工具使用的外部推流地址，不作为播放地址使用。只有 RTMP 推流地址时，页面展示封面、提示和复制入口。
+
+直播相册视频预览使用系统 `VideoPlayer` 播放可支持的视频地址；图片仍使用 `RemoteImage` 展示。视频地址不可播放时，页面保留打开和复制原始 URL 的操作。
+
+推流专项按旧 iOS 对齐，只保留诊断层和适配协议，默认 `UnsupportedLivePushAdapter` 明确提示未接入真推流 SDK；不引入腾讯/TRTC、Agora、HaishinKit、Zego 或 Android `youfun_control` 的飞控/抓娃娃直播接口。直播详情的“开始/暂停/结束”和“推流模式”只调用 `manual-live` 业务接口，不启动本机摄像头、麦克风或后台推流。
+
+后续若要接入真推流 SDK，可参考 Android `youfun_control` 中腾讯 TRTC 的实现路线，但需要单独确认后端房间参数、SDK 版本、真机权限、推流源和人工联调范围。
 
 直播封面创建沿用旧 iOS 的 URL 输入。直播相册素材通过 `PhotosPicker` 选择后，使用 `OSSUploadService.uploadAliveAlbumFile` 上传到 `live_albums/yyyyMMdd/scenicId/...`，再把最终 URL 提交给创建相册接口。

suixinkan/Features/Live/Models/LiveModels.swift

@@ -43,6 +43,11 @@ struct LiveEntity: Decodable, Identifiable, Equatable {
     let title: String
     let coverImg: String
     let pushUrl: String
+    let playUrl: String
+    let pullUrl: String
+    let hlsUrl: String
+    let flvUrl: String
+    let liveUrl: String
     let startTime: Int64
     let endTime: Int64
     let duration: Int64
@@ -57,6 +62,11 @@ struct LiveEntity: Decodable, Identifiable, Equatable {
         case title
         case coverImg = "cover_img"
         case pushUrl = "push_url"
+        case playUrl = "play_url"
+        case pullUrl = "pull_url"
+        case hlsUrl = "hls_url"
+        case flvUrl = "flv_url"
+        case liveUrl = "live_url"
         case startTime = "start_time"
         case endTime = "end_time"
         case duration
@@ -72,6 +82,11 @@ struct LiveEntity: Decodable, Identifiable, Equatable {
         title: String = "",
         coverImg: String = "",
         pushUrl: String = "",
+        playUrl: String = "",
+        pullUrl: String = "",
+        hlsUrl: String = "",
+        flvUrl: String = "",
+        liveUrl: String = "",
         startTime: Int64 = 0,
         endTime: Int64 = 0,
         duration: Int64 = 0,
@@ -85,6 +100,11 @@ struct LiveEntity: Decodable, Identifiable, Equatable {
         self.title = title
         self.coverImg = coverImg
         self.pushUrl = pushUrl
+        self.playUrl = playUrl
+        self.pullUrl = pullUrl
+        self.hlsUrl = hlsUrl
+        self.flvUrl = flvUrl
+        self.liveUrl = liveUrl
         self.startTime = startTime
         self.endTime = endTime
         self.duration = duration
@@ -101,6 +121,11 @@ struct LiveEntity: Decodable, Identifiable, Equatable {
         title = try container.liveDecodeLossyString(forKey: .title)
         coverImg = try container.liveDecodeLossyString(forKey: .coverImg)
         pushUrl = try container.liveDecodeLossyString(forKey: .pushUrl)
+        playUrl = try container.liveDecodeLossyString(forKey: .playUrl)
+        pullUrl = try container.liveDecodeLossyString(forKey: .pullUrl)
+        hlsUrl = try container.liveDecodeLossyString(forKey: .hlsUrl)
+        flvUrl = try container.liveDecodeLossyString(forKey: .flvUrl)
+        liveUrl = try container.liveDecodeLossyString(forKey: .liveUrl)
         startTime = Int64(try container.liveDecodeLossyInt(forKey: .startTime) ?? 0)
         endTime = Int64(try container.liveDecodeLossyInt(forKey: .endTime) ?? 0)
         duration = Int64(try container.liveDecodeLossyInt(forKey: .duration) ?? 0)
@@ -114,6 +139,10 @@ struct LiveEntity: Decodable, Identifiable, Equatable {
     var displayStatus: String {
         statusLabel.liveNonEmpty ?? "状态\(status)"
     }
+
+    var playbackURLCandidates: [String] {
+        [playUrl, pullUrl, hlsUrl, liveUrl, flvUrl]
+    }
 }
 
 /// 创建直播请求实体。

suixinkan/Features/Live/ViewModels/LivePlaybackViewModel.swift

@@ -0,0 +1,132 @@
+//
+//  LivePlaybackViewModel.swift
+//  suixinkan
+//
+//  Created by Codex on 2026/6/25.
+//
+
+import AVFoundation
+import Foundation
+import Observation
+
+/// 直播播放地址解析器，避免把 RTMP 推流地址误当作播放地址。
+enum LivePlaybackURLResolver {
+    static func playableURL(from live: LiveEntity) -> URL? {
+        playableURL(from: live.playbackURLCandidates)
+    }
+
+    static func playableURL(from candidates: [String]) -> URL? {
+        for candidate in candidates {
+            if let url = playableURL(from: candidate) {
+                return url
+            }
+        }
+        return nil
+    }
+
+    static func playableURL(from rawValue: String) -> URL? {
+        let value = rawValue.liveTrimmed
+        guard !value.isEmpty, let url = URL(string: value) else { return nil }
+        guard let scheme = url.scheme?.lowercased(), scheme == "http" || scheme == "https" else { return nil }
+        if url.pathExtension.lowercased() == "flv" {
+            return nil
+        }
+        return url
+    }
+}
+
+/// 播放器状态。
+enum LivePlaybackState: Equatable {
+    case empty
+    case ready(URL)
+    case playing(URL)
+    case failed(String)
+}
+
+@MainActor
+@Observable
+/// 直播播放器 ViewModel，管理系统播放器的 URL、播放和释放状态。
+final class LivePlaybackViewModel {
+    var state: LivePlaybackState = .empty
+    var errorMessage: String?
+
+    @ObservationIgnored private(set) var player: AVPlayer?
+
+    var playableURL: URL? {
+        switch state {
+        case .ready(let url), .playing(let url):
+            url
+        case .empty, .failed:
+            nil
+        }
+    }
+
+    var isPlaying: Bool {
+        if case .playing = state { return true }
+        return false
+    }
+
+    init(live: LiveEntity? = nil, urlString: String? = nil) {
+        if let live {
+            load(live: live)
+        } else if let urlString {
+            load(urlString: urlString)
+        }
+    }
+
+    func load(live: LiveEntity) {
+        load(url: LivePlaybackURLResolver.playableURL(from: live))
+    }
+
+    func load(urlString: String) {
+        load(url: LivePlaybackURLResolver.playableURL(from: urlString))
+    }
+
+    func play() {
+        guard let url = playableURL else { return }
+        if player == nil {
+            player = AVPlayer(url: url)
+        }
+        player?.play()
+        state = .playing(url)
+    }
+
+    func pause() {
+        guard let url = playableURL else { return }
+        player?.pause()
+        state = .ready(url)
+    }
+
+    func reload() {
+        guard let url = playableURL else { return }
+        releasePlayer()
+        player = AVPlayer(url: url)
+        state = .ready(url)
+    }
+
+    func release() {
+        releasePlayer()
+        if let url = playableURL {
+            state = .ready(url)
+        } else {
+            state = .empty
+        }
+    }
+
+    private func load(url: URL?) {
+        releasePlayer()
+        guard let url else {
+            errorMessage = "暂无可播放地址"
+            state = .empty
+            return
+        }
+        errorMessage = nil
+        player = AVPlayer(url: url)
+        state = .ready(url)
+    }
+
+    private func releasePlayer() {
+        player?.pause()
+        player = nil
+    }
+}

suixinkan/Features/Live/ViewModels/LivePushReadinessViewModel.swift

@@ -0,0 +1,290 @@
+//
+//  LivePushReadinessViewModel.swift
+//  suixinkan
+//
+//  Created by Codex on 2026/6/25.
+//
+
+import AVFoundation
+import Foundation
+import Network
+import Observation
+
+/// 直播推流权限状态。
+enum LivePushPermissionState: Equatable {
+    case unknown
+    case granted
+    case denied
+
+    var displayText: String {
+        switch self {
+        case .unknown: "未检查"
+        case .granted: "已授权"
+        case .denied: "未授权"
+        }
+    }
+}
+
+/// 直播推流网络状态。
+enum LivePushNetworkState: Equatable {
+    case unknown
+    case unavailable
+    case wifi
+    case cellular
+    case other
+
+    var displayText: String {
+        switch self {
+        case .unknown: "检测中"
+        case .unavailable: "网络不可用"
+        case .wifi: "Wi-Fi"
+        case .cellular: "蜂窝网络"
+        case .other: "其他网络"
+        }
+    }
+}
+
+/// 推流 SDK 适配协议。后续接入真实 RTMP/RTC SDK 时替换默认实现。
+protocol LivePushAdapter {
+    var name: String { get }
+    var isAvailable: Bool { get }
+    func prepare(pushURL: URL) async throws
+    func start() async throws
+    func stop() async throws
+    func dispose() async
+}
+
+/// 权限提供者协议，隔离 AVFoundation 便于测试。
+protocol LivePermissionProviding {
+    func cameraPermission() async -> LivePushPermissionState
+    func microphonePermission() async -> LivePushPermissionState
+}
+
+/// 网络监听协议，隔离 NWPathMonitor 便于测试。
+protocol LiveNetworkMonitoring: AnyObject {
+    var currentState: LivePushNetworkState { get }
+    func start(_ onChange: @escaping @Sendable (LivePushNetworkState) -> Void)
+    func stop()
+}
+
+enum LivePushReadinessError: LocalizedError, Equatable {
+    case missingPushURL
+    case invalidPushURL
+    case permissionDenied
+    case networkUnavailable
+    case sdkUnavailable
+
+    var errorDescription: String? {
+        switch self {
+        case .missingPushURL:
+            "暂无推流地址"
+        case .invalidPushURL:
+            "推流地址格式无效"
+        case .permissionDenied:
+            "请先开启相机和麦克风权限"
+        case .networkUnavailable:
+            "当前网络不可用"
+        case .sdkUnavailable:
+            "当前版本未接入真推流 SDK"
+        }
+    }
+}
+
+struct UnsupportedLivePushAdapter: LivePushAdapter {
+    let name = "未接入推流 SDK"
+    let isAvailable = false
+
+    func prepare(pushURL: URL) async throws {
+        throw LivePushReadinessError.sdkUnavailable
+    }
+
+    func start() async throws {
+        throw LivePushReadinessError.sdkUnavailable
+    }
+
+    func stop() async throws {}
+
+    func dispose() async {}
+}
+
+struct SystemLivePermissionProvider: LivePermissionProviding {
+    func cameraPermission() async -> LivePushPermissionState {
+        await permission(for: .video)
+    }
+
+    func microphonePermission() async -> LivePushPermissionState {
+        await permission(for: .audio)
+    }
+
+    private func permission(for mediaType: AVMediaType) async -> LivePushPermissionState {
+        switch AVCaptureDevice.authorizationStatus(for: mediaType) {
+        case .authorized:
+            return .granted
+        case .notDetermined:
+            let granted = await AVCaptureDevice.requestAccess(for: mediaType)
+            return granted ? .granted : .denied
+        case .denied, .restricted:
+            return .denied
+        @unknown default:
+            return .denied
+        }
+    }
+}
+
+final class SystemLiveNetworkMonitor: LiveNetworkMonitoring {
+    private let monitor = NWPathMonitor()
+    private let queue = DispatchQueue(label: "com.suixinkan.live.network")
+    private(set) var currentState: LivePushNetworkState = .unknown
+
+    func start(_ onChange: @escaping @Sendable (LivePushNetworkState) -> Void) {
+        monitor.pathUpdateHandler = { [weak self] path in
+            let state = Self.state(from: path)
+            self?.currentState = state
+            onChange(state)
+        }
+        monitor.start(queue: queue)
+    }
+
+    func stop() {
+        monitor.cancel()
+    }
+
+    private static func state(from path: NWPath) -> LivePushNetworkState {
+        guard path.status == .satisfied else { return .unavailable }
+        if path.usesInterfaceType(.wifi) { return .wifi }
+        if path.usesInterfaceType(.cellular) { return .cellular }
+        return .other
+    }
+}
+
+@MainActor
+@Observable
+/// 推流准备 ViewModel，检查权限、网络和默认 SDK 可用性。
+final class LivePushReadinessViewModel {
+    var cameraPermission: LivePushPermissionState = .unknown
+    var microphonePermission: LivePushPermissionState = .unknown
+    var networkState: LivePushNetworkState = .unknown
+    var prepared = false
+    var running = false
+    var errorMessage: String?
+
+    let adapterName: String
+    let sdkStatusText: String
+
+    @ObservationIgnored private let permissionProvider: any LivePermissionProviding
+    @ObservationIgnored private let networkMonitor: any LiveNetworkMonitoring
+    @ObservationIgnored private let adapter: any LivePushAdapter
+    @ObservationIgnored private var pushURL: URL?
+
+    init(
+        permissionProvider: any LivePermissionProviding = SystemLivePermissionProvider(),
+        networkMonitor: any LiveNetworkMonitoring = SystemLiveNetworkMonitor(),
+        adapter: any LivePushAdapter = UnsupportedLivePushAdapter()
+    ) {
+        self.permissionProvider = permissionProvider
+        self.networkMonitor = networkMonitor
+        self.adapter = adapter
+        self.adapterName = adapter.name
+        self.sdkStatusText = adapter.isAvailable ? "已接入" : "未接入真推流 SDK"
+        self.networkState = networkMonitor.currentState
+    }
+
+    func configure(pushURL rawValue: String) {
+        let value = rawValue.liveTrimmed
+        guard !value.isEmpty else {
+            pushURL = nil
+            errorMessage = LivePushReadinessError.missingPushURL.localizedDescription
+            return
+        }
+        guard let url = URL(string: value), url.scheme?.isEmpty == false else {
+            pushURL = nil
+            errorMessage = LivePushReadinessError.invalidPushURL.localizedDescription
+            return
+        }
+        pushURL = url
+        errorMessage = nil
+    }
+
+    func startMonitoring() {
+        networkState = networkMonitor.currentState
+        networkMonitor.start { [weak self] state in
+            Task { @MainActor in
+                self?.networkState = state
+            }
+        }
+    }
+
+    func stopMonitoring() {
+        networkMonitor.stop()
+    }
+
+    func refreshPermissions() async {
+        async let camera = permissionProvider.cameraPermission()
+        async let microphone = permissionProvider.microphonePermission()
+        cameraPermission = await camera
+        microphonePermission = await microphone
+    }
+
+    func runDiagnostics() throws {
+        do {
+            try validateReadiness()
+        } catch {
+            errorMessage = error.localizedDescription
+            throw error
+        }
+        guard adapter.isAvailable else {
+            errorMessage = LivePushReadinessError.sdkUnavailable.localizedDescription
+            throw LivePushReadinessError.sdkUnavailable
+        }
+        errorMessage = nil
+    }
+
+    func prepare() async throws {
+        try validateReadiness()
+        guard let pushURL else { throw LivePushReadinessError.missingPushURL }
+        do {
+            try await adapter.prepare(pushURL: pushURL)
+            prepared = true
+            errorMessage = nil
+        } catch {
+            errorMessage = error.localizedDescription
+            throw error
+        }
+    }
+
+    func startPush() async throws {
+        try validateReadiness()
+        guard adapter.isAvailable else {
+            errorMessage = LivePushReadinessError.sdkUnavailable.localizedDescription
+            throw LivePushReadinessError.sdkUnavailable
+        }
+        try await adapter.start()
+        running = true
+        prepared = true
+        errorMessage = nil
+    }
+
+    func stopPush() async {
+        try? await adapter.stop()
+        running = false
+    }
+
+    func dispose() async {
+        stopMonitoring()
+        await adapter.dispose()
+        running = false
+        prepared = false
+    }
+
+    private func validateReadiness() throws {
+        guard pushURL != nil else {
+            throw LivePushReadinessError.missingPushURL
+        }
+        guard cameraPermission != .denied, microphonePermission != .denied else {
+            throw LivePushReadinessError.permissionDenied
+        }
+        guard networkState != .unavailable else {
+            throw LivePushReadinessError.networkUnavailable
+        }
+    }
+}

suixinkan/Features/Live/Views/LiveAlbumViews.swift

@@ -5,6 +5,7 @@
 //  Created by Codex on 2026/6/25.
 //
 
+import AVKit
 import PhotosUI
 import SwiftUI
 import UniformTypeIdentifiers
@@ -459,13 +460,17 @@ struct LiveAlbumPreviewView: View {
 private struct LiveAlbumPreviewPage: View {
     let file: LiveAlbumFileItem
     @Environment(ToastCenter.self) private var toastCenter
+    @State private var playbackViewModel: LivePlaybackViewModel
+
+    init(file: LiveAlbumFileItem) {
+        self.file = file
+        _playbackViewModel = State(initialValue: LivePlaybackViewModel(urlString: file.url))
+    }
 
     var body: some View {
         VStack(spacing: AppMetrics.Spacing.medium) {
-            if file.isVideo && file.coverImg?.liveTrimmed.isEmpty != false {
-                Image(systemName: "play.circle.fill")
-                    .font(.system(size: 72, weight: .semibold))
-                    .foregroundStyle(.white)
+            if file.isVideo {
+                videoContent
             } else {
                 RemoteImage(urlString: file.previewURL, contentMode: .fit) {
                     ProgressView()
@@ -487,6 +492,33 @@ private struct LiveAlbumPreviewPage: View {
         .frame(maxWidth: .infinity, maxHeight: .infinity)
         .padding(AppMetrics.Spacing.medium)
         .background(Color.black)
+        .onDisappear {
+            playbackViewModel.release()
+        }
+    }
+
+    @ViewBuilder
+    private var videoContent: some View {
+        if let player = playbackViewModel.player, playbackViewModel.playableURL != nil {
+            VideoPlayer(player: player)
+                .aspectRatio(16.0 / 9.0, contentMode: .fit)
+                .frame(maxWidth: .infinity)
+                .clipShape(RoundedRectangle(cornerRadius: AppMetrics.CornerRadius.card))
+        } else if file.coverImg?.liveTrimmed.isEmpty == false {
+            RemoteImage(urlString: file.previewURL, contentMode: .fit) {
+                ProgressView()
+                    .tint(.white)
+            }
+        } else {
+            VStack(spacing: AppMetrics.Spacing.small) {
+                Image(systemName: "play.slash.fill")
+                    .font(.system(size: 62, weight: .semibold))
+                    .foregroundStyle(.white)
+                Text("当前视频地址暂不可播放")
+                    .font(.system(size: AppMetrics.FontSize.subheadline, weight: .semibold))
+                    .foregroundStyle(.white)
+            }
+        }
     }
 }
 

suixinkan/Features/Live/Views/LiveManagementViews.swift

@@ -5,6 +5,7 @@
 //  Created by Codex on 2026/6/25.
 //
 
+import AVKit
 import SwiftUI
 
 /// 直播管理首页，展示直播列表和控制入口。
@@ -354,11 +355,14 @@ struct LiveDetailView: View {
     @Environment(ToastCenter.self) private var toastCenter
     @Environment(\.globalLoading) private var globalLoading
     @State private var viewModel: LiveDetailViewModel
+    @State private var playbackViewModel: LivePlaybackViewModel
+    @State private var pushReadinessViewModel = LivePushReadinessViewModel()
     @State private var copied = false
     let onChanged: () -> Void
 
     init(initialDetail: LiveEntity, onChanged: @escaping () -> Void) {
         _viewModel = State(initialValue: LiveDetailViewModel(detail: initialDetail))
+        _playbackViewModel = State(initialValue: LivePlaybackViewModel(live: initialDetail))
         self.onChanged = onChanged
     }
 
@@ -366,10 +370,11 @@ struct LiveDetailView: View {
         VStack(spacing: 0) {
             ScrollView {
                 VStack(spacing: AppMetrics.Spacing.medium) {
-                    coverSection
+                    playbackSection
                     infoSection
                     pushURLSection
                     pushModeSection
+                    pushReadinessSection
                     Spacer(minLength: 80)
                 }
                 .padding(AppMetrics.Spacing.pageHorizontal)
@@ -387,18 +392,32 @@ struct LiveDetailView: View {
                 .disabled(viewModel.loading || viewModel.actionInFlight)
             }
         }
-        .task { await refresh(showLoading: false) }
+        .task {
+            pushReadinessViewModel.configure(pushURL: viewModel.detail.pushUrl)
+            pushReadinessViewModel.startMonitoring()
+            await pushReadinessViewModel.refreshPermissions()
+            await refresh(showLoading: false)
+        }
+        .onDisappear {
+            playbackViewModel.release()
+            Task { await pushReadinessViewModel.dispose() }
+        }
     }
 
-    private var coverSection: some View {
+    private var playbackSection: some View {
         ZStack(alignment: .bottomLeading) {
-            RemoteImage(urlString: viewModel.detail.coverImg, contentMode: .fill) {
-                LinearGradient(colors: [Color(hex: 0x0F274A), AppDesign.primary], startPoint: .topLeading, endPoint: .bottomTrailing)
-                    .overlay {
-                        Image(systemName: "dot.radiowaves.left.and.right")
-                            .font(.system(size: 42, weight: .semibold))
-                            .foregroundStyle(.white.opacity(0.72))
-                    }
+            if let player = playbackViewModel.player, playbackViewModel.playableURL != nil {
+                VideoPlayer(player: player)
+                    .background(Color.black)
+            } else {
+                RemoteImage(urlString: viewModel.detail.coverImg, contentMode: .fill) {
+                    LinearGradient(colors: [Color(hex: 0x0F274A), AppDesign.primary], startPoint: .topLeading, endPoint: .bottomTrailing)
+                        .overlay {
+                            Image(systemName: "dot.radiowaves.left.and.right")
+                                .font(.system(size: 42, weight: .semibold))
+                                .foregroundStyle(.white.opacity(0.72))
+                        }
+                }
             }
             VStack(alignment: .leading, spacing: AppMetrics.Spacing.small) {
                 Text(viewModel.detail.displayStatus)
@@ -411,6 +430,32 @@ struct LiveDetailView: View {
                     .font(.system(size: AppMetrics.FontSize.title, weight: .bold))
                     .foregroundStyle(.white)
                     .lineLimit(2)
+                Text(playbackHint)
+                    .font(.system(size: AppMetrics.FontSize.caption, weight: .medium))
+                    .foregroundStyle(.white.opacity(0.86))
+                    .lineLimit(2)
+                HStack(spacing: AppMetrics.Spacing.small) {
+                    if playbackViewModel.playableURL != nil {
+                        Button {
+                            playbackViewModel.isPlaying ? playbackViewModel.pause() : playbackViewModel.play()
+                        } label: {
+                            Label(playbackViewModel.isPlaying ? "暂停" : "播放", systemImage: playbackViewModel.isPlaying ? "pause.fill" : "play.fill")
+                        }
+                        Button {
+                            playbackViewModel.reload()
+                        } label: {
+                            Label("重载", systemImage: "arrow.clockwise")
+                        }
+                    }
+                    if let url = playbackViewModel.playableURL {
+                        Link(destination: url) {
+                            Label("打开", systemImage: "safari")
+                        }
+                    }
+                }
+                .font(.system(size: AppMetrics.FontSize.caption, weight: .semibold))
+                .buttonStyle(.borderedProminent)
+                .tint(.white.opacity(0.22))
             }
             .padding(AppMetrics.Spacing.medium)
             .frame(maxWidth: .infinity, alignment: .leading)
@@ -420,6 +465,16 @@ struct LiveDetailView: View {
         .clipShape(RoundedRectangle(cornerRadius: AppMetrics.CornerRadius.card))
     }
 
+    private var playbackHint: String {
+        if playbackViewModel.playableURL != nil {
+            return "已检测到可播放地址"
+        }
+        if viewModel.detail.pushUrl.liveTrimmed.lowercased().hasPrefix("rtmp://") {
+            return "当前仅有 RTMP 推流地址，系统播放器不可直接播放"
+        }
+        return "暂无可播放直播地址"
+    }
+
     private var infoSection: some View {
         liveDetailCard("直播信息") {
             LiveInfoRow(title: "标题", value: viewModel.detail.title.liveNonEmpty ?? "--")
@@ -431,6 +486,9 @@ struct LiveDetailView: View {
 
     private var pushURLSection: some View {
         liveDetailCard("推流地址") {
+            Text("该地址用于 OBS 或第三方推流工具；当前版本不在 App 内采集摄像头/麦克风并推流。")
+                .font(.system(size: AppMetrics.FontSize.caption))
+                .foregroundStyle(AppDesign.textSecondary)
             Text(viewModel.detail.pushUrl.liveNonEmpty ?? "--")
                 .font(.system(size: AppMetrics.FontSize.subheadline))
                 .textSelection(.enabled)
@@ -458,6 +516,40 @@ struct LiveDetailView: View {
         }
     }
 
+    private var pushReadinessSection: some View {
+        liveDetailCard("推流诊断") {
+            LiveInfoRow(title: "相机权限", value: pushReadinessViewModel.cameraPermission.displayText)
+            LiveInfoRow(title: "麦克风权限", value: pushReadinessViewModel.microphonePermission.displayText)
+            LiveInfoRow(title: "网络状态", value: pushReadinessViewModel.networkState.displayText)
+            LiveInfoRow(title: "推流 SDK", value: pushReadinessViewModel.adapterName)
+            LiveInfoRow(title: "SDK 状态", value: pushReadinessViewModel.sdkStatusText)
+            Text("此处仅做权限、网络和 SDK 接入状态诊断；开始、暂停、结束仍只控制 manual-live 业务状态。")
+                .font(.system(size: AppMetrics.FontSize.caption))
+                .foregroundStyle(AppDesign.textSecondary)
+            if let message = pushReadinessViewModel.errorMessage {
+                Text(message)
+                    .font(.system(size: AppMetrics.FontSize.caption))
+                    .foregroundStyle(Color(hex: 0xEF4444))
+            }
+            HStack(spacing: AppMetrics.Spacing.small) {
+                Button {
+                    Task { await pushReadinessViewModel.refreshPermissions() }
+                } label: {
+                    Label("重新检查", systemImage: "checkmark.shield")
+                        .frame(maxWidth: .infinity)
+                }
+                .buttonStyle(.bordered)
+                Button {
+                    diagnosePush()
+                } label: {
+                    Label("检查 SDK", systemImage: "antenna.radiowaves.left.and.right")
+                        .frame(maxWidth: .infinity)
+                }
+                .buttonStyle(.borderedProminent)
+            }
+        }
+    }
+
     private var bottomBar: some View {
         HStack(spacing: AppMetrics.Spacing.medium) {
             Button {
@@ -523,6 +615,7 @@ struct LiveDetailView: View {
         await globalLoading.withOptionalLoading(showLoading) {
             await viewModel.refresh(api: liveAPI, showLoading: false)
         }
+        syncMediaState()
         if let message = viewModel.errorMessage {
             toastCenter.show(message)
         }
@@ -554,6 +647,21 @@ struct LiveDetailView: View {
             toastCenter.show(error.localizedDescription)
         }
     }
+
+    private func diagnosePush() {
+        pushReadinessViewModel.configure(pushURL: viewModel.detail.pushUrl)
+        do {
+            try pushReadinessViewModel.runDiagnostics()
+            toastCenter.show("推流诊断通过")
+        } catch {
+            toastCenter.show(error.localizedDescription)
+        }
+    }
+
+    private func syncMediaState() {
+        playbackViewModel.load(live: viewModel.detail)
+        pushReadinessViewModel.configure(pushURL: viewModel.detail.pushUrl)
+    }
 }
 
 private struct LiveInfoRow: View {

suixinkan/Features/OperatingArea/API/OperatingAreaAPI.swift

@@ -0,0 +1,52 @@
+//
+//  OperatingAreaAPI.swift
+//  suixinkan
+//
+//  Created by Codex on 2026/6/25.
+//
+
+import Foundation
+import Observation
+
+/// 运营区域服务协议，定义店铺和景区管理员两类围栏数据接口。
+@MainActor
+protocol OperatingAreaServing {
+    func storeBusinessArea(storeId: Int) async throws -> ListPayload<OperatingAreaItem>
+    func scenicAdminBusinessArea(scenicId: Int) async throws -> ListPayload<OperatingAreaItem>
+}
+
+@MainActor
+@Observable
+/// 运营区域 API，封装运营区域只读围栏接口。
+final class OperatingAreaAPI {
+    @ObservationIgnored private let client: APIClient
+
+    /// 初始化运营区域 API，并注入共享网络客户端。
+    init(client: APIClient) {
+        self.client = client
+    }
+
+    /// 获取当前店铺的运营区域围栏。
+    func storeBusinessArea(storeId: Int) async throws -> ListPayload<OperatingAreaItem> {
+        try await client.send(
+            APIRequest(
+                method: .get,
+                path: "/api/app/store/business-area",
+                queryItems: [URLQueryItem(name: "store_id", value: String(storeId))]
+            )
+        )
+    }
+
+    /// 获取景区管理员视角下的运营区域围栏。
+    func scenicAdminBusinessArea(scenicId: Int) async throws -> ListPayload<OperatingAreaItem> {
+        try await client.send(
+            APIRequest(
+                method: .get,
+                path: "/api/app/scenic-admin/business-area",
+                queryItems: [URLQueryItem(name: "scenic_id", value: String(scenicId))]
+            )
+        )
+    }
+}
+
+extension OperatingAreaAPI: OperatingAreaServing {}

suixinkan/Features/OperatingArea/Models/OperatingAreaModels.swift

@@ -0,0 +1,374 @@
+//
+//  OperatingAreaModels.swift
+//  suixinkan
+//
+//  Created by Codex on 2026/6/25.
+//
+
+import Foundation
+
+/// 运营区域入口模式，区分店铺管理员与景区管理员两条接口链路。
+enum OperatingAreaEntryMode: Equatable {
+    case storeAdmin(storeId: Int)
+    case scenicAdmin(scenicId: Int)
+
+    var title: String {
+        switch self {
+        case .storeAdmin:
+            "店铺运营区域"
+        case .scenicAdmin:
+            "景区运营区域"
+        }
+    }
+}
+
+/// 运营区域接口单项，表示一个门店或区域围栏。
+struct OperatingAreaItem: Decodable, Equatable, Identifiable {
+    let id: Int
+    let name: String
+    let businessMapArea: OperatingMapArea?
+    let statusText: String
+    let typeText: String
+    let auditStatusText: String
+
+    enum CodingKeys: String, CodingKey {
+        case id
+        case name
+        case businessMapArea = "business_map_area"
+        case statusText = "status_text"
+        case typeText = "type_text"
+        case auditStatusText = "audit_status_text"
+    }
+
+    init(
+        id: Int = 0,
+        name: String = "",
+        businessMapArea: OperatingMapArea? = nil,
+        statusText: String = "",
+        typeText: String = "",
+        auditStatusText: String = ""
+    ) {
+        self.id = id
+        self.name = name
+        self.businessMapArea = businessMapArea
+        self.statusText = statusText
+        self.typeText = typeText
+        self.auditStatusText = auditStatusText
+    }
+
+    init(from decoder: Decoder) throws {
+        let container = try decoder.container(keyedBy: CodingKeys.self)
+        id = try container.operatingDecodeLossyInt(forKey: .id) ?? 0
+        name = try container.operatingDecodeLossyString(forKey: .name)
+        businessMapArea = try container.decodeIfPresent(OperatingMapArea.self, forKey: .businessMapArea)
+        statusText = try container.operatingDecodeLossyString(forKey: .statusText)
+        typeText = try container.operatingDecodeLossyString(forKey: .typeText)
+        auditStatusText = try container.operatingDecodeLossyString(forKey: .auditStatusText)
+    }
+}
+
+/// 运营区域原始 JSON 值，用于保留并解析后端不稳定的 `business_map_area`。
+enum OperatingMapArea: Decodable, Equatable {
+    case null
+    case bool(Bool)
+    case number(Double)
+    case string(String)
+    case array([OperatingMapArea])
+    case object([String: OperatingMapArea])
+
+    init(from decoder: Decoder) throws {
+        let container = try decoder.singleValueContainer()
+        if container.decodeNil() {
+            self = .null
+        } else if let value = try? container.decode(Bool.self) {
+            self = .bool(value)
+        } else if let value = try? container.decode(Double.self) {
+            self = .number(value)
+        } else if let value = try? container.decode(String.self) {
+            self = .string(value)
+        } else if let value = try? container.decode([OperatingMapArea].self) {
+            self = .array(value)
+        } else {
+            let keyed = try decoder.container(keyedBy: OperatingDynamicCodingKey.self)
+            var object: [String: OperatingMapArea] = [:]
+            for key in keyed.allKeys {
+                object[key.stringValue] = try keyed.decode(OperatingMapArea.self, forKey: key)
+            }
+            self = .object(object)
+        }
+    }
+
+    /// 将 JSON 字符串解析为运营区域 JSON 值。
+    static func parseString(_ text: String) -> OperatingMapArea? {
+        guard let data = text.data(using: .utf8),
+              let raw = try? JSONSerialization.jsonObject(with: data)
+        else { return nil }
+        return fromJSONObject(raw)
+    }
+
+    private static func fromJSONObject(_ value: Any) -> OperatingMapArea {
+        switch value {
+        case is NSNull:
+            return .null
+        case let value as Bool:
+            return .bool(value)
+        case let value as NSNumber:
+            return .number(value.doubleValue)
+        case let value as String:
+            return .string(value)
+        case let value as [Any]:
+            return .array(value.map(fromJSONObject))
+        case let value as [String: Any]:
+            return .object(value.mapValues(fromJSONObject))
+        default:
+            return .null
+        }
+    }
+}
+
+/// 运营区域地理坐标点。
+struct OperatingGeoPoint: Equatable, Hashable {
+    let latitude: Double
+    let longitude: Double
+}
+
+/// 运营区域围栏环，用于地图绘制和列表展示。
+struct OperatingFenceRing: Identifiable, Equatable {
+    let id: String
+    let itemId: Int
+    let regionName: String
+    let points: [OperatingGeoPoint]
+    let isCurrentStore: Bool
+
+    init(itemId: Int, regionName: String, points: [OperatingGeoPoint], isCurrentStore: Bool, ringIndex: Int) {
+        self.id = "\(itemId)-\(ringIndex)"
+        self.itemId = itemId
+        self.regionName = regionName
+        self.points = points
+        self.isCurrentStore = isCurrentStore
+    }
+}
+
+/// 运营区域阻断原因，用于缺少上下文或数据不可展示时给出稳定提示。
+enum OperatingAreaBlockReason: Equatable {
+    case missingStore
+    case missingScenic
+    case unsupportedRole
+    case emptyAreaList
+    case noParsableFenceData
+    case backendMessage(String)
+
+    var message: String {
+        switch self {
+        case .missingStore:
+            "请先选择店铺"
+        case .missingScenic:
+            "请先选择景区"
+        case .unsupportedRole:
+            "当前账号暂不支持运营区域"
+        case .emptyAreaList:
+            "当前景区无区域数据"
+        case .noParsableFenceData:
+            "有区域记录，但未解析出有效围栏，请检查坐标数据"
+        case .backendMessage(let message):
+            message.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty ? "运营区域加载失败" : message
+        }
+    }
+}
+
+/// 运营区域围栏解析器，兼容 GeoJSON、数组、字符串 JSON 和常见路径字段。
+enum OperatingAreaParser {
+    /// 将后端 `business_map_area` 解析为若干闭合多边形环。
+    static func parseToRings(_ area: OperatingMapArea?) -> [[OperatingGeoPoint]] {
+        guard let area else { return [] }
+        return parseElement(area)
+    }
+
+    private static func parseElement(_ value: OperatingMapArea) -> [[OperatingGeoPoint]] {
+        switch value {
+        case .null, .bool, .number:
+            return []
+        case .string(let text):
+            let trimmed = text.trimmingCharacters(in: .whitespacesAndNewlines)
+            guard !trimmed.isEmpty, let parsed = OperatingMapArea.parseString(trimmed) else { return [] }
+            return parseElement(parsed)
+        case .array(let array):
+            return parseArrayRoot(array)
+        case .object(let object):
+            return parseObject(object)
+        }
+    }
+
+    private static func parseObject(_ object: [String: OperatingMapArea]) -> [[OperatingGeoPoint]] {
+        let type: String?
+        if case let .string(rawType)? = object["type"] {
+            type = rawType.lowercased()
+        } else {
+            type = nil
+        }
+
+        switch type {
+        case "polygon":
+            guard case let .array(coordinates)? = object["coordinates"],
+                  case let .array(outer)? = coordinates.first
+            else { return [] }
+            return parseRing(outer).map { [$0] } ?? []
+        case "multipolygon":
+            guard case let .array(polygons)? = object["coordinates"] else { return [] }
+            return polygons.compactMap { polygon -> [OperatingGeoPoint]? in
+                guard case let .array(rings) = polygon,
+                      case let .array(firstRing)? = rings.first
+                else { return nil }
+                return parseRing(firstRing)
+            }
+        default:
+            for key in ["path", "paths", "points", "coordinates"] {
+                if let nested = object[key] {
+                    return parseElement(nested)
+                }
+            }
+            return []
+        }
+    }
+
+    private static func parseArrayRoot(_ array: [OperatingMapArea]) -> [[OperatingGeoPoint]] {
+        guard let first = array.first else { return [] }
+        switch first {
+        case .object:
+            return parseObjectRing(array).map { [$0] } ?? []
+        case .array(let nested):
+            guard let sample = nested.first else { return [] }
+            switch sample {
+            case .array(let pointCandidate):
+                if pointCandidate.count >= 2, pointCandidate[0].numberValue != nil, pointCandidate[1].numberValue != nil {
+                    return parseRing(nested).map { [$0] } ?? []
+                }
+                return array.compactMap { element -> [OperatingGeoPoint]? in
+                    guard case let .array(segment) = element else { return nil }
+                    return parseRing(segment)
+                }
+            case .object:
+                return parseObjectRing(nested).map { [$0] } ?? []
+            default:
+                return parseRing(nested).map { [$0] } ?? []
+            }
+        default:
+            return []
+        }
+    }
+
+    private static func parseObjectRing(_ array: [OperatingMapArea]) -> [OperatingGeoPoint]? {
+        let points = array.compactMap { element -> OperatingGeoPoint? in
+            guard case let .object(object) = element else { return nil }
+            return pointFromObject(object)
+        }
+        return points.count >= 3 ? points : nil
+    }
+
+    private static func parseRing(_ array: [OperatingMapArea]) -> [OperatingGeoPoint]? {
+        let points = array.compactMap { element -> OperatingGeoPoint? in
+            switch element {
+            case .array(let pair):
+                guard pair.count >= 2,
+                      let a = pair[0].numberValue,
+                      let b = pair[1].numberValue
+                else { return nil }
+                return normalizePair(a, b)
+            case .object(let object):
+                return pointFromObject(object)
+            default:
+                return nil
+            }
+        }
+        return points.count >= 3 ? points : nil
+    }
+
+    private static func pointFromObject(_ object: [String: OperatingMapArea]) -> OperatingGeoPoint? {
+        let lat = object["lat"]?.numberValue ?? object["latitude"]?.numberValue
+        let lng = object["lng"]?.numberValue ?? object["lon"]?.numberValue ?? object["longitude"]?.numberValue
+        guard let lat, let lng else { return nil }
+        return OperatingGeoPoint(latitude: lat, longitude: lng)
+    }
+
+    private static func normalizePair(_ a: Double, _ b: Double) -> OperatingGeoPoint {
+        if looksLikeLngLatPair(lng: a, lat: b) {
+            return OperatingGeoPoint(latitude: b, longitude: a)
+        }
+        if looksLikeLatLngPair(lat: a, lng: b) {
+            return OperatingGeoPoint(latitude: a, longitude: b)
+        }
+        if abs(a) > 90 {
+            return OperatingGeoPoint(latitude: b, longitude: a)
+        }
+        return OperatingGeoPoint(latitude: a, longitude: b)
+    }
+
+    private static func looksLikeLngLatPair(lng: Double, lat: Double) -> Bool {
+        (-90.0...90.0).contains(lat) && abs(lng) <= 180.0 && abs(lng) > abs(lat)
+    }
+
+    private static func looksLikeLatLngPair(lat: Double, lng: Double) -> Bool {
+        (-90.0...90.0).contains(lat) && abs(lng) <= 180.0 && abs(lat) <= abs(lng)
+    }
+}
+
+private struct OperatingDynamicCodingKey: CodingKey {
+    let stringValue: String
+    let intValue: Int?
+
+    init?(stringValue: String) {
+        self.stringValue = stringValue
+        intValue = nil
+    }
+
+    init?(intValue: Int) {
+        stringValue = String(intValue)
+        self.intValue = intValue
+    }
+}
+
+private extension OperatingMapArea {
+    var numberValue: Double? {
+        switch self {
+        case .number(let value):
+            return value
+        case .string(let text):
+            return Double(text.trimmingCharacters(in: .whitespacesAndNewlines))
+        default:
+            return nil
+        }
+    }
+}
+
+private extension KeyedDecodingContainer {
+    func operatingDecodeLossyString(forKey key: Key) throws -> String {
+        if let value = try? decodeIfPresent(String.self, forKey: key) {
+            return value
+        }
+        if let value = try? decodeIfPresent(Int.self, forKey: key) {
+            return String(value)
+        }
+        if let value = try? decodeIfPresent(Double.self, forKey: key) {
+            return String(value)
+        }
+        if let value = try? decodeIfPresent(Bool.self, forKey: key) {
+            return value ? "true" : "false"
+        }
+        return ""
+    }
+
+    func operatingDecodeLossyInt(forKey key: Key) throws -> Int? {
+        if let value = try? decodeIfPresent(Int.self, forKey: key) {
+            return value
+        }
+        if let value = try? decodeIfPresent(String.self, forKey: key) {
+            let text = value.trimmingCharacters(in: .whitespacesAndNewlines)
+            if let intValue = Int(text) { return intValue }
+            if let doubleValue = Double(text) { return Int(doubleValue) }
+        }
+        if let value = try? decodeIfPresent(Double.self, forKey: key) {
+            return Int(value)
+        }
+        return nil
+    }
+}

suixinkan/Features/OperatingArea/OperatingArea.md

@@ -0,0 +1,17 @@
+# OperatingArea 模块业务逻辑
+
+## 模块职责
+
+OperatingArea 负责首页 `operating-area` 入口的运营区域展示。模块按当前角色和业务上下文进入店铺管理员或景区管理员模式，读取后端围栏数据并只读展示。
+
+## 核心流程
+
+- `OperatingAreaView` 从环境读取 `AccountContext`、`PermissionContext` 和 `OperatingAreaAPI`。
+- `OperatingAreaViewModel` 根据角色名称和当前景区/门店解析入口模式。
+- 店铺管理员调用 `/api/app/store/business-area`，景区管理员调用 `/api/app/scenic-admin/business-area`。
+- `OperatingAreaParser` 解析 `business_map_area`，兼容 GeoJSON、坐标数组和字符串 JSON。
+- 真机构建启用高德地图时绘制 polygon；模拟器或未启用高德时展示坐标摘要兜底。
+
+## 边界
+
+本模块只展示已有区域和围栏，不提供新建、编辑、删除或绘制保存能力。缺少景区/门店、角色不支持、空列表和不可解析围栏都会进入明确空态或阻断提示。

suixinkan/Features/OperatingArea/ViewModels/OperatingAreaViewModel.swift

@@ -0,0 +1,154 @@
+//
+//  OperatingAreaViewModel.swift
+//  suixinkan
+//
+//  Created by Codex on 2026/6/25.
+//
+
+import Foundation
+import Observation
+
+@MainActor
+@Observable
+/// 运营区域 ViewModel，负责角色分流、围栏加载、解析和错误状态管理。
+final class OperatingAreaViewModel {
+    private(set) var mode: OperatingAreaEntryMode?
+    private(set) var loading = false
+    private(set) var items: [OperatingAreaItem] = []
+    private(set) var fenceRings: [OperatingFenceRing] = []
+    private(set) var blockReason: OperatingAreaBlockReason?
+    private(set) var errorMessage: String?
+
+    /// 按当前账号和角色刷新运营区域。
+    func reload(
+        api: any OperatingAreaServing,
+        accountContext: AccountContext,
+        permissionContext: PermissionContext
+    ) async {
+        guard !loading else { return }
+        guard let nextMode = resolveMode(accountContext: accountContext, permissionContext: permissionContext) else {
+            return
+        }
+
+        mode = nextMode
+        loading = true
+        errorMessage = nil
+        blockReason = nil
+        defer { loading = false }
+
+        do {
+            let response: ListPayload<OperatingAreaItem>
+            switch nextMode {
+            case .storeAdmin(let storeId):
+                response = try await api.storeBusinessArea(storeId: storeId)
+            case .scenicAdmin(let scenicId):
+                response = try await api.scenicAdminBusinessArea(scenicId: scenicId)
+            }
+            apply(items: response.list, mode: nextMode)
+        } catch {
+            resetLoadedData()
+            let message = error.localizedDescription
+            errorMessage = message
+            blockReason = .backendMessage(message)
+        }
+    }
+
+    /// 根据当前上下文解析运营区域入口模式。
+    @discardableResult
+    func resolveMode(accountContext: AccountContext, permissionContext: PermissionContext) -> OperatingAreaEntryMode? {
+        let roleName = permissionContext.currentRole?.name.trimmingCharacters(in: .whitespacesAndNewlines) ?? ""
+        let lowercaseRoleName = roleName.lowercased()
+        let isStoreRole = roleName.contains("店铺") || roleName.contains("门店") || lowercaseRoleName.contains("store")
+        let isScenicRole = roleName.contains("景区") || lowercaseRoleName.contains("scenic")
+
+        if isStoreRole {
+            guard let storeId = accountContext.currentStore?.id, storeId > 0 else {
+                setBlocked(.missingStore)
+                return nil
+            }
+            mode = .storeAdmin(storeId: storeId)
+            blockReason = nil
+            return mode
+        }
+
+        if isScenicRole {
+            guard let scenicId = accountContext.currentScenic?.id, scenicId > 0 else {
+                setBlocked(.missingScenic)
+                return nil
+            }
+            mode = .scenicAdmin(scenicId: scenicId)
+            blockReason = nil
+            return mode
+        }
+
+        if let storeId = accountContext.currentStore?.id, storeId > 0 {
+            mode = .storeAdmin(storeId: storeId)
+            blockReason = nil
+            return mode
+        }
+
+        if let scenicId = accountContext.currentScenic?.id, scenicId > 0 {
+            mode = .scenicAdmin(scenicId: scenicId)
+            blockReason = nil
+            return mode
+        }
+
+        setBlocked(.unsupportedRole)
+        return nil
+    }
+
+    /// 根据状态生成统计展示。
+    var summary: (areaCount: Int, fenceCount: Int, currentStoreFenceCount: Int) {
+        (
+            areaCount: items.count,
+            fenceCount: fenceRings.count,
+            currentStoreFenceCount: fenceRings.filter(\.isCurrentStore).count
+        )
+    }
+
+    /// 当前页面标题。
+    var title: String {
+        mode?.title ?? "运营区域"
+    }
+
+    private func apply(items: [OperatingAreaItem], mode: OperatingAreaEntryMode) {
+        self.items = items
+        if items.isEmpty {
+            fenceRings = []
+            blockReason = .emptyAreaList
+            return
+        }
+
+        let currentStoreId: Int? = {
+            guard case .storeAdmin(let storeId) = mode else { return nil }
+            return storeId
+        }()
+
+        let parsed = items.flatMap { item -> [OperatingFenceRing] in
+            OperatingAreaParser.parseToRings(item.businessMapArea).enumerated().compactMap { index, points in
+                guard points.count >= 3 else { return nil }
+                return OperatingFenceRing(
+                    itemId: item.id,
+                    regionName: item.name,
+                    points: points,
+                    isCurrentStore: currentStoreId == item.id,
+                    ringIndex: index
+                )
+            }
+        }
+        fenceRings = parsed
+        blockReason = parsed.isEmpty ? .noParsableFenceData : nil
+    }
+
+    private func setBlocked(_ reason: OperatingAreaBlockReason) {
+        resetLoadedData()
+        blockReason = reason
+        errorMessage = nil
+        loading = false
+    }
+
+    private func resetLoadedData() {
+        items = []
+        fenceRings = []
+    }
+}

suixinkan/Features/OperatingArea/Views/OperatingAreaViews.swift

@@ -0,0 +1,390 @@
+//
+//  OperatingAreaViews.swift
+//  suixinkan
+//
+//  Created by Codex on 2026/6/25.
+//
+
+import CoreLocation
+import SwiftUI
+
+#if AMAP_ENABLED
+import MAMapKit
+#endif
+
+/// 运营区域首页，按当前角色展示店铺或景区运营围栏。
+struct OperatingAreaView: View {
+    @Environment(AccountContext.self) private var accountContext
+    @Environment(PermissionContext.self) private var permissionContext
+    @Environment(OperatingAreaAPI.self) private var operatingAreaAPI
+    @Environment(ToastCenter.self) private var toastCenter
+    @Environment(\.globalLoading) private var globalLoading
+
+    @State private var viewModel = OperatingAreaViewModel()
+
+    var body: some View {
+        ScrollView {
+            VStack(spacing: AppMetrics.Spacing.medium) {
+                summarySection
+                mapSection
+                areaListSection
+            }
+            .padding(AppMetrics.Spacing.pageHorizontal)
+            .padding(.vertical, AppMetrics.Spacing.medium)
+        }
+        .background(Color(hex: 0xF5F7FA))
+        .navigationTitle("运营区域")
+        .navigationBarTitleDisplayMode(.inline)
+        .refreshable { await reload(showLoading: false) }
+        .task(id: taskID) {
+            await reload(showLoading: viewModel.items.isEmpty)
+        }
+    }
+
+    private var taskID: String {
+        "\(permissionContext.currentRole?.id ?? 0)-\(accountContext.currentScenic?.id ?? 0)-\(accountContext.currentStore?.id ?? 0)"
+    }
+
+    private var summarySection: some View {
+        VStack(alignment: .leading, spacing: AppMetrics.Spacing.medium) {
+            HStack {
+                VStack(alignment: .leading, spacing: 4) {
+                    Text(viewModel.title)
+                        .font(.system(size: AppMetrics.FontSize.title3, weight: .semibold))
+                        .foregroundStyle(AppDesign.textPrimary)
+                    Text(scopeText)
+                        .font(.system(size: AppMetrics.FontSize.caption))
+                        .foregroundStyle(AppDesign.textSecondary)
+                }
+                Spacer()
+                Image(systemName: "map.fill")
+                    .font(.system(size: 22, weight: .semibold))
+                    .foregroundStyle(AppDesign.primary)
+                    .frame(width: 42, height: 42)
+                    .background(AppDesign.primarySoft, in: RoundedRectangle(cornerRadius: 8))
+            }
+
+            HStack(spacing: AppMetrics.Spacing.small) {
+                OperatingAreaSummaryCard(title: "区域记录", value: "\(viewModel.summary.areaCount)", tint: AppDesign.primary)
+                OperatingAreaSummaryCard(title: "有效围栏", value: "\(viewModel.summary.fenceCount)", tint: AppDesign.success)
+                OperatingAreaSummaryCard(title: "当前门店", value: "\(viewModel.summary.currentStoreFenceCount)", tint: AppDesign.warning)
+            }
+        }
+        .padding(AppMetrics.Spacing.medium)
+        .background(.white, in: RoundedRectangle(cornerRadius: 8))
+    }
+
+    private var mapSection: some View {
+        VStack(alignment: .leading, spacing: AppMetrics.Spacing.small) {
+            HStack {
+                Text("围栏地图")
+                    .font(.system(size: AppMetrics.FontSize.body, weight: .semibold))
+                    .foregroundStyle(AppDesign.textPrimary)
+                Spacer()
+                Text(mapLegendText)
+                    .font(.system(size: AppMetrics.FontSize.caption))
+                    .foregroundStyle(AppDesign.textSecondary)
+            }
+
+            if let reason = viewModel.blockReason {
+                ContentUnavailableView(reason.message, systemImage: "mappin.slash")
+                    .frame(maxWidth: .infinity, minHeight: 260)
+                    .background(Color(hex: 0xF8FAFC), in: RoundedRectangle(cornerRadius: 8))
+                    .overlay(alignment: .bottom) {
+                        if shouldShowRetry(for: reason) {
+                            Button("重新加载") {
+                                Task { await reload(showLoading: true) }
+                            }
+                            .buttonStyle(.borderedProminent)
+                            .padding(.bottom, AppMetrics.Spacing.medium)
+                        }
+                    }
+            } else {
+                OperatingAreaMapView(rings: viewModel.fenceRings)
+                    .frame(height: 320)
+                    .clipShape(RoundedRectangle(cornerRadius: 8))
+            }
+        }
+        .padding(AppMetrics.Spacing.medium)
+        .background(.white, in: RoundedRectangle(cornerRadius: 8))
+    }
+
+    private var areaListSection: some View {
+        VStack(alignment: .leading, spacing: AppMetrics.Spacing.small) {
+            Text("区域列表")
+                .font(.system(size: AppMetrics.FontSize.body, weight: .semibold))
+                .foregroundStyle(AppDesign.textPrimary)
+
+            if viewModel.items.isEmpty {
+                Text(viewModel.blockReason?.message ?? "暂无运营区域")
+                    .font(.system(size: AppMetrics.FontSize.subheadline))
+                    .foregroundStyle(AppDesign.textSecondary)
+                    .frame(maxWidth: .infinity, minHeight: 88)
+                    .background(Color(hex: 0xF8FAFC), in: RoundedRectangle(cornerRadius: 8))
+            } else {
+                ForEach(viewModel.items) { item in
+                    let ringCount = viewModel.fenceRings.filter { $0.itemId == item.id }.count
+                    OperatingAreaItemRow(item: item, ringCount: ringCount, isCurrentStore: isCurrentStore(item))
+                }
+            }
+        }
+        .padding(AppMetrics.Spacing.medium)
+        .background(.white, in: RoundedRectangle(cornerRadius: 8))
+    }
+
+    private var scopeText: String {
+        switch viewModel.mode {
+        case .storeAdmin:
+            return accountContext.currentStore?.name ?? "当前店铺"
+        case .scenicAdmin:
+            return accountContext.currentScenic?.name ?? "当前景区"
+        case nil:
+            return accountContext.currentScenic?.name ?? accountContext.currentStore?.name ?? "未选择业务范围"
+        }
+    }
+
+    private var mapLegendText: String {
+        switch viewModel.mode {
+        case .storeAdmin:
+            "红色为当前门店"
+        case .scenicAdmin:
+            "景区全部围栏"
+        case nil:
+            "只读展示"
+        }
+    }
+
+    private func reload(showLoading: Bool) async {
+        await globalLoading.withOptionalLoading(showLoading) {
+            await viewModel.reload(api: operatingAreaAPI, accountContext: accountContext, permissionContext: permissionContext)
+        }
+        if let message = viewModel.errorMessage {
+            toastCenter.show(message)
+        }
+    }
+
+    private func isCurrentStore(_ item: OperatingAreaItem) -> Bool {
+        guard case .storeAdmin(let storeId)? = viewModel.mode else { return false }
+        return item.id == storeId
+    }
+
+    private func shouldShowRetry(for reason: OperatingAreaBlockReason) -> Bool {
+        if case .backendMessage = reason {
+            return true
+        }
+        return false
+    }
+}
+
+private struct OperatingAreaSummaryCard: View {
+    let title: String
+    let value: String
+    let tint: Color
+
+    var body: some View {
+        VStack(alignment: .leading, spacing: 4) {
+            Text(title)
+                .font(.system(size: AppMetrics.FontSize.caption))
+                .foregroundStyle(AppDesign.textSecondary)
+            Text(value)
+                .font(.system(size: AppMetrics.FontSize.title3, weight: .bold))
+                .foregroundStyle(tint)
+                .lineLimit(1)
+        }
+        .frame(maxWidth: .infinity, alignment: .leading)
+        .padding(AppMetrics.Spacing.small)
+        .background(tint.opacity(0.1), in: RoundedRectangle(cornerRadius: 8))
+    }
+}
+
+private struct OperatingAreaItemRow: View {
+    let item: OperatingAreaItem
+    let ringCount: Int
+    let isCurrentStore: Bool
+
+    var body: some View {
+        VStack(alignment: .leading, spacing: 8) {
+            HStack(alignment: .top) {
+                VStack(alignment: .leading, spacing: 4) {
+                    Text(item.name.isEmpty ? "未命名区域" : item.name)
+                        .font(.system(size: AppMetrics.FontSize.body, weight: .semibold))
+                        .foregroundStyle(AppDesign.textPrimary)
+                    Text("有效围栏 \(ringCount) 个")
+                        .font(.system(size: AppMetrics.FontSize.caption))
+                        .foregroundStyle(AppDesign.textSecondary)
+                }
+                Spacer()
+                if isCurrentStore {
+                    Text("当前门店")
+                        .font(.system(size: AppMetrics.FontSize.caption, weight: .medium))
+                        .foregroundStyle(Color(hex: 0xDC2626))
+                        .padding(.horizontal, 8)
+                        .frame(height: 24)
+                        .background(Color(hex: 0xDC2626).opacity(0.12), in: Capsule())
+                }
+            }
+            HStack(spacing: 8) {
+                if !item.statusText.isEmpty {
+                    OperatingAreaTag(text: item.statusText, color: AppDesign.success)
+                }
+                if !item.typeText.isEmpty {
+                    OperatingAreaTag(text: item.typeText, color: AppDesign.primary)
+                }
+                if !item.auditStatusText.isEmpty {
+                    OperatingAreaTag(text: item.auditStatusText, color: AppDesign.warning)
+                }
+            }
+        }
+        .padding(AppMetrics.Spacing.small)
+        .background(Color(hex: 0xF8FAFC), in: RoundedRectangle(cornerRadius: 8))
+    }
+}
+
+private struct OperatingAreaTag: View {
+    let text: String
+    let color: Color
+
+    var body: some View {
+        Text(text)
+            .font(.system(size: AppMetrics.FontSize.caption))
+            .foregroundStyle(color)
+            .padding(.horizontal, 8)
+            .frame(height: 22)
+            .background(color.opacity(0.12), in: Capsule())
+    }
+}
+
+private struct OperatingAreaMapView: View {
+    let rings: [OperatingFenceRing]
+
+    var body: some View {
+        #if AMAP_ENABLED
+        OperatingAreaAMapRepresentable(rings: rings)
+        #else
+        OperatingAreaMapFallback(rings: rings)
+        #endif
+    }
+}
+
+private struct OperatingAreaMapFallback: View {
+    let rings: [OperatingFenceRing]
+
+    var body: some View {
+        VStack(alignment: .leading, spacing: AppMetrics.Spacing.small) {
+            Label("模拟器未启用高德地图，以下为围栏坐标摘要", systemImage: "map")
+                .font(.system(size: AppMetrics.FontSize.subheadline, weight: .medium))
+                .foregroundStyle(AppDesign.textSecondary)
+            ScrollView {
+                LazyVStack(alignment: .leading, spacing: 8) {
+                    ForEach(rings) { ring in
+                        VStack(alignment: .leading, spacing: 4) {
+                            Text(ring.regionName.isEmpty ? "未命名区域" : ring.regionName)
+                                .font(.system(size: AppMetrics.FontSize.subheadline, weight: .semibold))
+                                .foregroundStyle(ring.isCurrentStore ? Color(hex: 0xDC2626) : AppDesign.textPrimary)
+                            Text(ring.points.prefix(4).map { String(format: "%.6f, %.6f", $0.latitude, $0.longitude) }.joined(separator: "  "))
+                                .font(.system(size: AppMetrics.FontSize.caption))
+                                .foregroundStyle(AppDesign.textSecondary)
+                                .lineLimit(2)
+                        }
+                        .frame(maxWidth: .infinity, alignment: .leading)
+                        .padding(10)
+                        .background(.white, in: RoundedRectangle(cornerRadius: 8))
+                    }
+                }
+            }
+        }
+        .padding(AppMetrics.Spacing.medium)
+        .frame(maxWidth: .infinity, maxHeight: .infinity, alignment: .topLeading)
+        .background(Color(hex: 0xEEF2F7))
+    }
+}
+
+#if AMAP_ENABLED
+private struct OperatingAreaAMapRepresentable: UIViewRepresentable {
+    let rings: [OperatingFenceRing]
+
+    func makeCoordinator() -> Coordinator {
+        Coordinator()
+    }
+
+    func makeUIView(context: Context) -> MAMapView {
+        let mapView = MAMapView(frame: .zero)
+        mapView.delegate = context.coordinator
+        mapView.showsCompass = false
+        mapView.showsScale = false
+        mapView.isRotateEnabled = false
+        return mapView
+    }
+
+    func updateUIView(_ mapView: MAMapView, context: Context) {
+        context.coordinator.ringsByOverlay.removeAll()
+        mapView.removeOverlays(mapView.overlays)
+        mapView.removeAnnotations(mapView.annotations)
+
+        var allCoordinates: [CLLocationCoordinate2D] = []
+        for ring in rings {
+            var coordinates = ring.points.map {
+                CLLocationCoordinate2D(latitude: $0.latitude, longitude: $0.longitude)
+            }
+            guard coordinates.count >= 3 else { continue }
+            let polygon = MAPolygon(coordinates: &coordinates, count: UInt(coordinates.count))
+            context.coordinator.ringsByOverlay[ObjectIdentifier(polygon)] = ring
+            mapView.add(polygon)
+            allCoordinates.append(contentsOf: coordinates)
+
+            if let center = ring.centerCoordinate {
+                let annotation = MAPointAnnotation()
+                annotation.coordinate = center
+                annotation.title = ring.regionName
+                mapView.addAnnotation(annotation)
+            }
+        }
+
+        if let region = Self.region(for: allCoordinates) {
+            mapView.setRegion(region, animated: true)
+        }
+    }
+
+    static func dismantleUIView(_ uiView: MAMapView, coordinator: Coordinator) {
+        uiView.delegate = nil
+    }
+
+    private static func region(for coordinates: [CLLocationCoordinate2D]) -> MACoordinateRegion? {
+        guard !coordinates.isEmpty else { return nil }
+        let minLat = coordinates.map(\.latitude).min() ?? 0
+        let maxLat = coordinates.map(\.latitude).max() ?? 0
+        let minLng = coordinates.map(\.longitude).min() ?? 0
+        let maxLng = coordinates.map(\.longitude).max() ?? 0
+        let center = CLLocationCoordinate2D(latitude: (minLat + maxLat) / 2, longitude: (minLng + maxLng) / 2)
+        let span = MACoordinateSpan(
+            latitudeDelta: max((maxLat - minLat) * 1.4, 0.01),
+            longitudeDelta: max((maxLng - minLng) * 1.4, 0.01)
+        )
+        return MACoordinateRegion(center: center, span: span)
+    }
+
+    final class Coordinator: NSObject, MAMapViewDelegate {
+        var ringsByOverlay: [ObjectIdentifier: OperatingFenceRing] = [:]
+
+        func mapView(_ mapView: MAMapView!, rendererFor overlay: MAOverlay!) -> MAOverlayRenderer! {
+            guard let polygon = overlay as? MAPolygon else { return nil }
+            let ring = ringsByOverlay[ObjectIdentifier(polygon)]
+            let renderer = MAPolygonRenderer(polygon: polygon)
+            let color = ring?.isCurrentStore == true ? UIColor.systemRed : UIColor.systemBlue
+            renderer?.strokeColor = color
+            renderer?.fillColor = color.withAlphaComponent(0.18)
+            renderer?.lineWidth = 3
+            return renderer
+        }
+    }
+}
+
+private extension OperatingFenceRing {
+    var centerCoordinate: CLLocationCoordinate2D? {
+        guard !points.isEmpty else { return nil }
+        let latitude = points.reduce(0) { $0 + $1.latitude } / Double(points.count)
+        let longitude = points.reduce(0) { $0 + $1.longitude } / Double(points.count)
+        return CLLocationCoordinate2D(latitude: latitude, longitude: longitude)
+    }
+}
+#endif

suixinkan/Features/PilotCertification/API/PilotCertificationAPI.swift

@@ -0,0 +1,58 @@
+//
+//  PilotCertificationAPI.swift
+//  suixinkan
+//
+//  Created by Codex on 2026/6/25.
+//
+
+import Foundation
+import Observation
+
+/// 飞手认证服务协议，定义认证详情、短信、提交和编辑接口。
+@MainActor
+protocol PilotCertificationServing {
+    func flyerDetail() async throws -> FlyerDetailResponse
+    func flyerSendCode(phone: String) async throws
+    func flyerApply(_ request: FlyerApplyRequest) async throws
+    func flyerEdit(_ request: FlyerEditRequest) async throws
+}
+
+@MainActor
+@Observable
+/// 飞手认证 API，封装 `/api/app/flyer` 认证相关接口。
+final class PilotCertificationAPI {
+    @ObservationIgnored private let client: APIClient
+
+    /// 初始化飞手认证 API，并注入共享网络客户端。
+    init(client: APIClient) {
+        self.client = client
+    }
+
+    /// 获取飞手认证详情。
+    func flyerDetail() async throws -> FlyerDetailResponse {
+        try await client.send(APIRequest(method: .get, path: "/api/app/flyer/detail"))
+    }
+
+    /// 发送飞手认证短信验证码。
+    func flyerSendCode(phone: String) async throws {
+        let _: EmptyPayload = try await client.send(
+            APIRequest(method: .post, path: "/api/app/flyer/send-code", body: FlyerSendCodeRequest(phone: phone))
+        )
+    }
+
+    /// 首次提交飞手认证申请。
+    func flyerApply(_ request: FlyerApplyRequest) async throws {
+        let _: EmptyPayload = try await client.send(
+            APIRequest(method: .post, path: "/api/app/flyer/apply", body: request)
+        )
+    }
+
+    /// 驳回后编辑并重新提交飞手认证申请。
+    func flyerEdit(_ request: FlyerEditRequest) async throws {
+        let _: EmptyPayload = try await client.send(
+            APIRequest(method: .post, path: "/api/app/flyer/edit", body: request)
+        )
+    }
+}
+
+extension PilotCertificationAPI: PilotCertificationServing {}

suixinkan/Features/PilotCertification/Models/PilotCertificationModels.swift

@@ -0,0 +1,310 @@
+//
+//  PilotCertificationModels.swift
+//  suixinkan
+//
+//  Created by Codex on 2026/6/25.
+//
+
+import Foundation
+
+/// 飞手证件类型。
+enum PilotCertType: Int, CaseIterable, Identifiable {
+    case idCard = 1
+    case caac = 2
+
+    var id: Int { rawValue }
+
+    var title: String {
+        switch self {
+        case .idCard:
+            "身份证"
+        case .caac:
+            "民用无人机驾驶员执照"
+        }
+    }
+}
+
+/// 飞手认证详情响应。
+struct FlyerDetailResponse: Decodable, Equatable {
+    let id: Int
+    let name: String
+    let accountId: String
+    let realnameStatus: Int
+    let status: Int
+    let statusName: String
+    let submitTime: String
+    let updatedAt: String
+    let auditPerson: String
+    let auditTime: String
+    let auditNote: String
+    let certificateType: Int
+    let certificateNo: String
+    let certificateStartDate: String
+    let certificateEndDate: String
+    let certificateImage: String
+    let droneModel: String
+    let droneSn: String
+    let contactPhone: String
+    let realnameStatusText: String
+    let certificationLogs: [FlyerCertificationLogItem]
+
+    enum CodingKeys: String, CodingKey {
+        case id
+        case name = "flyer_nickname"
+        case accountId = "account_id"
+        case realnameStatus = "realname_status"
+        case status
+        case statusName = "status_text"
+        case submitTime = "created_at"
+        case updatedAt = "updated_at"
+        case auditPerson = "reviewer"
+        case auditTime = "review_time"
+        case auditNote = "reject_reason"
+        case certificateType = "certificate_type"
+        case certificateNo = "certificate_no"
+        case certificateStartDate = "certificate_start_date"
+        case certificateEndDate = "certificate_end_date"
+        case certificateImage = "certificate_image"
+        case droneModel = "drone_model"
+        case droneSn = "drone_sn"
+        case contactPhone = "contact_phone"
+        case realnameStatusText = "realname_status_text"
+        case certificationLogs = "flyers_certification_logs"
+    }
+
+    init(
+        id: Int = 0,
+        name: String = "",
+        accountId: String = "",
+        realnameStatus: Int = 2,
+        status: Int = 0,
+        statusName: String = "",
+        submitTime: String = "",
+        updatedAt: String = "",
+        auditPerson: String = "",
+        auditTime: String = "",
+        auditNote: String = "",
+        certificateType: Int = 2,
+        certificateNo: String = "",
+        certificateStartDate: String = "",
+        certificateEndDate: String = "",
+        certificateImage: String = "",
+        droneModel: String = "",
+        droneSn: String = "",
+        contactPhone: String = "",
+        realnameStatusText: String = "",
+        certificationLogs: [FlyerCertificationLogItem] = []
+    ) {
+        self.id = id
+        self.name = name
+        self.accountId = accountId
+        self.realnameStatus = realnameStatus
+        self.status = status
+        self.statusName = statusName
+        self.submitTime = submitTime
+        self.updatedAt = updatedAt
+        self.auditPerson = auditPerson
+        self.auditTime = auditTime
+        self.auditNote = auditNote
+        self.certificateType = certificateType
+        self.certificateNo = certificateNo
+        self.certificateStartDate = certificateStartDate
+        self.certificateEndDate = certificateEndDate
+        self.certificateImage = certificateImage
+        self.droneModel = droneModel
+        self.droneSn = droneSn
+        self.contactPhone = contactPhone
+        self.realnameStatusText = realnameStatusText
+        self.certificationLogs = certificationLogs
+    }
+
+    init(from decoder: Decoder) throws {
+        let container = try decoder.container(keyedBy: CodingKeys.self)
+        id = try container.pilotDecodeLossyInt(forKey: .id) ?? 0
+        name = try container.pilotDecodeLossyString(forKey: .name)
+        accountId = try container.pilotDecodeLossyString(forKey: .accountId)
+        realnameStatus = try container.pilotDecodeLossyInt(forKey: .realnameStatus) ?? 2
+        status = try container.pilotDecodeLossyInt(forKey: .status) ?? 0
+        statusName = try container.pilotDecodeLossyString(forKey: .statusName)
+        submitTime = try container.pilotDecodeLossyString(forKey: .submitTime)
+        updatedAt = try container.pilotDecodeLossyString(forKey: .updatedAt)
+        auditPerson = try container.pilotDecodeLossyString(forKey: .auditPerson)
+        auditTime = try container.pilotDecodeLossyString(forKey: .auditTime)
+        auditNote = try container.pilotDecodeLossyString(forKey: .auditNote)
+        certificateType = try container.pilotDecodeLossyInt(forKey: .certificateType) ?? 2
+        certificateNo = try container.pilotDecodeLossyString(forKey: .certificateNo)
+        certificateStartDate = try container.pilotDecodeLossyString(forKey: .certificateStartDate)
+        certificateEndDate = try container.pilotDecodeLossyString(forKey: .certificateEndDate)
+        certificateImage = try container.pilotDecodeLossyString(forKey: .certificateImage)
+        droneModel = try container.pilotDecodeLossyString(forKey: .droneModel)
+        droneSn = try container.pilotDecodeLossyString(forKey: .droneSn)
+        contactPhone = try container.pilotDecodeLossyString(forKey: .contactPhone)
+        realnameStatusText = try container.pilotDecodeLossyString(forKey: .realnameStatusText)
+        certificationLogs = try container.decodeIfPresent([FlyerCertificationLogItem].self, forKey: .certificationLogs) ?? []
+    }
+}
+
+/// 飞手认证审核日志项。
+struct FlyerCertificationLogItem: Decodable, Identifiable, Equatable {
+    let id: Int
+    let flyerId: Int
+    let operatorName: String
+    let action: Int
+    let actionText: String
+    let rejectReason: String
+    let remark: String
+    let createdAt: String
+
+    enum CodingKeys: String, CodingKey {
+        case id
+        case flyerId = "flyer_id"
+        case operatorName = "operator"
+        case action
+        case actionText = "action_text"
+        case rejectReason = "reject_reason"
+        case remark
+        case createdAt = "created_at"
+    }
+
+    init(
+        id: Int = 0,
+        flyerId: Int = 0,
+        operatorName: String = "",
+        action: Int = 0,
+        actionText: String = "",
+        rejectReason: String = "",
+        remark: String = "",
+        createdAt: String = ""
+    ) {
+        self.id = id
+        self.flyerId = flyerId
+        self.operatorName = operatorName
+        self.action = action
+        self.actionText = actionText
+        self.rejectReason = rejectReason
+        self.remark = remark
+        self.createdAt = createdAt
+    }
+
+    init(from decoder: Decoder) throws {
+        let container = try decoder.container(keyedBy: CodingKeys.self)
+        id = try container.pilotDecodeLossyInt(forKey: .id) ?? 0
+        flyerId = try container.pilotDecodeLossyInt(forKey: .flyerId) ?? 0
+        operatorName = try container.pilotDecodeLossyString(forKey: .operatorName)
+        action = try container.pilotDecodeLossyInt(forKey: .action) ?? 0
+        actionText = try container.pilotDecodeLossyString(forKey: .actionText)
+        rejectReason = try container.pilotDecodeLossyString(forKey: .rejectReason)
+        remark = try container.pilotDecodeLossyString(forKey: .remark)
+        createdAt = try container.pilotDecodeLossyString(forKey: .createdAt)
+    }
+}
+
+/// 飞手认证短信验证码请求。
+struct FlyerSendCodeRequest: Encodable, Equatable {
+    let phone: String
+}
+
+/// 飞手首次认证申请请求。
+struct FlyerApplyRequest: Encodable, Equatable {
+    let name: String
+    let realnameStatus: Int
+    let certificateType: Int
+    let certificateNo: String
+    let certificateStartDate: String
+    let certificateEndDate: String
+    let certificateImage: String
+    let droneModel: String
+    let droneSn: String
+    let contactPhone: String
+    let code: String
+
+    enum CodingKeys: String, CodingKey {
+        case name
+        case realnameStatus = "realname_status"
+        case certificateType = "certificate_type"
+        case certificateNo = "certificate_no"
+        case certificateStartDate = "certificate_start_date"
+        case certificateEndDate = "certificate_end_date"
+        case certificateImage = "certificate_image"
+        case droneModel = "drone_model"
+        case droneSn = "drone_sn"
+        case contactPhone = "contact_phone"
+        case code
+    }
+}
+
+/// 飞手认证驳回后编辑请求。
+struct FlyerEditRequest: Encodable, Equatable {
+    let id: Int
+    let name: String
+    let realnameStatus: Int
+    let certificateType: Int
+    let certificateNo: String
+    let certificateStartDate: String
+    let certificateEndDate: String
+    let certificateImage: String
+    let droneModel: String
+    let droneSn: String
+    let contactPhone: String
+    let code: String
+
+    enum CodingKeys: String, CodingKey {
+        case id
+        case name
+        case realnameStatus = "realname_status"
+        case certificateType = "certificate_type"
+        case certificateNo = "certificate_no"
+        case certificateStartDate = "certificate_start_date"
+        case certificateEndDate = "certificate_end_date"
+        case certificateImage = "certificate_image"
+        case droneModel = "drone_model"
+        case droneSn = "drone_sn"
+        case contactPhone = "contact_phone"
+        case code
+    }
+}
+
+/// 飞手认证校验错误。
+enum PilotCertificationValidationError: LocalizedError, Equatable {
+    case message(String)
+
+    var errorDescription: String? {
+        switch self {
+        case .message(let message):
+            message
+        }
+    }
+}
+
+private extension KeyedDecodingContainer {
+    func pilotDecodeLossyString(forKey key: Key) throws -> String {
+        if let value = try? decodeIfPresent(String.self, forKey: key) {
+            return value
+        }
+        if let value = try? decodeIfPresent(Int.self, forKey: key) {
+            return String(value)
+        }
+        if let value = try? decodeIfPresent(Double.self, forKey: key) {
+            return String(value)
+        }
+        if let value = try? decodeIfPresent(Bool.self, forKey: key) {
+            return value ? "true" : "false"
+        }
+        return ""
+    }
+
+    func pilotDecodeLossyInt(forKey key: Key) throws -> Int? {
+        if let value = try? decodeIfPresent(Int.self, forKey: key) {
+            return value
+        }
+        if let value = try? decodeIfPresent(String.self, forKey: key) {
+            let text = value.trimmingCharacters(in: .whitespacesAndNewlines)
+            if let intValue = Int(text) { return intValue }
+            if let doubleValue = Double(text) { return Int(doubleValue) }
+        }
+        if let value = try? decodeIfPresent(Double.self, forKey: key) {
+            return Int(value)
+        }
+        return nil
+    }
+}

suixinkan/Features/PilotCertification/PilotCertification.md

@@ -0,0 +1,17 @@
+# PilotCertification 模块业务逻辑
+
+## 模块职责
+
+PilotCertification 负责首页 `pilot_cert` 入口的飞手认证申请。模块展示实名状态、飞手证件、无人机信息、联系方式和审核记录，并支持未提交或驳回状态下重新提交。
+
+## 核心流程
+
+- `PilotCertificationView` 从环境读取 `ProfileAPI`、`PilotCertificationAPI`、`OSSUploadService` 和当前景区。
+- `PilotCertificationViewModel` 并行加载实名认证状态和飞手认证详情，单通道失败不清空另一通道数据。
+- 用户选择证件图片后先保存在本地状态，提交时通过 OSS 上传并写入 `certificate_image`。
+- 未提交状态调用 `/api/app/flyer/apply`，驳回且有飞手记录 ID 时调用 `/api/app/flyer/edit`。
+- 验证码通过 `/api/app/flyer/send-code` 发送，成功后进入 60 秒本地倒计时。
+
+## 边界
+
+审核通过后页面只读。本模块不包含 DJI/飞控 SDK、无人机连接、飞行控制或横屏飞控流程。

suixinkan/Features/PilotCertification/ViewModels/PilotCertificationViewModel.swift

@@ -0,0 +1,282 @@
+//
+//  PilotCertificationViewModel.swift
+//  suixinkan
+//
+//  Created by Codex on 2026/6/25.
+//
+
+import Foundation
+import Observation
+
+@MainActor
+/// 飞手认证实名认证读取协议，便于 ViewModel 单测替换。
+protocol PilotRealNameServing {
+    func realNameInfo() async throws -> RealNameInfoResponse
+}
+
+extension ProfileAPI: PilotRealNameServing {}
+
+@MainActor
+@Observable
+/// 飞手认证 ViewModel，管理审核状态、表单、验证码、证件图上传和提交。
+final class PilotCertificationViewModel {
+    private(set) var flyer: FlyerDetailResponse?
+    private(set) var realNameInfo: RealNameInfo?
+    var name = ""
+    var certType: PilotCertType = .caac
+    var certNo = ""
+    var certImageUrl = ""
+    var startDate = Date()
+    var endDate = Calendar.current.date(byAdding: .year, value: 1, to: Date()) ?? Date()
+    var droneModel = ""
+    var droneSerialNo = ""
+    var phone = ""
+    var verifyCode = ""
+    private(set) var pendingCertificateImageData: Data?
+    private(set) var pendingCertificateFileName: String?
+    private(set) var uploadProgress: Int?
+    private(set) var loading = false
+    private(set) var sendingCode = false
+    private(set) var submitting = false
+    private(set) var countdown = 0
+    var statusMessage: String?
+
+    /// 加载实名状态和飞手认证详情，单通道失败不清空另一通道数据。
+    func load(api: any PilotCertificationServing, realNameAPI: any PilotRealNameServing) async {
+        guard !loading else { return }
+        loading = true
+        defer { loading = false }
+
+        async let realNameTask = realNameAPI.realNameInfo()
+        async let flyerTask = api.flyerDetail()
+        var messages: [String] = []
+
+        do {
+            let response = try await realNameTask
+            realNameInfo = response.realNameInfo
+        } catch {
+            messages.append(error.localizedDescription)
+        }
+
+        do {
+            apply(try await flyerTask)
+        } catch {
+            messages.append(error.localizedDescription)
+        }
+
+        statusMessage = messages.isEmpty ? nil : messages.joined(separator: "\n")
+    }
+
+    /// 选择待上传证件图。
+    func prepareCertificateImage(data: Data, fileName: String) {
+        pendingCertificateImageData = data
+        pendingCertificateFileName = fileName.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty
+            ? "pilot_cert_\(Int(Date().timeIntervalSince1970)).jpg"
+            : fileName
+        certImageUrl = ""
+        uploadProgress = nil
+    }
+
+    /// 发送验证码，成功后进入 60 秒倒计时。
+    func sendCode(api: any PilotCertificationServing) async throws {
+        guard canSendCode else {
+            throw PilotCertificationValidationError.message("请输入有效的手机号码")
+        }
+        sendingCode = true
+        defer { sendingCode = false }
+
+        try await api.flyerSendCode(phone: AppFormValidator.normalizedPhoneNumber(phone))
+        countdown = 60
+        statusMessage = "验证码已发送"
+    }
+
+    /// 倒计时递减，由页面定时器驱动。
+    func tickCountdown() {
+        if countdown > 0 {
+            countdown -= 1
+        }
+    }
+
+    /// 提交飞手认证，必要时先上传证件图。
+    func submit(api: any PilotCertificationServing, uploader: any OSSUploadServing, scenicId: Int?) async throws {
+        if let validationMessage {
+            throw PilotCertificationValidationError.message(validationMessage)
+        }
+
+        submitting = true
+        defer { submitting = false }
+
+        try await uploadPendingCertificateImage(uploader: uploader, scenicId: scenicId)
+        if auditStatus == 3, flyerId > 0 {
+            try await api.flyerEdit(makeEditRequest())
+            statusMessage = "修改已提交"
+        } else {
+            try await api.flyerApply(makeApplyRequest())
+            statusMessage = "认证申请已提交"
+        }
+        await load(api: api, realNameAPI: PilotEmptyRealNameServing(info: realNameInfo))
+    }
+
+    /// 审核状态编码。
+    var auditStatus: Int {
+        flyer?.status ?? 0
+    }
+
+    /// 飞手认证记录 ID。
+    var flyerId: Int {
+        flyer?.id ?? 0
+    }
+
+    /// 审核通过后表单只读。
+    var isReadOnly: Bool {
+        auditStatus == 2
+    }
+
+    /// 实名是否已通过。
+    var isRealNameVerified: Bool {
+        realNameInfo?.verified == true || flyer?.realnameStatus == 2
+    }
+
+    /// 是否允许发送验证码。
+    var canSendCode: Bool {
+        !sendingCode && countdown == 0 && (auditStatus == 0 || auditStatus == 3) && AppFormValidator.isValidMainlandPhoneNumber(phone)
+    }
+
+    /// 当前表单校验错误。
+    var validationMessage: String? {
+        if isReadOnly { return "认证已通过，无需重复提交" }
+        if auditStatus != 0 && auditStatus != 3 { return "认证审核中，请等待审核结果" }
+        if name.trimmedForPilot.isEmpty { return "请输入飞手昵称" }
+        if certNo.trimmedForPilot.isEmpty { return "请输入证件号码" }
+        if certImageUrl.trimmedForPilot.isEmpty && pendingCertificateImageData == nil { return "请选择证件图片" }
+        if endDate < startDate { return "截至日期不能早于起始日期" }
+        if droneModel.trimmedForPilot.isEmpty { return "请输入无人机型号" }
+        if droneSerialNo.trimmedForPilot.isEmpty { return "请输入无人机序列号" }
+        if phone.trimmedForPilot.isEmpty { return "请输入手机号码" }
+        if !AppFormValidator.isValidMainlandPhoneNumber(phone) { return "请输入有效的手机号码" }
+        if verifyCode.trimmedForPilot.isEmpty { return "请输入验证码" }
+        return nil
+    }
+
+    /// 审核状态展示文本。
+    var auditStatusText: String {
+        flyer?.statusName.trimmedForPilot.nonEmptyForPilot ?? Self.statusName(for: auditStatus)
+    }
+
+    /// 最近审核日志。
+    var latestAuditLog: FlyerCertificationLogItem? {
+        flyer?.certificationLogs.last { $0.action == 2 || $0.action == 3 }
+    }
+
+    private func apply(_ flyer: FlyerDetailResponse) {
+        self.flyer = flyer
+        name = flyer.name
+        certType = PilotCertType(rawValue: flyer.certificateType) ?? .caac
+        certNo = flyer.certificateNo
+        certImageUrl = flyer.certificateImage
+        startDate = Self.date(from: flyer.certificateStartDate) ?? startDate
+        endDate = Self.date(from: flyer.certificateEndDate) ?? endDate
+        droneModel = flyer.droneModel
+        droneSerialNo = flyer.droneSn
+        phone = flyer.contactPhone
+        pendingCertificateImageData = nil
+        pendingCertificateFileName = nil
+        uploadProgress = nil
+    }
+
+    private func uploadPendingCertificateImage(uploader: any OSSUploadServing, scenicId: Int?) async throws {
+        guard let data = pendingCertificateImageData else { return }
+        guard let scenicId, scenicId > 0 else {
+            throw PilotCertificationValidationError.message("请先选择景区")
+        }
+        uploadProgress = 1
+        defer { uploadProgress = nil }
+        certImageUrl = try await uploader.uploadPilotCertificateImage(
+            data: data,
+            fileName: pendingCertificateFileName ?? "pilot_cert_\(Int(Date().timeIntervalSince1970)).jpg",
+            scenicId: scenicId
+        ) { [weak self] progress in
+            Task { @MainActor in
+                self?.uploadProgress = progress
+            }
+        }
+        pendingCertificateImageData = nil
+        pendingCertificateFileName = nil
+    }
+
+    private func makeApplyRequest() -> FlyerApplyRequest {
+        FlyerApplyRequest(
+            name: name.trimmedForPilot,
+            realnameStatus: isRealNameVerified ? 1 : 2,
+            certificateType: certType.rawValue,
+            certificateNo: certNo.trimmedForPilot,
+            certificateStartDate: Self.dateFormatter.string(from: startDate),
+            certificateEndDate: Self.dateFormatter.string(from: endDate),
+            certificateImage: certImageUrl.trimmedForPilot,
+            droneModel: droneModel.trimmedForPilot,
+            droneSn: droneSerialNo.trimmedForPilot,
+            contactPhone: AppFormValidator.normalizedPhoneNumber(phone),
+            code: verifyCode.trimmedForPilot
+        )
+    }
+
+    private func makeEditRequest() -> FlyerEditRequest {
+        let apply = makeApplyRequest()
+        return FlyerEditRequest(
+            id: flyerId,
+            name: apply.name,
+            realnameStatus: apply.realnameStatus,
+            certificateType: apply.certificateType,
+            certificateNo: apply.certificateNo,
+            certificateStartDate: apply.certificateStartDate,
+            certificateEndDate: apply.certificateEndDate,
+            certificateImage: apply.certificateImage,
+            droneModel: apply.droneModel,
+            droneSn: apply.droneSn,
+            contactPhone: apply.contactPhone,
+            code: apply.code
+        )
+    }
+
+    private static func statusName(for status: Int) -> String {
+        switch status {
+        case 1: "审核中"
+        case 2: "已通过"
+        case 3: "审核失败"
+        default: "未提交"
+        }
+    }
+
+    private static let dateFormatter: DateFormatter = {
+        let formatter = DateFormatter()
+        formatter.calendar = Calendar(identifier: .gregorian)
+        formatter.locale = Locale(identifier: "en_US_POSIX")
+        formatter.dateFormat = "yyyy-MM-dd"
+        return formatter
+    }()
+
+    private static func date(from value: String) -> Date? {
+        let text = String(value.prefix(10))
+        guard !text.isEmpty else { return nil }
+        return dateFormatter.date(from: text)
+    }
+}
+
+private struct PilotEmptyRealNameServing: PilotRealNameServing {
+    let info: RealNameInfo?
+
+    func realNameInfo() async throws -> RealNameInfoResponse {
+        RealNameInfoResponse(realNameInfo: info)
+    }
+}
+
+private extension String {
+    var trimmedForPilot: String {
+        trimmingCharacters(in: .whitespacesAndNewlines)
+    }
+
+    var nonEmptyForPilot: String? {
+        let value = trimmedForPilot
+        return value.isEmpty ? nil : value
+    }
+}

suixinkan/Features/PilotCertification/Views/PilotCertificationViews.swift

@@ -0,0 +1,422 @@
+//
+//  PilotCertificationViews.swift
+//  suixinkan
+//
+//  Created by Codex on 2026/6/25.
+//
+
+import Combine
+import PhotosUI
+import SwiftUI
+import UIKit
+
+/// 飞手认证页面，展示认证审核状态并支持提交/驳回后编辑。
+struct PilotCertificationView: View {
+    @Environment(AccountContext.self) private var accountContext
+    @Environment(ProfileAPI.self) private var profileAPI
+    @Environment(PilotCertificationAPI.self) private var pilotAPI
+    @Environment(OSSUploadService.self) private var ossUploadService
+    @Environment(ToastCenter.self) private var toastCenter
+    @Environment(\.globalLoading) private var globalLoading
+
+    @State private var viewModel = PilotCertificationViewModel()
+    @State private var selectedImageItem: PhotosPickerItem?
+    private let countdownTimer = Timer.publish(every: 1, on: .main, in: .common).autoconnect()
+
+    var body: some View {
+        ScrollView {
+            VStack(spacing: AppMetrics.Spacing.medium) {
+                if viewModel.auditStatus != 0 {
+                    auditStatusCard
+                }
+                realNameCard
+                certificateCard
+                droneCard
+                contactCard
+                if let message = viewModel.statusMessage, !message.isEmpty {
+                    messageBanner(message)
+                }
+            }
+            .padding(AppMetrics.Spacing.pageHorizontal)
+            .padding(.vertical, AppMetrics.Spacing.medium)
+            .padding(.bottom, viewModel.isReadOnly ? 0 : 88)
+        }
+        .background(Color(hex: 0xF5F7FA))
+        .navigationTitle("飞手认证")
+        .navigationBarTitleDisplayMode(.inline)
+        .safeAreaInset(edge: .bottom) {
+            if !viewModel.isReadOnly {
+                submitBar
+            }
+        }
+        .task {
+            await reload(showLoading: true)
+        }
+        .onReceive(countdownTimer) { _ in
+            viewModel.tickCountdown()
+        }
+        .onChange(of: selectedImageItem) { _, item in
+            guard let item else { return }
+            Task { await loadImage(item) }
+        }
+    }
+
+    private var auditStatusCard: some View {
+        VStack(alignment: .leading, spacing: AppMetrics.Spacing.small) {
+            HStack {
+                Text(viewModel.auditStatusText)
+                    .font(.system(size: AppMetrics.FontSize.title3, weight: .bold))
+                    .foregroundStyle(auditColor)
+                Spacer()
+                Image(systemName: auditIcon)
+                    .foregroundStyle(auditColor)
+            }
+            PilotInfoRow(title: "提交时间", value: viewModel.flyer?.submitTime.nonEmptyPilotView ?? "--")
+            PilotInfoRow(title: "审核时间", value: viewModel.latestAuditLog?.createdAt.nonEmptyPilotView ?? viewModel.flyer?.auditTime.nonEmptyPilotView ?? "--")
+            PilotInfoRow(title: "审核人", value: viewModel.latestAuditLog?.operatorName.nonEmptyPilotView ?? viewModel.flyer?.auditPerson.nonEmptyPilotView ?? "--")
+            PilotInfoRow(title: "审核备注", value: viewModel.latestAuditLog?.rejectReason.nonEmptyPilotView ?? viewModel.flyer?.auditNote.nonEmptyPilotView ?? "--")
+        }
+        .padding(AppMetrics.Spacing.medium)
+        .background(auditColor.opacity(0.1), in: RoundedRectangle(cornerRadius: 8))
+        .overlay(RoundedRectangle(cornerRadius: 8).stroke(auditColor.opacity(0.35), lineWidth: 1))
+    }
+
+    private var realNameCard: some View {
+        VStack(spacing: AppMetrics.Spacing.medium) {
+            HStack {
+                VStack(alignment: .leading, spacing: 4) {
+                    Text("实名状态")
+                        .font(.system(size: AppMetrics.FontSize.body, weight: .semibold))
+                        .foregroundStyle(AppDesign.textPrimary)
+                    Text(viewModel.isRealNameVerified ? "已完成实名认证" : "飞手认证前建议先完成实名认证")
+                        .font(.system(size: AppMetrics.FontSize.caption))
+                        .foregroundStyle(AppDesign.textSecondary)
+                }
+                Spacer()
+                Text(viewModel.isRealNameVerified ? "已认证" : "未认证")
+                    .font(.system(size: AppMetrics.FontSize.caption, weight: .medium))
+                    .foregroundStyle(.white)
+                    .padding(.horizontal, 12)
+                    .frame(height: 28)
+                    .background(viewModel.isRealNameVerified ? AppDesign.success : AppDesign.warning, in: Capsule())
+            }
+            if !viewModel.isRealNameVerified {
+                NavigationLink {
+                    RealNameAuthView()
+                } label: {
+                    Label("去认证", systemImage: "person.text.rectangle")
+                        .font(.system(size: AppMetrics.FontSize.body, weight: .semibold))
+                        .frame(maxWidth: .infinity)
+                        .frame(height: 44)
+                }
+                .buttonStyle(.borderedProminent)
+            }
+        }
+        .padding(AppMetrics.Spacing.medium)
+        .background(.white, in: RoundedRectangle(cornerRadius: 8))
+    }
+
+    private var certificateCard: some View {
+        PilotSectionCard(title: "飞手证件信息") {
+            PilotTextField(title: "飞手昵称", text: $viewModel.name, placeholder: "请输入飞手昵称", disabled: viewModel.isReadOnly)
+            VStack(alignment: .leading, spacing: 8) {
+                Text("证件类型")
+                    .font(.system(size: AppMetrics.FontSize.subheadline, weight: .medium))
+                    .foregroundStyle(AppDesign.textPrimary)
+                Picker("证件类型", selection: $viewModel.certType) {
+                    ForEach(PilotCertType.allCases) { type in
+                        Text(type.title).tag(type)
+                    }
+                }
+                .pickerStyle(.menu)
+                .disabled(viewModel.isReadOnly)
+                .frame(maxWidth: .infinity, alignment: .leading)
+                .padding(.horizontal, 12)
+                .frame(height: 48)
+                .background(Color(hex: 0xF8FAFC), in: RoundedRectangle(cornerRadius: 8))
+            }
+            PilotTextField(title: "证件号码", text: $viewModel.certNo, placeholder: "请输入证件号码", disabled: viewModel.isReadOnly)
+            certificateImagePicker
+            HStack(spacing: AppMetrics.Spacing.small) {
+                PilotDateField(title: "起始日期", date: $viewModel.startDate, disabled: viewModel.isReadOnly)
+                PilotDateField(title: "截至日期", date: $viewModel.endDate, disabled: viewModel.isReadOnly)
+            }
+        }
+    }
+
+    private var certificateImagePicker: some View {
+        VStack(alignment: .leading, spacing: 8) {
+            Text("证件图片")
+                .font(.system(size: AppMetrics.FontSize.subheadline, weight: .medium))
+                .foregroundStyle(AppDesign.textPrimary)
+            ZStack {
+                if let data = viewModel.pendingCertificateImageData,
+                   let image = UIImage(data: data) {
+                    Image(uiImage: image)
+                        .resizable()
+                        .scaledToFill()
+                } else if !viewModel.certImageUrl.isEmpty {
+                    RemoteImage(urlString: viewModel.certImageUrl, contentMode: .fill) {
+                        certificatePlaceholder("证件图片加载中")
+                    }
+                } else {
+                    certificatePlaceholder("点击选择证件图片")
+                }
+            }
+            .frame(maxWidth: .infinity)
+            .frame(height: 150)
+            .clipShape(RoundedRectangle(cornerRadius: 8))
+            .overlay(RoundedRectangle(cornerRadius: 8).stroke(Color(hex: 0xE2E8F0), style: StrokeStyle(lineWidth: 1, dash: [5, 4])))
+
+            if !viewModel.isReadOnly {
+                PhotosPicker(selection: $selectedImageItem, matching: .images) {
+                    Label(viewModel.pendingCertificateImageData == nil && viewModel.certImageUrl.isEmpty ? "选择图片" : "更换图片", systemImage: "photo")
+                        .font(.system(size: AppMetrics.FontSize.subheadline, weight: .semibold))
+                        .frame(maxWidth: .infinity)
+                        .frame(height: 42)
+                }
+                .buttonStyle(.bordered)
+            }
+
+            if let progress = viewModel.uploadProgress {
+                ProgressView(value: Double(progress), total: 100)
+            }
+        }
+    }
+
+    private var droneCard: some View {
+        PilotSectionCard(title: "绑定无人机信息") {
+            PilotTextField(title: "无人机型号", text: $viewModel.droneModel, placeholder: "请输入无人机型号", disabled: viewModel.isReadOnly)
+            PilotTextField(title: "无人机序列号", text: $viewModel.droneSerialNo, placeholder: "请输入无人机序列号", disabled: viewModel.isReadOnly)
+        }
+    }
+
+    private var contactCard: some View {
+        PilotSectionCard(title: "联系信息") {
+            HStack(alignment: .bottom, spacing: AppMetrics.Spacing.small) {
+                PilotTextField(title: "手机号码", text: $viewModel.phone, placeholder: "请输入手机号", keyboard: .phonePad, disabled: viewModel.isReadOnly)
+                if !viewModel.isReadOnly {
+                    Button {
+                        Task { await sendCode() }
+                    } label: {
+                        Text(codeButtonText)
+                            .font(.system(size: AppMetrics.FontSize.caption, weight: .semibold))
+                            .frame(width: 96, height: 48)
+                    }
+                    .buttonStyle(.bordered)
+                    .disabled(!viewModel.canSendCode)
+                }
+            }
+            if !viewModel.isReadOnly {
+                PilotTextField(title: "验证码", text: $viewModel.verifyCode, placeholder: "请输入验证码", keyboard: .numberPad, disabled: false)
+            }
+        }
+    }
+
+    private var submitBar: some View {
+        VStack(spacing: 0) {
+            Divider()
+            Button {
+                Task { await submit() }
+            } label: {
+                HStack(spacing: 8) {
+                    if viewModel.submitting {
+                        ProgressView()
+                            .tint(.white)
+                    }
+                    Text(viewModel.auditStatus == 3 ? "重新提交" : "提交认证")
+                        .font(.system(size: AppMetrics.FontSize.body, weight: .semibold))
+                }
+                .foregroundStyle(.white)
+                .frame(maxWidth: .infinity)
+                .frame(height: AppMetrics.ControlSize.primaryButtonHeight)
+                .background(viewModel.validationMessage == nil ? AppDesign.primary : Color(hex: 0xC9CED6), in: RoundedRectangle(cornerRadius: 8))
+            }
+            .buttonStyle(.plain)
+            .disabled(viewModel.validationMessage != nil || viewModel.submitting)
+            .padding(AppMetrics.Spacing.medium)
+            .background(.white)
+        }
+    }
+
+    private var auditColor: Color {
+        switch viewModel.auditStatus {
+        case 2:
+            AppDesign.success
+        case 3:
+            Color(hex: 0xDC2626)
+        case 1:
+            AppDesign.warning
+        default:
+            AppDesign.textSecondary
+        }
+    }
+
+    private var auditIcon: String {
+        switch viewModel.auditStatus {
+        case 2:
+            "checkmark.seal.fill"
+        case 3:
+            "xmark.seal.fill"
+        case 1:
+            "clock.badge.checkmark.fill"
+        default:
+            "paperplane.fill"
+        }
+    }
+
+    private var codeButtonText: String {
+        if viewModel.countdown > 0 { return "\(viewModel.countdown)s" }
+        return viewModel.sendingCode ? "发送中" : "获取验证码"
+    }
+
+    private func certificatePlaceholder(_ text: String) -> some View {
+        VStack(spacing: 8) {
+            Image(systemName: "photo.badge.plus")
+                .font(.system(size: 34, weight: .semibold))
+            Text(text)
+                .font(.system(size: AppMetrics.FontSize.caption, weight: .medium))
+        }
+        .foregroundStyle(AppDesign.primary)
+        .frame(maxWidth: .infinity, maxHeight: .infinity)
+        .background(AppDesign.primarySoft)
+    }
+
+    private func messageBanner(_ text: String) -> some View {
+        HStack(spacing: 8) {
+            Image(systemName: text.contains("已") ? "checkmark.circle.fill" : "exclamationmark.triangle.fill")
+            Text(text)
+                .font(.system(size: AppMetrics.FontSize.caption))
+                .fixedSize(horizontal: false, vertical: true)
+        }
+        .foregroundStyle(text.contains("已") ? AppDesign.success : AppDesign.warning)
+        .padding(AppMetrics.Spacing.small)
+        .frame(maxWidth: .infinity, alignment: .leading)
+        .background((text.contains("已") ? AppDesign.success : AppDesign.warning).opacity(0.12), in: RoundedRectangle(cornerRadius: 8))
+    }
+
+    private func reload(showLoading: Bool) async {
+        await globalLoading.withOptionalLoading(showLoading) {
+            await viewModel.load(api: pilotAPI, realNameAPI: profileAPI)
+        }
+        if let message = viewModel.statusMessage, !message.isEmpty {
+            toastCenter.show(message)
+        }
+    }
+
+    private func loadImage(_ item: PhotosPickerItem) async {
+        do {
+            if let data = try await item.loadTransferable(type: Data.self) {
+                viewModel.prepareCertificateImage(data: data, fileName: "pilot_cert_\(Int(Date().timeIntervalSince1970)).jpg")
+            }
+        } catch {
+            toastCenter.show(error.localizedDescription)
+        }
+        selectedImageItem = nil
+    }
+
+    private func sendCode() async {
+        do {
+            try await viewModel.sendCode(api: pilotAPI)
+        } catch {
+            toastCenter.show(error.localizedDescription)
+        }
+    }
+
+    private func submit() async {
+        do {
+            try await globalLoading.withLoading {
+                try await viewModel.submit(api: pilotAPI, uploader: ossUploadService, scenicId: accountContext.currentScenic?.id)
+            }
+            toastCenter.show(viewModel.statusMessage ?? "提交成功")
+        } catch {
+            toastCenter.show(error.localizedDescription)
+        }
+    }
+}
+
+private struct PilotSectionCard<Content: View>: View {
+    let title: String
+    @ViewBuilder let content: () -> Content
+
+    var body: some View {
+        VStack(alignment: .leading, spacing: AppMetrics.Spacing.medium) {
+            Text(title)
+                .font(.system(size: AppMetrics.FontSize.body, weight: .bold))
+                .foregroundStyle(AppDesign.textPrimary)
+            content()
+        }
+        .padding(AppMetrics.Spacing.medium)
+        .background(.white, in: RoundedRectangle(cornerRadius: 8))
+    }
+}
+
+private struct PilotTextField: View {
+    let title: String
+    @Binding var text: String
+    let placeholder: String
+    var keyboard: UIKeyboardType = .default
+    let disabled: Bool
+
+    var body: some View {
+        VStack(alignment: .leading, spacing: 8) {
+            Text(title)
+                .font(.system(size: AppMetrics.FontSize.subheadline, weight: .medium))
+                .foregroundStyle(AppDesign.textPrimary)
+            TextField(placeholder, text: $text)
+                .keyboardType(keyboard)
+                .disabled(disabled)
+                .textInputAutocapitalization(.never)
+                .autocorrectionDisabled(true)
+                .appInputFieldStyle(cornerRadius: 8, minHeight: 48)
+        }
+    }
+}
+
+private struct PilotDateField: View {
+    let title: String
+    @Binding var date: Date
+    let disabled: Bool
+
+    var body: some View {
+        VStack(alignment: .leading, spacing: 8) {
+            Text(title)
+                .font(.system(size: AppMetrics.FontSize.subheadline, weight: .medium))
+                .foregroundStyle(AppDesign.textPrimary)
+            DatePicker(title, selection: $date, displayedComponents: .date)
+                .labelsHidden()
+                .disabled(disabled)
+                .frame(maxWidth: .infinity, alignment: .leading)
+                .padding(.horizontal, 10)
+                .frame(height: 48)
+                .background(Color(hex: 0xF8FAFC), in: RoundedRectangle(cornerRadius: 8))
+        }
+        .frame(maxWidth: .infinity, alignment: .leading)
+    }
+}
+
+private struct PilotInfoRow: View {
+    let title: String
+    let value: String
+
+    var body: some View {
+        HStack(alignment: .top, spacing: AppMetrics.Spacing.small) {
+            Text(title)
+                .font(.system(size: AppMetrics.FontSize.caption))
+                .foregroundStyle(AppDesign.textSecondary)
+                .frame(width: 72, alignment: .leading)
+            Text(value)
+                .font(.system(size: AppMetrics.FontSize.caption))
+                .foregroundStyle(AppDesign.textPrimary)
+                .frame(maxWidth: .infinity, alignment: .leading)
+                .multilineTextAlignment(.leading)
+        }
+    }
+}
+
+private extension String {
+    var nonEmptyPilotView: String? {
+        let value = trimmingCharacters(in: .whitespacesAndNewlines)
+        return value.isEmpty ? nil : value
+    }
+}