NanoCloud 私有化材料

交付准入检查清单

飞书 Wiki 同步子文档,revision 2。

交付准入检查清单

本清单用于决定项目能否进入下一交付阶段。安装成功不等于交付完成;范围、环境、依赖、验证、回退和维护责任,都要有本次项目的证据。

流程评审入口:交付准入准出 SOP(评审稿)(2026-10-08 整理稿,待评审)。商务、运营和项目人员从此入口查看准入、准出及问题处理流程;原有 10 篇子文档继续作为配套模板和技术附件,入口已列明用途及链接。

1. 使用方式与材料包

由交付负责人建一份项目副本,先填负责人、交付出口和版本,再逐项收证。商务协调范围和费用,技术判断可行性,客户确认环境与业务条件;任何一方不能替其他责任方默认确认。

**紧急交付入口:**准备周期不足时,先使用紧急交付最小准入检查清单完成不可省略项并形成书面放行结论。该清单默认只支持部署、限定真机试采与交接,不能替代 G4 生产全量切换门禁。

材料用途最迟准备时间
准入结果与门禁放行单准入清单逐项记录适用性、状态和证据;放行单汇总结论。各责任方只确认本人负责范围,交付负责人汇总,双方项目负责人作阶段 Go / No-Go 决定,不要求所有人对全部条目统一签字。G0 建档,G1 出发前形成首次结论;后续每个门禁更新
服务端与客户端交付测试报告分别记录服务端、客户端/设备端及端到端组合的版本、环境、覆盖项、失败项、缺陷和复验结论;容量与基准结果另引用专项报告,不混写为功能通过。G1 发布候选冻结时;受影响版本或配置变化后复验
SOW 与责任分工交付范围、不包含项、依赖、验收出口与签认人G0,承诺现场日期前
客户环境与设备调查实测硬件、磁盘、网络、DNS/TLS、设备和工作量输入G1,出发前
容量、压测与基准测试报告在一个专项报告中记录容量模型、等效环境、Nanocloud loadtest、S3/文件系统基准、阈值、限制和原始证据;不另建内容重复的“基准测试报告”。G1 完成实验室验证;G3 按现场差异补验
现场交付 SOP到场复核、部署、试采、切换、故障与撤场;交付前业务试用按 G3 真实链路执行G1,版本冻结时
交付材料与记录模板放行单、冻结基线、作业计划、日报、问题/变更单、分项验收和证据索引G1 建档并预填计划,逐阶段填写
交付前试用 / 验收结论引用 G3 试采和分项验收证据,汇总试用范围、实际结果、未测项、限制、遗留问题和客户意见;只做阶段结论,不重复抄录原始测试数据。G3 后形成试用结论,G5 前更新为验收结论
维护与交接方案维护范围、联系人、响应目标、备份与变更责任G1 定方案,G5 接管签认
技术资料与版本依据安装、存储、恢复、DNS 与验证工具的适用边界;核对本次冻结版本应交材料G1 冻结,G5 按实际部署修订交接

设备需要修改 DNS 时,另按设备 DNS 持久配置、验证与回退执行;不涉及设备 DNS 变更时不必填写。

项目副本与原始证据保存在双方认可的受控资料库;仓库只维护通用模板,不提交客户配置、真实凭证、设备清单或原始业务数据。每条证据要能找到版本、环境、时间、执行人和结果。

2. 先确定交付出口,再决定放行条件

必须在 SOW 中选择一种出口,不能现场默认为更大的范围:

  • A:服务部署、约定设备试采、培训和维护交接。 明确试采机型、台数、版本、样本与观察时长。
    完成 A 不等于客户全部设备已经切换,也不等于整机产品通过准出。
  • B:约定范围内的全量业务切换。 除 A 外,还要约定全量设备清单、存量数据处理、切换窗口、
    业务停机容忍度、回退点、观察期和原环境处置。只能切换已列入范围的设备与业务。

若设备不具备准出条件,只能暂停依赖设备的试采/切换,或经双方正式变更,把本阶段缩为可独立验证的
服务安装工作;不得用模拟器签署真实设备闭环通过,也不得把未完成试采写成 A 已完成。

