# 24 接维管理 PRD

## 0. Demo开发摘要

- 一句话定位：接维管理负责把新建、扩容、改造或客户迁入的数据中心能力，从项目态安全切换到运营态，确保资产、点位、资料、缺陷、责任、流程、证据和报表全部闭环。
- 菜单挂载：运维中心 / 项目投运 / 接维管理；与 01 生命周期管理、02 容量管理、15 监控视图、17 设备维修管理、25 运行方案管理形成联动。
- Demo主路径：创建接维批次 -> 展开移交清单 -> CMDB/点位差异比对 -> 上传资料包 -> 登记遗留缺陷 -> 多专业会签 -> 责任切换 -> 生成运营就绪报告 -> 归档审计证据包。
- 核心页面：接维驾驶舱、批次台账、清单核验、资料证据库、遗留缺陷闭环、责任切换工作台、审批与验收、模板配置、报表与审计、异常风险队列。
- 复用智航能力：CMDB、DCIM工作台、映射管理、边缘管理、AI盒子/视频、工作流、低代码表单、报表中心、知识库、告警/事件、移动端。
- 需要 Mock 的 API：批次、清单、CMDB差异、资料包、缺陷、责任切换、流程任务、证据、报表、模板、审计日志。

## 1. 制度依据与行业依据

- 本地白皮书依据：`03.管理系列产品白皮书-V3R4C50.md` 说明 DCOM 通过设施监控、资源管理、容量管理、能效管理和运维功能统一构建，解决离散工具、数据不共享、报表困难和管理成本高的问题。接维管理应作为从项目交付到这些运营功能之间的过渡闭环。
- 本地现状依据：`智航平台现状盘点.md` 已识别现场 MOP、MOP 日志和总部 MOP 控制器，说明智航已有运行规程管理基础；接维必须把 MOP/SOP 和资料包作为投运前置条件。
- 本地规划依据：`智航平台产品规划（含商业化）.md` 明确长期目标是完整可监可控 + DCIM + DCOM + 智能化和专家服务。接维管理是把项目建设成果转成可监、可控、可运维、可审计产品资产的入口。
- 外部 DCIM/DCOM 参考：DCIM 强调 IT 与设施管理集成、统一监控、容量规划、风险可用性和能耗效率；ITIL/ITSM 事件、变更、问题与配置管理强调记录、影响分析、审批、关闭和审计。产品化推导时不能把这些参考写成用户制度原文。
- 本地制度知识库状态：`datacenter-ops-product-reference` 健康检查当前未定位到知识库根目录，因此本轮先基于仓库白皮书/规划/范式与外部公开资料推导；后续若设置 `DATACENTER_OPS_KB_ROOT`，需要补一次制度原文引用。

## 2. 现有能力复用分析

| 能力 | 复用对象 | 接维管理中的使用方式 | 新增边界 |
|---|---|---|---|
| CMDB | 资产、空间、模型、关系、操作审计 | 读取设备清单、空间关系、模型版本、点位数量，生成接维快照和差异 | 新增接维快照与差异固化，不改 CMDB 主模型 |
| DCIM 工作台 | 资产视图、容量视图、监控视图 | 从接维清单跳转到资产、容量、动环/BA/消防/视频视图 | 新增接维入口与接维状态徽标 |
| 映射管理 | 点位、协议、单位、设备模型映射 | 校验设备模型应接点位和实际映射点位 | 新增接维差异任务和批次快照 |
| 边缘管理 | 采集器、驱动、AI盒子在线状态 | 判断现场采集与盒子证据是否可用 | 新增接维证据采集来源字段 |
| 低代码表单 | PagePlug/NocoBase 或同类配置能力 | 承载接维批次、清单、缺陷、责任切换表单 | 表单模板由接维模板配置驱动 |
| 工作流 | 审批、会签、退回、转交、归档 | 支持项目、工程、运维、供应商、客户多角色审批 | 新增接维流程模板和 SLA 节点 |
| 报表中心 | 报表、导出、订阅、审计 | 输出运营就绪报告、缺陷关闭率、资料齐套率 | 新增接维主题数据集 |
| 知识库 | MOP/SOP、维护经验、预案 | 对清单项关联 MOP/SOP、培训资料和验收标准 | 新增接维知识包索引 |
| AI盒子/视频 | 图片、视频、现场识别 | 作为现场资料、设备铭牌、机柜、消防/安防验收证据 | 新增证据 hash 与采集来源 |

## 3. 用户角色与业务场景

