交付项目 SOP

研发团队 SOP 体系 · 里程碑型 SOP
版本:V3.0(试行) 发布日期:2026-10-20 责任主体:PMO(交付负责人) 状态:试行(试行期至 2026-12-31,期满由 PMO 组织评估调整)

1. 定位与边界

2. 总体流程

交付物整理 → 验收与测试 → 部署上线 → 资料移交 → 项目收尾 (备齐 → 证明 → 上线 → 移交 → 结清,风险递减顺序)

3. 第一块:交付物整理

交付三要素:软件 + 文档 + 数据——三者都是交付物,缺一不可。交付清单必须覆盖三要素。
  1. 对照合同/立项文件建交付清单:逐项列出应交付物,按软件 / 文档 / 数据三类归集(系统、源码、文档包、业务数据、账号……),逐项标注状态(齐/缺/部分)——清单是后续所有环节的对照物,相当于项目级"交付标准",也是全流程的总线(交付清单销项指交付物逐项完成状态更新;checklist 销项指本 SOP 步骤项完成,两者并行维护);
  2. 文档包齐套:需求、设计、测试报告、用户手册、部署文档——按清单核对,缺的补、旧的更新;
  3. 格式统一:命名规范、版本号、模板一致——对外交付物注意公司形象;
  4. 源码与构建产物打包:可编译、可部署、可复现——附依赖说明与环境版本;构建后在干净环境验证一次"能跑起来",验证通过才算打包完成;
  5. 数据交付四要素(凡合同约定交付数据的,缺一不可):
    • 数据本身:按约定格式导出(数据库脚本 / 备份文件 / 结构化文件),含交付时点说明;
    • 数据字典:表结构、字段含义、枚举值说明——没有数据字典的数据对方接不住;
    • 迁移方案:数据如何导入目标环境(步骤、工具、依赖)、迁移后如何核对;
    • 数据备份:交付数据自身留一份备份(对应运维分册(研发团队 SOP 体系)备份要求),交付出问题可重来。

4. 第二块:验收与测试

  1. 交付前内部验收:项目级基准业务场景全过(开发任务 SOP 自测分级的项目级放大:基准必须、边界尽力;基准业务场景清单由 PMO 会同技术 Leader 在交付物整理阶段确定,纳入交付清单管理);内部验收不通过不发起正式验收;
  2. 验收环境准备:环境、数据、演示场景就绪——验收环境应尽量与生产环境等价(版本、配置、数据基线一致),避免验收环境通过而生产环境异常;验收前一天由执行人自查一遍;
  3. 陪同验收支持:现场/远程演示、问题当场逐条编号记录;
  4. 验收意见闭环:逐条响应——缺陷走修复(按开发任务 SOP 走新任务),非缺陷项书面说明;全部闭环后才进入验收签字环节(签字由商务主导、PMO 配合,与第7块衔接);正式验收不通过时,缺陷项走修复闭环后重新组织验收,延期影响同步商务与部门负责人。

5. 第三块:部署上线(五阶段)

5.1 阶段一:上线准备

  1. 上线方案五要素:
    • 时间窗口:明确日期时段,含"最迟开始时间"——过了这个点自动改期,不带病上线;改期由决策人宣布,窗口顺延规则与对后续计划的影响同步明确;
    • 步骤清单:逐条操作步骤(谁、做什么、预期结果),每步可勾选;
    • 回退方案:回退条件(什么情况立即回退、谁有权决定)+ 逐条回退步骤;
    • 影响评估:上线期间受影响的服务、时长、需提前知会的人;
    • 人员分工:执行人、验证人、决策人(回退拍板者)——三角色可两人兼任,但不能是一人。
  2. 部署脚本化要求:部署步骤应脚本化(部署脚本/发布工具配置),人工清单只作辅助:
    • 脚本覆盖停服/部署/启动/回退的完整动作链;
    • 脚本要素:幂等(重复执行不出错)、明确的成功/失败输出、关键步骤有日志;
    • 无法脚本化的步骤(硬件操作、需人工确认的授权)显式标注为"人工步骤",写明操作人。
  3. 方案确认:技术 Leader 确认技术部分;影响面大的(核心业务系统)部门负责人知会;
  4. 依赖就绪检查:服务器资源、账号权限、网络策略、第三方接口凭证——上线前一天全部到位,缺一项改期;
  5. 上线前三层备份(缺一不可):
    备份层内容为什么
    数据层数据库、上传文件、业务数据业务资产的本体
    配置层配置文件、环境变量、参数调优生产环境跑着的配置 ≠ 代码库里那份,含运行期改过的参数
    程序层系统二进制镜像 / 部署包(当前生产版本)回退要退回"原来的那个版本",不是"重新构建一个大概像的"
    三层各自验证可恢复;三层打同一版本标记——回退时配套退到同一时刻的完整状态,混用不同时刻的备份会制造出从未存在过的系统状态。

