第2章 梳理模型输入输出与业务链路
模型在业务链路中的位置决定了它的输入来源、输出去向以及与其他系统的依赖关系。本章提供一套标准化流程，帮助产品经理从业务全链路视角绘制模型的输入输出映射，并明确定义上下游依赖关系，为后续指标对齐奠定结构化基础。
适用场景
- 新模型立项阶段，需要明确模型与周边系统的数据边界。
- 已有模型需要重构或迁移，必须重新梳理输入输出依赖。
- 跨团队协作时，需要统一理解模型在整个业务流中的位置。
- 模型上线前，验证输入输出是否与业务链路各环节对齐。
前置条件
- 已完成业务主流程的梳理，形成业务流程图（泳道图或价值流图）。
- 已获取模型设计文档初稿（含模型名称、目标、算法类型）。
- 已拉通业务方、算法、工程的数据字典或字段清单。
- 已确定本章涉及的关键角色：产品经理（主导）、算法工程师（协作者）、后端开发（评审方）。
操作步骤
- 定位模型在业务链路中的环节 — 在业务流程图中标出模型服务所在的节点，确定其前驱和后继环节。
- 枚举每个环节的输入数据 — 列出业务原始数据、上游系统输出、特征依赖等，标注数据来源方。
- 枚举每个环节的输出数据 — 列出模型推理结果、决策指令、回调信号等，标注数据去向方。
- 建立输入输出映射表 — 将每个环节的输入和输出对齐到统一的数据字段维度，消除命名歧义。
- 标注上下游依赖关系 — 用箭头或连接线明确数据流向、调用顺序、同步/异步约束。
- 跨团队评审确认 — 组织业务方、算法、工程三方评审，确认映射关系和依赖定义无误。
实操要点： 步骤2和步骤3必须使用统一的数据字典版本，避免因字段命名不一致导致映射错位。推荐在映射表中增加“字段示例”列，降低理解偏差。
输入输出物
| 类别 | 名称 | 说明 | 模板/示例 |
|---|---|---|---|
| 输入物 | 业务流程图（泳道图） | 包含模型所在节点的完整业务链路 | UML 活动图 / 泳道图 |
| 模型设计文档 | 含模型名称、目标、算法类型、特征列表 | 内部模板 V2.3 | |
| 数据字典 | 所有相关字段的命名、类型、来源说明 | Excel 数据字典（示例见附件） | |
| 输出物 | 输入输出映射表 | 每个业务环节的输入输出字段对齐表 | 见下方“记录材料”示例 |
| 上下游依赖关系图 | 标注数据流向、调用顺序、同步/异步约束 | SVG / Draw.io 格式 | |
| 接口规范文档（初稿） | 输入输出字段名、类型、取值范围、频率 | OpenAPI 3.0 或内部规范 |
责任边界
| 角色 | 职责 | 产出物 | 参与节点 |
|---|---|---|---|
| 产品经理 | 主导链路梳理、映射表编制、评审组织 | 输入输出映射表、依赖关系图 | 全部步骤 |
| 算法工程师 | 提供模型输入输出说明、特征字段定义 | 模型输入输出字段清单 | 步骤2、3、6 |
| 后端开发 | 确认数据接入可行性和接口格式 | 接口规范初稿 | 步骤4、6 |
| 业务方 | 确认业务链路准确性、输出结果可用性 | 业务链路确认签字 | 步骤1、6 |
记录材料
- 输入输出映射表（核心记录）：必须包含“环节名称”、“输入字段”、“输出字段”、“数据来源”、“数据去向”、“字段示例”、“备注”七列。
- 依赖关系清单：记录每个依赖对的上游环节、下游环节、依赖类型（强依赖 / 弱依赖 / 异步）、超时阈值。
- 评审纪要：记录评审日期、参与人、决议事项、待办项及责任人。
模板参考： 输入输出映射表至少包含以下列：
推荐在字段级别使用“数据血缘标签”进行溯源管理。
环节名称 | 输入字段 | 输出字段 | 数据来源 | 数据去向 | 字段示例 | 备注推荐在字段级别使用“数据血缘标签”进行溯源管理。
异常处理
| 异常场景 | 可能原因 | 处理方式 |
|---|---|---|
| 输入数据字段缺失 | 上游系统未提供或字段名不一致 | 1. 与上游确认字段映射关系；2. 在映射表中标记为“待对齐”并跟进 |
| 输出结果与业务期望不符 | 模型输出定义有歧义或阈值不合理 | 1. 重新审查模型设计文档；2. 组织算法与业务方专题讨论 |
| 依赖关系冲突（环路依赖） | 模型输出又作为同一环节的输入 | 1. 拆分环节，引入中间存储；2. 重新设计链路顺序 |
| 多方对同一字段定义不一致 | 数据字典版本未对齐 | 1. 拉通各方使用统一数据字典；2. 建立字段别名映射表 |
| 评审无法达成一致 | 业务目标或技术方案存在分歧 | 1. 升级至项目负责人决策；2. 记录分歧点，设定 trial 验证周期 |
常见陷阱： 不要跳过“字段示例”列。纯理论定义的输入输出在对接时极易产生歧义，一个具体的示例值（如 user_id=“U12345”、score=0.87）能避免 80% 以上的沟通返工。
验收标准
- 完整性：映射表覆盖业务链路中所有与模型相关的节点，无遗漏环节。
- 一致性：所有输入输出字段均与数据字典对齐，无命名冲突。
- 可视化：依赖关系图已绘制完成，图上标注了数据流向、调用顺序和关键约束。
- 可执行：接口规范初稿已输出，字段名、类型、取值范围、更新频率均已定义。
- 已评审：三方（产品、算法、工程）签字确认映射关系和依赖定义无误。