| 角色 | 主要动作 | 关注点 |
|---|---|---|
| 项目经理 | 发起接维批次、协调项目资料、推动缺陷整改和最终移交 | 批次进度、阻断风险、客户验收结果 |
| 接维负责人 | 配置接维模板、拆分专业清单、安排核验责任人 | 清单完成率、资料齐套率、责任切换率 |
| 运维经理 | 判断是否具备运营接收条件，确认风险例外和运营边界 | P0/P1 缺陷、后续运维负担、SLA 风险 |
| 资料管理员 | 收集、版本化、审核和归档资料包 | 资料缺失、版本不一致、签字不完整、密级 |
| 专业工程师 | 核验供配电、暖通、弱电、消防、安防等专业清单 | 实物、点位、图纸、调试报告是否一致 |
| 供应商负责人 | 整改遗留缺陷、提交证据和维保边界 | 整改期限、扣罚、质保、责任划分 |
| 客户/业主代表 | 参与验收、确认例外条款和交付报告 | 透明度、证据完整性、后续服务边界 |

核心场景：

1. 新建数据中心完成工程建设，项目经理发起整站接维，系统按项目类型展开供配电、暖通、消防、安防、弱电、网络、资料七类清单。
2. 接维负责人触发 CMDB 差异比对，发现 UPS 旁路柜缺 12 个监控点位、3 个机柜 U 位资产位置不一致、2 份消防调试报告版本缺失。
3. 运维经理将缺点位和消防报告列为 P1 风险，有条件接维，但要求供应商在 7 天内补齐，并生成遗留缺陷工单。
4. 资料管理员上传竣工图、MOP/SOP、维保合同、账号清单和签字单，系统校验 hash、版本、密级和审核状态。
5. 项目、工程、运维、供应商、客户完成会签，责任切换从项目团队转为运营团队，系统生成运营就绪报告和审计证据包。

## 4. 信息架构与页面清单

| 页面 | 路由 | 角色 | 页面目标 | 核心组件 |
|---|---|---|---|---|
| 接维驾驶舱 | `/takeover/overview` | 项目经理 | 查看项目态到运营态的总体移交进度、遗留风险和责任切换状态 | 指标卡、筛选器、表格、详情抽屉、状态时间线、操作弹窗 |
| 接维批次台账 | `/takeover/list` | 接维负责人 | 维护每个数据中心、楼层、机房、系统域的接维批次和移交阶段 | 指标卡、筛选器、表格、详情抽屉、状态时间线、操作弹窗 |
| 移交清单核验 | `/takeover/checklist` | 资料管理员 | 逐项核验资产、监控点位、图纸、账号、备件、MOP/SOP和合同资料 | 指标卡、筛选器、表格、详情抽屉、状态时间线、操作弹窗 |
| 遗留缺陷闭环 | `/takeover/defect` | 运维经理 | 登记项目遗留缺陷，设定整改责任、期限、风险等级和验收标准 | 指标卡、筛选器、表格、详情抽屉、状态时间线、操作弹窗 |
| 资料证据库 | `/takeover/evidence` | 资料管理员 | 管理图纸、测试报告、调试记录、照片、视频、会议纪要和签字单 | 指标卡、筛选器、表格、详情抽屉、状态时间线、操作弹窗 |
| 责任切换工作台 | `/takeover/operation` | 运维经理 | 完成项目、工程、运维、供应商、客户之间的责任边界切换 | 指标卡、筛选器、表格、详情抽屉、状态时间线、操作弹窗 |
| 审批与验收流程 | `/takeover/workflow` | 项目经理 | 编排移交申请、专业会签、风险确认、验收结论和退回补证 | 指标卡、筛选器、表格、详情抽屉、状态时间线、操作弹窗 |
| 接维模板配置 | `/takeover/config` | 接维负责人 | 配置不同类型数据中心、机房、专业域和客户项目的接维模板 | 指标卡、筛选器、表格、详情抽屉、状态时间线、操作弹窗 |
| 接维报表与审计 | `/takeover/report` | 运维经理 | 输出项目转运营评估、缺陷关闭率、资料齐套率、审计证据包 | 指标卡、筛选器、表格、详情抽屉、状态时间线、操作弹窗 |
| 异常风险队列 | `/takeover/exception` | 运维经理 | 处理缺资料、缺点位、缺责任、缺整改、缺验收等阻断项 | 指标卡、筛选器、表格、详情抽屉、状态时间线、操作弹窗 |

### 4.1 接维驾驶舱