门禁决定什么必须看到的证据放行责任
G0 范围确认是否承诺本次交付计划SOW、A/B 出口、双方接口人、验收标准、维护边界双方授权项目/商务负责人;技术确认可行性
G1 出发准入是否按部署计划出发本清单适用项通过,客户环境、等效环境验证报告,设备准出,冻结物料与现场准备确认我方交付负责人汇总;双方项目负责人签认,技术/设备/客户 IT 各自确认
G2 现场实施准入是否安装或变更现场实际资产/网络/磁盘与冻结基线一致,访问与变更授权、影响范围、原状态及恢复准备交付负责人、客户 IT/变更负责人
G3 试采验收是否认定约定业务链路通过真机完整链路、质检/对账、性能与遗留问题记录双方技术、设备负责人、客户业务验收人
G4 生产切换是否切换生产流量/全量设备生产容量、安全、恢复与维护条件通过;切换/回退计划及窗口已批准客户业务/IT 变更授权人、我方交付负责人
G5 验收与接管是否签署对应范围的验收、办理撤场分项结论、材料与培训签收、维护接单、遗留项责任与时间双方验收授权人、客户运维与我方维护接口人

A 可以在 G3 和 G5 完成后结束,不自动授权 G4。任何模式将试采环境转为正式生产,都必须经过 G4。
不得以“单机/试点”为由默认获得高可用、灾备或全天维护能力;要求和限制均应写入 SOW。

建议按“资料调查 → 环境方案 → 版本冻结及等效压测 → 联合放行 → 出发”倒排时间。具体日期由项目
填写,不把固定的提前天数当作准备完成的证据。若仅开展现场勘察,须明确勘察范围及不含部署验收。

2.1 G0–G5 交付协作时序图

下图展示双方项目/商务、交付技术、客户 IT/安全、设备/测试及客户业务/运维之间的确认、执行和证据返回。它用于说明责任与门禁关系,不表示实际工期或系统调用接口。

sequenceDiagram
    autonumber
    participant PM as 双方项目/商务
    participant DT as 交付技术
    participant IT as 客户 IT/安全
    participant DEV as 设备/测试
    participant OPS as 客户业务/运维

    rect rgb(240, 243, 255)
        Note over PM,OPS: G0 范围确认
        PM->>DT: 确认 SOW、A/B 出口与验收口径
        DT->>OPS: 确认维护边界、验收人、依赖与未决事项
        OPS-->>PM: 返回业务范围与接管责任确认
    end

    rect rgb(247, 249, 255)
        Note over PM,OPS: G1 出发准入
        par 客户环境调查
            DT->>IT: 调查硬件、存储、网络与 DNS/TLS
            IT-->>DT: 返回实测环境与现场准备证据
        and 设备与等效验证
            DT->>DEV: 核对设备版本、代表真机与验证计划
            DEV-->>DT: 返回设备准出与等效验证报告
        end
        DT-->>PM: 汇总放行材料、差异与阻断项
        PM->>DT: 签认 Go / No-Go / 限定范围 Go
    end

    rect rgb(240, 250, 250)
        Note over PM,OPS: G2 现场实施准入
        DT->>IT: 到场复核冻结基线,申请实施窗口
        IT-->>DT: 确认访问授权、变更窗口与恢复点
        DT-->>PM: 登记现场差异并提交 G2 准入结论
    end

    rect rgb(255, 249, 243)
        Note over PM,OPS: G3 试采验收
        DT->>DEV: 按批准版本部署并发起真机试采
        DEV->>OPS: 生成真实样本与链路证据
        OPS-->>DT: 返回质检、数据对账与性能结论
        DT-->>PM: 提交 G3 分项验收与遗留项
    end

    alt A:服务部署、试采与交接,不切生产
        PM->>OPS: 确认试采范围完成,安排培训与材料交接
        OPS-->>PM: 签收维护入口与遗留项计划
    else B:约定范围内生产切换
        Note over PM,OPS: G4 生产切换
        PM->>IT: 申请生产切换授权
        IT-->>DT: 返回切换窗口、回退点与批准
        DT->>DEV: 按批准设备和业务范围分批切换
        OPS-->>DT: 返回观察、对账与回退判断
    end

    rect rgb(242, 250, 246)
        Note over PM,OPS: G5 验收与接管
        PM->>OPS: 发起对应范围的最终验收、材料签收与维护接管
        OPS-->>PM: 签认验收结论、接单责任与遗留项期限
    end

    break 任一门禁为 No-Go
        DT-->>PM: 登记阻断项、影响、责任人和复验条件
        PM->>DT: 停止后续阶段,整改补证后重新评审
    end

实线箭头表示发起确认、授权或执行;虚线箭头表示证据、结果或签认返回。A 路径在 G3 后进入交接,不获得 G4 生产切换授权;B 路径必须经过 G4。

