私有化部署的研发平台上线验收，需要把“装好了”变成“可交付、可追溯、可运维”。这份清单按环境与网络、安装与配置、账号与权限、数据与迁移、集成与接口、性能与容量、备份与恢复、安全与合规、监控与日志、文档与交接十个阶段展开，每项写明检查内容、通过标准、证据材料、负责人和检查时点。阻断项全部通过、证据归档、双方签字确认，才判定上线验收完成。ONES 的私有化部署场景中，验收问题跟踪与证据归档可承载在统一的工作项和文档里。
要点总览（TL;DR）
- 清单按环境与网络、安装与配置、账号与权限、数据与迁移、集成与接口、性能与容量、备份与恢复、安全与合规、监控与日志、文档与交接十个阶段组织，每项写明检查内容、通过标准、证据材料、负责人和检查时点。
- 证据以截图、命令输出、测试报告、日志片段和签字单为主，统一编号归档；确认记录固定检查项、结论、证据编号、负责人、日期五个字段。
- 阻断项与一般项分开管理，核心服务不可用、数据迁移不一致、备份不可恢复、高危漏洞未处置等属于阻断项，全部通过才能判定上线验收完成。
- 带条件放行需在验收报告中写明条件内容、责任方、完成时限和复检安排，双方项目负责人签字确认后归档。
- 验收问题、整改记录和证据可放在统一工作项与文档空间中管理，检查项对应工作项，证据随验收报告归档，便于复检和审计追溯。
谁在什么时点使用这份验收清单
这份清单的使用对象是私有化部署研发平台的项目双方，验收对象是部署完成后的平台环境与部署结果。使用时点是部署实施完成、准备转入正式使用之前的上线验收阶段。业务配置、流程治理、组织推广策略不在本清单范围内，这些内容应在验收通过后另行安排。
参与角色按职责分工，避免验收会上才临时找人：
| 角色 | 主要职责 | 在验收中的动作 |
|---|---|---|
| 甲方项目负责人 | 组织验收、确认范围与结论 | 召集验收会议、签署验收结论 |
| 甲方运维 | 环境、监控、备份、日常运维承接 | 核对部署结果、参与交接、确认运维可用 |
| 甲方安全 | 安全基线、漏洞与合规把关 | 审核安全项证据、确认高危问题处置 |
| 甲方测试 | 功能与性能验证 | 执行测试、提交测试报告 |
| 乙方实施负责人 | 部署交付、问题整改、文档提供 | 提供证据、整改问题、参与签字 |
基本流程是：乙方提交验收申请与证据包，甲方按清单逐项核对并记录结论，双方召开验收会议处理争议项和遗留项，阻断项全部通过后形成验收报告并签字。签字前应确认证据已按编号归档，口头确认不作为验收依据。
环境、网络与安装部署检查项
这一阶段确认基础设施与部署结果和规划一致。检查项、通过标准、证据、负责人和时点如下：
| 检查项 | 通过标准 | 证据材料 | 负责人 | 检查时点 |
|---|---|---|---|---|
| 服务器配置 | CPU、内存、磁盘规格与规划一致 | 配置截图或命令输出 | 乙方实施 | 部署完成后 |
| 操作系统与数据库、中间件版本 | 版本在双方确认的兼容清单内 | 版本查询命令输出 | 乙方实施 | 部署完成后 |
| 网络连通与端口 | 平台所需端口开放，客户端可访问 | 连通性测试记录、端口扫描结果 | 甲方运维 | 部署完成后 |
| 域名与证书 | 域名解析正确，证书有效且与域名匹配 | 访问截图、证书信息截图 | 甲方运维 | 部署完成后 |
| 服务启动状态 | 全部服务运行正常，无异常退出 | 服务状态命令输出 | 乙方实施 | 部署完成后 |
| 版本号核对 | 平台版本与合同或交付清单一致 | 版本页面截图 | 双方共同 | 验收会议前 |
| 集群或高可用节点状态（如采用） | 节点均在线，主备切换机制可用 | 节点状态截图、切换验证记录 | 乙方实施 | 部署完成后 |
若采用高可用集群部署，应额外记录节点角色、故障转移验证方式和验证结果。ONES 的高可用集群部署基于高可用架构运行，可实现故障转移、数据容灾和零停机服务升级，验收时可按项目约定方式验证节点状态与切换表现。
账号权限、数据迁移与集成接口检查项
这一阶段确认平台“有人能用、数据对得上、外部系统接得通”。
| 检查项 | 通过标准 | 证据材料 | 负责人 | 检查时点 |
|---|---|---|---|---|
| 管理员账号 | 超级管理员可登录，初始密码已按约定处理 | 登录截图、账号清单 | 乙方实施 | 部署完成后 |
| 组织与角色权限 | 组织架构、角色与权限配置符合约定方案 | 配置页面截图、权限矩阵 | 双方共同 | 验收会议前 |
| 数据迁移数量 | 迁移记录数与源系统统计一致 | 数量对比表、统计截图 | 乙方实施 | 迁移完成后 |
| 数据抽样一致性 | 按约定比例抽样，字段与附件一致 | 抽样清单、比对记录 | 甲方测试 | 迁移完成后 |
| 代码仓库、CI 等集成 | 接口连通，调用成功 | 调用结果截图、接口日志 | 乙方实施 | 集成配置后 |
| SSO 与消息通知 | 单点登录可用，通知可送达 | 登录与通知截图 | 双方共同 | 集成配置后 |
| 接口错误留痕 | 异常调用有日志可查 | 错误日志片段 | 甲方运维 | 集成配置后 |
ONES 私有化部署支持对接企业内部系统（如 LDAP），具体对接范围与配置方式应在实施阶段确认并纳入本阶段检查。数据迁移的抽样比例、比对字段和判定口径需在验收方案中事先写明，避免验收时对“一致”理解不同。
性能容量、备份恢复与安全检查项
非功能项容易在验收中被一句“感觉还行”带过，应提前约定测试口径并留下记录。
| 检查项 | 通过标准 | 证据材料 | 负责人 | 检查时点 |
|---|---|---|---|---|
| 并发与响应时间 | 按约定场景和并发数测试，结果达到约定指标 | 性能测试报告 | 甲方测试 | 验收会议前 |
| 容量与存储余量 | 磁盘、数据库容量满足约定使用周期的余量要求 | 容量统计截图 | 甲方运维 | 验收会议前 |
| 备份策略执行 | 备份任务按策略执行成功 | 备份任务记录、备份文件清单 | 甲方运维 | 上线前 |
| 恢复演练 | 按约定场景完成恢复，数据可用 | 恢复演练报告 | 双方共同 | 上线前 |
| 安全基线 | 操作系统、数据库、平台配置符合基线要求 | 基线核查表 | 甲方安全 | 上线前 |
| 漏洞扫描 | 扫描完成，高危漏洞已处置或已批准处置方案 | 扫描报告、处置记录 | 甲方安全 | 上线前 |
| 合规检查 | 按项目适用要求完成检查并留档 | 合规检查记录 | 甲方安全 | 上线前 |
性能指标、备份恢复机制和安全扫描范围应以项目实施约定为准。ONES 私有化部署采用 K3s 容器化部署，数据完整隔离并可直接访问，这些特性可在环境与安全核对时作为背景信息，具体指标仍需按项目口径测试记录。
监控日志、文档交付与运维交接检查项
上线验收不只确认“现在能用”，还要确认“以后能维护”。
| 检查项 | 通过标准 | 证据材料 | 负责人 | 检查时点 |
|---|---|---|---|---|
| 监控告警配置 | 关键服务、资源指标已纳入监控，告警可触达 | 监控面板截图、告警测试记录 | 甲方运维 | 上线前 |
| 日志采集 | 平台与应用日志可采集、可查询 | 日志查询截图 | 甲方运维 | 上线前 |
| 部署文档 | 部署架构、配置参数、启停步骤完整 | 文档交付清单 | 乙方实施 | 验收会议前 |
| 运维手册 | 日常巡检、故障处理、升级步骤可操作 | 手册签收记录 | 乙方实施 | 验收会议前 |
| 账号清单 | 管理员账号、系统账号交接清楚 | 账号交接单 | 双方共同 | 验收会议前 |
| 运维交接与培训 | 运维人员完成交接，培训有签到与内容记录 | 培训签到表、培训材料 | 双方共同 | 验收会议前 |
| 问题与遗留事项 | 问题清单登记完整，遗留项有责任人和时限 | 问题清单 | 甲方项目负责人 | 验收会议 |
验收过程中产生的问题、整改记录和证据归档，可以放在统一的工作项与文档空间中管理：检查项对应工作项，证据作为附件或文档版本留存，结论和签字记录随验收报告归档，便于后续复检和审计追溯。
每项检查的证据材料与确认记录怎么写
证据的作用是让第三方在不依赖口头说明的情况下判断该项是否通过。常用证据类型包括：界面截图、命令输出、测试报告、日志片段、签字单。截图应包含时间、环境标识和关键结果；命令输出应保留完整命令与返回；测试报告应写明测试场景、数据、结果和结论。
确认记录建议固定五个字段，逐项填写：
| 字段 | 填写要求 | 示例 |
|---|---|---|
| 检查项 | 与清单编号一致 | ENV-03 网络连通与端口 |
| 结论 | 通过 / 不通过 / 带条件通过 | 通过 |
| 证据编号 | 对应归档文件编号 | EV-2024-031 |
| 负责人 | 实际执行检查的人 | 甲方运维 张某 |
| 日期 | 检查完成日期 | 2024-06-12 |
证据命名建议采用“阶段编号-检查项编号-日期-版本”的规则，例如“ENV-03-20240612-v1”，统一归档到按阶段划分的目录中。验收报告可按以下结构组织：项目与范围说明、验收依据与口径、分阶段检查结果汇总表、阻断项与遗留项清单、证据索引、结论页与双方签字。结论页应明确写出“通过验收”“带条件通过”或“不通过”，并列出条件或整改要求。
阻断项与上线完成条件
阻断项是指不解决就不能上线的问题，与一般整改项分开管理。典型阻断项包括：核心服务不可用或频繁异常退出；数据迁移数量或关键字段不一致；备份不可恢复或恢复演练未通过；高危漏洞未处置且无经批准的风险接受方案；关键集成接口不通导致核心业务无法开展。
| 类别 | 处理方式 | 放行条件 |
|---|---|---|
| 阻断项 | 必须整改并复检 | 全部通过后方可判定上线验收完成 |
| 一般项 | 约定整改时限和复检方式 | 可带条件放行，登记责任人与完成日期 |
| 遗留问题 | 登记问题描述、影响范围、临时措施 | 经甲方项目负责人书面确认后带条件放行 |
带条件放行时，验收报告应写明条件内容、责任方、完成时限和复检安排，避免条件长期悬空。上线完成的最终判定条件是：全部阻断项通过，证据材料按编号归档完整，遗留项均有书面记录和责任人，双方项目负责人在验收报告上签字确认。任一阻断项未关闭，应判定暂缓上线，并明确复检时间。
常见问题
验收过程中发现的问题应该记在哪里，才能和检查项对应上？
建议让每个检查项对应一个可跟踪的工作项，问题、整改记录和证据都挂在该工作项下。这样做的直接好处是：复检时能按检查项编号找到原始问题、整改过程和最终结论，不用在多个表格和聊天记录之间来回翻找。
ONES 的私有化部署场景中，验收问题跟踪与证据归档可以承载在统一的工作项和文档里，检查项对应工作项，证据作为附件或文档版本留存。具体字段和流程按项目约定设置即可。
数据迁移抽样比例和“一致”的判定口径没提前约定，验收时怎么办？
这种情况应在验收会议前补一份书面口径，由双方项目负责人确认后再执行抽样。口径至少写明：抽样比例或抽样规则、比对字段范围（是否含附件、富文本、关联关系）、数量核对的统计时点，以及不一致时的处理方式。
如果已经完成部分抽样，可把已有结果按新口径复核一遍，差异项登记为待整改问题。口径未确认前，不建议直接给出“数据迁移通过”的结论。
采用高可用集群部署时，验收要额外验证什么？
除常规部署检查项外，高可用场景应额外记录节点角色分配、节点在线状态，以及故障转移的验证方式和验证结果。验证方式按项目约定执行，例如模拟单节点停止后观察服务是否持续可用。
ONES 提供基于高可用架构运行的高可用集群部署，可实现故障转移、数据容灾和零停机服务升级。具体架构要求和验证方法需在实施阶段与实施方确认，验收时按约定口径记录结果。
哪些情况可以带条件放行，条件一直没完成会怎样？
带条件放行适用于一般项和已登记的遗留问题，前提是这些问题不影响核心业务开展，且已有临时措施。阻断项不适用带条件放行，必须整改并复检通过。
条件长期悬空会让验收结论失去约束力。建议在验收报告中为每个条件写明责任方、完成时限和复检安排，并约定到期未完成时的处理方式，例如升级到项目决策层或转为正式变更单跟踪。
验收报告签字后，证据材料还需要保留多久、怎么组织？
保留期限按项目合同、企业内部审计和行业适用要求确定，验收阶段应与甲方安全或审计角色确认后写入报告。组织方式建议按阶段划分目录，文件名采用“阶段编号-检查项编号-日期-版本”的规则，报告中的证据索引与归档文件编号一一对应。
这样在后续复检、审计或平台升级时，能快速定位某项结论当时依据的是哪份材料。