- 页面目标：查看项目态到运营态的总体移交进度、遗留风险和责任切换状态。
- 顶部指标：接维完成率、资料齐套率、遗留缺陷关闭率、责任切换率、P0/P1 阻断数、逾期任务数。
- 筛选条件：数据中心、楼栋/机房、项目编码、接维类型、风险等级、状态、责任人、计划接维日期。
- 表格字段：批次ID、项目编码、站点、接维类型、状态、风险等级、完成率、当前节点、责任人、计划日期、更新时间。
- 主按钮：新建批次、导入清单、触发 CMDB 差异、生成报告、导出证据包。
- 行操作：查看详情、核验清单、登记缺陷、上传证据、推进流程、责任签署、归档。
- 异常态：CMDB 不可用时显示最后快照；资料服务不可用时允许暂存元数据；流程服务失败时保留本地草稿和重试入口。
- 权限态：无编辑权限只读；无审批权限隐藏决策按钮；客户代表仅可看已授权项目和脱敏证据。

### 4.2 接维批次台账

- 页面目标：维护每个数据中心、楼层、机房、系统域的接维批次和移交阶段。
- 顶部指标：接维完成率、资料齐套率、遗留缺陷关闭率、责任切换率、P0/P1 阻断数、逾期任务数。
- 筛选条件：数据中心、楼栋/机房、项目编码、接维类型、风险等级、状态、责任人、计划接维日期。
- 表格字段：批次ID、项目编码、站点、接维类型、状态、风险等级、完成率、当前节点、责任人、计划日期、更新时间。
- 主按钮：新建批次、导入清单、触发 CMDB 差异、生成报告、导出证据包。
- 行操作：查看详情、核验清单、登记缺陷、上传证据、推进流程、责任签署、归档。
- 异常态：CMDB 不可用时显示最后快照；资料服务不可用时允许暂存元数据；流程服务失败时保留本地草稿和重试入口。
- 权限态：无编辑权限只读；无审批权限隐藏决策按钮；客户代表仅可看已授权项目和脱敏证据。

### 4.3 移交清单核验

- 页面目标：逐项核验资产、监控点位、图纸、账号、备件、MOP/SOP和合同资料。
- 顶部指标：接维完成率、资料齐套率、遗留缺陷关闭率、责任切换率、P0/P1 阻断数、逾期任务数。
- 筛选条件：数据中心、楼栋/机房、项目编码、接维类型、风险等级、状态、责任人、计划接维日期。
- 表格字段：批次ID、项目编码、站点、接维类型、状态、风险等级、完成率、当前节点、责任人、计划日期、更新时间。
- 主按钮：新建批次、导入清单、触发 CMDB 差异、生成报告、导出证据包。
- 行操作：查看详情、核验清单、登记缺陷、上传证据、推进流程、责任签署、归档。
- 异常态：CMDB 不可用时显示最后快照；资料服务不可用时允许暂存元数据；流程服务失败时保留本地草稿和重试入口。
- 权限态：无编辑权限只读；无审批权限隐藏决策按钮；客户代表仅可看已授权项目和脱敏证据。

### 4.4 遗留缺陷闭环

- 页面目标：登记项目遗留缺陷，设定整改责任、期限、风险等级和验收标准。
- 顶部指标：接维完成率、资料齐套率、遗留缺陷关闭率、责任切换率、P0/P1 阻断数、逾期任务数。
- 筛选条件：数据中心、楼栋/机房、项目编码、接维类型、风险等级、状态、责任人、计划接维日期。
- 表格字段：批次ID、项目编码、站点、接维类型、状态、风险等级、完成率、当前节点、责任人、计划日期、更新时间。
- 主按钮：新建批次、导入清单、触发 CMDB 差异、生成报告、导出证据包。
- 行操作：查看详情、核验清单、登记缺陷、上传证据、推进流程、责任签署、归档。
- 异常态：CMDB 不可用时显示最后快照；资料服务不可用时允许暂存元数据；流程服务失败时保留本地草稿和重试入口。
- 权限态：无编辑权限只读；无审批权限隐藏决策按钮；客户代表仅可看已授权项目和脱敏证据。

### 4.5 资料证据库

- 页面目标：管理图纸、测试报告、调试记录、照片、视频、会议纪要和签字单。
- 顶部指标：接维完成率、资料齐套率、遗留缺陷关闭率、责任切换率、P0/P1 阻断数、逾期任务数。
- 筛选条件：数据中心、楼栋/机房、项目编码、接维类型、风险等级、状态、责任人、计划接维日期。
- 表格字段：批次ID、项目编码、站点、接维类型、状态、风险等级、完成率、当前节点、责任人、计划日期、更新时间。
- 主按钮：新建批次、导入清单、触发 CMDB 差异、生成报告、导出证据包。
- 行操作：查看详情、核验清单、登记缺陷、上传证据、推进流程、责任签署、归档。
- 异常态：CMDB 不可用时显示最后快照；资料服务不可用时允许暂存元数据；流程服务失败时保留本地草稿和重试入口。
- 权限态：无编辑权限只读；无审批权限隐藏决策按钮；客户代表仅可看已授权项目和脱敏证据。

