---
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 + 邮件发送 + 下载方式