4. 集成需求分析与方案设计

在 ZEISS 检测数据与质量系统集成的项目中，最容易失败的路径不是接口写不出来，而是需求没有被翻译成可验证的集成约束。业务方说“希望测量数据自动进质量系统”，这句话背后至少包含四类需要拆开定义的内容：数据从哪里来、要经过哪些处理、哪些功能由谁负责、在多长时间内必须完成。本节围绕这四类内容，给出从痛点出发的集成需求分析与方案设计方法。

一、先把业务痛点翻译成集成需求

痛点通常以现象出现，例如“检验员每天手工抄录 CMM 报告”“质量追溯时找不到对应批次的三坐标原始数据”“SPC 图表更新滞后一个班次”。这些现象不能直接作为需求，需要按“现象—影响—可度量目标”三层展开。以手工抄录为例：现象是每班约 40 件零件、每件 12 个关键尺寸由人工录入；影响是单件录入约 90 秒、存在错位风险；可度量目标可定义为“关键尺寸从测量完成到质量系统可查询的端到端时延 ≤ 5 分钟，人工录入字段降为 0”。

把痛点转成需求时，建议同时记录数据源、触发方式、目标系统、时效要求、准确性要求五个要素。例如 ZEISS CALYPSO 测量程序完成后生成测量结果，触发方式可以是文件落盘监听或数据库轮询；目标系统可能是 QMS 的检验结果表；时效要求 5 分钟；准确性要求关键尺寸与原始报告一致、不允许四舍五入二次处理。只有这五个要素都明确，后续的方案设计才有判断依据。

二、定义数据流：从测量设备到质量系统

数据流不是一条直线，而是包含采集、解析、映射、校验、写入、反馈六个环节的链路。以典型的 ZEISS 三坐标测量场景为例：CALYPSO 完成测量后输出测量结果文件（如 .txt 或 .xml），集成服务监听指定目录并读取文件；解析模块提取零件号、批次号、测量时间、特性名称、名义值、实测值、上下偏差；映射模块把 ZEISS 特性名转换为 QMS 的检验项编码；校验模块检查必填字段、量程合理性和重复记录；写入模块通过 QMS 提供的 API 或中间表落库；反馈模块在写入失败时生成告警并保留原始文件。

这条链路中，数据流的方向和边界必须画清楚。哪些数据是单向流入 QMS 的，哪些需要回写到测量设备或 MES，哪些只做日志留存，都要在方案设计阶段确定。下面这张图给出了一条典型的数据流与功能边界示意，重点表达数据从测量端到质量端的流转路径、各环节的职责归属以及异常分支。

三、功能边界：谁负责什么，必须写清楚

功能边界不清是集成项目中最常见的争议来源。测量设备侧通常只负责“把测量结果完整、可解析地输出”，不负责业务字段映射；集成服务侧负责采集、解析、映射、校验、重试和告警；质量系统侧负责检验结果存储、SPC 计算、追溯查询和放行判定；运维监控侧负责时延、成功率、积压量等运行指标。边界一旦确定，接口契约就可以围绕边界来写。

以字段映射为例，ZEISS 报告中的特性名可能是“D1_孔径_φ10”，而 QMS 中的检验项编码是“OP10-DIA-001”。这个映射关系属于集成服务侧的职责，不应要求测量工程师在 CALYPSO 中修改特性命名，也不应要求 QMS 去适配设备侧的命名习惯。映射表应作为配置项管理，支持版本化和变更审计。

四、性能指标：把“快”变成可测量的数字

性能指标需要覆盖时延、吞吐、准确性和可用性四个维度。时延指从测量完成到质量系统可查询的时间，建议按 P95 定义，例如“P95 ≤ 5 分钟”；吞吐指单位时间可处理的测量记录数，例如“峰值 200 条/分钟”；准确性指字段映射正确率和数值一致性，例如“关键尺寸数值与原始报告一致率 100%”；可用性指集成服务在计划生产时间内的可用比例，例如“≥ 99.5%”。

这些指标不是拍脑袋定的，而是从业务节奏反推。如果生产节拍是每 8 分钟下线一件，质量系统需要在下一件下线前完成上一件的检验结果可用，那么端到端时延就必须小于 8 分钟，并留出余量。下面给出一个简化的指标定义示例，便于在方案评审时对齐口径。

五、集成策略：同步、异步还是混合

集成策略的选择取决于业务对时效和一致性的要求。如果质量系统需要在测量完成后立即阻塞放行，适合采用同步调用，但同步调用对 QMS 接口的可用性要求高，一旦 QMS 不可用，测量端可能被阻塞。如果业务允许分钟级延迟，异步消息或文件监听更合适，集成服务可以在 QMS 短暂不可用时缓存并重试。

更常见的做法是混合策略：测量结果采集和写入采用异步，保证测量端不被阻塞；放行判定和关键追溯查询采用同步，保证业务实时性。无论选择哪种策略，都需要定义失败后的行为：是重试、告警、人工补录，还是回滚。建议在方案设计阶段就明确“失败不丢数据”的底线，例如原始文件保留不少于 30 天，失败记录进入重试队列并触发告警。

最后需要强调的是，集成需求分析与方案设计不是一次性文档，而是后续开发、测试和验收的基准。建议把数据流图、功能边界表、性能指标表和集成策略说明作为方案的核心交付物，并在评审时逐项确认。只有把业务痛点翻译成可验证的集成约束，ZEISS 检测数据与质量系统的集成才能从“能跑通”走向“可运维、可追溯、可扩展”。