### 4.6 责任切换工作台

- 页面目标：完成项目、工程、运维、供应商、客户之间的责任边界切换。
- 顶部指标：接维完成率、资料齐套率、遗留缺陷关闭率、责任切换率、P0/P1 阻断数、逾期任务数。
- 筛选条件：数据中心、楼栋/机房、项目编码、接维类型、风险等级、状态、责任人、计划接维日期。
- 表格字段：批次ID、项目编码、站点、接维类型、状态、风险等级、完成率、当前节点、责任人、计划日期、更新时间。
- 主按钮：新建批次、导入清单、触发 CMDB 差异、生成报告、导出证据包。
- 行操作：查看详情、核验清单、登记缺陷、上传证据、推进流程、责任签署、归档。
- 异常态：CMDB 不可用时显示最后快照；资料服务不可用时允许暂存元数据；流程服务失败时保留本地草稿和重试入口。
- 权限态：无编辑权限只读；无审批权限隐藏决策按钮；客户代表仅可看已授权项目和脱敏证据。

### 4.7 审批与验收流程

- 页面目标：编排移交申请、专业会签、风险确认、验收结论和退回补证。
- 顶部指标：接维完成率、资料齐套率、遗留缺陷关闭率、责任切换率、P0/P1 阻断数、逾期任务数。
- 筛选条件：数据中心、楼栋/机房、项目编码、接维类型、风险等级、状态、责任人、计划接维日期。
- 表格字段：批次ID、项目编码、站点、接维类型、状态、风险等级、完成率、当前节点、责任人、计划日期、更新时间。
- 主按钮：新建批次、导入清单、触发 CMDB 差异、生成报告、导出证据包。
- 行操作：查看详情、核验清单、登记缺陷、上传证据、推进流程、责任签署、归档。
- 异常态：CMDB 不可用时显示最后快照；资料服务不可用时允许暂存元数据；流程服务失败时保留本地草稿和重试入口。
- 权限态：无编辑权限只读；无审批权限隐藏决策按钮；客户代表仅可看已授权项目和脱敏证据。

### 4.8 接维模板配置

- 页面目标：配置不同类型数据中心、机房、专业域和客户项目的接维模板。
- 顶部指标：接维完成率、资料齐套率、遗留缺陷关闭率、责任切换率、P0/P1 阻断数、逾期任务数。
- 筛选条件：数据中心、楼栋/机房、项目编码、接维类型、风险等级、状态、责任人、计划接维日期。
- 表格字段：批次ID、项目编码、站点、接维类型、状态、风险等级、完成率、当前节点、责任人、计划日期、更新时间。
- 主按钮：新建批次、导入清单、触发 CMDB 差异、生成报告、导出证据包。
- 行操作：查看详情、核验清单、登记缺陷、上传证据、推进流程、责任签署、归档。
- 异常态：CMDB 不可用时显示最后快照；资料服务不可用时允许暂存元数据；流程服务失败时保留本地草稿和重试入口。
- 权限态：无编辑权限只读；无审批权限隐藏决策按钮；客户代表仅可看已授权项目和脱敏证据。

### 4.9 接维报表与审计

- 页面目标：输出项目转运营评估、缺陷关闭率、资料齐套率、审计证据包。
- 顶部指标：接维完成率、资料齐套率、遗留缺陷关闭率、责任切换率、P0/P1 阻断数、逾期任务数。
- 筛选条件：数据中心、楼栋/机房、项目编码、接维类型、风险等级、状态、责任人、计划接维日期。
- 表格字段：批次ID、项目编码、站点、接维类型、状态、风险等级、完成率、当前节点、责任人、计划日期、更新时间。
- 主按钮：新建批次、导入清单、触发 CMDB 差异、生成报告、导出证据包。
- 行操作：查看详情、核验清单、登记缺陷、上传证据、推进流程、责任签署、归档。
- 异常态：CMDB 不可用时显示最后快照；资料服务不可用时允许暂存元数据；流程服务失败时保留本地草稿和重试入口。
- 权限态：无编辑权限只读；无审批权限隐藏决策按钮；客户代表仅可看已授权项目和脱敏证据。

### 4.10 异常风险队列

