Skip to content

角色与场景 ​

平台的权限模型由「租户 → 用户 → 角色 → 菜单/权限点」四层构成,角色不是写死的枚举,而是数据。本文给出 6 类角色的关键任务与对应功能点,再用 3 条端到端场景把它们串起来。

1. 角色总览 ​

角色身份与边界主要入口现状
平台管理员系统租户(packageId=0)的用户,角色码 super_admin,可跨租户租户、套餐、菜单、全局字典、全平台日志✅
租户管理员每开通一个租户时自动创建,角色码 tenant_admin本租户的组织、用户、角色、消息模板✅
项目经理没有专属角色,通常是租户内一个普通角色 + 部门负责人部门、通知、文件;任务/工时/风险 🚧🚧
项目成员租户内普通用户,按角色获得菜单个人中心、站内信、文件✅
访客/客户App 端用户,用户类型 MEMBERApp 基础数据、短信登录;会员体系 ⏸⏸
开发者不进入业务界面,通过源码、接口索引、代码生成器工作代码生成、接口索引、错误码、预留模块✅

说明:super_admin 的跨租户能力不是「多给几个菜单」,而是在权限校验入口直接放行(SecurityFrameworkServiceImpl#L32-L34 的 skipPermissionCheck),因此平台管理员的接口不应暴露给租户侧。租户管理员的角色在租户创建时由 TenantServiceImpl#L131-L138 生成,并直接绑定所选套餐的菜单集合。

2. 角色关键任务 ​

2.1 平台管理员 ​

关键任务对应功能点状态
新建/修改租户套餐,勾选套餐包含的菜单SYS-TENANT-02✅
开通租户、填联系人、设到期时间SYS-TENANT-01✅
维护菜单树与权限点标识SYS-PERM-01✅
维护全局字典(地区、状态、类型)SYS-DICT-01、SYS-DICT-02✅
查看全平台登录/操作/接口日志SYS-LOG-01、INF-LOG-01✅

2.2 租户管理员 ​

关键任务对应功能点状态
建部门树、设负责人,建岗位SYS-DEPT-01、SYS-POST-01✅
建用户、分配部门与岗位、重置密码SYS-USER-01✅
建角色并勾选菜单,设置数据权限范围SYS-ROLE-01、SYS-PERM-02✅
配站内信/邮件/短信模板与渠道SYS-NOTIFY-02、SYS-MAIL-01、SYS-SMS-01✅
查看本租户操作日志SYS-LOG-02✅

2.3 项目经理 ​

关键任务对应功能点状态
组织项目组:建一个部门代表项目,指定负责人SYS-DEPT-01✅ 变通
拆任务、指派到人、跟踪状态任务(PM 域)🚧
收集工时、审批、看负载工时(PM 域)🚧
发项目通知、拉群式沟通SYS-NOTIFY-01、SYS-NOTICE-01✅
归档交付物、共享文档INF-FILE-01✅
每周自动催报INF-JOB-01✅ 生产可用

2.4 项目成员 ​

关键任务对应功能点状态
账号密码 / 短信 / 社交登录SYS-AUTH-01、SYS-AUTH-05✅
改头像、手机号、密码SYS-USER-02✅
收站内信、标记已读、看未读数SYS-NOTIFY-01✅
上传交付物、下载附件INF-FILE-01✅
填工时、写日报工时(PM 域)🚧

2.5 访客 / 客户 ​

关键任务对应功能点状态
短信验证码登录(App 端)SYS-AUTH-01、SYS-SMS-01✅
拉取 App 端基础数据(字典、地区、配置)SYS-APP-01✅
查看与自己相关的项目进度项目报表(PM 域)🚧
会员等级、积分、权益会员模块(MBR)⏸

2.6 开发者 ​

关键任务对应功能点状态
从数据库表生成 CRUD 骨架(单表/树表/主子表)INF-CODEGEN-01✅
查某个接口属于哪个 Controller、哪个权限点/code/api/system、/reference/索引-按代码找功能✅
按错误码定位异常来源/reference/错误码段✅
启用一个休眠业务模块/modules/reserved⏸
新增 PM 域模块并申请错误码段领域模型🚧

3. 端到端场景 ​

3.1 新租户开通(平台侧 → 租户侧) ​

  1. 平台管理员建套餐:POST /admin-api/system/tenant-package/create,menuIds 决定该套餐能看到哪些菜单。
  2. 平台管理员建租户:POST /admin-api/system/tenant/create,填名称、联系人、到期时间、packageId。
  3. 系统在同一事务内初始化:TenantServiceImpl#L100 → createRole(tenant_admin,绑定套餐菜单 #L138)→ createUser(管理员账号,#L123-L127)→ 回写联系人。
  4. 租户管理员首次登录:POST /admin-api/system/auth/login(SYS-AUTH-01),图形验证码校验挂在 AdminAuthServiceImpl#L105。
  5. 前端拉权限信息:GET /admin-api/system/auth/get-permission-info(AuthController#L93),返回用户、角色、过滤后的菜单树,前端据此渲染。
  6. 租户管理员建部门、岗位、用户、角色(SYS-DEPT-01、SYS-ROLE-01)。
  7. 后续调套餐:改套餐菜单会同步所有使用该套餐的租户(TenantPackageServiceImpl#L63-L65),不只是新租户。
  8. 租户到期后:任何带租户上下文的请求都会被 TenantSecurityWebFilter#L97 拦下并抛 TENANT_EXPIRE。

容易出错的地方:套餐菜单变化是「重设 + 求交」两套逻辑(TenantServiceImpl#L194 起),给小套餐时非管理员角色会被裁剪为交集;租户名与域名有唯一性校验(#L102、#L104)。

3.2 一个项目从立项到结项(当前能力下的最小闭环) ​

阶段现在怎么做依赖状态
立项建部门「XX 项目组」,负责人设为项目经理;项目编号/阶段写进字典SYS-DEPT-01、SYS-DICT-01✅ 变通
组建团队用户挂到该部门,按角色给菜单;数据权限设「本部门」SYS-USER-01、SYS-ROLE-01✅
计划阶段、优先级、任务类型先用字典约定;里程碑只能用公告/文档承载SYS-DICT-02、SYS-NOTICE-01🚧
执行任务拆分与状态流转没有实体;用站内信指派 + 文件归档交付物SYS-NOTIFY-01、INF-FILE-01🚧
周报定时任务 + 邮件模板推送催报提醒INF-JOB-01、SYS-MAIL-01✅
工时无工时表,只能线下统计后导出工时(PM 域)🚧
结项公告结项、归档文件、关闭部门与角色、回收账号SYS-NOTICE-01、INF-FILE-01✅ 变通

结论:沟通与归档能跑,任务、工时、风险跑不了。这正说明 PM 域的 6 个功能点不是「锦上添花」,而是当前闭环缺的那几块。

3.3 平台侧日常运维 ​

  1. 早上看登录异常:GET /admin-api/system/login-log/page(SYS-LOG-01)。
  2. 看接口错误:GET /admin-api/infra/api-error-log/page(INF-LOG-02),按「已处理/未处理」过滤。
  3. 看定时任务执行情况:INF-JOB-02。注意:local profile 默认排除了 Quartz 自动配置(application-local.yaml#L10),此时任务接口会抛「定时任务 - 已禁用」(SchedulerManager#L143-L147)。
  4. 看 Redis 与连接池:INF-REDIS-01、INF-DS-01。
  5. 调参数不重启:/admin-api/infra/config/*(INF-CONFIG-01)。
  6. 租户到期前续期:PUT /admin-api/system/tenant/update(SYS-TENANT-01),否则下一个请求即被拦截。

4. 角色 × 能力矩阵 ​

能力平台管理员租户管理员项目经理项目成员访客/客户开发者
租户与套餐✅ 全部✅ 只读本租户————
组织与用户✅ 跨租户✅ 本租户⏸ 只读———
角色与授权✅ 全部✅ 本租户————
消息与公告✅ 全部✅ 本租户✅ 发送✅ 接收⏸ 仅 App—
文件✅ 全部✅ 本租户✅✅⏸✅
代码生成—————✅
PM 业务域🚧🚧🚧🚧🚧🚧

状态的读法:✅ 现在就能用;⏸ 代码在库但未接入运行时(12 个模块已纳入构建并编译通过,ai 暂不构建);🚧 尚未编码。同一格出现两种状态时,按最保守的那个理解。