5.2 阶段二:上线预演(部署脚本的测试)

  1. 预演 = 部署脚本测试:在类生产环境用部署脚本完整执行一遍,正向 + 回退都实际跑——回退脚本没跑过等于没有回退脚本;预演不通过不进生产;
  2. 预演记录与修正:发现的脚本缺陷(漏步、顺序、权限、环境差异)修复脚本后从安全步骤重跑,不是记录了事——预演的意义是让方案变对,不是让流程走完;
  3. 双重验证:回退演练实际用到的正是程序层备份——演练跑通即同时验证了脚本可用与备份可用;
  4. 脚本入库:部署脚本随源码归档,并计入交付清单(脚本也是交付物)。

5.3 阶段三:生产执行

  1. 执行前最后确认:窗口时间到 → 参与人就位 → 三层备份完成确认 → 决策人宣布开始;
  2. 逐步执行逐步勾选:每步完成即勾选并记录实际结果;任何一步与预期不符 → 停下来上报决策人,不自行变通——自行变通是上线事故的最大来源;
  3. 变更记录:改了什么配置、动了哪些文件——变更三要素(改什么/为什么/怎么回退,属研发团队 SOP 体系)的落实。

5.4 阶段四:上线验证

上线配套宣讲与发版通知:面向运营与业务员的讲解/视频须在发版前完成;验证通过后由技术负责人在群内发布版成功通知,再由产品发送发版成功邮件——见《版本上线配套宣讲与发版通知流程》。
  1. 基准场景复测:基准业务场景在生产环境全部走通——复测通过才算上线完成,否则按回退方案处理;
  2. 外围检查:定时任务、消息通知、对外接口、日志无异常——这些"不在演示路径上"的功能最容易漏。

5.5 阶段五:观察期

  1. 观察期设置:时长按项目风险定(常规 1~3 个工作日,核心系统可一周);观察期内异常响应人、响应时限明确;
  2. 观察期结束确认:期满无异常,正式宣布上线完成,交付清单销项;观察期内出问题按缺陷处理 SOP(研发团队 SOP 体系)走。

6. 第四块:资料移交

与观察期并行:资料移交与用户培训可与观察期(5.5)并行开展,观察期满确认后交付清单统一销项。
  1. 账号权限移交:管理员账号、系统权限清单,书面移交、接收方确认;移交后接收方应立即重置管理员密码,账号口令通过安全渠道传递,不随书面材料明文流转;
  2. 运维知识移交:部署手册、常见故障处理、备份恢复方法——按"文档化生命线"标准整理,移交后对方能独立处理常规问题;
  3. 数据移交验证(如交付含数据):接收方按迁移方案实际导入一遍,抽样核对关键数据的数量与内容——导入成功 + 抽样一致,数据移交才算完成;
  4. 用户培训:操作培训 + 培训材料留存;培训完成让用户实际操作一遍(不是只看演示)。

7. 第五块:项目收尾

  1. 文件归档:全过程文档归档入库(含讨论记录、决策记录、部署脚本);
  2. 未完结事项显式移交:遗留问题、二期需求、已知限制——成文移交,不带暗账;
  3. 项目复盘会:目标达成度、过程得失;输出复盘纪要(任务级 30 秒复盘的项目版);
  4. 商务收尾配合:验收签字、款项节点通知——PMO 配合商务,不主导。

