PG官网

  去年有个做园区物业的客户，为了压预算，把新访客系统拆成四块。门禁硬件给一家，访客小程序给一家，后台管理给一家，短信和电子发票再给一家。四份合同分别签，项目群拉了六个，平时对接的是老板的行政。

  上线前一周，门禁刷卡的记录进不了后台，访客在门口等，保安拿纸质本子登记。硬件商说只保证刷卡开门，小程序公司说接口按文档写的，后台公司说字段对不上，短信服务商说模板还没过审。会开了三次，每家公司都能拿出自己没做错的证据，整条链路却停在那里。

一、拆包本身没错，错在没人当总包

  很多甲方拆包，是为了压价，也为了找更专业的公司。硬件找做硬件的，小程序找做界面的，后台找做数据的，听起来每一块都更划算。合同一签，各自的功能都能做，拼在一起却没人对最终结果负责。拆得越细，接口越多，没人管的地方也越多。

  每家公司的责任边界，通常只写到自己的合同范围。硬件商负责设备能刷，软件公司负责页面能开，后台公司负责接口能通。至于刷卡之后记录怎么进后台，访客信息怎么同步给保安，异常时谁先排查，合同里没有一个人名。

  这时候需要一个总包角色。总包可以是一家开发公司，也可以是甲方自己指定的项目经理，还可以是第三方。形式可以变，三样东西不能少，接口清单的确认权，联调排期的决定权，验收单上的签字权。没有这三样，总包只是一个称呼。

  有的甲方找一家公司做总包，合同里只写收几个点管理费，实际工作还是各家干各家的。这样的总包只多了一道转手，出事时照样找不到人。总包合同要写清它对整体交付负责，分包款由它结算，接口扯皮由它裁决，延期也要算它的责任。总包还要审核分包的技术方案，不能等出了事再拉群。

  如果甲方自己当总包，别让行政兼职传话。行政能约会议、能收发票，但压不住四家公司的技术负责人。至少要给这个项目指定一个能拍板的人，老板要明确授权，不然他在群里说的话，别人只当建议。

二、合同里最该写死的，是接口边界和交付物

  四份合同里最常见的一句话，就是配合甲方完成联调。这句话看着礼貌，实际没有约束力。有的合同写提供标准接口，标准是谁的标准，也没有下文。

  接口清单要单独做一份附件，不能只放在聊天记录里。清单上至少写清五件事，接口地址和调用方向，字段名称和类型，数据多久同步一次，鉴权和失败重试怎么处理，测试环境和上线时间。每一行后面要有提供方和确认人。这张表由总包起草，甲方确认，各家签字。

  付款节点也要挂到接口上。硬件到货付一部分，设备能刷付一部分，记录进后台再付一部分，总体验收通过付尾款。分包合同里加一条，配合总包联调属于交付义务，不配合导致延期要承担违约责任。付款节点挂上去，分包公司才会当回事。

  甲方不用自己写接口文档，但要看懂几个关键点。比如访客预约成功后，记录是先进门禁系统还是先进后台，两个系统之间的字段以谁为准，网络断了以后数据补不补。这些问题不问清，上线后一定会在门口吵架。尤其是访客、订单、支付这类跨系统数据，字段口径差一个字，后面就要人工补。

  接口文档还要有版本。联调前确认一版，改动必须通知到所有相关公司，不能今天加一个字段，明天换一个参数，最后每家手里的文档都不一样。版本号、确认时间、确认人，三样都留在附件里。

三、联调不是拉个群，得有人追着问题走

  很多项目都有群，群里每天发截图，发日志，发语音。问题一多，消息就沉底，谁在改，改到哪一步，没人说得清。联调要落一张问题清单，群里的聊天记录替代不了它。

  联调牵头人只能有一个。他的工作不写代码，每天只问三件事，昨天的问题谁在处理，今天能不能联调，卡住的地方需要谁拍板。每家公司的技术负责人都对他，不对老板，也不在群里各自解释。牵头的可以是总包项目经理，也可以是甲方技术负责人，但不能两家轮流当。

  联调顺序也要排。先打通一条最小链路，预约、审核、下发权限、刷卡、记录回传，这条走通了，再补异常分支。有的项目一上来就测十几条场景，测到第三天，连最基本的进门都还没通。

  每次联调要留记录。谁改了字段，什么时候改的，影响哪几家，下一次什么时候复测，都写在同一张表里。出了问题先看日志和版本，不靠回忆。嘴上说昨天已经改过，日志里没有，那就不算改过。

  甲方派的人可以不懂代码，但要能追问题。他不用判断技术方案，只要盯住每个问题的责任方和截止时间。超过时间没解决，就找总包，总包解决不了，再找老板。别让四家公司直接在群里吵，吵到最后还是甲方自己收拾。项目经理可以不会看代码，但要会看日期和责任人。

四、验收主体只能有一个，别让每家都说自己没问题

  分包项目最容易出现的场面，是每家都交了测试报告，每家都说自己负责的部分通过。甲方把报告收齐，以为项目结束了。真正走一遍业务，访客进不了门，后台查不到记录，短信也没发出去。单点功能的测试报告，替代不了整条业务链路。

  验收要按业务场景走，不按公司分。访客预约、审核通过、门禁下发、现场刷卡、记录回传、后台报表，一条流程从头到尾走完。每一段由哪家公司提供证据，提前写在总验收清单上。缺一段，整条不算通过。

  验收单上只能有一个甲方签字人。分包公司把材料交给总包，总包汇总后交给甲方，甲方只对总包签字。甲方直接跟四家签合同的，也要指定一家做技术总协调，给它协调费和否决权，不然没人愿意干这份得罪人的活。签字的人要能代表老板，不能今天签完，明天换人。

  验收结论要写清未通过项、责任方、整改期限。不要用基本通过、部分通过这种模糊说法，尾款照付，后面就没人着急。尾款跟总验收挂钩，分包款由总包按联调结果结算，这样总包才有动力去追。整改完成要复验，复验记录和第一次验收单放在一起。

  上线后第一个月也要有人管。接口监控谁看，数据对不上谁查，哪家公司先响应，这些在验收前就写进运维表。很多问题不在验收当天暴露，往往拖到验收后两周，大家散了，问题才慢慢冒出来。

  判断一个分包项目有没有人负责，不用看合同有多厚，问三个问题就够了。四份合同里，有没有一份写清谁对整体链路负责。有没有一份接口清单，能对应到每个字段和每家公司。验收单上，是不是只有一个甲方签字人。三个问题里有两个答不上来，先别急着上线。