- 页面目标：处理缺资料、缺点位、缺责任、缺整改、缺验收等阻断项。
- 顶部指标：接维完成率、资料齐套率、遗留缺陷关闭率、责任切换率、P0/P1 阻断数、逾期任务数。
- 筛选条件：数据中心、楼栋/机房、项目编码、接维类型、风险等级、状态、责任人、计划接维日期。
- 表格字段：批次ID、项目编码、站点、接维类型、状态、风险等级、完成率、当前节点、责任人、计划日期、更新时间。
- 主按钮：新建批次、导入清单、触发 CMDB 差异、生成报告、导出证据包。
- 行操作：查看详情、核验清单、登记缺陷、上传证据、推进流程、责任签署、归档。
- 异常态：CMDB 不可用时显示最后快照；资料服务不可用时允许暂存元数据；流程服务失败时保留本地草稿和重试入口。
- 权限态：无编辑权限只读；无审批权限隐藏决策按钮；客户代表仅可看已授权项目和脱敏证据。

## 5. 业务流程与状态机

| 状态 | 中文名 | 进入条件 | 可执行动作 | 退出条件 |
|---|---|---|---|---|
| draft | 草稿 | 接维负责人创建批次，尚未正式发起 | 查看、编辑、提交、退回、上传证据、生成日志 | 满足节点规则并生成审计记录 |
| submitted | 已提交 | 批次进入项目/工程/运维协同视图 | 查看、编辑、提交、退回、上传证据、生成日志 | 满足节点规则并生成审计记录 |
| checking | 核验中 | 资产、资料、点位、缺陷和责任并行核验 | 查看、编辑、提交、退回、上传证据、生成日志 | 满足节点规则并生成审计记录 |
| risk_review | 风险评审 | 存在 P0/P1 缺陷或关键资料缺失，需要管理层确认 | 查看、编辑、提交、退回、上传证据、生成日志 | 满足节点规则并生成审计记录 |
| rectifying | 整改中 | 遗留缺陷进入供应商、项目或工程整改闭环 | 查看、编辑、提交、退回、上传证据、生成日志 | 满足节点规则并生成审计记录 |
| pending_acceptance | 待验收 | 关键清单完成，等待运维与客户验收 | 查看、编辑、提交、退回、上传证据、生成日志 | 满足节点规则并生成审计记录 |
| accepted | 已接维 | 运营责任正式切换，后续事件进入运维体系 | 查看、编辑、提交、退回、上传证据、生成日志 | 满足节点规则并生成审计记录 |
| rejected | 已退回 | 资料或现场条件不足，退回补证或整改 | 查看、编辑、提交、退回、上传证据、生成日志 | 满足节点规则并生成审计记录 |
| suspended | 已挂起 | 项目延期、客户冻结或现场不可进入 | 查看、编辑、提交、退回、上传证据、生成日志 | 满足节点规则并生成审计记录 |
| archived | 已归档 | 证据包、审计日志和报表完成归档 | 查看、编辑、提交、退回、上传证据、生成日志 | 满足节点规则并生成审计记录 |

主流程：草稿 -> 已提交 -> 核验中 -> 风险评审 -> 整改中/待验收 -> 已接维 -> 已归档。

- 未完成必交资料审核时，不允许进入最终接维验收。
- 存在 P0 缺陷时，不允许状态进入已接维，只能退回、整改或挂起。
- 存在 P1 缺陷时，可以有条件接维，但必须生成例外条款、整改期限和责任签署。
- 资产快照差异未处理时，系统必须提示风险，不允许静默通过。
- 责任切换必须覆盖设备运行、告警处理、维保合同、资料维护、账号权限、备件库存、客户沟通七类责任域。
- 所有审批、退回、加签、转交、验收、归档动作必须生成审计日志。
- 证据附件必须记录 hash、上传人、采集来源、对象类型、对象ID和时间戳。
- 客户可见报告必须脱敏内部责任人联系方式、系统内部ID和敏感账号信息。

## 6. 数据模型与字段字典

核心对象：接维批次、移交清单项、资产点位快照、资料包、遗留缺陷、责任切换、审批任务、证据附件、审计日志、指标快照。字段级定义见 `FIELD_DICTIONARY.md`。

