系统管理

数脉平台用户手册 V2.0 · 系统管理

用户管理

功能定位

用户管理维护平台账号、所属部门、岗位、角色、状态和登录信息。它是“谁能进入系统”的第一道边界,也是审计和权限排查的起点。

用户管理

图 8-1 部门树、用户筛选和用户列表

适用角色

超级管理员、系统管理员和经授权的部门管理员。

页面入口

系统管理 → 用户管理(/system/user)。

页面结构

操作步骤

  1. 在左侧选择部门,或在筛选区输入用户名称/昵称后点击“搜索”。
  2. 点击“新增”,填写用户名称、昵称、部门、手机号码、邮箱、岗位和角色。
  3. 设置初始状态和密码策略。初始密码应由管理员安全交付,首次登录后要求修改。
  4. 在“角色”中按岗位选择最少必要角色,不要直接复制超级管理员。
  5. 用户离职或转岗时先停用账号、回收角色,再按制度删除或保留审计记录。
  6. 账号被锁定时使用“解锁”,但应先确认是否因连续输错密码或异常登录导致。

输入与输出

输入是账号资料、部门、岗位、角色和状态;输出是可登录账号、权限集合、部门数据范围和操作审计记录。

宏澜家电示例

新入职的华南区域销售分析师被分配到“销售中心/区域销售部”,授予 BI业务用户 和 BI分析师 角色,只允许查看华南区域数据。离职时先停用账号并移除角色,历史操作日志保留。

客户应用演示:创建华东区域销售经理账号

业务情境: 新员工入职,需要登录平台查看本区域看板和报表。

第一步:进入“系统管理 → 用户管理”

第1步重点操作:进入“系统管理 → 用户管理”

步骤图 44-01 第1步:进入“系统管理 → 用户管理”。红框标出进入系统管理 → 用户管理。

进入“系统管理 → 用户管理”,先确认所属部门已经存在。

第二步:点击“新增”

第2步重点操作:点击“新增”

步骤图 44-02 第2步:点击“新增”。红框标出点击新增。

点击“新增”,填写登录账号、姓名、部门、手机号和初始密码。

第三步:保存后点击“分配角色”

第3步重点操作:保存后点击“分配角色”

步骤图 44-03 第3步:保存后点击“分配角色”。红框标出保存后点击分配角色。

保存后点击“分配角色”,选择“区域销售经理”角色。

第四步:确认账号状态正常

第4步重点操作:确认账号状态正常

步骤图 44-04 第4步:确认账号状态正常。红框标出确认账号状态正常。

确认账号状态正常,并设置首次登录修改密码。

第五步:用新账号实际登录

第5步重点操作:用新账号实际登录

步骤图 44-05 第5步:用新账号实际登录。红框标出用新账号实际登录。

用新账号实际登录,检查菜单、看板数据和报表权限。

最终结果与效果

新账号可以登录,只看到岗位所需菜单和本区域数据;管理员可随时停用或调整角色。

操作提示: 不要共享管理员账号,不要将初始密码通过公开渠道发送。

常见问题

用户能看到菜单但不能导出。 菜单权限和按钮权限是两层控制,需要补充导出权限。

新增用户后无法登录。 检查账号状态、密码、验证码、角色和是否被锁定。

删除用户失败。 该用户可能仍被业务数据引用;优先停用而不是物理删除。

开发人员参考

角色管理

功能定位

角色是权限的集合。数脉不直接给个人堆叠权限,而是按岗位建立角色,再把角色分配给用户。角色同时控制菜单可见性、按钮操作和数据范围。

角色管理

图 8-2 角色权限字符、显示顺序、状态和用户分配

适用角色

超级管理员、安全管理员和系统管理员。

页面入口

系统管理 → 角色管理(/system/role)。

页面结构

操作步骤

  1. 点击“新增”,填写角色名称、权限字符、显示顺序和状态。
  2. 在“菜单权限”中勾选该角色可访问的目录、菜单和按钮。父目录可见不代表子按钮自动可用。
  3. 在“数据权限”中选择全部数据、本部门、本部门及以下、仅本人或自定义部门。
  4. 保存后点击“分配用户”,批量添加或移除成员。
  5. 修改角色权限前先评估在线用户和关键业务时段,必要时在变更窗口操作。
  6. 删除角色前确认没有用户绑定,且没有流程、报表或数据权限引用。

输入与输出

输入是角色名称、权限字符、菜单权限和数据范围;输出是角色、权限集合、用户绑定关系和授权审计。

宏澜家电示例

建立“集团管理层”角色:可查看经营大屏、数据探索和智能报表,但不能修改建模字典和系统配置;数据范围为集团全部。建立“部门负责人”角色:只能查看本部门及下级数据,不能导出客户联系方式。