任一门禁为 No-Go 时,停止后续阶段,记录阻断项并整改补证;重新评审通过后再继续。

3. 判定规则

准入项只填“待核查 / 通过 / 不通过 / 不适用”,并附证据编号、执行人和复核人。测试用例可以填写“未测”;汇总到门禁时,“未测”按“待核查”处理,不能计入通过。“待客户确认”“现场再看”“应该支持”也都属于待核查。项目副本中的角色必须换成具体姓名和代理人。

  • 阻断项:影响本次约定范围的完成、数据安全、设备安全或恢复能力。未通过时,不放行对应阶段。
    无明确范围/签认人、实际资源未知、DNS 不稳定、应校验的 TLS 不可信、未准出的验收设备、未经验证的
    容量、无安全回退条件,不能靠普通风险签收变为通过。
  • 非阻断项:不影响本次已明确的出口,且有可验证的限制或替代措施。使用例外单列出影响、补偿措施、
    负责人、期限与复验门禁,由双方授权人确认。到期或条件变化立即重评。
  • 不适用项:注明 SOW 条款、阶段与理由,经相应责任方确认;不能把当前未完成的约定能力标为不适用。
  • 放行失效:服务器/存储映射、网络/DNS/TLS、设备版本、服务版本、配置、工作量或交付范围改变后,
    重验受影响项并重新签认,不继续沿用旧报告。

G1 时正式站点可能尚未安装:域名控制权、DNS 规划和现场网络/硬件读数应已齐备;按本次访问方案
准备证书材料并验证信任(启用 TLS 时),业务链路可在等效预验环境验证。G2 是安装前放行,正式站点
的服务端点在安装后、G3 前复验。记录须区分
“出发前等效验证通过”和“现场验证通过”,不能要求不存在的服务返回成功,也不能免除后续现场验证。

4. 交付前检查表

以下均为 G1 必填项。标明 G3/G4 的事项,G1 检查方案、责任与预验,正式实施后再收取对应阶段的
实测证据。未约定阈值或没有证据时不勾选通过。

4.1 范围、计划和责任

编号核验项及放行证据主责角色结果 / 证据
S-01SOW 确认服务模块、交付轨、版本/版本冻结规则、不包含项和 A/B 出口;双方授权人确认商务、项目、技术待核查 / —
S-02验收矩阵写明每项功能、样本/设备数量、运行时间、通过阈值、分母、验收人与证据;部署与业务分开产品/测试、客户业务待核查 / —
S-03双方项目、IT、设备/FAE、业务、运维接口人与代理人已具名,现场时间和资源可兑现双方项目待核查 / —
S-04客户其它服务是否共机/共存储、是否需要我方安装维护、资源归属与故障责任均已确认;未知服务不默认为可共存客户 IT、商务、技术待核查 / —
S-05统一需求/故障入口和变更审批链已确认;技术可澄清和评估,但范围、排期、费用由授权人承诺项目、产品、商务待核查 / —
S-06维护方式、范围、时段、响应目标、费用/续费及驻场撤场条件已确认;没有默认为免费长期运维商务、维护负责人待核查 / —
S-07机房进场、账号/远程访问、离线介质、数据使用、安装/停机/测试窗口获授权;客户管理员在场计划明确客户 IT、项目待核查 / —

4.2 域名、DNS、证书与网络

编号核验项及放行证据主责角色结果 / 证据
N-01使用有控制权的域名/客户子域;DNS 管理、解析变更、证书申请及续期责任明确,不能临场借用未知域名客户网络/安全、项目待核查 / —
N-02节点、DNS、入口/LB、NTP 与管理地址有静态地址或 DHCP 保留;地址/VLAN/网段不冲突,设备 IP 策略符合实际接入依赖客户网络、设备/FAE待核查 / —
N-03每个实际可能被使用的解析器,对交付域均返回符合分域策略的结果;DHCP、IPv6、VPN/Tailscale、容器 DNS 不抢写;重启/重连后仍通过客户网络、设备/FAE待核查 / —
N-04访问协议与适用范围已确认;启用 TLS 时证书 SAN、链、有效期和校时正确,真实浏览器、设备宿主、容器及 SDK 正常校验通过,续期/轮换经过预验客户安全、设备、技术待核查 / —
N-05Web/API/S3/MQTT 等启用入口按实际客户端网段验证;预签名返回地址可达,鉴权、CORS、LB 超时和最大包/弱网场景有测试用例网络、技术、测试待核查 / —
N-06离线 DNS/NTP、节点互联、路由/MTU/防火墙、管理网络及镜像分发路径已实查;断公网时必需链路可用客户网络、技术待核查 / —

