工程实践

软件项目交付前,我们一定会检查的 12 项

交付质量不是靠"测试同学仔细一点",而是靠一份每次都要走完的检查清单。这是我们内部实际使用的清单,公开出来供参考。

项目交付出问题,很少是因为某个环节"没人会做",而是因为某个环节被漏掉了。清单的价值就在于把依赖记忆的事情变成依赖流程的事情。

以下是我们每个项目上线前都会逐项确认的 12 项,按类别组织。

一、功能完整性(1–3)

  1. 核心闭环是否端到端跑通?不是"每个功能都能点",而是"从创建到完成的整条链路能走完",包括异常分支(取消、退回、超时)。
  2. 权限边界是否逐角色验证?用每个真实角色各登录一次,确认该看到的有、不该看到的没有。越权访问是最常见也最危险的遗漏。
  3. 边界数据是否测试?空列表、超长文本、0 元订单、重复提交、特殊字符——这些不是边角情况,而是日常。

二、数据与安全(4–6)

  1. 备份是否已配置且验证可恢复?"有备份文件"和"能恢复"是两件事。上线前至少做一次真实恢复演练。
  2. 敏感信息是否脱离代码库?数据库密码、API 密钥、证书私钥不应出现在源码或前端包里。
  3. HTTPS 与安全头是否配置?证书有效期、强制跳转、HSTS、基础 CSP。这一步漏掉,浏览器会给访客显示"不安全"警告。

三、性能与容量(7–8)

  1. 首屏加载时间是否达标?移动端 4G 环境下首屏应低于 2 秒。用真实设备测,不要只看开发机的本地速度。
  2. 关键接口的响应时间是否有基线?记录主要接口在正常数据量下的耗时,作为后续劣化的对照基准。

四、可运维性(9–11)

  1. 日志是否可定位问题?出故障时,能否通过日志还原"谁在什么时候做了什么、在哪一步失败"。日志里不要打印敏感数据。
  2. 部署流程是否可重复?换一个人按文档操作,能否在干净环境里部署成功。做不到就说明文档或脚本有问题。
  3. 回滚方案是否演练过?不是"写了一个回滚文档",而是"真的执行过一次并成功"。

五、交接与文档(12)

  1. 交付物是否齐全?至少包括:源码、数据库结构与初始化脚本、接口文档、部署手册、运维说明、已知问题列表。

为什么"已知问题列表"也要交付

这一项经常被省略,但它其实是专业度的体现。任何系统都有已知的局限:某个场景性能不佳、某个浏览器兼容性有问题、某个功能是临时方案。主动写清楚,客户在遇到时不会认为"你们藏了问题";不说,才是真正的隐患。

交付不是"我认为做完了",而是"我能证明它符合约定,并且别人能接手继续维护"。

需要针对你的情况做判断?

文章是通用方法,实际项目总有具体约束。约 30 分钟,我们给出更有针对性的建议。

预约免费评估
交付质量项目管理运维