客户应用演示:配置“区域销售经理”角色

业务情境: 多个区域经理需要相同菜单、按钮和数据范围,用角色统一管理。

第一步:进入“系统管理 → 角色管理”

第1步重点操作:进入“系统管理 → 角色管理”

步骤图 45-01 第1步:进入“系统管理 → 角色管理”。红框标出进入系统管理 → 角色管理。

进入“系统管理 → 角色管理”,点击“新增”。

第二步:填写角色名称、权限字符和显示顺序

第2步重点操作:填写角色名称、权限字符和显示顺序

步骤图 45-02 第2步:填写角色名称、权限字符和显示顺序。红框标出填写角色名称、权限字符和显示顺序。

填写角色名称、权限字符和显示顺序。

第三步:在菜单权限中勾选大屏展示、仪表盘、业务报表、AI 对话分析

第3步重点操作:在菜单权限中勾选大屏展示、仪表盘、业务报表、AI 对话分析

步骤图 45-03 第3步:在菜单权限中勾选大屏展示、仪表盘、业务报表、AI 对话分析。红框标出在菜单权限中勾选大屏展示、仪表盘、业务报表、AI 对话分析。

在菜单权限中勾选大屏展示、仪表盘、业务报表、AI 对话分析。

第四步:设置数据范围为本人或本部门

第4步重点操作:设置数据范围为本人或本部门

步骤图 45-04 第4步:设置数据范围为本人或本部门。红框标出设置数据范围为本人或本部门。

设置数据范围为本人或本部门,保存后分配用户。

第五步:用一个测试账号验证菜单可见性和越权限制

第5步重点操作:用一个测试账号验证菜单可见性和越权限制

步骤图 45-05 第5步:用一个测试账号验证菜单可见性和越权限制。红框标出用一个测试账号验证菜单可见性和越权限制。

用一个测试账号验证菜单可见性和越权限制。

最终结果与效果

同岗位用户共享一套权限,新增人员只需分配角色,避免逐个账号配置。

操作提示: 角色权限应最小化;高风险按钮和导出权限单独评估。

常见问题

用户拥有角色仍看不到菜单。 检查菜单权限是否勾选、菜单是否隐藏、角色是否启用、用户是否重新登录。

同名权限字符冲突。 权限字符必须唯一,建议使用小写英文和下划线。

角色删除后用户无法登录。 删除角色前先迁移用户,避免账号失去必要的基础权限。

开发人员参考

菜单管理

功能定位

菜单管理维护目录、菜单和按钮三级结构,决定左侧导航、页面路由、组件路径和权限标识。它是系统功能入口的“总开关”,修改会影响所有角色。

菜单管理

图 8-3 目录、菜单与按钮的树形维护

适用角色

系统管理员、BI 管理员和前端/后端开发人员。

页面入口

系统管理 → 菜单管理(/system/menu)。

字段说明

字段 作用
菜单名称 左侧导航显示的名称
菜单类型 目录、菜单或按钮
显示排序 同级菜单的上下顺序
权限标识 后端接口和按钮权限码,如 bi:sup:dashboard
组件路径 前端页面组件路径
路由地址 浏览器访问路径
显示状态 显示或隐藏
菜单状态 正常或停用

操作步骤

  1. 先用筛选条件定位菜单,展开目录查看子菜单和按钮。
  2. 新增目录时只填写名称、排序、图标和路由;目录不对应具体页面。
  3. 新增菜单时填写路由地址、组件路径和权限标识,并选择上级目录。
  4. 新增按钮时填写权限标识,不填写组件路径;按钮用于控制新增、修改、删除、导出等操作。
  5. 调整顺序后保存,重新登录或刷新路由缓存验证导航顺序。
  6. 隐藏旧菜单时使用“隐藏”而不是直接删除,便于回滚和历史审计。
  7. 生产环境修改前先导出菜单备份,并在测试环境验证角色授权。

输入与输出

输入是菜单树、路由、组件和权限码;输出是动态路由、左侧导航和按钮级权限。

宏澜家电示例

新增“渠道分析”菜单,放在“数据探索中心”下,路由 /bi/superset/dashboard,组件指向 Superset 承载页,权限码 bi:sup:dashboard。同时新增“导出渠道明细”按钮权限,仅授予 BI 分析师。

客户应用演示:调整“数据探索中心”子菜单顺序

业务情境: 客户希望业务人员按“仪表盘 → 数据集 → SQL → AI”顺序使用功能。

第一步:进入“系统管理 → 菜单管理”

第1步重点操作:进入“系统管理 → 菜单管理”

步骤图 46-01 第1步:进入“系统管理 → 菜单管理”。红框标出进入系统管理 → 菜单管理。

