汉秋
1b1e93b9ca
从 xh_test 同步 ScenicPromotion 演示页，补齐 MVVM 结构、本地资源、单元测试与模块文档，注册 promotion_page 首页入口。 Co-authored-by: Cursor <cursoragent@cursor.com>
111 lines
3.0 KiB
Swift
111 lines
3.0 KiB
Swift
//
|
||
// HomeMenuItem.swift
|
||
// suixinkan
|
||
//
|
||
// Created by Codex on 2026/6/22.
|
||
//
|
||
|
||
import Foundation
|
||
|
||
/// 首页菜单实体，表示一个由权限 URI 派生出来的可点击功能入口。
|
||
struct HomeMenuItem: Equatable, Identifiable {
|
||
let title: String
|
||
let uri: String
|
||
let iconSrc: String?
|
||
|
||
var id: String {
|
||
uri
|
||
}
|
||
}
|
||
|
||
/// 首页可导航目标实体，表示首页菜单能进入的本地页面或占位页面。
|
||
enum HomeRoute: Hashable {
|
||
case profileSpace
|
||
case profileSpaceSettings
|
||
case scenicSelection
|
||
case permissionApply
|
||
case permissionApplyStatus
|
||
case scenicApplication
|
||
case moreFunctions
|
||
case settings
|
||
case paymentCollection
|
||
case wallet
|
||
case taskManagement
|
||
case taskCreate
|
||
case taskDetail(id: Int, summary: PhotographerTaskItem?)
|
||
case projectManagement
|
||
case pmProjectManagement
|
||
case projectDetail(id: Int, storeMode: Bool)
|
||
case projectEditor(id: Int?, storeMode: Bool)
|
||
case scheduleManagement
|
||
case scheduleAdd
|
||
case photographerInvite
|
||
case inviteRecord
|
||
case cloudStorage
|
||
case cloudStorageTransit
|
||
case materialLibrary
|
||
case materialUpload
|
||
case sampleLibrary
|
||
case sampleUpload
|
||
case albumList
|
||
case albumTrailer
|
||
case punchPointList
|
||
case punchPointDetail(id: Int, summary: PunchPointItem?)
|
||
case punchPointEditor(id: Int?)
|
||
case punchPointQR(id: Int, title: String, qrURL: String)
|
||
case locationReport
|
||
case locationReportHistory
|
||
case photographerReport
|
||
case depositOrders
|
||
case withdrawalAudit
|
||
case cooperationOrder
|
||
case scenicSettlement
|
||
case scenicSettlementReview
|
||
case messageCenter
|
||
case queueManagement
|
||
case liveManagement
|
||
case liveAlbum
|
||
case travelAlbumEntry
|
||
case operatingArea
|
||
case pilotCertification
|
||
case scenicPromotion
|
||
case modulePlaceholder(uri: String, title: String)
|
||
}
|
||
|
||
/// 首页权限 URI 解析结果，区分 Tab 跳转、本地页面、已知不支持和未知占位。
|
||
enum HomeMenuResolvedRoute: Equatable {
|
||
case tab(AppTab)
|
||
case orders(OrdersEntry)
|
||
case orderPush(OrdersRoute)
|
||
case destination(HomeRoute)
|
||
case unsupported(uri: String, title: String, reason: String)
|
||
case placeholder(uri: String, title: String)
|
||
}
|
||
|
||
/// 未知首页路由记录实体，用于诊断后端新增但 iOS 尚未映射的 URI。
|
||
struct UnknownHomeRouteRecord: Codable, Equatable {
|
||
let uri: String
|
||
let title: String
|
||
let firstSeenAt: Date
|
||
let lastSeenAt: Date
|
||
let count: Int
|
||
}
|
||
|
||
/// 首页权限路由审计项，表示一个权限菜单和它的解析结果。
|
||
struct HomePermissionRouteAuditEntry: Equatable {
|
||
let uri: String
|
||
let title: String
|
||
let route: HomeMenuResolvedRoute
|
||
}
|
||
|
||
/// 首页权限路由审计结果，按可路由、已知不支持、未知三类聚合。
|
||
struct HomePermissionRouteAudit: Equatable {
|
||
let routable: [HomePermissionRouteAuditEntry]
|
||
let unsupported: [HomePermissionRouteAuditEntry]
|
||
let unknown: [HomePermissionRouteAuditEntry]
|
||
|
||
var hasUnknownRoutes: Bool {
|
||
!unknown.isEmpty
|
||
}
|
||
}
|