研发平台上线验收要回答的核心问题是：平台是否具备正式承载研发工作的条件。建议按“部署环境—平台基础能力—集成与权限—业务配置与数据—运维与回退”五个阶段逐项检查，每项写明通过标准、证据和负责人。登录不可用、数据丢失风险、无可用备份、权限越界四类问题设为阻断项，未关闭不得宣布上线。下文给出可直接使用的分阶段检查表。
要点总览（TL;DR）
- 研发平台上线验收按“部署环境—平台基础能力—集成与权限—业务配置与数据—运维与回退”五个阶段推进，每项写明通过标准、证据和负责人。
- 登录不可用、数据丢失风险、无可用备份、权限越界四类问题设为阻断项，未关闭不得宣布正式上线。
- 恢复演练要作为独立通过标准：只配置备份任务、未验证恢复，不能证明备份可用。
- 上线完成需同时满足检查项全部有结论、阻断项全部关闭、验收负责人与运维及安全负责人签字确认。
- 上线后首周复核登录、权限、备份与告警四项，发现问题转入遗留问题跟踪表并明确处理时限。
谁在什么时点使用这份验收清单
这份清单的验收对象是私有化部署的研发平台，覆盖从部署完成到上线后首周复核的完整过程。它不评估平台选型是否合理，也不展开业务配置治理方法，只判断当前这套环境能否安全、稳定地投入正式使用。
验收涉及四类角色，职责需要在上线前明确到人：
- 平台运维：负责服务器、存储、网络、服务进程、监控告警与备份恢复，提供环境层与运维层的检查证据。
- 安全负责人：负责账号来源、登录方式、权限边界与数据隔离的核查，对权限越界类问题有一票否决权。
- 业务配置负责人：负责项目模板、工作项类型、字段、状态流转与历史数据的核对，确认平台配置与实际研发流程一致。
- 验收负责人：组织联合验收、汇总检查结果、判定阻断项是否关闭，并主持上线签字。
清单在三个时点使用，每个时点的检查深度不同：
| 使用时点 | 主要动作 | 参与角色 | 产出 |
|---|---|---|---|
| 部署完成自检 | 运维逐项检查环境、服务、访问入口，确认平台可进入功能验收 | 平台运维 | 环境自检记录与问题清单 |
| 上线前联合验收 | 四类角色按阶段联合检查，逐项判定通过与否，关闭或登记阻断项 | 全部角色 | 验收结论、阻断项清单、签字记录 |
| 上线后首周复核 | 复核登录、权限、备份、告警在真实使用下的表现 | 平台运维、安全负责人、验收负责人 | 首周复核记录与遗留问题跟踪表 |
三个时点的检查项可以复用同一张表，但自检阶段允许部分业务配置项标记为“待联合验收”，联合验收阶段则要求全部检查项有明确结论。
第一阶段：部署环境与基础可用性检查
环境层检查的目标是判断平台是否具备进入功能验收的条件。这一阶段不通过，后续检查没有意义，因此建议安排在部署完成后立即执行，由平台运维主导、验收负责人抽查。
| 检查项 | 通过标准 | 证据 | 负责人 |
|---|---|---|---|
| 服务器资源 | CPU、内存、磁盘容量满足交付方案要求，资源占用处于合理区间 | 资源监控截图或系统命令输出 | 平台运维 |
| 存储可用性 | 数据盘挂载正常，剩余空间满足上线后预估增长，读写无异常 | 挂载信息与读写测试记录 | 平台运维 |
| 网络与端口连通 | 平台所需端口在防火墙策略下可达，客户端到服务端链路通畅 | 端口探测结果、连通性测试记录 | 平台运维 |
| 服务启动与健康检查 | 各服务进程处于运行状态，健康检查接口返回正常 | 服务状态截图、健康检查返回结果 | 平台运维 |
| 日志可读性 | 应用日志与系统日志可正常写入、可检索，错误日志无持续异常刷屏 | 日志片段 | 平台运维 |
| 域名与证书 | 访问域名解析正确，证书在有效期内且与域名匹配，浏览器无证书告警 | 证书信息截图、访问截图 | 平台运维 |
| 访问入口可用 | 通过正式入口可打开登录页，静态资源加载完整 | 访问截图 | 平台运维 |
环境层有两处容易被忽略。一是证书有效期，验收时正常不代表上线后一个月仍正常，应把到期时间记录在案并纳入监控。二是日志可读性，日志能写入但无法检索，故障排查时同样被动，检查时应实际执行一次关键字检索。ONES 私有化部署采用 K3s 容器化部署，服务以容器方式运行，检查服务状态时可结合容器运行状态与平台健康检查一并确认。
第二阶段：账号、权限与集成检查
这一阶段确认“谁能进得来、进来能看到什么、平台能否与研发工具链协同”。账号与权限问题直接关系数据安全，集成问题影响研发流程能否在平台上闭环，两类都需要保留可观察的证据。
| 检查项 | 通过标准 | 证据 | 负责人 |
|---|---|---|---|
| 账号来源 | 账号由约定来源创建，账号数量与预期一致，无来源不明的账号 | 账号列表导出、来源系统对照记录 | 安全负责人 |
| 登录方式 | 约定的登录方式可用，认证失败时有明确提示，管理员账号可正常登录 | 登录成功与失败截图 | 安全负责人 |
| 角色权限边界 | 抽查普通成员、项目管理员、系统管理员三类角色，各自可见范围与操作权限符合设计 | 各角色操作截图与权限配置截图 | 安全负责人 |
| 项目权限隔离 | 非项目成员无法访问项目数据，跨项目数据不可见 | 越权访问尝试记录 | 安全负责人 |
| 企业系统对接 | 与内部身份系统（如 LDAP）的对接连通，账号同步结果与源系统一致 | 同步日志、账号比对记录 | 平台运维 |
| 代码库与流水线集成 | 约定的代码库、流水线在平台内可关联，提交与构建状态可回传 | 集成配置截图、一次完整联动的操作记录 | 平台运维 |
| 消息通知集成 | 平台通知可送达约定的消息渠道，通知内容包含必要信息 | 通知到达截图 | 平台运维 |
集成检查的关键是留下“失败时也能观察”的证据。只截一张成功页面不足以说明集成稳定，建议同时记录一次失败场景：例如断开目标系统后，平台是否给出明确错误提示、是否写入集成日志、是否影响其他功能。ONES 私有化部署支持对接企业内部系统（如 LDAP），具体对接范围与配置方式需按实际交付方案确认，验收时以方案约定的集成清单为准逐项核对。
第三阶段：业务配置与数据检查
业务层检查确认平台配置与团队实际研发流程一致，历史数据在平台上可用。这一阶段的检查对象是配置结果和数据结果，判断依据来自业务配置负责人的实际操作，而非配置界面是否存在对应选项。
| 检查项 | 通过标准 | 证据 | 负责人 |
|---|---|---|---|
| 项目模板 | 约定模板可创建项目，模板内工作项类型齐全，新建项目无需二次手工补配 | 按模板创建项目的截图 | 业务配置负责人 |
| 工作项类型与字段 | 工作项类型、必填字段、字段选项与设计文档一致 | 配置截图与设计文档对照表 | 业务配置负责人 |
| 状态流转 | 关键工作项的状态流转路径正确，流转条件与权限限制生效 | 完整走一遍流转的操作记录 | 业务配置负责人 |
| 配置与权限一致性 | 字段级、状态级权限设置与角色设计一致，敏感字段对无权限角色不可见 | 不同角色视角的截图 | 安全负责人 |
| 历史数据抽样核对 | 按约定比例抽样比对导入或迁移前后的记录数、关键字段值与附件，差异在可接受范围内且有清单 | 抽样比对表、差异清单 | 业务配置负责人 |
| 配置变更审批与记录 | 验收期间的配置变更均有审批记录，变更内容可追溯 | 变更记录与审批截图 | 验收负责人 |
历史数据核对要提前约定抽样口径，例如按项目抽取、按时间区间抽取或按数据量比例抽取，并把允许的差异范围写进验收方案。发现差异时登记为问题项并注明处理结论，避免验收结束后再回头争论数据是否完整。验收期间的配置变更建议集中记录，配置项与检查证据可以放在同一份验收文档中管理，ONES 的工作项与文档能力可用于承载检查项状态、负责人和证据附件，使每项结论都能对应到具体记录。
第四阶段：运维、备份与回退检查
运维层检查回答两个问题：上线后出问题能否第一时间发现，出现严重故障能否安全回退。这一阶段的检查结果直接决定阻断项判定，建议由平台运维提供证据、验收负责人复核。
| 检查项 | 通过标准 | 证据 | 负责人 |
|---|---|---|---|
| 监控项覆盖 | 服务可用性、资源使用率、关键接口响应等监控项已配置并处于生效状态 | 监控配置截图与当前状态 | 平台运维 |
| 告警通知对象 | 告警可送达值班人员，通知渠道与接收人清单明确 | 测试告警的送达截图 | 平台运维 |
| 备份策略 | 备份范围覆盖平台数据与配置，备份周期与保留时长符合约定，最近一次备份成功 | 备份任务配置与执行记录 | 平台运维 |
| 恢复演练 | 在非生产环境完成一次恢复演练，恢复后数据可访问、关键功能可用，恢复耗时记录在案 | 恢复演练报告 | 平台运维 |
| 回退方案 | 回退步骤、执行人、预计耗时明确，回退触发条件有书面约定 | 回退方案文档 | 验收负责人 |
| 升级与补丁窗口 | 升级与补丁的变更窗口、审批流程、通知范围已约定 | 变更管理约定记录 | 平台运维 |
恢复演练是这一阶段最容易被跳过的项。只配置备份任务、不做恢复验证，无法证明备份可用，因此应把“完成一次恢复演练并有报告”作为通过标准，而不是“已配置备份”。回退方案要写清触发条件，例如核心功能不可用超过约定时长、数据异常无法在约定时间内修复，触发后由谁决策、按什么顺序执行。若采用高可用集群部署，ONES 支持故障转移、数据容灾与零停机服务升级，验收时可结合交付方案确认相关能力的前提条件，并把验证方式写入检查记录。
阻断项清单与上线完成条件
阻断项是上线判定中不可让步的部分。建议限定为四类，出现任一类即暂停上线，直到关闭并留存证据：
| 阻断项 | 判定情形 | 关闭条件 |
|---|---|---|
| 登录不可用 | 约定登录方式无法完成认证，或管理员无法登录 | 登录成功并有截图，失败场景有明确提示 |
| 数据丢失风险 | 历史数据核对发现缺失且无法解释，或导入过程存在未处理异常 | 差异清单逐项有结论，剩余差异经业务确认可接受 |
| 无可用备份 | 备份任务未成功执行，或恢复演练未通过 | 备份成功且有恢复演练报告 |
| 权限越界 | 非授权角色可访问项目数据或敏感字段 | 权限配置修正后复测通过 |
阻断项未关闭时，处理方式应事先约定：由验收负责人登记问题、指定责任人与关闭时限，期间平台可保持试运行状态，但不得对外宣布正式上线。若因业务时间要求必须上线，需由业务负责人书面确认风险并限定使用范围，该确认本身也应作为验收证据归档。
宣布上线完成需同时满足三个条件：五个阶段检查项全部有结论，阻断项全部关闭，验收负责人、平台运维负责人、安全负责人完成签字确认。上线后首周复核聚焦四项：登录成功率与异常登录、权限配置在真实使用中是否出现越界、备份任务是否按周期成功执行、告警是否实际触发并送达。首周复核发现的问题转入遗留问题跟踪表，明确责任人与处理时限。
验收证据归档与责任落实
验收结论要有证据支撑，口头确认在事后无法复核。每类检查项应留存对应证据，并按统一规则命名和归档。
| 证据类型 | 适用检查项 | 留存要求 | 签字人 |
|---|---|---|---|
| 截图 | 配置核对、权限边界、访问入口、通知送达 | 包含时间与操作账号，关键信息清晰可读 | 检查执行人 |
| 日志片段 | 服务健康、集成连通、告警触发 | 保留时间范围与关键字，注明来源服务 | 平台运维 |
| 测试记录 | 登录、权限抽查、状态流转、集成联动 | 记录操作步骤、预期结果与实际结果 | 检查执行人与复核人 |
| 恢复演练报告 | 备份与恢复 | 包含演练时间、恢复范围、耗时与结论 | 平台运维与验收负责人 |
证据命名建议采用“阶段编号-检查项-日期-执行人”的结构，统一存放在验收文档的对应章节下，使每项结论可直接追溯到证据。签字规则按两级设置：检查执行人对证据真实性签字，验收负责人对判定结论签字；阻断项关闭还需安全负责人或平台运维负责人附加签字。证据缺失时，该项按未通过处理，补齐证据后重新判定，不以“已口头确认”替代。
把检查项、证据和签字记录放在同一处管理，可以减少验收结束后的追溯成本。ONES 的文档与工作项能力可用于承载验收清单、证据附件和阻断项状态，使每项检查从执行到关闭都有记录可查。
常见问题
验收期间业务方要求先上线、后补检查项，怎么处理？
先区分未完成项是否属于阻断项。登录不可用、数据丢失风险、无可用备份、权限越界这四类未关闭时，不建议宣布正式上线；如因业务时间要求必须开放使用，需由业务负责人书面确认风险并限定使用范围，该确认作为验收证据归档。非阻断项可以带条件上线，但要登记责任人与关闭时限，并在首周复核时逐项确认。
历史数据抽样核对发现差异，验收还能通过吗？
可以，前提是差异有清单、有结论。验收前应约定抽样口径和允许的差异范围，发现差异时逐条登记并注明处理结论，例如补导、业务确认可接受或标记为遗留问题。剩余差异经业务负责人确认可接受后，该项可判定通过；无法解释的数据缺失属于数据丢失风险，按阻断项处理。
恢复演练一定要在非生产环境做吗？
建议在非生产环境完成，避免演练本身影响业务数据。演练报告需记录演练时间、恢复范围、恢复耗时和结论，恢复后要实际验证数据可访问、关键功能可用。如果只有生产环境可用，应选择业务低峰窗口并提前约定回退安排，演练过程同样留档。
部署完成自检和上线前联合验收可以用同一张表吗？
可以复用同一张检查表，但判定要求不同。自检阶段由平台运维执行，业务配置类检查项允许标记为“待联合验收”；联合验收阶段要求全部检查项有明确结论，阻断项关闭并完成签字。两个阶段的记录分开留存，便于追溯每项结论是在哪个时点、由谁判定的。
验收证据缺失但执行人确认已完成，能否判定通过？
按未通过处理，补齐证据后重新判定。口头确认在事后无法复核，截图、日志片段、测试记录和恢复演练报告是结论的依据。证据命名建议采用“阶段编号-检查项-日期-执行人”的结构，统一归档在验收文档对应章节下，使每项结论可直接追溯到证据。