进入“系统管理 → 菜单管理”,展开数据探索中心。

第二步:记录当前菜单顺序、路由和权限标识

第2步重点操作:记录当前菜单顺序、路由和权限标识

步骤图 46-02 第2步:记录当前菜单顺序、路由和权限标识。红框标出记录当前菜单顺序、路由和权限标识。

记录当前菜单顺序、路由和权限标识,先做配置备份。

第三步:使用上移/下移或排序值调整四个子菜单

第3步重点操作:使用上移/下移或排序值调整四个子菜单

步骤图 46-03 第3步:使用上移/下移或排序值调整四个子菜单。红框标出使用上移/下移或排序值调整四个子菜单。

使用上移/下移或排序值调整四个子菜单。

第四步:保存后刷新页面

第4步重点操作:保存后刷新页面

步骤图 46-04 第4步:保存后刷新页面。红框标出保存后刷新页面。

保存后刷新页面,确认菜单顺序、图标和链接都正常。

第五步:用业务账号复核可见菜单

第5步重点操作:用业务账号复核可见菜单

步骤图 46-05 第5步:用业务账号复核可见菜单。红框标出用业务账号复核可见菜单。

用业务账号复核可见菜单,确认没有改变功能权限。

最终结果与效果

菜单按业务使用顺序显示,链接和权限保持不变;变更可在操作日志中追溯。

操作提示: 不要修改正在使用的路由和组件路径;菜单变更后应回归所有链接。

常见问题

菜单显示但点击 404。 检查路由地址、组件路径和前端构建是否包含该页面。

页面能打开但按钮全部隐藏。 检查按钮权限码是否与前端 v-hasPermi 一致。

截图里有历史菜单但导航不显示。 菜单表可能保留隐藏的旧目录;以当前左侧导航为准,不要误删仍在使用的权限节点。

开发人员参考

部门管理

功能定位

部门管理维护集团、中心、部门和班组的组织层级,既用于通讯录和用户归属,也作为数据权限范围的基础。组织调整会直接影响“本部门及以下”的数据可见性。

部门管理

图 8-4 组织层级、类别编码、负责人和状态

适用角色

系统管理员、人力资源管理员和经授权的组织管理员。

页面入口

系统管理 → 部门管理(/system/dept)。

页面结构

操作步骤

  1. 先确认上级部门,再点击“新增”创建下级组织。
  2. 填写部门名称、类别编码、显示排序、负责人、联系电话和状态。
  3. 类别编码应与集团组织编码规范一致,例如 GROUP_ROOT、HQ_SUPPORT、FINANCE_CENTER。
  4. 调整组织时优先“移动”而不是删除重建,避免历史用户和权限关系丢失。
  5. 部门停用前确认没有在职用户、未完成流程和有效数据权限。
  6. 组织变革后重新检查角色数据范围、报表组织维度和用户归属。

输入与输出

输入是组织层级、编码、负责人和状态;输出是部门树、用户归属和部门数据范围。

宏澜家电示例

集团下设置集团总部、人力资源中心、财务共享中心、研发中心、供应链中心、营销中心和制造中心。华南销售部挂在营销中心下,部门负责人只能查看本部门及下级区域的销售数据。

客户应用演示:新增华东销售大区部门

业务情境: 组织调整后,需要把新区域纳入用户、数据范围和工作流。

第一步:进入“系统管理 → 部门管理”

第1步重点操作:进入“系统管理 → 部门管理”

步骤图 47-01 第1步:进入“系统管理 → 部门管理”。红框标出进入系统管理 → 部门管理。

进入“系统管理 → 部门管理”,选择上级销售中心。

第二步:点击“新增”

第2步重点操作:点击“新增”

步骤图 47-02 第2步:点击“新增”。红框标出点击新增。

点击“新增”,填写部门名称、编码、负责人和显示顺序。

第三步:保存后检查树形层级

第3步重点操作:保存后检查树形层级

步骤图 47-03 第3步:保存后检查树形层级。红框标出保存后检查树形层级。

保存后检查树形层级,确认新部门位于正确父节点下。

第四步:把相关用户调整到新部门

第4步重点操作:把相关用户调整到新部门

步骤图 47-04 第4步:把相关用户调整到新部门。红框标出把相关用户调整到新部门。

把相关用户调整到新部门,并核对数据范围。

第五步:回到用户管理

第5步重点操作:回到用户管理

步骤图 47-05 第5步:回到用户管理。红框标出回到用户管理。

回到用户管理,用新部门账号验证看板数据。

最终结果与效果

组织树增加华东销售大区,用户、角色和数据权限可以按新部门生效。

操作提示: 部门变更会影响数据范围,调整前先确认历史报表和看板权限。

常见问题

看不到某个部门。 检查上级部门是否被隐藏、当前账号数据范围是否包含该部门。

