12 KiB
12 KiB
各端菜单配置规范
最后更新：2026-04-02 维护人：开发团队
本文档记录各端的正确菜单配置，是菜单分配的唯一权威来源。修改菜单时必须对照此文档。
快速参考：各端登录信息
| 端 | 租户编码 | 登录URL | 用户名 | 密码 | 角色 |
|---|---|---|---|---|---|
| 超管端 | super | /super/login |
admin | admin123 | super_admin |
| 广东省图端（租户端） | gdlib | /gdlib/login |
admin | admin123 | tenant_admin |
| 评委端 | judge | /judge/login |
admin | admin123 | judge |
| 公众端 | — | /p/login |
自主注册 | — | public_user |
注意：在同一浏览器中切换不同端时，需要先登出或清除缓存（localStorage），否则旧 token 会导致跳转错误。建议用无痕窗口测试不同端。
一、超管端（tenant_id=1, code='super'）— 21条
定位：只读监管，不含操作类功能。
一级菜单：5 个（活动监管、内容管理、机构管理、用户中心、系统设置）
不包含：数据统计（租户端专属）、活动管理（租户端专属）、我的评审（评委端专属）
活动监管 (id=37) ← 只读监管视角
├── 全部活动 (38)
├── 报名数据 (39)
├── 作品数据 (40)
├── 评审进度 (41)
└── 活动成果 (44)
内容管理 (id=46)
├── 作品审核 (47)
├── 作品管理 (48)
└── 标签管理 (49)
机构管理 (id=28)
└── 机构管理 (30)
用户中心 (id=29)
├── 用户管理 (32)
└── 角色管理 (33)
系统设置 (id=14)
├── 菜单管理 (17)
├── 数据字典 (18)
├── 系统配置 (19)
├── 日志记录 (20)
└── 权限管理 (21)
tenant_menus ID 列表（21条）：
14, 17, 18, 19, 20, 21, 28, 29, 30, 32, 33, 37, 38, 39, 40, 41, 44, 46, 47, 48, 49
超管端不包含的菜单及原因
| 菜单 | ID | 原因 |
|---|---|---|
| 评委管理 | 42 | 操作类功能，属于租户端活动管理 |
| 评审规则 | 43 | 操作类功能，属于租户端活动管理 |
| 通知管理 | 45 | 操作类功能，属于租户端活动管理 |
| 数据统计 | 52,53,54 | 设计文档明确标注"所属端：租户端"（见 docs/design/org-admin/data-analytics-dashboard.md） |
| 活动管理 | 9 及子菜单 | 租户端操作菜单，超管用"活动监管"代替 |
| 我的评审 | 34,35,36 | 评委端专属 |
| 工作台 | 50 | 租户端工作台(TenantDashboard)，超管端不需要 |
| 学校管理 | 2 及子菜单 | 已剥离（代码移至 competition-management-system-stripped-modules/） |
二、租户端（以 gdlib id=9 为例）— 18条
定位：机构管理员操作端，含全部业务操作功能。
一级菜单：4 个（工作台、数据统计、活动管理、系统设置）
工作台 (id=50) ← TenantDashboard
页面内容：欢迎信息 + 6个统计卡片 + 快捷操作 + 待办提醒 + 最近活动
数据统计 (id=52) ← 租户端专属
├── 运营概览 (53) — 指标卡片 + 漏斗图 + 月度趋势 + 活动对比
└── 评审分析 (54) — 效率指标 + 评委工作量 + 奖项分布
活动管理 (id=9) ← 含全部操作功能（创建/编辑/审核/评委/评分/发布）
├── 活动列表 (10) — 创建、发布、编辑活动
├── 评委管理 (23) — 添加/移除评委、设置权重
├── 报名管理 (11) — 审核报名、添加指导老师
├── 作品管理 (12) — 查看作品、版本管理
├── 评审进度 (25) — 分配作品、查看进度
├── 评审规则 (26) — 创建/编辑评审规则和维度
├── 成果发布 (24) — 计算得分/排名、设置奖项、发布成果
└── 活动公告 (27) — 创建/编辑活动公告
系统设置 (id=14) ← 精简版
├── 机构信息 (51) — 查看/编辑机构名称和描述、复制登录地址
├── 用户管理 (15) — 本租户用户 CRUD
├── 角色管理 (16) — 本租户角色和权限分配
└── 日志记录 (20) — 操作日志查看
tenant_menus ID 列表（18条）：
9, 10, 11, 12, 14, 15, 16, 20, 23, 24, 25, 26, 27, 50, 51, 52, 53, 54
租户端系统设置不包含的子菜单
| 菜单 | ID | 原因 |
|---|---|---|
| 菜单管理 | 17 | 平台级功能，超管专属 |
| 数据字典 | 18 | 平台级功能，超管专属 |
| 系统配置 | 19 | 平台级功能，超管专属 |
| 权限管理 | 21 | 平台级功能，超管专属 |
| 租户管理 | 22 | 平台级功能，超管专属 |
新建租户时的菜单分配
创建新租户时，应分配与 gdlib 相同的菜单列表（18条）。在 SysTenantServiceImpl.createTenant 中实现。
三、评委端（tenant_id=7, code='judge'）— 3条
定位：评委评审工作台，只能看到自己被分配的活动和作品。
详细接口与字段说明：评委端评审任务。
一级菜单：1 个（我的评审）
我的评审 (id=34)
├── 评审任务 (35) — 查看分配的活动、作品列表、打分
└── 预设评语 (36) — 管理评审常用评语模板，支持跨活动同步
tenant_menus ID 列表（3条）：
34, 35, 36
评委端权限码
| 权限码 | 用途 |
|---|---|
| review:score | 提交/更新评分 |
| review:read | 查看评审数据 |
| review:create | 创建评审记录 |
| review:update | 更新评审记录 |
| activity:read | 查看活动列表 |
| judge:read | 查看评委信息 |
| judge:assign | 分配评审 |
| work:read | 查看作品 |
| notice:read | 查看公告 |
| workbench:read | 查看工作台 |
四、公众端（tenant_id=8, code='public'）
公众端不使用动态菜单系统，路由固定在前端 router/index.ts 中。
导航结构
顶部导航栏（Web 端）/ 底部 Tab（H5 移动端）：
├── 发现 (/p/gallery) — 作品广场，推荐+标签+搜索
├── 活动 (/p/activities) — 活动大厅，浏览+报名
├── 创作 (/p/create) — 绘本创作4步流程
├── 作品库 (/p/works) — 我的作品（草稿/审核中/已发布）
└── 我的 (/p/mine) — 个人中心
├── 个人信息 — 昵称/城市/性别
├── 我的报名 — 报名记录+审核状态
├── 我的收藏 — 收藏的作品
└── 子女管理 — 添加子女/创建子女账号/切换身份
公众端权限码
| 权限码 | 用途 |
|---|---|
| activity:read | 浏览活动 |
| registration:create | 报名活动 |
| work:create | 创建作品 |
| child:manage | 子女管理 |
无需认证的接口（@Public）
GET /public/activities— 活动列表GET /public/activities/:id— 活动详情GET /public/gallery— 作品广场GET /public/gallery/recommended— 推荐作品GET /public/gallery/:id— 作品详情GET /public/tags— 标签列表GET /public/tags/hot— 热门标签POST /public/auth/register— 注册POST /public/auth/login— 登录
五、完整菜单 ID 对照表
| ID | 名称 | 父ID | 组件 | 所属端 |
|---|---|---|---|---|
| 1 | 工作台(旧) | — | workbench/Index | |
| 2 | 学校管理 | — | — | |
| 3-8 | 学校子菜单 | 2 | school/* | |
| 9 | 活动管理 | — | — | 租户端 |
| 10 | 活动列表 | 9 | contests/Index | 租户端 |
| 11 | 报名管理 | 9 | contests/registrations/Index | 租户端 |
| 12 | 作品管理 | 9 | contests/works/Index | 租户端 |
| 14 | 系统设置 | — | — | 超管+租户 |
| 15 | 用户管理 | 14 | system/users/Index | 租户端 |
| 16 | 角色管理 | 14 | system/roles/Index | 租户端 |
| 17 | 菜单管理 | 14 | system/menus/Index | 超管端 |
| 18 | 数据字典 | 14 | system/dict/Index | 超管端 |
| 19 | 系统配置 | 14 | system/config/Index | 超管端 |
| 20 | 日志记录 | 14 | system/logs/Index | 超管+租户 |
| 21 | 权限管理 | 14 | system/permissions/Index | 超管端 |
| 22 | 租户管理 | 14 | system/tenants/Index | |
| 23 | 评委管理 | 9 | contests/judges/Index | 租户端 |
| 24 | 成果发布 | 9 | contests/results/Index | 租户端 |
| 25 | 评审进度 | 9 | contests/reviews/Progress | 租户端 |
| 26 | 评审规则 | 9 | contests/ReviewRules | 租户端 |
| 27 | 活动公告 | 9 | contests/notices/Index | 租户端 |
| 28 | 机构管理 | — | — | 超管端 |
| 29 | 用户中心 | — | — | 超管端 |
| 30 | 机构管理(列表) | 28 | system/tenants/Index | 超管端 |
| 32 | 用户管理(超管) | 29 | system/users/Index | 超管端 |
| 33 | 角色管理(超管) | 29 | system/roles/Index | 超管端 |
| 34 | 我的评审 | — | — | 评委端 |
| 35 | 评审任务 | 34 | activities/Review | 评委端 |
| 36 | 预设评语 | 34 | activities/PresetComments | 评委端 |
| 37 | 活动监管 | — | — | 超管端 |
| 38 | 全部活动 | 37 | contests/Index | 超管端 |
| 39 | 报名数据 | 37 | contests/registrations/Index | 超管端 |
| 40 | 作品数据 | 37 | contests/works/Index | 超管端 |
| 41 | 评审进度 | 37 | contests/reviews/Progress | 超管端 |
| 42 | 评委管理 | 37 | contests/judges/Index | |
| 43 | 评审规则 | 37 | contests/reviews/Index | |
| 44 | 活动成果 | 37 | contests/results/Index | 超管端 |
| 45 | 通知管理 | 37 | contests/notices/Index | |
| 46 | 内容管理 | — | — | 超管端 |
| 47 | 作品审核 | 46 | content/WorkReview | 超管端 |
| 48 | 作品管理 | 46 | content/WorkManagement | 超管端 |
| 49 | 标签管理 | 46 | content/TagManagement | 超管端 |
| 50 | 工作台 | — | workbench/TenantDashboard | 租户端 |
| 51 | 机构信息 | 14 | system/tenant-info/Index | 租户端 |
| 52 | 数据统计 | — | — | 租户端 |
| 53 | 运营概览 | 52 | analytics/Overview | 租户端 |
| 54 | 评审分析 | 52 | analytics/Review | 租户端 |
六、技术实现要点
菜单加载逻辑（Java: SysMenuServiceImpl.getUserMenus）
1. 查询所有 valid_state=1 的菜单
2. 查询当前用户 tenant_id 对应的 t_sys_tenant_menu
3. 按 tenant_menus 过滤菜单
4. 如果是超管(isSuperAdmin)：不做权限码过滤
5. 如果是普通用户：按用户权限码过滤（菜单.permission 字段匹配用户 permissions）
6. 补全父菜单（确保树结构完整）
7. 构建树形结构返回
⚠️ 重要：超管也必须按 tenant_menus 过滤，不能返回全部菜单。之前的 bug 就是超管返回全部 52 个菜单导致错乱。
登录时租户识别
前端通过 URL 提取 tenantCode（如 /gdlib/login → tenantCode=gdlib），登录请求：
POST /api/auth/login
{"username": "admin", "password": "xxx", "tenantCode": "gdlib"}
Java 后端 AuthService.login 支持两种方式确定租户：
X-Tenant-Idheader（数字ID，优先）- body 中的
tenantCode（编码），后端通过t_sys_tenant.code查找租户ID
前端组件映射
菜单的 component 字段对应前端 menu.ts 中的 componentMap。如果某个 component 路径未在 componentMap 中注册，控制台会输出警告。已剥离的学校管理模块会有 6 条 warning，属预期行为。
权威来源
| 来源 | 用途 |
|---|---|
docs/design/menu-config.md |
本文档，菜单配置唯一权威 |
backend/data/menus.json |
菜单定义（所有菜单的字段） |
backend/scripts/init-menus.ts |
菜单初始化脚本（SUPER_TENANT_MENUS / NORMAL_TENANT_MENUS） |
t_sys_menu 表 |
数据库中的菜单数据 |
t_sys_tenant_menu 表 |
各端的菜单分配关系 |