8. 贯穿原则

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 使用方法

  1. 一个批次复制一份文件:上线前把整份文件另存为"<项目名>-交付checklist-v<版本>-<上线窗口>.xlsx";不要在同一份文件里做第二次上线——下一批会覆盖上一批留下的痕迹;
  2. 先改项目概况:把交付范围换成自己的软件 / 文档 / 数据条目——后面的清单都要挂在这份范围上;
  3. 逐条改写 A 清单:保留骨架条目编号(方便对回本 SOP),把"能力中台的具体事项"改成自己的;通用项直接沿用;
  4. 复核清单并记改动:第一次上线才发现清单不足是常态——本次增删改了哪条,记到"版本变更"页,下一次复制自然带上;
  5. 看板不用手填:完成率与统计由公式自动算,只看不改。

10.3 一个批次一份文件:全量快照,而不是一张累积表

清单本身不是一成不变的:第一次上线发现 checklist 不足,就会修改补充;第二次上线的清单已经和第一次不同了。所以执行记录不靠"一张不断追加的表",而是靠"每次上线都完整留存一份文件":

原则做法
一个批次一份文件每次上线复制整份文件另存,文件名带版本与上线窗口(如 能力中台-交付checklist-v3-20261024.xlsx)。作业单只有"正在做的这一份"。
每份都是全量快照文件里同时带着 B(本次上线 14 项)和 A(一次性工作)的当时状态——"一次性"的工作同样会被修正(验收口径收紧、新增承接项),所以 A 也必须逐次留存,不能"做完就从表里消失"。
清单靠版本链迭代每次上线复核清单时的增删改,记在文件内的"版本变更"页(改了哪条、为什么、谁发现);下一次复制就自然带上。清单没有"主模板",这条链就是主模板。
历史 = 所有文件放一起v1 / v2 / v3 … 按文件名排列即时间线;复盘、审计、追责都翻对应那一份,旧文件不复用、不覆盖、不删除。
一句话记法:文件 = 快照,版本变更页 = diff,全部文件 = 历史。表格内的"运营看板"只汇总当前这一份的状态——跨批次的趋势要看文件序列,不看任何一张"累积表"。

11. 附件二:项目资源登记表样例

附件:能力中台-项目资源登记表样例.xlsx,可直接下载,以能力中台项目为例。

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 颜色就是待办

11.4 使用方法

  1. 先登云资源:把三个环境所有服务器、数据库、中间件按编号列全——这一列全了,才知道后面要维护多少账号和密钥;
  2. 再登账号:每个账号必填保管人;生产账号只写名称与用途,具体信息留空;
  3. 后登密钥:一组密钥对(或一组堡垒机凭据)对应多台服务器时,用"适用服务器编号"一栏串联;第一保管人与备份保管人不能是同一人;
  4. 看总览做体检:交接前先看"仍用口令的服务器数"和"未登记登录方式的服务器数"是否为 0;
  5. 随变更更新:每新增一台服务器或一个账号,当天登记;人员离职时按"是否已离职交接"列完成密钥换发,并更新保管人。

12. 检查方式

PMO 按清单销项自查;部门负责人在签字环节前查看清单完成度(清单就是给负责人的"一屏");技术 Leader 负责上线方案与预演结果的确认。资源登记表由运维在移交前提交,随资料移交一并归档。

13. 不在本 SOP 约定的事项

范围边界见第1节。项目组的具体事项由各项目在自己的清单副本中定义,本 SOP 只约定骨架与判定规则。资源登记表的具体平台选型(用哪家云、是否上堡垒机)由运维体系另行约定。

14. 修订记录

日期版本说明
2026-09-21V0.1初稿发布,进入试行(五块结构;部署上线五阶段;checklist 关卡式)
2026-09-21V0.2补数据交付:交付三要素(软件/文档/数据)、数据交付四要素(数据/数据字典/迁移方案/备份)、数据移交验证(导入+抽样核对);checklist 增至 16 项
2026-10-19V2.0按评审意见修订(版本化、干净环境验证顺序统一、验收签字归属明确、补充遗漏项与机制说明;checklist 增至 17 项)
2026-10-20V3.0按"一次性 / 每次上线"拆分为两份 checklist(A 15 项、B 14 项,附分界判断);新增附件电子表格样例(能力中台项目);删去原单张 17 项 checklist
2026-10-20V3.0新增第二份附件「项目资源登记表样例」,承载 A-10 / A-12 / B-3;确立三条纪律(表内不存密钥、默认密钥登录、生产账号只记名称与保管人);原第 10 节拆为"附件一 交付 checklist"与"附件二 资源登记表",后续章节顺延

15. 历史版本