删除部门失败。 可能存在子部门或用户,先迁移再删除。

组织调整后报表维度没变。 报表使用历史组织快照或数仓维度表,需要同步更新维表并重跑相关模型。

开发人员参考

字典管理

功能定位

字典管理统一维护枚举值和显示标签,例如用户性别、菜单状态、通知类型、操作类型和设备类型。它保证页面下拉框、表格标签和后端校验使用同一套编码。

字典管理

图 8-5 字典类型与字典数据

适用角色

系统管理员、开发人员和业务配置人员。

页面入口

系统管理 → 字典管理(/system/dict)。

页面结构

操作步骤

  1. 先在左侧搜索字典名称或类型,确认是否已有同类字典。
  2. 新增字典类型时填写名称、类型编码和备注;类型编码一经使用不要随意更改。
  3. 在右侧新增字典数据,填写标签、键值、排序、样式和状态。
  4. 键值必须与数据库、接口和历史数据保持一致;修改键值可能导致旧数据无法翻译。
  5. 保存后点击“刷新缓存”,再刷新页面验证下拉框和标签。
  6. 删除字典前检查是否仍被菜单、表单、报表或历史数据引用。

输入与输出

输入是字典类型、标签、键值和排序;输出是统一的下拉选项、状态标签和接口枚举。

宏澜家电示例

“订单状态”字典包含待付款、已付款、已发货、已完成、已取消和已退货。报表按字典标签显示中文,后端仍保存稳定键值;新增“部分退货”状态时先评估历史报表分组。

客户应用演示:维护“销售渠道”字典

业务情境: 业务新增直营、经销、电商和工程渠道,需要在筛选器和表单中统一显示。

第一步:进入“系统管理 → 字典管理”

第1步重点操作:进入“系统管理 → 字典管理”

步骤图 48-01 第1步:进入“系统管理 → 字典管理”。红框标出进入系统管理 → 字典管理。

进入“系统管理 → 字典管理”,搜索“销售渠道”。

第二步:新增字典项

第2步重点操作:新增字典项

步骤图 48-02 第2步:新增字典项。红框标出新增字典项。

新增字典项,填写标签、键值、排序和状态。

第三步:保存后刷新使用该字典的页面

第3步重点操作:保存后刷新使用该字典的页面

步骤图 48-03 第3步:保存后刷新使用该字典的页面。红框标出保存后刷新使用该字典的页面。

保存后刷新使用该字典的页面,检查下拉选项。

第四步:确认历史数据仍能正确映射

第4步重点操作:确认历史数据仍能正确映射

步骤图 48-04 第4步:确认历史数据仍能正确映射。红框标出确认历史数据仍能正确映射。

确认历史数据仍能正确映射,必要时补充兼容值。

第五步:通知相关报表和看板负责人进行显示核对

第5步重点操作:通知相关报表和看板负责人进行显示核对

步骤图 48-05 第5步:通知相关报表和看板负责人进行显示核对。红框标出通知相关报表和看板负责人进行显示核对。

通知相关报表和看板负责人进行显示核对。

最终结果与效果

所有引用该字典的筛选项和表单统一显示新增渠道,键值保持稳定。

操作提示: 不要随意修改历史键值;停用比删除更安全。

常见问题

修改字典后页面仍显示旧值。 点击“刷新缓存”并重新登录;浏览器可能仍缓存旧字典。

删除字典提示被引用。 先查找菜单、表单和报表引用,改用停用。

同一字典出现重复键值。 键值在字典类型内必须唯一,合并前先迁移历史数据。

开发人员参考

参数设置

功能定位

参数设置维护系统运行参数和业务配置,例如初始密码策略、注册开关、OSS 预览开关和企业基本信息。参数变更可能影响全局行为,必须谨慎。

参数设置

图 8-6 系统内置参数与自定义配置

适用角色

超级管理员、系统管理员和运维人员。

页面入口

系统管理 → 参数设置(/system/config)。

参数分类

分类 示例 影响
系统内置 用户初始密码、注册开关、OSS 预览开关 认证、账号和文件访问行为
自定义配置 企业编码、企业全称、简称、英文名、法人、注册资本、成立日期 页面展示、报表抬头和品牌信息

操作步骤

  1. 按参数名称或键名搜索目标参数。
  2. 打开编辑,确认参数键、当前值、备注和影响范围。
  3. 修改后保存,并点击“刷新缓存”使多节点立即生效。
  4. 涉及认证、注册、文件访问或外部地址的参数,先在测试环境验证。
  5. 对关键参数保留变更记录:修改人、时间、原值、新值和回滚方式。
  6. 导出参数清单用于备份,但导出文件不得包含真实密钥或口令。

输入与输出

