Implement permission-driven home tab aligned with Android.

Load role-permission on first visit to drive menus, role-based layout, store card, and location reporting with account-scoped persistence and unit tests. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-06 17:27:54 +08:00
parent 75d0cb1f9a
commit 3b17b7f7f0
27 changed files with 2573 additions and 10 deletions
--- a/suixinkan/Features/Home/Services/HomeMenuCatalog.swift
+++ b/suixinkan/Features/Home/Services/HomeMenuCatalog.swift
@ -0,0 +1,58 @@
+//
+//  HomeMenuCatalog.swift
+//  suixinkan
+//
+
+import Foundation
+
+/// 首页菜单静态 catalog，与服务端 permission URI 取交集后展示。
+enum HomeMenuCatalog {
+
+    /// 全部已知菜单项，对齐 Android `Constants.menuList`。
+    static let allItems: [HomeMenuItem] = [
+        HomeMenuItem(uri: "space_settings", title: "空间设置", iconName: "gearshape"),
+        HomeMenuItem(uri: "wallet", title: "我的钱包", iconName: "wallet.pass"),
+        HomeMenuItem(uri: "cloud_management", title: "相册云盘", iconName: "icloud"),
+        HomeMenuItem(uri: "asset_management", title: "素材管理", iconName: "photo.on.rectangle"),
+        HomeMenuItem(uri: "task_management", title: "任务管理", iconName: "checklist"),
+        HomeMenuItem(uri: "task_management_editor", title: "任务管理", iconName: "checklist"),
+        HomeMenuItem(uri: "schedule_management", title: "日程管理", iconName: "calendar"),
+        HomeMenuItem(uri: "system_settings", title: "设置中心", iconName: "slider.horizontal.3"),
+        HomeMenuItem(uri: "message_center", title: "消息中心", iconName: "bell"),
+        HomeMenuItem(uri: "checkin_points", title: "打卡点管理", iconName: "mappin.and.ellipse"),
+        HomeMenuItem(uri: "sample_management", title: "样片管理", iconName: "photo.stack"),
+        HomeMenuItem(uri: "live_stream_management", title: "直播管理", iconName: "video"),
+        HomeMenuItem(uri: "verification_order", title: "核销订单", iconName: "checkmark.seal"),
+        HomeMenuItem(uri: "live_album", title: "直播相册", iconName: "photo.on.rectangle.angled"),
+        HomeMenuItem(uri: "pm", title: "项目管理", iconName: "folder"),
+        HomeMenuItem(uri: "pm_manager", title: "项目管理", iconName: "folder"),
+        HomeMenuItem(uri: "location_report", title: "位置上报", iconName: "location"),
+        HomeMenuItem(uri: "registration_invitation", title: "注册邀请", iconName: "person.badge.plus"),
+        HomeMenuItem(uri: "store", title: "店铺管理", iconName: "building.2"),
+        HomeMenuItem(uri: "fly", title: "飞行管理", iconName: "airplane"),
+        HomeMenuItem(uri: "pilot_cert", title: "飞手认证", iconName: "person.text.rectangle"),
+        HomeMenuItem(uri: "pilot_controller", title: "飞控", iconName: "gamecontroller"),
+        HomeMenuItem(uri: "/scenic-queue", title: "排队管理", iconName: "person.3"),
+        HomeMenuItem(uri: "operating-area", title: "运营区域", iconName: "map"),
+        HomeMenuItem(uri: "/scenic-order-manage", title: "景区订单", iconName: "doc.text"),
+        HomeMenuItem(uri: "cooperation_order", title: "合作订单", iconName: "person.2"),
+    ]
+
+    /// 将服务端权限映射为可展示菜单，保持服务端顺序。
+    static func visibleMenus(from permissions: [HomePermissionItem]) -> [HomeMenuItem] {
+        permissions.compactMap { permission in
+            guard let catalog = allItems.first(where: { $0.uri == permission.uri }) else { return nil }
+            return HomeMenuItem(
+                uri: catalog.uri,
+                title: catalog.title,
+                iconName: catalog.iconName,
+                serverName: permission.name
+            )
+        }
+    }
+
+    /// 查找 catalog 项。
+    static func item(for uri: String) -> HomeMenuItem? {
+        allItems.first { $0.uri == uri }
+    }
+}