不能把“多个 DNS 地址”视为天然容灾;要么同域一致解析,要么明确分域转发和失效行为。

没有准备好受控域名时,本项目不建议启用 HTTPS,也不采用临时自签证书、批量安装内部 CA 作为默认
补救路径。
确需 HTTP 内网联调时,须明确隔离网络、设备范围、测试数据/账号、期限和正式方案补齐
责任,不对公网开放,也不因此认定正式域名、HTTPS 验收或生产切换已经通过。正式交付仍须确认域名
和最终访问方案;设备或业务要求 HTTPS 时,应先补齐条件,不能用 HTTP 绕过要求。

已启用 TLS 的入口必须正常校验证书,不能用忽略告警、关闭校验或临时 hosts 作为通过证据。
本规则针对业务/设备访问入口,不要求关闭集群内部 TLS,也不授权将已有 HTTPS 环境直接降级为 HTTP。

4.3 实际硬件、存储与业务容量

编号核验项及放行证据主责角色结果 / 证据
H-01每台服务器实测 CPU 架构/核数、内存、OS/内核、网卡及链路速率、虚拟化配额/超售情况,与报价配置单对比客户 IT、技术待核查 / —
H-02系统/容器运行时、数据库/消息、对象数据、解析 workspace/tmp、日志、备份分别映射到实际物理盘/阵列及故障域;仅不同目录或分区不算物理隔离客户 IT、存储负责人待核查 / —
H-03挂载与开机持久化、盘型、磁盘健康/阵列状态、可用空间、inode、预留与重建空间已经验证;不以 SSD 标签推断实际独立 SSD客户 IT、存储负责人待核查 / —
H-04共机业务的峰值 CPU/内存/IO/网络及配额已计入;预留 OS、集群与运维资源,明确超限时谁限流、扩容客户 IT、技术待核查 / —
W-01按机型填写现有/峰值设备数、每日采集小时、每小时条数、典型/大包尺寸、相机与采样参数、同时上传与断网积压客户业务、设备待核查 / —
W-02原始/衍生/质检/导出数据保留、增长周期、删除/归档责任、备份与历史版本策略已确认;估算保留逻辑量及分层物理占用客户数据负责人、技术待核查 / —
W-03有与客户 CPU/内存/网络/存储及共机负载等效的验证环境;差异逐项列出并评估;关键 IO 无法等效时先补测,不能按核数比例宣称通过测试、技术、客户 IT待核查 / —
W-04基准、目标峰值、断网补传、查询/导出并行、长稳、备份并行均有报告;吞吐、p95/p99、IO 延迟、队列、WAL 和 workspace 上限事先约定测试、客户业务/IT待核查 / —
W-05可承载规模、服务并发、限流、预警水位与扩容触发条件基于实测;报告列明未验证上限与故障恢复窗口,不复制旧场地数字技术、测试、项目待核查 / —

容量算法、单位和场景填写见 容量验证 SOP。不能把磁盘标称容量、
PVC 申请值、对象逻辑大小、文件系统预留和 Longhorn 物理占用混成一个数,也不能把系统空闲时的 CPU
快照作为客户规模承诺。

4.4 设备准出、版本、离线物料与安全

编号核验项及放行证据主责角色结果 / 证据
D-01用于验收的整机/固件/系统镜像、主控/从控/Recorder/SDK/App/协议版本与服务器版本组成兼容矩阵;设备负责人提供准出、升级及回退证据设备负责人、测试待核查 / —
D-02约定试采真机、现场 FAE、设备操作安全措施就绪;SN、控制器绑定、租户、账号/权限、任务模板与样本清单可用设备/FAE、客户业务、技术待核查 / —
D-03设备实际 API/S3/MQTT 协议、地址及配置来源统一;主控再次下发、容器重建、设备重启后不恢复公网地址,不覆盖站点 DNS 及适用的信任配置设备、技术待核查 / —
D-04真机预验覆盖任务下发→采集→真实上传→事件上报→解析→质检/回看及约定导出;携带关联 ID,未测环节明确保留设备、测试、客户业务待核查 / —
R-01固定交付轨/profile、版本/构建来源、服务镜像和配置基线、数据库迁移、设备兼容版本;版本清单可追溯,不混用临时镜像发布、技术待核查 / —
R-02匹配 CPU 架构的完整离线包及必需基础软件已验证;冷环境断公网首装、约定升级与回退验证通过,不依赖开发机缓存发布、测试待核查 / —
R-03客户自备数据库/存储/认证等依赖逐项确认版本、TLS、权限、初始化、备份与恢复责任;仅采用所选轨本次版本已验证的接法技术、客户 IT待核查 / —
R-04租户/角色、设备与 M2M 鉴权、负向权限、初始账号更换、密钥保管及数据脱敏有验证记录;开源清单/许可材料按发布流程评审安全/合规、发布、测试待核查 / —
R-05已知缺陷/版本回退风险逐项分类;“代码已改”“压测工具通过”不能代替本次交付版本回归;现场补丁回收为可重建版本技术、测试、发布待核查 / —

