160 lines
8.4 KiB
Markdown
160 lines
8.4 KiB
Markdown
# 字段权限与字段个性化设计
|
||
|
||
> 状态：设计定稿，未实现。创建于 2026-09-04。
|
||
> 关联文档：[FMS新系统核心表结构设计.md](./FMS新系统核心表结构设计.md)（其中 s_power / s_role_power 部分）
|
||
|
||
## 1. 背景与目标
|
||
|
||
系统已有全局的字段显示配置（`s_field_view` / `s_field_edit`，在模块设计器中维护，对所有人生效）。本设计解决两个新需求：
|
||
|
||
1. **字段权限**：管理员（高权限角色）控制某个人/某些人**能不能看到**某些字段；
|
||
2. **字段个性化**：用户自己调整列表的**字段顺序、列宽、显示/隐藏**，且只影响自己、跨设备持久化。
|
||
|
||
范围约定：
|
||
|
||
- 个性化只作用于**列表**（查看态列表 + 可编辑列表两套配置），**表单不参与**顺序/布局个性化；
|
||
- 单公司系统（无多租户维度），后续如需多公司再扩展；
|
||
- 不考虑旧数据迁移难度。
|
||
|
||
## 2. 三层模型
|
||
|
||
```
|
||
第 1 层 默认配置（模板） s_field_view / s_field_edit 模块设计器维护，管理员设定
|
||
第 2 层 字段权限（谁能看） s_power(field型) + s_role_power 管理员按角色控制可见性
|
||
第 3 层 个人偏好（怎么摆） s_user_field_pref（新表） 用户自己拖拽，只影响自己
|
||
```
|
||
|
||
职责边界是本设计的核心原则：
|
||
|
||
- **权限决定"全集"**：deny 的字段对用户不存在（列表不渲染、后端不返回）；
|
||
- **偏好只决定"排列"**：顺序、宽度、个人显隐，永远在权限允许的范围内生效，无法越过权限；
|
||
- 终端用户能控制的只有自己的布局，可见性的控制权始终在管理员手里。
|
||
|
||
两层独立演化：将来权限规则变化，偏好数据不需要清洗（偏好里残留无权限字段只是无效数据，不构成越权）。
|
||
|
||
## 3. 数据结构
|
||
|
||
### 3.1 新表：s_user_field_pref（个人偏好）
|
||
|
||
一人 × 一模块 × 一字段 × 一模式 一行。每字段一行（而非 JSON 快照），可直接复用现有通用 CRUD（DataService）。
|
||
|
||
```sql
|
||
CREATE TABLE s_user_field_pref (
|
||
b_id VARCHAR(32) PRIMARY KEY,
|
||
b_user_id VARCHAR(32) NOT NULL,
|
||
b_module_id VARCHAR(32) NOT NULL,
|
||
b_field_id VARCHAR(32) NOT NULL,
|
||
b_mode VARCHAR(10) NOT NULL, -- 'view' 查看列表 / 'edit' 可编辑列表
|
||
b_visible TINYINT DEFAULT 1, -- 个人显隐（1 显示，0 隐藏）
|
||
b_xh INT, -- 个人顺序号
|
||
b_width INT, -- 个人列宽
|
||
b_update_time DATETIME,
|
||
UNIQUE KEY uk_user_field (b_user_id, b_module_id, b_field_id, b_mode)
|
||
);
|
||
```
|
||
|
||
说明：
|
||
|
||
- 用户**没有**保存过偏好的字段不产生行，解析时落回默认配置（`s_field_view` / `s_field_edit`）；
|
||
- 保存过布局 = 该用户该模块该 mode 存在偏好行，此后**默认布局变更对该用户不再生效**（保持用户自主摆放的稳定性），可通过"恢复默认"删除偏好行回到跟随默认；
|
||
- "恢复默认" = 删除该用户 + 该模块 + 该 mode 的全部行。
|
||
|
||
### 3.2 权限层：复用已有表 + 一张用户级覆盖表
|
||
|
||
- `s_power`（field 型：`b_module_id + b_field_id + b_operation`[view/edit]）与 `s_role_power`（`b_effect` allow/deny）沿用现有表结构，见 [FMS新系统核心表结构设计.md](./FMS新系统核心表结构设计.md)；
|
||
- 新增用户级覆盖表，用于个别用户的特例（平时应为空表，只为"开小灶"使用，不值得建角色时用它）：
|
||
|
||
```sql
|
||
CREATE TABLE s_user_power (
|
||
b_id VARCHAR(32) PRIMARY KEY,
|
||
b_user_id VARCHAR(32) NOT NULL,
|
||
b_module_id VARCHAR(32) NOT NULL,
|
||
b_field_id VARCHAR(32) NOT NULL,
|
||
b_operation VARCHAR(10) NOT NULL, -- 'view' / 'edit'
|
||
b_effect VARCHAR(10) NOT NULL, -- 'allow' / 'deny'
|
||
UNIQUE KEY uk_user_field_op (b_user_id, b_module_id, b_field_id, b_operation)
|
||
);
|
||
```
|
||
|
||
## 4. 解析算法
|
||
|
||
### 4.1 字段可见性（权限链）
|
||
|
||
```
|
||
可见性 = 用户级覆盖（s_user_power，有配置则生效，优先级最高）
|
||
↓ 该用户该字段无配置
|
||
角色合并（该用户所有角色的 s_role_power，deny 优先：任一角色 deny 即 deny）
|
||
↓ 无任何角色配置
|
||
默认可见（allow）
|
||
```
|
||
|
||
要点：
|
||
|
||
- **默认全部可见，黑名单式配置**：只为敏感字段配 deny，不为普通字段配 allow，维护量最小；
|
||
- deny 优先（而非 allow 优先）：敏感字段场景下更安全。
|
||
|
||
### 4.2 列表最终配置（合并链）
|
||
|
||
对查看列表和可编辑列表分别执行（mode = view / edit）：
|
||
|
||
```
|
||
最终配置 = 默认配置（s_field_view / s_field_edit，含 b_canuse 过滤）
|
||
→ 剔除权限 deny 的字段
|
||
→ 用个人偏好覆盖 b_xh / b_width / b_visible
|
||
→ 偏好中没有的字段，按默认配置的顺序追加补全
|
||
```
|
||
|
||
有效显示 = `权限可见 && 字段可用(b_canuse=1) && 个人未隐藏`。
|
||
|
||
补全规则保证：新增字段、默认配置新启用的字段，即使用户保存过布局也会按默认顺序出现在列表尾部，不会"消失"。
|
||
|
||
### 4.3 顺序合并细节
|
||
|
||
偏好只覆盖出现过的字段；用户保存布局后管理员再调默认顺序，对已保存用户无效（见 3.1）。
|
||
|
||
## 5. 边界场景约定
|
||
|
||
| 场景 | 行为 |
|
||
|---|---|
|
||
| 字段 `b_canuse=0`（下架） | 不进入候选集，即使偏好表里有该字段的行也不显示（偏好行成无效数据，暂不清理，量大后在字段下架入口顺带删除） |
|
||
| 新增字段 | 所有用户可见：无偏好则按默认顺序出现在尾部 |
|
||
| 权限从 allow 变 deny | 字段对用户消失；偏好数据保留，权限恢复后用户的自定义布局自动恢复 |
|
||
| 用户隐藏字段 vs 权限隐藏字段 | 是两回事：个人隐藏 = 有权看但暂时不显示，"栏位设置"弹窗可随时勾回；权限隐藏 = 对该用户不存在，弹窗中**不展示**无权限字段 |
|
||
| 必填字段被用户隐藏（可编辑列表） | **待定**，见第 8 节 |
|
||
|
||
## 6. 交互设计
|
||
|
||
- 列表列头拖拽排序、拖拽调宽（能力已有：`FmsTable.vue`）；
|
||
- 拖拽结束后防抖保存（约 500ms）upsert 到 `s_user_field_pref`；
|
||
- 菜单保留"保存/恢复栏位设置"，语义从全局改为个人："恢复"即删除偏好行；
|
||
- "栏位设置"弹窗：排序 + 个人显隐 + 列宽统一管理；不展示无权限字段；
|
||
- 可选：管理员入口"保存为全局默认"，仍写 `s_field_view` / `s_field_edit`。
|
||
|
||
## 7. 改动范围（实现清单）
|
||
|
||
| 位置 | 改动 |
|
||
|---|---|
|
||
| migration | 新增 `s_user_field_pref`、`s_user_power` 建表 |
|
||
| 后端 DataService | ① 字段权限过滤：deny 字段从查询结果中剔除（设计文档既定要求，目前后端零过滤）② 偏好表 CRUD 复用现有通用机制 |
|
||
| 前端 `stores/permissions.js` | 新增 `canField(moduleId, fieldId, operation)`：用户级 → 角色合并（deny 优先）→ 默认 allow |
|
||
| 前端 `FmsModuleListPage.vue` | `loadData` 中实现合并链（默认 → 权限过滤 → 偏好覆盖 → 补全）；`saveColumnSettings` 保存目标从 `s_field_view/s_field_edit` 改为 `s_user_field_pref` |
|
||
| 权限管理 UI | 模块管理 `ModuleFieldsPanel` 旁新增"字段权限"页签：选角色 × 勾字段（view/edit）；入口本身由现有模块/按钮权限（`canPower`）控制，实现"高权限的人才能配" |
|
||
| 用户级覆盖 UI | 可后置：先支持直接改 `s_user_power` 数据，界面后续补 |
|
||
|
||
关键实现纪律：**合并偏好的代码必须在权限过滤之后执行**，保证偏好永远无法越过权限。
|
||
|
||
## 8. 待定事项
|
||
|
||
**必填字段被用户隐藏后的校验策略**（可编辑列表场景）：
|
||
|
||
| 方案 | 规则 | 适用 |
|
||
|---|---|---|
|
||
| A. 所见即所验 | 隐藏后跳过必填校验 | "必填"只是引导性要求，空值可接受；且权限隐藏与用户隐藏行为天然统一，无需特殊分支 |
|
||
| B. 必填不可藏 | 可编辑列表中必填字段置灰、禁止隐藏 | "必填"是业务硬规则，字段空值会损害下游使用 |
|
||
|
||
判断标准：该字段空着，会不会有人受害。会 → B；不会 → A。权限隐藏（管理员 deny）场景下无论选哪个方案，行为都与 A 一致（用户"没有这个字段"，天然不校验）。
|
||
|
||
---
|
||
|
||
**结论摘要**：默认配置（全局模板）→ 字段权限（管理员按角色控制可见性，deny 优先，默认全可见，用户级覆盖兜底）→ 个人偏好（仅列表的顺序/列宽/显隐，权限范围内生效，未设置走默认）。
|