501 lines
18 KiB
Markdown
501 lines
18 KiB
Markdown
# FMS 新系统核心表结构
|
||
|
||
> 目标结构基于 2026-09-04 只读拉取的 `FMS-NEW` 数据库整理。
|
||
> 平台配置使用字符串业务键；未来业务数据表使用 `bigint` 雪花 ID。
|
||
|
||
## 1. 用户表
|
||
|
||
```sql
|
||
create table dbo.b_user (
|
||
b_id varchar(50) not null primary key, -- 用户账号本身
|
||
b_name nvarchar(100) null,
|
||
b_bz nvarchar(400) null,
|
||
b_password nvarchar(255) not null,
|
||
b_canuse tinyint not null default 1,
|
||
b_logintime tinyint not null default 0
|
||
);
|
||
```
|
||
|
||
## 2. 模块
|
||
|
||
```sql
|
||
create table dbo.s_module (
|
||
b_id varchar(50) not null primary key, -- 模块编码本身，创建后不可修改
|
||
b_parent_id varchar(50) null,
|
||
b_name nvarchar(200) not null,
|
||
b_i18n varchar(150) null,
|
||
b_module_type varchar(20) not null,
|
||
b_viewtable varchar(128) null,
|
||
b_savetable varchar(128) null,
|
||
b_keyfield varchar(50) null,
|
||
b_orderfield varchar(500) null,
|
||
b_delete_policy varchar(20) null,
|
||
b_canuse tinyint not null default 1,
|
||
b_xh int not null default 0,
|
||
b_bz nvarchar(2000) null,
|
||
b_edit_mode varchar(10) null
|
||
);
|
||
|
||
create index ix_s_module_parent
|
||
on dbo.s_module (b_parent_id, b_xh, b_canuse, b_id);
|
||
|
||
create index ix_s_module_order
|
||
on dbo.s_module (b_xh, b_id);
|
||
|
||
create index ix_s_module_savetable
|
||
on dbo.s_module (b_savetable);
|
||
```
|
||
|
||
## 3. 字段和字段布局
|
||
|
||
> 状态字段统一使用 `tinyint` 保存 0/1，由业务层负责校验取值。`b_canuse` 表示记录或配置是否启用、是否参与运行；`b_visible` 表示当前列表或编辑场景是否展示，二者语义不同，不互相替代。
|
||
|
||
```sql
|
||
create table dbo.s_field (
|
||
b_module_id varchar(50) not null,
|
||
b_field varchar(50) not null,
|
||
b_name nvarchar(200) not null,
|
||
b_i18n varchar(150) null,
|
||
b_type varchar(30) not null,
|
||
b_dbtype varchar(30) not null,
|
||
b_length int null,
|
||
b_precision int null,
|
||
b_scale int null,
|
||
b_nullable tinyint not null default 1,
|
||
b_default_value nvarchar(1000) null,
|
||
b_db_default nvarchar(1000) null,
|
||
b_writemode varchar(20) not null default 'direct',
|
||
b_options nvarchar(max) null,
|
||
b_canuse tinyint not null default 1,
|
||
b_xh int not null default 0, -- 字段定义顺序：模块「同步字段」时按查询视图列序（10 起步）重排
|
||
primary key (b_module_id, b_field)
|
||
);
|
||
|
||
create index ix_s_field_module_order
|
||
on dbo.s_field (b_module_id, b_xh, b_field);
|
||
|
||
create table dbo.s_field_group (
|
||
b_id varchar(50) not null, -- 分组编码本身，模块内唯一，创建后不可修改
|
||
b_module_id varchar(50) not null,
|
||
b_parent_id varchar(50) null, -- 父分组编码，NULL 表示根分组
|
||
b_title nvarchar(200) not null,
|
||
b_i18n varchar(150) null,
|
||
b_xh int not null default 0,
|
||
b_canuse tinyint not null default 1,
|
||
b_colspan int not null default 48,
|
||
b_layout_direction varchar(10) null default 'vertical',
|
||
primary key (b_module_id, b_id)
|
||
);
|
||
|
||
create index ix_s_field_group_parent
|
||
on dbo.s_field_group (b_module_id, b_parent_id, b_xh, b_id);
|
||
|
||
create index ix_s_field_group_order
|
||
on dbo.s_field_group (b_module_id, b_xh, b_id);
|
||
|
||
create table dbo.s_field_view (
|
||
b_module_id varchar(50) not null,
|
||
b_field varchar(50) not null,
|
||
b_group_id varchar(50) null, -- 引用同模块 s_field_group.b_id
|
||
b_visible tinyint not null default 1,
|
||
b_xh int not null default 0,
|
||
b_width int null,
|
||
primary key (b_module_id, b_field)
|
||
);
|
||
|
||
create index ix_s_field_view_order
|
||
on dbo.s_field_view (b_module_id, b_xh, b_field);
|
||
|
||
create table dbo.s_field_edit (
|
||
b_module_id varchar(50) not null,
|
||
b_field varchar(50) not null,
|
||
b_group_id varchar(50) null, -- 引用同模块 s_field_group.b_id
|
||
b_visible tinyint not null default 1,
|
||
b_required tinyint not null default 0,
|
||
b_readonly tinyint not null default 0,
|
||
b_disabled tinyint not null default 0,
|
||
b_xh int not null default 0,
|
||
b_width int null,
|
||
b_placeholder nvarchar(400) null,
|
||
b_colspan int not null default 12,
|
||
b_height int null,
|
||
primary key (b_module_id, b_field)
|
||
);
|
||
|
||
create index ix_s_field_edit_order
|
||
on dbo.s_field_edit (b_module_id, b_xh, b_field);
|
||
|
||
create table dbo.s_field_query (
|
||
b_module_id varchar(50) not null,
|
||
b_field varchar(50) not null,
|
||
b_component varchar(30) null,
|
||
b_condition_no int not null default 1,
|
||
b_operator varchar(20) not null,
|
||
b_default_value nvarchar(1000) null,
|
||
b_canuse tinyint not null default 1,
|
||
b_xh int not null default 0,
|
||
primary key (b_module_id, b_field, b_condition_no)
|
||
);
|
||
|
||
create index ix_s_field_query_order
|
||
on dbo.s_field_query (b_module_id, b_xh, b_field, b_condition_no);
|
||
```
|
||
|
||
## 4. 用户个性化
|
||
|
||
> 用户个性化只作用于列表布局和普通查询收起态，不改变模块级默认配置。权限过滤优先于个人偏好，个人偏好不能越过字段权限或字段 `b_canuse` 限制。
|
||
|
||
```sql
|
||
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);
|
||
|
||
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` 的 `b_mode` 区分查看列表和可编辑列表两套个人布局；
|
||
- `s_user_query_field_pref` 不区分普通查询/高级查询模式，因为两者使用同一批查询字段；
|
||
- 查询偏好只影响普通查询收起态，展开态和高级查询仍展示所有有权限且启用的查询字段；
|
||
- 没有个人偏好时回落到对应的 `s_field_view` / `s_field_edit` / `s_field_query` 默认配置；
|
||
- “恢复默认”删除当前用户、当前模块对应的个人偏好记录。
|
||
|
||
## 5. 自动编码
|
||
|
||
```sql
|
||
create table dbo.s_autocode (
|
||
b_module_id varchar(50) not null,
|
||
b_field varchar(50) not null,
|
||
b_prefix nvarchar(200) not null default N'',
|
||
b_dateformat varchar(30) not null default 'yyyyMM',
|
||
b_separator nvarchar(20) not null default N'-',
|
||
b_seqwidth int not null default 5,
|
||
b_resettype varchar(10) not null default 'month',
|
||
b_startvalue bigint not null default 1,
|
||
b_currentperiod varchar(8) null,
|
||
b_currentvalue bigint not null default 0,
|
||
b_canuse tinyint not null default 1,
|
||
primary key (b_module_id, b_field)
|
||
);
|
||
```
|
||
|
||
## 6. 模块关系
|
||
|
||
```sql
|
||
create table dbo.s_relation (
|
||
b_module_id varchar(50) not null,
|
||
b_target_module_id varchar(50) not null,
|
||
b_relation_type varchar(20) not null,
|
||
b_field varchar(50) not null,
|
||
b_target_field varchar(50) not null,
|
||
b_foreign_side varchar(10) null,
|
||
b_junction_module_id varchar(50) null,
|
||
b_junction_field varchar(50) null,
|
||
b_junction_target_field varchar(50) null,
|
||
b_ownership varchar(20) not null default 'reference',
|
||
b_owner_side varchar(10) null,
|
||
b_delete_policy varchar(20) null,
|
||
b_order_module_id varchar(50) null,
|
||
b_order_field varchar(50) null,
|
||
b_canuse tinyint not null default 1,
|
||
b_xh int not null default 0,
|
||
primary key (b_module_id, b_field, b_target_module_id, b_target_field)
|
||
);
|
||
|
||
create index ix_s_relation_module
|
||
on dbo.s_relation (b_module_id, b_canuse, b_xh, b_field, b_target_module_id);
|
||
|
||
create index ix_s_relation_target
|
||
on dbo.s_relation (b_target_module_id);
|
||
```
|
||
|
||
## 7. 菜单
|
||
|
||
```sql
|
||
create table dbo.s_menu (
|
||
b_id varchar(50) not null primary key, -- 菜单编码本身
|
||
b_parent_id varchar(50) null,
|
||
b_name nvarchar(200) not null,
|
||
b_i18n varchar(150) null,
|
||
b_menu_type varchar(20) not null,
|
||
b_route varchar(200) null,
|
||
b_module_id varchar(50) null,
|
||
b_icon varchar(50) null,
|
||
b_xh int not null default 0,
|
||
b_canuse tinyint not null default 1
|
||
);
|
||
|
||
create index ix_s_menu_parent
|
||
on dbo.s_menu (b_parent_id, b_xh, b_canuse, b_id);
|
||
|
||
create index ix_s_menu_order
|
||
on dbo.s_menu (b_xh, b_id);
|
||
|
||
create index ix_s_menu_module
|
||
on dbo.s_menu (b_module_id);
|
||
|
||
create index ix_s_menu_route
|
||
on dbo.s_menu (b_route, b_canuse, b_id);
|
||
```
|
||
|
||
## 8. 权限
|
||
|
||
> 权限直接授予用户，不引入角色继承。`s_power.b_id` 是内部主键，`s_power.b_code` 是稳定且全局唯一的业务键；字段授权使用独立的字段访问策略表。
|
||
|
||
```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 type
|
||
b_owner_id varchar(128) null, -- action owner id
|
||
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,
|
||
primary key (b_id),
|
||
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);
|
||
|
||
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,
|
||
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);
|
||
|
||
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,
|
||
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);
|
||
|
||
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 varchar(10) not null default 'default', -- default / 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, -- custom 时每个用户/部门值一行
|
||
b_updatedatetime datetime2 null,
|
||
primary key (b_user_id, b_module_id, b_operation, b_scope_level, b_scope_no),
|
||
constraint ck_s_user_data_scope_level check (b_scope_level in ('default','override')),
|
||
constraint ck_s_user_data_scope_operation check (
|
||
(b_scope_level = 'default' and b_operation = '*')
|
||
or (b_scope_level = 'override' and b_operation in ('read','create','update','delete','export'))
|
||
)
|
||
);
|
||
|
||
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);
|
||
```
|
||
|
||
权限点约定：
|
||
|
||
- `menu/access`：菜单或页面入口访问权限；
|
||
- `module/read|create|update|delete|export`：模块级数据操作权限；
|
||
- `action/execute`：菜单或页面中的按钮、动作权限；
|
||
- `s_user_field_permission`：字段 `hidden/view/edit` 访问级别，以及独立的查询/导出能力；
|
||
- `page/access`、`report/access`：独立页面或报表访问权限，报表列表中的每个报表可作为一个资源；
|
||
- `b_power_type` 和 `b_capability` 是可扩展编码，新增资源类型不新增权限表，但需要补充权限定义和前端/后端校验规则。
|
||
- 动作业务键必须包含所属资源命名空间，例如 `action.module.cw_fee.audit.execute`，不得使用裸 `action.audit`。
|
||
|
||
权限计算约定：
|
||
|
||
- 默认拒绝：用户没有有效授权记录时不具备该权限；
|
||
- 用户存在有效 `s_user_power` 记录时获得该权限；停用的权限点或授权记录不生效；
|
||
- 字段没有有效策略记录时为 `hidden`；`view` 表示可见只读，`edit` 表示可见可编辑；`s_field_view` / `s_field_edit` 等元数据只能收紧权限；
|
||
- `hidden` 字段不可查询、不可导出；`b_allow_query` / `b_allow_export` 不能突破字段访问级别；
|
||
- 模块数据操作权限与数据范围同时生效：先判断操作权限，再按 `s_user_data_scope` 限制数据行；
|
||
- 菜单/页面/报表访问权限只控制入口和访问，不能替代模块、字段或数据范围权限。
|
||
|
||
## 9. 多语言
|
||
|
||
```sql
|
||
-- b_i18n / b_key 保存完整资源键，不追加 .name 或 .title 后缀：
|
||
-- s_module.b_i18n = module.<module_id>
|
||
-- s_field.b_i18n = field.<module_id>.<b_field>
|
||
-- s_field_group.b_i18n = field_group.<module_id>.<b_id>
|
||
-- s_menu.b_i18n = menu.<b_id>
|
||
|
||
create table dbo.s_i18n_type (
|
||
b_id varchar(20) not null primary key, -- 语言编码本身
|
||
b_name nvarchar(200) not null,
|
||
b_canuse tinyint not null default 1,
|
||
b_default tinyint not null default 0,
|
||
b_xh int not null default 0
|
||
);
|
||
|
||
create table dbo.s_i18n (
|
||
b_id varchar(200) not null primary key, -- b_key + ':' + b_locale
|
||
b_key varchar(150) not null,
|
||
b_locale varchar(20) not null,
|
||
b_value nvarchar(1000) not null,
|
||
b_i18ntype varchar(20) null,
|
||
b_canuse tinyint not null default 1,
|
||
b_module_id varchar(50) null,
|
||
unique (b_key, b_locale)
|
||
);
|
||
|
||
create index ix_s_i18n_module_key
|
||
on dbo.s_i18n (b_module_id, b_key, b_locale);
|
||
|
||
create index ix_s_i18n_locale
|
||
on dbo.s_i18n (b_locale, b_canuse);
|
||
```
|
||
|
||
## 10. 日志
|
||
|
||
> 日志主键由业务层统一生成 UUIDv7。UUID 主键使用非聚集索引；技术、登录、审计日志按发生时间建立聚集索引，审计字段明细按审计事件建立聚集索引。日志顺序以 `b_occurdatetime` 为准，不依赖 UUID 排序。
|
||
|
||
```sql
|
||
create table dbo.s_log_technical (
|
||
b_id uniqueidentifier not null, -- 业务层生成的 UUIDv7
|
||
b_user_id varchar(50) null, -- 稳定用户/账号标识；未认证请求时为 NULL
|
||
b_sourcetype varchar(20) null,
|
||
b_loglevel varchar(16) not null,
|
||
b_logcategory varchar(64) null,
|
||
b_operation varchar(100) null,
|
||
b_module_id varchar(50) null,
|
||
b_request_id varchar(64) null,
|
||
b_trace_id varchar(64) null,
|
||
b_server_node varchar(128) null,
|
||
b_duration_ms bigint null,
|
||
b_result_code varchar(50) null,
|
||
b_error_code varchar(50) null,
|
||
b_error_message nvarchar(4000) null,
|
||
b_exception_text nvarchar(max) null,
|
||
b_context_text nvarchar(max) null,
|
||
b_occurdatetime datetime2 default sysutcdatetime(),
|
||
constraint pk_s_log_technical primary key nonclustered (b_id)
|
||
);
|
||
|
||
create table dbo.s_log_login (
|
||
b_id uniqueidentifier not null, -- 业务层生成的 UUIDv7
|
||
b_user_id varchar(50) null, -- 当前系统中账号即用户稳定标识；登录失败且账号不存在时为 NULL
|
||
b_login_type varchar(20) not null,
|
||
b_login_result tinyint not null default 0,
|
||
b_fail_reason nvarchar(400) null,
|
||
b_ip varchar(50) null,
|
||
b_ip_location nvarchar(400) null,
|
||
b_browser varchar(100) null,
|
||
b_browser_version varchar(50) null,
|
||
b_os varchar(100) null,
|
||
b_os_version varchar(50) null,
|
||
b_device_type varchar(20) null,
|
||
b_user_agent nvarchar(max) null,
|
||
b_session_id varchar(50) null,
|
||
b_request_id varchar(64) null,
|
||
b_trace_id varchar(64) null,
|
||
b_occurdatetime datetime2 default sysutcdatetime(),
|
||
constraint pk_s_log_login primary key nonclustered (b_id)
|
||
);
|
||
|
||
create table dbo.s_log_audit (
|
||
b_id uniqueidentifier not null, -- 业务层生成的 UUIDv7
|
||
b_event_code varchar(50) not null,
|
||
b_module_id varchar(50) null,
|
||
b_data_id varchar(50) null,
|
||
b_business_no varchar(50) null,
|
||
b_operation varchar(100) null,
|
||
b_operator_id varchar(50) null,
|
||
b_operator_name nvarchar(200) null,
|
||
b_source_type varchar(20) not null default 'user',
|
||
b_visibility varchar(20) not null default 'internal',
|
||
b_request_id varchar(64) null,
|
||
b_trace_id varchar(64) null,
|
||
b_payload_text nvarchar(max) null,
|
||
b_occurdatetime datetime2 default sysutcdatetime(),
|
||
constraint pk_s_log_audit primary key nonclustered (b_id)
|
||
);
|
||
|
||
create table dbo.s_log_audit_field (
|
||
b_id uniqueidentifier not null, -- 业务层生成的 UUIDv7
|
||
b_event_id uniqueidentifier not null,
|
||
b_module_id varchar(50) null,
|
||
b_data_id varchar(50) null,
|
||
b_field varchar(50) not null,
|
||
b_field_label nvarchar(200) null,
|
||
b_before_value nvarchar(max) null,
|
||
b_after_value nvarchar(max) null,
|
||
b_before_display nvarchar(1000) null,
|
||
b_after_display nvarchar(1000) null,
|
||
b_visibility varchar(20) not null default 'internal',
|
||
constraint pk_s_log_audit_field primary key nonclustered (b_id)
|
||
);
|
||
|
||
create clustered index cx_s_log_technical_occur
|
||
on dbo.s_log_technical (b_occurdatetime, b_id);
|
||
|
||
create clustered index cx_s_log_login_occur
|
||
on dbo.s_log_login (b_occurdatetime, b_id);
|
||
|
||
create clustered index cx_s_log_audit_occur
|
||
on dbo.s_log_audit (b_occurdatetime, b_id);
|
||
|
||
create clustered index cx_s_log_audit_field_event
|
||
on dbo.s_log_audit_field (b_event_id, b_id);
|
||
|
||
create index ix_s_log_technical_trace
|
||
on dbo.s_log_technical (b_trace_id, b_occurdatetime);
|
||
|
||
create index ix_s_log_login_user
|
||
on dbo.s_log_login (b_user_id, b_occurdatetime);
|
||
|
||
create index ix_s_log_audit_module
|
||
on dbo.s_log_audit (b_module_id, b_data_id, b_occurdatetime);
|
||
```
|
||
|
||
## 11. 业务表主键约定
|
||
|
||
```sql
|
||
create table dbo.b_example (
|
||
b_id bigint not null primary key, -- 应用层雪花 ID
|
||
b_inputuser_id varchar(50) null, -- 引用 b_user.b_id
|
||
b_inputdatetime datetime2 default sysutcdatetime()
|
||
);
|
||
```
|