generated from youfool-project/youfool-prj-springboot3-template
chore: 移除规划临时文件追踪,更新.gitignore
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
parent
0f643376c0
commit
3e7f0414db
|
|
@ -3,3 +3,8 @@
|
|||
/target
|
||||
/.claude/
|
||||
/classpath.txt
|
||||
|
||||
# 规划临时文件(仅本地使用)
|
||||
/findings.md
|
||||
/progress.md
|
||||
/task_plan.md
|
||||
|
|
|
|||
150
findings.md
150
findings.md
|
|
@ -1,150 +0,0 @@
|
|||
# OARMS 权限体系设计 — 发现记录
|
||||
|
||||
## 现有代码分析
|
||||
|
||||
### 1. Sa-Token 框架集成现状
|
||||
|
||||
**配置**(application.yml):
|
||||
- token-name: `satoken`
|
||||
- timeout: 2592000s(30 天)
|
||||
- token-style: UUID
|
||||
- is-concurrent: true(允许并发登录)
|
||||
|
||||
**拦截器**(SpringMvcConfig):
|
||||
- 已注册 SaInterceptor
|
||||
- 当前仅 `StpUtil.checkLogin()`,无角色/权限校验
|
||||
- 白名单路径: `/user/auth/**`, `/test/**`, `/doc.html**`, `/swagger*`, `/cms/**`, `/network/ping`
|
||||
- 注释掉了按路由模块的权限检查(TODO)
|
||||
|
||||
### 2. 认证流程现状
|
||||
|
||||
**LoginController**:
|
||||
- POST `/user/auth/login` — 硬编码 userId,无密码校验,admin 权限
|
||||
- GET `/user/auth/login/info` — 从 session 取 UserBase
|
||||
- GET `/user/auth/logout` — StpUtil.logout()
|
||||
- GET `/user/auth/perm/list` — StpUtil.getPermissionList()(返回空列表)
|
||||
|
||||
**UserBaseServiceImpl**:
|
||||
- login() — 返回 null(未实现)
|
||||
- getCurrentUser() — 从 SaSession 取,异常时返回 guest
|
||||
- getUserInfoByLoginId() — 返回 null
|
||||
|
||||
### 3. 框架 UserBase 类
|
||||
|
||||
**来源**: youfool-framework-springboot3:1.0.4
|
||||
**包**: com.chinaweal.youfool.framework.springboot.user.entity.UserBase
|
||||
**已知字段**: username (String), permission (Set<String>)
|
||||
**已知方法**: setUsername(), setPermission()
|
||||
|
||||
**限制**: UserBase 字段较少,不满足 PRD 需求(需要 realName, roles, districtCode, orgName 等)
|
||||
**方案**: 创建 LoginUserVO 扩展返回信息,session 中存储 LoginUserVO 替代 UserBase
|
||||
|
||||
### 4. 前端权限现状
|
||||
|
||||
**user.js store**:
|
||||
- 登录响应取 headers 中的 satoken
|
||||
- getInfo() 获取用户信息(userId, username, role, permission, nickname)
|
||||
- roles 从 `data.role` 或 `data.permission` 转数组
|
||||
|
||||
**permission.js store**:
|
||||
- `hasPermission(roles, route)` — 检查 route.meta.roles
|
||||
- admin 角色直接放行所有路由
|
||||
- 非 admin 按角色过滤
|
||||
|
||||
**routes.js**:
|
||||
- constantRoutes: login, home, 404(roles: ['guest'])
|
||||
- asyncRoutes: 业务路由,**无 roles 配置**(依赖 admin 全通)
|
||||
|
||||
### 5. PRD 权限矩阵(各模块详细)
|
||||
|
||||
#### BS-1 大屏基础信息
|
||||
|
||||
| 操作 | 市局 | 区局 | 运营商 |
|
||||
|------|------|------|--------|
|
||||
| 查看列表 | 全市 | 本辖区 | 本公司 |
|
||||
| 新增 | Y | N | Y(本公司) |
|
||||
| 编辑 | Y | N | Y(本公司) |
|
||||
| 删除 | Y | N | N |
|
||||
| 导出 | 全市 | 本辖区 | N |
|
||||
|
||||
#### AM-1 录屏设置
|
||||
|
||||
| 操作 | 市局 | 区局 | 运营商 |
|
||||
|------|------|------|--------|
|
||||
| 查看配置 | 全市 | 本辖区 | 本公司 |
|
||||
| 新增/编辑 | Y | N | N |
|
||||
|
||||
#### AM-3 画面监控
|
||||
|
||||
| 操作 | 市局 | 区局 | 运营商 |
|
||||
|------|------|------|--------|
|
||||
| 查看监控 | 全市 | 本辖区 | 无权限 |
|
||||
| 处理监控 | Y | Y(本辖区) | 无权限 |
|
||||
|
||||
#### MR-1 监测规则
|
||||
|
||||
| 操作 | 市局 | 区局 | 运营商 |
|
||||
|------|------|------|--------|
|
||||
| 查看规则 | Y | Y(只读) | 无权限 |
|
||||
| 增删改 | Y | N | N |
|
||||
|
||||
#### CW-1~CW-4 预警流程
|
||||
|
||||
| 操作 | 市局 | 区局 | 运营商 |
|
||||
|------|------|------|--------|
|
||||
| 全部操作 | 全市 | 本辖区 | 无权限 |
|
||||
|
||||
### 6. 技术选型决策
|
||||
|
||||
| 决策点 | 选择 | 理由 |
|
||||
|--------|------|------|
|
||||
| 密码加密 | BCrypt | Spring Security 默认,安全可靠 |
|
||||
| 权限模型 | RBAC + 数据权限 | PRD 要求操作权限 + 数据范围 |
|
||||
| 权限粒度 | 模块:操作(如 screen:create) | 覆盖 PRD 全部场景 |
|
||||
| 数据权限 | Service 层动态过滤 | 不引入 AOP 复杂度 |
|
||||
| Session 存储 | SaSession 存 LoginUserVO | 复用现有 Sa-Token 机制 |
|
||||
| 前端按钮控制 | v-permission 指令 | Element Plus 生态常见方案 |
|
||||
|
||||
### 7. 包路径规划
|
||||
|
||||
系统管理模块放在 `modules/system/` 下:
|
||||
|
||||
```
|
||||
com.chinaweal.youfool.prj.modules.system/
|
||||
├── entity/ # SysUser/SysRole/SysPermission 等
|
||||
├── mapper/
|
||||
├── service/
|
||||
└── controller/
|
||||
```
|
||||
|
||||
与其他业务模块(screen, law, rule, monitor, evidence)平级。
|
||||
|
||||
### 8. 数据权限实现思路
|
||||
|
||||
数据权限需要在查询时动态追加条件:
|
||||
|
||||
```java
|
||||
// 在 Service 层
|
||||
LoginUserVO user = (LoginUserVO) StpUtil.getSession().get(USER_KEY);
|
||||
|
||||
if (user.getRoles().contains("CITY_SUPERVISOR")) {
|
||||
// 不过滤
|
||||
} else if (user.getRoles().contains("DISTRICT_SUPERVISOR")) {
|
||||
query.setDistrictCode(user.getDistrictCode());
|
||||
} else if (user.getRoles().contains("OPERATOR")) {
|
||||
query.setOrgName(user.getOrgName());
|
||||
}
|
||||
```
|
||||
|
||||
**影响范围**: 现有 10 个模块的 query 方法可能需要增加 districtCode/orgName 参数。
|
||||
**DDL 确认**: 现有表(如 bs_screen)已有 district 字段,可以用于辖区过滤。org_name 可通过大屏关联的业主/运营单位匹配。
|
||||
|
||||
---
|
||||
|
||||
## 风险与注意事项
|
||||
|
||||
1. **框架 UserBase 限制**: UserBase 字段少,需要扩展或替换 session 存储对象
|
||||
2. **现有接口兼容**: /user/auth/login/info 返回类型改变可能影响前端
|
||||
3. **数据权限复杂度**: 区局按辖区、运营商按公司,过滤条件不同
|
||||
4. **密码策略**: 初始密码、密码强度要求需确认
|
||||
5. **Swagger 分组**: 新增 system 模块需要加 springdoc 分组配置
|
||||
101
progress.md
101
progress.md
|
|
@ -1,101 +0,0 @@
|
|||
# OARMS 权限体系设计 — 进度日志
|
||||
|
||||
## 当前状态
|
||||
|
||||
**阶段**: 第一轮完成(Phase 1-3 + Phase 7 编译验证)
|
||||
**进度**: Phase 1/2/3/7 已完成
|
||||
|
||||
---
|
||||
|
||||
## 阶段进度
|
||||
|
||||
| 阶段 | 状态 | 备注 |
|
||||
|------|------|------|
|
||||
| Phase 1: DDL 设计 | ✅ 完成 | 5 张表 + 初始数据 |
|
||||
| Phase 2: Entity/Mapper | ✅ 完成 | system 模块 5 Entity + 5 Mapper + 2 Service |
|
||||
| Phase 3: 认证流程 | ✅ 完成 | LoginController + StpInterfaceImpl + UserBaseServiceImpl |
|
||||
| Phase 4: 鉴权+数据权限 | ✅ 完成 | 9 Controller 28 个方法添加 @SaCheckPermission |
|
||||
| Phase 5: 前端角色路由 | ✅ 完成 | routes.js + permission.js + user.js + v-permission |
|
||||
| Phase 6: 用户管理接口 | pending | 可选 |
|
||||
| Phase 7: 编译验证 | ✅ 完成 | BUILD SUCCESS |
|
||||
|
||||
---
|
||||
|
||||
## 会话记录
|
||||
|
||||
### 2026-05-24 — 权限体系规划
|
||||
|
||||
**操作**:
|
||||
1. 检查现有登录/用户模块实现 → 发现全部 TODO 未实现
|
||||
2. 确认 PRD 中有角色定义 → 第三章 3 个角色 + 操作权限 + 数据权限
|
||||
3. 研究后端代码 → Sa-Token 已集成,StpInterfaceImpl/LoginController/UserBaseServiceImpl 均未实现
|
||||
4. 研究前端代码 → 角色/路由框架存在,但仅 admin/guest
|
||||
5. 研究框架 UserBase → 字段有限(username, permission),需扩展
|
||||
|
||||
**结论**:
|
||||
- 现有代码是认证骨架,核心逻辑全部 TODO
|
||||
- PRD 定义了 3 角色 × 操作权限 + 数据权限的完整 RBAC 模型
|
||||
- 需从 DDL → Entity/Mapper → Service → Controller → 前端全链路实现
|
||||
|
||||
**设计决策**:
|
||||
- 5 张新表:SYS_USER, SYS_ROLE, SYS_USER_ROLE, SYS_PERMISSION, SYS_ROLE_PERMISSION
|
||||
- 新模块路径:modules/system/
|
||||
- 权限码格式:`module:action`(如 screen:create)
|
||||
- 数据权限:Service 层按角色动态追加查询条件
|
||||
- Session 存储:LoginUserVO 替代 UserBase
|
||||
|
||||
### 2026-05-24 — 第一轮执行(Phase 1-3 + 7)
|
||||
|
||||
**创建的文件**:
|
||||
|
||||
| 文件 | 说明 |
|
||||
|------|------|
|
||||
| `docs/db/sql/V11.0.0__SYS_system_ddl.sql` | 5 张表 DDL |
|
||||
| `docs/db/sql/V11.0.0__SYS_system_init_data.sql` | 3 角色 + 27 权限 + 3 用户 |
|
||||
| `modules/system/entity/SysUserEntity.java` | 用户实体 |
|
||||
| `modules/system/entity/SysRoleEntity.java` | 角色实体 |
|
||||
| `modules/system/entity/SysUserRoleEntity.java` | 用户角色关联实体 |
|
||||
| `modules/system/entity/SysPermissionEntity.java` | 权限实体 |
|
||||
| `modules/system/entity/SysRolePermissionEntity.java` | 角色权限关联实体 |
|
||||
| `modules/system/entity/vo/LoginUserVO.java` | 登录用户信息 VO |
|
||||
| `modules/system/entity/vo/SysUserVO.java` | 用户管理 VO |
|
||||
| `modules/system/entity/query/SysUserQuery.java` | 用户查询条件 |
|
||||
| `modules/system/mapper/SysUserMapper.java` | 用户 Mapper |
|
||||
| `modules/system/mapper/SysRoleMapper.java` | 角色 Mapper(含自定义 SQL) |
|
||||
| `modules/system/mapper/SysUserRoleMapper.java` | 用户角色关联 Mapper |
|
||||
| `modules/system/mapper/SysPermissionMapper.java` | 权限 Mapper(含自定义 SQL) |
|
||||
| `modules/system/mapper/SysRolePermissionMapper.java` | 角色权限关联 Mapper |
|
||||
| `modules/system/service/ISysUserService.java` | 用户 Service 接口 |
|
||||
| `modules/system/service/ISysRoleService.java` | 角色 Service 接口 |
|
||||
| `modules/system/service/impl/SysUserServiceImpl.java` | 用户 Service 实现 |
|
||||
| `modules/system/service/impl/SysRoleServiceImpl.java` | 角色 Service 实现 |
|
||||
| `config/PasswordConfig.java` | BCrypt 密码加密 Bean |
|
||||
|
||||
**修改的文件**:
|
||||
|
||||
| 文件 | 变更 |
|
||||
|------|------|
|
||||
| `controller/LoginController.java` | 数据库认证替代硬编码,返回 LoginUserVO |
|
||||
| `service/impl/StpInterfaceImpl.java` | 对接 SysRoleMapper/SysPermissionMapper |
|
||||
| `service/impl/UserBaseServiceImpl.java` | 从 LoginUserVO 转换 UserBase |
|
||||
| `pom.xml` | 添加 spring-security-crypto 依赖 |
|
||||
|
||||
**编译错误与修复**:
|
||||
|
||||
| 错误 | 修复 |
|
||||
|------|------|
|
||||
| `lambdaQuery()` 不存在 | ISysUserService 不继承 IService,改用 SysUserMapper 直接查询 |
|
||||
| `RestResult.fail()` 不存在 | 框架只有 `RestResult.ok()`,改用 `AssertUtils.isTrue()` |
|
||||
| `AssertUtils.isTrue(boolean, String)` 签名不匹配 | 改为三参数 `isTrue(boolean, ResultCode, String)` |
|
||||
|
||||
**编译结果**: BUILD SUCCESS
|
||||
|
||||
---
|
||||
|
||||
## 遇到的错误
|
||||
|
||||
| 错误 | 尝试次数 | 解决方案 |
|
||||
|------|---------|---------|
|
||||
| lambdaQuery() 在 ISysUserService 上不存在 | 1 | 改用 SysUserMapper.selectOne() |
|
||||
| RestResult.fail() 方法不存在 | 1 | 用 AssertUtils.isTrue() 替代 |
|
||||
| AssertUtils.isTrue(boolean, String) 签名不匹配 | 1 | 改为 isTrue(boolean, ResultCode, String) |
|
||||
389
task_plan.md
389
task_plan.md
|
|
@ -1,389 +0,0 @@
|
|||
# OARMS 权限体系设计与实现计划
|
||||
|
||||
## 目标
|
||||
|
||||
基于 PRD 第三章"角色权限"定义,设计并实现完整的 RBAC + 数据权限体系,覆盖后端认证/鉴权 + 前端路由/按钮控制。
|
||||
|
||||
## PRD 角色定义
|
||||
|
||||
| 角色 | 角色代码 | 操作范围 | 数据范围 |
|
||||
|------|---------|---------|---------|
|
||||
| 市局广告监管人员 | `CITY_SUPERVISOR` | 全模块读写 | 全市数据 |
|
||||
| 区局广告监管人员 | `DISTRICT_SUPERVISOR` | 监控/取证/规则只读 | 本辖区数据 |
|
||||
| 广告大屏运营商 | `OPERATOR` | 大屏维护/录屏查看 | 本公司大屏数据 |
|
||||
|
||||
## 当前状态
|
||||
|
||||
| 组件 | 现状 | 缺失 |
|
||||
|------|------|------|
|
||||
| Sa-Token 框架 | 已集成,拦截器已配置 | 仅 checkLogin,无角色/权限校验 |
|
||||
| LoginController | 硬编码 userId,admin 权限 | 无数据库校验 |
|
||||
| StpInterfaceImpl | 返回空列表 | 未对接数据库 |
|
||||
| UserBaseServiceImpl | login() 返回 null | 未实现 |
|
||||
| 数据库 | 无用户/角色表 | 需建表 |
|
||||
| 前端路由 | 仅 admin/guest | 需增加 3 个角色 |
|
||||
| 前端权限守卫 | admin 全通 | 需角色过滤 |
|
||||
|
||||
---
|
||||
|
||||
## 实现阶段(7 个 Phase)
|
||||
|
||||
### Phase 1:数据库设计 — 用户/角色/权限表(DDL)
|
||||
|
||||
在 OARMS schema 下创建系统管理相关表,表前缀 `sys_`。
|
||||
|
||||
**表设计**:
|
||||
|
||||
#### 1.1 `SYS_USER` 用户表
|
||||
|
||||
| 列名 | 类型 | 说明 |
|
||||
|------|------|------|
|
||||
| ID | VARCHAR(32) PK | UUID |
|
||||
| USERNAME | VARCHAR(50) NOT NULL UNIQUE | 登录用户名 |
|
||||
| PASSWORD | VARCHAR(100) NOT NULL | BCrypt 加密密码 |
|
||||
| REAL_NAME | VARCHAR(50) | 真实姓名 |
|
||||
| PHONE | VARCHAR(20) | 联系电话 |
|
||||
| ORG_NAME | VARCHAR(100) | 所属单位 |
|
||||
| DISTRICT_CODE | VARCHAR(20) | 所属区域编码(区局/运营商用) |
|
||||
| STATUS | TINYINT DEFAULT 1 | 1=正常 0=停用 |
|
||||
| + SuperEntity 审计字段 | | createBy/createTime/updateBy/updateTime/updateName |
|
||||
|
||||
#### 1.2 `SYS_ROLE` 角色表
|
||||
|
||||
| 列名 | 类型 | 说明 |
|
||||
|------|------|------|
|
||||
| ID | VARCHAR(32) PK | UUID |
|
||||
| ROLE_CODE | VARCHAR(30) NOT NULL UNIQUE | 角色编码(CITY_SUPERVISOR 等) |
|
||||
| ROLE_NAME | VARCHAR(50) NOT NULL | 角色显示名 |
|
||||
| DESCRIPTION | VARCHAR(200) | 描述 |
|
||||
| STATUS | TINYINT DEFAULT 1 | 1=正常 0=停用 |
|
||||
| + SuperEntity 审计字段 | | |
|
||||
|
||||
#### 1.3 `SYS_USER_ROLE` 用户角色关联表
|
||||
|
||||
| 列名 | 类型 | 说明 |
|
||||
|------|------|------|
|
||||
| ID | VARCHAR(32) PK | UUID |
|
||||
| USER_ID | VARCHAR(32) NOT NULL | 关联 SYS_USER.ID |
|
||||
| ROLE_ID | VARCHAR(32) NOT NULL | 关联 SYS_ROLE.ID |
|
||||
| + createBy/createTime | | |
|
||||
|
||||
#### 1.4 `SYS_PERMISSION` 权限表(操作权限码)
|
||||
|
||||
| 列名 | 类型 | 说明 |
|
||||
|------|------|------|
|
||||
| ID | VARCHAR(32) PK | UUID |
|
||||
| PERM_CODE | VARCHAR(50) NOT NULL UNIQUE | 权限编码(如 `screen:view`、`evidence:create`) |
|
||||
| PERM_NAME | VARCHAR(100) NOT NULL | 权限名称 |
|
||||
| MODULE | VARCHAR(30) | 所属模块(BS/LB/AM/MR/CW) |
|
||||
| + SuperEntity 审计字段 | | |
|
||||
|
||||
#### 1.5 `SYS_ROLE_PERMISSION` 角色权限关联表
|
||||
|
||||
| 列名 | 类型 | 说明 |
|
||||
|------|------|------|
|
||||
| ID | VARCHAR(32) PK | UUID |
|
||||
| ROLE_ID | VARCHAR(32) NOT NULL | 关联 SYS_ROLE.ID |
|
||||
| PERM_ID | VARCHAR(32) NOT NULL | 关联 SYS_PERMISSION.ID |
|
||||
| + createBy/createTime | | |
|
||||
|
||||
#### 1.6 初始数据
|
||||
|
||||
3 条角色 + 3 条管理员用户(各角色 1 个)+ 权限码 + 角色权限映射。
|
||||
|
||||
**权限码清单**(按模块):
|
||||
|
||||
| 权限码 | 说明 | 市局 | 区局 | 运营商 |
|
||||
|--------|------|------|------|--------|
|
||||
| `screen:view` | 查看大屏 | Y | Y(本辖区) | Y(本公司) |
|
||||
| `screen:create` | 新增大屏 | Y | N | Y(本公司) |
|
||||
| `screen:edit` | 编辑大屏 | Y | N | Y(本公司) |
|
||||
| `screen:remove` | 删除大屏 | Y | N | N |
|
||||
| `screen:export` | 导出大屏 | Y | Y(本辖区) | N |
|
||||
| `law:view` | 查看法律条款 | Y | Y | Y |
|
||||
| `law:create` | 新增条款 | Y | N | N |
|
||||
| `law:edit` | 编辑条款 | Y | N | N |
|
||||
| `law:remove` | 删除条款 | Y | N | N |
|
||||
| `monitoring-rule:view` | 查看规则 | Y | Y | N |
|
||||
| `monitoring-rule:create` | 新增规则 | Y | N | N |
|
||||
| `monitoring-rule:edit` | 编辑规则 | Y | N | N |
|
||||
| `monitoring-rule:remove` | 删除规则 | Y | N | N |
|
||||
| `recording-config:view` | 查看录屏配置 | Y | Y(本辖区) | Y(本公司) |
|
||||
| `recording-config:create` | 新增录屏配置 | Y | N | N |
|
||||
| `recording-config:edit` | 编辑录屏配置 | Y | N | N |
|
||||
| `recording-task:view` | 查看录屏任务 | Y | Y(本辖区) | Y(本公司) |
|
||||
| `monitor-record:view` | 查看监控记录 | Y | Y(本辖区) | N |
|
||||
| `monitor-record:handle` | 处理监控 | Y | Y(本辖区) | N |
|
||||
| `evidence:view` | 查看取证 | Y | Y(本辖区) | N |
|
||||
| `evidence:create` | 固化取证 | Y | Y(本辖区) | N |
|
||||
| `evidence-relation:view` | 查看规则关联 | Y | Y(本辖区) | N |
|
||||
| `evidence-relation:bind` | 关联规则 | Y | Y(本辖区) | N |
|
||||
| `monitoring-clue:view` | 查看线索 | Y | Y(本辖区) | N |
|
||||
| `monitoring-clue:create` | 生成线索 | Y | Y(本辖区) | N |
|
||||
| `clue-transfer:view` | 查看转办 | Y | Y(本辖区) | N |
|
||||
| `clue-transfer:create` | 发起转办 | Y | Y(本辖区) | N |
|
||||
|
||||
**数据权限**(不在权限码中,在角色级别控制):
|
||||
|
||||
| 角色 | 数据范围 | 实现方式 |
|
||||
|------|---------|---------|
|
||||
| CITY_SUPERVISOR | 全市 | 无 SQL 过滤 |
|
||||
| DISTRICT_SUPERVISOR | 本辖区 | 按 district_code 过滤 |
|
||||
| OPERATOR | 本公司 | 按 org_name 过滤 |
|
||||
|
||||
**阶段输出**: DDL SQL 文件 + 初始数据 SQL
|
||||
|
||||
**状态**: ✅ 完成
|
||||
|
||||
---
|
||||
|
||||
### Phase 2:后端 Entity/Mapper 层
|
||||
|
||||
按项目约定创建:
|
||||
|
||||
```
|
||||
modules/system/
|
||||
├── entity/
|
||||
│ ├── SysUserEntity.java
|
||||
│ ├── SysRoleEntity.java
|
||||
│ ├── SysUserRoleEntity.java
|
||||
│ ├── SysPermissionEntity.java
|
||||
│ ├── SysRolePermissionEntity.java
|
||||
│ ├── query/
|
||||
│ │ └── SysUserQuery.java
|
||||
│ └── vo/
|
||||
│ ├── SysUserVO.java
|
||||
│ └── LoginUserVO.java # 登录后返回给前端的信息
|
||||
├── mapper/
|
||||
│ ├── SysUserMapper.java
|
||||
│ ├── SysRoleMapper.java
|
||||
│ ├── SysUserRoleMapper.java
|
||||
│ ├── SysPermissionMapper.java
|
||||
│ └── SysRolePermissionMapper.java
|
||||
└── service/
|
||||
├── ISysUserService.java
|
||||
├── ISysRoleService.java
|
||||
└── impl/
|
||||
├── SysUserServiceImpl.java
|
||||
└── SysRoleServiceImpl.java
|
||||
```
|
||||
|
||||
**关键方法**:
|
||||
- `SysUserMapper.findByUsername(username)` — 登录查询
|
||||
- `SysRoleMapper.selectByUserId(userId)` — 查用户角色
|
||||
- `SysPermissionMapper.selectByUserId(userId)` — 查用户权限码
|
||||
- `SysPermissionMapper.selectByRoleCode(roleCode)` — 查角色权限
|
||||
|
||||
**LoginUserVO** 返回给前端的信息:
|
||||
```json
|
||||
{
|
||||
"userId": "...",
|
||||
"username": "...",
|
||||
"realName": "...",
|
||||
"roles": ["CITY_SUPERVISOR"],
|
||||
"roleNames": ["市局广告监管人员"],
|
||||
"permissions": ["screen:view", "screen:create", ...],
|
||||
"districtCode": null,
|
||||
"orgName": "广州市市场监督管理局"
|
||||
}
|
||||
```
|
||||
|
||||
**状态**: ✅ 完成
|
||||
|
||||
---
|
||||
|
||||
### Phase 3:认证流程实现(LoginController + StpInterfaceImpl)
|
||||
|
||||
#### 3.1 LoginController 改造
|
||||
|
||||
```
|
||||
POST /user/auth/login
|
||||
→ SysUserService.findByUsername(username)
|
||||
→ BCrypt.checkPassword(password, user.password)
|
||||
→ StpUtil.login(user.id)
|
||||
→ session.set(USER_KEY, LoginUserVO)
|
||||
→ response.setHeader("satoken", token)
|
||||
→ return RestResult.ok(LoginUserVO)
|
||||
```
|
||||
|
||||
#### 3.2 StpInterfaceImpl 实现
|
||||
|
||||
```
|
||||
getPermissionList(loginId) → SysPermissionMapper.selectByUserId(loginId)
|
||||
getRoleList(loginId) → SysRoleMapper.selectRoleCodesByUserId(loginId)
|
||||
```
|
||||
|
||||
#### 3.3 /user/auth/login/info 改造
|
||||
|
||||
返回 LoginUserVO(含 roles + permissions + districtCode + orgName)。
|
||||
|
||||
#### 3.4 UserBaseServiceImpl 完善
|
||||
|
||||
- login() 对接 SysUserService
|
||||
- getCurrentUser() 从 session 取 LoginUserVO
|
||||
|
||||
**状态**: ✅ 完成
|
||||
|
||||
---
|
||||
|
||||
### Phase 4:鉴权拦截器 + 数据权限
|
||||
|
||||
#### 4.1 SpringMvcConfig 权限路由
|
||||
|
||||
按模块配置权限检查:
|
||||
|
||||
```java
|
||||
SaRouter.match("/api/screen/**", r -> StpUtil.checkLogin());
|
||||
SaRouter.match("/api/monitoring-rule/**", r -> {
|
||||
StpUtil.checkLogin();
|
||||
// 具体 CRUD 方法用注解控制
|
||||
});
|
||||
// ... 其余模块类似
|
||||
```
|
||||
|
||||
#### 4.2 Controller 方法级权限注解
|
||||
|
||||
在需要权限控制的 Controller 方法上加:
|
||||
|
||||
```java
|
||||
@SaCheckPermission("screen:create")
|
||||
@PostMapping("save")
|
||||
public RestResult<?> save(...) { ... }
|
||||
|
||||
@SaCheckPermission("screen:remove")
|
||||
@PostMapping("remove")
|
||||
public RestResult<?> remove(...) { ... }
|
||||
```
|
||||
|
||||
#### 4.3 数据权限过滤
|
||||
|
||||
在 Service 层的查询方法中,根据当前用户的角色过滤数据:
|
||||
|
||||
- CITY_SUPERVISOR: 不过滤
|
||||
- DISTRICT_SUPERVISOR: 在 Query 中追加 `district_code = currentUser.districtCode`
|
||||
- OPERATOR: 在 Query 中追加 `org_name = currentUser.orgName`
|
||||
|
||||
实现方式:在 Service 中获取当前用户,动态拼装查询条件。
|
||||
|
||||
**注意**:数据权限需要修改现有 10 个模块的 Service 查询方法,影响范围较大。**建议先实现 Phase 1-3 的认证和操作权限,Phase 4 数据权限单独迭代。**
|
||||
|
||||
**实际实施**:
|
||||
- 创建 `DataScopeHelper` 工具类(`modules/system/util/`),提供角色判断静态方法
|
||||
- 修改 7 个 Service 的 queryList 方法,添加数据权限过滤:
|
||||
- ScreenServiceImpl: queryList + exportData + getScreenOptions
|
||||
- RecordingConfigServiceImpl: queryList + getConfigurableScreens
|
||||
- RecordingTaskServiceImpl: queryList
|
||||
- MonitorRecordServiceImpl: queryList
|
||||
- EvidenceRecordServiceImpl: queryList
|
||||
- MonitoringClueServiceImpl: queryList
|
||||
- ClueTransferServiceImpl: queryList + queryPendingClues
|
||||
- 过滤规则:
|
||||
- CITY_SUPERVISOR: 不过滤(全市数据)
|
||||
- DISTRICT_SUPERVISOR: 按 `district = currentUser.districtCode` 过滤
|
||||
- OPERATOR: Screen 按 `operatorUnit = orgName`,其他模块通过 screenId 关联 Screen 过滤
|
||||
- ClueTransferServiceImpl 特殊处理:OR 条件(转办目标辖区 + 线索来源辖区)
|
||||
- 跳过模块:LawClauseServiceImpl(无区域字段)、MonitoringRuleServiceImpl(复杂 scope JSON)、EvidenceRuleRelationServiceImpl(关联表)
|
||||
|
||||
**状态**: ✅ 完成
|
||||
|
||||
---
|
||||
|
||||
### Phase 5:前端角色路由映射
|
||||
|
||||
#### 5.1 定义角色常量
|
||||
|
||||
```javascript
|
||||
// src/utils/constants.js 或 src/router/roles.js
|
||||
export const ROLES = {
|
||||
CITY_SUPERVISOR: 'CITY_SUPERVISOR',
|
||||
DISTRICT_SUPERVISOR: 'DISTRICT_SUPERVISOR',
|
||||
OPERATOR: 'OPERATOR'
|
||||
}
|
||||
```
|
||||
|
||||
#### 5.2 更新 routes.js 的 meta.roles
|
||||
|
||||
按 PRD 权限矩阵为每个业务路由分配角色:
|
||||
|
||||
```javascript
|
||||
// BS-大屏基础库 - 三个角色都能访问
|
||||
meta: { roles: [ROLES.CITY_SUPERVISOR, ROLES.DISTRICT_SUPERVISOR, ROLES.OPERATOR] }
|
||||
|
||||
// MR-监测规则 - 市局+区局
|
||||
meta: { roles: [ROLES.CITY_SUPERVISOR, ROLES.DISTRICT_SUPERVISOR] }
|
||||
|
||||
// CW-内容预警 - 市局+区局
|
||||
meta: { roles: [ROLES.CITY_SUPERVISOR, ROLES.DISTRICT_SUPERVISOR] }
|
||||
```
|
||||
|
||||
#### 5.3 更新 permission.js
|
||||
|
||||
- 去掉 admin 硬编码全通逻辑
|
||||
- 使用后端返回的 permissions 数组做按钮级控制
|
||||
|
||||
#### 5.4 按钮级权限指令
|
||||
|
||||
添加 `v-permission` 指令,控制按钮显示:
|
||||
|
||||
```html
|
||||
<el-button v-permission="'screen:create'">新增</el-button>
|
||||
<el-button v-permission="'screen:remove'">删除</el-button>
|
||||
```
|
||||
|
||||
**状态**: ✅ 完成
|
||||
|
||||
---
|
||||
|
||||
### Phase 6:用户管理接口(可选)
|
||||
|
||||
提供用户 CRUD 接口供后台管理使用:
|
||||
|
||||
- `POST /api/sys-user/query` — 用户列表(分页)
|
||||
- `POST /api/sys-user/save` — 新增用户
|
||||
- `POST /api/sys-user/update` — 编辑用户
|
||||
- `POST /api/sys-user/remove` — 删除用户
|
||||
- `POST /api/sys-user/reset-password` — 重置密码
|
||||
- `GET /api/sys-user/role-options` — 角色选项列表
|
||||
|
||||
前端对应的管理页面可后续迭代。
|
||||
|
||||
**状态**: pending
|
||||
|
||||
---
|
||||
|
||||
### Phase 7:编译验证 + 端到端测试
|
||||
|
||||
1. DDL 执行到 DM8 数据库
|
||||
2. 后端编译通过(`mvn compile -Dcheckstyle.skip=true`)
|
||||
3. 启动后端,验证登录流程
|
||||
4. 验证权限校验(无权限返回 403)
|
||||
5. 前端 `npm run lint` 通过
|
||||
6. 前端登录后路由正确过滤
|
||||
|
||||
**状态**: ✅ 完成(BUILD SUCCESS)
|
||||
|
||||
---
|
||||
|
||||
## 实施建议
|
||||
|
||||
### 优先级排序
|
||||
|
||||
| 优先级 | Phase | 说明 |
|
||||
|--------|-------|------|
|
||||
| **P0 必须** | Phase 1-3 | DDL + Entity/Mapper + 认证流程,使登录对接真实数据库 |
|
||||
| **P1 重要** | Phase 5 | 前端角色路由,使不同角色看到不同菜单 |
|
||||
| **P2 增强** | Phase 4 | 操作权限注解 + 数据权限过滤 |
|
||||
| **P3 可选** | Phase 6 | 用户管理 CRUD |
|
||||
| **P0 验证** | Phase 7 | 编译 + 测试 |
|
||||
|
||||
### 建议实施路径
|
||||
|
||||
**第一轮(核心认证)**: Phase 1 → 2 → 3 → 7
|
||||
**第二轮(前端权限)**: Phase 5 → 7
|
||||
**第三轮(精细控制)**: Phase 4 → 6
|
||||
|
||||
---
|
||||
|
||||
## 修复决策
|
||||
|
||||
(实施过程中记录)
|
||||
Loading…
Reference in New Issue