| 字段 | 中文名 | 类型 | 规则 |
|---|---|---|---|
| batch_id | 接维批次ID | string | 系统生成，业务唯一键，格式 TK-YYYYMM-#### |
| project_code | 项目编码 | string | 来自项目管理或合同系统，作为项目态来源索引 |
| site_id | 数据中心ID | string | 关联 CMDB 站点主数据 |
| building_id | 楼栋ID | string | 关联 CMDB 空间树 |
| room_id | 机房ID | string | 关联机房、模块、冷通道或弱电间 |
| handover_type | 接维类型 | enum | 新建投运、扩容改造、客户迁入、专业系统改造 |
| batch_status | 批次状态 | enum | draft/submitted/checking/risk_review/rectifying/pending_acceptance/accepted/rejected/suspended/archived |
| risk_level | 风险等级 | enum | P0/P1/P2/P3，受缺陷等级和关键资料缺失自动推导 |
| planned_accept_at | 计划接维日期 | datetime | 用于 SLA 与逾期提醒 |
| acceptance_score | 接维评分 | decimal | 资料、资产、缺陷、责任、流程五类加权评分 |
| item_id | 清单项ID | string | 模板展开后的清单唯一标识 |
| domain | 专业域 | enum | 供配电/暖通/弱电/消防/安防/网络/运维资料/客户资料 |
| category | 清单分类 | enum | 资产/点位/图纸/账号/备件/MOP/SOP/合同/验收记录 |
| acceptance_criteria | 验收标准 | text | 明确数量、版本、签字、附件、测试结果或系统同步要求 |
| verification_result | 核验结论 | enum | 未核验/通过/不通过/有条件通过/不适用 |
| expected_qty | 应交数量 | number | 来自模板或工程交付清单 |
| verified_qty | 核验数量 | number | 现场或资料实际核验数量 |
| cmdb_ref_id | CMDB引用ID | string | 资产、空间、模型或关系ID |
| asset_id | 资产ID | string | CMDB 资产实例ID |
| asset_type | 资产类型 | enum | UPS/电池/PDU/精密空调/冷机/消防主机/摄像头/门禁控制器/服务器/网络设备 |
| space_path | 空间路径 | string | 数据中心/楼栋/楼层/机房/机柜/U位 |
| monitor_point_count | 应接入测点数 | number | 按设备模型模板计算 |
| mapped_point_count | 已映射测点数 | number | 来自映射管理或采集配置 |
| diff_type | 差异类型 | enum | 缺资产/缺点位/多点位/位置不一致/型号不一致/关系缺失 |
| doc_type | 资料类型 | enum | 竣工图/测试报告/调试记录/操作手册/维保合同/MOP/SOP/账号清单/培训记录 |
| version_no | 资料版本 | string | 必须支持版本比较和退回补证 |
| file_hash | 文件Hash | string | 用于归档防篡改校验 |
| confidential_level | 密级 | enum | 公开/内部/敏感/客户限制 |
| review_status | 资料审核状态 | enum | 待审/通过/退回/过期/缺失 |
| defect_id | 遗留缺陷ID | string | 与整改工单、证据和验收关联 |
| defect_domain | 缺陷专业域 | enum | 供配电/暖通/弱电/消防/安防/建筑/流程/资料 |
| severity | 缺陷等级 | enum | P0 阻断接维，P1 有条件接维，P2 计划整改，P3 观察项 |
| impact_scope | 影响范围 | text | 影响机房、客户、系统、容量、SLA或安全合规 |
| rectify_owner_type | 整改责任方类型 | enum | 项目/工程/供应商/运维/客户/外部单位 |
| rectify_due_at | 整改期限 | datetime | P0/P1 必填且触发逾期升级 |
| shift_id | 责任切换ID | string | 每个责任域一条切换记录 |
| responsibility_domain | 责任域 | enum | 设备运行/告警处理/维保合同/资料维护/账号权限/备件库存/客户沟通 |
| from_owner_id | 转出责任人 | string | 项目、工程或供应商负责人 |
| to_owner_id | 接收责任人 | string | 运维团队或客户运营负责人 |
| boundary_desc | 责任边界说明 | text | 明确接维前后责任、遗留项、例外条款 |
| task_id | 流程任务ID | string | 工作流任务主键 |
| node_code | 流程节点编码 | string | submit/professional_review/risk_review/accept/archive |
| decision | 审批结论 | enum | 同意/退回/转交/加签/有条件通过/拒绝 |
| sla_due_at | 任务SLA | datetime | 用于催办、升级、红黄牌 |
| evidence_id | 证据ID | string | 照片、视频、签字、报告、系统日志统一证据对象 |
| capture_source | 采集来源 | enum | Web上传/移动端拍照/AI盒子/视频平台/报表系统/接口同步 |
| audit_valid_flag | 审计有效 | boolean | hash、时间、责任人、对象齐全时为 true |
| audit_id | 审计ID | string | 每次状态变化和关键动作生成 |

## 7. 数据库表结构

数据库设计必须支持批次级审计、对象级证据、跨系统引用和增量快照。具体表结构见 `DB_TABLE_SPEC.md`。核心表：