输入是参数键和值;输出是运行时配置、缓存刷新结果和操作审计。

宏澜家电示例

将企业全称设置为“宏澜家电智造集团股份有限公司”,简称“宏澜集团”,英文名用于登录页和报表抬头。初始密码参数只设置复杂度策略,不在文档中记录真实密码。

客户应用演示:调整报表默认查询时间范围

业务情境: 业务反馈报表默认打开最近 30 天,希望改为最近 90 天。

第一步:进入“系统管理 → 参数设置”

第1步重点操作:进入“系统管理 → 参数设置”

步骤图 49-01 第1步:进入“系统管理 → 参数设置”。红框标出进入系统管理 → 参数设置。

进入“系统管理 → 参数设置”,搜索报表相关参数。

第二步:记录原值、参数键名和影响范围

第2步重点操作:记录原值、参数键名和影响范围

步骤图 49-02 第2步:记录原值、参数键名和影响范围。红框标出记录原值、参数键名和影响范围。

记录原值、参数键名和影响范围,确认不是敏感配置。

第三步:修改参数值并填写变更原因

第3步重点操作:修改参数值并填写变更原因

步骤图 49-03 第3步:修改参数值并填写变更原因。红框标出修改参数值并填写变更原因。

修改参数值并填写变更原因,保存。

第四步:点击刷新缓存

第4步重点操作:点击刷新缓存

步骤图 49-04 第4步:点击刷新缓存。红框标出点击刷新缓存。

点击刷新缓存,重新打开业务报表验证默认范围。

第五步:若结果不符合预期

第5步重点操作:若结果不符合预期

步骤图 49-05 第5步:若结果不符合预期。红框标出若结果不符合预期。

若结果不符合预期,按记录恢复原值。

最终结果与效果

报表默认查询范围更新为 90 天,页面行为和变更记录一致。

操作提示: 不要修改数据库口令、密钥和第三方地址等基础设施参数;变更前先备份原值。

常见问题

修改参数后没有生效。 点击“刷新缓存”,必要时重启相关服务。

参数值显示被脱敏。 截图和页面会对敏感值脱敏;实际值只对授权管理员可见。

误改关键参数。 立即回滚到原值并刷新缓存,再检查登录、注册和文件访问。

开发人员参考

通知公告

功能定位

通知公告用于发布版本上线、维护窗口、培训安排和制度通知。公告可以面向全员或指定范围,并在首页或消息入口展示。

通知公告

图 8-7 公告类型、状态、创建者和发布范围

适用角色

系统管理员、运营人员和行政人员。

页面入口

系统管理 → 通知公告(/system/notice)。

操作步骤

  1. 点击“新增”,填写公告标题、类型、正文、有效期和接收范围。
  2. 选择“公告”或“通知”类型,正文支持富文本、链接和附件。
  3. 保存为草稿后预览,确认排版、链接、时间和接收人。
  4. 发布后检查首页消息和通知列表是否可见。
  5. 过期内容及时下线或修改有效期,避免用户看到失效信息。
  6. 删除公告前确认不再需要审计留痕,重要公告建议停用而不是删除。

输入与输出

输入是标题、类型、正文、有效期和范围;输出是站内公告、消息提醒和阅读记录。

宏澜家电示例

发布“2026 年 11 月经营分析培训”通知,面向集团管理层、部门负责人和 BI 业务用户,附带培训议程和会议链接;培训结束后将公告状态改为过期。

客户应用演示:发布周末系统维护公告

业务情境: 运维计划周六凌晨升级,需要提前通知所有业务用户。

第一步:进入“系统管理 → 通知公告”

第1步重点操作:进入“系统管理 → 通知公告”

步骤图 50-01 第1步:进入“系统管理 → 通知公告”。红框标出进入系统管理 → 通知公告。

进入“系统管理 → 通知公告”,点击“新增”。

第二步:选择公告类型、标题、有效期和接收范围

第2步重点操作:选择公告类型、标题、有效期和接收范围

步骤图 50-02 第2步:选择公告类型、标题、有效期和接收范围。红框标出选择公告类型、标题、有效期和接收范围。

选择公告类型、标题、有效期和接收范围。

第三步:填写维护时间、影响页面、替代操作和联系人

第3步重点操作:填写维护时间、影响页面、替代操作和联系人

步骤图 50-03 第3步:填写维护时间、影响页面、替代操作和联系人。红框标出填写维护时间、影响页面、替代操作和联系人。

填写维护时间、影响页面、替代操作和联系人。

第四步:预览公告内容

第4步重点操作:预览公告内容

步骤图 50-04 第4步:预览公告内容。红框标出预览公告内容。

预览公告内容,确认不包含内部地址和敏感信息。

第五步:发布后用一个普通账号查看首页消息和公告

