143 lines
5.4 KiB
Markdown
143 lines
5.4 KiB
Markdown
---
|
||
name: session-20260613-3
|
||
description: 2026-06-13 第3次会话 — 头像401、菜单check-strictly、移动端全面优化、token/info接口、唯一键校验、数据权限、文档更新
|
||
metadata:
|
||
type: session
|
||
date: 2026-06-13
|
||
sessionNumber: 3
|
||
startTime: 2026-06-13T00:00:00+08:00
|
||
---
|
||
|
||
# 2026-06-13 第3次会话 — 完整记录
|
||
|
||
## 一、头像 401 修复
|
||
|
||
**根因**：文件服务 Token 一次一密，PersonalView.vue 上传和下载共用一个 Token，带 Token 的 URL 存入数据库 → 永久 401。
|
||
|
||
**修复**：
|
||
- `auth.ts`：fetchUserInfo() 和 login() 先刷新 Token 再设 userInfo
|
||
- `PersonalView.vue`：上传用 Token1（消费），下载用 Token2（新获取），DB 只存基础 URL
|
||
|
||
## 二、分配菜单 check-strictly
|
||
|
||
**RoleList.vue**：el-tree 加 `check-strictly`，节点独立勾选，父子不联动。
|
||
- 可以只勾"系统列表"不给新增/编辑/删除
|
||
|
||
## 三、移动端全面优化
|
||
|
||
### 3.1 操作列 → 桌面按钮行 / 手机卡片按钮
|
||
不再使用 CSS dropdown hack，改用 `useIsMobile()` composable + `v-if`
|
||
|
||
**composable**: `src/composables/useIsMobile.ts` — 响应式检测屏幕 ≤768px
|
||
|
||
**已改造**：RoleList, UserList, SystemList, MenuList, DictList, ApiList, FileList, EmailList, LoginLogList, OperationLogList, OpenTokenLogList
|
||
|
||
### 3.2 表单按钮全局统一
|
||
`global.css`：移动端 `.form-footer { flex-direction: column }` 取消/保存按钮等宽上下排列
|
||
|
||
### 3.3 分页滚动
|
||
`main.ts`：监听分页点击 → `window.scrollTo({ top: 0, behavior: 'smooth' })`
|
||
|
||
### 3.4 卡片样式
|
||
`global.css`：`.mobile-cards` / `.mobile-card` / `.card-field` / `.card-actions`
|
||
|
||
## 四、新增 GET /token/info 接口
|
||
|
||
- `OpenApiController.java`：`GET /zgapi/v1/open/token/info?token=xxx`
|
||
- 不消费 Token，从 JWT 解析 systemId/systemCode/systemName
|
||
- `TokenAuthFilter.java`：放行 `/zgapi/v1/open/token/info`
|
||
- `open-api-doc.md`：新增 §4
|
||
|
||
## 五、所有新增接口唯一键校验
|
||
|
||
| 接口 | 唯一约束 | 修复 |
|
||
|------|----------|------|
|
||
| 新增系统 | uk_system_code + uk_gateway_url | ✅ gatewayUrl 自动生成唯一值 |
|
||
| 新增用户 | uk_username + uk_email | ✅ 空邮箱→null，重复提示中文 |
|
||
| 新增角色 | uk_system_role_code | ✅ 系统+编码重复提示 |
|
||
| 新增字典 | uk_type_value | ✅ 类型+值重复提示 |
|
||
| 新增接口 | uk_system_path_method | ✅ 系统+路径+方法重复提示 |
|
||
|
||
## 六、全局数据权限
|
||
|
||
**架构**：`UserContextInterceptor` → `UserContextHolder`(ThreadLocal) → Service 层过滤
|
||
|
||
**规则**：roleCode=super_admin 看全部；其他角色只看绑定系统（sys_user_system）的数据
|
||
|
||
**新增文件**：
|
||
- `config/UserContextHolder.java` — ThreadLocal
|
||
- `config/UserContextInterceptor.java` — 拦截器，读 X-User-Roles 头
|
||
- `config/WebMvcConfig.java` — 注册拦截器
|
||
|
||
**修改的 Service**：
|
||
- RoleServiceImpl.page() — in(systemIds)
|
||
- SystemApiServiceImpl.page() — in(systemIds)
|
||
- LogServiceImpl.loginLogPage() — in(systemIds)
|
||
- UserServiceImpl.page() — 通过 sys_user_system 关联过滤
|
||
- SystemServiceImpl.page() — in(systemIds)
|
||
- SystemServiceImpl.add() — gatewayUrl 唯一值
|
||
|
||
**不做过滤**：
|
||
- 操作日志、Token日志（用户指定不要）
|
||
- 字典、邮件（无 system_id）
|
||
|
||
## 七、FileList 系统筛选
|
||
|
||
- 搜索栏新增"所属系统"下拉（systemCode / systemName）
|
||
- 表格新增"所属系统"列
|
||
- systemId 传给后端过滤
|
||
|
||
## 八、接入文档更新
|
||
|
||
### IntegrationDoc.vue（页面内文档）
|
||
- **§9.3** 下载文件：Token 支持 Header 和 Query 参数两种方式
|
||
- **§10** 新增对外开放 API 章节（Token 获取 + 邮件发送）
|
||
- **§3** 前端接入：localStorage → Cookie 读取 Token，说明跨域 Cookie 机制
|
||
- **§3.5** 登录回调：完整说明 Cookie Token 流程
|
||
|
||
### open-api-doc.md（独立文档）
|
||
- 下载文件 curl 示例增加 Query 参数方式
|
||
- 所有文档章节重新编号
|
||
|
||
## 修改文件总清单
|
||
|
||
**后端新增**：
|
||
- `config/UserContextHolder.java`
|
||
- `config/UserContextInterceptor.java`
|
||
- `config/WebMvcConfig.java`
|
||
|
||
**后端修改**：
|
||
- `OpenApiController.java` — +GET /token/info
|
||
- `TokenAuthFilter.java` — 放行 /token/info
|
||
- `UserServiceImpl.java` — 重复校验 + 数据权限 + 空邮箱→null
|
||
- `SystemServiceImpl.java` — systemCode/gatewayUrl 唯一性 + 数据权限
|
||
- `RoleServiceImpl.java` — 角色编码唯一性 + 数据权限
|
||
- `DictServiceImpl.java` — 字典值唯一性
|
||
- `SystemApiServiceImpl.java` — 接口唯一性 + 数据权限
|
||
- `LogServiceImpl.java` — 登录日志数据权限（操作日志不过滤）
|
||
- `FileController.java` — systemId 过滤已支持
|
||
|
||
**前端新增**：
|
||
- `composables/useIsMobile.ts`
|
||
|
||
**前端修改**：
|
||
- `auth.ts` — 头像 Token 刷新
|
||
- `PersonalView.vue` — 头像双 Token
|
||
- `global.css` — 移动端卡片 + 表单按钮
|
||
- `main.ts` — 分页滚动
|
||
- `RoleList.vue` — check-strictly + 手机卡片
|
||
- `UserList.vue` — 手机卡片
|
||
- `SystemList.vue` — 手机卡片
|
||
- `MenuList.vue` — 手机卡片
|
||
- `DictList.vue` — 手机卡片
|
||
- `ApiList.vue` — 手机卡片
|
||
- `FileList.vue` — 系统下拉过滤
|
||
- `EmailList.vue` — 手机卡片 + confirmDel
|
||
- `LoginLogList.vue` — 手机卡片
|
||
- `OperationLogList.vue` — 手机卡片
|
||
- `OpenTokenLogList.vue` — 手机卡片
|
||
|
||
**文档修改**：
|
||
- `docs/open-api-doc.md` — +token/info，下载 Query 参数
|
||
- `IntegrationDoc.vue` — Cookie Token + 邮件发送 + 下载方式
|