workspace/code/fms/字段权限与用户个性化设计.md

FMS 权限体系、字段权限与用户个性化设计

0. 总体约定

本系统是 SQL 驱动的内部 ERP，权限表和模块配置表主要用于生成通用查询、写入和界面配置规则。权限采用“入口默认拒绝、其它能力默认放行、用户配置负责收紧”的策略：

• menu/access 和 action/execute 属于入口或动作权限，必须存在有效的用户授权记录；page/access、report/access 仅在页面或报表需要独立入口控制时启用，启用后同样必须存在有效授权记录；
• module/read|create|update|delete|export 未配置用户授权时默认放行；s_power 权限点或用户授权记录存在 b_canuse = 0 时明确禁用；
• 字段没有有效的用户字段策略时，按模块字段默认配置执行，不额外限制查询、编辑和导出；有效字段策略只能收紧权限；
• 数据范围没有配置时按 all 处理；有配置时先使用操作级 override，没有 override 再使用模块默认的 * 范围；同一层级多条范围按 OR 合并；
• 用户个性化只影响列表布局、查询收起态、顺序和宽度，不得越过字段权限、字段启用状态或数据范围；
• 数据库层不建 check 约束，字段取值及组合规则由业务层校验（见各表下方「业务层约束」）。

权限过滤、字段裁剪和数据范围条件最终必须在后端 SQL 中落实，前端隐藏菜单、按钮和字段只用于界面展示。

资源与权限归属

权限以业务模块为核心，不以菜单或 Vue 路由为核心：

资源	主要职责	是否授予模块数据权限
menu	导航入口、菜单显示	否
page	逻辑页面访问（按需启用）	否
module	读取、新增、修改、删除、导出、字段和数据范围	是
action	审核、反审核、核销等具体业务动作	通常绑定业务模块
Vue 路由/组件	技术实现和页面复用	否

• 菜单或页面权限不会自动授予所使用模块的权限；
• 一个页面可以使用多个模块，一个模块可以被多个页面复用，模块权限始终按模块自身计算；
• Vue 路由和组件不是稳定的权限标识。page 权限使用稳定的逻辑页面编码，不使用路由路径或组件名称；
• s_menu.b_module_id（如果保留）只表示菜单的默认/主模块，不能表示页面使用的全部模块，也不能触发权限继承；
• 普通菜单页面通常只配置菜单入口权限。只有需要独立直接访问的页面，才额外定义 page/access 权限，避免客户重复勾选菜单和页面。

复合页面和公共页面

以海运详细页为例：

海运详细页
├── sea_main
├── container_main
├── container_detail
├── finance_main
└── finance_detail

技术人员只需配置一次“页面使用哪些模块”的关系。页面打开后，各模块分别检查自己的 read、字段权限和数据范围：

• 必需模块没有读取权限时，页面不能完成正常业务，可以拒绝进入；
• 非必需模块没有读取权限时，隐藏对应页签或区域；
• 页面权限、菜单权限和模块权限互不继承；
• 同一个公共 Vue 页面被多个模块使用时，以当前页面配置和实际 module_id 判断权限，不以路由名称判断权限。

动作权限按业务归属配置：有明确业务主模块时使用 action.module.<module_id>.<action_id>.execute；真正跨模块且没有主模块的页面流程才使用 action.page.<page_id>.<action_id>.execute；不把动作绑定到 Vue 路由或公共组件。

权限计算顺序

一个页面或接口按以下顺序计算最终权限：

1. 用户账号和对应资源是否启用；
2. 菜单入口是否有有效授权；存在独立页面/报表权限时，再检查对应入口授权；
3. 当前动作是否有有效 action/execute 授权；
4. 当前模块操作是否被 s_power 或 s_user_power.b_canuse = 0 明确禁用，未配置时按默认放行；
5. 根据模块字段元数据和用户字段策略裁剪字段、查询和导出能力；
6. 根据数据范围的 override、default 或 all 生成 SQL 行条件；
7. 在以上结果基础上应用用户列表布局和查询布局偏好。

页面显示权限和接口执行权限必须使用同一套计算规则。前端可以提前隐藏无权限内容，但不能代替后端 SQL 的最终判断。

1. 表结构

1.1 s_power（权限定义表）

create table dbo.s_power (
    b_id bigint not null,                 -- 内部主键，雪花/序列生成，不表达业务含义
    b_code varchar(300) not null,         -- 稳定、全局唯一的业务键，由系统生成
                                          -- 示例：menu.cw_fee.access / module.cw_fee.read / action.module.cw_fee.audit.execute
    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 类型：menu/page/module
    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)
);

create index IX_s_power_resource
    on dbo.s_power (b_power_type, b_owner_type, b_owner_id, b_resource_id, b_canuse);

业务层约束（数据库不建 check 约束，由业务层校验）：

• b_power_type 只能取 menu / page / report / module / action；
• menu / page / report 类型：b_owner_type、b_owner_id 必须为空，b_capability 固定为 access；
• module 类型：b_owner_type、b_owner_id 必须为空，b_capability 只能取 read / create / update / delete / export；
• action 类型：b_owner_type 只能取 menu / page / module，b_owner_id 必填，b_capability 固定为 execute。

1.2 s_user_power（用户权限授权表）

create table dbo.s_user_power (
    b_user_id varchar(50) not null,
    b_power_id bigint not null,           -- 引用 s_power.b_id（内部主键）
    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);

1.3 s_user_field_permission（用户字段访问策略表）

create table dbo.s_user_field_permission (
    b_user_id varchar(50) not null,
    b_module_id varchar(50) not null,
    b_field varchar(50) 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)
);