第5步重点操作:发布后用一个普通账号查看首页消息和公告

步骤图 50-05 第5步:发布后用一个普通账号查看首页消息和公告。红框标出发布后用一个普通账号查看首页消息和公告。

发布后用一个普通账号查看首页消息和公告。

最终结果与效果

目标用户在有效期内看到维护公告,减少维护期间的误报和重复咨询。

操作提示: 公告要写清开始时间、结束时间、影响范围和恢复确认方式。

常见问题

发布后首页看不到。 检查状态、有效期、接收范围和首页公告组件。

公告正文链接打不开。 使用站内相对链接或已登记的帮助地址,避免失效外链。

用户说没有收到。 公告可见性与消息权限不同,检查用户角色和消息订阅。

开发人员参考

操作日志

功能定位

操作日志记录用户在系统中的新增、修改、删除、导出、登录等关键动作,用于安全审计、问题追踪和责任界定。日志正文和客户端信息会脱敏展示。

操作日志

图 8-8 操作日志筛选、详情、导出与清理

适用角色

系统管理员、安全审计人员和运维人员。

页面入口

系统管理 → 日志管理 → 操作日志(/system/log/operlog)。

筛选条件

操作地址、系统模块、操作人员、客户端、设备类型、浏览器、操作系统、操作类型、操作状态和操作时间。

操作步骤

  1. 按时间、操作人员或模块缩小范围,避免一次查询全部日志。
  2. 点击详情查看请求方法、业务参数摘要、返回结果和耗时。
  3. 发现异常操作时记录日志编号、用户、时间、IP 摘要和影响对象。
  4. 需要归档时使用“导出”,导出文件应按敏感级别存放。
  5. “删除”用于清理单条记录,“清空”影响范围更大,必须经过审批并在低峰期执行。
  6. 安全事件排查应同时比对登录日志、在线用户和业务审计。

输入与输出

输入是筛选条件和日志记录;输出是审计明细、导出文件和清理记录。

宏澜家电示例

发现某报表被批量导出,审计人员按操作类型“导出”和时间范围查询,确认操作人属于财务共享中心,导出范围为授权部门;将日志编号和导出用途记录在审计台账。

客户应用演示:追踪一次报表导出操作

业务情境: 需要确认某份费用报表是否被导出、由谁在什么时间导出。

第一步:进入“系统管理 → 操作日志”

第1步重点操作:进入“系统管理 → 操作日志”

步骤图 51-01 第1步:进入“系统管理 → 操作日志”。红框标出进入系统管理 → 操作日志。

进入“系统管理 → 操作日志”,按模块、操作人和时间筛选。

第二步:打开目标记录

第2步重点操作:打开目标记录

步骤图 51-02 第2步:打开目标记录。红框标出打开目标记录。

打开目标记录,查看操作类型、请求路径、结果和来源地址。

第三步:核对业务对象、导出时间和执行结果

第3步重点操作:核对业务对象、导出时间和执行结果

步骤图 51-03 第3步:核对业务对象、导出时间和执行结果。红框标出核对业务对象、导出时间和执行结果。

核对业务对象、导出时间和执行结果。

第四步:如结果异常

第4步重点操作:如结果异常

步骤图 51-04 第4步:如结果异常。红框标出如结果异常。

如结果异常,记录日志编号并联系对应模块管理员。

第五步:按制度处理敏感导出

第5步重点操作:按制度处理敏感导出

步骤图 51-05 第5步:按制度处理敏感导出。红框标出按制度处理敏感导出。

按制度处理敏感导出,不在聊天工具传播日志中的个人信息。

最终结果与效果

能够定位操作人、时间、动作和结果,为安全审计和问题排查提供证据。

操作提示: 日志查询本身也是敏感操作,应按最小权限使用。

常见问题

查不到刚发生的操作。 日志可能异步写入,稍等后刷新;也可能是只读查询未记录。

详情中的参数被脱敏。 这是安全设计,确需排查时由授权管理员在受控环境查看原始审计数据。

清空后无法恢复。 清空是不可逆操作,必须先导出归档并完成审批。

开发人员参考

登录日志

功能定位

登录日志记录账号登录结果、客户端、设备、浏览器、操作系统、登录地点和访问时间,用于发现异常登录、账号锁定和安全事件。

登录日志

图 8-9 登录结果、账号解锁和日志清理

适用角色

系统管理员、安全审计人员和运维人员。

页面入口

系统管理 → 日志管理 → 登录日志(/system/log/logininfo)。

页面结构