- takeover_batch：接维批次主表，关键字段 batch_id PK、project_code、site_id、building_id、room_id、handover_type、source_project_stage、target_ops_team_id。
- takeover_checklist_item：移交清单明细表，关键字段 item_id PK、batch_id FK、domain、category、item_name、required_flag、acceptance_criteria、source_system。
- takeover_asset_snapshot：资产与点位快照表，关键字段 snapshot_id PK、batch_id FK、asset_id、asset_name、asset_type、space_path、rack_u_position、power_path。
- takeover_document_package：资料包表，关键字段 doc_id PK、batch_id FK、doc_type、doc_name、version_no、file_id、file_hash、source_owner。
- takeover_defect：遗留缺陷表，关键字段 defect_id PK、batch_id FK、defect_title、defect_domain、severity、impact_scope、root_cause、rectify_owner_type。
- takeover_responsibility_shift：责任切换表，关键字段 shift_id PK、batch_id FK、responsibility_domain、from_owner_id、to_owner_id、boundary_desc、effective_at、precondition_status。
- takeover_workflow_task：审批与会签任务表，关键字段 task_id PK、batch_id FK、node_code、node_name、assignee_id、assignee_role、task_status、decision。
- takeover_evidence：证据附件表，关键字段 evidence_id PK、batch_id FK、object_type、object_id、evidence_type、file_id、capture_source、box_device_id。
- takeover_audit_log：审计日志表，关键字段 audit_id PK、batch_id FK、actor_id、actor_role、action、object_type、object_id、before_state。
- takeover_metric_daily：日报指标快照表，关键字段 metric_id PK、batch_id FK、metric_date、checklist_complete_rate、defect_close_rate、document_complete_rate、responsibility_shift_rate、p0_blocker_count。

## 8. API 契约与错误码

接口必须统一返回 `traceId`、`requestId`、`auditId` 和 `sourceSystem`。查询接口支持分页、排序、筛选；提交接口必须幂等，重复提交按 requestId 返回同一结果。完整接口见 `API_SPEC.md`。

| 方法 | 路径 | 用途 |
|---|---|---|
| GET | /api/dcim/takeover/batches | 批次分页查询 |
| POST | /api/dcim/takeover/batches | 创建接维批次 |
| GET | /api/dcim/takeover/batches/{batchId} | 批次详情 |
| PATCH | /api/dcim/takeover/batches/{batchId} | 更新批次基础信息 |
| POST | /api/dcim/takeover/batches/{batchId}/submit | 提交接维申请 |
| GET | /api/dcim/takeover/batches/{batchId}/checklist | 查询移交清单 |
| PUT | /api/dcim/takeover/checklist/{itemId}/verify | 核验清单项 |
| POST | /api/dcim/takeover/batches/{batchId}/cmdb-diff | 触发 CMDB 差异比对 |
| GET | /api/dcim/takeover/batches/{batchId}/asset-snapshots | 资产点位快照 |
| POST | /api/dcim/takeover/batches/{batchId}/documents | 上传资料包 |
| PUT | /api/dcim/takeover/documents/{docId}/review | 审核资料 |
| GET | /api/dcim/takeover/batches/{batchId}/defects | 遗留缺陷列表 |
| POST | /api/dcim/takeover/batches/{batchId}/defects | 新增遗留缺陷 |
| PATCH | /api/dcim/takeover/defects/{defectId}/rectify | 提交整改 |
| PUT | /api/dcim/takeover/defects/{defectId}/verify | 验收整改 |
| GET | /api/dcim/takeover/batches/{batchId}/responsibilities | 责任切换清单 |
| POST | /api/dcim/takeover/responsibilities/{shiftId}/sign | 责任签署 |
| GET | /api/dcim/takeover/batches/{batchId}/workflow | 流程节点与任务 |
| POST | /api/dcim/takeover/workflow/tasks/{taskId}/decision | 审批决策 |
| GET | /api/dcim/takeover/batches/{batchId}/evidence | 证据链查询 |
| POST | /api/dcim/takeover/batches/{batchId}/accept | 最终接维验收 |
| POST | /api/dcim/takeover/batches/{batchId}/archive | 归档接维证据包 |
| GET | /api/dcim/takeover/reports/operation-readiness | 运营就绪报告 |
| GET | /api/dcim/takeover/config/templates | 接维模板列表 |
| POST | /api/dcim/takeover/config/templates | 创建接维模板 |
| GET | /api/dcim/takeover/audit-logs | 审计日志查询 |

错误码：`TAKEOVER_400_TEMPLATE_MISSING`、`TAKEOVER_409_STATE_CONFLICT`、`TAKEOVER_412_P0_BLOCKER`、`TAKEOVER_422_EVIDENCE_REQUIRED`、`TAKEOVER_503_CMDB_UNAVAILABLE`。

## 9. 埋点、指标与报表

