主题
角色与场景
平台的权限模型由「租户 → 用户 → 角色 → 菜单/权限点」四层构成,角色不是写死的枚举,而是数据。本文给出 6 类角色的关键任务与对应功能点,再用 3 条端到端场景把它们串起来。
1. 角色总览
| 角色 | 身份与边界 | 主要入口 | 现状 |
|---|---|---|---|
| 平台管理员 | 系统租户(packageId=0)的用户,角色码 super_admin,可跨租户 | 租户、套餐、菜单、全局字典、全平台日志 | ✅ |
| 租户管理员 | 每开通一个租户时自动创建,角色码 tenant_admin | 本租户的组织、用户、角色、消息模板 | ✅ |
| 项目经理 | 没有专属角色,通常是租户内一个普通角色 + 部门负责人 | 部门、通知、文件;任务/工时/风险 🚧 | 🚧 |
| 项目成员 | 租户内普通用户,按角色获得菜单 | 个人中心、站内信、文件 | ✅ |
| 访客/客户 | App 端用户,用户类型 MEMBER | App 基础数据、短信登录;会员体系 ⏸ | ⏸ |
| 开发者 | 不进入业务界面,通过源码、接口索引、代码生成器工作 | 代码生成、接口索引、错误码、预留模块 | ✅ |
说明: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 新租户开通(平台侧 → 租户侧)
- 平台管理员建套餐:
POST /admin-api/system/tenant-package/create,menuIds决定该套餐能看到哪些菜单。 - 平台管理员建租户:
POST /admin-api/system/tenant/create,填名称、联系人、到期时间、packageId。 - 系统在同一事务内初始化:
TenantServiceImpl#L100→createRole(tenant_admin,绑定套餐菜单#L138)→createUser(管理员账号,#L123-L127)→ 回写联系人。 - 租户管理员首次登录:
POST /admin-api/system/auth/login(SYS-AUTH-01),图形验证码校验挂在AdminAuthServiceImpl#L105。 - 前端拉权限信息:
GET /admin-api/system/auth/get-permission-info(AuthController#L93),返回用户、角色、过滤后的菜单树,前端据此渲染。 - 租户管理员建部门、岗位、用户、角色(SYS-DEPT-01、SYS-ROLE-01)。
- 后续调套餐:改套餐菜单会同步所有使用该套餐的租户(
TenantPackageServiceImpl#L63-L65),不只是新租户。 - 租户到期后:任何带租户上下文的请求都会被
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 平台侧日常运维
- 早上看登录异常:
GET /admin-api/system/login-log/page(SYS-LOG-01)。 - 看接口错误:
GET /admin-api/infra/api-error-log/page(INF-LOG-02),按「已处理/未处理」过滤。 - 看定时任务执行情况:INF-JOB-02。注意:
localprofile 默认排除了 Quartz 自动配置(application-local.yaml#L10),此时任务接口会抛「定时任务 - 已禁用」(SchedulerManager#L143-L147)。 - 看 Redis 与连接池:INF-REDIS-01、INF-DS-01。
- 调参数不重启:
/admin-api/infra/config/*(INF-CONFIG-01)。 - 租户到期前续期:
PUT /admin-api/system/tenant/update(SYS-TENANT-01),否则下一个请求即被拦截。
4. 角色 × 能力矩阵
| 能力 | 平台管理员 | 租户管理员 | 项目经理 | 项目成员 | 访客/客户 | 开发者 |
|---|---|---|---|---|---|---|
| 租户与套餐 | ✅ 全部 | ✅ 只读本租户 | — | — | — | — |
| 组织与用户 | ✅ 跨租户 | ✅ 本租户 | ⏸ 只读 | — | — | — |
| 角色与授权 | ✅ 全部 | ✅ 本租户 | — | — | — | — |
| 消息与公告 | ✅ 全部 | ✅ 本租户 | ✅ 发送 | ✅ 接收 | ⏸ 仅 App | — |
| 文件 | ✅ 全部 | ✅ 本租户 | ✅ | ✅ | ⏸ | ✅ |
| 代码生成 | — | — | — | — | — | ✅ |
| PM 业务域 | 🚧 | 🚧 | 🚧 | 🚧 | 🚧 | 🚧 |
状态的读法:✅ 现在就能用;⏸ 代码在库但未接入运行时(12 个模块已纳入构建并编译通过,
ai暂不构建);🚧 尚未编码。同一格出现两种状态时,按最保守的那个理解。