操作步骤

  1. 按用户名称或时间范围查询登录记录。
  2. 查看登录状态和描述,区分成功、密码错误、验证码错误和账号锁定。
  3. 发现连续失败时先确认是否为本人操作,再决定是否解锁。
  4. 点击“解锁”前核对账号状态和失败原因,避免为攻击者恢复账号。
  5. 异常登录应结合在线用户、操作日志和业务审计一起分析。
  6. 导出或清理日志按安全制度执行,保留必要的历史审计周期。

输入与输出

输入是登录事件和筛选条件;输出是登录明细、锁定状态、解锁记录和导出文件。

宏澜家电示例

财务账号在短时间内出现多次密码错误,登录日志显示来自不同客户端。安全管理员暂不解锁,先联系用户确认,并检查是否有撞库攻击,再重置密码并要求重新登录。

客户应用演示:排查账号连续登录失败

业务情境: 销售经理解锁后仍无法登录,需要查看登录记录。

第一步:进入“系统管理 → 登录日志”

第1步重点操作:进入“系统管理 → 登录日志”

步骤图 52-01 第1步:进入“系统管理 → 登录日志”。红框标出进入系统管理 → 登录日志。

进入“系统管理 → 登录日志”,按账号和时间筛选。

第二步:查看失败原因、登录地址、浏览器和状态

第2步重点操作:查看失败原因、登录地址、浏览器和状态

步骤图 52-02 第2步:查看失败原因、登录地址、浏览器和状态。红框标出查看失败原因、登录地址、浏览器和状态。

查看失败原因、登录地址、浏览器和状态。

第三步:确认是否为密码错误、验证码过期或账号锁定

第3步重点操作:确认是否为密码错误、验证码过期或账号锁定

步骤图 52-03 第3步:确认是否为密码错误、验证码过期或账号锁定。红框标出确认是否为密码错误、验证码过期或账号锁定。

确认是否为密码错误、验证码过期或账号锁定。

第四步:在允许范围内执行解锁或通知用户重置密码

第4步重点操作:在允许范围内执行解锁或通知用户重置密码

步骤图 52-04 第4步:在允许范围内执行解锁或通知用户重置密码。红框标出在允许范围内执行解锁或通知用户重置密码。

在允许范围内执行解锁或通知用户重置密码。

第五步:让用户重新登录

第5步重点操作:让用户重新登录

步骤图 52-05 第5步:让用户重新登录。红框标出让用户重新登录。

让用户重新登录,并检查后续是否仍有异常尝试。

最终结果与效果

定位登录失败原因并恢复账号访问;登录尝试和处理过程均有记录。

操作提示: 不要向他人透露密码或验证码;异常来源地址应交给安全管理员处理。

常见问题

账号被锁定但日志没有记录。 可能是缓存锁定或认证服务异常,检查 Redis 和认证服务。

登录地点与实际不符。 可能使用代理、VPN 或 IP 库定位偏差,应结合客户端和设备判断。

解锁后仍无法登录。 检查密码、验证码、账号状态和角色权限。

开发人员参考

文件管理

功能定位

文件管理统一管理上传的图片、附件和业务文件,支持上传文件、上传图片、预览、下载、删除和存储配置跳转。头像、公告附件、报表导出等文件都通过统一对象存储能力管理。

文件管理

图 8-10 文件上传、预览开关与存储配置

适用角色

系统管理员、运营人员和开发人员。

页面入口

系统管理 → 文件管理(/system/oss)。

操作步骤

  1. 按文件名、原名、后缀、创建时间或服务商筛选文件。
  2. 点击“上传文件”或“上传图片”,选择文件并等待上传完成。
  3. 检查文件名、原名、后缀、大小、服务商和上传人是否正确。
  4. 需要预览时点击预览;预览开关受系统参数 sys.oss.previewListResource 控制。
  5. 删除前确认文件没有被公告、报表、头像或其他业务引用。
  6. 生产环境建议使用独立对象存储、私有桶和临时签名 URL,不要长期公开文件。

输入与输出

输入是文件、业务类型和存储配置;输出是文件记录、访问地址、预览权限和存储审计。

宏澜家电示例

上传“宏澜集团 2026 年经营分析培训”封面图,存放在业务附件目录,公告引用该文件。培训结束后不直接删除,先确认公告已下线,再按保留周期清理。

客户应用演示:上传公司 Logo 用于报表页眉

业务情境: 财务报表需要统一使用公司 Logo。

第一步:进入“系统管理 → 文件管理”

第1步重点操作:进入“系统管理 → 文件管理”

步骤图 53-01 第1步:进入“系统管理 → 文件管理”。红框标出进入系统管理 → 文件管理。

进入“系统管理 → 文件管理”,选择“上传图片”。

第二步:选择已审核的公司 Logo 文件

第2步重点操作:选择已审核的公司 Logo 文件

步骤图 53-02 第2步:选择已审核的公司 Logo 文件。红框标出选择已审核的公司 Logo 文件。