| event | 触发时机 | 属性 |
|---|---|---|
| takeover_batch_view | 进入批次详情 | batch_id,status,risk_level,user_role |
| takeover_batch_create | 创建接维批次 | template_id,site_id,project_code |
| takeover_checklist_verify | 核验清单项 | item_id,result,domain,owner_id |
| takeover_cmdb_diff_start | 启动 CMDB 差异比对 | batch_id,scope,model_version |
| takeover_cmdb_diff_resolved | 处理差异 | diff_type,result,asset_id |
| takeover_document_upload | 上传资料 | doc_type,version,confidential_level |
| takeover_document_review | 审核资料 | doc_id,decision,missing_reason |
| takeover_defect_create | 登记缺陷 | severity,domain,owner_type,due_at |
| takeover_defect_rectify | 提交整改 | defect_id,rectify_status,evidence_count |
| takeover_responsibility_sign | 责任签署 | domain,from_owner,to_owner,decision |
| takeover_workflow_decision | 审批决策 | node_code,decision,sla_status |
| takeover_acceptance_submit | 最终验收 | score,p0_count,p1_count,exception_policy |
| takeover_report_export | 导出报告 | report_type,format,watermark |
| takeover_archive_complete | 归档完成 | archive_id,file_count,hash_valid |
| takeover_exception_escalate | 异常升级 | reason,severity,target_role |

核心报表：运营就绪评分、资料齐套率、缺陷关闭率、P0/P1 阻断清单、责任切换完成率、CMDB差异趋势、接维逾期任务、证据包完整率。

## 10. CLI 与智能体设计

| 命令 | 用途 | 返回 |
|---|---|---|
| `zhihang takeover list --site YZ-A --status checking --json` | 查询接维批次列表 | JSON，含 traceId/auditId/result |
| `zhihang takeover create --project P2026-M6 --template new-dc --site M6` | 创建接维批次 | JSON，含 traceId/auditId/result |
| `zhihang takeover diff --batch TK-202606-0001 --scope asset,point` | 触发 CMDB/点位差异比对 | JSON，含 traceId/auditId/result |
| `zhihang takeover checklist verify --item ITEM-01 --result pass --evidence E1,E2` | 核验清单项 | JSON，含 traceId/auditId/result |
| `zhihang takeover defect add --batch TK-1 --severity P1 --owner supplier-a` | 登记遗留缺陷 | JSON，含 traceId/auditId/result |
| `zhihang takeover document review --doc DOC-1 --decision reject --reason missing-signature` | 审核资料包 | JSON，含 traceId/auditId/result |
| `zhihang takeover responsibility sign --shift RS-1 --decision agree` | 责任切换签署 | JSON，含 traceId/auditId/result |
| `zhihang takeover workflow decide --task TASK-1 --decision approve` | 审批流程任务 | JSON，含 traceId/auditId/result |
| `zhihang takeover report export --batch TK-1 --type readiness --format pdf` | 导出运营就绪报告 | JSON，含 traceId/auditId/result |
| `zhihang takeover archive --batch TK-1 --watermark true --signature org` | 归档证据包 | JSON，含 traceId/auditId/result |

智能体能力：读取批次状态、解释阻断原因、生成补证清单、比对资料版本、生成客户报告草稿、追踪逾期缺陷、推荐风险例外条款。所有智能体建议必须保留引用来源，不可直接改状态。

## 11. 高保真 Demo 验收脚本

1. 从第三批预览站打开 24 接维管理，确认首页显示接维完成率、资料齐套率、遗留缺陷关闭率和责任切换率。
2. 点击批次表格首行，打开详情抽屉，看到站点、责任人、状态、审计规则和证据链。
3. 在清单核验页面筛选 `消防/资料缺失`，打开清单项，上传证据并提交核验。
4. 在遗留缺陷页面新增 P1 缺陷，选择供应商责任方和整改期限，提交后生成整改工单。
5. 在责任切换工作台对设备运行、告警处理、资料维护三类责任域签署，看到状态变化和审计日志。
6. 在审批与验收页面执行有条件通过，系统要求填写例外条款和整改截止日期。
7. 在报表页面导出运营就绪报告，报告包含 hash、水印、批次号和风险清单。
8. 在异常队列模拟 CMDB 不可用，页面显示最后快照、重试按钮和人工补录入口。

## 12. 风险、边界与待确认

- 待确认：不同客户对 P1 有条件接维的接受标准是否一致，是否需要客户签署例外条款。
- 待确认：AI盒子/视频证据是否可作为正式验收证据，还是只能作为辅助证据。
- 待确认：资料密级和客户可见范围需要与权限中心、文档中心统一。
- 风险：如果 CMDB 模型字段不统一，接维差异比对会退化成手工清单；因此必须先固化设备模型模板和应接点位规则。
- 风险：如果工作流只做线性审批，无法表达多专业并行核验和 P0/P1 风险分支；需要支持并行节点、会签、加签、退回、挂起。
- 风险：如果报表不固化证据 hash 和审计日志，客户验收时无法证明资料没有被事后篡改。