# FMS 权限与功能实例简化设计

## 1. 设计原则

- 客户按菜单查找功能，但权限不绑定菜单位置。
- `s_feature` 表示客户能理解的业务功能或页面区域，是入口和显示权限边界。
- `s_module` 是技术数据对象，负责字段、数据范围和默认数据能力，不直接出现在客户菜单树中。
- 同一模块被多个功能使用时，模块默认能力只配置一次。
- 某个功能使用同一模块但权限更严时，增加功能-模块例外，只能收紧，不能扩大权限。
- 同一物理表但业务语义、字段或数据范围完全不同，拆成不同逻辑模块。
- 公共 Vue 页面、路由和组件可以复用，但不同业务场景使用不同 `s_feature`。

## 2. 对象关系

```text
菜单（既有表）
    └── 引用 s_feature.b_code，只负责导航

s_feature
    └── 技术配置：使用哪些 s_module、模板、页面区域或报表卡片

s_module
    └── 字段、默认数据能力、默认数据范围

s_power
    ├── feature.*  功能入口、区域/卡片显示、功能专属动作
    └── module.*   模块默认数据能力

s_user_power
    └── 用户对 feature.* / module.* 的授权

s_user_feature_module_override
    └── 某用户在某功能使用某模块时的收紧例外
```

## 3. 表结构

### 3.1 s_feature（业务功能实例）

```sql
create table dbo.s_feature (
    b_code varchar(100) not null,
    b_name nvarchar(200) not null,
    b_feature_type varchar(20) not null, -- page / panel / report_card
    b_parent_code varchar(100) null,
    b_template_code varchar(100) null,
    b_canuse tinyint not null default 1,
    b_xh int not null default 0,
    primary key (b_code)
);
```

菜单、模块及功能-模块关系属于既有技术配置表，本文件只约定语义，不重复定义其表结构。

### 3.2 s_power（权限点）

```sql
create table dbo.s_power (
    b_code varchar(180) not null,
    b_scope_type varchar(20) not null, -- feature / module
    b_scope_code varchar(100) not null, -- feature_code 或 module_id
    b_name nvarchar(200) not null,
    b_capability varchar(30) not null, -- access/read/create/update/delete/export/业务动作
    b_i18n varchar(220) null,
    b_canuse tinyint not null default 1,
    b_xh int not null default 0,
    primary key (b_code)
);
```

业务层校验 `b_code`、`b_scope_type`、`b_scope_code` 和 `b_capability` 的组合关系。权限编码由系统生成，创建后不可修改。

### 3.3 s_user_power（用户默认授权）

```sql
create table dbo.s_user_power (
    b_user_id varchar(50) not null,
    b_power_code varchar(180) not null,
    b_canuse tinyint not null default 1,
    b_updatedatetime datetime2 null,
    primary key (b_user_id, b_power_code),
    foreign key (b_power_code) references dbo.s_power(b_code)
);
```

### 3.4 s_user_feature_module_override（功能-模块收紧例外）

```sql
create table dbo.s_user_feature_module_override (
    b_user_id varchar(50) not null,
    b_feature_code varchar(100) not null,
    b_module_id varchar(50) not null,
    b_capability varchar(30) not null, -- read/create/update/delete/export
    b_canuse tinyint not null default 0, -- 0 表示在该场景禁止
    b_updatedatetime datetime2 null,
    primary key (b_user_id, b_feature_code, b_module_id, b_capability)
);
```

该表只保存例外限制，不保存默认允许记录，也不能用于突破 `s_user_power` 的模块权限。

字段和数据范围仍按逻辑模块配置：

```text
s_user_field_permission(user_id, module_id, field, ...)
s_user_data_scope(user_id, module_id, operation, ...)
```

如果某功能需要不同字段或数据范围，可将例外表扩展为功能-模块维度；仍只允许收紧权限。

## 4. 权限计算

### 4.1 入口和显示

```text
页面进入       = feature.<page>.access
页面区域显示   = 父页面已进入 + feature.<panel>.access
报表卡片显示   = 父看板已进入 + feature.<report_card>.access
```

### 4.2 模块操作

```text
模块读取       = feature.access + module.<module>.read
模块新增       = feature.access + module.<module>.create
模块修改       = feature.access + module.<module>.update
模块删除       = feature.access + module.<module>.delete
模块导出       = feature.access + module.<module>.export
```

如果存在 `s_user_feature_module_override` 对应的禁止记录，则该功能场景下的能力被收紧。

```text
最终模块能力 = 功能入口 ∩ 用户模块能力 ∩ 功能-模块例外
```

### 4.3 功能专属动作

审核、反审核、核销等不属于通用 CRUD 的动作，直接绑定功能实例：

```text
feature.sea_detail.audit
feature.cw_fee_list.settle
```

## 5. Demo 数据

### 5.1 功能实例

