20260908170359

code/fms/FMS新系统核心表结构设计.md

@@ -3,6 +3,16 @@
 > 目标结构基于 2026-09-04 只读拉取的 `FMS-NEW` 数据库整理。
 > 平台配置使用字符串业务键；未来业务数据表使用 `bigint` 雪花 ID。
 
+## 0. SQL 驱动与动态配置
+
+本系统是 SQL 驱动的内部 ERP。能通过 SQL 完成的查询、关联、过滤、排序、分页、聚合、权限过滤和数据范围过滤，优先在 SQL 层完成，不在业务代码中加载大量数据后再处理。
+
+- 模块、字段、查询条件、排序、字段权限和数据范围等规则，优先从本文件定义的配置表读取，由通用查询逻辑动态生成 SQL；
+- 动态 SQL 的表名、字段名和操作符只能来自受控的模块元数据、字段定义和白名单，业务值使用参数传递；
+- 配置驱动的动态 SQL 不等于保存任意 SQL 字符串。不得把未审查的前端字符串或整段 SQL 直接保存后执行；
+- 固定 SQL 仅用于稳定且明确的特殊业务逻辑，且应保持通用，不为单个页面或单个用户复制一套查询接口；
+- 前端权限控制只负责界面展示，模块操作、字段访问和数据范围必须在后端查询或写入 SQL 中落实；用户个性化只能调整布局，不能放宽权限。
+
 ## 1. 用户表
 
 ```sql
@@ -345,11 +355,13 @@ create index ix_s_user_data_scope_module
 
 权限计算约定：
 
-- 默认拒绝：用户没有有效授权记录时不具备该权限；
-- 用户存在有效 `s_user_power` 记录时获得该权限；停用的权限点或授权记录不生效；
-- 字段没有有效策略记录时为 `hidden`；`view` 表示可见只读，`edit` 表示可见可编辑；`s_field_view` / `s_field_edit` 等元数据只能收紧权限；
+- 入口权限默认拒绝：`menu/access`、`page/access`、`report/access` 和 `action/execute` 必须存在有效的 `s_user_power` 授权记录；停用的权限点或授权记录不生效；
+- 模块操作权限默认放行：`module/read|create|update|delete|export` 没有用户授权记录时视为允许；`s_power` 权限点或用户授权记录存在 `b_canuse = 0` 时视为明确禁用；
+- 字段没有有效用户策略记录时不增加限制，按 `s_field`、`s_field_view`、`s_field_edit`、`s_field_query` 等模块默认配置执行；有效的 `s_user_field_permission` 只能收紧权限；`hidden` 表示不可见，`view` 表示可见只读，`edit` 表示可见可编辑；
 - `hidden` 字段不可查询、不可导出；`b_allow_query` / `b_allow_export` 不能突破字段访问级别；
-- 模块数据操作权限与数据范围同时生效：先判断操作权限，再按 `s_user_data_scope` 限制数据行；
+- 模块数据操作权限与数据范围同时生效：先判断操作权限，再按 `s_user_data_scope` 限制数据行；数据范围没有配置时视为 `all`；
+- 数据范围优先使用当前操作的 `override`，没有 `override` 时使用 `operation = '*'` 的 `default`；同一层级的多条范围按 OR 合并；
+- `read`、`export`、`update`、`delete` 在 SQL 行条件中应用数据范围；`create` 在写入前校验新增数据是否符合数据范围；
 - 菜单/页面/报表访问权限只控制入口和访问，不能替代模块、字段或数据范围权限。
 
 ## 9. 多语言