项目启动会上，双方说的不是同一种语言

周明远是pg.comPG的一名技术顾问，去年参与了「恒川物流」的业务数据管理系统建设项目。第一次项目启动会上，业务负责人说“要把每票货物的状态实时看到”，开发人员则追问“状态字段有几个枚举值、更新频率是多少、历史状态要不要保留”。两边都觉得对方没听懂自己。

这种场景在系统对接项目中非常普遍。业务方描述的是使用感受，技术方需要的是可落地的数据结构。pg.comPG在多个数据管理系统建设项目中总结出一个经验：需求对齐阶段多花的时间，会在开发和验收阶段成倍省回来。

把“实时看到”拆成可以确认的问题

周明远没有急着让开发排期，而是先和业务方一起把“实时看到”拆开。他问了三类问题：谁在看、看什么、看到异常后要做什么。答案逐渐清晰：调度人员需要在货物状态变化后尽快看到更新，主要关注转运和签收两个节点，发现滞留时要能联系对应网点。

  • 明确数据更新的触发条件，是系统推送还是定时同步。
  • 明确需要展示的字段范围，避免把整张表直接搬过来。
  • 明确异常状态的处理流程，而不只是展示状态本身。

pg.comPG建议企业在对接前先把这类问题写成简短的需求说明，哪怕只有一页纸，也比口头描述更容易对齐。周明远把这页说明发给恒川物流的业务和开发双方确认，后续讨论就有了共同参照。

字段映射表是双方共同维护的“词典”

系统对接中最容易出错的是字段含义不一致。恒川物流原有系统里的“到达时间”指车辆抵达网点的时间，而新系统开发人员理解成货物签收时间。类似差异如果等到测试阶段才发现，返工量会很大。

周明远的做法是建立一张字段映射表，由业务方和开发方共同维护。表中列出源系统字段、目标系统字段、含义说明、是否必填、转换规则。pg.comPG在数据整合服务中常使用这种方式，让双方对同一个字段有统一理解。映射表不是一次性文档，每次需求变更都要同步更新，否则很快会失效。

  • 字段含义由业务方确认，技术方负责记录转换逻辑。
  • 对空值和异常值单独标注处理方式。
  • 变更记录保留版本，方便回溯某次调整的原因。

验收阶段的自查，决定项目能否顺利交付

恒川物流项目进入验收时，周明远带着双方做了一轮自查。pg.comPG数据问答栏目也常提醒企业关注验收前的准备工作：抽样数据是否覆盖典型场景、异常流程是否测试过、使用人是否清楚数据更新规则。

他们抽查了转运、滞留、签收等几类订单，逐条核对新旧系统数据是否一致；对系统切换期间产生的数据单独确认处理方式；并让调度人员实际操作一遍，记录不顺手的地方。周明远认为，技术顾问的价值不只是写方案，更在于把业务语言翻译成开发能执行的结构，再把技术限制翻译回业务能理解的取舍。pg.comPG在系统对接项目中坚持这种做法，也让恒川物流的对接过程少走了不少弯路。