| b_code | b_name | b_feature_type | b_parent_code | b_template_code |
| --- | --- | --- | --- | --- |
| sea_detail | 海运详细 | page | null | DetailPage |
| sea_detail_container | 海运详细-装箱区域 | panel | sea_detail | DetailPanel |
| container_query | 装箱查询 | page | null | CommonListPage |
| cw_fee_list | 费用列表 | page | null | CommonListPage |
| finance_dashboard | 财务看板 | page | null | DashboardPage |
| ar_aging_card | 应收账龄 | report_card | finance_dashboard | ReportCard |

### 5.2 功能使用的模块

| b_feature_code | b_module_id | b_usage_type | b_required |
| --- | --- | --- | ---: |
| sea_detail | sea_main | main | 1 |
| sea_detail | cw_fee | detail | 0 |
| sea_detail_container | container_main | detail | 0 |
| container_query | container_main | main | 1 |
| cw_fee_list | cw_fee | main | 1 |
| ar_aging_card | finance_main | source | 1 |

### 5.3 权限点

| b_code | b_scope_type | b_scope_code | b_capability | b_name |
| --- | --- | --- | --- | --- |
| feature.sea_detail.access | feature | sea_detail | access | 进入海运详细 |
| feature.sea_detail.audit | feature | sea_detail | audit | 海运审核 |
| feature.sea_detail_container.access | feature | sea_detail_container | access | 显示装箱区域 |
| feature.container_query.access | feature | container_query | access | 进入装箱查询 |
| feature.cw_fee_list.access | feature | cw_fee_list | access | 进入费用列表 |
| feature.finance_dashboard.access | feature | finance_dashboard | access | 进入财务看板 |
| feature.ar_aging_card.access | feature | ar_aging_card | access | 显示应收账龄 |
| feature.ar_aging_card.export | feature | ar_aging_card | export | 导出应收账龄 |
| module.sea_main.read | module | sea_main | read | 查看海运主表 |
| module.cw_fee.read | module | cw_fee | read | 查看费用 |
| module.cw_fee.create | module | cw_fee | create | 新增费用 |
| module.cw_fee.update | module | cw_fee | update | 修改费用 |
| module.cw_fee.export | module | cw_fee | export | 导出费用 |
| module.container_main.read | module | container_main | read | 查看装箱 |
| module.container_main.export | module | container_main | export | 导出装箱 |

### 5.4 用户默认授权

| b_user_id | b_power_code | b_canuse |
| --- | --- | ---: |
| zhangsan | feature.sea_detail.access | 1 |
| zhangsan | feature.sea_detail_container.access | 1 |
| zhangsan | feature.container_query.access | 1 |
| zhangsan | feature.cw_fee_list.access | 1 |
| zhangsan | module.sea_main.read | 1 |
| zhangsan | module.container_main.read | 1 |
| zhangsan | module.cw_fee.read | 1 |
| zhangsan | module.cw_fee.create | 1 |
| zhangsan | module.cw_fee.update | 1 |
| lisi | feature.sea_detail.access | 1 |
| lisi | feature.sea_detail_container.access | 1 |
| lisi | feature.container_query.access | 1 |
| lisi | feature.cw_fee_list.access | 1 |
| lisi | feature.finance_dashboard.access | 1 |
| lisi | feature.ar_aging_card.access | 1 |
| lisi | module.sea_main.read | 1 |
| lisi | module.container_main.read | 1 |
| lisi | module.container_main.export | 1 |
| lisi | module.cw_fee.read | 1 |
| lisi | module.cw_fee.create | 1 |
| lisi | module.cw_fee.update | 1 |
| lisi | module.cw_fee.export | 1 |

### 5.5 功能-模块例外

李四可以在费用列表维护费用，但海运详细中的费用只读：

| b_user_id | b_feature_code | b_module_id | b_capability | b_canuse |
| --- | --- | --- | --- | ---: |
| lisi | sea_detail | cw_fee | create | 0 |
| lisi | sea_detail | cw_fee | update | 0 |
| lisi | sea_detail | cw_fee | export | 0 |

结果：

```text
费用列表：可查看、新增、修改、导出
海运详细：可查看费用，不可新增、修改、导出
```

## 6. 运行规则

```text
请求 -> 服务端确定 feature_code
     -> 检查 feature.<feature>.access
     -> 按功能配置取得允许的 module_id
     -> 检查 module.<module>.<operation>
     -> 检查功能-模块例外
     -> 应用字段权限和数据范围
     -> 执行查询、写入或导出
```

- 菜单只负责定位功能实例，同一功能挂在多个菜单时只授权一次。
- 同一公共页面模板对应不同功能实例时，权限按功能实例区分。
- 同一模块被多个功能使用时，模块默认能力只配置一次。
- 功能场景差异通过例外限制表达，例外只能收紧。
- 页面内可独立隐藏的区域定义为 `panel` 功能实例；看板卡片定义为 `report_card`。
- 前端传入的 `module_id` 必须经过当前功能的模块白名单校验。
- 后端接口必须重复校验 `access`、模块操作权限和例外限制，不能只依赖前端按钮隐藏。