create index IX_s_user_field_permission_module
    on dbo.s_user_field_permission (b_user_id, b_module_id, b_canuse, b_field);

业务层约束（数据库不建 check 约束，由业务层校验）：

• b_access_mode 只能取 hidden / view / edit；
• b_access_mode = 'hidden' 时，b_allow_query 和 b_allow_export 必须同时为 0；
• 没有 b_canuse = 1 的有效记录时，该字段按模块字段默认配置执行，不视为 hidden。

1.4 s_user_data_scope（用户数据范围授权表）

create table dbo.s_user_data_scope (
    b_user_id varchar(50) not null,

    b_module_id varchar(50) not null,

    b_operation varchar(30) not null,
    -- * / read / create / update / delete / export
    -- * 表示模块默认范围，仅 b_scope_level = 'default' 时允许使用

    b_scope_level varchar(10) not null default 'default',
    -- default / override；default 使用 b_operation='*'，override 为操作级覆盖

    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,
    primary key (b_user_id, b_module_id, b_operation, b_scope_level, b_scope_no)
);

create index IX_s_user_data_scope_module
    on dbo.s_user_data_scope (b_user_id, b_module_id, b_operation, b_scope_level, b_scope_type);

数据范围计算规则：

1. 先查询当前操作的 override 记录；存在时只使用 override，忽略模块默认范围；
2. 没有 override 时使用 operation = '*' 的 default 记录；
3. 默认范围和操作覆盖都没有配置时，按 all 处理，不追加数据行过滤条件；
4. 同一层级存在多条范围记录时按 OR 合并；b_scope_no 只用于区分同级范围行；
5. read、export、update、delete 在 SQL 行条件中应用范围；create 在写入前校验新增数据是否符合范围。

配置流程

技术人员按以下顺序配置，避免在每个页面重复维护权限：

1. 配置模块、字段和模块默认布局；
2. 配置菜单、逻辑页面及页面使用的模块关系；
3. 由系统按菜单、页面、模块和动作定义生成 s_power；
4. 在用户授权界面按入口、动作、模块限制、字段限制、数据范围分组展示；
5. 客户通常只需要勾选可进入的菜单和可执行的动作，再配置少量模块禁用、敏感字段和数据范围限制。

客户不需要为每个页面重复勾选 module.read、module.update 等权限。模块操作默认放行，只有禁止某个操作时才保存 s_user_power.b_canuse = 0；字段和数据范围也只保存需要收紧的例外配置。

页面与模块的多对多关系属于系统配置数据，建议由独立的页面模块关系配置维护。该关系表的最终结构在《FMS新系统核心表结构设计.md》统一整理前，本文件只约定其业务语义，不在本文件重复定义核心表。

1.5 s_user_field_pref（用户列表布局偏好表）

create table dbo.s_user_field_pref (
    b_user_id varchar(50) not null,
    b_module_id varchar(50) not null,
    b_field varchar(50) not null,
    b_mode varchar(10) not null, -- view / edit
    b_visible tinyint not null default 1,
    b_xh int not null default 0,
    b_width int null,
    b_updatedatetime datetime2 null,
    primary key (b_user_id, b_module_id, b_field, b_mode)
);

create index IX_s_user_field_pref_order
    on dbo.s_user_field_pref (b_user_id, b_module_id, b_mode, b_xh, b_field);

1.6 s_user_query_field_pref（用户查询布局偏好表）

create table dbo.s_user_query_field_pref (
    b_user_id varchar(50) not null,
    b_module_id varchar(50) not null,
    b_field varchar(50) not null,
    b_quick_visible tinyint not null default 1,
    b_xh int not null default 0,
    b_updatedatetime datetime2 null,
    primary key (b_user_id, b_module_id, b_field)
);

create index IX_s_user_query_field_pref_order
    on dbo.s_user_query_field_pref (b_user_id, b_module_id, b_xh, b_field);

用户个性化规则：

• s_user_field_pref 区分查看列表和可编辑列表两套布局；
• s_user_query_field_pref 只影响普通查询收起态，展开态和高级查询仍使用所有有效查询字段；
• 没有个人偏好时，回落到模块默认的 s_field_view、s_field_edit、s_field_query 配置；
• 个人偏好只能调整可见字段的显示、顺序和宽度，不能显示隐藏字段、启用停用字段或扩大查询/导出权限；
• “恢复默认”删除当前用户、当前模块对应的个人偏好记录。

---

2. Demo 数据

示例沿用 cw_fee 费用模块。示例用户：张三（费用会计）、李四（财务经理）。

2.1 s_power（权限定义）

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

2.2 s_user_power（用户授权）

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	1006	0	2026-02-10 14:30: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

张三的 1006 对应 module.cw_fee.create，1008 对应 module.cw_fee.delete，两条记录都已停用（b_canuse = 0），因此张三没有新增和删除权限。模块操作权限没有用户授权记录时默认放行，所以需要显式停用记录表达禁止操作。

2.3 s_user_field_permission（字段访问策略）

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

张三对金额字段是“可见、只读、可查询、不可导出”，对内部成本字段完全不可见；李四可以编辑和导出金额，但内部成本字段仍然只读。

未配置用户字段策略的字段按模块默认配置执行，不额外限制查询、编辑和导出；上表中的记录只表示对特定字段的收紧。

2.4 s_user_data_scope（用户数据范围授权）

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

• 张三使用模块默认范围（* + department）读取本部门数据，update 有操作级覆盖（override + own），只能修改本人录入的费用；
• 李四使用默认范围 department_tree 处理一般操作，delete 有操作级覆盖为 all，可删全模块数据。