# 数据运营平台第一阶段运维移交手册

## 1. 移交范围

本手册面向数据运营平台第一阶段设备治理与运营能力，覆盖服务检查、日常巡检、
备份恢复、发布回滚、安全管理、故障升级和运维培训。部署、离线包、备份和
恢复的执行证据见 `docs/validation/WP13_DEPLOYMENT_BACKUP_RECOVERY_EVIDENCE.md`。

本地工程环境已完成恢复核对；企业目标环境的安装、正式 RPO/RTO 演练和签字
仍需企业运维团队执行。

## 2. 组件与责任

| 组件 | 主要职责 | 企业责任人状态 |
|---|---|---|
| 前端 | 用户界面和权限入口控制 | 待企业指定 |
| 后端 | API、认证授权、业务规则和审计 | 待企业指定 |
| PostgreSQL | 业务、治理和审计主数据 | 待企业指定 |
| Neo4j | 受控图关系投影 | 待企业指定 |
| MinIO | 文件与对象存储 | 待企业指定 |
| n8n | 受控流程运行 | 待企业指定 |

正式移交时应为每个组件指定主责、备岗和升级联系人，并记录工作时间与非工作
时间的联系路径。

## 3. 日常巡检

### 每日巡检

- 检查前端、后端和关键依赖的健康状态。
- 检查登录失败、403 激增、5xx 和任务失败情况。
- 检查数据库、对象存储容量及最近一次备份结果。
- 检查设备摄取、质量运行、整改和知识查询的异常记录。
- 检查关键审计类别是否持续产生记录。

### 每周巡检

- 抽查设备台账来源标识、责任覆盖和版本追溯。
- 抽查实体合并与回滚、质量问题关闭和运行维护证据。
- 核对治理指标趋势并确认异常变化有责任人。
- 验证备份文件可读取、校验值有效且保留周期符合策略。
- 复核停用账号、管理员账号和高权限变更。

### 每月

- 在隔离环境执行一次抽样恢复。
- 复核容量、性能、证书、密钥轮换和补丁计划。
- 汇总故障、缺陷、恢复演练和待办风险。
- 更新运维联系人、责任矩阵和培训覆盖情况。

## 4. 备份与恢复

备份至少覆盖 PostgreSQL、Neo4j、MinIO、配置文件、密钥引用、发布制品和校验
清单。生产密钥本身应由企业密钥系统管理，不应明文进入备份包或代码仓库。

恢复流程：

1. 确认恢复目标、恢复点和变更冻结窗口。
2. 校验备份包完整性并在隔离环境解包。
3. 按依赖顺序恢复数据库、图数据、对象、配置和服务。
4. 核对表数量、审计封印、设备数量、图节点关系和对象数量。
5. 验证前后端健康、登录、只读查询及一条受控业务流程。
6. 记录实际 RPO、RTO、差异和批准人。

恢复失败时保留现场和日志，不覆盖最后一个可用备份。企业生产恢复必须经过
变更审批。

## 5. 发布、升级与回滚

1. 发布前确认变更清单、数据库变更、兼容性和定向测试结果。
2. 在正式构建环境生成镜像或离线制品，记录版本、提交号和校验值。
3. 备份当前数据与配置，确认回滚窗口和执行人。
4. 先在预生产环境验证健康、登录、权限和变更场景。
5. 生产升级后重复关键健康与业务检查。
6. 出现 P0、数据错误、权限越界或不可接受性能退化时立即回滚。

回滚应恢复上一版制品和兼容数据状态。若数据库迁移不可逆，发布前必须准备
经验证的数据回退脚本或恢复方案。

## 6. 安全与审计

- 企业环境必须替换演示密码、令牌和默认密钥引用。
- 管理员账号实行最小授权和职责分离，停用人员账号应及时关闭。
- 日志不得记录密码、完整令牌或不必要的敏感数据。
- 定期复核登录、摄取、实体、语义、质量、整改和知识查询审计。
- 审计封印或关键日志中断应按安全事件处理。
- 第一阶段使用本地认证；单点登录接入前仍需执行企业账号生命周期管理。

## 7. 故障等级与异常升级

| 等级 | 示例 | 响应与升级 |
|---|---|---|
| P0 | 全站不可用、严重数据损坏、权限绕过 | 立即冻结变更，通知技术、业务和安全负责人，启动恢复或回滚 |
| P1 | 关键流程不可用、关键结果错误 | 当日组织处置，明确替代路径和关闭时间 |
| P2 | 非关键功能异常、局部性能下降 | 纳入迭代，持续跟踪影响范围 |
| P3 | 体验或低风险改进 | 纳入产品待办 |

故障记录应包含时间线、影响范围、检测方式、临时处置、根因、永久修复和验证
证据。未确认根因时不得用推测替代事实。

## 8. 培训计划

用户培训包括角色说明、设备台账、实体匹配、质量整改、运行维护、知识问答和
治理指标。运维培训包括健康检查、日志定位、备份恢复、发布回滚、安全审计和
故障升级。

建议现场练习：

1. 查看一台设备的来源、责任和版本。
2. 解释一个实体匹配候选并完成回滚演练。
3. 从质量运行定位问题并完成整改闭环。
4. 对证据不足的运行事件验证拒绝结论。
5. 执行一次隔离环境恢复并核对关键数据。

培训签到、练习结果、问题记录和补训安排由企业培训负责人保存。

## 9. 移交清单

| 项目 | 当前状态 |
|---|---|
| 第一阶段用户操作指南 | 工程材料已就绪 |
| WP14 验收计划、用例和缺陷台账 | 工程材料已就绪 |
| WP13 安装、备份与恢复证据 | 本地证据已就绪 |
| 企业运维主责、备岗和升级联系人 | 待企业指定 |
| 企业目标环境安装 | 待企业执行 |
| 企业 RPO/RTO 恢复演练 | 待企业执行 |
| 用户与运维培训 | 待企业组织 |
| 正式验收与移交签字 | 待企业 UAT 完成后签署 |