交付项目 SOP
研发团队 SOP 体系 · 里程碑型 SOP
版本:V3.0(试行)
发布日期:2026-10-20
责任主体:PMO(交付负责人)
状态:试行(试行期至 2026-12-31,期满由 PMO 组织评估调整)
1. 定位与边界
- 里程碑型 SOP:一个项目一次,覆盖从"决定交付"到"项目关闭"的交付侧全过程;
- 启动侧(立项、计划制定)、代码质量验收标准(规范层面)、商务谈判(商务线)不在本 SOP 范围;
- 交付项目 = 若干开发任务的汇合点 + 一次性动作(部署上线、移交、归档)——凡已有 SOP 约定的(自测分级、变更三要素、文档化生命线,均属研发团队 SOP 体系),本 SOP 引用不重复;
- 触发时机:项目进入交付准备(合同约定的交付节点或验收前约定时限),由 PMO 启动本 SOP。
2. 总体流程
交付物整理 → 验收与测试 → 部署上线 → 资料移交 → 项目收尾
(备齐 → 证明 → 上线 → 移交 → 结清,风险递减顺序)
3. 第一块:交付物整理
交付三要素:软件 + 文档 + 数据——三者都是交付物,缺一不可。交付清单必须覆盖三要素。
- 对照合同/立项文件建交付清单:逐项列出应交付物,按软件 / 文档 / 数据三类归集(系统、源码、文档包、业务数据、账号……),逐项标注状态(齐/缺/部分)——清单是后续所有环节的对照物,相当于项目级"交付标准",也是全流程的总线(交付清单销项指交付物逐项完成状态更新;checklist 销项指本 SOP 步骤项完成,两者并行维护);
- 文档包齐套:需求、设计、测试报告、用户手册、部署文档——按清单核对,缺的补、旧的更新;
- 格式统一:命名规范、版本号、模板一致——对外交付物注意公司形象;
- 源码与构建产物打包:可编译、可部署、可复现——附依赖说明与环境版本;构建后在干净环境验证一次"能跑起来",验证通过才算打包完成;
- 数据交付四要素(凡合同约定交付数据的,缺一不可):
- 数据本身:按约定格式导出(数据库脚本 / 备份文件 / 结构化文件),含交付时点说明;
- 数据字典:表结构、字段含义、枚举值说明——没有数据字典的数据对方接不住;
- 迁移方案:数据如何导入目标环境(步骤、工具、依赖)、迁移后如何核对;
- 数据备份:交付数据自身留一份备份(对应运维分册(研发团队 SOP 体系)备份要求),交付出问题可重来。
4. 第二块:验收与测试
- 交付前内部验收:项目级基准业务场景全过(开发任务 SOP 自测分级的项目级放大:基准必须、边界尽力;基准业务场景清单由 PMO 会同技术 Leader 在交付物整理阶段确定,纳入交付清单管理);内部验收不通过不发起正式验收;
- 验收环境准备:环境、数据、演示场景就绪——验收环境应尽量与生产环境等价(版本、配置、数据基线一致),避免验收环境通过而生产环境异常;验收前一天由执行人自查一遍;
- 陪同验收支持:现场/远程演示、问题当场逐条编号记录;
- 验收意见闭环:逐条响应——缺陷走修复(按开发任务 SOP 走新任务),非缺陷项书面说明;全部闭环后才进入验收签字环节(签字由商务主导、PMO 配合,与第7块衔接);正式验收不通过时,缺陷项走修复闭环后重新组织验收,延期影响同步商务与部门负责人。
5. 第三块:部署上线(五阶段)
5.1 阶段一:上线准备
- 上线方案五要素:
- 时间窗口:明确日期时段,含"最迟开始时间"——过了这个点自动改期,不带病上线;改期由决策人宣布,窗口顺延规则与对后续计划的影响同步明确;
- 步骤清单:逐条操作步骤(谁、做什么、预期结果),每步可勾选;
- 回退方案:回退条件(什么情况立即回退、谁有权决定)+ 逐条回退步骤;
- 影响评估:上线期间受影响的服务、时长、需提前知会的人;
- 人员分工:执行人、验证人、决策人(回退拍板者)——三角色可两人兼任,但不能是一人。
- 部署脚本化要求:部署步骤应脚本化(部署脚本/发布工具配置),人工清单只作辅助:
- 脚本覆盖停服/部署/启动/回退的完整动作链;
- 脚本要素:幂等(重复执行不出错)、明确的成功/失败输出、关键步骤有日志;
- 无法脚本化的步骤(硬件操作、需人工确认的授权)显式标注为"人工步骤",写明操作人。
- 方案确认:技术 Leader 确认技术部分;影响面大的(核心业务系统)部门负责人知会;
- 依赖就绪检查:服务器资源、账号权限、网络策略、第三方接口凭证——上线前一天全部到位,缺一项改期;
- 上线前三层备份(缺一不可):
| 备份层 | 内容 | 为什么 |
| 数据层 | 数据库、上传文件、业务数据 | 业务资产的本体 |
| 配置层 | 配置文件、环境变量、参数调优 | 生产环境跑着的配置 ≠ 代码库里那份,含运行期改过的参数 |
| 程序层 | 系统二进制镜像 / 部署包(当前生产版本) | 回退要退回"原来的那个版本",不是"重新构建一个大概像的" |
三层各自验证可恢复;三层打同一版本标记——回退时配套退到同一时刻的完整状态,混用不同时刻的备份会制造出从未存在过的系统状态。
5.2 阶段二:上线预演(部署脚本的测试)
- 预演 = 部署脚本测试:在类生产环境用部署脚本完整执行一遍,正向 + 回退都实际跑——回退脚本没跑过等于没有回退脚本;预演不通过不进生产;
- 预演记录与修正:发现的脚本缺陷(漏步、顺序、权限、环境差异)修复脚本后从安全步骤重跑,不是记录了事——预演的意义是让方案变对,不是让流程走完;
- 双重验证:回退演练实际用到的正是程序层备份——演练跑通即同时验证了脚本可用与备份可用;
- 脚本入库:部署脚本随源码归档,并计入交付清单(脚本也是交付物)。
5.3 阶段三:生产执行
- 执行前最后确认:窗口时间到 → 参与人就位 → 三层备份完成确认 → 决策人宣布开始;
- 逐步执行逐步勾选:每步完成即勾选并记录实际结果;任何一步与预期不符 → 停下来上报决策人,不自行变通——自行变通是上线事故的最大来源;
- 变更记录:改了什么配置、动了哪些文件——变更三要素(改什么/为什么/怎么回退,属研发团队 SOP 体系)的落实。
5.4 阶段四:上线验证
上线配套宣讲与发版通知:面向运营与业务员的讲解/视频须在
发版前完成;验证通过后由技术负责人在群内发布版成功通知,再由产品发送发版成功邮件——见
《版本上线配套宣讲与发版通知流程》。
- 基准场景复测:基准业务场景在生产环境全部走通——复测通过才算上线完成,否则按回退方案处理;
- 外围检查:定时任务、消息通知、对外接口、日志无异常——这些"不在演示路径上"的功能最容易漏。
5.5 阶段五:观察期
- 观察期设置:时长按项目风险定(常规 1~3 个工作日,核心系统可一周);观察期内异常响应人、响应时限明确;
- 观察期结束确认:期满无异常,正式宣布上线完成,交付清单销项;观察期内出问题按缺陷处理 SOP(研发团队 SOP 体系)走。
6. 第四块:资料移交
与观察期并行:资料移交与用户培训可与观察期(5.5)并行开展,观察期满确认后交付清单统一销项。
- 账号权限移交:管理员账号、系统权限清单,书面移交、接收方确认;移交后接收方应立即重置管理员密码,账号口令通过安全渠道传递,不随书面材料明文流转;
- 运维知识移交:部署手册、常见故障处理、备份恢复方法——按"文档化生命线"标准整理,移交后对方能独立处理常规问题;
- 数据移交验证(如交付含数据):接收方按迁移方案实际导入一遍,抽样核对关键数据的数量与内容——导入成功 + 抽样一致,数据移交才算完成;
- 用户培训:操作培训 + 培训材料留存;培训完成让用户实际操作一遍(不是只看演示)。
7. 第五块:项目收尾
- 文件归档:全过程文档归档入库(含讨论记录、决策记录、部署脚本);
- 未完结事项显式移交:遗留问题、二期需求、已知限制——成文移交,不带暗账;
- 项目复盘会:目标达成度、过程得失;输出复盘纪要(任务级 30 秒复盘的项目版);
- 商务收尾配合:验收签字、款项节点通知——PMO 配合商务,不主导。
8. 贯穿原则
- 交付清单是全流程总线:每个环节动的是清单上的同一份状态,每块完成销项;
- 责任到人:PMO 为交付负责人,各块执行人明确到人;
- 内部先过再对外:内部验收 → 正式验收;预演 → 生产执行;构建产物 → 干净环境验证 → 确认打包完成。
9. 两份 Checklist:一次性准备 vs 每次上线重复
为什么分成两份。交付过程里的动作其实有两种节奏:有些是一个项目只做一次、做完后续一直沿用的(建清单、脚本化、基线环境、账号权限、培训材料……);有些是每上线一次就要完整重跑一遍的(备份、预演、执行、复测、观察期恢复)。混在一张表里,团队每次上线都得在几十项里挑出"这次要做的",既容易漏,也容易把一次性的事反复做一遍空耗。
| 对比项 | Checklist A · 一次性准备 | Checklist B · 每次上线 |
| 执行频次 | 项目内一次;项目有重大变更时更新 | 每个上线批次完整执行一遍 |
| 谁来主责 | PMO 牵头,技术 Leader / 运维 / QA 分工 | 执行人主责,验证人复核,决策人拍板 |
| 完成标志 | 基线定稿并归档,团队可重复引用 | 观察期满无异常,本批次销项 |
| 失败代价 | 后续每个批次都要返工加倍 | 只影响本批次,可回退重来 |
| 载体 | 表格样例 交付度/A 页 | 表格样例 交付度/B 页 |
9.1 Checklist A:一次性准备清单
建完并确认后作为项目基线归档;上线批次之间只需维护、不需重做。
| 编号 | 项目 | 对应 SOP 环节 | 主责 |
| A-1 | 交付清单已建,按软件 / 文档 / 数据三类归集,逐项标注状态 | 第一块 交付物整理 | PMO |
| A-2 | 文档包齐套(需求 / 设计 / 测试报告 / 用户手册 / 部署文档),命名与版本格式统一 | 第一块 交付物整理 | PMO |
| A-3 | 源码与构建产物打包完成,依赖说明与环境版本随包;干净环境验证通过 | 第一块 交付物整理 | 开发 |
| A-4 | 数据交付四要素齐备(数据本身 / 数据字典 / 迁移方案 / 备份) | 第一块 交付物整理 | PMO + 开发 |
| A-5 | 基准业务场景清单已确定(内部验收与生产复测共用同一份) | 第二块 验收与测试 | PMO + 技术 Leader |
| A-6 | 验收环境建成,版本 / 配置 / 数据基线尽量与生产等价 | 第二块 验收与测试 | 运维 |
| A-7 | 部署脚本完成:覆盖停服 / 部署 / 启动 / 回退完整动作链,幂等、有成功失败输出与日志 | 第三块 部署上线 | 开发 |
| A-8 | 无法脚本化的步骤已显式标注为"人工步骤"并写明操作人 | 第三块 部署上线 | 开发 |
| A-9 | 上线方案模板已固化(五要素:窗口 / 步骤 / 回退 / 影响 / 分工) | 第三块 部署上线 | PMO |
| A-10 | 服务器资源、账号权限、网络策略、第三方接口凭证已就位(逐项登记在资源登记表,见第 11 节) | 第三块 部署上线 | 运维 |
| A-11 | 三层备份机制已建立(数据 / 配置 / 程序镜像),同一版本标记规则明确,各自验证可恢复 | 第三块 部署上线 | 运维 |
| A-12 | 账号与权限清单整理完成(含管理员账号归属与权限重置渠道;生产账号只记名称与保管人,见第 11 节) | 第四块 资料移交 | 运维 |
| A-13 | 运维知识文档完成(部署手册 / 常见故障 / 备份恢复) | 第四块 资料移交 | 开发 + 运维 |
| A-14 | 用户培训材料与培训计划完成 | 第四块 资料移交 | PMO |
| A-15 | 归档目录结构与命名规范确定 | 第五块 项目收尾 | PMO |
9.2 Checklist B:每次上线执行清单
每个上线批次复制一份本清单,按顺序执行并勾选。关卡式:前一项未过,不进入下一阶段。
| 编号 | 项目 | 关卡 | 对应 SOP 环节 |
| B-1 | 本批次上线范围已确认(哪些功能、影响哪些模块) | 准备 | 第三块 部署上线 |
| B-2 | 本批次上线方案五要素齐备,技术 Leader 已确认 | 准备 | 5.1 上线准备 |
| B-3 | 本批次依赖复核通过(资源 / 权限 / 网络 / 凭证),无缺项 | 准备 | 5.1 上线准备 |
| B-4 | 三层备份完成(数据 / 配置 / 程序镜像),同一版本标记,各自确认可恢复 | 准备 | 5.1 上线准备 |
| B-5 | 部署脚本在类生产环境预演:正向执行跑通 | 预演 | 5.2 上线预演 |
| B-6 | 部署脚本预演:回退脚本实际跑通(回退演练同时验证程序层备份可用) | 预演 | 5.2 上线预演 |
| B-7 | 预演发现的脚本缺陷已修复并从安全步骤重跑 | 预演 | 5.2 上线预演 |
| B-8 | 执行前最后确认:窗口到点、人员就位、备份确认、决策人宣布开始 | 执行 | 5.3 生产执行 |
| B-9 | 逐步执行逐步勾选,无未上报的自行变通 | 执行 | 5.3 生产执行 |
| B-10 | 本批次变更记录完整(改什么 / 为什么 / 怎么回退) | 执行 | 5.3 生产执行 |
| B-11 | 基准业务场景在生产环境复测全部通过 | 验证 | 5.4 上线验证 |
| B-12 | 外围检查完成(定时任务 / 消息通知 / 对外接口 / 日志) | 验证 | 5.4 上线验证 |
| B-13 | 观察期已设置(时长 + 异常响应人 + 响应时限) | 观察 | 5.5 观察期 |
| B-14 | 观察期满无异常,正式宣布本批次上线完成并销项 | 观察 | 5.5 观察期 |
两份清单的分界判断:问一句"这件事,下一个上线批次还要不要再做一遍?"——要,就进 B;不要、做完就一直用,就进 A。拿不准的,通常是 A(因为 A 做扎实了,B 才会短)。
10. 附件一:交付 checklist 样例
附件:
能力中台-交付checklist样例-v3.xlsx,可直接下载,以能力中台项目为例。
用途:本 SOP 的清单是"通用骨架",但每个项目组的
具体事项不同——同一项 A-11"三层备份机制",在单体项目里可能只有两台服务器,在系统集成项目里却涉及多套系统各自的数据库与中间件。
样例把骨架落到一个真实项目上,团队照着改比从空白开始快得多。
另有一份配套附件:
项目资源登记表样例(见第 11 节),承载 A-10 与 A-12 的底账。
10.1 表格结构:交付 checklist
| 工作表 | 内容 |
| 项目概况 | 项目基本信息 + 交付范围(软件 / 文档 / 数据三要素的具体条目) |
| A-一次性准备 | 16 项通用骨架条目(含 A-16 遗留项承接位),落到能力中台的具体事项(含对应交付物与验收口径) |
| 版本变更 | 每次上线复核清单时的增删改记录(类型 / 影响编号 / 发现人)——清单靠这条链迭代 |
| B-本次上线 | 14 项骨架 + 本批次执行明细 + 版本信息(version / 上一版 / supersedes);不做批次累积 |
| 运营看板 | 当前文件内 A 清单完成度与清单迭代统计(自动公式;B 每批清零,进度看 B 表右侧 KPI) |
| 填写说明 | 怎么用这份表、哪些格子是公式不要覆盖 |
10.2 使用方法
- 一个批次复制一份文件:上线前把整份文件另存为"<项目名>-交付checklist-v<版本>-<上线窗口>.xlsx";不要在同一份文件里做第二次上线——下一批会覆盖上一批留下的痕迹;
- 先改项目概况:把交付范围换成自己的软件 / 文档 / 数据条目——后面的清单都要挂在这份范围上;
- 逐条改写 A 清单:保留骨架条目编号(方便对回本 SOP),把"能力中台的具体事项"改成自己的;通用项直接沿用;
- 复核清单并记改动:第一次上线才发现清单不足是常态——本次增删改了哪条,记到"版本变更"页,下一次复制自然带上;
- 看板不用手填:完成率与统计由公式自动算,只看不改。
10.3 一个批次一份文件:全量快照,而不是一张累积表
清单本身不是一成不变的:第一次上线发现 checklist 不足,就会修改补充;第二次上线的清单已经和第一次不同了。所以执行记录不靠"一张不断追加的表",而是靠"每次上线都完整留存一份文件":
| 原则 | 做法 |
| 一个批次一份文件 | 每次上线复制整份文件另存,文件名带版本与上线窗口(如 能力中台-交付checklist-v3-20261024.xlsx)。作业单只有"正在做的这一份"。 |
| 每份都是全量快照 | 文件里同时带着 B(本次上线 14 项)和 A(一次性工作)的当时状态——"一次性"的工作同样会被修正(验收口径收紧、新增承接项),所以 A 也必须逐次留存,不能"做完就从表里消失"。 |
| 清单靠版本链迭代 | 每次上线复核清单时的增删改,记在文件内的"版本变更"页(改了哪条、为什么、谁发现);下一次复制就自然带上。清单没有"主模板",这条链就是主模板。 |
| 历史 = 所有文件放一起 | v1 / v2 / v3 … 按文件名排列即时间线;复盘、审计、追责都翻对应那一份,旧文件不复用、不覆盖、不删除。 |
一句话记法:文件 = 快照,版本变更页 = diff,全部文件 = 历史。表格内的"运营看板"只汇总当前这一份的状态——跨批次的趋势要看文件序列,不看任何一张"累积表"。
11. 附件二:项目资源登记表样例
A-10(资源与凭证就位)与 A-12(账号与权限清单)最容易被含糊过去——"都配好了"是判断,不是记录。资源登记表就是让这两条可查、可交接、可追责的那张底账:服务器在哪、账号归谁管、密钥谁持有,一页看完。它同时支撑 B-3(依赖复核)。
11.1 三条纪律
纪律一:表里不存密钥。登记表是"索引",只记密钥编号 + 保管人 + 指纹,密钥本体一律不进表、不进群、不进邮件。
纪律二:默认密钥登录。服务器一律走密钥(或堡垒机 + 密钥),这样不必在表里记服务器登录账号——少记一个字段,就少一处泄露面。
纪律三:生产账号只记"是谁的"。生产环境账号只填名称与保管人,"具体信息"列留空;只有开发 / 测试内部账号才允许写明文(如表里 ZH-11 至 ZH-14)。
11.2 表格结构
| 工作表 | 内容 |
| 使用说明 | 三条纪律 + 填写顺序(先建账号与云资源,再登记密钥,最后看总览) |
| 账号登记 | 14 个账号:名称 / 用途 / 使用环境 / 保管人 / 账号类型 / 具体信息(仅开发、测试内部账号填写)/ 重置找回方式 / 最近确认日期 |
| 云资源 | 20 项资源,按开发 / 测试 / 生产三环境分组:ECS、MySQL、PostgreSQL、Redis、API 网关、ALB、对象存储、堡垒机;含规格版本、内网地址、是否公网暴露、所属可用区、密钥编号、登录账号(可选)、登录方式、保管人 |
| 密钥与登录 | 4 组密钥:用途 / 第一保管人 / 备份保管人 / 适用服务器 / 生成日期 / 指纹(SHA256 前 16 位)/ 离职是否已交接 |
| 资源总览 | 自动汇总:三环境资源分布、账号总数、生产账号数、用密钥登录的服务器数、仍用口令的服务器数、未登记登录方式的服务器数、密钥组数 |
| 填写说明 | 哪些格子是公式不要覆盖、红色/黄色底纹各代表什么 |
11.3 颜色就是待办
- 红色底纹:生产环境的行,却在"具体信息"里写了口令——这是违规,必须清空;或生产服务器没填登录方式——必须补上。
- 黄色底纹:某台服务器仍靠口令登录——这是一条待办,目标是把"仍用口令的服务器数"这一指标压到 0。
11.4 使用方法
- 先登云资源:把三个环境所有服务器、数据库、中间件按编号列全——这一列全了,才知道后面要维护多少账号和密钥;
- 再登账号:每个账号必填保管人;生产账号只写名称与用途,具体信息留空;
- 后登密钥:一组密钥对(或一组堡垒机凭据)对应多台服务器时,用"适用服务器编号"一栏串联;第一保管人与备份保管人不能是同一人;
- 看总览做体检:交接前先看"仍用口令的服务器数"和"未登记登录方式的服务器数"是否为 0;
- 随变更更新:每新增一台服务器或一个账号,当天登记;人员离职时按"是否已离职交接"列完成密钥换发,并更新保管人。
12. 检查方式
PMO 按清单销项自查;部门负责人在签字环节前查看清单完成度(清单就是给负责人的"一屏");技术 Leader 负责上线方案与预演结果的确认。资源登记表由运维在移交前提交,随资料移交一并归档。
13. 不在本 SOP 约定的事项
范围边界见第1节。项目组的具体事项由各项目在自己的清单副本中定义,本 SOP 只约定骨架与判定规则。资源登记表的具体平台选型(用哪家云、是否上堡垒机)由运维体系另行约定。
14. 修订记录
| 日期 | 版本 | 说明 |
| 2026-09-21 | V0.1 | 初稿发布,进入试行(五块结构;部署上线五阶段;checklist 关卡式) |
| 2026-09-21 | V0.2 | 补数据交付:交付三要素(软件/文档/数据)、数据交付四要素(数据/数据字典/迁移方案/备份)、数据移交验证(导入+抽样核对);checklist 增至 16 项 |
| 2026-10-19 | V2.0 | 按评审意见修订(版本化、干净环境验证顺序统一、验收签字归属明确、补充遗漏项与机制说明;checklist 增至 17 项) |
| 2026-10-20 | V3.0 | 按"一次性 / 每次上线"拆分为两份 checklist(A 15 项、B 14 项,附分界判断);新增附件电子表格样例(能力中台项目);删去原单张 17 项 checklist |
| 2026-10-20 | V3.0 | 新增第二份附件「项目资源登记表样例」,承载 A-10 / A-12 / B-3;确立三条纪律(表内不存密钥、默认密钥登录、生产账号只记名称与保管人);原第 10 节拆为"附件一 交付 checklist"与"附件二 资源登记表",后续章节顺延 |
15. 历史版本