Article body
正文
项目经理在业务系统里查看任务进度时，往往还想知道延期集中在哪些团队、成本偏差来自哪些项目。如果分析入口在另一套系统，使用者需要重新找项目、设筛选条件，再把结论带回原来的工作页面。SaaS 厂商要交付的是能接住这些业务问题的产品体验。
先选业务页面，再决定嵌入什么
以项目管理应用为例，项目首页适合呈现交付进度与预算概览；进入单个项目后，用户更需要按阶段、团队和时间查看偏差。伙伴可以在 HENGSHI SENSE 中准备数据集和分析资产，再把仪表盘或分析入口嵌入对应页面。这样，用户在处理项目时就能查看相关数据，不必从一张通用报表里重新定位业务对象。
嵌入前应先确定宿主页面传递哪些上下文，例如当前项目、组织和时间范围；同时确认这些参数在分析侧如何映射。图表能显示出来只是第一步，筛选条件与业务页面保持一致，分析才真正进入工作流程。
给每个入口一份页面契约
嵌入前，产品和实施团队要把宿主页面与分析内容一一对应。项目首页适合看项目组合，项目详情页适合看单个项目的成本和进度，审批页则可能只需要当前事项的风险提示。先确定用户在该页面要做什么决定，再选择图表和交互深度；否则同一张大看板塞进所有页面，用户仍要自己找答案。
| 业务入口 | 传入的上下文 | 分析侧应呈现 | 验收动作 |
|---|---|---|---|
| 项目列表 | 组织、时间范围 | 项目组合的进度与偏差 | 切换组织后核对汇总 |
| 项目详情 | 当前项目、时间范围 | 该项目的阶段和成本明细 | 切换项目后核对标题与数据 |
| 审批页面 | 当前项目或事项 | 与审批相关的少量指标 | 查看异常后返回审批 |
这张表是交付讨论的起点，不是固定产品模板。团队还需明确参数从哪里来、缺失时显示什么、用户能否在分析区域继续筛选，以及返回业务页面后筛选状态如何处理。比如用户在项目详情页选择了“最近三个月”，随后打开另一个项目，系统要明确保留时间范围还是恢复默认值。前端、后端与分析实施人员按同一约定测试，才能避免每一端都按自己的理解工作。
移动端和窄屏页面也要单独验收。完整仪表盘在桌面上可读，不代表缩进业务页面后仍能使用。设计人员可以先保留一个关键结论和必要的筛选入口，把复杂明细放到更适合查看的页面；用户点开异常项目后，应知道如何回到原任务。
把数据口径与用户身份一并接通
衡石提供数据连接、建模、指标管理、可视化和嵌入集成能力。伙伴可以在指标管理中明确计算方式、限定条件和分析维度，再将经过验收的指标用于不同页面。订单金额、已回款金额和预算执行率各有定义，不能因为都出现在同一张看板上就混用口径。
认证和权限需要与宿主产品一起设计。HENGSHI SENSE 提供单点登录、JWT 等集成路径，也支持按应用和数据资源配置权限。多租户场景还要核对租户空间、用户映射与行级数据范围；相关能力需结合授权和部署方案确认。验收时，实施团队应分别以平台管理员、租户管理员和普通用户身份进入宿主页面，检查每个角色看到的页面与数据。
在原产品里完成交付验收
伙伴上线前可围绕一个真实任务做走查：用户从项目页进入分析，切换时间范围，查看异常项目，再返回待办或审批流程。团队需要检查页面加载、筛选联动、权限提示和移动端布局，也要确认数据刷新后看板与业务系统仍指向同一个项目。发现数据差异时，应能追到指标定义、数据集和权限配置。
嵌入式分析的验收样本应覆盖用户真正会走的页面路径。实施团队可以先选一个有数据的项目和一个没有数据的项目，分别从列表页进入详情页，核对页面项目、图表标题、筛选条件与汇总数字。用户切换到另一个项目后，分析内容也要跟着切换；返回列表再进入原项目时，应检查页面是否保留了错误的筛选状态。
权限走查需要把“看不到”拆开处理。未登录、会话过期、没有分析入口权限、可以看汇总但不能看明细，是四种不同场景。宿主产品应给用户可理解的提示，实施团队则核对分析侧的身份映射与数据授权。若客户采用多租户部署，还要用两个租户中的同名项目验证隔离，避免只凭管理员账号验收。
交付记录可保留入口页面、传入的业务对象、使用的测试身份、预期结果与实际截图。产品改版或分析资产调整后，伙伴按这份记录复测关键路径，再让客户业务负责人核对数字和用词。这样，页面体验与指标结果都能找到具体责任人。
上线后继续观察真实使用
交付验收可以分成三个时点：试点前确认指标与身份映射，试点中记录用户从入口到行动的路径，推广前复测不同租户和角色。试点不只问“图表能否加载”，还要看项目经理是否能从异常数字进入项目处理流程，是否需要复制数据到别处才能完成讨论。若用户每次都绕开嵌入入口去找独立报表，团队应回头检查入口位置、图表内容或筛选条件。
产品改版会改变页面路径和参数，客户组织调整会改变可见数据范围，分析资产升级也可能改变图表名称。伙伴可以为关键入口保存一组回归样本：一个有数据的项目、一个无数据的项目、一个权限受限账号和一个跨租户隔离场景。每次改动后先走完这组样本，再让客户负责人检查业务含义。这样可以把“上次还能看”还原为具体入口、身份与版本，而不是在多套系统之间猜原因。
长期使用还需要维护责任分工。宿主产品团队负责入口、导航和用户提示；数据团队负责数据集、指标与刷新；客户业务负责人确认哪些数字支持日常决策。发现数据不一致时，先保存业务对象、筛选条件、访问身份和查看时间，再按责任面定位。一个小而明确的交付记录，比堆叠更多图表更能帮助团队持续改进。
一次客户走查的实际顺序
以项目经理查看延期风险为例：他先在项目列表发现一个项目进度落后，再进入详情页查看按阶段拆分的进度与成本，最后回到任务列表找负责人。实施团队可以在这条路径上逐屏核对：列表中的项目编号是否与分析区域一致，详情页时间范围是否跟随页面选择，点击异常项后是否还能回到原任务。若用户需要复制项目编号再到独立分析页搜索，嵌入入口的位置或上下文传递就还有改进空间。
同一条路径再用受限账号走一次。若该账号只有项目汇总权限，页面应避免出现可点击却无法打开的明细入口；若整个项目不可见，宿主页面和分析区域应给出一致的权限结果。团队还需测试退出后重新登录、会话过期后刷新、浏览器返回上一页等普通操作。用户体验中的断点常出现在这些切换动作，而不在第一次加载看板时。
最后请客户业务负责人用真实业务语言讲一遍他从图表中得到的结论。若“预算偏差”在系统里包含未审批费用，而客户理解为已发生费用，图表即使加载快速、数字计算正确，也不能按原名称交付。双方应回到指标定义，确定名称、解释和页面提示，再完成签收。嵌入式分析的交付结果是用户能在原工作页面作出判断，技术联通只是其中一步。
衡石的价值在于把数据准备、指标和可视化能力组织成可集成的分析底座，供伙伴在自己的产品中交付。伙伴仍负责选择业务入口、定义客户可用的指标、完成认证映射并验收最终体验。这样交付的分析功能，才能随着客户的日常工作被使用和改进。