Article body
正文
摘要： 企业重复建设销售看板、区域经营应用和管理层报表时，需要复用可交付、可扩展、可追溯的分析资产。衡石将数据集、数据模型、指标、图表库和应用组织为可管理对象：HQL 与指标管理承载业务计算，数据集市承载数据包和权限，图表库支持看板复用，Data Agent 则在既有授权资产上参与问数与创作。复用由此从“复制一份报表”变成一条可验证的交付链路。
复用的起点，是可解释的业务语义
同一个“销售额”放进总部驾驶舱、区域看板和业务系统嵌入页，名称相同并不代表计算相同。团队需要先明确订单状态、金额字段、退款处理、统计时间和可分析维度，再把这些规则沉淀到衡石的数据集、数据模型和指标中。HQL 用于表达计算逻辑；指标管理再把计算逻辑与业务配置组织起来，使分析师不必在每一张图表里重复拼接规则。
衡石将指标分为原子指标和业务指标。原子指标保存聚合计算的定义；业务指标在此基础上配置限定条件、分析维度、时间轴和路径归因，服务一个明确的分析场景。多个业务指标需要相同的维度、时间轴和限定条件时，团队还可以引用同一指标粒度。粒度变化后，引用它的指标会同步相应配置，因此这类改动应经过样本核对和下游影响检查。
统一语义解决的是“同一个业务概念如何计算”。它不能替代查询条件和数据权限。区域负责人只看到本区域数据，总部看到全部区域数据，双方引用同一指标仍可能得到不同数值；这表示可见数据范围不同。项目验收应同时记录指标名称、数据集或模型、过滤条件、时间范围、数据时点和访问身份，让差异可以复核。
资产还需要让使用者找得到。衡石的指标集市按业务主题及子主题组织原子指标和业务指标，支持按指标类型、数据集、创建人和分组筛选。常用指标可以加入“我的收藏”，其中会保留主题路径；指标管理、指标集市和指标分析看板提供一致的全局搜索入口。主题权限决定用户能否查看或使用对应指标，因此收藏和搜索只改善定位效率，不能扩大访问范围。
围绕五类对象组织分析资产复用
| 资产对象 | 适合复用的内容 | 实施时需要确认的边界 |
|---|---|---|
| 指标与指标粒度 | 聚合逻辑、限定条件、分析维度和时间轴 | 指标复用共享计算含义；页面过滤、身份权限和数据刷新仍由每次查询决定。 |
| 数据包与继承数据集 | 数据集、数据模型、参数以及公共基础数据 | 应用需要先申请并由数据包管理者审批。继承后的原有内容保持只读，应用可新增字段、指标、数据集和关系模型。 |
| 图表库图表 | 高频经营图表、统一展示方式和计算配置 | 复制后可独立修改；链接会跟随图表库变化且不能直接编辑。发布应用或导出模板后，链接图表成为实体，不再保留引用关系。 |
| 数据包模板 | 数据集、图表库、数据模型等分析骨架 | 导入模板创建新数据包后，仍要确认数据连接、数据内容和授权对象；模板提供起点，不代替目标环境的权限与数据校验。 |
| 应用模板与模板市场 | 标准看板结构、统一版式和复杂报表样板 | 模板市场上架时会将使用的数据集转为 Excel 样例数据展示，发布前须确认样例是否适合目标使用者查看；跨环境导入还需重新绑定可用数据包。 |
这组对象覆盖了从语义到数据、再到展示与交付的复用层次。数据集市中的数据包可以导出为模板，也可以通过创建副本或复制到形成独立资产；模板市场则适合下发标准分析样板和重复搭建的同类看板。团队应把“链接”用于需要持续保持一致的标准图表，把“复制”用于明确需要本地改版的场景。两者的维护责任不同，选错方式会把后续变更变成意外。
数据包继承适合总部提供公共基础数据、区域在本地扩展分析的组织方式。继承保留了源数据包的来源标识和保护边界，区域可以增加业务字段、区域指标或新的关系模型，却不能修改继承来的原始内容。包含继承数据集的应用无法导出模板；源数据包一旦删除，依赖它的图表会报错。团队需要把这些依赖关系纳入变更评审，而不是把继承当成无成本的复制。
说明性示例：总部与区域如何复用一套经营分析资产
以连锁零售企业为例。总部在数据集市建立“经营基础数据包”，将订单、门店、商品和日期等数据集建模，并定义“已支付销售额”“退款金额”“库存周转天数”等指标。数据团队用 HQL 和指标配置把计算规则、时间轴和常用维度沉淀下来，再通过数据包权限控制谁能管理、编辑或查看这些资产。
华东区域申请继承该数据包。管理者审批后，区域应用获得可用的基础数据、参数和模型；区域分析师新增“华东促销后销售额”这样的本地指标，并将门店经营图表放入区域仪表盘。需要跟随总部调整的标准门店趋势图，可在区域应用创作区以链接方式导入；区域要改写展示规则时，则复制图表并维护本地版本。向业务人员交付已发布应用时，源图表的后续调整需要纳入重新发布与验收流程。这样，总部保留基础语义和标准内容的维护权，区域保留业务扩展和本地交付的空间。
当业务人员询问“华东本月哪类商品销售下滑”时，Data Agent 可以在已授权的数据集和既有指标、业务主题范围内辅助检索和分析，并把可视化结果沉淀为后续可维护的图表或看板。团队仍要核对问题采用的指标、维度、过滤条件和数据时点。Agent 消费的是已有分析资产，不能绕过数据权限，也不能代替业务负责人确认口径。
把复用做成可交付的工程能力
衡石的开放集成能力让分析资产可以进入门户、业务系统与自动化工作流。团队可根据界面和系统边界选择嵌入页、JavaScript SDK 或 API 等方式，把仪表盘、问数能力和分析结果放进既有产品。集成前应先确认调用身份、资源授权、行列权限、参数传递和验收口径。发布后的应用是发布瞬间的快照，创作区改动需要重新发布才会进入发布区；外部嵌入和跳转应使用稳定的应用标识设计交付，避免把重发布后的内部对象变更带入业务系统。
一条可执行的交付流程可以从高频场景开始：
- 选择一个经营主题，确认指标负责人、计算定义、可分析维度、时间规则和授权范围。
- 在数据集市沉淀数据包、模型和公共图表；为数据包、图表和应用写清维护责任。
- 为区域或项目应用选择继承、链接、复制或模板导入方式，并在目标身份下验收数据范围和结果。
- 将稳定的看板、嵌入入口和 Agent 问题纳入发布与变更流程；口径、源数据或权限调整后，重新核对受影响对象。
衡石的能力重点在于将 HQL 指标语义、数据包治理、看板创作和开放集成连成一套资产链。企业不必把每一次分析都重新做成孤立项目：总部可以沉淀公共基础，区域可以在受控范围内扩展，业务系统和 Agent 可以消费已经准备好的分析资产。随着负责人、引用关系和变更记录持续完善，复用会从一次性交付变成组织可积累的分析能力。