diff --git a/code/fms/FMS新系统核心表结构设计.md b/code/fms/FMS新系统核心表结构设计.md index 6f9d6ef3..e5c20677 100644 --- a/code/fms/FMS新系统核心表结构设计.md +++ b/code/fms/FMS新系统核心表结构设计.md @@ -141,7 +141,49 @@ create index ix_s_field_query_order on dbo.s_field_query (b_module_id, b_xh, b_field, b_condition_no); ``` -## 4. 自动编码 +## 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 ( @@ -160,7 +202,7 @@ create table dbo.s_autocode ( ); ``` -## 5. 模块关系 +## 6. 模块关系 ```sql create table dbo.s_relation ( @@ -190,7 +232,7 @@ create index ix_s_relation_target on dbo.s_relation (b_target_module_id); ``` -## 6. 菜单 +## 7. 菜单 ```sql create table dbo.s_menu ( @@ -219,7 +261,9 @@ create index ix_s_menu_route on dbo.s_menu (b_route, b_canuse, b_id); ``` -## 7. 权限 +## 8. 权限 + +> 权限直接授予用户，不引入角色继承。`s_power` 是权限点定义表，`s_user_power` 是用户授权表；数据范围使用独立的 `s_user_data_scope` 表。权限点按资源类型扩展，新增报表、页面等资源时复用同一模型。 ```sql create table dbo.s_power ( @@ -240,9 +284,54 @@ create index ix_s_power_module create index ix_s_power_resource on dbo.s_power (b_power_type, b_resource, b_canuse); + +create table dbo.s_user_power ( + b_user_id varchar(50) not null, + b_power_id varchar(50) 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_data_scope ( + b_user_id varchar(50) not null, + b_module_id varchar(50) not null, + b_operation varchar(30) not null, -- read / update / delete / export + 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_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_type); ``` -## 8. 多语言 +权限点约定： + +- `menu/access`：菜单或页面入口访问权限； +- `module/read|create|update|delete|export`：模块级数据操作权限； +- `action/execute`：菜单或页面中的按钮、动作权限； +- `field/view|edit|query|export`：字段查看、修改、查询、导出能力； +- `page/access`、`report/access`：独立页面或报表访问权限，报表列表中的每个报表可作为一个资源； +- `b_power_type` 和 `b_operation` 是可扩展编码，新增资源类型不新增权限表，但需要补充权限定义和前端/后端校验规则。 +- 当前数据库迁移中的权限类型/形状约束若仍只允许 `menu/module/action/field` 或 `field/view|edit`，新增 `page`、`report`、`field/query` 等编码时必须同步扩展约束；不要只修改前端枚举。 + +权限计算约定： + +- 默认拒绝：用户没有有效授权记录时不具备该权限； +- 用户存在有效 `s_user_power` 记录时获得该权限；停用的权限点或授权记录不生效； +- 字段 `edit` 只代表用户有修改能力，最终是否可编辑仍受 `s_field_edit.b_readonly`、`b_disabled` 和业务校验约束； +- 字段不可见时，其编辑、查询、导出能力一并无效；字段可见但无 `edit` 权限时，在可编辑列表中显示为只读； +- 模块数据操作权限与数据范围同时生效：先判断操作权限，再按 `s_user_data_scope` 限制数据行； +- 菜单/页面/报表访问权限只控制入口和访问，不能替代模块、字段或数据范围权限。 + +## 9. 多语言 ```sql -- b_i18n / b_key 保存完整资源键，不追加 .name 或 .title 后缀： @@ -277,7 +366,7 @@ create index ix_s_i18n_locale on dbo.s_i18n (b_locale, b_canuse); ``` -## 9. 日志 +## 10. 日志 > 日志主键由业务层统一生成 UUIDv7。UUID 主键使用非聚集索引；技术、登录、审计日志按发生时间建立聚集索引，审计字段明细按审计事件建立聚集索引。日志顺序以 `b_occurdatetime` 为准，不依赖 UUID 排序。 @@ -379,7 +468,7 @@ create index ix_s_log_audit_module on dbo.s_log_audit (b_module_id, b_data_id, b_occurdatetime); ``` -## 10. 业务表主键约定 +## 11. 业务表主键约定 ```sql create table dbo.b_example ( diff --git a/code/fms/fms-vue/src/views/dashboard/index.vue b/code/fms/fms-vue/src/views/dashboard/index.vue index 4e137407..20c19736 100644 --- a/code/fms/fms-vue/src/views/dashboard/index.vue +++ b/code/fms/fms-vue/src/views/dashboard/index.vue @@ -13,6 +13,7 @@ import { Trash2, Upload, LockKeyhole, + SlidersHorizontal, Settings2, } from '@lucide/vue' import { Button, Dropdown, Input, Pagination, RangePicker, Select, Tooltip } from '@/components/ui' @@ -247,12 +248,14 @@ const queryApplied = ref(false) const activeQueryMode = ref('quick') const queryMode = ref('quick') const advancedLogic = ref('and') -const advancedNodes = reactive([ - { id: 1, field: 'status', operator: 'eq', value: 'pending', label: '状态', source: 'advanced' }, - { id: 2, field: 'invoiceStatus', operator: 'eq', value: 'unissued', label: '发票状态', source: 'advanced' }, -]) +const advancedNodes = reactive([]) const advancedGroups = reactive([]) +const advancedSnapshot = ref(null) +const draggingFieldKey = ref('') const allAdvancedNodes = computed(() => advancedNodes.concat(advancedGroups.flatMap((group) => group.nodes))) +function hasNodeValue(value) { + return Array.isArray(value) ? value.some((item) => item !== '' && item !== null && item !== undefined) : value !== '' && value !== null && value !== undefined +} /* 渲染用的字段列表：标签 / 选项文案按当前语言解析（含「全部」空值项） */ const searchFields = computed(() => @@ -270,7 +273,7 @@ const searchFields = computed(() => const quickSearchFields = computed(() => searchFields.value .filter((field) => field.queryable !== false && queryPrefs[field.key]?.area === 'quick') - .sort((a, b) => queryPrefs[a.key].order - queryPrefs[b.key].order), + .toSorted((a, b) => queryPrefs[a.key].order - queryPrefs[b.key].order), ) const extraQuickSearchFields = computed(() => quickSearchFields.value.slice(QUICK_VISIBLE_LIMIT)) const extraQuickConditionCount = computed(() => extraQuickSearchFields.value.filter((field) => { @@ -289,18 +292,33 @@ function getFieldOptions(key) { } function getNodeOperators(node) { const type = fieldByKey.value[node.field]?.type - if (type === 'input') return [{ value: 'contains', label: '包含（like）' }, { value: 'eq', label: '等于（eq）' }, { value: 'not_contains', label: '不包含' }] - if (type === 'numrange') return [{ value: 'gt', label: '大于（gt）' }, { value: 'ge', label: '大于等于（ge）' }, { value: 'lt', label: '小于（lt）' }, { value: 'le', label: '小于等于（le）' }, { value: 'between', label: '介于（between）' }] - if (type === 'daterange') return [{ value: 'between', label: '介于（between）' }, { value: 'ge', label: '不早于（ge）' }, { value: 'le', label: '不晚于（le）' }] - if (node.field === 'invoiceStatus' || node.field === 'paymentStatus') return [{ value: 'eq', label: '等于（eq）' }, { value: 'not_eq', label: '不等于（neq）' }, { value: 'exists', label: '已存在（exists）' }] - return [{ value: 'eq', label: '等于（eq）' }, { value: 'not_eq', label: '不等于（neq）' }, { value: 'in', label: '属于（in）' }] + if (type === 'input') return [{ value: 'contains', label: '包含' }, { value: 'eq', label: '等于' }, { value: 'not_contains', label: '不包含' }] + if (type === 'numrange') return [{ value: 'gt', label: '大于' }, { value: 'ge', label: '大于等于' }, { value: 'lt', label: '小于' }, { value: 'le', label: '小于等于' }, { value: 'between', label: '介于' }] + if (type === 'daterange') return [{ value: 'between', label: '介于' }, { value: 'ge', label: '不早于' }, { value: 'le', label: '不晚于' }] + if (node.field === 'invoiceStatus' || node.field === 'paymentStatus') return [{ value: 'eq', label: '等于' }, { value: 'not_eq', label: '不等于' }, { value: 'exists', label: '已存在' }] + return [{ value: 'eq', label: '等于' }, { value: 'not_eq', label: '不等于' }, { value: 'in', label: '属于' }] +} +function emptyNodeValue(field, operator) { + if (field?.type === 'daterange' || (field?.type === 'numrange' && operator === 'between')) return ['', ''] + return '' +} +function createAdvancedNode(fieldKey) { + const field = fieldByKey.value[fieldKey] + const node = { id: Date.now() + Math.random(), field: fieldKey, operator: 'eq', value: '', label: field?.label || fieldKey, source: field?.relation ? 'relation' : 'advanced' } + node.operator = getNodeOperators(node)[0]?.value || 'eq' + node.value = emptyNodeValue(field, node.operator) + return node } function onNodeFieldChange(node) { node.operator = getNodeOperators(node)[0]?.value || 'eq' - node.value = '' + node.value = emptyNodeValue(fieldByKey.value[node.field], node.operator) node.label = getFieldLabel(node.field) } +function onNodeOperatorChange(node) { + node.value = emptyNodeValue(fieldByKey.value[node.field], node.operator) +} function getNodeValueLabel(node) { + if (Array.isArray(node.value)) return node.value.filter(Boolean).join(' - ') const option = getFieldOptions(node.field).find((item) => item.value === node.value) return option?.label || node.value } @@ -317,17 +335,15 @@ const quickQueryAst = computed(() => { }) const advancedQueryAst = computed(() => { const children = [] - const advanced = advancedNodes.filter((node) => node.value !== '').map((node) => ({ type: 'condition', field: fieldByKey.value[node.field]?.path || node.field, operator: node.operator, value: node.value })) + const advanced = advancedNodes.filter((node) => hasNodeValue(node.value)).map((node) => ({ type: 'condition', field: fieldByKey.value[node.field]?.path || node.field, operator: node.operator, value: node.value })) if (advanced.length) children.push({ type: 'group', logic: advancedLogic.value, children: advanced }) advancedGroups.forEach((group) => { - const groupChildren = group.nodes.filter((node) => node.value !== '').map((node) => ({ type: 'condition', field: fieldByKey.value[node.field]?.path || node.field, operator: node.operator, value: node.value })) + const groupChildren = group.nodes.filter((node) => hasNodeValue(node.value)).map((node) => ({ type: 'condition', field: fieldByKey.value[node.field]?.path || node.field, operator: node.operator, value: node.value })) if (groupChildren.length) children.push({ type: 'group', logic: group.logic, children: groupChildren }) }) return { type: 'group', logic: 'and', children } }) -const queryAst = computed(() => activeQueryMode.value === 'advanced' ? advancedQueryAst.value : quickQueryAst.value) -const queryAstPreview = computed(() => JSON.stringify(queryAst.value, null, 2)) -const advancedConditionCount = computed(() => allAdvancedNodes.value.filter((node) => node.value !== '').length) +const advancedConditionCount = computed(() => allAdvancedNodes.value.filter((node) => hasNodeValue(node.value)).length) const querySummary = computed(() => { const items = [] if (activeQueryMode.value === 'quick') { @@ -336,7 +352,7 @@ const querySummary = computed(() => { if (value) items.push({ id: `quick:${field.key}`, kind: 'quick', field: field.key, text: `${field.label} ${field.type === 'input' ? '包含' : '='} ${value}` }) }) } else { - allAdvancedNodes.value.filter((node) => node.value).forEach((node) => items.push({ id: `advanced:${node.id}`, kind: 'advanced', nodeId: node.id, text: `${getFieldLabel(node.field)} ${node.operator === 'eq' ? '=' : node.operator} ${getNodeValueLabel(node)}` })) + allAdvancedNodes.value.filter((node) => Array.isArray(node.value) ? node.value.some(Boolean) : node.value).forEach((node) => items.push({ id: `advanced:${node.id}`, kind: 'advanced', nodeId: node.id, text: `${getFieldLabel(node.field)} ${getNodeOperators(node).find((operator) => operator.value === node.operator)?.label || node.operator} ${getNodeValueLabel(node)}` })) } return items }) @@ -355,9 +371,26 @@ function removeSummaryItem(item) { if (!querySummary.value.length) queryApplied.value = false } function openQueryDrawer(tab = 'conditions') { + if (tab === 'conditions' && !drawerOpen.value) { + advancedSnapshot.value = { + logic: advancedLogic.value, + nodes: JSON.parse(JSON.stringify(advancedNodes)), + groups: JSON.parse(JSON.stringify(advancedGroups)), + } + } drawerTab.value = tab drawerOpen.value = true } +function closeQueryDrawer() { + if (advancedSnapshot.value) { + advancedLogic.value = advancedSnapshot.value.logic + advancedNodes.splice(0, advancedNodes.length, ...advancedSnapshot.value.nodes) + advancedGroups.splice(0, advancedGroups.length, ...advancedSnapshot.value.groups) + advancedSnapshot.value = null + queryMode.value = activeQueryMode.value + } + drawerOpen.value = false +} function selectQueryMode(mode) { queryMode.value = mode if (mode === 'advanced') openQueryDrawer('conditions') @@ -386,12 +419,36 @@ function removeAdvancedNode(id) { } } function addAdvancedNode() { - const field = advancedSearchFields.value[0] - advancedNodes.push({ id: Date.now(), field: field?.key || 'creator', operator: getNodeOperators({ field: field?.key || 'creator' })[0]?.value || 'eq', value: '', label: field?.label || '创建人', source: field?.relation ? 'relation' : 'advanced' }) + advancedNodes.push(createAdvancedNode(advancedSearchFields.value[0]?.key || 'creator')) } function addAdvancedGroup() { - const field = advancedSearchFields.value[0] - advancedGroups.push({ id: Date.now(), logic: 'or', nodes: [{ id: Date.now() + 1, field: field?.key || 'creator', operator: 'eq', value: '', label: field?.label || '创建人', source: 'advanced' }] }) + advancedGroups.push({ id: Date.now() + Math.random(), logic: 'or', nodes: [createAdvancedNode(advancedSearchFields.value[0]?.key || 'creator')] }) +} +function resetAdvancedQuery() { + advancedNodes.splice(0, advancedNodes.length) + advancedGroups.splice(0, advancedGroups.length) + advancedLogic.value = 'and' + if (activeQueryMode.value === 'advanced') queryApplied.value = false +} +function resetQuickQuery() { + Object.assign(searchForm, makeEmptyForm()) + if (activeQueryMode.value === 'quick') queryApplied.value = false +} +function startFieldDrag(field) { + draggingFieldKey.value = field.key +} +function dropField(field, area) { + const sourceKey = draggingFieldKey.value + draggingFieldKey.value = '' + if (!sourceKey || sourceKey === field.key || queryPrefs[sourceKey]?.area !== area) return + const rows = searchFields.value.filter((item) => item.queryable !== false && queryPrefs[item.key]?.area === area) + .toSorted((a, b) => queryPrefs[a.key].order - queryPrefs[b.key].order) + const from = rows.findIndex((item) => item.key === sourceKey) + const to = rows.findIndex((item) => item.key === field.key) + if (from < 0 || to < 0) return + const [moved] = rows.splice(from, 1) + rows.splice(to, 0, moved) + rows.forEach((item, index) => { queryPrefs[item.key].order = (index + 1) * 10 }) } function onSearch() { activeQueryMode.value = 'quick' @@ -402,12 +459,17 @@ function applyAdvancedQuery() { activeQueryMode.value = 'advanced' queryMode.value = 'advanced' queryApplied.value = true + advancedSnapshot.value = null drawerOpen.value = false } -function onReset() { - Object.assign(searchForm, makeEmptyForm()) - advancedNodes.splice(0, advancedNodes.length) - advancedGroups.splice(0, advancedGroups.length) +function resetAllQueries() { + resetQuickQuery() + resetAdvancedQuery() + queryApplied.value = false + advancedSnapshot.value = null +} +function returnToQuickQuery() { + if (drawerOpen.value && drawerTab.value === 'conditions') closeQueryDrawer() activeQueryMode.value = 'quick' queryMode.value = 'quick' queryApplied.value = false @@ -545,20 +607,8 @@ function onMoreAction({ key }) {
-
-
- 查询模式 - - -
-
- 当前生效：{{ activeQueryMode === 'quick' ? '普通查询' : '高级查询' }} - 正在编辑{{ queryMode === 'quick' ? '普通' : '高级' }}查询 -
-
-
高级查询条件在右侧 Drawer 中配置。普通查询条件仍会保留，但当前不会参与结果。
- @@ -784,16 +859,11 @@ function onMoreAction({ key }) { padding: 12px 16px 8px; container-type: inline-size; } -.query-mode-bar { display: flex; align-items: center; justify-content: space-between; gap: 16px; margin-bottom: 12px; } -.query-mode-switch { display: flex; align-items: center; gap: 2px; } -.query-mode-label { margin-right: 8px; color: var(--fms-text-secondary); font-size: 12px; } -.query-mode-switch button { min-height: 30px; padding: 0 12px; border: 1px solid var(--fms-border); background: var(--fms-card); color: var(--fms-text-secondary); font-size: 12px; cursor: pointer; } -.query-mode-switch button:first-of-type { border-radius: 4px 0 0 4px; } -.query-mode-switch button:last-of-type { border-left: 0; border-radius: 0 4px 4px 0; } -.query-mode-switch button.active { border-color: var(--fms-primary); background: var(--fms-primary); color: #fff; font-weight: 600; } -.query-mode-status { color: var(--fms-text-secondary); font-size: 12px; } -.query-mode-status strong { color: var(--fms-text); font-weight: 600; } -.query-mode-draft { margin-left: 8px; color: #8a6414; } +.advanced-query-button { gap: 5px; color: var(--fms-text-secondary); } +.advanced-query-button:hover { color: var(--fms-primary); } +.advanced-query-button .query-count { margin-left: 2px; } +.return-quick-button { color: var(--fms-text-secondary); } +.return-quick-button:hover { color: var(--fms-primary); } /* ---- ① 搜索区：固定格宽 + 顶部标签 ---- */ .list-search { @@ -880,16 +950,6 @@ function onMoreAction({ key }) { .quick-more-button { gap: 5px; } .quick-more-button svg { transition: transform 160ms ease; } .quick-more-button svg.is-up { transform: rotate(180deg); } -.advanced-mode-note { grid-column: 1 / -1; padding: 7px 9px; border-radius: 4px; background: #fff8e6; color: #8a6414; font-size: 12px; } - -.search-toggle__icon { - transition: transform 160ms ease; -} - -.search-toggle__icon.is-up { - transform: rotate(180deg); -} - /* ---- ② 工具条：左「改数据」，中 状态，右「用数据」 ---- */ .list-toolbar { display: flex; @@ -1055,10 +1115,6 @@ function onMoreAction({ key }) { .query-drawer__sub { display: block; margin-top: 4px; color: var(--fms-text-secondary); font-size: 12px; } .query-drawer__close { width: 30px; height: 30px; border: 0; border-radius: 5px; background: transparent; color: var(--fms-text-secondary); font-size: 22px; } .query-drawer__close:hover { background: var(--fms-background, #f5f6f8); } -.query-drawer__tabs { display: flex; flex: none; gap: 22px; padding: 0 20px; border-bottom: 1px solid var(--fms-border-soft, #f0f1f3); } -.query-drawer__tabs button { position: relative; height: 42px; padding: 0; border: 0; background: transparent; color: var(--fms-text-secondary); font-size: 13px; } -.query-drawer__tabs button.active { color: var(--fms-primary); font-weight: 600; } -.query-drawer__tabs button.active::after { position: absolute; right: 0; bottom: -1px; left: 0; height: 2px; background: var(--fms-primary); content: ''; } .query-drawer__body { flex: 1; min-height: 0; overflow: auto; padding: 18px 20px; } .mode-notice { display: flex; align-items: flex-start; gap: 8px; margin-bottom: 16px; padding: 9px 10px; border: 1px solid #d8e5f7; border-radius: 5px; background: #f7faff; color: #526176; font-size: 12px; line-height: 1.5; } .mode-notice__dot { flex: none; width: 7px; height: 7px; margin-top: 5px; border-radius: 50%; background: var(--fms-primary); } @@ -1066,6 +1122,7 @@ function onMoreAction({ key }) { .drawer-section-title span { color: var(--fms-text-secondary); font-size: 12px; font-weight: 400; } .ast-root { display: flex; align-items: center; gap: 8px; margin-bottom: 10px; color: var(--fms-text-secondary); font-size: 12px; } .ast-root select, .ast-row select { height: 34px; border: 1px solid var(--fms-border); border-radius: 4px; background: var(--fms-card); color: var(--fms-text); padding: 0 9px; outline: none; } +.ast-empty { margin: 8px 0 12px; padding: 18px 12px; border: 1px dashed var(--fms-border); border-radius: 5px; color: var(--fms-text-secondary); font-size: 12px; text-align: center; } .ast-row { display: grid; grid-template-columns: minmax(160px, 1.25fr) 150px minmax(130px, 1fr) 30px; gap: 8px; align-items: center; margin-bottom: 8px; } .ast-group { margin: 12px 0; padding: 10px; border: 1px solid #dfe6ef; border-radius: 6px; background: #fbfcfe; } .ast-group__head { display: flex; align-items: center; gap: 8px; margin-bottom: 8px; color: var(--fms-text-secondary); font-size: 12px; } @@ -1076,15 +1133,13 @@ function onMoreAction({ key }) { .ast-field-wrap .ast-field { min-width: 0; flex: 1; } .relation-badge { flex: none; padding: 2px 5px; border-radius: 3px; background: #f3edff; color: #7048b8; font-size: 10px; } .ast-value { width: 100%; min-width: 0; } -.ast-range-value { min-width: 0; } +.ast-range-value { display: flex; min-width: 0; align-items: center; gap: 5px; } +.ast-range-value :deep(input) { min-width: 0; flex: 1; } .ast-range-value :deep(input) { width: 100%; } .ast-remove { width: 28px; height: 28px; border: 0; border-radius: 4px; background: transparent; color: var(--fms-text-secondary); font-size: 18px; } .ast-remove:hover { background: #fff1f0; color: var(--fms-danger); } .ast-hint { display: flex; align-items: center; gap: 6px; margin: 12px 0; color: var(--fms-text-secondary); font-size: 12px; } .drawer-actions { display: flex; gap: 8px; padding-top: 12px; border-top: 1px dashed var(--fms-border); } -.ast-preview { margin-top: 16px; border-top: 1px solid var(--fms-border-soft); color: var(--fms-text-secondary); font-size: 12px; } -.ast-preview summary { padding-top: 12px; cursor: pointer; } -.ast-preview pre { max-height: 210px; margin: 10px 0 0; overflow: auto; padding: 10px; border-radius: 4px; background: #f7f9fc; color: #526176; font: 11px/1.55 ui-monospace, SFMono-Regular, Consolas, monospace; white-space: pre-wrap; } .query-drawer__foot { display: flex; flex: none; align-items: center; justify-content: flex-end; gap: 8px; padding: 12px 20px; border-top: 1px solid var(--fms-border-soft, #f0f1f3); } .ast-foot-note { flex: 1; color: var(--fms-text-secondary); font-size: 12px; } .settings-note { margin-bottom: 14px; padding: 9px 10px; border: 1px solid #e8edf3; border-radius: 5px; background: #f7f9fc; color: var(--fms-text-secondary); font-size: 12px; } @@ -1095,5 +1150,5 @@ function onMoreAction({ key }) { .setting-row { display: flex; align-items: center; gap: 8px; min-height: 42px; padding: 0 12px; border-bottom: 1px solid var(--fms-border-soft); }.setting-row:last-child { border-bottom: 0; } .setting-empty { padding: 12px; color: var(--fms-text-secondary); font-size: 12px; } .drag-handle { color: #a3acb8; letter-spacing: -2px; }.setting-label { flex: 1; min-width: 0; color: var(--fms-text); }.setting-row button { border: 0; background: transparent; color: var(--fms-primary); font-size: 12px; }.setting-row button:hover { text-decoration: underline; }.setting-more { color: var(--fms-text-secondary) !important; }.setting-row.is-disabled { color: var(--fms-disabled-text); }.setting-row.is-disabled .setting-label { color: var(--fms-disabled-text); }.setting-disabled { color: var(--fms-disabled-text); font-size: 12px; } -@media (max-width: 760px) { .query-drawer__body { padding-inline: 12px; }.query-drawer__head, .query-drawer__tabs, .query-drawer__foot { padding-inline: 12px; }.ast-row { grid-template-columns: 1fr 1fr; }.ast-row .ast-value { grid-column: 1 / span 2; }.ast-remove { justify-self: end; margin-top: -38px; } .active-query-bar { flex-wrap: wrap; } } +@media (max-width: 760px) { .query-drawer__body { padding-inline: 12px; }.query-drawer__head, .query-drawer__foot { padding-inline: 12px; }.ast-row { grid-template-columns: 1fr 1fr; }.ast-row .ast-value { grid-column: 1 / span 2; }.ast-remove { justify-self: end; margin-top: -38px; } .active-query-bar { flex-wrap: wrap; } } diff --git a/code/fms/字段权限与字段个性化设计.md b/code/fms/字段权限与字段个性化设计.md deleted file mode 100644 index f55259e8..00000000 --- a/code/fms/字段权限与字段个性化设计.md +++ /dev/null @@ -1,159 +0,0 @@ -# 字段权限与字段个性化设计 - -> 状态：设计定稿，未实现。创建于 2026-09-04。 -> 关联文档：[FMS新系统核心表结构设计.md](./FMS新系统核心表结构设计.md)（其中 s_power / s_role_power 部分） - -## 1. 背景与目标 - -系统已有全局的字段显示配置（`s_field_view` / `s_field_edit`，在模块设计器中维护，对所有人生效）。本设计解决两个新需求： - -1. **字段权限**：管理员（高权限角色）控制某个人/某些人**能不能看到**某些字段； -2. **字段个性化**：用户自己调整列表的**字段顺序、列宽、显示/隐藏**，且只影响自己、跨设备持久化。 - -范围约定： - -- 个性化只作用于**列表**（查看态列表 + 可编辑列表两套配置），**表单不参与**顺序/布局个性化； -- 单公司系统（无多租户维度），后续如需多公司再扩展； -- 不考虑旧数据迁移难度。 - -## 2. 三层模型 - -``` -第 1 层 默认配置（模板） s_field_view / s_field_edit 模块设计器维护，管理员设定 -第 2 层 字段权限（谁能看） s_power(field型) + s_role_power 管理员按角色控制可见性 -第 3 层 个人偏好（怎么摆） s_user_field_pref（新表） 用户自己拖拽，只影响自己 -``` - -职责边界是本设计的核心原则： - -- **权限决定"全集"**：deny 的字段对用户不存在（列表不渲染、后端不返回）； -- **偏好只决定"排列"**：顺序、宽度、个人显隐，永远在权限允许的范围内生效，无法越过权限； -- 终端用户能控制的只有自己的布局，可见性的控制权始终在管理员手里。 - -两层独立演化：将来权限规则变化，偏好数据不需要清洗（偏好里残留无权限字段只是无效数据，不构成越权）。 - -## 3. 数据结构 - -### 3.1 新表：s_user_field_pref（个人偏好） - -一人 × 一模块 × 一字段 × 一模式 一行。每字段一行（而非 JSON 快照），可直接复用现有通用 CRUD（DataService）。 - -```sql -CREATE TABLE s_user_field_pref ( - b_id VARCHAR(32) PRIMARY KEY, - b_user_id VARCHAR(32) NOT NULL, - b_module_id VARCHAR(32) NOT NULL, - b_field_id VARCHAR(32) NOT NULL, - b_mode VARCHAR(10) NOT NULL, -- 'view' 查看列表 / 'edit' 可编辑列表 - b_visible TINYINT DEFAULT 1, -- 个人显隐（1 显示，0 隐藏） - b_xh INT, -- 个人顺序号 - b_width INT, -- 个人列宽 - b_update_time DATETIME, - UNIQUE KEY uk_user_field (b_user_id, b_module_id, b_field_id, b_mode) -); -``` - -说明： - -- 用户**没有**保存过偏好的字段不产生行，解析时落回默认配置（`s_field_view` / `s_field_edit`）； -- 保存过布局 = 该用户该模块该 mode 存在偏好行，此后**默认布局变更对该用户不再生效**（保持用户自主摆放的稳定性），可通过"恢复默认"删除偏好行回到跟随默认； -- "恢复默认" = 删除该用户 + 该模块 + 该 mode 的全部行。 - -### 3.2 权限层：复用已有表 + 一张用户级覆盖表 - -- `s_power`（field 型：`b_module_id + b_field_id + b_operation`[view/edit]）与 `s_role_power`（`b_effect` allow/deny）沿用现有表结构，见 [FMS新系统核心表结构设计.md](./FMS新系统核心表结构设计.md)； -- 新增用户级覆盖表，用于个别用户的特例（平时应为空表，只为"开小灶"使用，不值得建角色时用它）： - -```sql -CREATE TABLE s_user_power ( - b_id VARCHAR(32) PRIMARY KEY, - b_user_id VARCHAR(32) NOT NULL, - b_module_id VARCHAR(32) NOT NULL, - b_field_id VARCHAR(32) NOT NULL, - b_operation VARCHAR(10) NOT NULL, -- 'view' / 'edit' - b_effect VARCHAR(10) NOT NULL, -- 'allow' / 'deny' - UNIQUE KEY uk_user_field_op (b_user_id, b_module_id, b_field_id, b_operation) -); -``` - -## 4. 解析算法 - -### 4.1 字段可见性（权限链） - -``` -可见性 = 用户级覆盖（s_user_power，有配置则生效，优先级最高） - ↓ 该用户该字段无配置 - 角色合并（该用户所有角色的 s_role_power，deny 优先：任一角色 deny 即 deny） - ↓ 无任何角色配置 - 默认可见（allow） -``` - -要点： - -- **默认全部可见，黑名单式配置**：只为敏感字段配 deny，不为普通字段配 allow，维护量最小； -- deny 优先（而非 allow 优先）：敏感字段场景下更安全。 - -### 4.2 列表最终配置（合并链） - -对查看列表和可编辑列表分别执行（mode = view / edit）： - -``` -最终配置 = 默认配置（s_field_view / s_field_edit，含 b_canuse 过滤） - → 剔除权限 deny 的字段 - → 用个人偏好覆盖 b_xh / b_width / b_visible - → 偏好中没有的字段，按默认配置的顺序追加补全 -``` - -有效显示 = `权限可见 && 字段可用(b_canuse=1) && 个人未隐藏`。 - -补全规则保证：新增字段、默认配置新启用的字段，即使用户保存过布局也会按默认顺序出现在列表尾部，不会"消失"。 - -### 4.3 顺序合并细节 - -偏好只覆盖出现过的字段；用户保存布局后管理员再调默认顺序，对已保存用户无效（见 3.1）。 - -## 5. 边界场景约定 - -| 场景 | 行为 | -|---|---| -| 字段 `b_canuse=0`（下架） | 不进入候选集，即使偏好表里有该字段的行也不显示（偏好行成无效数据，暂不清理，量大后在字段下架入口顺带删除） | -| 新增字段 | 所有用户可见：无偏好则按默认顺序出现在尾部 | -| 权限从 allow 变 deny | 字段对用户消失；偏好数据保留，权限恢复后用户的自定义布局自动恢复 | -| 用户隐藏字段 vs 权限隐藏字段 | 是两回事：个人隐藏 = 有权看但暂时不显示，"栏位设置"弹窗可随时勾回；权限隐藏 = 对该用户不存在，弹窗中**不展示**无权限字段 | -| 必填字段被用户隐藏（可编辑列表） | **待定**，见第 8 节 | - -## 6. 交互设计 - -- 列表列头拖拽排序、拖拽调宽（能力已有：`FmsTable.vue`）； -- 拖拽结束后防抖保存（约 500ms）upsert 到 `s_user_field_pref`； -- 菜单保留"保存/恢复栏位设置"，语义从全局改为个人："恢复"即删除偏好行； -- "栏位设置"弹窗：排序 + 个人显隐 + 列宽统一管理；不展示无权限字段； -- 可选：管理员入口"保存为全局默认"，仍写 `s_field_view` / `s_field_edit`。 - -## 7. 改动范围（实现清单） - -| 位置 | 改动 | -|---|---| -| migration | 新增 `s_user_field_pref`、`s_user_power` 建表 | -| 后端 DataService | ① 字段权限过滤：deny 字段从查询结果中剔除（设计文档既定要求，目前后端零过滤）② 偏好表 CRUD 复用现有通用机制 | -| 前端 `stores/permissions.js` | 新增 `canField(moduleId, fieldId, operation)`：用户级 → 角色合并（deny 优先）→ 默认 allow | -| 前端 `FmsModuleListPage.vue` | `loadData` 中实现合并链（默认 → 权限过滤 → 偏好覆盖 → 补全）；`saveColumnSettings` 保存目标从 `s_field_view/s_field_edit` 改为 `s_user_field_pref` | -| 权限管理 UI | 模块管理 `ModuleFieldsPanel` 旁新增"字段权限"页签：选角色 × 勾字段（view/edit）；入口本身由现有模块/按钮权限（`canPower`）控制，实现"高权限的人才能配" | -| 用户级覆盖 UI | 可后置：先支持直接改 `s_user_power` 数据，界面后续补 | - -关键实现纪律：**合并偏好的代码必须在权限过滤之后执行**，保证偏好永远无法越过权限。 - -## 8. 待定事项 - -**必填字段被用户隐藏后的校验策略**（可编辑列表场景）： - -| 方案 | 规则 | 适用 | -|---|---|---| -| A. 所见即所验 | 隐藏后跳过必填校验 | "必填"只是引导性要求，空值可接受；且权限隐藏与用户隐藏行为天然统一，无需特殊分支 | -| B. 必填不可藏 | 可编辑列表中必填字段置灰、禁止隐藏 | "必填"是业务硬规则，字段空值会损害下游使用 | - -判断标准：该字段空着，会不会有人受害。会 → B；不会 → A。权限隐藏（管理员 deny）场景下无论选哪个方案，行为都与 A 一致（用户"没有这个字段"，天然不校验）。 - ---- - -**结论摘要**：默认配置（全局模板）→ 字段权限（管理员按角色控制可见性，deny 优先，默认全可见，用户级覆盖兜底）→ 个人偏好（仅列表的顺序/列宽/显隐，权限范围内生效，未设置走默认）。 diff --git a/code/fms/字段权限与用户个性化设计.md b/code/fms/字段权限与用户个性化设计.md new file mode 100644 index 00000000..b548164f --- /dev/null +++ b/code/fms/字段权限与用户个性化设计.md @@ -0,0 +1,877 @@ +# FMS 权限体系设计文档 + +## 1. 设计目标 + +本权限体系用于 FMS / ERP 元数据驱动架构，核心目标： + +1. 操作权限与数据权限分离。 +2. 权限直接绑定菜单、动作、模块、字段、页面、报表等资源。 +3. Power ID 不要求人工维护，直接由资源类型、资源 ID 和操作组成。 +4. 用户直接授权，不引入角色继承。 +5. 数据权限独立于菜单，不因为用户从哪个菜单进入而改变数据范围。 +6. 用户个性化设置不能突破权限。 +7. 权限默认拒绝（Default Deny）。 + +--- + +## 2. 权限模型总览 + +整个权限体系分为两条线： + +```text + ┌──────────────┐ + │ 资源定义 │ + └──────┬───────┘ + │ + ┌──────────┼──────────┐ + │ │ │ + 菜单/动作 模块/字段 页面/报表 + │ │ │ + └──────────┼──────────┘ + ↓ + s_power + ↓ + s_user_power + ↓ + 用户操作权限 + + + ┌──────────────┐ + │ 数据模块 │ + └──────┬───────┘ + ↓ + s_data_scope + ↓ + s_user_data_scope + ↓ + 数据范围 +``` + +因此： + +- `s_power`：定义「能做什么」 +- `s_user_power`：定义「用户能做什么」 +- `s_data_scope`：定义「能看到 / 操作哪些数据」 +- `s_user_data_scope`：定义「用户在某个模块、某个操作下使用哪个数据范围」 + +--- + +## 3. Power ID 设计 + +### 3.1 核心原则 + +`b_id` 不再使用随机 ID，也不要求人工创建类似： + +```text +power_cw_fee_update +power_cw_fee_audit +power_cw_fee_amount_edit +``` + +而是直接使用稳定、可解析的权限编码。 + +统一格式： + +```text +menu. +action. +module.. +field... +page. +report. +``` + +### 3.2 Power ID 示例 + +**菜单权限** + +```text +menu.cw_fee +``` + +表示：可以进入 / 使用费用管理菜单。 + +**动作权限** + +```text +action.cw_fee_audit +``` + +表示：可以执行费用审核动作。 + +**模块权限** + +```text +module.cw_fee.read +module.cw_fee.create +module.cw_fee.update +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 +page.cw_fee +``` + +**报表权限** + +```text +report.cw_fee_summary +``` + +--- + +## 4. Power 类型 + +| b_power_type | 用途 | ID 格式 | +| ------------ | ------------ | --------------------------------------- | +| menu | 菜单入口 | `menu.` | +| action | 业务动作 | `action.` | +| module | 数据模块操作 | `module..` | +| field | 字段能力 | `field...` | +| page | 页面入口 | `page.` | +| report | 报表入口 | `report.` | + +--- + +## 5. 操作权限语义 + +### 5.1 menu + +```text +menu.cw_fee +``` + +用于判断用户是否拥有菜单入口权限。 + +菜单权限只解决： + +- 用户能不能进入这个菜单。 + +不负责： + +- 数据范围 +- 字段权限 +- 审核权限 +- 删除权限 + +### 5.2 action + +例如： + +```text +action.cw_fee_audit +action.cw_fee_unaudit +action.cw_fee_writeoff +``` + +统一使用： + +- `b_power_type = action` +- `b_operation = execute` + +动作权限解决：用户能不能执行这个具体业务动作。 + +### 5.3 module + +例如： + +```text +module.cw_fee.read +module.cw_fee.create +module.cw_fee.update +module.cw_fee.delete +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 + +例如： + +```text +page.cw_fee +``` + +用于页面访问控制。 + +页面权限和菜单权限可以同时存在： + +```text +menu.cw_fee +page.cw_fee +``` + +菜单解决入口展示 / 进入菜单，页面解决具体页面访问。 + +### 5.6 report + +例如： + +```text +report.cw_fee_summary +``` + +用于报表访问权限。 + +报表权限本身不等于数据权限。例如用户拥有 `report.cw_fee_summary`，还需要根据报表对应的数据模块执行数据范围控制。 + +--- + +## 6. 核心表结构 + +以下表结构暂时不加入索引、唯一约束、外键约束，后续根据实际运行情况再补充。 + +### 6.1 s_power + +权限定义表。 + +```sql +create table dbo.s_power ( + b_id varchar(300) not null, + + b_name nvarchar(200) not null, + b_i18n varchar(150) null, + + b_power_type varchar(20) not null, + -- menu / action / module / field / page / report + + b_resource varchar(128) null, + -- action / page / report 等资源 ID + + b_menu_id varchar(50) null, + -- 所属菜单，主要用于 menu / action + + 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, + + b_xh int not null default 0 +); +``` + +`b_id` 示例： + +```text +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 +``` + +这里的 `b_id` 就是 Power 的业务编码。 + +不再需要 `power_cw_fee_update`、`power_cw_fee_audit` 这种额外编码。 + +--- + +## 7. s_user_power + +用户权限授权表。 + +```sql +create table dbo.s_user_power ( + b_user_id varchar(50) not null, + + b_power_id varchar(300) not null, + + b_canuse tinyint not null default 1, + + b_updatedatetime datetime2 null +); +``` + +语义： + +- 存在有效记录 = 用户拥有权限 +- 不存在记录 = 用户没有权限 +- `b_canuse = 0` = 当前授权无效 + +当前设计不增加 allow / deny，即采用： + +**默认拒绝，明确授权。** + +--- + +## 8. 数据权限 + +操作权限与数据权限必须分开。 + +例如： + +```text +module.cw_fee.read +``` + +只表示：用户具有读取费用数据的能力。 + +它并不表示：用户可以读取所有费用数据。 + +数据范围由 `s_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 + +用户数据权限授权表。 + +```sql +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_id varchar(50) not null, + + b_xh int not null default 0, + + b_updatedatetime datetime2 null +); +``` + +多个 Scope 同时存在时： + +```text +Scope A OR Scope B OR Scope C +``` + +例如： + +```text +张三 +cw_fee +read + ├── department + └── own +``` + +表示张三读取费用数据时：department 范围 OR own 范围。 + +--- + +## 11. 完整示例 + +假设系统有： + +- 模块：`cw_fee` = 费用管理 +- 菜单：`cw_fee` = 费用管理 +- 动作：`cw_fee_audit` = 审核、`cw_fee_unaudit` = 反审核、`cw_fee_writeoff` = 核销 +- 字段：`mx_amount` = 金额 + +### 11.1 自动产生 Power + +菜单： + +```text +menu.cw_fee +``` + +动作： + +```text +action.cw_fee_audit +action.cw_fee_unaudit +action.cw_fee_writeoff +``` + +模块： + +```text +module.cw_fee.read +module.cw_fee.create +module.cw_fee.update +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. 用户授权示例 + +张三拥有： + +- `menu.cw_fee` +- `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 ( + b_user_id, + b_power_id, + b_canuse +) +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); +``` + +张三没有 `module.cw_fee.delete`、`field.cw_fee.mx_amount.edit`，所以： + +- 不能删除费用 +- 不能修改金额字段 + +--- + +## 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 +) +values ( + 'zhangsan', + 'cw_fee', + 'read', + 'scope.cw_fee.department', + 0 +); +``` + +此时张三拥有 `module.cw_fee.read`，并且 read 数据范围 = 本部门。 + +最终不是「张三可以读取全部费用」，而是「张三可以读取自己有权限范围内的费用」。 + +--- + +## 14. 权限执行顺序 + +一个业务操作建议按照以下顺序判断： + +```text +① 用户是否有效 + ↓ +② 菜单 / 页面入口权限 + ↓ +③ Action 权限 + ↓ +④ Module 数据操作权限 + ↓ +⑤ Field 字段权限 + ↓ +⑥ Data Scope 数据范围 + ↓ +⑦ 业务状态 / 业务规则 + ↓ +⑧ 执行操作 +``` + +例如「审核费用」： + +```text +用户 + ↓ +menu.cw_fee + ↓ +page.cw_fee + ↓ +action.cw_fee_audit + ↓ +module.cw_fee.update + ↓ +数据范围 + ↓ +费用当前状态 = 送审 + ↓ +执行审核 +``` + +--- + +## 15. 不同权限解决不同问题 + +| 问题 | 权限 | +| -------------- | ------------------------------- | +| 能不能看到菜单 | `menu.*` | +| 能不能进入页面 | `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` | +| 能不能看报表 | `report.*` | +| 能看哪些数据 | `s_data_scope` | + +--- + +## 16. 与元数据体系的关系 + +Power 不应该成为另一套独立的资源体系，而应该从现有元数据自动生成。 + +```text +s_menu + ↓ +menu. + +Action 定义 + ↓ +action. + +s_module + ↓ +module.. + +s_field + ↓ +field... + +Page 定义 + ↓ +page. + +Report 定义 + ↓ +report. +``` + +因此新增模块 `cw_air_fee`，系统可以自动注册： + +```text +module.cw_air_fee.read +module.cw_air_fee.create +module.cw_air_fee.update +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 编码。 + +--- + +## 17. 权限与用户个性化的关系 + +用户个性化配置（`s_user_field_pref`、`s_user_query_field_pref`）只能调整： + +- 显示 +- 排序 +- 宽度 +- 查询字段默认状态 + +不能增加权限。 + +最终优先级： + +```text +字段 b_canuse + ↓ +权限 + ↓ +系统默认布局 + ↓ +用户个性化 +``` + +例如：用户没有 `field.cw_fee.mx_amount.view`，即使 `s_user_field_pref.b_visible = 1`，也不能显示金额字段。 + +--- + +## 18. 最终推荐的核心关系 + +```text +┌───────────────┐ +│ s_module │ +└───────┬───────┘ + │ + ├──────────────┐ + ↓ ↓ + s_field s_data_scope + │ │ + ↓ ↓ + s_power s_user_data_scope + │ + ↓ + s_user_power + │ + ↓ + b_user +``` + +菜单和动作： + +```text +s_menu + │ + ├── menu. + │ + └── action. + ↓ + s_power +``` + +页面和报表： + +```text +page / report + ↓ + s_power +``` + +--- + +## 19. 最终结论 + +本设计的核心原则可以归纳为： + +- 资源 ID = 资源本身的 ID +- Power ID = 资源类型 + 资源 ID + Operation + +统一规则： + +```text +menu. +action. +module.. +field... +page. +report. +``` + +其中： + +- `b_id` 是稳定的业务权限编码，不需要人工随机生成。 +- `s_power` 是统一权限注册表。 +- `s_user_power` 是用户操作权限。 +- `s_data_scope` 是数据范围定义。 +- `s_user_data_scope` 是用户数据范围授权。 +- 操作权限和数据权限完全分离。 +- 菜单不负责数据范围。 +- 用户个性化不能突破权限。 +- 当前不引入角色继承。 +- 后续如果增加角色，可以在 `s_user_power` 之外增加角色授权层，而无需改变 Power 编码体系。 + +--- + +## 20. Demo 数据（4 张表） + +以下为 4 张表的示例数据，沿用正文的 `cw_fee` 费用模块。示例用户：张三（费用会计）、李四（财务经理）。 + +### 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 | + +要点：覆盖全部 6 种 `b_power_type`；`b_id` 由类型 + 资源 + 操作自动拼出，`b_module_id` / `b_field` 等列是解析冗余，便于按模块、字段反查权限。 + +### 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 | + +要点： + +- 张三的 `module.cw_fee.delete` 记录存在但 `b_canuse = 0`，演示「授权被手动停用 = 无权限」，与「无记录 = 无权限」效果相同； +- 张三没有 `field.cw_fee.mx_amount.edit`，金额字段对他只读；李四全量字段能力。 + +### 20.3 s_data_scope（数据范围定义） + +| 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 | + +要点： + +- 张三 read 挂了两条范围 → 部门数据 OR 本人数据； +- 数据范围按操作分开授权：张三能看本部门，但只能改自己录的费用（update 仅 own）； +- 李四 delete 挂 `all`，经理可删全模块数据，符合「操作越重、范围越收」或「管理者放宽」都可表达的弹性。 + +### 20.5 组合结果解读 + +| 能力 | 张三（费用会计） | 李四（财务经理） | +| ---------------- | ---------------------------------------- | -------------------------------- | +| 看菜单 / 页面 | ✅ | ✅ | +| 读取费用数据 | ✅ 本部门 + 本人 | ✅ 本部门及下属部门 | +| 新增 | ❌ 无 module.create | ✅ | +| 修改 | ✅ 仅本人录入的单据 | ✅ 本部门及下属部门的单据 | +| 删除 | ❌ 授权已停用（b_canuse=0） | ✅ 全部数据 | +| 审核 / 反审核 | ✅ 可审核，❌ 不可反审核 | ✅ 都可以 | +| 金额字段 | 可看、可查询、❌ 不可编辑、❌ 不可导出字段列 | 可看、可编辑、可导出 | +| 汇总报表 | ✅ | ✅（报表数据仍受 read 范围约束） |