选择已审核的公司 Logo 文件,确认格式、尺寸和文件大小。

第三步:上传后预览

第3步重点操作:上传后预览

步骤图 53-03 第3步:上传后预览。红框标出上传后预览。

上传后预览,检查透明背景和清晰度。

第四步:复制文件访问地址

第4步重点操作:复制文件访问地址

步骤图 53-04 第4步:复制文件访问地址。红框标出复制文件访问地址。

复制文件访问地址,配置到报表模板页眉。

第五步:打开报表预览

第5步重点操作:打开报表预览

步骤图 53-05 第5步:打开报表预览。红框标出打开报表预览。

打开报表预览,确认打印时 Logo 不变形。

最终结果与效果

Logo 上传成功并可用于报表模板;文件记录包含上传人、大小和访问地址。

操作提示: 不要上传含个人信息或未授权版权素材的图片;对外访问地址应按安全要求配置。

常见问题

上传失败。 检查文件大小、类型、存储服务和网络;浏览器控制台可能显示 413 或 403。

文件记录存在但预览 404。 检查对象存储桶、文件键和访问签名是否过期。

删除后页面图片裂开。 文件仍被业务引用;应先替换引用再删除。

开发人员参考

客户端管理

功能定位

客户端管理维护接入数脉的 OAuth/OIDC 客户端,包括客户端 Key、密钥、授权类型、回调地址、状态和权限范围。它用于第三方系统单点登录或 API 接入。

客户端管理

图 8-11 客户端标识、密钥和授权配置

适用角色

系统管理员、集成开发人员和安全管理员。

页面入口

系统管理 → 客户端管理(/system/client)。

操作步骤

  1. 点击“新增”,填写客户端名称、Key、授权类型、回调地址和权限范围。
  2. 密钥由系统生成或安全注入,页面和日志只显示脱敏值。
  3. 回调地址必须精确匹配,禁止使用任意通配符或未登记域名。
  4. 选择最小权限范围,第三方系统不应获得全量用户和 BI 权限。
  5. 保存后先在测试环境完成授权码或客户端凭证流程,再上线。
  6. 定期轮换密钥;停用客户端前通知接入方并确认没有在线会话。

输入与输出

输入是客户端元数据、密钥、回调和权限范围;输出是接入凭据、授权记录和访问审计。

宏澜家电示例

ERP 门户通过 OIDC 单点登录进入数脉,只申请用户基本信息和“查看已发布大屏”权限。客户端密钥由密钥管理服务注入,回调地址限定为 ERP 门户的固定域名。

客户应用演示:停用不再使用的测试客户端

业务情境: 安全检查发现旧的测试客户端仍可访问接口,需要停用。

第一步:进入“系统管理 → 客户端管理”

第1步重点操作:进入“系统管理 → 客户端管理”

步骤图 54-01 第1步:进入“系统管理 → 客户端管理”。红框标出进入系统管理 → 客户端管理。

进入“系统管理 → 客户端管理”,按名称和时间找到测试客户端。

第二步:查看授权类型、有效期、状态和关联用户

第2步重点操作:查看授权类型、有效期、状态和关联用户

步骤图 54-02 第2步:查看授权类型、有效期、状态和关联用户。红框标出查看授权类型、有效期、状态和关联用户。

查看授权类型、有效期、状态和关联用户。

第三步:确认没有生产任务依赖后

第3步重点操作:确认没有生产任务依赖后

步骤图 54-03 第3步:确认没有生产任务依赖后。红框标出确认没有生产任务依赖后。

确认没有生产任务依赖后,点击“修改”并将状态设为停用。

第四步:保存后验证生产客户端仍可正常访问

第4步重点操作:保存后验证生产客户端仍可正常访问

步骤图 54-04 第4步:保存后验证生产客户端仍可正常访问。红框标出保存后验证生产客户端仍可正常访问。

保存后验证生产客户端仍可正常访问。

第五步:在操作日志中记录变更原因和审批人

第5步重点操作:在操作日志中记录变更原因和审批人

步骤图 54-05 第5步:在操作日志中记录变更原因和审批人。红框标出在操作日志中记录变更原因和审批人。

在操作日志中记录变更原因和审批人。

最终结果与效果

测试客户端失效,生产调用不受影响;配置变更可追溯。

操作提示: 客户端密钥属于高敏感信息,不截图、不复制到文档或聊天工具。

常见问题

授权回调报 redirect_uri_mismatch。 回调地址必须与登记值完全一致,包括协议、端口和路径。

第三方能登录但看不到数据。 客户端只解决身份认证,数据权限仍由数脉角色和数据范围决定。

密钥泄露。 立即停用客户端、轮换密钥并检查访问日志。

开发人员参考