oneao/workspace
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

20260907224521

Browse Source
This commit is contained in:
oneao committed 2026-09-07 22:45:21 +08:00
1 parent 1b596ffa5b
commit 2f5eac079e
4 files changed
+510 -294
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

code/fms/字段权限与用户个性化设计.md
+338 -225
View File
@@ -40,7 +40,7 @@
│ 数据模块 │
└──────┬───────┘
↓
s_data_scope
s_user_data_scope
↓
s_user_data_scope
↓
@@ -51,8 +51,7 @@
- `s_power`：定义「能做什么」
- `s_user_power`：定义「用户能做什么」
- `s_data_scope`：定义「能看到 / 操作哪些数据」
- `s_user_data_scope`：定义「用户在某个模块、某个操作下使用哪个数据范围」
- `s_user_data_scope`：定义「用户在某个模块、某个操作下可以作用于哪些数据」
---
@@ -76,7 +75,6 @@ power_cw_fee_amount_edit
menu.<MenuID>
action.<ActionID>
module.<ModuleID>.<Operation>
field.<ModuleID>.<Field>.<Operation>
page.<PageID>
report.<ReportID>
```
@@ -109,15 +107,6 @@ module.cw_fee.delete
module.cw_fee.export
```
**字段权限**
```text
field.cw_fee.mx_amount.view
field.cw_fee.mx_amount.edit
field.cw_fee.mx_amount.query
field.cw_fee.mx_amount.export
```
**页面权限**
```text
@@ -139,7 +128,6 @@ report.cw_fee_summary
| menu | 菜单入口 | `menu.<MenuID>` |
| action | 业务动作 | `action.<ActionID>` |
| module | 数据模块操作 | `module.<ModuleID>.<Operation>` |
| field | 字段能力 | `field.<ModuleID>.<Field>.<Operation>` |
| page | 页面入口 | `page.<PageID>` |
| report | 报表入口 | `report.<ReportID>` |
@@ -197,28 +185,7 @@ module.cw_fee.export
模块权限解决：用户对该业务模块具有什么数据操作能力。
### 5.4 field
例如：
```text
field.cw_fee.mx_amount.view
field.cw_fee.mx_amount.edit
field.cw_fee.mx_amount.query
field.cw_fee.mx_amount.export
```
字段权限解决：用户对某个字段具有什么能力。
需要注意：`field.xxx.edit` 只是权限允许编辑，并不代表字段最终一定可编辑。最终还要同时考虑：
- 字段权限
- `s_field_edit.b_readonly`
- `s_field_edit.b_disabled`
- 业务状态
- 业务规则
### 5.5 page
### 5.4 page
例如：
@@ -237,7 +204,7 @@ page.cw_fee
菜单解决入口展示 / 进入菜单，页面解决具体页面访问。
### 5.6 report
### 5.5 report
例如：
@@ -267,7 +234,7 @@ create table dbo.s_power (
b_i18n varchar(150) null,
b_power_type varchar(20) not null,
-- menu / action / module / field / page / report
-- menu / action / module / page / report
b_resource varchar(128) null,
-- action / page / report 等资源 ID
@@ -278,14 +245,10 @@ create table dbo.s_power (
b_module_id varchar(50) null,
-- 所属业务模块
b_field varchar(50) null,
-- field 权限对应字段
b_operation varchar(30) not null,
-- menu/page/report: access
-- action: execute
-- module: read/create/update/delete/export
-- field: view/edit/query/export
b_canuse tinyint not null default 1,
@@ -300,8 +263,6 @@ menu.cw_fee
action.cw_fee_audit
module.cw_fee.read
module.cw_fee.update
field.cw_fee.mx_amount.view
field.cw_fee.mx_amount.edit
page.cw_fee
report.cw_fee_summary
```
@@ -354,44 +315,11 @@ module.cw_fee.read
它并不表示：用户可以读取所有费用数据。
数据范围由 `s_data_scope` / `s_user_data_scope` 控制。
数据范围直接由 `s_user_data_scope` 控制。
---
## 9. s_data_scope
数据范围定义表。
```sql
create table dbo.s_data_scope (
b_id varchar(50) not null,
b_name nvarchar(200) not null,
b_i18n varchar(150) null,
b_module_id varchar(50) not null,
-- 数据权限作用的数据模块
b_scope_type varchar(30) not null,
-- own / department / department_tree / all / custom
b_scope_field varchar(50) null,
-- 业务数据中的归属字段
-- 例如 b_inputuser_id / b_department_id / b_owner_id
b_scope_value varchar(100) null,
-- custom 等场景使用
b_canuse tinyint not null default 1,
b_xh int not null default 0
);
```
---
## 10. s_user_data_scope
## 9. s_user_data_scope
用户数据权限授权表。
@@ -402,17 +330,23 @@ create table dbo.s_user_data_scope (
b_module_id varchar(50) not null,
b_operation varchar(30) not null,
-- read / create / update / delete / export
-- * / read / create / update / delete / export；* 表示模块默认范围
b_scope_id varchar(50) not null,
b_scope_level varchar(10) not null default 'default',
-- default / override；default 使用 b_operation='*'
b_xh int not null default 0,
b_scope_no int not null default 1,
b_scope_type varchar(30) not null,
-- own / department / department_tree / all / custom
b_scope_field varchar(50) null,
b_scope_value varchar(100) null,
b_updatedatetime datetime2 null
);
```
多个 Scope 同时存在时：
多个同级范围同时存在时：
```text
Scope A OR Scope B OR Scope C
@@ -423,12 +357,12 @@ Scope A OR Scope B OR Scope C
```text
张三
cw_fee
read
* / read / update
├── department
└── own
```
表示张三读取费用数据时：department 范围 OR own 范围。
表示同一操作下多个范围按 OR 合并；具体操作没有 override 时回退到 `b_operation='*'` 的默认范围。
---
@@ -467,15 +401,6 @@ module.cw_fee.delete
module.cw_fee.export
```
字段：
```text
field.cw_fee.mx_amount.view
field.cw_fee.mx_amount.edit
field.cw_fee.mx_amount.query
field.cw_fee.mx_amount.export
```
---
## 12. 用户授权示例
@@ -486,7 +411,6 @@ field.cw_fee.mx_amount.export
- `module.cw_fee.read`
- `module.cw_fee.update`
- `action.cw_fee_audit`
- `field.cw_fee.mx_amount.view`
```sql
insert into dbo.s_user_power (
@@ -498,11 +422,10 @@ values
('zhangsan', 'menu.cw_fee', 1),
('zhangsan', 'module.cw_fee.read', 1),
('zhangsan', 'module.cw_fee.update', 1),
('zhangsan', 'action.cw_fee_audit', 1),
('zhangsan', 'field.cw_fee.mx_amount.view', 1);
('zhangsan', 'action.cw_fee_audit', 1);
```
张三没有 `module.cw_fee.delete`、`field.cw_fee.mx_amount.edit`，所以：
张三没有 `module.cw_fee.delete`，并且金额字段策略为 `view`，所以：
- 不能删除费用
- 不能修改金额字段
@@ -511,50 +434,30 @@ values
## 13. 数据范围示例
定义：
```sql
insert into dbo.s_data_scope (
b_id,
b_name,
b_module_id,
b_scope_type,
b_scope_field,
b_canuse,
b_xh
)
values
(
'scope.cw_fee.department',
N'本部门',
'cw_fee',
'department',
'b_department_id',
1,
0
);
```
然后授权：
直接授权：
```sql
insert into dbo.s_user_data_scope (
b_user_id,
b_module_id,
b_operation,
b_scope_id,
b_xh
b_scope_level,
b_scope_no,
b_scope_type,
b_scope_field
)
values (
'zhangsan',
'cw_fee',
'read',
'scope.cw_fee.department',
0
'*',
'default',
1,
'department',
'b_department_id'
);
```
此时张三拥有 `module.cw_fee.read`，并且 read 数据范围 = 本部门。
此时张三拥有 `module.cw_fee.read`，并且 read 数据范围回退为本部门。若再增加 `update + override + own`，则修改范围只限本人创建的数据。
最终不是「张三可以读取全部费用」，而是「张三可以读取自己有权限范围内的费用」。
@@ -612,12 +515,12 @@ module.cw_fee.update
| 能不能进入页面 | `page.*` |
| 能不能执行审核 | `action.*` |
| 能不能修改费用 | `module.cw_fee.update` |
| 能不能看到金额 | `field.cw_fee.mx_amount.view` |
| 能不能修改金额 | `field.cw_fee.mx_amount.edit` |
| 能不能查询金额 | `field.cw_fee.mx_amount.query` |
| 能不能导出金额 | `field.cw_fee.mx_amount.export` |
| 能不能看到金额 | `s_user_field_permission.b_access_mode in ('view','edit')` |
| 能不能修改金额 | `s_user_field_permission.b_access_mode = 'edit'` |
| 能不能查询金额 | `s_user_field_permission.b_allow_query = 1` |
| 能不能导出金额 | `s_user_field_permission.b_allow_export = 1` |
| 能不能看报表 | `report.*` |
| 能看哪些数据 | `s_data_scope` |
| 能看哪些数据 | `s_user_data_scope` |
---
@@ -638,10 +541,6 @@ s_module
↓
module.<ModuleID>.<Operation>
s_field
↓
field.<ModuleID>.<Field>.<Operation>
Page 定义
↓
page.<PageID>
@@ -661,16 +560,7 @@ module.cw_air_fee.delete
module.cw_air_fee.export
```
新增字段 `mx_tax`，可以自动注册：
```text
field.cw_air_fee.mx_tax.view
field.cw_air_fee.mx_tax.edit
field.cw_air_fee.mx_tax.query
field.cw_air_fee.mx_tax.export
```
不需要开发人员另外维护 Power 编码。
新增字段 `mx_tax` 后，由模块字段元数据和用户字段策略直接控制，不生成 `s_power` 权限点。
---
@@ -697,7 +587,7 @@ field.cw_air_fee.mx_tax.export
用户个性化
```
例如：用户没有 `field.cw_fee.mx_amount.view`，即使 `s_user_field_pref.b_visible = 1`，也不能显示金额字段。
例如：用户字段策略为 `hidden` 时，即使 `s_user_field_pref.b_visible = 1`，也不能显示金额字段。
---
@@ -710,8 +600,9 @@ field.cw_air_fee.mx_tax.export
│
├──────────────┐
↓ ↓
s_field s_data_scope
│ │
s_field
│
├──────────────┐
↓ ↓
s_power s_user_data_scope
│
@@ -748,26 +639,25 @@ page / report
本设计的核心原则可以归纳为：
- 资源 ID = 资源本身的 ID
- Power ID = 资源类型 + 资源 ID + Operation
- `s_power.b_id` 是内部主键，`s_power.b_code` 是系统生成的可读业务键；
- 权限唯一性由资源类型、资源编码、owner 和能力字段共同保证；
- 字段权限直接使用 `s_user_field_permission` 的访问策略；
- 数据范围直接使用 `s_user_data_scope`，不再建立独立的范围模板表。
统一规则：
权限业务键示例：
```text
menu.<MenuID>
action.<ActionID>
module.<ModuleID>.<Operation>
field.<ModuleID>.<Field>.<Operation>
page.<PageID>
report.<ReportID>
```
其中：
- `b_id` 是稳定的业务权限编码，不需要人工随机生成。
- `s_power` 是统一权限注册表。
- `s_user_power` 是用户操作权限。
- `s_data_scope` 是数据范围定义。
- `s_user_data_scope` 是用户数据范围授权。
- 操作权限和数据权限完全分离。
- 菜单不负责数据范围。
@@ -779,99 +669,322 @@ report.<ReportID>
## 20. Demo 数据（4 张表）
以下为 4 张表的示例数据，沿用正文的 `cw_fee` 费用模块。示例用户：张三（费用会计）、李四（财务经理）。
以下为新权限模型的示例数据，沿用 `cw_fee` 费用模块。示例用户：张三（费用会计）、李四（财务经理）。数据范围直接保存在 `s_user_data_scope`，不再维护独立的范围模板表。
### 20.1 s_power（权限定义）
| b_id | b_name | b_power_type | b_resource | b_menu_id | b_module_id | b_field | b_operation | b_canuse | b_xh |
| --------------------------------- | ---------- | ------------ | --------------- | --------- | ----------- | ---------- | ----------- | -------- | ---- |
| menu.cw_fee | 费用管理菜单 | menu | cw_fee | cw_fee | null | null | access | 1 | 10 |
| page.cw_fee | 费用页面 | page | cw_fee | cw_fee | null | null | access | 1 | 20 |
| action.cw_fee_audit | 费用审核 | action | cw_fee_audit | cw_fee | cw_fee | null | execute | 1 | 30 |
| action.cw_fee_unaudit | 费用反审核 | action | cw_fee_unaudit | cw_fee | cw_fee | null | execute | 1 | 40 |
| module.cw_fee.read | 费用读取 | module | null | cw_fee | cw_fee | null | read | 1 | 10 |
| module.cw_fee.create | 费用新增 | module | null | cw_fee | cw_fee | null | create | 1 | 20 |
| module.cw_fee.update | 费用修改 | module | null | cw_fee | cw_fee | null | update | 1 | 30 |
| module.cw_fee.delete | 费用删除 | module | null | cw_fee | cw_fee | null | delete | 1 | 40 |
| module.cw_fee.export | 费用导出 | module | null | cw_fee | cw_fee | null | export | 1 | 50 |
| field.cw_fee.mx_amount.view | 金额可查看 | field | null | cw_fee | cw_fee | mx_amount | view | 1 | 10 |
| field.cw_fee.mx_amount.edit | 金额可编辑 | field | null | cw_fee | cw_fee | mx_amount | edit | 1 | 20 |
| field.cw_fee.mx_amount.query | 金额可查询 | field | null | cw_fee | cw_fee | mx_amount | query | 1 | 30 |
| field.cw_fee.mx_amount.export | 金额可导出 | field | null | cw_fee | cw_fee | mx_amount | export | 1 | 40 |
| report.cw_fee_summary | 费用汇总报表 | report | cw_fee_summary | cw_fee | cw_fee | null | access | 1 | 60 |
| b_id | b_code | b_name | b_power_type | b_resource_id | b_owner_type | b_owner_id | b_capability | b_canuse | b_xh |
| ---: | --- | --- | --- | --- | --- | --- | --- | ---: | ---: |
| 1001 | menu.cw_fee.access | 费用管理菜单 | menu | cw_fee | null | null | access | 1 | 10 |
| 1002 | page.cw_fee.access | 费用页面 | page | cw_fee | null | null | access | 1 | 20 |
| 1003 | action.module.cw_fee.audit.execute | 费用审核 | action | audit | module | cw_fee | execute | 1 | 30 |
| 1004 | action.module.cw_fee.unaudit.execute | 费用反审核 | action | unaudit | module | cw_fee | execute | 1 | 40 |
| 1005 | module.cw_fee.read | 费用读取 | module | cw_fee | null | null | read | 1 | 50 |
| 1006 | module.cw_fee.create | 费用新增 | module | cw_fee | null | null | create | 1 | 60 |
| 1007 | module.cw_fee.update | 费用修改 | module | cw_fee | null | null | update | 1 | 70 |
| 1008 | module.cw_fee.delete | 费用删除 | module | cw_fee | null | null | delete | 1 | 80 |
| 1009 | module.cw_fee.export | 费用导出 | module | cw_fee | null | null | export | 1 | 90 |
| 1010 | report.cw_fee_summary.access | 费用汇总报表 | report | cw_fee_summary | null | null | access | 1 | 100 |
要点：覆盖全部 6 种 `b_power_type`；`b_id` 由类型 + 资源 + 操作自动拼出，`b_module_id` / `b_field` 等列是解析冗余，便于按模块、字段反查权限。
`b_id` 是内部主键，`b_code` 是全局唯一业务键。动作的 `b_resource_id` 是动作编码，`b_owner_type/b_owner_id` 标识所属模块；因此不同模块可以同时拥有 `audit` 动作而不冲突。
### 20.2 s_user_power（用户授权）
| b_user_id | b_power_id | b_canuse | b_updatedatetime |
| --------- | ------------------------------ | -------- | -------------------- |
| zhangsan | menu.cw_fee | 1 | 2026-02-01 09:00:00 |
| zhangsan | page.cw_fee | 1 | 2026-02-01 09:00:00 |
| zhangsan | module.cw_fee.read | 1 | 2026-02-01 09:00:00 |
| zhangsan | module.cw_fee.update | 1 | 2026-02-01 09:00:00 |
| zhangsan | module.cw_fee.export | 1 | 2026-02-01 09:00:00 |
| zhangsan | module.cw_fee.delete | **0** | 2026-02-10 14:30:00 |
| zhangsan | action.cw_fee_audit | 1 | 2026-02-01 09:00:00 |
| zhangsan | field.cw_fee.mx_amount.view | 1 | 2026-02-01 09:00:00 |
| zhangsan | field.cw_fee.mx_amount.query | 1 | 2026-02-01 09:00:00 |
| zhangsan | report.cw_fee_summary | 1 | 2026-02-01 09:00:00 |
| lisi | menu.cw_fee | 1 | 2026-01-15 10:00:00 |
| lisi | page.cw_fee | 1 | 2026-01-15 10:00:00 |
| lisi | module.cw_fee.read | 1 | 2026-01-15 10:00:00 |
| lisi | module.cw_fee.create | 1 | 2026-01-15 10:00:00 |
| lisi | module.cw_fee.update | 1 | 2026-01-15 10:00:00 |
| lisi | module.cw_fee.delete | 1 | 2026-01-15 10:00:00 |
| lisi | module.cw_fee.export | 1 | 2026-01-15 10:00:00 |
| lisi | action.cw_fee_audit | 1 | 2026-01-15 10:00:00 |
| lisi | action.cw_fee_unaudit | 1 | 2026-01-15 10:00:00 |
| lisi | field.cw_fee.mx_amount.view | 1 | 2026-01-15 10:00:00 |
| lisi | field.cw_fee.mx_amount.edit | 1 | 2026-01-15 10:00:00 |
| lisi | field.cw_fee.mx_amount.export | 1 | 2026-01-15 10:00:00 |
| b_user_id | b_power_id | b_canuse | b_updatedatetime |
| --- | ---: | ---: | --- |
| zhangsan | 1001 | 1 | 2026-02-01 09:00:00 |
| zhangsan | 1002 | 1 | 2026-02-01 09:00:00 |
| zhangsan | 1005 | 1 | 2026-02-01 09:00:00 |
| zhangsan | 1007 | 1 | 2026-02-01 09:00:00 |
| zhangsan | 1009 | 1 | 2026-02-01 09:00:00 |
| zhangsan | 1008 | 0 | 2026-02-10 14:30:00 |
| zhangsan | 1003 | 1 | 2026-02-01 09:00:00 |
| zhangsan | 1010 | 1 | 2026-02-01 09:00:00 |
| lisi | 1001 | 1 | 2026-01-15 10:00:00 |
| lisi | 1002 | 1 | 2026-01-15 10:00:00 |
| lisi | 1005 | 1 | 2026-01-15 10:00:00 |
| lisi | 1006 | 1 | 2026-01-15 10:00:00 |
| lisi | 1007 | 1 | 2026-01-15 10:00:00 |
| lisi | 1008 | 1 | 2026-01-15 10:00:00 |
| lisi | 1009 | 1 | 2026-01-15 10:00:00 |
| lisi | 1003 | 1 | 2026-01-15 10:00:00 |
| lisi | 1004 | 1 | 2026-01-15 10:00:00 |
| lisi | 1010 | 1 | 2026-01-15 10:00:00 |
要点：
张三的 `1008` 对应 `module.cw_fee.delete`，记录存在但已停用，因此仍然没有删除权限。
- 张三的 `module.cw_fee.delete` 记录存在但 `b_canuse = 0`，演示「授权被手动停用 = 无权限」，与「无记录 = 无权限」效果相同；
- 张三没有 `field.cw_fee.mx_amount.edit`，金额字段对他只读；李四全量字段能力。
### 20.3 s_user_field_permission（字段访问策略）
### 20.3 s_data_scope（数据范围定义）
| b_user_id | b_module_id | b_field | b_access_mode | b_allow_query | b_allow_export | b_canuse |
| --- | --- | --- | --- | ---: | ---: | ---: |
| zhangsan | cw_fee | mx_amount | view | 1 | 0 | 1 |
| zhangsan | cw_fee | mx_internal_cost | hidden | 0 | 0 | 1 |
| lisi | cw_fee | mx_amount | edit | 1 | 1 | 1 |
| lisi | cw_fee | mx_internal_cost | view | 1 | 0 | 1 |
| b_id | b_name | b_module_id | b_scope_type | b_scope_field | b_scope_value | b_canuse | b_xh |
| ------------------------------ | ------------ | ----------- | ---------------- | ---------------- | ------------- | -------- | ---- |
| scope.cw_fee.own | 仅本人 | cw_fee | own | b_inputuser_id | null | 1 | 10 |
| scope.cw_fee.department | 本部门 | cw_fee | department | b_department_id | null | 1 | 20 |
| scope.cw_fee.department_tree | 本部门及下属 | cw_fee | department_tree | b_department_id | null | 1 | 30 |
| scope.cw_fee.all | 全部费用 | cw_fee | all | null | null | 1 | 40 |
| scope.cw_fee.custom_project | 指定项目 | cw_fee | custom | b_project_id | PRJ001 | 1 | 50 |
要点：`own` / `department` / `department_tree` / `all` 靠 `b_scope_type` 语义过滤，`b_scope_field` 指向业务表的归属字段；`custom` 额外用 `b_scope_value` 指定具体值。
张三对金额字段是“可见、只读、可查询、不可导出”；对内部成本字段完全不可见。李四可以编辑和导出金额，但内部成本字段仍然只读。
### 20.4 s_user_data_scope（用户数据范围授权）
| b_user_id | b_module_id | b_operation | b_scope_id | b_xh | b_updatedatetime |
| --------- | ----------- | ----------- | ---------------------------- | ---- | ------------------- |
| zhangsan | cw_fee | read | scope.cw_fee.department | 0 | 2026-02-01 09:00:00 |
| zhangsan | cw_fee | read | scope.cw_fee.own | 10 | 2026-02-01 09:00:00 |
| zhangsan | cw_fee | update | scope.cw_fee.own | 0 | 2026-02-01 09:00:00 |
| lisi | cw_fee | read | scope.cw_fee.department_tree | 0 | 2026-01-15 10:00:00 |
| lisi | cw_fee | update | scope.cw_fee.department_tree | 0 | 2026-01-15 10:00:00 |
| lisi | cw_fee | delete | scope.cw_fee.all | 0 | 2026-01-15 10:00:00 |
| b_user_id | b_module_id | b_operation | b_scope_level | b_scope_type | b_scope_field | b_scope_value | b_scope_no | b_updatedatetime |
| --------- | ----------- | ----------- | ------------- | ---------------- | --------------- | ------------- | ---------- | ------------------- |
| zhangsan | cw_fee | * | default | department | b_department_id | null | 1 | 2026-02-01 09:00:00 |
| zhangsan | cw_fee | update | override | own | b_inputuser_id | null | 1 | 2026-02-01 09:00:00 |
| lisi | cw_fee | * | default | department_tree | b_department_id | null | 1 | 2026-01-15 10:00:00 |
| lisi | cw_fee | delete | override | all | null | null | 1 | 2026-01-15 10:00:00 |
要点：
- 张三 read 挂了两条范围 → 部门数据 OR 本人数据；
- 数据范围按操作分开授权：张三能看本部门，但只能改自己录的费用（update 仅 own）；
- 李四 delete 挂 `all`，经理可删全模块数据，符合「操作越重、范围越收」或「管理者放宽」都可表达的弹性。
- 张三使用模块默认范围读取本部门数据，但 update 有操作级覆盖，只能修改本人录入的费用；
- 李四使用默认范围处理一般操作，但 delete 有操作级覆盖为 `all`，经理可删全模块数据。
### 20.5 组合结果解读
| 能力 | 张三（费用会计） | 李四（财务经理） |
| ---------------- | ---------------------------------------- | -------------------------------- |
| 看菜单 / 页面 | ✅ | ✅ |
| 读取费用数据 | ✅ 本部门 + 本人 | ✅ 本部门及下属部门 |
| 读取费用数据 | ✅ 本部门 | ✅ 本部门及下属部门 |
| 新增 | ❌ 无 module.create | ✅ |
| 修改 | ✅ 仅本人录入的单据 | ✅ 本部门及下属部门的单据 |
| 删除 | ❌ 授权已停用（b_canuse=0） | ✅ 全部数据 |
| 审核 / 反审核 | ✅ 可审核，❌ 不可反审核 | ✅ 都可以 |
| 金额字段 | 可看、可查询、❌ 不可编辑、❌ 不可导出字段列 | 可看、可编辑、可导出 |
| 金额字段 | 可见、只读、可查询、不可导出 | 可见、可编辑、可查询、可导出 |
| 内部成本字段 | 不可见 | 可见但只读 |
| 汇总报表 | ✅ | ✅（报表数据仍受 read 范围约束） |
---
## 21. 权限模型重构（当前生效方案）
### 21.1 重构原因
旧方案有两个结构性问题：
1. `s_power.b_id` 同时承担数据库主键和业务权限编码。权限编码一旦变化会影响授权记录；动作编码在不同菜单/模块下重复时，`action.<ActionID>` 也无法保证全局唯一。
2. 字段权限被拆成多个彼此独立的 `view/edit/query/export` 权限点，不能直接表达“不可见”“可见但只读”“可见且可编辑”等实际权限状态，也容易出现 `edit=1、view=0` 这种无效组合。
新方案将“权限点身份”和“字段访问策略”分开：
- `s_power` 只保存菜单、页面、报表、模块、动作等可执行能力；
- `s_user_field_permission` 保存字段访问级别及查询/导出能力；
- `b_id` 只做内部主键，业务侧使用不可变且全局唯一的 `b_code`；
- 动作权限必须带上所属资源的命名空间，不再使用裸 `action.<ActionID>`。
### 21.2 s_power：内部主键与业务编码分离
```sql
create table dbo.s_power (
b_id bigint not null, -- 内部主键，雪花/序列生成，不表达业务含义
b_code varchar(300) not null, -- 稳定、全局唯一的业务键，由系统生成
b_name nvarchar(200) not null,
b_i18n varchar(150) null,
b_power_type varchar(20) not null, -- menu/page/report/module/action
b_resource_id varchar(128) not null, -- 当前权限对应的资源编码
b_owner_type varchar(20) null, -- action 的 owner 类型
b_owner_id varchar(128) null, -- action 的 owner 编码
b_capability varchar(30) not null, -- access/execute/read/create/update/delete/export
b_canuse tinyint not null default 1,
b_xh int not null default 0,
constraint PK_s_power primary key (b_id),
constraint UQ_s_power_code unique (b_code),
constraint CK_s_power_type check (b_power_type in ('menu','page','report','module','action')),
constraint CK_s_power_shape check (
(b_power_type in ('menu','page','report')
and b_owner_type is null and b_owner_id is null
and b_capability = 'access')
or (b_power_type = 'module'
and b_owner_type is null and b_owner_id is null
and b_capability in ('read','create','update','delete','export'))
or (b_power_type = 'action'
and b_owner_type in ('menu','page','module')
and b_owner_id is not null
and b_capability = 'execute')
)
);
create index IX_s_power_resource
on dbo.s_power (b_power_type, b_owner_type, b_owner_id, b_resource_id, b_canuse);
```
`b_code` 是由结构化身份规范化生成的唯一键，不允许人工随意修改。资源编码应使用稳定的业务键（建议只允许字母、数字、`_`、`-`），更名应通过资源迁移完成，而不是直接改写已发布权限的身份。推荐格式：
```text
menu.cw_fee.access
page.cw_fee.access
report.cw_fee_summary.access
module.cw_fee.read
action.module.cw_fee.audit.execute
```
动作至少包含 `owner_type + owner_id + action_id` 三段。两个模块都可以定义 `audit`，但它们会生成不同的 `b_code`。跨多个资源的动作必须为每个资源建立独立权限点，或指定明确的系统级 owner。
### 21.3 s_user_power：引用内部主键
```sql
create table dbo.s_user_power (
b_user_id varchar(50) not null,
b_power_id bigint not null,
b_canuse tinyint not null default 1,
b_updatedatetime datetime2 null,
constraint PK_s_user_power primary key (b_user_id, b_power_id)
);
create index IX_s_user_power_user
on dbo.s_user_power (b_user_id, b_canuse, b_power_id);
```
授权、审计和关联查询使用 `b_power_id`；接口、缓存键、日志中需要可读标识时使用 `s_power.b_code`。权限名称或编码生成规则变化不会破坏数据库关联。
### 21.4 字段权限独立为访问策略
字段权限是有顺序的访问级别，不是四个互不相关的动作。新增用户字段策略表：
```sql
create table dbo.s_user_field_permission (
b_user_id varchar(50) not null,
b_module_id varchar(50) not null,
b_field varchar(128) not null,
b_access_mode varchar(10) not null, -- hidden / view / edit
b_allow_query tinyint not null default 0,
b_allow_export tinyint not null default 0,
b_canuse tinyint not null default 1,
b_updatedatetime datetime2 null,
constraint PK_s_user_field_permission
primary key (b_user_id, b_module_id, b_field),
constraint CK_s_user_field_permission_mode
check (b_access_mode in ('hidden','view','edit')),
constraint CK_s_user_field_permission_capability
check (b_access_mode <> 'hidden' or (b_allow_query = 0 and b_allow_export = 0))
);
create index IX_s_user_field_permission_module
on dbo.s_user_field_permission (b_user_id, b_module_id, b_canuse, b_field);
```
| `b_access_mode` | 返回字段 | 页面显示 | 可编辑 |
| --------------- | -------- | -------- | ------ |
| `hidden` | 否 | 否 | 否 |
| `view` | 是 | 是 | 否 |
| `edit` | 是 | 是 | 是 |
`b_allow_query` 和 `b_allow_export` 是附加能力，不能把 `hidden` 字段变成可查询或可导出字段。没有有效记录时按 `hidden` 处理。
系统元数据中的 `s_field_view`、`s_field_edit`、`s_field_query` 仍然只负责默认布局、只读、禁用和查询布局，不承担用户授权。最终字段状态按以下规则计算：
```text
用户字段策略（hidden/view/edit）
↓
模块字段元数据：b_visible、b_readonly、b_disabled（只能收紧）
↓
业务状态与业务规则
↓
最终字段状态
```
因此 `edit` 遇到 `b_readonly=1` 或 `b_disabled=1` 时降为 `view`，`b_visible=0` 时最终为 `hidden`。用户个性化不能恢复 `hidden` 字段，也不能把 `view` 变成 `edit`。
### 21.5 字段授权示例
```sql
insert into dbo.s_user_field_permission
(b_user_id, b_module_id, b_field, b_access_mode, b_allow_query, b_allow_export)
values
('zhangsan', 'cw_fee', 'mx_amount', 'view', 1, 0),
('lisi', 'cw_fee', 'mx_amount', 'edit', 1, 1);
```
写接口必须同时检查 `module.<module>.update`、字段最终为 `edit`、以及 update 数据范围。
### 21.6 权限判定顺序（重构后）
```text
① 用户有效
② menu/page/report 入口权限（如适用）
③ action 权限（如适用）
④ module 操作权限
⑤ 字段策略：hidden / view / edit + query/export
⑥ 数据范围
⑦ 元数据只读/禁用、业务状态和业务规则
⑧ 执行操作
```
入口权限、模块权限、字段策略、数据范围是 AND 关系；同一用户多个数据范围仍按 OR 合并。
### 21.7 旧数据迁移规则
1. 原 `s_power.b_id` 字符串迁移到新表的 `b_code`；新 `b_id` 重新生成，`s_user_power.b_power_id` 通过旧编码映射到新主键。
2. 原 `action.<ActionID>` 根据 `b_module_id` 或菜单归属补全 owner，生成 `action.<OwnerType>.<OwnerID>.<ActionID>.execute`。无法唯一确定归属的记录不得自动合并。
3. 原字段权限按用户、模块、字段聚合：有有效 `edit` 则为 `edit`，否则有有效 `view` 则为 `view`，否则为 `hidden`；`query`、`export` 映射到附加标志，并受 `hidden` 约束。
4. 迁移完成后旧字段权限记录删除或归档，权限服务只读取新模型，避免新旧模型同时生效。
### 21.8 数据范围配置 UI：默认范围 + 操作级覆盖
数据范围底层仍按“模块 + 操作”保存，但管理界面不要求管理员一开始就配置每个操作。采用两层配置：
#### 默认配置
用户选择一个模块后，先设置一个默认数据范围：
```text
默认数据范围：仅本人 / 仅本部门 / 本部门及下属 / 全部 / 自定义
```
默认范围应用于该模块所有需要数据过滤的操作。底层只保存一条模块默认记录：
```text
* -> 默认范围
```
对于不适用的操作（例如用户没有 `module.<module>.delete`），不生成数据范围记录也不会产生权限。
#### 操作级覆盖
在默认范围旁提供“按操作单独设置”入口。管理员展开后，可以针对具体操作覆盖默认值：
```text
查询 read ：跟随默认范围 = 本部门
新增 create ：跟随默认范围
修改 update ：仅本人
删除 delete ：无权限或不配置
导出 export ：跟随默认范围 = 本部门
```
操作级覆盖只改变该操作的数据过滤条件，不会授予操作权限。用户仍然必须拥有对应的 `s_power` 权限。
#### 保存与读取规则
`s_user_data_scope` 使用来源标识和通配操作，区分默认值和覆盖值：
```sql
b_scope_level varchar(10) not null default 'default'
-- default = 来自模块默认范围
-- override = 操作级覆盖
b_operation = '*'
-- 仅 default 级别允许使用 '*'
```
同一用户、模块、操作最多保留一组生效配置：
- 没有具体操作的 `override` 记录时，运行时回退到 `b_operation='*'` 的 `default` 范围；
- 存在 `override` 记录时，只对该操作使用覆盖范围；
- 一个操作可以配置多条范围，多条范围之间仍按 `OR` 合并；
- UI 中的“无权限”表示不生成该操作的范围，同时仍以 `s_user_power` 为最终操作权限判断依据。
#### 典型示例
管理员只配置：
```text
cw_fee 默认数据范围 = 本部门
```
然后展开操作级配置，将修改覆盖为“仅本人”：
```text
s_user_data_scope
cw_fee + * + department (default)
cw_fee + update + own (override)
```
最终效果就是：张三可以查询和导出本部门费用，但只能修改本人创建的费用。这个例子也是保留操作级数据范围能力的主要原因。