系统管理
数脉平台用户手册 V2.0 · 系统管理
用户管理
功能定位
用户管理维护平台账号、所属部门、岗位、角色、状态和登录信息。它是“谁能进入系统”的第一道边界,也是审计和权限排查的起点。
图 8-1 部门树、用户筛选和用户列表
适用角色
超级管理员、系统管理员和经授权的部门管理员。
页面入口
系统管理 → 用户管理(/system/user)。
页面结构
- 左侧“部门结构”按集团、中心、部门层级筛选用户。
- 顶部筛选条件支持用户名称、用户昵称、手机号码、状态和创建时间。
- 用户列表显示用户名称、昵称、部门、手机号码、状态、创建时间和操作。
- 工具按钮包括新增、修改、删除、解锁、导入导出和角色分配。
操作步骤
- 在左侧选择部门,或在筛选区输入用户名称/昵称后点击“搜索”。
- 点击“新增”,填写用户名称、昵称、部门、手机号码、邮箱、岗位和角色。
- 设置初始状态和密码策略。初始密码应由管理员安全交付,首次登录后要求修改。
- 在“角色”中按岗位选择最少必要角色,不要直接复制超级管理员。
- 用户离职或转岗时先停用账号、回收角色,再按制度删除或保留审计记录。
- 账号被锁定时使用“解锁”,但应先确认是否因连续输错密码或异常登录导致。
输入与输出
输入是账号资料、部门、岗位、角色和状态;输出是可登录账号、权限集合、部门数据范围和操作审计记录。
宏澜家电示例
新入职的华南区域销售分析师被分配到“销售中心/区域销售部”,授予 BI业务用户 和 BI分析师 角色,只允许查看华南区域数据。离职时先停用账号并移除角色,历史操作日志保留。
客户应用演示:创建华东区域销售经理账号
业务情境: 新员工入职,需要登录平台查看本区域看板和报表。
第一步:进入“系统管理 → 用户管理”
步骤图 44-01 第1步:进入“系统管理 → 用户管理”。红框标出进入系统管理 → 用户管理。
进入“系统管理 → 用户管理”,先确认所属部门已经存在。
第二步:点击“新增”
步骤图 44-02 第2步:点击“新增”。红框标出点击新增。
点击“新增”,填写登录账号、姓名、部门、手机号和初始密码。
第三步:保存后点击“分配角色”
步骤图 44-03 第3步:保存后点击“分配角色”。红框标出保存后点击分配角色。
保存后点击“分配角色”,选择“区域销售经理”角色。
第四步:确认账号状态正常
步骤图 44-04 第4步:确认账号状态正常。红框标出确认账号状态正常。
确认账号状态正常,并设置首次登录修改密码。
第五步:用新账号实际登录
步骤图 44-05 第5步:用新账号实际登录。红框标出用新账号实际登录。
用新账号实际登录,检查菜单、看板数据和报表权限。
最终结果与效果
新账号可以登录,只看到岗位所需菜单和本区域数据;管理员可随时停用或调整角色。
操作提示: 不要共享管理员账号,不要将初始密码通过公开渠道发送。
常见问题
用户能看到菜单但不能导出。 菜单权限和按钮权限是两层控制,需要补充导出权限。
新增用户后无法登录。 检查账号状态、密码、验证码、角色和是否被锁定。
删除用户失败。 该用户可能仍被业务数据引用;优先停用而不是物理删除。
开发人员参考
- 页面:
ui/src/views/system/user/index.vue - 接口:
/system/user、/system/user/{userId}、/system/user/authRole、/system/user/resetPwd - 权限:
system:user:list、system:user:add、system:user:edit、system:user:remove、system:user:export、system:user:import - 用户与部门、角色、岗位为多对多关系;数据范围由角色和部门共同决定。
角色管理
功能定位
角色是权限的集合。数脉不直接给个人堆叠权限,而是按岗位建立角色,再把角色分配给用户。角色同时控制菜单可见性、按钮操作和数据范围。
图 8-2 角色权限字符、显示顺序、状态和用户分配
适用角色
超级管理员、安全管理员和系统管理员。
页面入口
系统管理 → 角色管理(/system/role)。
页面结构
- 筛选条件:角色名称、权限字符、状态和创建时间。
- 角色列表:角色名称、权限字符、显示顺序、状态、创建时间和操作。
- 操作:修改、删除、数据权限、分配用户。
- 当前演示环境可见的角色包括超级管理员、本部门及以下、仅本人、BI 业务用户、BI 分析师、BI 管理员、ETL 管理员、集团管理层、部门负责人和业务运营等。
操作步骤
- 点击“新增”,填写角色名称、权限字符、显示顺序和状态。
- 在“菜单权限”中勾选该角色可访问的目录、菜单和按钮。父目录可见不代表子按钮自动可用。
- 在“数据权限”中选择全部数据、本部门、本部门及以下、仅本人或自定义部门。
- 保存后点击“分配用户”,批量添加或移除成员。
- 修改角色权限前先评估在线用户和关键业务时段,必要时在变更窗口操作。
- 删除角色前确认没有用户绑定,且没有流程、报表或数据权限引用。
输入与输出
输入是角色名称、权限字符、菜单权限和数据范围;输出是角色、权限集合、用户绑定关系和授权审计。
宏澜家电示例
建立“集团管理层”角色:可查看经营大屏、数据探索和智能报表,但不能修改建模字典和系统配置;数据范围为集团全部。建立“部门负责人”角色:只能查看本部门及下级数据,不能导出客户联系方式。
客户应用演示:配置“区域销售经理”角色
业务情境: 多个区域经理需要相同菜单、按钮和数据范围,用角色统一管理。
第一步:进入“系统管理 → 角色管理”
步骤图 45-01 第1步:进入“系统管理 → 角色管理”。红框标出进入系统管理 → 角色管理。
进入“系统管理 → 角色管理”,点击“新增”。
第二步:填写角色名称、权限字符和显示顺序
步骤图 45-02 第2步:填写角色名称、权限字符和显示顺序。红框标出填写角色名称、权限字符和显示顺序。
填写角色名称、权限字符和显示顺序。
第三步:在菜单权限中勾选大屏展示、仪表盘、业务报表、AI 对话分析
步骤图 45-03 第3步:在菜单权限中勾选大屏展示、仪表盘、业务报表、AI 对话分析。红框标出在菜单权限中勾选大屏展示、仪表盘、业务报表、AI 对话分析。
在菜单权限中勾选大屏展示、仪表盘、业务报表、AI 对话分析。
第四步:设置数据范围为本人或本部门
步骤图 45-04 第4步:设置数据范围为本人或本部门。红框标出设置数据范围为本人或本部门。
设置数据范围为本人或本部门,保存后分配用户。
第五步:用一个测试账号验证菜单可见性和越权限制
步骤图 45-05 第5步:用一个测试账号验证菜单可见性和越权限制。红框标出用一个测试账号验证菜单可见性和越权限制。
用一个测试账号验证菜单可见性和越权限制。
最终结果与效果
同岗位用户共享一套权限,新增人员只需分配角色,避免逐个账号配置。
操作提示: 角色权限应最小化;高风险按钮和导出权限单独评估。
常见问题
用户拥有角色仍看不到菜单。 检查菜单权限是否勾选、菜单是否隐藏、角色是否启用、用户是否重新登录。
同名权限字符冲突。 权限字符必须唯一,建议使用小写英文和下划线。
角色删除后用户无法登录。 删除角色前先迁移用户,避免账号失去必要的基础权限。
开发人员参考
- 接口:
/system/role、/system/role/{roleId}、/system/role/dataScope、/system/role/authUser - 权限:
system:role:list、system:role:add、system:role:edit、system:role:remove、system:role:export - 角色权限变更后应清理相关用户会话或提示重新登录,防止旧菜单缓存继续生效。
菜单管理
功能定位
菜单管理维护目录、菜单和按钮三级结构,决定左侧导航、页面路由、组件路径和权限标识。它是系统功能入口的“总开关”,修改会影响所有角色。
图 8-3 目录、菜单与按钮的树形维护
适用角色
系统管理员、BI 管理员和前端/后端开发人员。
页面入口
系统管理 → 菜单管理(/system/menu)。
字段说明
| 字段 | 作用 |
|---|---|
| 菜单名称 | 左侧导航显示的名称 |
| 菜单类型 | 目录、菜单或按钮 |
| 显示排序 | 同级菜单的上下顺序 |
| 权限标识 | 后端接口和按钮权限码,如 bi:sup:dashboard |
| 组件路径 | 前端页面组件路径 |
| 路由地址 | 浏览器访问路径 |
| 显示状态 | 显示或隐藏 |
| 菜单状态 | 正常或停用 |
操作步骤
- 先用筛选条件定位菜单,展开目录查看子菜单和按钮。
- 新增目录时只填写名称、排序、图标和路由;目录不对应具体页面。
- 新增菜单时填写路由地址、组件路径和权限标识,并选择上级目录。
- 新增按钮时填写权限标识,不填写组件路径;按钮用于控制新增、修改、删除、导出等操作。
- 调整顺序后保存,重新登录或刷新路由缓存验证导航顺序。
- 隐藏旧菜单时使用“隐藏”而不是直接删除,便于回滚和历史审计。
- 生产环境修改前先导出菜单备份,并在测试环境验证角色授权。
输入与输出
输入是菜单树、路由、组件和权限码;输出是动态路由、左侧导航和按钮级权限。
宏澜家电示例
新增“渠道分析”菜单,放在“数据探索中心”下,路由 /bi/superset/dashboard,组件指向 Superset 承载页,权限码 bi:sup:dashboard。同时新增“导出渠道明细”按钮权限,仅授予 BI 分析师。
客户应用演示:调整“数据探索中心”子菜单顺序
业务情境: 客户希望业务人员按“仪表盘 → 数据集 → SQL → AI”顺序使用功能。
第一步:进入“系统管理 → 菜单管理”
步骤图 46-01 第1步:进入“系统管理 → 菜单管理”。红框标出进入系统管理 → 菜单管理。
进入“系统管理 → 菜单管理”,展开数据探索中心。
第二步:记录当前菜单顺序、路由和权限标识
步骤图 46-02 第2步:记录当前菜单顺序、路由和权限标识。红框标出记录当前菜单顺序、路由和权限标识。
记录当前菜单顺序、路由和权限标识,先做配置备份。
第三步:使用上移/下移或排序值调整四个子菜单
步骤图 46-03 第3步:使用上移/下移或排序值调整四个子菜单。红框标出使用上移/下移或排序值调整四个子菜单。
使用上移/下移或排序值调整四个子菜单。
第四步:保存后刷新页面
步骤图 46-04 第4步:保存后刷新页面。红框标出保存后刷新页面。
保存后刷新页面,确认菜单顺序、图标和链接都正常。
第五步:用业务账号复核可见菜单
步骤图 46-05 第5步:用业务账号复核可见菜单。红框标出用业务账号复核可见菜单。
用业务账号复核可见菜单,确认没有改变功能权限。
最终结果与效果
菜单按业务使用顺序显示,链接和权限保持不变;变更可在操作日志中追溯。
操作提示: 不要修改正在使用的路由和组件路径;菜单变更后应回归所有链接。
常见问题
菜单显示但点击 404。 检查路由地址、组件路径和前端构建是否包含该页面。
页面能打开但按钮全部隐藏。 检查按钮权限码是否与前端 v-hasPermi 一致。
截图里有历史菜单但导航不显示。 菜单表可能保留隐藏的旧目录;以当前左侧导航为准,不要误删仍在使用的权限节点。
开发人员参考
部门管理
功能定位
部门管理维护集团、中心、部门和班组的组织层级,既用于通讯录和用户归属,也作为数据权限范围的基础。组织调整会直接影响“本部门及以下”的数据可见性。
图 8-4 组织层级、类别编码、负责人和状态
适用角色
系统管理员、人力资源管理员和经授权的组织管理员。
页面入口
系统管理 → 部门管理(/system/dept)。
页面结构
- 部门树按上级部门展开,支持展开/折叠。
- 列表显示部门名称、类别编码、排序、状态、创建时间和操作。
- 操作支持新增下级部门、修改和删除。
操作步骤
- 先确认上级部门,再点击“新增”创建下级组织。
- 填写部门名称、类别编码、显示排序、负责人、联系电话和状态。
- 类别编码应与集团组织编码规范一致,例如
GROUP_ROOT、HQ_SUPPORT、FINANCE_CENTER。 - 调整组织时优先“移动”而不是删除重建,避免历史用户和权限关系丢失。
- 部门停用前确认没有在职用户、未完成流程和有效数据权限。
- 组织变革后重新检查角色数据范围、报表组织维度和用户归属。
输入与输出
输入是组织层级、编码、负责人和状态;输出是部门树、用户归属和部门数据范围。
宏澜家电示例
集团下设置集团总部、人力资源中心、财务共享中心、研发中心、供应链中心、营销中心和制造中心。华南销售部挂在营销中心下,部门负责人只能查看本部门及下级区域的销售数据。
客户应用演示:新增华东销售大区部门
业务情境: 组织调整后,需要把新区域纳入用户、数据范围和工作流。
第一步:进入“系统管理 → 部门管理”
步骤图 47-01 第1步:进入“系统管理 → 部门管理”。红框标出进入系统管理 → 部门管理。
进入“系统管理 → 部门管理”,选择上级销售中心。
第二步:点击“新增”
步骤图 47-02 第2步:点击“新增”。红框标出点击新增。
点击“新增”,填写部门名称、编码、负责人和显示顺序。
第三步:保存后检查树形层级
步骤图 47-03 第3步:保存后检查树形层级。红框标出保存后检查树形层级。
保存后检查树形层级,确认新部门位于正确父节点下。
第四步:把相关用户调整到新部门
步骤图 47-04 第4步:把相关用户调整到新部门。红框标出把相关用户调整到新部门。
把相关用户调整到新部门,并核对数据范围。
第五步:回到用户管理
步骤图 47-05 第5步:回到用户管理。红框标出回到用户管理。
回到用户管理,用新部门账号验证看板数据。
最终结果与效果
组织树增加华东销售大区,用户、角色和数据权限可以按新部门生效。
操作提示: 部门变更会影响数据范围,调整前先确认历史报表和看板权限。
常见问题
看不到某个部门。 检查上级部门是否被隐藏、当前账号数据范围是否包含该部门。
删除部门失败。 可能存在子部门或用户,先迁移再删除。
组织调整后报表维度没变。 报表使用历史组织快照或数仓维度表,需要同步更新维表并重跑相关模型。
开发人员参考
- 接口:
/system/dept、/system/dept/{deptId}、/system/dept/treeselect - 权限:
system:dept:list、system:dept:add、system:dept:edit、system:dept:remove - 部门使用
ancestors维护祖级路径,移动节点时必须同步更新所有子孙路径。 - 数据权限使用部门 ID 集合,组织移动后应重新计算授权范围。
字典管理
功能定位
字典管理统一维护枚举值和显示标签,例如用户性别、菜单状态、通知类型、操作类型和设备类型。它保证页面下拉框、表格标签和后端校验使用同一套编码。
图 8-5 字典类型与字典数据
适用角色
系统管理员、开发人员和业务配置人员。
页面入口
系统管理 → 字典管理(/system/dict)。
页面结构
- 左侧为字典类型:字典名称、字典类型、备注和操作。
- 右侧为字典数据:字典标签、键值、排序、备注、状态和操作。
- 工具按钮支持新增、修改、删除、导出和刷新缓存。
操作步骤
- 先在左侧搜索字典名称或类型,确认是否已有同类字典。
- 新增字典类型时填写名称、类型编码和备注;类型编码一经使用不要随意更改。
- 在右侧新增字典数据,填写标签、键值、排序、样式和状态。
- 键值必须与数据库、接口和历史数据保持一致;修改键值可能导致旧数据无法翻译。
- 保存后点击“刷新缓存”,再刷新页面验证下拉框和标签。
- 删除字典前检查是否仍被菜单、表单、报表或历史数据引用。
输入与输出
输入是字典类型、标签、键值和排序;输出是统一的下拉选项、状态标签和接口枚举。
宏澜家电示例
“订单状态”字典包含待付款、已付款、已发货、已完成、已取消和已退货。报表按字典标签显示中文,后端仍保存稳定键值;新增“部分退货”状态时先评估历史报表分组。
客户应用演示:维护“销售渠道”字典
业务情境: 业务新增直营、经销、电商和工程渠道,需要在筛选器和表单中统一显示。
第一步:进入“系统管理 → 字典管理”
步骤图 48-01 第1步:进入“系统管理 → 字典管理”。红框标出进入系统管理 → 字典管理。
进入“系统管理 → 字典管理”,搜索“销售渠道”。
第二步:新增字典项
步骤图 48-02 第2步:新增字典项。红框标出新增字典项。
新增字典项,填写标签、键值、排序和状态。
第三步:保存后刷新使用该字典的页面
步骤图 48-03 第3步:保存后刷新使用该字典的页面。红框标出保存后刷新使用该字典的页面。
保存后刷新使用该字典的页面,检查下拉选项。
第四步:确认历史数据仍能正确映射
步骤图 48-04 第4步:确认历史数据仍能正确映射。红框标出确认历史数据仍能正确映射。
确认历史数据仍能正确映射,必要时补充兼容值。
第五步:通知相关报表和看板负责人进行显示核对
步骤图 48-05 第5步:通知相关报表和看板负责人进行显示核对。红框标出通知相关报表和看板负责人进行显示核对。
通知相关报表和看板负责人进行显示核对。
最终结果与效果
所有引用该字典的筛选项和表单统一显示新增渠道,键值保持稳定。
操作提示: 不要随意修改历史键值;停用比删除更安全。
常见问题
修改字典后页面仍显示旧值。 点击“刷新缓存”并重新登录;浏览器可能仍缓存旧字典。
删除字典提示被引用。 先查找菜单、表单和报表引用,改用停用。
同一字典出现重复键值。 键值在字典类型内必须唯一,合并前先迁移历史数据。
开发人员参考
- 接口:
/system/dict/type、/system/dict/data、/system/dict/type/refreshCache - 权限:
system:dict:list、system:dict:add、system:dict:edit、system:dict:remove、system:dict:export - 字典数据缓存于 Redis;写入后需刷新缓存,避免多节点读到旧值。
- 前后端通过字典类型编码读取,不在页面硬编码中文标签。
参数设置
功能定位
参数设置维护系统运行参数和业务配置,例如初始密码策略、注册开关、OSS 预览开关和企业基本信息。参数变更可能影响全局行为,必须谨慎。
图 8-6 系统内置参数与自定义配置
适用角色
超级管理员、系统管理员和运维人员。
页面入口
系统管理 → 参数设置(/system/config)。
参数分类
| 分类 | 示例 | 影响 |
|---|---|---|
| 系统内置 | 用户初始密码、注册开关、OSS 预览开关 | 认证、账号和文件访问行为 |
| 自定义配置 | 企业编码、企业全称、简称、英文名、法人、注册资本、成立日期 | 页面展示、报表抬头和品牌信息 |
操作步骤
- 按参数名称或键名搜索目标参数。
- 打开编辑,确认参数键、当前值、备注和影响范围。
- 修改后保存,并点击“刷新缓存”使多节点立即生效。
- 涉及认证、注册、文件访问或外部地址的参数,先在测试环境验证。
- 对关键参数保留变更记录:修改人、时间、原值、新值和回滚方式。
- 导出参数清单用于备份,但导出文件不得包含真实密钥或口令。
输入与输出
输入是参数键和值;输出是运行时配置、缓存刷新结果和操作审计。
宏澜家电示例
将企业全称设置为“宏澜家电智造集团股份有限公司”,简称“宏澜集团”,英文名用于登录页和报表抬头。初始密码参数只设置复杂度策略,不在文档中记录真实密码。
客户应用演示:调整报表默认查询时间范围
业务情境: 业务反馈报表默认打开最近 30 天,希望改为最近 90 天。
第一步:进入“系统管理 → 参数设置”
步骤图 49-01 第1步:进入“系统管理 → 参数设置”。红框标出进入系统管理 → 参数设置。
进入“系统管理 → 参数设置”,搜索报表相关参数。
第二步:记录原值、参数键名和影响范围
步骤图 49-02 第2步:记录原值、参数键名和影响范围。红框标出记录原值、参数键名和影响范围。
记录原值、参数键名和影响范围,确认不是敏感配置。
第三步:修改参数值并填写变更原因
步骤图 49-03 第3步:修改参数值并填写变更原因。红框标出修改参数值并填写变更原因。
修改参数值并填写变更原因,保存。
第四步:点击刷新缓存
步骤图 49-04 第4步:点击刷新缓存。红框标出点击刷新缓存。
点击刷新缓存,重新打开业务报表验证默认范围。
第五步:若结果不符合预期
步骤图 49-05 第5步:若结果不符合预期。红框标出若结果不符合预期。
若结果不符合预期,按记录恢复原值。
最终结果与效果
报表默认查询范围更新为 90 天,页面行为和变更记录一致。
操作提示: 不要修改数据库口令、密钥和第三方地址等基础设施参数;变更前先备份原值。
常见问题
修改参数后没有生效。 点击“刷新缓存”,必要时重启相关服务。
参数值显示被脱敏。 截图和页面会对敏感值脱敏;实际值只对授权管理员可见。
误改关键参数。 立即回滚到原值并刷新缓存,再检查登录、注册和文件访问。
开发人员参考
- 接口:
/system/config、/system/config/{configId}、/system/config/refreshCache - 权限:
system:config:list、system:config:add、system:config:edit、system:config:remove、system:config:export - 参数缓存于 Redis;系统内置参数不应随意删除。
- 密钥类配置应使用环境变量或密钥管理,不应存入普通参数表。
通知公告
功能定位
通知公告用于发布版本上线、维护窗口、培训安排和制度通知。公告可以面向全员或指定范围,并在首页或消息入口展示。
图 8-7 公告类型、状态、创建者和发布范围
适用角色
系统管理员、运营人员和行政人员。
页面入口
系统管理 → 通知公告(/system/notice)。
操作步骤
- 点击“新增”,填写公告标题、类型、正文、有效期和接收范围。
- 选择“公告”或“通知”类型,正文支持富文本、链接和附件。
- 保存为草稿后预览,确认排版、链接、时间和接收人。
- 发布后检查首页消息和通知列表是否可见。
- 过期内容及时下线或修改有效期,避免用户看到失效信息。
- 删除公告前确认不再需要审计留痕,重要公告建议停用而不是删除。
输入与输出
输入是标题、类型、正文、有效期和范围;输出是站内公告、消息提醒和阅读记录。
宏澜家电示例
发布“2026 年 11 月经营分析培训”通知,面向集团管理层、部门负责人和 BI 业务用户,附带培训议程和会议链接;培训结束后将公告状态改为过期。
客户应用演示:发布周末系统维护公告
业务情境: 运维计划周六凌晨升级,需要提前通知所有业务用户。
第一步:进入“系统管理 → 通知公告”
步骤图 50-01 第1步:进入“系统管理 → 通知公告”。红框标出进入系统管理 → 通知公告。
进入“系统管理 → 通知公告”,点击“新增”。
第二步:选择公告类型、标题、有效期和接收范围
步骤图 50-02 第2步:选择公告类型、标题、有效期和接收范围。红框标出选择公告类型、标题、有效期和接收范围。
选择公告类型、标题、有效期和接收范围。
第三步:填写维护时间、影响页面、替代操作和联系人
步骤图 50-03 第3步:填写维护时间、影响页面、替代操作和联系人。红框标出填写维护时间、影响页面、替代操作和联系人。
填写维护时间、影响页面、替代操作和联系人。
第四步:预览公告内容
步骤图 50-04 第4步:预览公告内容。红框标出预览公告内容。
预览公告内容,确认不包含内部地址和敏感信息。
第五步:发布后用一个普通账号查看首页消息和公告
步骤图 50-05 第5步:发布后用一个普通账号查看首页消息和公告。红框标出发布后用一个普通账号查看首页消息和公告。
发布后用一个普通账号查看首页消息和公告。
最终结果与效果
目标用户在有效期内看到维护公告,减少维护期间的误报和重复咨询。
操作提示: 公告要写清开始时间、结束时间、影响范围和恢复确认方式。
常见问题
发布后首页看不到。 检查状态、有效期、接收范围和首页公告组件。
公告正文链接打不开。 使用站内相对链接或已登记的帮助地址,避免失效外链。
用户说没有收到。 公告可见性与消息权限不同,检查用户角色和消息订阅。
开发人员参考
- 接口:
/system/notice、/system/notice/{noticeId} - 权限:
system:notice:list、system:notice:add、system:notice:edit、system:notice:remove - 正文应做 XSS 过滤;外链需要域名白名单或明确提示。
- 公告阅读状态与用户、公告 ID 关联,删除公告会影响历史阅读记录。
操作日志
功能定位
操作日志记录用户在系统中的新增、修改、删除、导出、登录等关键动作,用于安全审计、问题追踪和责任界定。日志正文和客户端信息会脱敏展示。
图 8-8 操作日志筛选、详情、导出与清理
适用角色
系统管理员、安全审计人员和运维人员。
页面入口
系统管理 → 日志管理 → 操作日志(/system/log/operlog)。
筛选条件
操作地址、系统模块、操作人员、客户端、设备类型、浏览器、操作系统、操作类型、操作状态和操作时间。
操作步骤
- 按时间、操作人员或模块缩小范围,避免一次查询全部日志。
- 点击详情查看请求方法、业务参数摘要、返回结果和耗时。
- 发现异常操作时记录日志编号、用户、时间、IP 摘要和影响对象。
- 需要归档时使用“导出”,导出文件应按敏感级别存放。
- “删除”用于清理单条记录,“清空”影响范围更大,必须经过审批并在低峰期执行。
- 安全事件排查应同时比对登录日志、在线用户和业务审计。
输入与输出
输入是筛选条件和日志记录;输出是审计明细、导出文件和清理记录。
宏澜家电示例
发现某报表被批量导出,审计人员按操作类型“导出”和时间范围查询,确认操作人属于财务共享中心,导出范围为授权部门;将日志编号和导出用途记录在审计台账。
客户应用演示:追踪一次报表导出操作
业务情境: 需要确认某份费用报表是否被导出、由谁在什么时间导出。
第一步:进入“系统管理 → 操作日志”
步骤图 51-01 第1步:进入“系统管理 → 操作日志”。红框标出进入系统管理 → 操作日志。
进入“系统管理 → 操作日志”,按模块、操作人和时间筛选。
第二步:打开目标记录
步骤图 51-02 第2步:打开目标记录。红框标出打开目标记录。
打开目标记录,查看操作类型、请求路径、结果和来源地址。
第三步:核对业务对象、导出时间和执行结果
步骤图 51-03 第3步:核对业务对象、导出时间和执行结果。红框标出核对业务对象、导出时间和执行结果。
核对业务对象、导出时间和执行结果。
第四步:如结果异常
步骤图 51-04 第4步:如结果异常。红框标出如结果异常。
如结果异常,记录日志编号并联系对应模块管理员。
第五步:按制度处理敏感导出
步骤图 51-05 第5步:按制度处理敏感导出。红框标出按制度处理敏感导出。
按制度处理敏感导出,不在聊天工具传播日志中的个人信息。
最终结果与效果
能够定位操作人、时间、动作和结果,为安全审计和问题排查提供证据。
操作提示: 日志查询本身也是敏感操作,应按最小权限使用。
常见问题
查不到刚发生的操作。 日志可能异步写入,稍等后刷新;也可能是只读查询未记录。
详情中的参数被脱敏。 这是安全设计,确需排查时由授权管理员在受控环境查看原始审计数据。
清空后无法恢复。 清空是不可逆操作,必须先导出归档并完成审批。
开发人员参考
- 接口:
/monitor/operlog、/monitor/operlog/{operlogId}、/monitor/operlog/export - 权限:
monitor:operlog:list、monitor:operlog:query、monitor:operlog:remove、monitor:operlog:export - 通过注解或切面记录模块、操作类型、方法、参数摘要、结果和耗时。
- 参数和返回体需脱敏,禁止记录密码、Token、Cookie 和完整个人联系方式。
登录日志
功能定位
登录日志记录账号登录结果、客户端、设备、浏览器、操作系统、登录地点和访问时间,用于发现异常登录、账号锁定和安全事件。
图 8-9 登录结果、账号解锁和日志清理
适用角色
系统管理员、安全审计人员和运维人员。
页面入口
系统管理 → 日志管理 → 登录日志(/system/log/logininfo)。
页面结构
- 筛选条件:登录地址、用户名称、状态和登录时间。
- 列表字段:访问编号、用户名称、客户端、设备类型、地址、登录地点、操作系统、浏览器、登录状态、描述和访问时间。
- 操作:删除、清空、解锁、导出。
操作步骤
- 按用户名称或时间范围查询登录记录。
- 查看登录状态和描述,区分成功、密码错误、验证码错误和账号锁定。
- 发现连续失败时先确认是否为本人操作,再决定是否解锁。
- 点击“解锁”前核对账号状态和失败原因,避免为攻击者恢复账号。
- 异常登录应结合在线用户、操作日志和业务审计一起分析。
- 导出或清理日志按安全制度执行,保留必要的历史审计周期。
输入与输出
输入是登录事件和筛选条件;输出是登录明细、锁定状态、解锁记录和导出文件。
宏澜家电示例
财务账号在短时间内出现多次密码错误,登录日志显示来自不同客户端。安全管理员暂不解锁,先联系用户确认,并检查是否有撞库攻击,再重置密码并要求重新登录。
客户应用演示:排查账号连续登录失败
业务情境: 销售经理解锁后仍无法登录,需要查看登录记录。
第一步:进入“系统管理 → 登录日志”
步骤图 52-01 第1步:进入“系统管理 → 登录日志”。红框标出进入系统管理 → 登录日志。
进入“系统管理 → 登录日志”,按账号和时间筛选。
第二步:查看失败原因、登录地址、浏览器和状态
步骤图 52-02 第2步:查看失败原因、登录地址、浏览器和状态。红框标出查看失败原因、登录地址、浏览器和状态。
查看失败原因、登录地址、浏览器和状态。
第三步:确认是否为密码错误、验证码过期或账号锁定
步骤图 52-03 第3步:确认是否为密码错误、验证码过期或账号锁定。红框标出确认是否为密码错误、验证码过期或账号锁定。
确认是否为密码错误、验证码过期或账号锁定。
第四步:在允许范围内执行解锁或通知用户重置密码
步骤图 52-04 第4步:在允许范围内执行解锁或通知用户重置密码。红框标出在允许范围内执行解锁或通知用户重置密码。
在允许范围内执行解锁或通知用户重置密码。
第五步:让用户重新登录
步骤图 52-05 第5步:让用户重新登录。红框标出让用户重新登录。
让用户重新登录,并检查后续是否仍有异常尝试。
最终结果与效果
定位登录失败原因并恢复账号访问;登录尝试和处理过程均有记录。
操作提示: 不要向他人透露密码或验证码;异常来源地址应交给安全管理员处理。
常见问题
账号被锁定但日志没有记录。 可能是缓存锁定或认证服务异常,检查 Redis 和认证服务。
登录地点与实际不符。 可能使用代理、VPN 或 IP 库定位偏差,应结合客户端和设备判断。
解锁后仍无法登录。 检查密码、验证码、账号状态和角色权限。
开发人员参考
- 接口:
/monitor/logininfo、/monitor/logininfo/{infoId}、/monitor/logininfo/unlock、/monitor/logininfo/export - 权限:
monitor:logininfo:list、monitor:logininfo:query、monitor:logininfo:remove、monitor:logininfo:export - 登录失败计数和锁定状态存储于 Redis;解锁需同步清理计数键。
- IP、客户端和位置信息应脱敏展示,原文只对安全审计角色开放。
文件管理
功能定位
文件管理统一管理上传的图片、附件和业务文件,支持上传文件、上传图片、预览、下载、删除和存储配置跳转。头像、公告附件、报表导出等文件都通过统一对象存储能力管理。
图 8-10 文件上传、预览开关与存储配置
适用角色
系统管理员、运营人员和开发人员。
页面入口
系统管理 → 文件管理(/system/oss)。
操作步骤
- 按文件名、原名、后缀、创建时间或服务商筛选文件。
- 点击“上传文件”或“上传图片”,选择文件并等待上传完成。
- 检查文件名、原名、后缀、大小、服务商和上传人是否正确。
- 需要预览时点击预览;预览开关受系统参数
sys.oss.previewListResource控制。 - 删除前确认文件没有被公告、报表、头像或其他业务引用。
- 生产环境建议使用独立对象存储、私有桶和临时签名 URL,不要长期公开文件。
输入与输出
输入是文件、业务类型和存储配置;输出是文件记录、访问地址、预览权限和存储审计。
宏澜家电示例
上传“宏澜集团 2026 年经营分析培训”封面图,存放在业务附件目录,公告引用该文件。培训结束后不直接删除,先确认公告已下线,再按保留周期清理。
客户应用演示:上传公司 Logo 用于报表页眉
业务情境: 财务报表需要统一使用公司 Logo。
第一步:进入“系统管理 → 文件管理”
步骤图 53-01 第1步:进入“系统管理 → 文件管理”。红框标出进入系统管理 → 文件管理。
进入“系统管理 → 文件管理”,选择“上传图片”。
第二步:选择已审核的公司 Logo 文件
步骤图 53-02 第2步:选择已审核的公司 Logo 文件。红框标出选择已审核的公司 Logo 文件。
选择已审核的公司 Logo 文件,确认格式、尺寸和文件大小。
第三步:上传后预览
步骤图 53-03 第3步:上传后预览。红框标出上传后预览。
上传后预览,检查透明背景和清晰度。
第四步:复制文件访问地址
步骤图 53-04 第4步:复制文件访问地址。红框标出复制文件访问地址。
复制文件访问地址,配置到报表模板页眉。
第五步:打开报表预览
步骤图 53-05 第5步:打开报表预览。红框标出打开报表预览。
打开报表预览,确认打印时 Logo 不变形。
最终结果与效果
Logo 上传成功并可用于报表模板;文件记录包含上传人、大小和访问地址。
操作提示: 不要上传含个人信息或未授权版权素材的图片;对外访问地址应按安全要求配置。
常见问题
上传失败。 检查文件大小、类型、存储服务和网络;浏览器控制台可能显示 413 或 403。
文件记录存在但预览 404。 检查对象存储桶、文件键和访问签名是否过期。
删除后页面图片裂开。 文件仍被业务引用;应先替换引用再删除。
开发人员参考
- 接口:
/system/oss、/system/oss/upload、/system/oss/{ossId} - 权限:
system:oss:list、system:oss:upload、system:oss:remove、system:oss:config - 上传需校验扩展名、MIME、大小和病毒扫描;下载使用短时签名。
- 文件元数据存数据库,文件本体存对象存储;本地头像服务仅用于演示。
客户端管理
功能定位
客户端管理维护接入数脉的 OAuth/OIDC 客户端,包括客户端 Key、密钥、授权类型、回调地址、状态和权限范围。它用于第三方系统单点登录或 API 接入。
图 8-11 客户端标识、密钥和授权配置
适用角色
系统管理员、集成开发人员和安全管理员。
页面入口
系统管理 → 客户端管理(/system/client)。
操作步骤
- 点击“新增”,填写客户端名称、Key、授权类型、回调地址和权限范围。
- 密钥由系统生成或安全注入,页面和日志只显示脱敏值。
- 回调地址必须精确匹配,禁止使用任意通配符或未登记域名。
- 选择最小权限范围,第三方系统不应获得全量用户和 BI 权限。
- 保存后先在测试环境完成授权码或客户端凭证流程,再上线。
- 定期轮换密钥;停用客户端前通知接入方并确认没有在线会话。
输入与输出
输入是客户端元数据、密钥、回调和权限范围;输出是接入凭据、授权记录和访问审计。
宏澜家电示例
ERP 门户通过 OIDC 单点登录进入数脉,只申请用户基本信息和“查看已发布大屏”权限。客户端密钥由密钥管理服务注入,回调地址限定为 ERP 门户的固定域名。
客户应用演示:停用不再使用的测试客户端
业务情境: 安全检查发现旧的测试客户端仍可访问接口,需要停用。
第一步:进入“系统管理 → 客户端管理”
步骤图 54-01 第1步:进入“系统管理 → 客户端管理”。红框标出进入系统管理 → 客户端管理。
进入“系统管理 → 客户端管理”,按名称和时间找到测试客户端。
第二步:查看授权类型、有效期、状态和关联用户
步骤图 54-02 第2步:查看授权类型、有效期、状态和关联用户。红框标出查看授权类型、有效期、状态和关联用户。
查看授权类型、有效期、状态和关联用户。
第三步:确认没有生产任务依赖后
步骤图 54-03 第3步:确认没有生产任务依赖后。红框标出确认没有生产任务依赖后。
确认没有生产任务依赖后,点击“修改”并将状态设为停用。
第四步:保存后验证生产客户端仍可正常访问
步骤图 54-04 第4步:保存后验证生产客户端仍可正常访问。红框标出保存后验证生产客户端仍可正常访问。
保存后验证生产客户端仍可正常访问。
第五步:在操作日志中记录变更原因和审批人
步骤图 54-05 第5步:在操作日志中记录变更原因和审批人。红框标出在操作日志中记录变更原因和审批人。
在操作日志中记录变更原因和审批人。
最终结果与效果
测试客户端失效,生产调用不受影响;配置变更可追溯。
操作提示: 客户端密钥属于高敏感信息,不截图、不复制到文档或聊天工具。
常见问题
授权回调报 redirect_uri_mismatch。 回调地址必须与登记值完全一致,包括协议、端口和路径。
第三方能登录但看不到数据。 客户端只解决身份认证,数据权限仍由数脉角色和数据范围决定。
密钥泄露。 立即停用客户端、轮换密钥并检查访问日志。
开发人员参考
- 接口:
/system/client、/system/client/{clientId} - 权限:
system:client:list、system:client:add、system:client:edit、system:client:remove、system:client:export - 客户端密钥使用加密存储,接口不回显明文。
- 授权服务器应校验 PKCE、回调白名单、Token 有效期和作用域。