4.5 恢复、监控与接管准备

编号核验项及放行证据主责角色结果 / 证据
O-01数据库、对象、配置、密钥、设备离线队列的保护范围明确;G1 有恢复方案及预演,G4 前有独立故障域备份和隔离环境恢复/数据对账证据双方运维、客户数据负责人待核查 / —
O-02实测并签认 RPO/RTO;备份成功、可解密与实际业务恢复分别记录;保存恢复密钥的方式不会与生产单点一起丢失运维、客户业务/IT待核查 / —
O-03按 SOW 定义节点/磁盘/网络故障下的可用性;若承诺 HA,验证控制面、入口、应用与存储全链路,不能只数节点技术、测试、客户 IT待核查 / —
O-04监控对象、历史保留、告警阈值/通知、接警人和升级链路已确定;G4 前演练告警到人,临时健康页不代替生产监控双方运维待核查 / —
O-05安装/切换/变更停止条件、回退对象与数据恢复边界明确;有原环境保护、现场窗口和异常联系人交付、客户变更负责人待核查 / —
O-06本材料包与所选轨 SOP 已随交付材料带到现场,可离线访问;G5 前由客户实操验证巡检/报障并签收权限和维护入口交付、维护、客户运维待核查 / —

5. 放行会与出发结论

交付负责人逐项展示调查、预验和物料证据,记录通过项、阻断项、允许例外与下一阶段必复验项。
使用 放行与例外记录,输出一种明确结论:

  1. Go:本阶段适用必需项全部通过,可按记录的版本、范围、时间和环境推进。
  2. No-Go:列出阻断项、责任人、预计补齐时间和复验方式,重新确定出发/实施计划。
  3. 限定范围 Go:仅限已经正式变更并可独立验收的子范围;写出禁止开展的动作和下一次门禁。
    这不等于原范围通过,非阻断例外也不能掩盖未完成的约定工作。

未签认或结论不清晰,按 No-Go 处理。现场出现基线变化,由 G2 重新评估,不因人员已经到场而降低准入。

6. 常见交付风险与控制措施

以下控制措施来自历史交付经验,不是对某个现场状态的认证。实际通过情况必须重新收证,
技术判断遵循版本与证据层级。

观察到的问题转为交付控制主要落点
域名未准备、多 DNS 不一致、设备 IP/配置变化域名与网络责任提前确认;按实际解析路径逐端测试并验证持久化N-01~N-06、环境调查、DNS SOP
无域名时临时启用自签 HTTPS,设备 SDK 拒绝证书不把自签/装 CA 作为默认补救;先确认域名和访问方案,启用 TLS 后必须正常验证N-04、D-03
仅看配置单,现场才发现磁盘 IO 与系统盘共用问题实测资源和物理落盘映射;容量模型、等效混合负载与停止阈值H-01~W-05
设备规模、每日采集量、客户其它服务未确定调查设备/工作量/共机负载;变更重新估算和评审S-04、W-01~W-05
整机未准出,交付出口与服务责任混淆SOW 固定 A/B 出口,设备兼容矩阵及前置依赖;分项验收S-01~S-03、D-01~D-04
无 SOW、需求直接变成技术承诺、维护边界缺失范围签认、统一需求入口、变更单、维护接管S-01、S-05、S-06、O-06
安装成功与完整业务验收混为一谈分离节点/服务就绪、真机链路、人工质检、数据对账和最终签认G2~G5、验收记录
备份同故障域、临时监控、单控制面被误认为生产保障独立恢复证据、告警到人、逐层 HA 与明确限制O-01~O-04

技术与版本核验见技术资料与版本依据。历史记录仅用于识别风险,
旧实验配置和容量数字不作为本次承诺;原始内部记录不在此发布。完整安装、恢复和工具材料由发布负责人
按本次冻结版本提供,执行前须确认可访问、适用和已验证。