数脉平台用户手册 V2.0 数脉平台 DataPulse 用户手册 V2.0，覆盖产品总体介绍、八个一级菜单、各功能模块的分步应用示例、开发与运维说明以及常见问题。适用产品版本：当前演示与部署版本。 文档信息 数脉平台用户手册 V2.0 · 文档信息 封面与文档信息 图 0-1　从业务问题到经营洞察，数脉平台把接数、治数、建模、分析、智能问答连成一条价值链 产品名称： 数脉平台（DataPulse） 产品定位： 企业级一站式数据智能平台 品牌口号： 汇数 · 治数 · 析数 · 智数 运营主体： 上海山奇信息技术有限公司 文档版本： V2.0 发布日期： 2026-11-06 适用对象： 业务用户、管理人员、BI 分析师、建模人员、数据管理员、系统管理员与实施人员 演示数据声明： 本手册中的“宏澜家电智造集团”为模拟企业，人物、组织、客户、供应商、订单、财务和经营数据均为演示用途，不对应任何真实企业或个人信息。 文档说明 本手册面向实际使用场景编写。每个功能页均包含：功能解决的问题、适用角色、进入方式、前置条件、宏澜家电分步示例、最终结果与效果、使用提示和常见问题。阅读后应能独立完成从登录、看数、问数、建模、治理到系统管理的日常操作。 怎样使用本手册 三种阅读路径 您的角色 建议阅读顺序 目标 第一次接触产品的客户 产品总体介绍 → 数据价值链 → 登录与首页 → 五条典型场景 10 分钟建立整体认识 日常业务用户 首页 → 数据大屏中心 → 数据探索中心 → 智能报表中心 → AI 对话分析 快速找到并使用已发布的数据资产 建设与管理人员 业务建模中心 → 数据治理中心 → 系统管理 → 系统监控 → 附录 完成数据接入、建模、发布和运行管理 图 0-2　八个一级菜单可按“业务消费、数据建设、平台支撑”三类理解 页面中的固定标记 进入方式：告诉您从哪个菜单进入，部分页面同时给出浏览器路径。 开始前准备：说明账号权限、数据状态或上游资产是否已就绪。 操作示例：以宏澜家电的真实业务语言给出连续步骤，每一步都说明应看到什么。 最终结果与效果：说明完成操作后会得到什么，以及业务上有什么价值。 常见问题：给出最常见的失败原因与处理方法。 阅读提示： 如果页面上的按钮比本手册少，通常是角色权限不同；如果页面上的数字与截图不同，是演示数据已经更新。两种情况都不代表系统异常。 截图与术语约定 截图为当前演示环境的实际界面，已对登录信息、日志、连接配置等敏感内容进行遮挡。文中“看板”指仪表盘式分析页面，“大屏”指用于展厅或会议投屏的可视化页面，“报表”指版式固定的表格或打印文档，“数据集”指可被图表和 AI 复用的受控数据视图。 开始使用 数脉平台用户手册 V2.0 · 开始使用 产品总体介绍 数脉平台是什么 数脉平台（DataPulse）是面向企业经营管理的一站式数据智能平台。它把 ERP、MES、CRM、WMS、财务、人力等业务系统中的数据接入统一数据底座，经过质量校验、元数据与血缘治理、业务语义建模后，形成可信、可解释、可复用的数据资产；业务用户再通过大屏、看板、报表、SQL 和自然语言对话获得洞察。 图 1-1　统一门户、五个业务中心与数据平台的协同关系 客户最常解决的五类问题 数据分散：销售、库存、财务各看一张表，口径不一致。 取数慢：业务临时问题依赖数据人员手工写 SQL，等待时间长。 报表重复开发：同一指标在多个报表中反复计算，修改困难。 数据不可信：不知道数据从哪来、经过哪些加工、是否通过质量校验。 分析门槛高：业务人员会提问题，但不会建模型、写查询或设计图表。 平台带来的业务价值 价值 对客户的意义 平台支撑 看得全 管理层从集团、区域、产品、客户多个视角掌握经营 数据大屏、仪表盘、经营看板 问得到 业务人员用自然语言直接追问数据 AI 对话分析、受控数据集 说得清 指标有定义、数据有来源、变更可追溯 业务字典、数据血缘、版本审计 管得住 数据接入、查询、导出和发布均在权限边界内 角色权限、只读账号、审核发布 做得快 复用模型、数据集和模板，减少重复开发 模型设计、数据集、报表模板、AI 助手 产品边界 数脉平台不是替代 ERP 的交易系统，也不替客户作经营决策。它负责把业务系统中的数据安全地汇聚、治理、建模和呈现；AI 提供分析与草稿建议，最终判断仍需业务人员复核。 一条完整的数据价值链 数脉平台把企业数据工作拆成五段连续能力：接数 → 治数 → 建数 → 析数 → 智数。客户可以按模块逐步建设，也可以先使用已接好的数据和已发布的看板。 图 2-1　五个环节的输入、处理与业务产出 五段能力说明 环节 要解决的问题 主要页面 看得见的结果 接数 数据如何从 ERP、Excel、接口进入平台 数据同步、外部数据源、数据加工 同步批次、ODS 数据、运行记录 治数 数据是否完整、准确、可追溯 数据质量、元数据管理、ETL 调度 质量结果、字段目录、血缘关系、调度实例 建数 指标、维度、模型如何统一 建模项目、业务字典、模型设计、发布中心 业务语义、模型版本、发布记录 析数 业务人员如何看数和追问 仪表盘、SQL、数据集、智能报表、大屏 看板、查询结果、固定报表、经营大屏 智数 如何降低分析和开发门槛 AI 对话分析、AI 建模助手、AI 数据助手 多图表看板草稿、模型草稿、链路草稿 宏澜家电的连续示例 从 ERP 同步销售订单、客户、产品、库存和财务数据。 检查订单号唯一、金额非负、日期合法和客户引用完整。 统一“销售收入、毛利额、毛利率、库存周转天数”等指标口径。 构建销售订单事实模型以及产品、客户、组织、日期维度模型。 发布销售、财务、库存等数据集，制作管理看板与经营大屏。 业务人员用自然语言追问“最近 6 个月哪些区域毛利下降”，AI 生成多图表看板方案，人工确认后使用。 实施建议： 不要一开始就建设全部主题。先选择一个业务价值明确、数据质量较好的主题，例如“销售经营”，完成端到端闭环后再复制到财务、库存和生产。 角色与权限 为什么需要角色 平台同时服务管理层、业务人员、分析师、建模人员、数据管理员和系统管理员。不同角色看到的菜单、按钮、数据范围和 AI 能力不同，目的是让“该看的人看得到，该改的人才能改”。 图 3-1　按职责划分的典型角色与访问边界 六类典型角色 角色 日常任务 典型菜单 关键限制 集团管理层 看经营、看趋势、看异常 首页、大屏展示、仪表盘 以只读为主，不修改模型 业务用户 查看授权报表、提出分析问题 智能报表、AI 对话分析 只访问授权数据范围 BI 分析师 建看板、查数据、做分析 仪表盘、数据集、SQL 工作台 只读 SQL，不直接改业务库 建模人员 维护字典、模型和业务链路 业务建模中心 提交后需独立审核 数据管理员 接数、加工、调度、质量管理 数据治理中心 凭据不显示明文，操作留痕 系统管理员 用户、角色、菜单、参数与监控 系统管理、系统监控 高风险操作需谨慎并保留审计 看不到菜单或按钮怎么办 看不到菜单通常表示角色没有菜单权限；看得到菜单但不能操作通常表示缺少按钮权限；能打开看板但数据为空还可能是数据范围或行级权限限制。请联系系统管理员，并提供账号、目标菜单、操作时间与提示信息。 安全原则 最小权限：只授予完成工作必需的菜单与数据范围。 职责分离：提交人不能审核自己的建模成果。 只读接入：分析查询使用只读账号，不能修改业务库。 全程留痕：用户、时间、动作、对象和结果均可审计。 登录与首次进入 这个功能解决什么问题 登录用于确认用户身份，并加载该账号被授权的菜单、按钮和数据范围。首次登录后，建议先熟悉首页和左侧导航，再进入具体业务中心。 图 4-1　输入账号、密码和验证码进入统一工作台 开始前准备 已获得平台账号，并确认账号状态正常。 知道平台访问地址，网络可访问服务器。 如启用了验证码，确保页面能正常显示验证码图片。 操作示例：销售经理首次登录 第一步：打开登录页 步骤图 06-01　第1步：打开登录页。红框标出打开登录页。 在浏览器输入平台地址，等待登录页面完整显示。页面左侧展示产品介绍，右侧是登录表单。 第二步：输入账号信息 步骤图 06-02　第2步：输入账号信息。红框标出输入账号信息。 填写企业账号和密码。注意区分大小写，不要在本手册或聊天工具中记录真实密码。 第三步：填写验证码 步骤图 06-03　第3步：填写验证码。红框标出填写验证码。 按图片中的字符填写验证码。如果图片模糊，点击验证码图片刷新后再输入。 第四步：点击登录 步骤图 06-04　第4步：点击登录。红框标出点击登录。 点击“登录”按钮。登录成功后自动进入首页，右上角显示当前用户，左侧显示有权限的一级菜单。 第五步：检查个人入口 步骤图 06-05　第5步：检查个人入口。红框标出检查个人入口。 点击右上角头像，可以进入个人中心，查看个人资料、修改密码、头像和在线设备。 最终结果与效果 页面进入“首页 - 数脉平台”，能看到欢迎语、五个业务中心入口、待办/提醒和全局搜索。后续再次访问时，浏览器会话有效期内可直接进入；会话过期后需要重新登录。 常见问题 验证码没有显示。 先刷新页面并检查网络；若仍为空，联系管理员检查验证码服务或反向代理配置。 提示账号或密码错误。 确认账号未被停用、键盘大小写和输入法状态；连续失败后可能需要等待解锁。 登录后菜单很少。 这是角色权限结果，不是页面缺失；联系管理员按岗位分配菜单权限。 首页工作台 这个功能解决什么问题 首页把“我现在要做什么”放在最前面，按业务任务组织五个中心入口，同时提供全局搜索、消息、刷新、全屏和账号菜单，避免用户在多套工具之间寻找入口。 图 5-1　首页按“看经营、做分析、出报表、建模型、治数据”组织任务 适合谁使用 所有登录用户。不同角色看到的快捷入口和可点击范围可能不同。 操作示例：经营分析例会前准备 第一步：查看首页业务中心 步骤图 07-01　第1步：查看首页业务中心。红框标出查看首页业务中心。 在“业务中心”区域浏览数据大屏中心、数据探索中心、智能报表中心、业务建模中心、数据治理中心。 第二步：进入经营看板 步骤图 07-02　第2步：进入经营看板。红框标出进入经营看板。 点击“数据大屏中心”卡片中的“查看经营态势”，进入已授权的经营大屏。如需固定报表，则点击“智能报表中心”。 第三步：用自然语言追问 步骤图 07-03　第3步：用自然语言追问。红框标出用自然语言追问。 返回首页，点击“用自然语言问数”，进入 AI 对话分析，输入会议前临时关注的问题。 第四步：查看通知 步骤图 07-04　第4步：查看通知。红框标出查看通知。 点击右上角消息图标，确认是否有数据质量告警、审核待办或系统公告。 第五步：固定常用入口 步骤图 07-05　第5步：固定常用入口。红框标出固定常用入口。 通过浏览器书签保存首页地址；不建议直接收藏内嵌的大屏或报表深层地址，以免一次性票据过期后无法打开。 最终结果与效果 会议前可在同一工作台完成“看整体经营 → 追问异常 → 查看正式报表 → 处理待办”，减少切换系统的时间。首页卡片是任务入口，不会修改任何业务数据。 使用提示 左侧菜单可折叠，页面内容区会自动扩展。 右上角“刷新”用于重新加载当前页面，不会刷新数据仓库。 全屏适合投屏演示；退出全屏后返回原页面。 图标和名称以当前部署版本为准，若与截图不同，可先在全局搜索中查找功能名称。 业务用户 10 分钟快速入门 目标 第一次使用时，用最短路径完成“登录 → 看大屏 → 看固定报表 → 用自然语言问数”，并知道遇到问题时去哪里找答案。 图 6-1　业务用户无需写 SQL，也能用自然语言发起分析 操作示例：区域销售负责人查看本月经营 第一步：登录并查看首页 步骤图 08-01　第1步：登录并查看首页。红框标出登录并查看首页。 登录后确认左侧菜单包含“数据大屏中心、数据探索中心、智能报表中心”。如果缺少某个中心，联系管理员补充角色权限。 第二步：打开经营大屏 步骤图 08-02　第2步：打开经营大屏。红框标出打开经营大屏。 进入“数据大屏中心 → 大屏展示”，选择“宏澜经营驾驶舱”。查看本月销售额、毛利额、订单数、库存预警和区域排名。 第三步：查看固定报表 步骤图 08-03　第3步：查看固定报表。红框标出查看固定报表。 进入“智能报表中心 → 业务报表中心”，打开“区域销售月报”，选择本月和所属区域，核对明细、合计和单位。 第四步：提出临时问题 步骤图 08-04　第4步：提出临时问题。红框标出提出临时问题。 进入“数据探索中心 → AI 对话分析”，输入：“对比华东和华南最近 6 个月销售额与毛利率，找出下降最明显的品类。” 第五步：确认 AI 方案 步骤图 08-05　第5步：确认 AI 方案。红框标出确认 AI 方案。 查看 AI 给出的数据范围、指标、维度和图表数量。确认口径无误后点击“确认创建看板”，再点击“打开看板”。 第六步：调整展示 步骤图 08-06　第6步：调整展示。红框标出调整展示。 输入“看板背景改为深蓝色，图表标题字号调大，销售额用青色”。系统解析并应用样式后，人工复核结果。 最终结果与效果 您会得到一个最多包含 5 张图表的分析看板，能够从趋势、品类和区域角度解释销售变化。AI 不会自动发布看板，也不会修改 ERP 数据。 使用边界 AI 适合探索与起草，不适合代替正式财务结算或绩效认定。对外汇报前，应回到固定报表或经审核的数据集核对关键数字。 管理员快速入门 目标 完成一个新用户从“创建账号”到“看到正确菜单、能打开授权看板”的最小配置闭环。 图 7-1　管理员从用户、角色和菜单权限开始配置 操作示例：为区域销售经理开通演示账号 第一步：确认组织 步骤图 09-01　第1步：确认组织。红框标出确认组织。 进入“系统管理 → 部门管理”，确认区域销售部已经存在，并记录部门 ID 或层级。 第二步：创建用户 步骤图 09-02　第2步：创建用户。红框标出创建用户。 进入“系统管理 → 用户管理”，点击“新增”，填写账号、姓名、所属部门、手机号和初始密码，状态设为正常。 第三步：分配角色 步骤图 09-03　第3步：分配角色。红框标出分配角色。 在用户行点击“分配角色”，选择“业务用户”或客户自定义的“区域销售经理”角色。不要直接授予超级管理员。 第四步：检查菜单权限 步骤图 09-04　第4步：检查菜单权限。红框标出检查菜单权限。 进入“系统管理 → 角色管理”，打开对应角色，确认已勾选大屏展示、业务报表中心、AI 对话分析等菜单与按钮权限。 第五步：配置数据范围 步骤图 09-05　第5步：配置数据范围。红框标出配置数据范围。 按客户组织授权数据范围。若使用行级权限，确认该用户只能看到所属区域数据。 第六步：用新账号验证 步骤图 09-06　第6步：用新账号验证。红框标出用新账号验证。 退出管理员账号，用新账号登录，逐项打开目标菜单、看板和报表，确认没有多余菜单且数据范围正确。 最终结果与效果 新用户能够登录并看到与其岗位匹配的菜单、按钮和数据；管理员账号不共享，敏感操作有独立日志可追溯。 管理员上线检查清单 账号使用实名或唯一工号，离职及时停用。 角色按岗位设计，避免为个人单独堆叠权限。 初始密码首次登录后修改。 数据源使用只读账号，密钥通过环境变量或密钥文件注入。 看板、报表、大屏发布前完成授权和抽样核对。 定期检查登录日志、操作日志、在线用户和缓存状态。 典型业务场景 数脉平台用户手册 V2.0 · 典型业务场景 场景一：管理层看经营 业务背景 周一上午 9 点召开集团经营例会。管理层需要先用 5 分钟确认集团销售、毛利、订单、库存和区域达成情况，再针对异常区域追问原因。 图 8-1　从已发布且已授权的大屏进入经营视图 参与角色与前置条件 集团管理层账号，已获得“宏澜经营驾驶舱”的查看权限。 大屏已经发布，数据同步与看板刷新任务已完成。 经营口径已由财务和销售共同确认。 操作步骤 第一步：进入大屏展示 步骤图 10-01　第1步：进入大屏展示。红框标出进入大屏展示。 登录后进入“数据大屏中心 → 大屏展示”，找到“宏澜经营驾驶舱”。卡片上应能看到名称和发布时间。 第二步：确认数据日期 步骤图 10-02　第2步：确认数据日期。红框标出确认数据日期。 打开大屏后先看右上角或底部的数据更新时间。若更新时间不是当天，暂停解读并联系数据管理员。 第三步：查看核心指标 步骤图 10-03　第3步：查看核心指标。红框标出查看核心指标。 依次查看销售收入、毛利额、毛利率、订单数和库存预警。先看同比/环比，再看目标达成率。 第四步：定位异常区域 步骤图 10-04　第4步：定位异常区域。红框标出定位异常区域。 在区域排名中找出销售额或毛利率下降最大的区域，点击区域筛选器联动其他图表。 第五步：进入明细看板 步骤图 10-05　第5步：进入明细看板。红框标出进入明细看板。 从大屏返回“数据探索中心 → 仪表盘看板”，打开对应区域经营看板，查看品类、渠道和客户明细。 第六步：形成会议结论 步骤图 10-06　第6步：形成会议结论。红框标出形成会议结论。 记录“现象、影响、可能原因、待验证动作”。AI 分析只能作为线索，最终结论由业务负责人确认。 最终结果与效果 管理层在会前看到一张统一的经营全景，会议中能快速聚焦异常区域，而不是逐部门索取 Excel。大屏展示的是发布快照，会议期间不会因他人编辑而改变。 成功标准 指标口径、数据日期与责任人明确。 至少能下钻到区域、品类或渠道中的一层。 异常项有对应业务负责人和后续动作。 场景二：业务人员临时问数 业务背景 区域销售经理临时想知道“最近三个月华东区空调品类为什么毛利下降”，但不熟悉 SQL，也不想等待数据团队排期。 图 9-1　复杂问题可由分析师在 SQL 工作台补充验证 操作步骤 第一步：先明确问题 步骤图 11-01　第1步：先明确问题。红框标出先明确问题。 把问题写成“时间范围 + 对象 + 指标 + 对比维度”，例如：“对比华东区 2026 年 8—10 月空调品类的销售额、折扣额、毛利额和毛利率，按渠道拆分。” 第二步：进入 AI 对话分析 步骤图 11-02　第2步：进入 AI 对话分析。红框标出进入 AI 对话分析。 进入“数据探索中心 → AI 对话分析”，在输入框中粘贴问题。问题不超过 500 字。 第三步：检查数据范围 步骤图 11-03　第3步：检查数据范围。红框标出检查数据范围。 确认页面显示的数据范围、模型、可用状态和指标口径。若显示“全量”或范围过大，谨慎提交。 第四步：查看分析步骤 步骤图 11-04　第4步：查看分析步骤。红框标出查看分析步骤。 查看 AI 的取数思路：用了哪些数据集、按什么维度汇总、如何计算毛利率、是否排除取消订单。 第五步：确认并生成看板 步骤图 11-05　第5步：确认并生成看板。红框标出确认并生成看板。 点击“确认创建看板”。生成完成后点击“打开看板”，查看趋势、渠道对比和异常品类。 第六步：人工复核 步骤图 11-06　第6步：人工复核。红框标出人工复核。 用固定报表或 SQL 工作台抽查一个渠道的销售额和毛利额，确认与 AI 结果一致后再用于会议。 最终结果与效果 业务人员从提出问题到看到可交互看板，通常只需数分钟。系统同一看板最多生成 5 张图表，方案只读且需二次确认，不会修改 ERP 数据，也不会自动发布给其他人。 什么时候应转给分析师 当问题涉及复杂窗口函数、跨库关联、明细导出、敏感客户信息或对外正式口径时，应由 BI 分析师在 SQL 工作台验证，并形成受控数据集。 场景三：AI 生成多图表看板并调整样式 业务背景 经营分析会需要一页式销售复盘：既要看趋势，也要看区域、品类和客户排行。传统方式需要分别创建多张图表，再由 AI 对话逐一调整标题与颜色。 图 10-1　同一问题可生成多张图表，并经过二次确认后创建 推荐提问 分析最近 6 个月宏澜家电的销售额、毛利额和订单数， 按月份展示趋势，按区域和品类展示占比， 列出销售额前 10 名客户，并标出同比下降的区域。 操作步骤 第一步：进入 AI 对话分析 步骤图 12-01　第1步：进入 AI 对话分析。红框标出进入 AI 对话分析。 从“数据探索中心 → AI 对话分析”进入。确认右上角显示模型状态“AI 可用”。 第二步：输入业务问题 步骤图 12-02　第2步：输入业务问题。红框标出输入业务问题。 写明时间、对象、指标、维度和期望图表。点击“开始分析”，不要连续重复点击。 第三步：检查分析步骤 步骤图 12-03　第3步：检查分析步骤。红框标出检查分析步骤。 观察“分析步骤”中的工具调用轨迹，确认取数范围和安全边界。系统只读分析，不应出现写库、删除或修改操作。 第四步：检查看板方案 步骤图 12-04　第4步：检查看板方案。红框标出检查看板方案。 在“看板方案”中核对图表数量、类型、字段、指标、筛选条件和单位。一次方案最多包含 5 张图表，且都进入同一看板。 第五步：确认创建 步骤图 12-05　第5步：确认创建。红框标出确认创建。 点击“确认创建看板”。方案约 30 分钟有效且只能消费一次；过期后重新生成，不要重复提交旧方案。 第六步：打开并核对看板 步骤图 12-06　第6步：打开并核对看板。红框标出打开并核对看板。 点击“打开看板”，逐一核对图表标题、坐标轴、单位、排序和筛选器。发现数字异常时先检查口径，不要先改颜色。 第七步：用自然语言调整样式 步骤图 12-07　第7步：用自然语言调整样式。红框标出用自然语言调整样式。 输入“看板背景改为深蓝色，图表使用青蓝色系，图表标题字号改为 18，坐标轴文字改为深灰色”。系统返回已应用的对象和值。 第八步：保存并确认边界 步骤图 12-08　第8步：保存并确认边界。红框标出保存并确认边界。 在数据探索页面保存看板。AI 样式调整只改变展示，不改变底层数据；对外发布仍需按权限和审核流程执行。 最终结果与效果 同一看板内出现趋势、区域占比、品类占比和客户排行等多张图表，整体配色统一。业务人员可以用业务语言调整背景、图表颜色、文字颜色和字号，无需手工修改样式代码。 常见问题 只有方案没有看板。 还需要点击“确认创建看板”，方案阶段不会创建资产。 提示方案过期。 重新提问并生成新方案；旧方案不能复用。 样式指令未生效。 写明对象和值，例如“图表标题字号 18”，并确认当前看板 ID 与权限正确。 场景四：生成并分发固定经营报表 业务背景 财务部每月需要输出格式固定的“集团费用汇总表”，包含部门、科目、预算、实际、差异和差异率，并打印为 PDF 供经营会签。 图 11-1　固定报表集中管理，业务用户从模板入口打开 操作步骤 第一步：确认数据与口径 步骤图 13-01　第1步：确认数据与口径。红框标出确认数据与口径。 财务与数据管理员确认费用科目映射、预算版本、期间范围和组织合并规则。 第二步：进入报表自助设计 步骤图 13-02　第2步：进入报表自助设计。红框标出进入报表自助设计。 报表开发人员进入“智能报表中心 → 报表自助设计”，选择已审核的数据集，新建报表模板。 第三步：设计表格结构 步骤图 13-03　第3步：设计表格结构。红框标出设计表格结构。 设置标题、期间、编制单位、部门、科目、预算数、实际数、差异、差异率和合计行。金额统一单位和保留位数。 第四步：配置查询参数 步骤图 13-04　第4步：配置查询参数。红框标出配置查询参数。 增加期间、部门和费用类型筛选器，设置默认值与合法范围，禁止拼接任意 SQL。 第五步：预览与核对 步骤图 13-05　第5步：预览与核对。红框标出预览与核对。 分别选择“集团合并”和一个部门预览，核对明细合计、空值、长文本、分页和 A4 打印效果。 第六步：发布并登记 步骤图 13-06　第6步：发布并登记。红框标出发布并登记。 保存模板，将报表 ID 登记到业务报表中心白名单，并为财务角色授予查看和导出权限。 第七步：业务用户使用 步骤图 13-07　第7步：业务用户使用。红框标出业务用户使用。 财务人员进入“智能报表中心 → 业务报表中心”，选择期间和范围，查看结果后导出 PDF 或 Excel。 最终结果与效果 业务用户看到版式统一、口径固定的月报，不再每月手工拼接 Excel。报表中心使用一次性免登录票据，不需要再次输入报表工具账号。 分发前检查 数据日期和抽取批次已确认。 合计与明细一致，差异率计算正确。 用户只看到授权组织的数据。 导出文件带有必要的保密标识和页脚。 场景五：从 ERP 到经营看板 业务背景 客户希望每天 02:00 自动从 ERP 抽取销售订单、客户、产品、库存和财务数据，经过清洗、质量校验和汇总后，早上 8:00 前刷新经营看板。 图 12-1　数据同步、加工、质量和看板刷新由调度统一编排 端到端步骤 第一步：登记只读数据源 步骤图 14-01　第1步：登记只读数据源。红框标出登记只读数据源。 在“数据治理中心 → 外部数据源”登记 ERP 数据库，凭据使用环境变量或密钥文件引用，页面不回显明文；测试连接并保存。 第二步：配置同步任务 步骤图 14-02　第2步：配置同步任务。红框标出配置同步任务。 在“数据同步”选择白名单源表与 Doris ODS 目标表，设置全量或增量模式、批次号和重试策略。先手工运行一次，核对行数与主键。 第三步：配置数据加工 步骤图 14-03　第3步：配置数据加工。红框标出配置数据加工。 在“数据加工”按 ODS → DWD → DWS → ADS 配置清洗与汇总，处理取消订单、退货、折扣、币种和日期口径。 第四步：建立质量规则 步骤图 14-04　第4步：建立质量规则。红框标出建立质量规则。 在“数据质量”配置订单号唯一、金额非负、日期合法、客户引用完整等规则；规则审核通过后生效。 第五步：编排调度 步骤图 14-05　第5步：编排调度。红框标出编排调度。 在“ETL 调度中心”建立每日工作流：源表就绪 → 同步 → 清洗 → 汇总 → 质量测试 → 元数据刷新 → 看板数据集刷新。 第六步：发布数据集与看板 步骤图 14-06　第6步：发布数据集与看板。红框标出发布数据集与看板。 模型审核发布后，在数据探索中心确认数据集可查询，刷新仪表盘并核对关键数字与源系统对账结果。 第七步：配置监控与告警 步骤图 14-07　第7步：配置监控与告警。红框标出配置监控与告警。 检查调度失败、质量失败、数据延迟和看板空数据告警，明确值班人和处理时限。 最终结果与效果 每天凌晨自动完成数据抽取与加工，早上业务人员打开看板即可看到最新经营数据。任何异常都能沿批次、任务、字段和血缘定位，不再依赖个人记忆。 当前环境说明 部分治理页面是“入口已实现、集成按环境配置启用”的状态。若页面提示 DISABLED 或服务未连接，表示当前演示环境关闭了该外部服务，并非菜单失效；生产启用由部署管理员配置。 数据大屏中心 数脉平台用户手册 V2.0 · 数据大屏中心 大屏展示 功能定位 大屏展示集中呈现“已发布且当前角色已授权”的数据大屏。业务用户只能看到发布快照，设计中的草稿不会影响正在展示的内容。 图 3-1　仅展示已发布并授权的经营大屏 适用角色 经营管理者、业务负责人、展厅讲解人员和 BI 业务用户。 页面入口 数据大屏中心 → 大屏展示（ /bi/screen/center）。 前置条件 大屏已在大屏设计器中发布。 当前账号所属角色已被加入该大屏的授权名单。 大屏所需数据源和数据集可正常访问。 操作步骤 打开“大屏展示”，查看卡片中的大屏名称、说明和发布时间。 点击“查看大屏”，系统校验登录态、发布状态和角色授权。 进入全屏预览后，按大屏内提供的筛选器切换期间、区域或产品线。 演示结束后退出全屏，返回大屏展示页。 若卡片为空，联系大屏所有者确认是否已发布并授权当前角色。 输入与输出 输入是大屏发布快照和角色授权；输出是只读的可视化大屏。预览页不提供编辑能力，也不会写入业务数据。 宏澜家电示例 集团展厅使用“宏澜经营驾驶舱”展示年度销售、生产达成、库存周转和渠道贡献。讲解人员只需使用已授权账号打开“大屏展示”，无需进入设计器，也不会误改发布内容。 客户应用演示：周五经营例会：从大屏快速掌握全局 业务情境： 集团管理层需要在大屏上查看本周销售、毛利、订单和库存预警，并聚焦华东区域。 第一步：登录后进入“数据大屏中心 → 大屏展示” 步骤图 15-01　第1步：登录后进入“数据大屏中心 → 大屏展示”。红框标出登录后进入数据大屏中心 → 大屏展示。 登录后进入“数据大屏中心 → 大屏展示”，找到“宏澜经营驾驶舱”。 第二步：查看卡片名称、发布时间和说明 步骤图 15-02　第2步：查看卡片名称、发布时间和说明。红框标出查看卡片名称、发布时间和说明。 查看卡片名称、发布时间和说明，点击“查看大屏”。 第三步：先确认页面数据更新时间 步骤图 15-03　第3步：先确认页面数据更新时间。红框标出先确认页面数据更新时间。 先确认页面数据更新时间，再查看销售额、毛利额、订单数和库存预警。 第四步：在区域筛选器中选择“华东” 步骤图 15-04　第4步：在区域筛选器中选择“华东”。红框标出在区域筛选器中选择华东。 在区域筛选器中选择“华东”，观察趋势、品类和门店排行是否联动变化。 第五步：进入全屏模式投屏讲解 步骤图 15-05　第5步：进入全屏模式投屏讲解。红框标出进入全屏模式投屏讲解。 进入全屏模式投屏讲解，结束后退出全屏返回大屏展示页。 最终结果与效果 大屏显示已发布、已授权的经营快照，筛选后各图表同步切换到华东区域。会议人员能看到统一的指标和图表，不会误改设计稿。 操作提示： 如果卡片为空或打不开，先检查发布状态和角色授权，不要反复刷新。 结果说明与限制 草稿修改不会立即出现在展示页，必须重新发布。 未配置授权时通常只有作者和管理员可见。 页面加载失败时先检查发布状态、角色授权和大屏服务状态，不要反复刷新。 开发人员参考 页面： ui/src/views/bi/goview/center/index.vue、预览页 ui/src/views/bi/goview/index.vue 接口： GET /bi/goview/center、 POST /bi/goview/view/launch 权限： bi:goview:view 预览通过一次性票据打开，读取不可变发布快照；前端不能拼接任意 GoView 地址。 大屏设计器 功能定位 大屏设计器用于创建、编辑、发布、授权和回滚数据大屏。它把可视化画布、数据绑定、发布快照和角色访问控制放在同一个管理界面中。 图 3-2　大屏设计与发布管理 适用角色 BI 管理员、数据可视化设计人员和经授权的大屏所有者。 页面入口 数据大屏中心 → 大屏设计器（ /bi/screen/designer）。 操作步骤 点击“新建大屏”，输入业务名称，例如“宏澜渠道经营大屏”。 在项目列表点击“编辑”，进入 GoView 画布；添加图表、指标卡、地图、筛选器和装饰元素。 绑定已审核的数据集，设置刷新周期、主题色、分辨率和交互联动。 返回列表点击“授权”，按角色选择可见范围。 点击“发布”，填写发布说明。系统生成不可变版本，业务用户只能看到该快照。 在“版本”中查看发布人、时间、摘要，并按需回滚到历史版本。 需要下线时使用“下线”，停止业务入口展示。 输入与输出 输入 输出 画布组件、数据绑定、主题和交互 可编辑草稿 发布说明和角色授权 不可变发布版本、可见的业务大屏 历史版本号 可回滚的已发布快照 宏澜家电示例 可视化人员制作“宏澜智能制造运营大屏”，左侧展示产量与良率，中部展示产线节拍，右侧展示库存预警。发布前授权“集团管理层”和“生产运营”角色；生产口径调整后重新发布 v2，v1 仍可追溯。 客户应用演示：制作“宏澜渠道经营大屏” 业务情境： 可视化人员需要把渠道销售、目标达成和区域贡献放在一张投屏大屏中。 第一步：进入“数据大屏中心 → 大屏设计器” 步骤图 16-01　第1步：进入“数据大屏中心 → 大屏设计器”。红框标出进入数据大屏中心 → 大屏设计器。 进入“数据大屏中心 → 大屏设计器”，点击“新建大屏”，填写名称和业务说明。 第二步：在项目行点击“编辑”进入画布 步骤图 16-02　第2步：在项目行点击“编辑”进入画布。红框标出在项目行点击编辑进入画布。 在项目行点击“编辑”进入画布，添加指标卡、趋势图、区域地图和渠道排行。 第三步：为组件绑定已审核的数据集 步骤图 16-03　第3步：为组件绑定已审核的数据集。红框标出为组件绑定已审核的数据集。 为组件绑定已审核的数据集，设置筛选器联动、刷新周期和分辨率。 第四步：返回列表点击“授权” 步骤图 16-04　第4步：返回列表点击“授权”。红框标出返回列表点击授权。 返回列表点击“授权”，选择集团管理层和渠道运营角色。 第五步：点击“发布” 步骤图 16-05　第5步：点击“发布”。红框标出点击发布。 点击“发布”，填写发布说明；再到“大屏展示”用业务账号验证可见性和数据。 最终结果与效果 画布生成不可变发布版本，授权角色能在“大屏展示”中打开；后续修改草稿不会影响线上快照。 操作提示： 发布前必须预览并抽样核对数字；下线时使用“下线”操作，不要直接删除历史版本。 常见问题 发布后业务用户仍看不到。 检查是否完成角色授权，以及用户是否属于该角色。 编辑画布提示连接失败。 检查大屏服务状态和一次性跳转票据；票据短时有效，刷新页面后重新申请即可。 发布后直接修改草稿会影响线上吗？ 不会。线上使用发布快照，修改草稿后需再次发布。 开发人员参考 接口： /bi/goview/design/projects、 .../publish、 .../acl、 .../versions、 .../rollback 权限： bi:goview:view、 bi:goview:design 发布必须生成不可变版本；回滚和授权均需服务端校验项目所有权与角色。 设计器使用受限 bridge 会话，令牌不落前端日志。 数据探索中心 数脉平台用户手册 V2.0 · 数据探索中心 仪表盘看板 功能定位 仪表盘看板用于浏览 Superset 6.1.0 中已创建的分析仪表盘。用户可以组合趋势、对比、占比、明细和筛选器，在同一页面回答一个完整业务问题。 图 4-1　Superset 仪表盘工作区 适用角色 BI 分析师、业务分析人员和经营管理人员。 页面入口 数据探索中心 → 仪表盘看板（ /bi/superset/dashboard）。 操作步骤 打开看板列表，选择与业务主题匹配的仪表盘。 使用日期、区域、渠道、产品线等筛选器限定分析范围。 将鼠标移到图表上查看数值、单位和时间点；必要时点击图表联动其他组件。 使用图表右上角菜单导出图片或查看数据；导出范围不得超出当前数据权限。 需要调整布局或新增图表时，进入编辑模式；无编辑权限时只能查看和筛选。 完成后返回列表，避免在公共终端保留登录会话。 输入与输出 输入是数据集、图表定义和筛选条件；输出是可交互看板、图表明细和可导出的分析结果。 宏澜家电示例 销售运营打开“区域销售与毛利看板”，筛选 2026 年第三季度和华南区域。趋势图显示销售额增长但毛利率下降，再按产品线联动发现高端空调促销折扣过高，于是转到 SQL 工作台或 AI 对话分析继续验证。 客户应用演示：销售例会前查看“销售业绩全景看板” 业务情境： 销售负责人需要在会议前确认区域销售额、毛利率和订单趋势。 第一步：进入“数据探索中心 → 仪表盘看板” 步骤图 17-01　第1步：进入“数据探索中心 → 仪表盘看板”。红框标出进入数据探索中心 → 仪表盘看板。 进入“数据探索中心 → 仪表盘看板”，在列表搜索“销售业绩全景看板”。 第二步：点击已发布看板 步骤图 17-02　第2步：点击已发布看板。红框标出点击已发布看板。 点击已发布看板，查看标题、筛选器和数据更新时间。 第三步：选择时间范围“最近 6 个月” 步骤图 17-03　第3步：选择时间范围“最近 6 个月”。红框标出选择时间范围最近 6 个月。 选择时间范围“最近 6 个月”，按区域和渠道筛选。 第四步：将鼠标移到趋势或柱状图上查看明细提示 步骤图 17-04　第4步：将鼠标移到趋势或柱状图上查看明细提示。红框标出将鼠标移到趋势或柱状图上查看明细提示。 将鼠标移到趋势或柱状图上查看明细提示，必要时进入关联明细图表。 第五步：整理需要跟进的异常区域 步骤图 17-05　第5步：整理需要跟进的异常区域。红框标出整理需要跟进的异常区域。 整理需要跟进的异常区域，并记录看板名称和筛选条件，便于复盘。 最终结果与效果 看板按所选时间、区域和渠道展示最新分析结果，图表之间保持同一筛选口径。业务用户无需再次登录数据探索工具。 操作提示： 看板中的“草稿”状态不等于已发布；正式会议请使用“已发布”版本。 常见问题 页面显示“正在加载数据探索页面”较久。 先等待首次初始化；若超过提示时间，检查 Superset 服务和后端免登录通道。 看板打开后又要求登录。 这是安全票据过期或会话失效。返回数脉平台重新点击菜单，不要在新窗口手工输入第三方凭据。 图表无数据。 检查筛选期间、数据集权限和源表是否有该期间数据。 开发人员参考 页面： ui/src/views/bi/superset/index.vue 接口： GET /bi/superset/status?page=dashboard、 GET /bi/superset/launch?page=dashboard 权限： bi:sup:dashboard 目标路径由后端白名单生成；安全票据约 45 秒有效且一次性使用。 数据集与指标 功能定位 数据集与指标页面承载 Superset 的数据集模型和指标定义，是图表、SQL 工作台和 AI 看板共同使用的数据语义层。 图 4-2　数据集、字段与指标管理入口 适用角色 BI 分析师、数据开发人员和指标管理员。 页面入口 数据探索中心 → 数据集&指标（ /bi/superset/dataset）。 操作步骤 新建或打开数据集，选择已登记且经审核的物理表或 SQL 数据集。 检查字段类型、中文名称、是否可分组、是否可过滤和是否可聚合。 创建指标时写明业务口径、计算公式、单位、时间粒度和负责人。 设置数据集权限和行级安全规则，确保不同角色只看到授权范围。 保存前预览字段和数据量；发布后在仪表盘或 AI 分析中引用。 口径变更应形成新版本并更新业务字典，不要直接覆盖历史解释。 输入与输出 输入是数据源、表字段、SQL 和指标定义；输出是可复用数据集、维度、指标与权限规则。 宏澜家电示例 建立“销售订单分析数据集”，包含订单日期、区域、渠道、产品品类、销售额、销量、折扣额和毛利额。指标“成交金额”明确为含税订单金额扣除取消订单，“毛利率”按毛利额除以净销售额计算。 结果说明 数据集是“单一事实来源”的入口。若同一指标在多个图表中口径不同，应先修正数据集和业务字典，而不是在每个图表内分别写公式。 客户应用演示：维护“销售订单分析数据集” 业务情境： BI 分析师需要为销售趋势、品类占比和客户排行提供统一的数据集。 第一步：进入“数据探索中心 → 数据集&指标” 步骤图 18-01　第1步：进入“数据探索中心 → 数据集&指标”。红框标出进入数据探索中心 → 数据集&指标。 进入“数据探索中心 → 数据集&指标”，找到销售订单主题数据集。 第二步：打开数据集详情 步骤图 18-02　第2步：打开数据集详情。红框标出打开数据集详情。 打开数据集详情，检查来源表、字段类型、指标定义和默认过滤条件。 第三步：确认“销售额、订单数、毛利额、毛利率”等指标的计算口径 步骤图 18-03　第3步：确认“销售额、订单数、毛利额、毛利率”等指标的计算口径。红框标出确认销售额、订单数、毛利额、毛利率等指标的计算口径。 确认“销售额、订单数、毛利额、毛利率”等指标的计算口径。 第四步：在数据集预览中抽查一个区域和月份 步骤图 18-04　第4步：在数据集预览中抽查一个区域和月份。红框标出在数据集预览中抽查一个区域和月份。 在数据集预览中抽查一个区域和月份，确认数据行数与合计合理。 第五步：保存变更并记录修改原因 步骤图 18-05　第5步：保存变更并记录修改原因。红框标出保存变更并记录修改原因。 保存变更并记录修改原因；如口径发生变化，提交相应审核。 最终结果与效果 数据集字段和指标可被多个图表复用，预览结果与业务口径一致。下游图表不需要重复编写相同计算。 操作提示： 不要直接在数据集里加入未授权的敏感字段；字段和行级权限应在服务端控制。 开发人员参考 页面入口： /bi/superset/dataset 权限： bi:sup:dataset 通过 Superset 原生数据集管理能力维护字段、指标和 RLS；数脉统一负责门户身份与免登录跳转。 受控 SQL 仍需遵循只读、字段白名单和行数限制。 SQL 工作台 功能定位 SQL 工作台面向具备 SQL 能力的分析人员，用于直接查询已授权数据、验证口径和保存可复用查询。它适合探索性分析，不应替代经过审核的固定报表。 图 4-3　SQL 查询、结果与保存入口 适用角色 BI 分析师、数据开发和数据治理人员。 页面入口 数据探索中心 → SQL 工作台（ /bi/superset/sqllab）。 操作步骤 在左侧选择数据库和数据集范围。 输入只读 SQL，先使用 LIMIT 控制结果规模。 点击运行，检查执行状态、耗时、返回行数和字段类型。 将结果保存为查询或数据集，补充名称、业务说明和责任人。 需要复用时，将稳定查询转化为数据集和指标，并提交审核。 分析完成后退出，不在查询中保存口令、令牌或个人敏感信息。 输入与输出 输入是只读 SQL 和授权数据源；输出是查询结果、执行日志和可保存的查询资产。 宏澜家电示例 分析师验证“华南区域毛利率下降”时，按月份、产品线和渠道分组查询销售额、折扣额与毛利额，确认异常来自高端空调的促销折扣，而不是退货或汇率因素。 安全边界 只允许只读查询；写操作、DDL 和危险函数应被拒绝。 查询结果受行数限制，导出还需额外权限。 结果中如含个人信息，应遵守最小必要原则，不复制到聊天工具或公共文档。 客户应用演示：核对华南区域毛利率异常 业务情境： 分析师发现华南区域毛利率下降，需要用只读 SQL 验证品类和折扣因素。 第一步：进入“数据探索中心 → SQL 工作台” 步骤图 19-01　第1步：进入“数据探索中心 → SQL 工作台”。红框标出进入数据探索中心 → SQL 工作台。 进入“数据探索中心 → SQL 工作台”，选择销售分析数据库。 第二步：输入只读查询 步骤图 19-02　第2步：输入只读查询。红框标出输入只读查询。 输入只读查询，按月份、产品线和渠道汇总销售额、折扣额、毛利额。 第三步：在查询中加入时间范围和 LIMIT 步骤图 19-03　第3步：在查询中加入时间范围和 LIMIT。红框标出在查询中加入时间范围和 LIMIT。 在查询中加入时间范围和 LIMIT，先控制结果规模后运行。 第四步：检查返回行数、字段类型、执行耗时和异常空值 步骤图 19-04　第4步：检查返回行数、字段类型、执行耗时和异常空值。红框标出检查返回行数、字段类型、执行耗时和异常空值。 检查返回行数、字段类型、执行耗时和异常空值。 第五步：把稳定查询保存为查询或数据集 步骤图 19-05　第5步：把稳定查询保存为查询或数据集。红框标出把稳定查询保存为查询或数据集。 把稳定查询保存为查询或数据集，补充名称、业务说明和责任人。 最终结果与效果 查询结果定位到具体月份、产品线和渠道，能够验证或排除毛利率下降原因；稳定查询可被后续分析复用。 操作提示： SQL 工作台只用于只读分析，不应尝试建表、更新、删除或导出敏感明细。 开发人员参考 页面入口： /bi/superset/sqllab 权限： bi:sup:sqllab SQL 校验在服务端完成；前端限制不能替代数据库只读账号、网络边界和审计。 查询异常应记录 SQL 摘要、耗时和错误码，但不得记录凭据或完整敏感结果。 AI 对话分析 功能定位 AI 对话分析让业务用户用自然语言描述分析目标，由大模型结合受控数据集和 MCP 工具生成多图表看板方案。系统先给出方案，用户二次确认后才真正创建数据集、图表和看板。 图 4-4　输入问题、查看步骤并确认看板方案 适用角色 业务分析人员、经营管理人员和 BI 分析师。当前演示环境页面显示模型为 DeepSeek-V4.1-Flash，由企业模型网关调用。 页面入口 数据探索中心 → AI 对话分析（ /bi/superset/ai）。 操作步骤 在输入框描述业务问题，建议同时写明分析对象、时间范围、对比维度和关注指标。 点击“开始分析”或按 Ctrl + Enter。系统展示 AI 工具调用轨迹和看板方案。 检查方案中的数据范围、图表数量、字段、指标、筛选条件和单位。一次最多生成 5 张图表，并放入同一看板。 点击“确认创建看板”。方案只能消费一次，重复提交会提示过期或已执行。 创建完成后点击“打开看板”，在 Superset 中查看结果。 需要调整样式时，输入“把背景改成深蓝色”“图表使用青蓝色系”“标题字号调大”等指令，系统解析后应用到看板。 任何 AI 结果都必须人工复核后再用于经营判断。 推荐提问模板 分析【时间范围】内【业务对象】的【指标】， 按【维度一】和【维度二】拆分， 展示趋势、占比和排行，并标注异常。 宏澜家电示例：“分析最近 6 个月各区域销售额趋势、品类销售占比和前 10 名客户，使用青蓝色主题。”AI 返回趋势图、占比图、客户排行等多图表方案；确认后形成一个看板，再要求“标题字号调大、图表文字使用深灰色”。 输入与输出 项目 规则 问题长度 最多 500 字 分析边界 只读分析，不直接修改业务库 SQL 安全 数据集范围、字段白名单、只读和行数限制 方案确认 一次性消费，创建前必须人工确认 输出 一个最多 5 图表的看板、分析步骤和审计记录 客户应用演示：一次生成多图表销售复盘看板 业务情境： 经营会需要同时查看销售趋势、区域占比、品类结构和客户排行。 第一步：进入“数据探索中心 → AI 对话分析” 步骤图 20-01　第1步：进入“数据探索中心 → AI 对话分析”。红框标出进入数据探索中心 → AI 对话分析。 进入“数据探索中心 → AI 对话分析”，确认模型和 AI 状态可用。 第二步：输入“分析最近 6 个月销售额、毛利额和订单数 步骤图 20-02　第2步：输入“分析最近 6 个月销售额、毛利额和订单数。红框标出输入分析最近 6 个月销售额、毛利额和订单数。 输入“分析最近 6 个月销售额、毛利额和订单数，按月份看趋势、按区域和品类看占比，列出前 10 名客户”。 第三步：查看分析步骤 步骤图 20-03　第3步：查看分析步骤。红框标出查看分析步骤。 查看分析步骤，确认数据范围、指标口径和只读边界。 第四步：在看板方案中核对最多 5 张图表的类型、字段、筛选和单位 步骤图 20-04　第4步：在看板方案中核对最多 5 张图表的类型、字段、筛选和单位。红框标出在看板方案中核对最多 5 张图表的类型、字段、筛选和单位。 在看板方案中核对最多 5 张图表的类型、字段、筛选和单位。 第五步：点击“确认创建看板” 步骤图 20-05　第5步：点击“确认创建看板”。红框标出点击确认创建看板。 点击“确认创建看板”，再点击“打开看板”查看结果。 第六步：输入“背景改为深蓝色 步骤图 20-06　第6步：输入“背景改为深蓝色。红框标出输入背景改为深蓝色。 输入“背景改为深蓝色，图表用青蓝色系，标题字号 18”，复核后保存。 最终结果与效果 同一看板生成趋势、占比、品类和客户排行等多张图表，配色和文字样式可按自然语言调整。方案需人工确认，不会自动发布。 操作提示： 方案约 30 分钟有效且只能消费一次；样式调整不改变底层数据。 常见问题 点击后没有生成看板。 检查是否已经点击二次确认；只有方案阶段不会创建资产。 提示方案已过期。 重新发起分析并生成新方案，不要重复使用旧方案。 样式指令没有生效。 使用明确的对象和值，例如“看板背景改为 #0B1F3A，图表标题字号 18”；若仍失败，检查看板 ID 和权限。 AI 回答看似合理但数据异常。 核对字段、时间范围、筛选条件和指标口径；AI 输出不能替代数据校验。 开发人员参考 页面： ui/src/views/bi/ai/index.vue 接口： GET /bi/ai/status、 POST /bi/ai/chat、 POST /bi/ai/execute、 POST /bi/ai/style 权限： bi:sup:ai 方案包含 planId 且一次性有效；服务端校验数据集范围、字段白名单、只读 SQL 和行数限制。 模型网关配置通过环境变量管理，文档和日志不得出现真实 API Key。 智能报表中心 数脉平台用户手册 V2.0 · 智能报表中心 业务报表中心 功能定位 业务报表中心集中展示经授权、格式固定的业务报表。它适合月度经营、费用汇总、库存台账、应收账龄、生产日报等需要稳定版式和打印归档的场景。 图 5-1　按业务主题进入已授权报表 适用角色 业务用户、财务人员、运营人员、生产管理人员和报表查看者。 页面入口 智能报表中心 → 业务报表中心（ /bi/jimu/center）。 前置条件 JimuReport 2.5.5 服务正常。 当前账号拥有 bi:jimu:center 权限。 报表已发布，且目标报表 ID 位于服务端只读白名单。 操作步骤 按报表主题查找目标报表，例如“月度费用汇总”。 点击报表卡片，系统申请一次性免登录票据并打开只读报表。 按页面提示选择期间、部门、产品线等查询条件。 查看结果并核对数据日期、单位、口径和页码。 使用打印或导出功能输出 PDF/Excel；导出前确认接收人的数据权限。 如需修改版式或新增报表，请从“报表自助设计”进入，而不是修改正在使用的业务报表。 输入与输出 输入是报表参数和当前用户权限；输出是只读报表页面、打印件或导出文件。 宏澜家电示例 财务人员月初打开“宏澜月度费用汇总”，选择 2026 年 10 月和“集团合并”范围，核对管理费用、销售费用和研发费用后导出 PDF，作为经营例会材料附件。 客户应用演示：导出宏澜集团 10 月费用汇总表 业务情境： 财务人员需要在经营会前导出集团合并口径的月度费用汇总。 第一步：进入“智能报表中心 → 业务报表中心” 步骤图 21-01　第1步：进入“智能报表中心 → 业务报表中心”。红框标出进入智能报表中心 → 业务报表中心。 进入“智能报表中心 → 业务报表中心”，找到“宏澜月度费用汇总”。 第二步：点击报表卡片 步骤图 21-02　第2步：点击报表卡片。红框标出点击报表卡片。 点击报表卡片，等待只读报表打开。 第三步：选择期间“2026 年 10 月”、组织范围“集团合并” 步骤图 21-03　第3步：选择期间“2026 年 10 月”、组织范围“集团合并”。红框标出选择期间2026 年 10 月、组织范围集团合并。 选择期间“2026 年 10 月”、组织范围“集团合并”。 第四步：核对数据日期、金额单位、合计行和费用科目口径 步骤图 21-04　第4步：核对数据日期、金额单位、合计行和费用科目口径。红框标出核对数据日期、金额单位、合计行和费用科目口径。 核对数据日期、金额单位、合计行和费用科目口径。 第五步：点击打印或导出 步骤图 21-05　第5步：点击打印或导出。红框标出点击打印或导出。 点击打印或导出，选择 PDF，确认文件页眉、页码和密级标识。 最终结果与效果 生成版式固定的费用汇总 PDF，明细、合计和预算差异可直接作为经营会材料。 操作提示： 导出前确认接收人拥有同等数据权限；报表数据为空时先检查期间和抽取批次。 常见问题 报表卡片打不开。 检查 JimuReport 状态、安全票据是否过期、报表是否仍在白名单。 数据为空。 确认查询期间、组织范围和数据抽取批次；固定报表不会自动补造缺失数据。 能看见报表但不能导出。 导出属于额外操作权限，需联系管理员。 开发人员参考 页面： ui/src/views/bi/jimu/index.vue 接口： GET /bi/jimu/status?page=center、 GET /bi/jimu/center/launch?reportId=... 权限： bi:jimu:center 报表 ID 必须精确匹配服务端只读白名单；票据约 30 秒有效且一次性使用。 报表自助设计 功能定位 报表自助设计提供积木报表设计器入口，用于制作表格类报表、查询表单、分组汇总、交叉表、图表和打印模板。 图 5-2　积木报表设计器与报表资产工作区 适用角色 报表开发人员、BI 管理员和获得设计权限的业务分析师。 页面入口 智能报表中心 → 报表自助设计（ /bi/jimu/designer）。 操作步骤 进入设计器，选择新建报表或打开已有模板。 选择经审核的数据集，配置字段、查询参数和数据集绑定。 使用表格、交叉表、分组、图表、图片和文本组件完成版面设计。 设置参数校验、默认值、分页、打印页眉页脚和导出格式。 预览不同参数下的结果，检查合计、空值、长文本和分页。 保存并发布；将报表 ID 登记到业务报表中心白名单后，业务用户才可从统一入口访问。 变更时保留旧版本，避免影响正在使用的固定报表。 输入与输出 输入是数据集、查询参数、模板布局和打印设置；输出是可在报表中心打开、打印和导出的报表。 宏澜家电示例 报表开发人员制作“宏澜应收账龄分析表”，按客户、销售组织和账龄区间分组，显示应收余额、逾期金额和占比；支持按截止日期查询，并输出带公司页眉的 PDF。 客户应用演示：设计“宏澜应收账龄分析表” 业务情境： 财务需要一张按客户和账龄区间展开的应收分析表。 第一步：进入“智能报表中心 → 报表自助设计” 步骤图 22-01　第1步：进入“智能报表中心 → 报表自助设计”。红框标出进入智能报表中心 → 报表自助设计。 进入“智能报表中心 → 报表自助设计”，新建报表并选择应收数据集。 第二步：设置标题、截止日期参数、客户、销售组织、应收余额和逾期金额字段 步骤图 22-02　第2步：设置标题、截止日期参数、客户、销售组织、应收余额和逾期金额字段。红框标出设置标题、截止日期参数、客户、销售组织、应收余额和逾期金额字段。 设置标题、截止日期参数、客户、销售组织、应收余额和逾期金额字段。 第三步：按客户和账龄区间分组 步骤图 22-03　第3步：按客户和账龄区间分组。红框标出按客户和账龄区间分组。 按客户和账龄区间分组，增加合计行、占比列和逾期预警条件格式。 第四步：设置 A4 横向打印、页眉、页码和 PDF/Excel 导出选项 步骤图 22-04　第4步：设置 A4 横向打印、页眉、页码和 PDF/Excel 导出选项。红框标出设置 A4 横向打印、页眉、页码和 PDF/Excel 导出选项。 设置 A4 横向打印、页眉、页码和 PDF/Excel 导出选项。 第五步：预览不同客户和截止日期 步骤图 22-05　第5步：预览不同客户和截止日期。红框标出预览不同客户和截止日期。 预览不同客户和截止日期，核对合计、空值和分页后保存发布。 最终结果与效果 设计器生成可查询、可打印的应收账龄报表；登记白名单并授权后，财务人员可从业务报表中心直接使用。 操作提示： 报表查询参数必须有合法范围，禁止拼接任意 SQL；变更时保留旧版本。 检查清单 标题、期间、单位和数据来源清楚。 合计行与明细行计算一致。 空值显示规则统一，不把空值误认为零。 大结果集启用分页，避免浏览器卡死。 查询参数有合法范围，禁止拼接任意 SQL。 打印版式在 A4 横向和纵向均可读。 开发人员参考 页面入口： /bi/jimu/designer 权限： bi:jimu:designer 通过 /bi/jimu/launch?page=designer 申请短时票据；设计器与报表中心使用不同页面编码。 新增固定报表需同时配置服务端白名单、菜单权限和帮助文档。 业务建模中心 数脉平台用户手册 V2.0 · 业务建模中心 建模概览 功能定位 建模概览把项目、业务域、业务过程、指标、维度、审核态势和快捷入口集中在一个工作台，帮助团队按“定义范围 → 梳理字典 → 提交审核 → 固化版本 → 持续治理”的顺序推进。 图 6-1　建模概览、审核态势和流程导航 适用角色 建模项目负责人、数据架构师、指标管理员、审核人员和业务专家。 页面入口 业务建模中心 → 建模概览（ /bi/bm/workbench）。 操作步骤 查看当前项目、业务域、业务过程、指标和维度数量，确认建模范围。 查看待审核、已通过和已驳回数量，识别审核瓶颈。 点击“进入建模项目”创建或维护项目。 按快捷入口依次进入业务字典、审核中心、Excel 导入和版本与审计。 需要检查模型和发布状态时，进入模型设计和发布中心。 客户应用演示：启动“宏澜销售经营分析”建模项目 业务情境： 数据架构师准备统一销售、毛利和客户指标，为后续看板提供语义底座。 第一步：进入“业务建模中心 → 建模概览” 步骤图 23-01　第1步：进入“业务建模中心 → 建模概览”。红框标出进入业务建模中心 → 建模概览。 进入“业务建模中心 → 建模概览”，查看项目、业务域、指标和审核态势。 第二步：点击“进入建模项目” 步骤图 23-02　第2步：点击“进入建模项目”。红框标出点击进入建模项目。 点击“进入建模项目”，创建或选择“宏澜集团经营分析”项目。 第三步：按快捷入口先梳理销售业务域和业务过程 步骤图 23-03　第3步：按快捷入口先梳理销售业务域和业务过程。红框标出按快捷入口先梳理销售业务域和业务过程。 按快捷入口先梳理销售业务域和业务过程，再维护指标与维度。 第四步：提交指标口径到审核中心 步骤图 23-04　第4步：提交指标口径到审核中心。红框标出提交指标口径到审核中心。 提交指标口径到审核中心，通过后进入模型设计。 第五步：在发布中心确认模型版本和发布状态 步骤图 23-05　第5步：在发布中心确认模型版本和发布状态。红框标出在发布中心确认模型版本和发布状态。 在发布中心确认模型版本和发布状态，再回到概览检查整体进度。 最终结果与效果 团队按“项目 → 字典 → 审核 → 模型 → 发布”的顺序推进，概览中能看到项目、指标和审核状态。 操作提示： 先完成一个高价值主题再扩展，避免一次性铺开过多业务域。 当前演示环境说明 当前截图中的演示数据显示 2 个建模项目、18 个业务域、134 个业务过程、180 个指标和 98 个维度。该数值会随演示数据变化，不能作为生产基线。 宏澜家电示例 数据架构师先建立“宏澜集团经营分析建模项目”，再按销售、生产、库存、采购、财务、市场和人力七个主题梳理业务域。指标和维度通过审核后才用于模型设计和看板。 开发人员参考 接口： GET /bi/bm/overview 权限： bi:bm:view 概览只做聚合展示，不提供跨项目数据拼接。 统计值应以服务端实时查询为准，不在前端缓存超过当前会话需要。 建模项目 功能定位 建模项目定义建模目标、范围、负责人、归属部门、计划周期和协作成员，是业务字典、质量规则、模型和发布记录的权限边界。 图 6-2　项目范围、成员与状态管理 适用角色 项目负责人、数据架构师和 BI 管理员。 页面入口 业务建模中心 → 建模项目（ /bi/bm/project）。 操作步骤 点击“新建项目”，填写项目编码、名称、负责人、部门和计划周期。 写明项目目标和范围，例如“覆盖宏澜集团销售与财务主题，统一收入、毛利和费用口径”。 创建后点击“成员”，添加编辑者、审核者和查看者。 项目负责人拥有管理和授权能力；编辑者维护字典；审核者审核；查看者只读。 使用状态下拉框将项目从草稿推进到进行中、暂停或完成，并填写变更原因。 项目必须至少保留一名负责人，移除成员前应确认工作交接。 输入与输出 输入是项目范围、周期、负责人和成员角色；输出是受权限约束的建模协作空间和可审计状态变更。 宏澜家电示例 建立“宏澜集团经营分析”项目，负责人为数据架构师，销售、财务、供应链各指定业务专家作为编辑者，数据治理委员会成员作为审核者，管理层作为查看者。 客户应用演示：建立销售主题建模项目并配置成员 业务情境： 销售、财务和数据团队需要共同维护收入、折扣和毛利口径。 第一步：进入“业务建模中心 → 建模项目” 步骤图 24-01　第1步：进入“业务建模中心 → 建模项目”。红框标出进入业务建模中心 → 建模项目。 进入“业务建模中心 → 建模项目”，点击“新建项目”。 第二步：填写项目编码、名称、负责人、归属部门和计划周期 步骤图 24-02　第2步：填写项目编码、名称、负责人、归属部门和计划周期。红框标出填写项目编码、名称、负责人、归属部门和计划周期。 填写项目编码、名称、负责人、归属部门和计划周期。 第三步：在项目目标中写明范围 步骤图 24-03　第3步：在项目目标中写明范围。红框标出在项目目标中写明范围。 在项目目标中写明范围，例如“统一华东与华南销售收入、折扣额、毛利额口径”。 第四步：点击“成员” 步骤图 24-04　第4步：点击“成员”。红框标出点击成员。 点击“成员”，分别添加编辑者、审核者和查看者。 第五步：将项目状态改为“进行中” 步骤图 24-05　第5步：将项目状态改为“进行中”。红框标出将项目状态改为进行中。 将项目状态改为“进行中”，保存后在列表核对成员和状态。 最终结果与效果 项目成为字典、模型和发布记录的权限边界；不同成员只能执行被授权的编辑、审核或查看操作。 操作提示： 提交人与审核人应分离；项目至少保留一名负责人。 常见问题 编辑保存提示版本冲突。 页面使用乐观锁；刷新后比较最新内容再修改，避免覆盖他人更新。 无法调整成员。 需要 bi:bm:project:member 权限，且通常仅项目负责人可操作。 开发人员参考 接口： /bi/bm/projects、 .../members、 .../status 权限： bi:bm:project:edit、 bi:bm:project:member 项目成员角色： OWNER、 EDITOR、 REVIEWER、 VIEWER；所有写操作携带 expectedRevision。 业务字典 功能定位 业务字典统一管理业务域、业务过程、指标和维度，是报表、模型、大屏和 AI 问数共同引用的业务语义底座。 图 6-3　四类业务对象及审核状态 适用角色 业务专家、指标管理员、数据架构师和模型开发人员。 页面入口 业务建模中心 → 业务字典（ /bi/bm/dictionary）。 对象说明 对象 回答的问题 示例 业务域 企业有哪些稳定的业务主题？ 销售、生产、库存、财务、市场、人力 业务过程 业务中发生了什么事件？ 销售下单、生产完工、采购入库、费用报销 指标 如何衡量业务结果？ 成交金额、毛利率、库存周转天数 维度 从哪些角度分析？ 时间、区域、渠道、产品、客户、组织 操作步骤 选择项目和对象页签，按编码或名称查询。 点击“新增”填写编码、名称、业务域、责任角色、描述和生效日期。 指标必须填写业务口径、计算说明和单位；维度需说明来源表与类型。 保存草稿后点击“提交审核”，对象进入待审核状态。 审核通过后对象变为已通过并生成不可变版本；驳回后按意见修订再提交。 已通过对象需要变更时使用“修订”，不要直接删除历史对象。 宏澜家电示例 销售部门提交指标“成交金额”，口径为含税订单金额扣除取消订单，单位为元，分析粒度为订单日期和销售组织；财务部门审核确认含税规则后通过。 客户应用演示：定义“毛利率”指标口径 业务情境： 销售和财务对毛利率的计算口径不一致，需要形成统一业务定义。 第一步：进入“业务建模中心 → 业务字典” 步骤图 25-01　第1步：进入“业务建模中心 → 业务字典”。红框标出进入业务建模中心 → 业务字典。 进入“业务建模中心 → 业务字典”，选择销售业务域。 第二步：新增指标“毛利率” 步骤图 25-02　第2步：新增指标“毛利率”。红框标出新增指标毛利率。 新增指标“毛利率”，填写业务定义、计算公式、分子分母、时间粒度和单位。 第三步：关联销售额与毛利额指标 步骤图 25-03　第3步：关联销售额与毛利额指标。红框标出关联销售额与毛利额指标。 关联销售额与毛利额指标，注明是否含税、是否排除取消订单和退货。 第四步：选择负责人并提交审核 步骤图 25-04　第4步：选择负责人并提交审核。红框标出选择负责人并提交审核。 选择负责人并提交审核；在审核中心由财务审核人复核。 第五步：审核通过后 步骤图 25-05　第5步：审核通过后。红框标出审核通过后。 审核通过后，在版本与审计中确认不可变版本和摘要。 最终结果与效果 “毛利率”成为可被报表、数据集、看板和 AI 问数共同引用的统一指标，口径和审核记录可追溯。 操作提示： 指标定义要说明边界条件，不能只写公式名称。 常见问题 审核通过后不能直接改。 这是版本控制设计；应提交新修订，保留历史口径。 编码重复。 编码在项目内应保持唯一且稳定；业务含义变化时新增编码或按治理规范升版。 开发人员参考 接口： /bi/bm/projects/{projectId}/domains|processes|metrics|dimensions 权限： bi:bm:dict:edit、 bi:bm:dict:submit、 bi:bm:dict:review 审核通过生成带 SHA-256 的不可变快照；修订号用于乐观锁。 数据源与画像 功能定位 数据源与画像用于登记只读数据库连接、同步元数据目录、查看表结构和执行脱敏数据画像。它回答“有哪些数据、字段质量如何、能否支撑分析”。 图 6-4　只读数据源、表目录与画像任务 适用角色 数据管理员、数据架构师和 ETL 管理员。 页面入口 业务建模中心 → 数据源与画像（ /bi/bm/source）。 操作步骤 选择项目，点击“新增数据源”。 填写数据源名称、类型、主机端口、数据库、Schema 和只读账号；口令加密保存。 点击“测试连接”，确认网络、账号和权限。 执行“同步目录”，读取表、字段、类型和注释；该操作只读元数据。 选择一张或多张表执行“画像”，查看行数、空值率、唯一值、最值、分布和格式异常。 查看任务记录和最近验证时间；同步和画像同一数据源同时只允许一个任务。 不再使用的数据源先确认下游引用，再按流程删除。 输入与输出 输入是只读连接和表范围；输出是数据源状态、表目录、字段画像和脱敏统计。系统不保存原始样本行。 宏澜家电示例 接入 ERP 只读库后同步 80 张表，对 sales_order、 sales_order_item、 inventory_stock 和 finance_voucher 做画像，发现订单金额空值率、客户编码重复率和日期越界问题，作为质量规则设计依据。 安全边界 只允许登记只读账号；生产写账号不得接入。 连接地址和凭据不得出现在帮助文档、截图和前端日志。 画像只保存聚合统计，不保存个人手机号、地址等原始样本。 客户应用演示：登记宏澜 ERP 只读数据源 业务情境： 需要把 ERP 中的订单、客户和产品表接入数据治理流程。 第一步：进入“业务建模中心 → 数据源与画像” 步骤图 26-01　第1步：进入“业务建模中心 → 数据源与画像”。红框标出进入业务建模中心 → 数据源与画像。 进入“业务建模中心 → 数据源与画像”，点击“新增数据源”。 第二步：选择数据库类型 步骤图 26-02　第2步：选择数据库类型。红框标出选择数据库类型。 选择数据库类型，填写主机、端口、库名和只读账号的环境变量引用。 第三步：点击“测试连接” 步骤图 26-03　第3步：点击“测试连接”。红框标出点击测试连接。 点击“测试连接”，确认连接成功后同步表清单和字段目录。 第四步：对订单、客户、产品表执行画像 步骤图 26-04　第4步：对订单、客户、产品表执行画像。红框标出对订单、客户、产品表执行画像。 对订单、客户、产品表执行画像，查看行数、空值、枚举和主键候选。 第五步：保存数据源并记录负责人、用途和访问范围 步骤图 26-05　第5步：保存数据源并记录负责人、用途和访问范围。红框标出保存数据源并记录负责人、用途和访问范围。 保存数据源并记录负责人、用途和访问范围。 最终结果与效果 数据源登记成功，页面显示表数量、字段目录和画像摘要；密码不会在页面回显。 操作提示： 必须使用只读账号；若连接失败，先检查网络白名单和密钥引用，不要粘贴明文口令。 开发人员参考 接口： /bi/bm/sources、 .../tables、 .../profile、 .../jobs 权限： bi:bm:source:admin、 bi:bm:profile:run 服务端校验网络边界并加密保存口令；目录同步与画像均为受控异步任务。 数据质量 功能定位 数据质量通过规则、运行、告警和趋势，持续检查数据的完整性、唯一性、范围、枚举、格式、时效性、行数和引用完整性。 图 6-5　质量规则、运行结果和告警处理 适用角色 数据管理员、质量管理员、ETL 管理员和业务数据责任人。 页面入口 业务建模中心 → 数据质量（ /bi/bm/quality）。 规则类型 类型 检查内容 示例 NOT_NULL 必填字段是否为空 订单号不能为空 UNIQUE 单字段或组合字段是否唯一 客户编码唯一 RANGE 数值是否在合理区间 折扣率 0—1 ENUM 值是否属于允许集合 订单状态合法 REGEX 文本格式是否符合规则 物料编码格式 FRESHNESS 数据是否足够新 销售数据延迟不超过 1 天 ROW_COUNT 行数是否异常 当日订单量不为零 REFERENTIAL 外键引用是否存在 订单产品必须在产品维表中 操作步骤 选择项目，点击“新建质量规则”。 选择规则类型、数据源、校验表、字段和参数，设置阈值与严重级别。 保存草稿并提交审核；审核通过后按调度运行或手工运行。 在运行记录中查看通过、警告、失败和错误数量。 在告警页签按待处理、已确认、已忽略筛选，查看脱敏摘要。 对已知问题执行确认或忽略，并记录原因。 在质量趋势中查看最近 7/30/90 天变化，评估治理效果。 客户应用演示：为销售订单配置金额与主键质量规则 业务情境： 订单数据进入分析前，需要防止重复订单和负金额影响销售指标。 第一步：进入“业务建模中心 → 数据质量” 步骤图 27-01　第1步：进入“业务建模中心 → 数据质量”。红框标出进入业务建模中心 → 数据质量。 进入“业务建模中心 → 数据质量”，点击“新建规则”。 第二步：选择订单源表 步骤图 27-02　第2步：选择订单源表。红框标出选择订单源表。 选择订单源表，创建“订单号唯一”和“订单金额不小于 0”两条规则。 第三步：设置严重级别、统计范围、执行周期和告警接收人 步骤图 27-03　第3步：设置严重级别、统计范围、执行周期和告警接收人。红框标出设置严重级别、统计范围、执行周期和告警接收人。 设置严重级别、统计范围、执行周期和告警接收人。 第四步：保存并提交审核 步骤图 27-04　第4步：保存并提交审核。红框标出保存并提交审核。 保存并提交审核，审核通过后手工运行一次。 第五步：查看通过率、失败行数和样本摘要 步骤图 27-05　第5步：查看通过率、失败行数和样本摘要。红框标出查看通过率、失败行数和样本摘要。 查看通过率、失败行数和样本摘要，确认结果可被追溯。 最终结果与效果 订单表拥有可重复执行的质量检查；失败时能定位表、字段、批次和影响行数，并按告警策略通知责任人。 操作提示： 质量规则应围绕业务风险设计，不要一次配置大量低价值规则拖慢运行。 当前演示环境说明 当前截图显示 72 条已审核规则、293 次运行和 0 个未处理告警。该数据仅用于演示，生产环境应以实际运行结果为准。 宏澜家电示例 为订单金额设置“必须大于零”的范围规则，为订单号设置唯一性规则，为客户编码设置引用完整性规则。促销期间订单激增时，行数规则发现某区域同步批次只有正常量的 12%，及时阻止错误报表发布。 开发人员参考 接口： /bi/bm/dq/rules、 .../runs、 .../alerts、 .../trend 权限： bi:bm:dq:edit、 bi:bm:dq:submit、 bi:bm:dq:review、 bi:bm:dq:run 规则 SQL 由受控编译器生成，禁止任意表达式注入；告警摘要需脱敏。 审核中心 功能定位 审核中心集中处理待审核的业务域、业务过程、指标和维度。审核人检查口径、引用、责任角色和变更影响，通过后系统生成不可变版本。 图 6-6　按对象类型查看和批量审核 适用角色 审核人员、数据治理委员会成员和项目审核者。 页面入口 业务建模中心 → 审核中心（ /bi/bm/review）。 操作步骤 选择项目和对象类型页签。 勾选一个或多个待审核对象，查看提交人、提交时间、修订号和详情。 打开详情，核对业务口径、计算公式、单位、来源表、数据分级和关联维度。 点击“批量通过”，填写可选审核意见；确认后生成版本快照。 如需退回，点击“批量驳回”，填写 5—500 字驳回原因。 审核人不能审核本人提交的对象；如页面无待审数据，检查是否触发了职责分离限制。 输入与输出 输入是待审对象和审核意见；输出是已通过或已驳回状态、审核记录和不可变版本。 宏澜家电示例 财务审核人收到“毛利率”指标修订，发现计算说明未明确是否扣除运费，驳回并要求补充口径。销售部门修订后再次提交，审核通过并形成 v2 快照。 客户应用演示：审核销售主题的字典变更 业务情境： 销售部门提交了收入、折扣额和毛利率三项字典变更，需要独立审核。 第一步：进入“业务建模中心 → 审核中心” 步骤图 28-01　第1步：进入“业务建模中心 → 审核中心”。红框标出进入业务建模中心 → 审核中心。 进入“业务建模中心 → 审核中心”，筛选“待审核”和“业务字典”。 第二步：逐条查看变更内容、提交人、影响范围和口径说明 步骤图 28-02　第2步：逐条查看变更内容、提交人、影响范围和口径说明。红框标出逐条查看变更内容、提交人、影响范围和口径说明。 逐条查看变更内容、提交人、影响范围和口径说明。 第三步：将新口径与财务确认稿、历史报表和来源字段进行对照 步骤图 28-03　第3步：将新口径与财务确认稿、历史报表和来源字段进行对照。红框标出将新口径与财务确认稿、历史报表和来源字段进行对照。 将新口径与财务确认稿、历史报表和来源字段进行对照。 第四步：填写审核意见 步骤图 28-04　第4步：填写审核意见。红框标出填写审核意见。 填写审核意见，选择“通过”或“驳回”；驳回必须写明修改要求。 第五步：通过后检查生成的版本号、摘要和审核人记录 步骤图 28-05　第5步：通过后检查生成的版本号、摘要和审核人记录。红框标出通过后检查生成的版本号、摘要和审核人记录。 通过后检查生成的版本号、摘要和审核人记录。 最终结果与效果 审核通过的字典对象生成不可变版本，可进入模型设计；驳回项返回提交人修改，提交人和审核人保持职责分离。 操作提示： 审核人不能审核本人提交的对象；不要只看标题，要核对公式和边界条件。 常见问题 通过后报表口径没有变化。 已发布报表和模型需要重新引用新版本或重新发布，审核本身不会自动改写历史资产。 看不到待审对象。 检查项目范围、对象类型页签和审核权限。 开发人员参考 接口： POST /bi/bm/projects/{projectId}/reviews 权限： bi:bm:dict:review 审核与提交人职责分离；通过时生成带 SHA-256 的不可变快照。 审核意见和驳回原因进入操作审计。 Excel 导入 功能定位 Excel 导入使用受控模板批量维护业务字典。系统先校验文件、再做差异比对，只有校验通过且无错误行时才允许写入，导入对象统一生成草稿。 图 6-7　模板下载、校验批次、差异清单和受控提交 适用角色 建模人员、数据管理员和业务专家。 页面入口 业务建模中心 → Excel 导入（ /bi/bm/import）。 操作步骤 点击“下载导入模板”，不要自行修改 Sheet 名称和列标题。 选择目标项目，上传 .xlsx 文件并点击“校验文件”。 系统返回批次 ID、模板版本、文件 SHA-256 和过期时间。 查看错误清单，按 Sheet、行号、列、字段、错误码和说明逐项修正。 查看差异清单，确认新增、修改和冲突对象。 校验无错误后点击“确认导入”；提交时需匹配文件摘要，防止文件被替换。 导入结果为草稿，仍需在业务字典中逐项提交审核。 输入与输出 输入是 BM-V2.0.0 模板文件；输出是校验批次、错误与差异清单、草稿对象。 宏澜家电示例 销售专家用模板一次性导入 12 个渠道指标和 20 个客户维度，系统发现 3 行指标单位为空、1 个编码重复；修正后重新校验并导入，随后提交审核。 客户应用演示：用 Excel 批量导入销售指标和维度 业务情境： 已有标准模板的 30 个销售指标需要批量进入建模工作台。 第一步：进入“业务建模中心 → Excel 导入” 步骤图 29-01　第1步：进入“业务建模中心 → Excel 导入”。红框标出进入业务建模中心 → Excel 导入。 进入“业务建模中心 → Excel 导入”，先下载最新模板。 第二步：按模板填写业务域、对象类型、编码、名称、定义、公式和负责人 步骤图 29-02　第2步：按模板填写业务域、对象类型、编码、名称、定义、公式和负责人。红框标出按模板填写业务域、对象类型、编码、名称、定义、公式和负责人。 按模板填写业务域、对象类型、编码、名称、定义、公式和负责人。 第三步：上传文件 步骤图 29-03　第3步：上传文件。红框标出上传文件。 上传文件，查看预校验结果：必填、编码重复、引用关系和格式。 第四步：修正错误行后重新校验 步骤图 29-04　第4步：修正错误行后重新校验。红框标出修正错误行后重新校验。 修正错误行后重新校验，确认通过行数和错误行数为零。 第五步：选择导入范围并保存导入设计清单 步骤图 29-05　第5步：选择导入范围并保存导入设计清单。红框标出选择导入范围并保存导入设计清单。 选择导入范围并保存导入设计清单，检查导入结果。 最终结果与效果 批量对象进入待维护或审核流程，页面保留导入清单和错误记录。当前版本保存的是导入设计，不自动创建真实数据源或执行器。 操作提示： 不要修改模板列名；大批量导入前先用 3—5 行试导。 常见问题 有错误行还能导入吗。 不能。必须先修正全部阻断错误。 批次过期。 重新上传并校验，不要复用过期批次。 导入后看不到对象。 导入对象为草稿，需要到业务字典按对象类型查询并提交审核。 开发人员参考 接口： GET /bi/bm/imports/template、 POST /bi/bm/imports/validate、 POST /bi/bm/imports/{batchId}/commit 权限： bi:bm:dict:import 提交携带 expectedFileSha256，默认 ABORT_ON_CONFLICT；批次有过期时间。 版本与审计 功能定位 版本与审计提供不可变版本快照、操作事件、对象变更和项目导出，用于追溯“谁在什么时候改了什么、为什么改”。 图 6-8　版本快照与操作审计 适用角色 审核人员、数据治理人员、审计风控人员和项目负责人。 页面入口 业务建模中心 → 版本与审计（ /bi/bm/audit）。 操作步骤 选择项目，切换“不可变版本”或“操作审计”页签。 在版本页签查看对象类型、编码、版本号、修订号、状态、SHA-256、审核人和通过时间。 点击“快照”查看完整对象内容和审核意见。 在审计页签按对象类型或事件类型筛选，查看操作人、结果、说明、客户端 IP 和时间。 点击“导出项目”下载当前项目的业务字典与相关设计资产，用于备份或迁移。 对异常变更记录事件、对象编码和快照摘要，提交治理复核。 输入与输出 输入是项目、对象和时间范围；输出是版本快照、审计列表和项目导出包。 宏澜家电示例 季度审计发现“毛利率”在 8 月发生口径修订。审计人员通过版本快照比较 v1 与 v2 的计算说明，并在操作审计中确认修订由销售分析员提交、财务审核人通过。 客户应用演示：比较模型版本并回滚错误变更 业务情境： 一次指标修正后发现口径写错，需要查看历史版本并恢复。 第一步：进入“业务建模中心 → 版本与审计” 步骤图 30-01　第1步：进入“业务建模中心 → 版本与审计”。红框标出进入业务建模中心 → 版本与审计。 进入“业务建模中心 → 版本与审计”，选择项目和对象。 第二步：按时间查看版本列表 步骤图 30-02　第2步：按时间查看版本列表。红框标出按时间查看版本列表。 按时间查看版本列表，打开相邻两个版本的详情。 第三步：比较字段、公式、负责人、审核人和版本摘要的差异 步骤图 30-03　第3步：比较字段、公式、负责人、审核人和版本摘要的差异。红框标出比较字段、公式、负责人、审核人和版本摘要的差异。 比较字段、公式、负责人、审核人和版本摘要的差异。 第四步：确认错误版本和目标回滚版本 步骤图 30-04　第4步：确认错误版本和目标回滚版本。红框标出确认错误版本和目标回滚版本。 确认错误版本和目标回滚版本，填写回滚原因。 第五步：执行回滚并检查新版本记录、操作人和审计日志 步骤图 30-05　第5步：执行回滚并检查新版本记录、操作人和审计日志。红框标出执行回滚并检查新版本记录、操作人和审计日志。 执行回滚并检查新版本记录、操作人和审计日志。 最终结果与效果 错误变更被恢复到正确版本，系统保留原版本和回滚动作，不会删除历史记录。 操作提示： 回滚不是删除历史；涉及已发布模型时，还需同步检查下游数据集和看板。 开发人员参考 接口： GET /bi/bm/projects/{projectId}/versions、 .../audits、 .../export 权限： bi:bm:view、 bi:bm:project:export 快照包含 SHA-256 摘要；审计记录禁止在前端修改或删除。 业务链路 功能定位 业务链路把业务过程、指标、维度和数据对象连接成可阅读的关系图，帮助分析团队理解业务事件之间的上下游关系和数据影响范围。 图 6-9　业务链路节点、关系和发布状态 适用角色 业务架构师、数据架构师和高级分析师。 页面入口 业务建模中心 → 业务链路（ /bi/bm/chain）。 操作步骤 选择项目并新建业务链路，填写名称和说明。 从左侧添加业务过程、指标、维度等节点，拖动调整布局。 连接节点并填写关系说明，确保方向与业务含义一致。 保存草稿，检查孤立节点、重复关系和循环依赖。 提交审核；审核通过后发布不可变版本。 变更时创建新修订，必要时回滚到历史版本。 输入与输出 输入是节点、边和业务说明；输出是可审核、可发布的业务关系图和版本快照。 宏澜家电示例 以“销售订单”为中心连接客户、产品、区域、渠道和订单金额，再向下连接发货、开票和回款，形成从订单到现金的业务链路，便于分析收入确认和应收风险。 客户应用演示：梳理“订单到回款”业务链路 业务情境： 销售、财务和库存团队需要看清订单、发货、开票、回款之间的依赖。 第一步：进入“业务建模中心 → 业务链路” 步骤图 31-01　第1步：进入“业务建模中心 → 业务链路”。红框标出进入业务建模中心 → 业务链路。 进入“业务建模中心 → 业务链路”，新建“订单到回款”链路。 第二步：添加订单、出库、开票、应收和回款节点 步骤图 31-02　第2步：添加订单、出库、开票、应收和回款节点。红框标出添加订单、出库、开票、应收和回款节点。 添加订单、出库、开票、应收和回款节点，选择对应业务过程。 第三步：按实际业务顺序连接节点 步骤图 31-03　第3步：按实际业务顺序连接节点。红框标出按实际业务顺序连接节点。 按实际业务顺序连接节点，标注关键指标、来源表和责任人。 第四步：检查是否存在孤立节点、循环依赖或缺失来源 步骤图 31-04　第4步：检查是否存在孤立节点、循环依赖或缺失来源。红框标出检查是否存在孤立节点、循环依赖或缺失来源。 检查是否存在孤立节点、循环依赖或缺失来源。 第五步：保存链路并提交审核 步骤图 31-05　第5步：保存链路并提交审核。红框标出保存链路并提交审核。 保存链路并提交审核，在版本记录中查看审批结果。 最终结果与效果 业务链路以可视化方式呈现跨部门数据关系，可点击节点查看指标、来源和下游影响。 操作提示： 链路应表达业务事实，不要把组织结构图误当数据链路。 开发人员参考 接口： /bi/bm/projects/{projectId}/chains、 .../submit、 .../review、 .../publish、 .../rollback 权限： bi:bm:chain:edit、 bi:bm:chain:submit、 bi:bm:dict:review 链路发布生成版本快照；节点和边均做项目范围校验。 AI 建模助手 功能定位 AI 建模助手根据业务描述和受控数据目录生成业务对象、指标、维度或模型候选草稿。AI 只生成候选，不直接写入正式字典或发布资产。 图 6-10　场景选择、范围限定与候选草稿 适用角色 数据架构师、建模人员和业务分析专家。 页面入口 业务建模中心 → AI 建模助手（ /bi/bm/ai）。 操作步骤 选择可编辑的建模项目。 选择生成场景，限定业务域、对象编码范围和来源表。 用自然语言描述建模目标，例如“生成订单金额、订单数和客单价指标，说明口径并关联已有维度”。 点击生成，查看草稿编号、候选数量、请求模型、实际模型、耗时和 Prompt 版本。 打开草稿逐项检查；可接受单个候选项或接受全部通过校验的候选。 拒绝不合适候选并填写原因；修订后重新校验。 接受的候选仍进入业务字典草稿流程，必须提交审核后才能用于正式模型。 输入与输出 输入是项目、场景、来源表和业务需求；输出是结构化候选草稿、校验问题和接受/拒绝记录。 宏澜家电示例 输入“围绕销售订单生成成交金额、订单数、客单价和折扣率指标，关联时间、区域、渠道和产品维度”，AI 生成指标候选；建模人员修正“客单价”的取消订单规则后接受并提交审核。 安全边界 服务端对 AI 输入和输出做字段白名单与 SQL 安全检查。 AI 不能读取未授权表，也不能绕过审核直接发布。 草稿中记录实际模型和 Prompt 版本，便于复现和审计。 客户应用演示：让 AI 起草“销售订单事实模型” 业务情境： 建模人员希望根据订单、客户和产品表快速生成模型草稿。 第一步：进入“业务建模中心 → AI建模助手” 步骤图 32-01　第1步：进入“业务建模中心 → AI建模助手”。红框标出进入业务建模中心 → AI建模助手。 进入“业务建模中心 → AI建模助手”，选择销售业务域和 1—3 张来源表。 第二步：输入“以订单明细为粒度 步骤图 32-02　第2步：输入“以订单明细为粒度。红框标出输入以订单明细为粒度。 输入“以订单明细为粒度，生成销售事实模型，包含订单金额、数量、折扣额和毛利额”。 第三步：查看候选字段、主键、度量、维度和关系 步骤图 32-03　第3步：查看候选字段、主键、度量、维度和关系。红框标出查看候选字段、主键、度量、维度和关系。 查看候选字段、主键、度量、维度和关系，检查字段映射。 第四步：将草稿保存到当前项目 步骤图 32-04　第4步：将草稿保存到当前项目。红框标出将草稿保存到当前项目。 将草稿保存到当前项目，并补充业务说明和负责人。 第五步：提交审核 步骤图 32-05　第5步：提交审核。红框标出提交审核。 提交审核；审核通过后再进入模型设计继续完善。 最终结果与效果 生成可编辑的模型草稿，字段和关系以结构化形式展示；草稿不会自动发布或执行。 操作提示： 一次限定 1—3 张来源表能提高准确性；AI 生成的字段必须人工复核。 开发人员参考 接口： /bi/bm/ai/status、 /bi/bm/projects/{projectId}/ai/drafts、 .../accept、 .../reject 权限： bi:bm:ai:use、 bi:bm:ai:accept 输出经过结构校验和业务一致性校验；生成内容不自动执行。 模型设计 功能定位 模型设计把已审核的指标、维度和来源表组合为事实模型、维度模型或桥接模型，并编译为 dbt/Doris 可执行的模型定义。 图 6-11　模型字段、度量、关系和编译结果 适用角色 数据模型工程师、数据架构师和 BI 管理员。 页面入口 业务建模中心 → 模型设计（ /bi/bm/model）。 操作步骤 选择项目，点击“新建模型”，填写以 MODEL_ 开头的编码、名称和类型。 事实模型必须填写事实粒度，例如“一行一个销售订单明细”。 选择来源表，配置字段角色：主键、维度、度量、属性或时间。 为度量设置聚合方式和聚合字段；为维度模型配置主键和属性。 事实模型可添加指向同项目 DIM 模型的关系，选择关系类型和关联字段。 查看“编译结果”中的 SQL/DDL、依赖和校验问题。 保存草稿、提交审核；审核通过后生成不可变版本。 在发布中心选择审核版本，沿固定发布链登记到数据平台。 输入与输出 输入是来源表、字段映射、度量、关系和模型类型；输出是可审核的模型定义、编译结果和版本快照。 客户应用演示：创建“宏澜销售订单事实模型” 业务情境： 已审核的销售额、毛利额和维度需要组合成可发布的事实模型。 第一步：进入“业务建模中心 → 模型设计” 步骤图 33-01　第1步：进入“业务建模中心 → 模型设计”。红框标出进入业务建模中心 → 模型设计。 进入“业务建模中心 → 模型设计”，选择销售项目，新建模型。 第二步：填写 MODEL_SALES_ORDER_FACT 步骤图 33-02　第2步：填写 MODEL_SALES_ORDER_FACT。红框标出填写 MODEL_SALES_ORDER_FACT。 填写 MODEL_SALES_ORDER_FACT，选择事实模型，粒度设为“一行一个订单明细”。 第三步：选择订单来源表 步骤图 33-03　第3步：选择订单来源表。红框标出选择订单来源表。 选择订单来源表，配置订单号、客户、产品、组织、日期和金额字段角色。 第四步：为销售额、数量、折扣额、毛利额设置聚合方式和字段 步骤图 33-04　第4步：为销售额、数量、折扣额、毛利额设置聚合方式和字段。红框标出为销售额、数量、折扣额、毛利额设置聚合方式和字段。 为销售额、数量、折扣额、毛利额设置聚合方式和字段。 第五步：关联同项目的产品、客户、组织和日期维度模型 步骤图 33-05　第5步：关联同项目的产品、客户、组织和日期维度模型。红框标出关联同项目的产品、客户、组织和日期维度模型。 关联同项目的产品、客户、组织和日期维度模型。 第六步：查看编译结果 步骤图 33-06　第6步：查看编译结果。红框标出查看编译结果。 查看编译结果，修正字段或类型问题后保存并提交审核。 最终结果与效果 模型形成可审核的字段映射、度量、关系和编译结果；审核通过后生成不可变版本。 操作提示： 事实模型必须写清粒度；未经审核的维度模型不能作为关联目标。 当前演示环境说明 当前模型设计页显示 4 个已发布模型：宏澜销售订单事实模型、宏澜产品维度模型、宏澜客户维度模型和宏澜财务期间事实模型。 宏澜家电示例 “宏澜销售订单事实模型”以订单明细为粒度，包含订单金额、数量、折扣额和毛利额度量；关联产品、客户、组织和日期维度。模型审核后发布到 dbt、Doris、OpenMetadata 和 Superset。 常见问题 无法关联某个维度模型。 关系只能指向同项目且已审核通过的 DIM 模型。 编译提示字段不存在。 回到来源表和字段映射检查字段名、类型和来源表版本。 模型已修改但发布记录未变化。 发布只接受审核版本；修改后需重新提交审核。 开发人员参考 接口： /bi/bm/projects/{projectId}/models、 .../compile、 .../submit、 .../review、 .../versions 权限： bi:bm:model:edit、 bi:bm:model:submit、 bi:bm:model:review 模型编码格式为 MODEL_[A-Z0-9_]{2,56}；事实模型必须有粒度说明。 发布中心 功能定位 发布中心把审核通过的模型按固定顺序发布到数据平台：DBT 编译与模型执行 → Doris 表结构校验 → OpenMetadata 元数据采集 → DolphinScheduler 固定工作流 → Superset 数据集注册。 图 6-12　固定发布链、步骤结果与重试 适用角色 BI 管理员、数据平台管理员和发布审核人员。 页面入口 业务建模中心 → 发布中心（ /bi/bm/publish）。 操作步骤 点击“新建模型发布”，选择已审核或已发布模型。 选择审核版本，确认版本号、修订号和快照摘要。 查看固定发布链，录入发布摘要和摘要说明。 点击“开始发布”，系统按顺序执行各步骤并记录外部对象引用。 在详情中查看每一步的状态、结果、耗时和输入摘要。 失败时查看失败步骤和错误原因；修复环境后点击“重试”，重试会生成新的发布记录并保留来源关系。 发布成功后，Superset 数据集和 DolphinScheduler 工作流即可供后续分析使用。 输入与输出 项目 说明 输入 模型 ID、审核版本号、发布摘要 固定目标 DBT、Doris、OpenMetadata、DolphinScheduler、Superset 输出 发布记录、步骤日志、外部对象引用和可重试状态 幂等 使用 publishKey 和载荷摘要防止重复发布 客户应用演示：发布销售订单模型到分析平台 业务情境： 销售订单模型已审核通过，需要进入数据平台供数据集和看板使用。 第一步：进入“业务建模中心 → 发布中心” 步骤图 34-01　第1步：进入“业务建模中心 → 发布中心”。红框标出进入业务建模中心 → 发布中心。 进入“业务建模中心 → 发布中心”，点击“新建模型发布”。 第二步：选择销售订单模型和审核版本 步骤图 34-02　第2步：选择销售订单模型和审核版本。红框标出选择销售订单模型和审核版本。 选择销售订单模型和审核版本，核对版本号与快照摘要。 第三步：填写发布摘要 步骤图 34-03　第3步：填写发布摘要。红框标出填写发布摘要。 填写发布摘要，说明本次变更、影响范围和回滚方案。 第四步：点击“开始发布” 步骤图 34-04　第4步：点击“开始发布”。红框标出点击开始发布。 点击“开始发布”，依次查看 DBT、Doris、OpenMetadata、调度和 Superset 步骤。 第五步：全部成功后打开数据集或看板验证 步骤图 34-05　第5步：全部成功后打开数据集或看板验证。红框标出全部成功后打开数据集或看板验证。 全部成功后打开数据集或看板验证；失败时按步骤日志修复后重试。 最终结果与效果 模型按固定发布链完成登记，每一步都有状态、耗时和外部对象引用；失败重试会生成新记录并保留来源。 操作提示： 不要跳过审核直接发布；发布前确认下游看板负责人已知晓变更。 当前演示环境说明 当前页面显示上述 4 个模型均已成功发布。其他环境若出现步骤失败，应先修复依赖服务，再重试，不要修改历史发布记录。 宏澜家电示例 销售订单模型审核 v3 后，发布中心先生成 dbt SQL 并在 Doris 建表，再采集元数据、登记调度工作流，最后在 Superset 创建数据集。业务看板随后引用新数据集，旧版本保留可追溯。 开发人员参考 接口： /bi/bm/publish、 /bi/bm/publish/{id}、 .../retry 权限： bi:bm:publish 发布链固定且不可由前端替换；步骤引用和摘要记录在数据库中。 章节提示： 发布中心在业务上属于“模型交付”，因此保留在业务建模章节；菜单实际入口以当前系统为准。 数据治理中心 数脉平台用户手册 V2.0 · 数据治理中心 ETL 调度中心 功能定位 ETL 调度中心是数据治理流水线的“时间与依赖控制器”。它把数据同步、清洗加工、dbt 建模、质量校验和元数据刷新组织成有先后依赖的工作流，按日、周或手工触发，并保留每次运行的实例、日志和重试记录。数脉通过统一门户和安全免登录票据打开 DolphinScheduler，用户不需要再输入一套调度平台账号。 图 7-1　DolphinScheduler 集成诊断、版本与安全跳转入口 适用角色 ETL 管理员、数据平台运维人员、数据开发人员和值班人员。业务用户通常不直接进入调度中心，而是在大屏或报表中消费调度产出。 页面入口 数据治理中心 → ETL 调度中心（ /bi/etl/ds）。页面内嵌 DolphinScheduler 3.4.3。 前置条件 DolphinScheduler 服务健康，调度数据库和 Worker 正常。 当前账号已开通 ETL 调度中心访问权限，并完成平台账号与调度租户的映射。 后端已配置免登录交换地址和安全票据密钥。 目标工作流所需的 Doris、SeaTunnel、Hop、dbt 等执行环境可用。 操作步骤 从菜单进入后，页面先显示“集成状态提示”。绿色表示已连接，黄色或红色表示配置关闭、账号未映射或服务异常。 状态正常时，系统签发短时、一次性的访问票据并自动打开 DolphinScheduler。 在工作流定义中按项目查看已有 DAG；不要把生产工作流直接改成临时试验版本。 打开“工作流实例”查看运行状态、开始结束时间、耗时和失败节点。 失败时先看任务日志定位原因；修复数据、依赖或环境后，再执行“重跑”或“补数”。 需要临时验证时使用手工运行，并在运行说明中写明业务原因、影响范围和期望完成时间。 完成后回到数脉的元数据、质量或发布页面核对产出，不要仅以“调度成功”判断数据正确。 输入与输出 项目 说明 输入 工作流定义、调度周期、依赖关系、运行参数、补数日期 输出 工作流实例、任务实例、运行日志、产出表和状态回写 失败处理 定位失败节点后重试；涉及重复写入时必须依赖幂等键或批次号 宏澜家电示例 每天 02:00 启动“销售订单全链路”：先同步 ERP 订单到 ODS，再清洗为 DWD，汇总区域与品类 DWS，执行 dbt 质量测试，刷新元数据，最后登记 Superset 数据集刷新。若 02:10 发现 ERP 连接超时，值班人员先确认源库恢复，再对同步节点补跑；下游任务依赖未满足时不会提前执行。 客户应用演示：检查每日销售同步工作流 业务情境： 值班人员早上发现经营看板未刷新，需要检查 02:00 的调度实例。 第一步：进入“数据治理中心 → ETL 调度中心” 步骤图 35-01　第1步：进入“数据治理中心 → ETL 调度中心”。红框标出进入数据治理中心 → ETL 调度中心。 进入“数据治理中心 → ETL 调度中心”，查看集成状态和诊断信息。 第二步：打开“工作流实例” 步骤图 35-02　第2步：打开“工作流实例”。红框标出打开工作流实例。 打开“工作流实例”，定位当天销售全链路实例。 第三步：查看开始时间、结束时间、耗时和失败节点 步骤图 35-03　第3步：查看开始时间、结束时间、耗时和失败节点。红框标出查看开始时间、结束时间、耗时和失败节点。 查看开始时间、结束时间、耗时和失败节点。 第四步：打开失败任务日志 步骤图 35-04　第4步：打开失败任务日志。红框标出打开失败任务日志。 打开失败任务日志，区分源库连接、权限、数据质量或下游依赖问题。 第五步：修复原因后按依赖顺序补跑 步骤图 35-05　第5步：修复原因后按依赖顺序补跑。红框标出修复原因后按依赖顺序补跑。 修复原因后按依赖顺序补跑，并回到看板核对数据更新时间。 最终结果与效果 能够定位失败节点和影响范围，补跑后看板恢复更新；历史和重试记录均可追溯。 操作提示： 当前演示环境可能显示 DISABLED，表示入口已实现但外部调度集成未启用，不是菜单损坏。 当前演示环境说明 截图中页面显示“DolphinScheduler 集成已停用”，诊断码为 DISABLED。这表示页面和免登录通道已经实现，但当前运行配置主动关闭了该集成，并非页面链接失效。启用方法由部署管理员在环境配置中完成，普通用户无需修改浏览器地址。 常见问题 一直停在“正在校验权限并签发安全访问票据”。 检查后端、调度服务和账号映射；票据通常只有几十秒有效，超时后点击“重新检测并打开”。 提示账号未开通。 平台账号还没有映射到调度租户，联系 ETL 管理员开通。 调度成功但报表没有新数据。 依次检查产出表行数、批次时间、质量规则和数据集刷新，不要只重复点击重跑。 开发人员参考 页面： ui/src/views/bi/dolphinscheduler/index.vue 接口： GET /bi/dolphinscheduler/status、 GET /bi/dolphinscheduler/launch、 GET /bi/dolphinscheduler/exchange 权限： bi:etl:ds 门户只传递一次性票据，调度服务账号和密码不会发送到浏览器。 iframe 使用受限 sandbox、 referrerpolicy=no-referrer，并设置加载超时和错误诊断码。 数据同步 功能定位 数据同步把 ERP、业务库或文件等源数据按白名单配置抽取到 Doris 的 ODS 层。它解决“数据如何稳定进入平台”的问题，重点不是写复杂 SQL，而是把源表、目标表、全量或增量模式、批次、重试和运行记录管理清楚。 图 7-2　白名单源表到 Doris 的受控同步 适用角色 ETL 管理员、数据开发人员和数据运维人员。 页面入口 数据治理中心 → 数据同步（ /bi/etl/seatunnel）。 页面结构与关键字段 区域 作用 集成状态 显示数据同步集成、MySQL 源库、Doris ODS、内部令牌和 ETL 调度是否可用 同步作业 展示作业名称、同步链路、模式、最近运行和操作 运行实例 展示批次号、作业、模式、状态、读写行数、尝试次数和创建时间 操作 全量执行、增量执行、运行记录、重试 操作步骤 确认状态栏中的源库、Doris ODS 和调度服务均为可用；任何一项异常都先处理环境。 点击“新建作业”，选择服务端白名单中的源表和目标 ODS 表。页面不允许手工输入任意库表。 选择同步模式：首次接入或需要重建时使用全量；日常增量按时间戳、主键或批次水位同步。 保存后先执行一次小范围验证，检查读取行数、写入行数和抽样数据。 在“运行实例”中按批次号跟踪；重试应沿用原批次号，避免产生重复订单或重复库存。 核对 Doris 目标表行数、主键唯一性和最新时间，再通知下游加工。 输入与输出 输入是源表、目标表、同步模式、字段映射和批次参数；输出是 ODS 表数据、批次记录、读写行数和运行状态。 宏澜家电示例 将 ERP 的 sales_order 和 sales_order_detail 同步到 ods_sales_order 与 ods_sales_order_detail。首次全量 18 万行，之后每小时按更新时间增量。某次网络中断后重试保持同一批次号，Doris 幂等覆盖，没有产生重复订单。 客户应用演示：把 ERP 销售订单同步到 ODS 业务情境： 需要首次同步宏澜 ERP 的销售订单、客户和产品表。 第一步：进入“数据治理中心 → 数据同步” 步骤图 36-01　第1步：进入“数据治理中心 → 数据同步”。红框标出进入数据治理中心 → 数据同步。 进入“数据治理中心 → 数据同步”，新建同步作业。 第二步：按白名单选择源表和 Doris ODS 目标表 步骤图 36-02　第2步：按白名单选择源表和 Doris ODS 目标表。红框标出按白名单选择源表和 Doris ODS 目标表。 按白名单选择源表和 Doris ODS 目标表，设置全量或增量模式。 第三步：配置批次号、字段映射、失败重试和运行超时 步骤图 36-03　第3步：配置批次号、字段映射、失败重试和运行超时。红框标出配置批次号、字段映射、失败重试和运行超时。 配置批次号、字段映射、失败重试和运行超时。 第四步：先手工运行一次 步骤图 36-04　第4步：先手工运行一次。红框标出先手工运行一次。 先手工运行一次，检查同步行数、主键重复和目标表数据。 第五步：核对无误后启用周期任务 步骤图 36-05　第5步：核对无误后启用周期任务。红框标出核对无误后启用周期任务。 核对无误后启用周期任务，并在运行记录中查看批次和状态。 最终结果与效果 源表数据进入 ODS，页面显示批次号、行数、耗时和运行状态；重复执行不会重复新增订单。 操作提示： 同步只负责搬运，不负责业务汇总；字段清洗应在数据加工层完成。 当前演示环境说明 截图中的页面提示“数据同步集成已关闭”，源库连接失败、Doris ODS 连接失败、ETL 调度不可用。该状态用于说明诊断信息如何呈现，部署环境启用后才会出现可执行的同步任务。 常见问题 执行按钮不可用。 作业可能已停用，或当前环境关闭了同步集成。 读取行数正常但写入为 0。 检查字段类型、目标表主键、Doris 分区和写入权限。 重试后数据翻倍。 说明目标表没有正确使用批次幂等键；停止继续重试并联系数据开发核查。 开发人员参考 接口： GET /bi/etl/status、 GET/POST /bi/etl/jobs、 POST /bi/etl/jobs/{jobId}/runs、 POST /bi/etl/runs/{runId}/retry 权限： bi:etl:seatunnel 源表、目标表和字段映射由服务端白名单约束；执行过程使用内部令牌调用 SeaTunnel。 运行记录保存批次号、模式、读写行数、尝试次数和错误摘要，不在前端暴露连接口令。 数据加工 功能定位 数据加工负责把 ODS 原始数据清洗、标准化并逐层加工为 DWD 明细、DWS 汇总和 ADS 应用表。数脉使用 Hop 2.19.0 承载固定加工管线，并把管线版本、运行记录、Doris 产物预览和 DolphinScheduler 调度串在一起。 图 7-3　DWD → DWS → ADS 分层产物与集成状态 适用角色 数据开发人员、ETL 管理员、数仓建模人员和数据运维人员。 页面入口 数据治理中心 → 数据加工（ /bi/etl/hop）。 页面结构 页签/区域 说明 数据加工工作台 打开 Hop Web 工作台，查看或设计转换流程 加工管线 展示管线名称、分层、目标表、生效版本、最近运行和目标行数 运行记录 展示运行号、管线、版本、触发方式、状态、耗时和错误摘要 产物预览 按分层查看 Doris 目标表的样例行、字段和统计 顶部操作 执行全链路、同步用户部门、DS 调度、刷新、全屏 操作步骤 先确认容器运行、Web 服务、执行器、Doris 目标表、内部令牌和 DS 调度状态。 在“加工管线”中确认 ODS→DWD、DWD→DWS、DWS→ADS 的链路顺序和目标表。 点击“执行全链路”前，确认上游 ODS 批次已完成，避免加工空数据。 查看“运行记录”，逐个核对每个管线的读取行数、写入行数、耗时和失败原因。 在“产物预览”检查主键唯一性、金额非负、日期范围、维度关联和汇总口径。 需要每日自动运行时，通过“DS 调度”登记固定工作流；不要在页面上设置任意 Cron 表达式。 调整管线后发布新版本并激活，保留旧版本以便回滚。 输入与输出 输入是 ODS/DWD/DWS 表、字段映射、清洗规则和管线版本；输出是 DWD 明细、DWS 汇总、ADS 应用表及运行记录。 宏澜家电示例 订单清洗管线过滤取消订单、补齐客户与产品维度、统一金额单位并写入 DWD。按区域和品类汇总后形成 DWS 销售日汇总，再生成 ADS 部门销售应用表。若 DWD 行数比 ODS 少 2%，先检查取消订单和异常过滤规则是否符合口径，而不是直接补行。 客户应用演示：把 ODS 订单加工为 DWD 明细 业务情境： ODS 中订单包含取消、测试和重复数据，需要清洗后进入 DWD。 第一步：进入“数据治理中心 → 数据加工” 步骤图 37-01　第1步：进入“数据治理中心 → 数据加工”。红框标出进入数据治理中心 → 数据加工。 进入“数据治理中心 → 数据加工”，选择 ODS → DWD 加工模板。 第二步：配置订单表、客户表和产品表的关联字段与过滤条件 步骤图 37-02　第2步：配置订单表、客户表和产品表的关联字段与过滤条件。红框标出配置订单表、客户表和产品表的关联字段与过滤条件。 配置订单表、客户表和产品表的关联字段与过滤条件。 第三步：处理取消订单、重复订单、空客户、金额格式和日期标准化 步骤图 37-03　第3步：处理取消订单、重复订单、空客户、金额格式和日期标准化。红框标出处理取消订单、重复订单、空客户、金额格式和日期标准化。 处理取消订单、重复订单、空客户、金额格式和日期标准化。 第四步：点击预览 步骤图 37-04　第4步：点击预览。红框标出点击预览。 点击预览，检查输入行数、输出行数和关键字段样例。 第五步：保存并运行 步骤图 37-05　第5步：保存并运行。红框标出保存并运行。 保存并运行，确认 DWD 产物可被 DWS/ADS 继续加工。 最终结果与效果 形成干净、结构化、可追溯的 DWD 订单明细，运行记录保留输入输出行数和批次。 操作提示： 加工前先确认业务规则，尤其是取消、退货和折扣的含义。 当前演示环境说明 截图显示 Hop 集成处于 DISABLED，容器、Web 服务、执行器和 Doris 目标表状态异常。页面仍展示固定的分层链路和安全边界，用于说明启用后的操作路径。 常见问题 全链路执行后中间层有数、应用层为空。 检查 DWS/ADS 的日期分区、汇总维度和调度依赖。 Doris 目标表找不到。 先完成模型发布或建表，再执行加工；不要在 Hop 中临时创建任意表。 运行成功但金额异常。 检查币种、含税/未税、折扣和退货口径，运行成功不代表业务口径正确。 开发人员参考 接口： /bi/etl/hop/status、 /launch、 /pipelines、 /pipelines/{id}/versions、 /runs/chain、 /schedule、 /preview 权限： bi:etl:hop 管线目标表与文件路径由服务端白名单固定；版本发布、激活、运行和回滚均有独立记录。 Hop 账号凭据不进入浏览器，使用一次性票据交换受限会话。 外部数据源 功能定位 外部数据源用于接入不适合直接连库的第三方系统，例如电商平台、企业微信、开放 API、SaaS 订单接口。系统通过受控 HTTP 出口读取分页或游标数据，写入指定 Doris 目标表，并记录批次、重试、审计和脱敏原因。 图 7-4　外部源配置、同步作业、运行实例与安全审计 适用角色 ETL 管理员、集成开发人员、数据运维人员和审计人员。 页面入口 数据治理中心 → 外部数据源（ /bi/etl/external）。 页面结构 页签 作用 外部源 源名称、类型、接口地址、目标表、鉴权方式、状态和编辑入口 同步作业 作业名称、外部源、全量/增量模式、自动重试和最近运行 运行实例 批次号、作业、状态、读写行数、DS 实例和重试 安全审计 事件、结果、操作人、脱敏原因和来源 IP 操作步骤 点击“新建外部源”，选择模板：通用 REST 分页、企业微信游标或开放 API。 填写源名称、接口地址、请求方法、目标表和分页参数；接口地址只允许服务端出口白名单中的域名。 选择鉴权方式（如 HEADER 或 QUERY），凭据使用 env: 或文件引用，页面只显示“已配置”，不回显明文。 保存后测试连通性，确认返回结构、分页字段、游标路径和错误码。 新建同步作业，设置全量或增量、最大重试次数和启停状态。 执行后查看运行实例的读取行数、写入行数和失败原因；重试保持批次号。 在安全审计中核对每次配置、执行和脱敏事件。 输入与输出 输入是接口地址、鉴权引用、分页规则、字段映射和目标表；输出是写入 Doris 的外部数据、批次记录、审计事件和脱敏摘要。 宏澜家电示例 接入某电商平台的订单接口：使用 REST 分页，按更新时间增量拉取，订单号作为幂等键写入 ods_ecommerce_order。凭据由环境变量注入，页面只显示“HEADER 已配置”。若平台限流，作业按指数退避重试并保留原批次号。 客户应用演示：接入宏澜 ERP 只读数据库 业务情境： 数据管理员需要把外部 ERP 作为后续同步和建模的数据源。 第一步：进入“数据治理中心 → 外部数据源” 步骤图 38-01　第1步：进入“数据治理中心 → 外部数据源”。红框标出进入数据治理中心 → 外部数据源。 进入“数据治理中心 → 外部数据源”，点击新增。 第二步：填写数据源名称、类型、主机、端口和库名 步骤图 38-02　第2步：填写数据源名称、类型、主机、端口和库名。红框标出填写数据源名称、类型、主机、端口和库名。 填写数据源名称、类型、主机、端口和库名。 第三步：凭据使用环境变量或密钥文件引用 步骤图 38-03　第3步：凭据使用环境变量或密钥文件引用。红框标出凭据使用环境变量或密钥文件引用。 凭据使用环境变量或密钥文件引用，不填写明文到页面说明中。 第四步：测试连接并读取表清单 步骤图 38-04　第4步：测试连接并读取表清单。红框标出测试连接并读取表清单。 测试连接并读取表清单，确认只读账号权限边界。 第五步：保存后执行一次连接诊断 步骤图 38-05　第5步：保存后执行一次连接诊断。红框标出保存后执行一次连接诊断。 保存后执行一次连接诊断，并把数据源负责人和用途登记完整。 最终结果与效果 外部数据源登记成功，后续同步作业可按白名单引用；页面不回显密码，操作进入审计日志。 操作提示： 连接失败先检查网络白名单、账号权限和密钥引用；不要把真实连接串写入文档。 当前演示环境说明 截图显示“外部数据源集成已关闭”，接口地址已脱敏，白名单为 0 个域名。该页面展示配置结构和审计方式；实际调用前必须由管理员开启集成并配置允许访问的域名。 安全边界 禁止接入任意公网地址，禁止通过页面探测内网服务。 凭据只保存引用，不返回明文；日志和审计不得记录 Token、Cookie 或完整响应。 目标表必须在白名单内，字段映射必须显式声明。 删除数据源前先停用作业并确认历史批次和下游依赖。 常见问题 保存时提示域名不在白名单。 由管理员在服务端出口策略中登记域名，不要在页面反复换写法绕过。 运行成功但字段为空。 检查 JSON 路径、分页游标和字段映射，先用小页数验证。 凭据显示“未配置”。 环境变量或文件引用没有加载，需管理员检查部署配置，不要把密钥直接填到浏览器。 开发人员参考 接口： /bi/ext/sources、 /jobs、 /runs、 /audits、 /options、 /status 权限： bi:etl:ext 使用受控出口网关，服务端校验目标域名、请求方法、响应大小和字段白名单。 审计只保存事件、结果和脱敏原因；凭据引用不写入数据库明文。 元数据管理 功能定位 元数据管理把 Doris 表、字段、中文注释、dbt 模型、质量结果和上下游血缘集中到一个可检索目录。它回答三个问题：平台上有什么数据、字段是什么意思、这个指标从哪里来又流向哪里。 图 7-5　治理通道诊断、Doris 元数据目录与字段血缘入口 适用角色 数据架构师、数据管理员、指标管理员、开发人员和审计人员。 页面入口 数据治理中心 → 元数据管理（ /bi/etl/metadata）。 页面结构 区域 说明 治理通道诊断 元数据服务、OM 授权、dbt 环境、dbt 产物、Doris 采集、质量同步、ETL 调度服务 元数据目录 仅展示服务端白名单 Schema，可搜索表名或注释 字段与注释 查看字段类型、中文名、描述、敏感级别和是否可用于分析 数据血缘 查看表级和字段级上下游关系 dbt 模型 查看模型、依赖、最近运行和质量结果 质量与运行 查看质量测试、运行状态和失败原因 调度实例 查看与元数据刷新相关的工作流实例 操作步骤 先查看治理通道诊断。红色状态表示该能力不可用，需管理员处理。 在元数据目录选择 Schema，输入表名或中文注释查询。 点击“字段”查看字段清单、类型和注释，确认口径后再用于建模或分析。 点击“血缘”查看上游来源、下游模型和看板引用，评估变更影响。 需要更新目录时，由管理员执行“元数据采集”，选择 Doris、dbt、质量结果或全量刷新。 需要验证 dbt 时，使用“dbt 命令”执行 debug、run、test 或 docs generate。 需要周期性刷新时，通过“执行受控调度”登记固定工作流，并核对调度实例结果。 输入与输出 输入是 Doris Schema、dbt manifest、质量结果和调度状态；输出是可搜索目录、字段注释、血缘图、dbt 模型清单和采集任务记录。 宏澜家电示例 分析师发现“区域销售额”与财务口径不一致，在元数据管理中打开 ads_dept_sales_daily 的血缘：上游是 dws_sales_category_summary 和 dwd_sales_order_clean，再向上到 ERP 订单表。通过字段注释确认“净销售额”已扣除退货，从而定位差异来自财务使用含税收入口径。 客户应用演示：追踪“销售额”字段的来源与影响 业务情境： 业务人员质疑销售额口径，需要确认字段来自哪里、被哪些资产使用。 第一步：进入“数据治理中心 → 元数据管理” 步骤图 39-01　第1步：进入“数据治理中心 → 元数据管理”。红框标出进入数据治理中心 → 元数据管理。 进入“数据治理中心 → 元数据管理”，搜索销售额字段。 第二步：打开字段详情 步骤图 39-02　第2步：打开字段详情。红框标出打开字段详情。 打开字段详情，查看所属表、数据类型、注释和负责人。 第三步：沿上游查看 ODS 源表、DWD 清洗字段和 DWS 汇总字段 步骤图 39-03　第3步：沿上游查看 ODS 源表、DWD 清洗字段和 DWS 汇总字段。红框标出沿上游查看 ODS 源表、DWD 清洗字段和 DWS 汇总字段。 沿上游查看 ODS 源表、DWD 清洗字段和 DWS 汇总字段。 第四步：沿下游查看数据集、图表、看板和报表引用 步骤图 39-04　第4步：沿下游查看数据集、图表、看板和报表引用。红框标出沿下游查看数据集、图表、看板和报表引用。 沿下游查看数据集、图表、看板和报表引用。 第五步：记录血缘路径和影响范围 步骤图 39-05　第5步：记录血缘路径和影响范围。红框标出记录血缘路径和影响范围。 记录血缘路径和影响范围，如需修改先通知下游负责人。 最终结果与效果 页面显示字段的上游来源、处理过程和下游资产，能够判断一次口径变更会影响哪些报表。 操作提示： 血缘用于定位影响，不替代数据质量校验；修改前仍要抽样对账。 当前演示环境说明 截图显示元数据服务离线、OM 授权未通过、dbt 环境异常、dbt 产物缺失、Doris 采集已同步、质量同步为 0 项、ETL 调度可用。页面同时展示 27 张白名单表。该状态用于演示诊断，不能据此认定生产血缘完整。 常见问题 搜不到表。 可能不在白名单 Schema，或尚未执行元数据采集。 血缘图只有表、没有字段。 需要 dbt manifest 和字段级依赖解析；先检查 dbt 产物是否生成。 表注释为空。 在模型或建表阶段补充 COMMENT，再重新采集，不要只在前端手工改显示。 开发人员参考 接口： /bi/metadata/status、 /catalog、 /table、 /lineage、 /dbt/models、 /dbt/runs、 /ingest、 /schedule 权限： bi:metadata:view，采集、dbt 和调度为独立细粒度权限。 仅允许白名单 Schema；采集任务异步执行并记录输入摘要、结果和错误码。 血缘来自 dbt manifest、Doris 元数据和登记关系的组合，不靠前端猜测。 AI 同步生成器 功能定位 AI 同步生成器根据白名单源表、字段注释和业务描述，生成 SeaTunnel 同步候选配置。它把“从哪张表同步到哪张 ODS 表、保留哪些字段、按什么方式增量”写成结构化候选，但不会自动执行。 图 7-6　自然语言输入、候选草稿与源字段说明 适用角色 ETL 管理员、集成开发人员和数据开发人员。 页面入口 数据治理中心 → AI 数据助手 → AI 同步生成器（ /bi/etl/ai/sync）。 前置条件 AI 服务正常，当前演示环境使用 DeepSeek-V4.1-Flash。 目标源表在服务端白名单内，并已完成元数据采集。 DolphinScheduler 登记通道可用，当前账号有 AI 流水线权限。 操作步骤 选择服务端模板，例如“销售订单全量同步”。 选择白名单源表，页面会加载字段名、类型和中文注释。 填写方案标题和业务描述。描述应说明同步频率、目标 Schema、需要保留的字段和过滤条件。 点击“AI 生成候选流水线”，等待返回草稿编号、模型名和候选内容。 在“结构化预览”检查源表、目标表、字段映射、主键和增量策略；必要时切换“JSON 编辑”修正白名单内字段。 点击“确定性校验”，处理阻断错误和告警。 提交人工审核，审核通过后绑定内容摘要；最后“登记发布”到 DolphinScheduler 门禁。 发布后仍需按正常同步流程执行和核对数据。 输入与输出 项目 说明 输入 模板、白名单源表、方案标题、最多 1200 字业务描述 输出 同步候选草稿、字段映射、校验结果、审核记录、版本和发布摘要 状态 待校验、已校验、已审核、已发布、已驳回 宏澜家电示例 业务描述：“每天 02:00 把销售订单增量同步到 Doris ODS，保留订单金额、状态、客户、产品和更新时间，已取消订单也保留以便审计。”AI 生成订单源表到 ods_sales_order 的候选映射；数据开发补充增量字段后校验、审核并登记调度。 客户应用演示：让 AI 起草订单同步作业 业务情境： 数据开发需要新增订单同步，但希望先生成标准配置草稿。 第一步：进入“数据治理中心 → AI数据助手 → AI 同步生成器” 步骤图 40-01　第1步：进入“数据治理中心 → AI数据助手 → AI 同步生成器”。红框标出进入数据治理中心 → AI数据助手 → AI 同步生成器。 进入“数据治理中心 → AI数据助手 → AI 同步生成器”。 第二步：选择订单源表和目标 ODS 表 步骤图 40-02　第2步：选择订单源表和目标 ODS 表。红框标出选择订单源表和目标 ODS 表。 选择订单源表和目标 ODS 表，填写同步频率、增量字段和业务说明。 第三步：点击生成 步骤图 40-03　第3步：点击生成。红框标出点击生成。 点击生成，查看源字段、目标字段、过滤条件和安全边界。 第四步：执行确定性校验 步骤图 40-04　第4步：执行确定性校验。红框标出执行确定性校验。 执行确定性校验，修正字段类型、主键和白名单问题。 第五步：保存为草稿并提交审核 步骤图 40-05　第5步：保存为草稿并提交审核。红框标出保存为草稿并提交审核。 保存为草稿并提交审核；审核发布后才交给调度执行。 最终结果与效果 生成符合固定模板的同步草稿，包含字段映射、批次和安全配置；不会自动执行或改写生产数据。 操作提示： AI 草稿必须经过校验和人工审核；不要用自然语言要求绕过白名单。 常见问题 生成失败或超时。 检查 AI 服务状态、描述长度和源表字段；不要重复提交十几次，先看页面错误信息。 选择不到源表。 表不在白名单或元数据未采集。 修改 JSON 后不能发布。 修改会重置校验和审核，必须重新校验、重新审核。 开发人员参考 接口： /bi/ai-pipeline/status、 /options?kind=SYNC、 /generate、 /drafts、 /drafts/{id}/validate|review|publish 权限： bi:etl:ai-sync 大模型只能选择模板和字段，不能生成任意连接串或执行任意组件。 发布只登记固定摘要门禁，不直接执行模型产物；内容 SHA-256 与审核记录绑定。 AI 加工设计器 功能定位 AI 加工设计器把业务描述转换成 Hop 转换候选流程和依赖 DAG，例如过滤取消订单、补齐部门信息、统一金额单位、按订单日期排序后写入 DWD。服务端固定可用组件、字段范围和写入边界，AI 不直接获得数据库写权限。 图 7-7　Hop 加工候选草稿与固定安全边界 适用角色 数据开发人员、数仓工程师和 ETL 管理员。 页面入口 数据治理中心 → AI 数据助手 → AI 加工设计器（ /bi/etl/ai/hop）。 操作步骤 选择加工模板，例如“DWD 订单清洗”。 选择白名单 ODS 源表，查看字段与中文注释。 描述清洗目标：保留哪些字段、过滤什么状态、如何补维度、写入哪张 DWD 表。 生成候选流水线，在结构化预览中检查输入、转换、输出和字段映射。 在“DAG 编排”查看节点和依赖边，确认没有孤立节点、循环依赖或错误方向。 执行确定性校验，修正字段类型、空值、主键和写入范围问题。 提交人工审核并登记发布；发布后由调度执行，不在页面直接运行模型产物。 输入与输出 输入是 ODS 源表、业务描述和加工模板；输出是 Hop 候选流程、字段映射、DAG、校验结果、审核版本和调度门禁。 宏澜家电示例 输入“过滤已取消订单，补客户和产品维度，金额统一为元，按订单日期写入 dwd_sales_order_clean”。AI 生成过滤、查找维度、字段重命名和写入节点；开发人员发现退货订单不应直接删除后，增加状态字段并调整过滤条件，再重新校验审核。 客户应用演示：让 AI 起草 ODS→DWD 清洗逻辑 业务情境： 订单数据需要清洗取消订单、重复订单和空客户后再进入 DWD。 第一步：进入“数据治理中心 → AI数据助手 → AI 加工设计器” 步骤图 41-01　第1步：进入“数据治理中心 → AI数据助手 → AI 加工设计器”。红框标出进入数据治理中心 → AI数据助手 → AI 加工设计器。 进入“数据治理中心 → AI数据助手 → AI 加工设计器”。 第二步：选择 ODS 订单表和 DWD 目标表 步骤图 41-02　第2步：选择 ODS 订单表和 DWD 目标表。红框标出选择 ODS 订单表和 DWD 目标表。 选择 ODS 订单表和 DWD 目标表，描述清洗规则与输出字段。 第三步：生成候选加工草稿 步骤图 41-03　第3步：生成候选加工草稿。红框标出生成候选加工草稿。 生成候选加工草稿，查看过滤、关联、字段映射和主键。 第四步：在预览中对比输入输出行数 步骤图 41-04　第4步：在预览中对比输入输出行数。红框标出在预览中对比输入输出行数。 在预览中对比输入输出行数，检查空值和异常金额。 第五步：保存、校验、审核并发布 步骤图 41-05　第5步：保存、校验、审核并发布。红框标出保存、校验、审核并发布。 保存、校验、审核并发布；执行仍由调度中心负责。 最终结果与效果 得到结构化加工草稿和可核对样例，清洗逻辑可追溯，发布前不会影响生产数据。 操作提示： 业务规则要写清楚，例如“取消订单不计入销售额”，不要只写“清洗数据”。 常见问题 候选 DAG 缺节点。 业务描述可能过于笼统；补充输入表、过滤条件、关联维度和目标表。 校验提示字段越界。 AI 只能使用白名单字段；先在元数据中登记字段或调整方案。 审核通过后还能改吗。 修改会生成新版本并使原审核失效，必须重新走校验和审核。 开发人员参考 接口： /bi/ai-pipeline/options?kind=HOP、 /generate、 /drafts/{id}/validate|review|publish、 /versions 权限： bi:etl:ai-hop 组件、字段、源表和目标表由服务端模板约束，JSON 仅允许编辑白名单结构化字段。 审核绑定 SHA-256 摘要，发布只登记 DolphinScheduler 门禁，不自动执行 Hop 产物。 AI 全链路编排 功能定位 AI 全链路编排面向“从同步到可用”的端到端场景。它根据业务描述生成同步、清洗、dbt 建模、质量校验和元数据刷新的候选 DAG，让数据团队先看到完整依赖，再逐段审核，而不是在多个工具之间手工拼接。 图 7-8　端到端同步加工候选与发布门禁 适用角色 数据架构师、ETL 管理员、数据平台负责人和高级数据开发人员。 页面入口 数据治理中心 → AI 数据助手 → AI 全链路编排（ /bi/etl/ai/whale）。 操作步骤 选择全链路模板，例如“销售数据每日主链路”。 选择白名单源表，填写业务描述：同步频率、目标分层、清洗规则、质量要求和刷新范围。 生成候选 DAG，查看节点类型、目标表、依赖边和关键参数。 检查链路是否包含“源表就绪 → 同步 → DWD 清洗 → DWS 汇总 → 质量测试 → 元数据刷新”的必要阶段。 对每个节点检查失败策略、重试次数、超时和依赖条件，避免一个节点失败后下游仍继续。 执行确定性校验，处理循环依赖、缺失字段、越权表和非白名单组件。 提交审核并登记发布；发布后仍需在调度中心按正常流程执行和监控。 输入与输出 输入是源表、业务描述、分层目标和模板；输出是端到端 DAG、节点参数、依赖关系、校验结果、审核版本和调度门禁。 宏澜家电示例 输入“每天同步销售订单，清洗后按区域品类汇总，执行金额非负和主键唯一测试，刷新元数据，供经营看板使用”。AI 生成五段式 DAG；数据架构师补充“质量失败阻断下游”的条件后审核发布，避免脏数据进入 ADS。 客户应用演示：生成“销售数据每日主链路” 业务情境： 需要把同步、清洗、汇总、质量和刷新串成一条每日 DAG。 第一步：进入“数据治理中心 → AI数据助手 → AI 全链路编排” 步骤图 42-01　第1步：进入“数据治理中心 → AI数据助手 → AI 全链路编排”。红框标出进入数据治理中心 → AI数据助手 → AI 全链路编排。 进入“数据治理中心 → AI数据助手 → AI 全链路编排”。 第二步：选择销售主链路模板和白名单源表 步骤图 42-02　第2步：选择销售主链路模板和白名单源表。红框标出选择销售主链路模板和白名单源表。 选择销售主链路模板和白名单源表。 第三步：输入“每天 02:00 同步订单 步骤图 42-03　第3步：输入“每天 02:00 同步订单。红框标出输入每天 02:00 同步订单。 输入“每天 02:00 同步订单，清洗后汇总区域品类，执行金额非负和主键唯一测试，再刷新数据集”。 第四步：检查节点、依赖边、失败策略、重试次数和超时 步骤图 42-04　第4步：检查节点、依赖边、失败策略、重试次数和超时。红框标出检查节点、依赖边、失败策略、重试次数和超时。 检查节点、依赖边、失败策略、重试次数和超时。 第五步：执行确定性校验 步骤图 42-05　第5步：执行确定性校验。红框标出执行确定性校验。 执行确定性校验，补充“质量失败阻断下游”，提交审核发布。 最终结果与效果 生成端到端 DAG 草稿，包含同步、加工、汇总、质量和刷新阶段；发布只登记调度门禁，不自动运行。 操作提示： 确保链条有源表就绪、失败阻断和批次追踪，避免半成品进入看板。 常见问题 DAG 看起来完整但不能发布。 先看校验结果，通常是字段越界、依赖循环或缺少目标表。 全链路是否会自动执行。 不会。发布只登记调度门禁和摘要，实际执行由 DolphinScheduler 负责。 某个节点失败如何补数。 从失败节点开始按依赖顺序补跑，避免只补最后一层造成口径断层。 开发人员参考 接口： /bi/ai-pipeline/options?kind=WHALE、 /generate、 /drafts/{id}/validate|review|publish、 /versions/{id}/rollback 权限： bi:etl:ai-whale 服务端对 DAG 做节点白名单、依赖环检测、字段边界和摘要校验。 发布不直接调用执行器，避免 AI 生成内容未经人工确认就改变生产数据。 AI 数仓分层建模器 功能定位 AI 数仓分层建模器根据真实元数据和 DWD/DWS/ADS 分层规范，生成字段、主键、质量规则、依赖关系和 dbt 候选模型。它帮助建模人员快速起草分层模型，但 DDL 由服务端安全重建，候选必须校验和审核后才能发布。 图 7-9　ODS → DWD → DWS → ADS 候选与分层选择 适用角色 数仓建模人员、数据架构师、dbt 开发人员和指标管理员。 页面入口 数据治理中心 → AI 数据助手 → AI 数仓分层建模器（ /bi/etl/ai/warehouse）。 操作步骤 选择分层模板和数仓分层：DWD、DWS 或 ADS。 选择白名单源表，确认字段、类型和注释已经采集。 描述业务目标，例如“构建部门日销售 DWS 汇总，包含订单数、销售件数与销售金额，并校验金额非负”。 生成候选模型，查看字段、主键、分区、度量、质量规则和依赖。 在“结构化预览”检查服务端重建的 DDL；不要手工拼接建表语句。 在“DAG 编排”确认上游模型和下游依赖，避免跨层反向依赖。 校验、审核、发布；发布后在模型设计和发布中心继续跟踪 dbt、Doris、OpenMetadata 和 Superset 状态。 输入与输出 输入是源表元数据、目标分层、业务描述和模板；输出是字段定义、主键与分区、质量规则、依赖、dbt 候选模型、DDL 和审核版本。 宏澜家电示例 选择 DWS，描述“按部门、日期汇总销售订单，输出订单数、销售件数、销售金额、折扣额和毛利率，金额不得为负”。AI 生成汇总字段和质量规则；建模人员补充“取消订单不计入订单数”的口径后审核。发布后该模型成为部门经营看板的数据集来源。 客户应用演示：生成部门日销售 DWS 模型 业务情境： 经营看板需要按部门和日期汇总销售订单，并统一金额口径。 第一步：进入“数据治理中心 → AI数据助手 → AI 数仓分层建模器” 步骤图 43-01　第1步：进入“数据治理中心 → AI数据助手 → AI 数仓分层建模器”。红框标出进入数据治理中心 → AI数据助手 → AI 数仓分层建模器。 进入“数据治理中心 → AI数据助手 → AI 数仓分层建模器”。 第二步：选择 DWS 分层和部门日销售模板 步骤图 43-02　第2步：选择 DWS 分层和部门日销售模板。红框标出选择 DWS 分层和部门日销售模板。 选择 DWS 分层和部门日销售模板，选择白名单源表。 第三步：描述“按部门和日期汇总订单数、销售件数、销售金额、折扣额和毛利率 步骤图 43-03　第3步：描述“按部门和日期汇总订单数、销售件数、销售金额、折扣额和毛利率。红框标出描述按部门和日期汇总订单数、销售件数、销售金额、折扣额和毛利率。 描述“按部门和日期汇总订单数、销售件数、销售金额、折扣额和毛利率，金额不得为负”。 第四步：查看字段、主键、分区、度量、质量规则和结构化 DDL 步骤图 43-04　第4步：查看字段、主键、分区、度量、质量规则和结构化 DDL。红框标出查看字段、主键、分区、度量、质量规则和结构化 DDL。 查看字段、主键、分区、度量、质量规则和结构化 DDL。 第五步：校验依赖与分层 步骤图 43-05　第5步：校验依赖与分层。红框标出校验依赖与分层。 校验依赖与分层，提交审核发布，并在发布中心确认下游数据集。 最终结果与效果 形成符合 DWD/DWS/ADS 规范的分层模型草稿，字段和质量规则可审核，DDL 由服务端重建。 操作提示： DWD 保留明细粒度，DWS 做主题汇总，ADS 面向具体应用；选错分层会造成口径混乱。 常见问题 DDL 预览与手工 SQL 不一致。 以服务端重建结果为准，页面不允许直接提交任意 DDL。 分层选错。 DWD 保留明细粒度，DWS 做主题汇总，ADS 面向具体应用；选错会导致粒度混乱。 质量规则太多导致运行慢。 优先保留主键、金额、日期和引用完整性规则，再按业务风险补充。 开发人员参考 接口： /bi/ai-pipeline/options?kind=WAREHOUSE、 /generate、 /drafts/{id}/validate|review|publish 权限： bi:etl:ai-warehouse 分层、命名、字段类型和 DDL 由服务端规范约束；模型产物不会自动执行。 审核摘要和版本记录可追溯到具体草稿、模型和发布时间。 系统管理 数脉平台用户手册 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 一致。 截图里有历史菜单但导航不显示。 菜单表可能保留隐藏的旧目录；以当前左侧导航为准，不要误删仍在使用的权限节点。 开发人员参考 接口： /system/menu、 /system/menu/{menuId}、 /system/menu/treeselect 权限： system:menu:list、 system:menu:add、 system:menu:edit、 system:menu:remove 目录、菜单、按钮分别使用 M、 C、 F 类型。 菜单变更会影响动态路由和权限缓存；发布后应清理缓存并做角色回归测试。 部门管理 功能定位 部门管理维护集团、中心、部门和班组的组织层级，既用于通讯录和用户归属，也作为数据权限范围的基础。组织调整会直接影响“本部门及以下”的数据可见性。 图 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 有效期和作用域。 系统监控 数脉平台用户手册 V2.0 · 系统监控 在线用户 功能定位 在线用户列出当前仍持有有效会话的账号、客户端、设备类型、所属部门、登录地址、浏览器、操作系统和登录时间。管理员可据此确认异常会话、排查重复登录或执行强制退出。 图 9-1　在线会话筛选、列表和安全强退入口 适用角色 超级管理员、系统管理员和安全运维人员。普通业务用户只能在个人中心查看自己的在线设备。 页面入口 系统监控 → 在线用户（ /monitor/online）。 前置条件 已使用具备 monitor:online:list 权限的账号登录。 执行强制退出还需要 monitor:online:forceLogout 权限。 浏览器与服务端时间已校准，便于判断会话是否异常。 页面结构 区域 说明 筛选条件 登录地址、用户名称；支持回车和“搜索” 在线用户列表 会话编号、登录名称、客户端、设备类型、部门、主机、地点、系统、浏览器、登录时间 操作 强制退出当前会话 分页 显示总数、每页条数，可切换页码或每页数量 操作步骤 进入“系统监控 → 在线用户”。 输入登录地址或用户名称，点击“搜索”。空条件则返回当前授权范围内的在线会话。 核对客户端、设备类型、登录地点、浏览器和时间，判断是否为本人或受信设备。 对离职账号、遗失设备或明显异常会话，点击行尾“强退”按钮。 在确认框中再次核对账号和会话，确认后使该会话失效。 强退后用“操作日志”和“登录日志”复核事件；不要把它当作封禁账号的替代手段。 若风险来自账号泄露，应同时停用账号、重置密码并检查角色授权。 输入与输出 输入：用户名称、登录地址、当前会话筛选条件。 输出：会话列表、在线设备信息和强制退出结果。 强退只终止目标令牌对应的会话，不删除账号，也不改变角色权限。 宏澜家电示例 安全管理员发现一个已离职区域经理的账号在非工作时间从陌生地点登录。先筛选该账号，核对设备与浏览器后强制退出；随后在用户管理中停用账号、重置密码，并由审计人员复核该账号近期访问的报表和数据导出记录。 安全与隐私 截图和工单中不得公开完整会话编号、主机地址或账号信息。 帮助中心展示的截图已对会话、账号、客户端和主机信息脱敏。 只有经过授权的安全人员可以查看和处理全体在线会话。 强退生产用户前应评估是否正在执行报表导出、数据配置或调度操作。 客户应用演示：强制退出异常在线会话 业务情境： 安全告警显示一个未知设备登录了管理员账号。 第一步：进入“系统监控 → 在线用户” 步骤图 55-01　第1步：进入“系统监控 → 在线用户”。红框标出进入系统监控 → 在线用户。 进入“系统监控 → 在线用户”，按账号或地址搜索。 第二步：核对会话的登录时间、浏览器、地址和最后活动时间 步骤图 55-02　第2步：核对会话的登录时间、浏览器、地址和最后活动时间。红框标出核对会话的登录时间、浏览器、地址和最后活动时间。 核对会话的登录时间、浏览器、地址和最后活动时间。 第三步：与账号所有者确认是否为本人操作 步骤图 55-03　第3步：与账号所有者确认是否为本人操作。红框标出与账号所有者确认是否为本人操作。 与账号所有者确认是否为本人操作。 第四步：确认异常后点击“强退” 步骤图 55-04　第4步：确认异常后点击“强退”。红框标出确认异常后点击强退。 确认异常后点击“强退”，并通知用户立即修改密码。 第五步：复查登录日志和操作日志 步骤图 55-05　第5步：复查登录日志和操作日志。红框标出复查登录日志和操作日志。 复查登录日志和操作日志，确认没有异常数据操作。 最终结果与效果 异常会话被终止，后续登录使用新凭据；安全事件有完整处理记录。 操作提示： 强退前务必确认，避免误断正在进行的重要导出或建模操作。 常见问题 列表为空。 可能当前没有其他有效会话，或筛选条件过窄；先清空筛选后重试。 强退后用户仍能访问。 用户可能已在另一设备重新登录，或浏览器仍显示缓存页面。检查最新在线会话并要求用户重新认证。 看不到强退按钮。 当前账号缺少 monitor:online:forceLogout 权限，应通过角色授权，不要共享管理员账号。 开发人员参考 页面： ui/src/views/monitor/online/index.vue 接口： GET /monitor/online/list、 DELETE /monitor/online/{tokenId} 权限： monitor:online:list、 monitor:online:forceLogout 会话数据来自 Redis/Token 会话存储；服务端应校验令牌归属、租户和当前操作者权限。 返回浏览器或工单前，对 tokenId、 clientKey、 ipaddr 和地点字段做脱敏。 缓存监控 功能定位 缓存监控展示 Redis 的运行状态、资源消耗和实时统计，包括版本、运行模式、端口、客户端数、内存、CPU、AOF/RDB、Key 数量、网络流量、命令分布和内存消耗。它用于容量评估、性能排查和故障预警，不是通用 Key 管理工具。 图 9-2　Redis 运行指标、命令统计和内存信息 适用角色 系统管理员、运维人员和具备监控权限的开发人员。 页面入口 系统监控 → 缓存监控（ /monitor/cache）。 页面结构 区域 关键指标 用途 缓存概览 Redis 版本、模式、端口、客户端数 确认连接目标和实例形态 运行指标 使用内存、使用 CPU、AOF、RDB、Key 数量、网络入口/出口 判断容量、持久化和流量状态 命令统计 命令调用分布 定位异常命令或热点操作 内存信息 当前内存消耗 评估扩容和回收策略 操作步骤 进入“系统监控 → 缓存监控”，等待页面加载完成。 核对 Redis 版本、端口和运行模式，确认监控的是当前环境实例。 观察客户端数、CPU、内存和 Key 数量；与历史基线比较，而不是只看单次快照。 查看 AOF/RDB 状态和网络吞吐，判断持久化与访问压力。 命令统计异常增长时，结合操作日志、接口耗时和部署变更定位来源。 达到容量阈值时，由运维人员评估扩容、清理过期键或调整淘汰策略。 输入与输出 输入：Redis INFO、命令统计和当前缓存 Key 数量。 输出：运行指标、图表和异常判断依据。 该页面只读展示，不提供直接删除任意 Key 的操作。 宏澜家电示例 月末报表集中刷新时，管理员观察到 Redis 客户端数和网络入口流量短时升高，但内存与 CPU 仍低于预警线。结合操作日志确认是正常的并发看板访问，因此不清理缓存；若 Key 数持续只增不减，则检查会话过期和业务缓存 TTL。 安全边界 不要通过命令行批量删除未知 Key；先确认 Key 前缀、TTL 和业务归属。 缓存中可能包含会话、字典、验证码和业务临时数据，截图中不得暴露真实 Key 或值。 清理缓存会影响在线登录、验证码、字典和页面性能，必须在维护窗口并准备回滚。 页面展示的是运行指标，不是备份；Redis 持久化策略仍需独立运维。 客户应用演示：检查系统响应变慢时的缓存状态 业务情境： 多名用户反馈页面加载变慢，需要查看 Redis 运行情况。 第一步：进入“系统监控 → 缓存监控” 步骤图 56-01　第1步：进入“系统监控 → 缓存监控”。红框标出进入系统监控 → 缓存监控。 进入“系统监控 → 缓存监控”，查看连接状态、内存使用和命中率。 第二步：查看命令统计和键空间 步骤图 56-02　第2步：查看命令统计和键空间。红框标出查看命令统计和键空间。 查看命令统计和键空间，确认是否存在异常增长。 第三步：对比最近一次正常时段 步骤图 56-03　第3步：对比最近一次正常时段。红框标出对比最近一次正常时段。 对比最近一次正常时段，判断是容量、连接还是热点键问题。 第四步：不要直接清空缓存 步骤图 56-04　第4步：不要直接清空缓存。红框标出不要直接清空缓存。 不要直接清空缓存；先把诊断结果交给系统管理员评估。 第五步：处理后在业务低峰期验证登录、首页和报表加载 步骤图 56-05　第5步：处理后在业务低峰期验证登录、首页和报表加载。红框标出处理后在业务低峰期验证登录、首页和报表加载。 处理后在业务低峰期验证登录、首页和报表加载。 最终结果与效果 能够判断缓存是否健康以及是否与页面变慢相关，避免盲目清空造成会话失效。 操作提示： 清空缓存可能导致用户掉线，必须经变更审批并在低峰执行。 常见问题 页面提示加载失败。 检查后端与 Redis 网络、认证配置和 Redis 服务状态。 内存消耗突然升高。 查看命令分布、客户端数、Key 数量和近期发布；必要时抓取慢查询和连接来源。 AOF/RDB 状态异常。 立即检查磁盘空间、持久化配置和 Redis 日志，不要反复刷新页面代替恢复。 图表为空。 确认命令统计接口是否返回数据，并检查浏览器图表初始化是否受窗口尺寸影响。 开发人员参考 页面： ui/src/views/monitor/cache/index.vue 接口： GET /monitor/cache 权限： monitor:cache:list 数据来源为 Redis INFO、 DBSIZE 和命令统计；服务端应设置超时、只读查询和连接池隔离。 该接口不应暴露密码、完整连接串或敏感 Key；图表实例在页面卸载时销毁，窗口变化时重算尺寸。 关于数脉平台 数脉平台用户手册 V2.0 · 关于数脉平台 关于数脉平台 功能定位 “关于数脉平台”用业务语言说明平台定位、五个业务中心、数据价值链和核心价值，并提供“开始探索数据”“了解业务能力”“查看数据大屏”等导航入口。它适合新用户建立整体认知，也适合作为客户介绍和培训入口。 图 9-3　平台定位、五个业务中心和端到端数据价值链 适用角色 所有登录用户，尤其适合首次使用平台的管理人员、业务用户、售前顾问和培训讲师。 页面入口 主菜单 → 关于数脉平台（ /about），或在首页通过品牌/帮助入口进入。 页面内容 区域 回答的问题 平台简介 数脉平台是什么、连接哪些业务系统 价值链路 接数、治数、建数、析数、智数分别做什么 五个业务中心 数据大屏、数据探索、智能报表、业务建模、数据治理 业务价值 看得全、说得清、用 AI 让问数更简单 平台说明 适用场景、AI 边界和企业信息 操作步骤 阅读顶部简介，理解“从业务中来，到经营决策中去”的平台定位。 用五个环节串起数据从 ERP/CRM/MES 到经营看板的流动过程。 点击“开始探索数据”，进入数据探索中心首页。 点击“了解业务能力”，定位五个业务中心卡片，再选择需要的模块。 点击“查看数据大屏”，进入数据大屏展示页。 新用户可继续阅读“平台总览与阅读地图”，再进入对应快速入门。 输入与输出 输入：无需业务数据，只需要平台登录权限。 输出：平台能力认知、模块导航和后续学习路径。 页面中的“5 个业务中心”和“1 条数据价值链”是产品结构说明，不是实时统计。 宏澜家电示例 宏澜集团新入职的销售分析师先打开“关于数脉平台”，理解订单数据如何从 ERP 进入 ODS、经治理和建模后成为销售看板。随后点击“开始探索数据”，按业务用户快速入门查看区域销售看板。 使用说明 页面用于介绍产品能力，具体功能是否已启用以对应模块页面为准。 AI 输出仅作为分析辅助，不能替代业务口径确认和管理决策。 品牌名称为“数脉平台（DataPulse）”，运营主体为上海山奇信息技术有限公司。 客户应用演示：确认系统版本与技术支持信息 业务情境： 客户准备提交问题或做版本验收，需要记录系统信息。 第一步：进入“关于数脉平台” 步骤图 57-01　第1步：进入“关于数脉平台”。红框标出进入关于数脉平台。 进入“关于数脉平台”，查看产品名称、英文名、版本和运营主体。 第二步：记录浏览器标题和页面底部版本信息 步骤图 57-02　第2步：记录浏览器标题和页面底部版本信息。红框标出记录浏览器标题和页面底部版本信息。 记录浏览器标题和页面底部版本信息。 第三步：在“支持与联系”中确认服务渠道 步骤图 57-03　第3步：在“支持与联系”中确认服务渠道。红框标出在支持与联系中确认服务渠道。 在“支持与联系”中确认服务渠道。 第四步：整理问题发生时间、菜单路径、操作步骤和截图 步骤图 57-04　第4步：整理问题发生时间、菜单路径、操作步骤和截图。红框标出整理问题发生时间、菜单路径、操作步骤和截图。 整理问题发生时间、菜单路径、操作步骤和截图。 第五步：提交问题时附上版本信息 步骤图 57-05　第5步：提交问题时附上版本信息。红框标出提交问题时附上版本信息。 提交问题时附上版本信息，便于快速定位。 最终结果与效果 获得完整的产品身份和版本信息，技术支持可以据此判断环境与兼容性。 操作提示： 对外提交截图前先遮挡账号、Token、数据库地址等敏感信息。 常见问题 点击能力卡片没有反应。 检查该菜单是否对当前角色开放；无权限时应联系管理员，而不是手动拼接地址。 页面文案与产品版本不一致。 记录页面名称、截图、浏览器和发现时间，通过文档反馈入口提交。 页面在移动端显示拥挤。 建议横屏或使用桌面浏览器完成首次学习；实际操作以桌面端为主。 开发人员参考 页面： ui/src/views/about/index.vue 路由： /about 本页主要为静态产品介绍，按钮使用前端受控路由跳转。 修改品牌、业务中心或价值链路时，应同步更新登录页、首页、菜单地图、帮助文档和版本记录。 页面不接收用户输入，不调用写接口；所有外链和路由应使用白名单。 个人中心 数脉平台用户手册 V2.0 · 个人中心 个人中心 功能定位 个人中心维护当前账号的基本资料、头像、登录密码、第三方应用绑定和在线设备。它是用户自助管理入口，不用于修改他人账号或角色。 图 9-4　个人资料、账号安全与在线设备 适用角色 所有登录用户。 页面入口 点击右上角头像 → 个人中心（ /user/profile）。 页面结构 页签/区域 可查看或修改的内容 个人信息 用户名称、手机号码、邮箱、部门、角色、创建日期 基本资料 用户昵称、手机号码、邮箱和性别 修改密码 输入旧密码和新密码 第三方应用 查看和解除已绑定的第三方账号 在线设备 查看当前账号的在线会话并可移除设备 头像 上传并裁剪个人头像 操作步骤 更新基本资料 点击右上角头像，选择“个人中心”。 在“基本资料”核对昵称、手机号码、邮箱和性别。 修改后点击“保存”；页面显示成功提示后再刷新核对。 手机号和邮箱属于联系与安全信息，应使用本人可控且经过企业允许的地址。 修改密码 切换到“修改密码”。 输入旧密码、新密码和确认密码。 新密码应符合企业密码策略，不使用姓名、手机号或弱口令。 保存后按系统要求重新登录；其他设备会话可能需要重新认证。 更新头像 点击头像区域的上传入口。 选择清晰的 JPG/PNG 图片，在裁剪框中调整范围。 确认上传并等待成功提示。 若页面仍显示旧头像，刷新浏览器或清理头像缓存后重新进入。 管理在线设备 切换到“在线设备”。 核对设备类型、登录地址和登录时间。 对不明设备执行移除，随后修改密码并检查登录日志。 不要随意移除正在用于关键业务操作的受信设备。 输入与输出 输入：昵称、联系方式、性别、头像、旧密码、新密码。 输出：更新后的个人资料、密码状态、第三方绑定和在线设备列表。 个人中心不接受用户 ID 作为越权参数，服务端以当前登录身份为准。 宏澜家电示例 华东区域销售经理更换手机号后，在个人中心更新联系方式并上传企业头像。出差期间发现一台陌生设备在线，立即移除该设备、修改密码，并请安全管理员核查登录日志。涉及角色和数据范围的变化仍由管理员在用户管理中处理。 安全边界 不得在截图、工单或聊天中暴露完整手机号、邮箱和会话标识。 头像上传应限制文件类型、大小和内容，禁止脚本或伪扩展名文件。 修改密码必须验证旧密码；新密码不得写入日志或帮助文档。 第三方应用解绑后应确认是否影响单点登录，再执行其他会话操作。 个人中心不能自行提升角色、扩大数据范围或修改他人资料。 客户应用演示：更新头像并修改登录密码 业务情境： 新员工完成首次登录后，需要完善个人资料并更换初始密码。 第一步：点击右上角头像 步骤图 58-01　第1步：点击右上角头像。红框标出点击右上角头像。 点击右上角头像，进入“个人中心”。 第二步：在“个人信息”中上传头像、核对姓名、手机号和部门 步骤图 58-02　第2步：在“个人信息”中上传头像、核对姓名、手机号和部门。红框标出在个人信息中上传头像、核对姓名、手机号和部门。 在“个人信息”中上传头像、核对姓名、手机号和部门。 第三步：打开“修改密码” 步骤图 58-03　第3步：打开“修改密码”。红框标出打开修改密码。 打开“修改密码”，输入旧密码和符合规则的新密码。 第四步：保存后确认提示成功 步骤图 58-04　第4步：保存后确认提示成功。红框标出保存后确认提示成功。 保存后确认提示成功，并使用新密码重新登录。 第五步：在“在线设备”中检查是否有未知会话 步骤图 58-05　第5步：在“在线设备”中检查是否有未知会话。红框标出在在线设备中检查是否有未知会话。 在“在线设备”中检查是否有未知会话，必要时退出。 最终结果与效果 头像和个人资料更新，新密码生效，旧密码失效；在线设备清晰可见。 操作提示： 密码不要与外部网站复用；头像文件应清晰、合规且不含敏感信息。 常见问题 头像更新后仍显示旧图片。 等待上传成功提示，刷新页面；仍有缓存时退出重新登录。若接口报错，检查文件大小、格式和服务端文件存储。 保存基本资料失败。 检查手机号/邮箱格式、必填项和字段长度；联系管理员查看后端操作日志。 修改密码失败。 核对旧密码、两次新密码和密码复杂度；账号被冻结时应先联系管理员。 在线设备列表不完整。 Token 会话可能按客户端或时间窗口聚合，以安全管理员看到的“在线用户”页面为准。 开发人员参考 页面： ui/src/views/system/user/profile/index.vue 接口： GET /system/user/profile、 PUT /system/user/profile、 PUT /system/user/profile/updatePwd、 POST /system/user/profile/avatar 在线设备： GET /monitor/online；移除设备： DELETE /monitor/online/{tokenId} 权限：登录用户自助访问；服务端必须从安全上下文取得当前用户，禁止信任前端传入的用户 ID。 密码请求应加密传输，服务端校验旧密码和复杂度；头像上传需做 MIME、扩展名、大小与内容检测。 开发与运维 数脉平台用户手册 V2.0 · 开发与运维 总体架构与运行环境 文档目的 本章面向开发、测试、部署和运维人员，说明数脉平台各层职责、关键集成、环境要求和安全边界。业务用户无需阅读本章即可完成看板、报表和 AI 问数操作。 图 10-1　门户、业务服务、数据底座和外部引擎的分层关系 分层架构 层级 主要组件 职责 用户与门户层 Vue 3、Element Plus、RuoYi-Vue-Plus 风格权限与路由 登录、菜单、工作台、统一交互和受控跳转 应用服务层 Java 21、Spring Boot、MyBatis-Plus 用户权限、业务建模、质量治理、AI 编排、审计和集成票据 分析展示层 Superset 6.1.0、JimuReport 2.5.5、GoView 大屏 仪表盘、数据集、SQL、报表和大屏设计 数据治理层 DolphinScheduler、SeaTunnel、Hop、dbt、OpenMetadata 调度、同步、加工、模型构建、元数据和血缘 数据存储层 Doris、MySQL、Redis、对象存储 分析数据、业务配置、缓存与文件资产 模型服务层 企业模型网关 + DeepSeek-V4.1-Flash 自然语言理解、方案生成、受控 SQL 与看板编排 推荐运行环境 项目 要求 Java 21 LTS Spring Boot 4.1.x MyBatis-Plus 3.5.17 Node.js 20.19.0 或更高 pnpm 10.0.0 或更高 浏览器 当前版本 Chrome、Edge；启用 JavaScript 和 Cookie 数据库 MySQL 8.x（配置）、Doris（分析） 缓存 Redis 7.x 容器 Docker Engine 与 Docker Compose 关键集成原则 数脉门户是统一身份入口，用户不需要保存 Superset、JimuReport、DolphinScheduler 等子系统的独立口令。 集成跳转使用短时、一次性票据；票据绑定用户、目标页面和有效期，不能在前端日志中回显。 后台服务和数据引擎使用独立服务账号；服务账号凭据通过环境变量或密钥管理注入。 受控 SQL 只允许只读查询，必须限制 Schema、字段、行数和执行时间。 发布链固定为 DBT → Doris → OpenMetadata → DolphinScheduler → Superset，每一步都可追溯。 AI 不得直接拼接并执行任意 SQL；应先生成结构化方案，再通过白名单编译器和二次确认执行。 开发前必须理解的四条边界 前端不是安全边界。 菜单隐藏只改善体验；接口仍需服务端权限校验。 第三方页面不直接拼接任意 URL。 Superset、JimuReport、GoView、DolphinScheduler、Hop 均通过后端页面白名单和一次性票据打开。 AI 不直接执行任意 SQL。 服务端会做数据集范围、字段白名单、只读 SQL 和结果行数等校验。 发布使用不可变版本。 审核通过的模型、发布的大屏和流水线版本不能被原地覆盖，变更应形成新版本并可追溯。 本地开发目录 ui/ 前端页面与 API 封装 source/ruoyi-modules/ruoyi-bi/ BI、建模、ETL、AI 后端模块 source/script/sql/ 初始化与迁移脚本 docs/ 设计、验收和部署资料 infra/ MySQL、Redis、Doris、Superset 等基础设施 一次典型请求的链路 浏览器 → RuoYi 网关 → JWT 鉴权 → 菜单/按钮权限 → BI 控制器 → 白名单与参数校验 → 业务服务 → 数据源/第三方平台 → 脱敏审计日志 → 返回结构化结果 环境配置约定 APP_BASE_URL 门户对外地址 DATABASE_* MySQL 配置连接 REDIS_* Redis 连接与认证 AI_GATEWAY_BASE_URL 企业模型网关地址 AI_GATEWAY_API_KEY 由部署环境注入，禁止入库和入仓 AI_DEFAULT_MODEL 默认模型标识 SUPERSET_* Superset 服务与跳转密钥 DOLPHINSCHEDULER_* 调度服务与票据配置 OPENMETADATA_* 元数据服务配置 安全提示：示例只列变量名，不提供真实密钥、数据库口令或内部地址。生产环境应使用 Secret Manager、Kubernetes Secret 或受控环境变量。 部署检查清单 前端、后端、数据库、Redis、Superset 和分析数据库健康检查均通过。 HTTPS 证书、跨域策略、Cookie 属性和反向代理头正确。 所有子服务仅暴露必要端口，管理端口不对公网开放。 上传目录、备份目录、日志目录具备容量监控和最小权限。 时区统一为 Asia/Shanghai，数据库、JVM、容器与浏览器时间一致。 AI Key、JWT、数据库口令不进入 Git、镜像、前端包和帮助文档。 发布前执行单元测试、接口测试、页面冒烟、权限回归和敏感信息扫描。 故障排查顺序 用健康检查确认门户和核心接口是否存活。 检查浏览器网络面板，区分 401、403、404、502 和超时。 核对一次性票据是否过期、是否已被消费、目标服务是否健康。 查看后端日志、网关日志和目标引擎容器日志，使用同一时间与请求 ID 关联。 修复后从真实菜单重新进入，不使用手工拼接的临时地址验证。 API、鉴权与权限模型 鉴权流程 用户登录后获得平台会话。访问业务 API 时，前端在受控请求层携带会话令牌；后端验证身份、菜单权限、按钮权限和数据范围。打开嵌入式分析工具时，另行申请短时一次性票据，票据只能用于指定目标页面。 浏览器 → 门户登录 → 会话令牌 → 业务 API 浏览器 → 点击分析菜单 → 后端校验权限 → 一次性票据 浏览器 → 目标系统交换票据 → 建立受控会话 → 打开指定页面 API 约定 项目 约定 基础路径 门户后端统一前缀，按模块分组 请求格式 JSON；文件上传使用 multipart/form-data 响应格式 业务码、消息、数据；分页数据包含 rows 与 total 时间格式 ISO 或统一的 yyyy-MM-dd HH:mm:ss 幂等 创建类接口支持请求号或业务唯一键 分页 pageNum、 pageSize；服务端设置最大页大小 错误码 401 未认证、403 无权限、404 不存在、409 状态冲突、422 校验失败、429 限流、502 下游异常 权限模型 平台权限分四层： 菜单权限：控制目录和页面是否可见；不能代替接口鉴权。 按钮权限：控制新增、修改、删除、审核、导出、运行等操作。 数据权限：按全部、本部门、本部门及以下、本人或自定义部门限定数据范围。 服务端资源权限：对数据源、项目、数据集、报表和发布目标分别校验归属与角色。 用户 → 角色 → 菜单/按钮/数据范围 用户 → 部门 → 数据范围 用户 → 项目成员 → OWNER / EDITOR / REVIEWER / VIEWER 典型接口分组 模块 接口前缀 示例 用户与个人中心 /system/user /system/user/profile 角色与部门 /system/role、 /system/dept /system/role/{roleId} 在线会话 /monitor/online 列表与强制退出 业务建模 /bi/bm 项目、字典、质量、审核、发布 数据治理 /bi/etl 调度、同步、加工、外部源、元数据 数据探索 /bi/superset 状态检查、受控启动 智能报表 /bi/jimu 状态检查、受控启动 AI 对话与分析 /bi/ai 会话、方案、确认、样式调整 安全要求 所有写接口校验 CSRF/重复提交策略和当前用户权限。 文件下载和导出再次校验数据范围，不信任前端传入的查询条件。 SQL 只读、字段白名单、行数上限、超时与取消机制必须由服务端强制执行。 跳转子系统的目标地址从服务端白名单生成，禁止开放任意 URL 重定向。 日志不得记录密码、Token、Cookie、API Key、完整 SQL 中的敏感常量和个人联系方式。 对 AI 输入做长度与内容限制；对 AI 输出做 JSON Schema 校验和操作白名单校验。 最佳实践 前端权限只用于改善体验，最终授权以后端为准。 对重要业务动作使用二次确认、幂等键和审计事件。 对跨服务错误返回稳定的诊断码，不把下游堆栈和内部地址暴露给浏览器。 对敏感字段采用脱敏视图，原始数据访问单独授权并记录。 接口变更保持向后兼容；废弃字段先标记版本，再逐步移除。 AI 生成看板与样式调整 能力边界 AI 对话分析把自然语言问题转换为经校验的分析方案，再由后端创建 Superset 图表并组合到一个看板中。当前产品约束如下： 单次最多生成 5 张图表，统一进入一个看板。 首次请求先生成方案，用户二次确认后才创建资产。 方案 TTL 为 30 分钟，且一次性消费。 用户问题最多 500 字。 SQL 只读，字段来自白名单，结果行数受限。 支持后续用自然语言调整背景色、图表颜色、文字颜色和字号。 默认模型为 DeepSeek-V4.1-Flash，通过企业模型网关访问。 生成流程 自然语言问题 → 模型识别业务主题、指标、维度和筛选 → 方案 JSON 校验 → 数据集/字段白名单检查 → 生成只读 SQL → 预览影响与图表计划 → 用户二次确认 → 创建图表和看板 → 返回看板链接与操作记录 方案结构示例 { "title": "华东南亚空调季度经营分析", "audience": "经营管理层", "charts": [ {"type": "line", "metric": "销售额", "dimension": "订单月份"}, {"type": "bar", "metric": "毛利率", "dimension": "产品品类"} ], "filters": {"region": "华南", "year": 2026}, "style": {"background": "#071B35", "palette": ["#2A78FF", "#42D3FF"]} } 示例仅说明结构，不允许把模型输出直接当作可执行 SQL 或任意配置写入目标系统。 样式调整流程 用户输入“把看板背景改为深蓝，折线图使用青色，标题字号 20”。 模型生成受控样式补丁，只允许颜色、字号、坐标轴和合法图表属性。 服务端校验颜色格式、字号范围和目标图表归属。 返回变更预览；用户确认后应用到指定看板。 保存变更前后的配置快照，记录会话、用户、时间和补丁摘要。 错误与安全 场景 处理 模型超时 返回可重试提示，不重复创建资产 方案过期 提示重新生成方案；一次性 token 不再接受 字段越权 拒绝生成并记录原因，不返回敏感字段元数据 SQL 非只读 编译器拒绝；禁止依赖模型自检 非法颜色/字号 Schema 校验失败，返回可读错误 重复确认 幂等键阻止重复创建图表 开发检查清单 模型网关地址与 API Key 只从环境变量读取。 提示词中不包含真实客户明细、密钥或不必要的个人信息。 对模型响应使用严格 Schema 校验，禁止“解析失败后直接执行”。 AI 生成资产必须归属当前用户和项目，支持撤销与审计。 看板创建失败时，清理半成品图表或保持可重试状态。 测试覆盖：空问题、超长问题、越权字段、跨租户、过期方案、重复提交、下游 502、模型限流。 测试、发布与运维 测试分层 层级 重点 典型验证 单元测试 参数校验、权限判断、SQL 编译、样式 Schema 边界值、空值、非法值、幂等 接口测试 鉴权、状态码、事务、审计、错误信息 401/403/404/409/422/502 集成测试 门户票据、Superset、报表、调度、元数据 免登录跳转、票据过期、服务不可用 端到端测试 用户从菜单进入并完成目标业务 生成多图表看板并调整样式 权限回归 角色、部门、数据集和导出边界 业务用户不能访问管理接口 安全测试 越权、注入、文件上传、敏感信息泄露 白名单、限流、日志脱敏 可用性测试 桌面与移动端、错误提示、加载超时 无横向溢出、可恢复 发布流程 合并前通过静态检查、单元测试和代码评审。 在测试环境执行数据库迁移、配置核对和冒烟测试。 验证所有外部服务健康状态及一次性票据通道。 在变更窗口按依赖顺序发布：数据库 → 后端 → 前端 → 集成配置。 发布后执行登录、菜单、看板、报表、大屏、建模、治理和 AI 核心链路检查。 观察错误率、响应时间和 502 日志；异常时按预案回滚。 运维监控 门户后端健康端点与关键接口成功率。 Superset、JimuReport、GoView、DolphinScheduler、Hop、SeaTunnel、OpenMetadata 容器状态。 MySQL、Doris、Redis 磁盘、连接、慢查询和内存。 AI 网关延迟、错误率、限流和模型切换情况。 调度失败、质量告警、元数据刷新失败和报表加载失败。 备份成功率、恢复演练和敏感配置轮换记录。 备份与恢复 资产 备份内容 恢复验证 MySQL 用户、权限、业务建模、质量规则和配置 登录、菜单、项目数据 Doris ODS/DWD/DWS/ADS 数据与建模产物 行数、质量规则、看板查询 对象存储 头像、报表资源、上传文件 下载与权限校验 配置 环境变量、集成白名单和票据密钥引用 不读取明文密钥进行截图 文档 Markdown 源文件、图片、导入包与发布清单 本地站点和导出文件可打开 回滚原则 数据库迁移必须提供向前修复或可验证回滚脚本。 前后端版本与接口契约应保持兼容，避免只回滚一端。 看板、报表和模型发布使用不可变版本，回滚指向历史版本而不是覆盖文件。 AI 生成的资产支持撤销，但审计记录不得随撤销删除。 常见故障定位 502/504：检查反向代理、后端存活、上游超时和容器日志。不要通过重启所有容器掩盖根因。 401/403：区分会话过期与权限不足。401 重新登录，403 检查角色、菜单、按钮和数据范围。 页面空白或 iframe 不加载：检查一次性票据、安全响应头、 X-Frame-Options/CSP 和下游服务状态。 数据为空：检查批次时间、源表行数、质量规则、模型刷新和筛选条件。 AI 无响应：检查模型网关、Key 引用、配额、超时与输入长度；不得在浏览器打印 Key。 常见问题 数脉平台用户手册 V2.0 · 常见问题 常见问题与故障排查 使用方法 先按现象定位到对应问题，再按“先检查入口与权限、再检查服务、最后检查数据”的顺序排查。若问题涉及账号、密钥、内部地址或客户数据，请通过受控支持渠道提交，不要粘贴到公开聊天或工单描述中。 登录与会话 验证码图片不显示 强制刷新页面，确认网络请求中的验证码接口不是 401/500。 检查浏览器是否阻止图片、Cookie 或混合内容。 确认后端、Redis 和反向代理均正常。 清理该站点 Cookie 后重新登录；仍失败时联系管理员查看验证码服务日志。 登录后立即返回登录页 检查会话 Cookie 的 Secure、 SameSite、域名和 HTTPS 配置；确认前后端时间一致，令牌未过期。 点击菜单提示 401/403 401 表示未认证或会话失效，重新登录；403 表示已登录但无权限，联系管理员检查角色、菜单、按钮和数据范围。 页面与嵌入系统 一直显示加载动画 等待合理的首次初始化时间后，检查后端状态接口、目标服务健康状态和一次性票据。若页面提示“集成已关闭”，说明功能入口存在但当前环境未启用，不应判断为前端断链。 Superset/报表/大屏要求再次登录 返回数脉菜单重新进入，让系统重新签发短时票据。不要在新窗口手工输入第三方账号；票据过期或服务会话失效时，旧地址不会长期有效。 页面出现 502 或“集成已关闭” 502 表示网关无法从上游取得有效响应，检查后端和下游服务。 DISABLED 表示主动关闭，检查环境配置和账号映射后由管理员启用。 菜单打开后空白 检查浏览器控制台、网络面板和 iframe 安全策略；确认目标系统允许被当前域名嵌入。生产环境不应通过关闭全部安全策略绕过问题。 报表、看板与大屏 新建报表报错 检查 JimuReport 服务、数据库连接、模板权限和文件存储。记录报错时间与请求 ID，不要反复提交产生重复报表。 看板图表无数据 依次核对筛选条件、数据批次、数据集权限、SQL 结果和源表行数。先用同一条件在 SQL 工作台验证。 两个报表同一指标不一致 检查指标口径、时间范围、含税/未税、退货处理、组织层级和数据刷新批次。以业务字典中的审核版本为唯一口径。 大屏组件被遮挡或无法点击 刷新页面并检查浏览器缩放比例；确认画布层级和响应式布局。若问题持续，记录组件名称、浏览器和复现步骤。 AI 对话分析 AI 没有响应 检查问题是否超过 500 字、模型网关是否可用、Key 引用是否已加载、请求是否被限流。页面应显示明确错误与重试入口。 方案确认后提示过期 方案有效期为 30 分钟且只能消费一次。重新生成方案；不要重复点击旧确认链接。 只生成了部分图表 一次最多生成 5 张图表。拆分问题或减少维度；查看是否有图表因字段越权、数据为空或类型不支持被跳过。 修改背景色/图表色不生效 确认样式指令明确指向当前看板或图表，例如“把当前看板背景改为深蓝，所有折线使用青色”。若颜色或字号不合法，系统会拒绝修改。 文字颜色和字号无法调整 先重新生成或刷新看板，再提交包含目标图表和数值范围的指令。系统只允许受支持的样式属性和合法范围。 AI 回答可信吗 AI 结果仅用于辅助分析。涉及财务、客户、合同或管理决策时，应回到数据源、业务字典和审核记录核实。 数据建模与治理 数据源测试连接失败 检查只读账号、网络白名单、数据库端口和证书。不要把生产写账号改用为分析连接。 元数据/血缘为空 检查元数据服务授权、dbt 产物、Doris 采集任务和调度状态。先执行受控采集，再查询目录。 质量告警一直未处理 按严重级别分派责任人，确认问题原因后执行确认或忽略。忽略必须记录原因和复查日期。 调度成功但数据不正确 调度成功只表示任务执行完成。继续检查产出表行数、质量规则、批次时间、模型刷新和看板数据集。 导入、导出与文件 Excel 导入失败 检查模板版本、必填列、编码、重复编码和字段长度。下载最新模板后重新导入，不要修改隐藏列。 导出文件打不开 确认下载完成、文件扩展名与内容一致，并使用受支持办公软件。敏感数据导出需遵守企业审批要求。 头像上传失败 检查图片格式、大小、裁剪范围和对象存储状态；刷新后仍显示旧图时清理浏览器缓存。 支持信息模板 提交问题前请准备：页面名称、菜单路径、发生时间、账号角色、浏览器版本、期望结果、实际结果、复现步骤、错误提示截图，以及可公开的请求 ID。请先脱敏手机号、邮箱、Token、Cookie、数据库地址和客户明细。 版本与反馈 数脉平台用户手册 V2.0 · 版本与反馈 版本记录与文档维护 V2.0（2026-11-06） 本次更新 按当前真实菜单重新梳理用户手册，覆盖八个一级菜单和全部功能页面。 新增五条典型业务场景：管理层看经营、业务人员临时问数、AI 生成并调整多图表看板、固定经营报表分发、从 ERP 到经营看板。 为 44 个业务与管理功能页补充客户应用演示，统一采用“第一步、第二步、第三步……”编号步骤，并说明最终结果与页面效果。 重新采集并脱敏 46 张当前界面截图，配套 8 张业务示意图，做到图文并茂。 新增“最终结果与效果”“操作提示”“常见问题”，帮助客户判断操作是否成功。 明确区分“功能入口已实现”和“当前演示环境已启用”；涉及外部集成的页面按实际状态说明。 业务用户内容优先，开发与运维内容单独成章，避免把接口细节混入日常操作。 内容口径 AI 对话分析在同一看板中最多生成 5 张图表；方案约 30 分钟有效且一次性消费。 AI 仅做只读分析，生成前需人工确认，不自动发布看板，也不修改 ERP 业务数据。 数据接入使用只读账号、字段校验、行数限制和审计；AI 输出不能替代业务复核。 宏澜家电智造集团及其全部业务数据均为演示用的模拟企业和模拟数据。 V1.0（2026-11-05） 覆盖范围 八个一级菜单、五个业务中心和统一支撑区。 45 个唯一路由功能页，配套 46 张脱敏页面截图。 数据大屏、数据探索、智能报表、业务建模、数据治理、系统管理、系统监控、关于与个人中心。 开发与运维：架构、运行环境、API、鉴权、权限、AI 编排、测试、发布和回滚。 业务快速入门、开发快速入门、常见问题、版本记录和反馈模板。 质量检查 页面元数据 ID 唯一，章节顺序与当前菜单一致。 截图来自当前运行系统，已脱敏账号、联系方式、会话、内部地址和敏感配置。 静态站支持全局搜索、关键词高亮、业务/开发筛选、上一篇/下一篇、图片放大和移动端适配。 Markdown、静态站、DOCX、PDF 与 BookStack 导入包使用同一份内容源。 公开包不包含原始截图、采集清单、采集脚本或环境凭据。 已知环境状态 帮助文档准确区分“入口已实现”和“当前演示环境已启用”。部分数据治理集成在演示环境中显示 DISABLED、连接关闭或未授权；这不表示页面不存在，也不表示生产环境已经完成验收。使用前应由管理员按部署章节核对配置。 文档维护责任 角色 责任 产品负责人 确认功能范围、术语、版本和发布节奏 业务负责人 审核业务流程、示例、指标口径和角色说明 开发负责人 审核接口、权限、架构、错误码和技术限制 测试负责人 验证复现步骤、截图状态和功能可用性 运维负责人 审核部署、监控、备份、安全和故障处置 文档维护人 合并修订、生成发布包、执行链接和敏感信息检查 文档变更流程 需求或缺陷确认后，记录变更单号、影响页面和责任人。 更新唯一内容源中的 Markdown，不只改导出的 DOCX/PDF。 在测试环境重新操作受影响页面，必要时更新脱敏截图。 由业务或开发审核人确认内容与实际行为一致。 重新构建静态站，生成 DOCX、PDF 和 BookStack 导入包。 执行链接、搜索、图片、响应式、导出和敏感信息扫描。 记录版本号、日期、变更摘要、审核人与发布地址。 发布后抽查线上目录、搜索、图片和移动端页面。 反馈闭环 请通过帮助中心右上角“文档反馈”复制反馈模板，或使用企业支持渠道提交。建议反馈包含： 文档页面： 产品版本： 问题类型：内容错误 / 操作失败 / 图文不一致 / 缺少说明 / 其他 发生时间： 复现步骤： 期望结果： 实际结果： 影响范围： 可公开的截图或请求 ID： 不要在反馈中提交密码、API Key、Token、Cookie、数据库口令、客户明细或未脱敏截图。 发布验收记录 每次发布至少确认： 首页、目录、搜索、筛选、上一篇/下一篇和反馈入口可用。 图片点击放大，图示和页面截图均能加载。 桌面与手机宽度无横向溢出。 DOCX 与 PDF 可打开，标题、表格和图片未丢失。 公开包敏感信息扫描通过。 BookStack 发布凭据存在时，执行同名检查和发布后验证；凭据缺失时明确标记为未发布。