# 运维体系目录导读

创建人员：Codex  
文件职责：说明 `common/ops-doc` 下运维体系公共规范、模板和创建指南的用途。  
管理规范/模板：../../全局规范.md；../../体系创建流程.md；运维规范.md。  
引用文件：运维环境创建指南.md；运维审核规范.md；运维事项总纲模版.md；运维事项计划模版.md；运维执行日志模版.md；运维变更记录模版.md；运维审计报告模版.md；运维问题记录模版.md；运维操作手册模版.md。  
记录方式：目录导读；文件清单或职责变化时同步更新。

## 1. 体系定位

运维体系负责把项目已经批准的运行目标落实为可观察、可回滚、可复盘的运行操作。它覆盖服务、任务、配置、数据库、部署、备份恢复、监控告警和事故处置，但不替代项目决策、开发实现或业务判断。

基本原则是：实用优先、快速落地、小步快跑、避免过度设计。只保留能降低真实运行风险的检查、留证和审核。

## 2. 文件清单

| 文件 | 类型 | 职责 |
|---|---|---|
| `运维规范.md` | 全局规范 | 定义事项分级、执行边界、变更、回滚、证据和通信规则 |
| `运维环境创建指南.md` | 创建指南 | 指导项目启用运维体系并创建本地入口 |
| `运维审核规范.md` | 审核规范 | 定义需要独立审核的情形和实质性检查口径 |
| `运维事项总纲模版.md` | 模板 | 登记运维事项、事故和当前状态 |
| `运维事项计划模版.md` | 模板 | 记录必要的短计划、窗口、前置检查和回滚条件 |
| `运维执行日志模版.md` | 模板 | 记录实际命令、结果、证据和终态 |
| `运维变更记录模版.md` | 模板 | 记录运行配置和运行态事实源变化 |
| `运维审计报告模版.md` | 模板 | 记录独立审核或事后复核结论 |
| `运维问题记录模版.md` | 模板 | 跟踪非审计来源问题和事故后续项 |
| `运维操作手册模版.md` | 模板 | 固化可重复的日常操作、检查和恢复步骤 |

## 3. 使用顺序

1. 项目管理员按需启用 `operations`，但不因此自动创建角色。
2. 项目先建立本地 `ops-doc/`、`ops-data/evidence/`、`ops-data/tmp/` 和十个正式入口。
3. 日常只读检查直接按操作手册执行；可回滚变更使用短计划；高风险动作取得项目级明确授权并做一次必要独立审核。
4. 创建运维角色时，其工作说明必须读取本地运维规范、审核规范、操作手册和项目配置，并使用 Codex 原生任务通信。

## 4. 边界

运维体系不保存密码、令牌、私钥或完整连接串；只记录秘密的安全引用、版本或脱敏指纹。代码修复回到开发体系，项目范围和风险接受由项目管理员决定，跨项目或全局控制面事项才升级到管理体系。