# 运维文档目录

本目录用于存放系统运维相关的文档。

## 目录结构

```
operations/
├── deployment/       # 部署文档
│   ├── local.md
│   ├── server.md
│   └── docker.md
├── monitoring/       # 监控文档
│   ├── metrics.md
│   ├── alerts.md
│   └── logging.md
└── troubleshooting/ # 故障排查
    ├── common.md
    ├── critical.md
    └── recovery.md
```

## 文档命名规范

| 类型 | 命名格式 | 示例 |
|-----|---------|------|
| 部署文档 | `deployment/环境.md` | `deployment/server.md` |
| 监控文档 | `monitoring/类型.md` | `monitoring/metrics.md` |
| 故障排查 | `troubleshooting/级别-主题.md` | `troubleshooting/critical-order.md` |

## 部署文档模板

### deployment/server.md

```markdown
# 服务器部署指南

## 环境准备

### 硬件要求
- CPU: 4核+
- 内存: 8GB+
- 磁盘: 100GB+

### 软件要求
- OS: Ubuntu 22.04 LTS+
- Python: 3.10+
- 数据库: PostgreSQL 14+

## 部署步骤

### 1. 安装依赖

\`\`\`bash
sudo apt update
sudo apt install python3.11 python3.11-venv postgresql
\`\`\`

### 2. 配置数据库

\`\`\`bash
sudo -u postgres createdb sanguo_trading
sudo -u postgres psql -c "CREATE USER sanguo WITH PASSWORD 'xxx';"
sudo -u postgres psql -c "GRANT ALL ON DATABASE sanguo_trading TO sanguo;"
\`\`\`

### 3. 部署应用

\`\`\`bash
git clone http://192.168.2.154:3000/sanguo/sanguo_vnpy_v2
cd sanguo_vnpy_v2
python3.11 -m venv venv
source venv/bin/activate
pip install -r requirements/base.txt
\`\`\`

### 4. 配置服务

创建 systemd 服务文件...

### 5. 启动服务

\`\`\`bash
sudo systemctl start sanguo-trader
sudo systemctl enable sanguo-trader
\`\`\`

## 验证部署

\`\`\`bash
curl http://localhost:8000/health
\`\`\`
```

## 监控文档模板

### monitoring/metrics.md

```markdown
# 系统监控指标

## 核心指标

### 交易相关
| 指标 | 说明 | 告警阈值 |
|-----|------|---------|
| order_latency | 订单延迟 | >100ms |
| order_success_rate | 订单成功率 | <99% |
| position_sync_rate | 持仓同步率 | <95% |
| tick_delay | 行情延迟 | >500ms |

### 系统相关
| 指标 | 说明 | 告警阈值 |
|-----|------|---------|
| cpu_usage | CPU使用率 | >80% |
| memory_usage | 内存使用率 | >85% |
| disk_io | 磁盘IO | >90% |

## 告警规则

\`\`\`yaml
alerts:
  - name: OrderDelay
    condition: order_latency > 100
    action: send_alert
    severity: warning
\`\`\`

## 监控工具

- Prometheus + Grafana
- 日志分析
```

## 故障排查模板

### troubleshooting/critical.md

```markdown
# 紧急故障处理手册

## 故障分级

| 级别 | 描述 | 响应时间 |
|-----|------|---------|
| P0 | 系统不可用 | 15分钟 |
| P1 | 核心功能异常 | 1小时 |
| P2 | 部分功能异常 | 4小时 |
| P3 | 轻微问题 | 1个工作日 |

## 常见紧急场景

### 场景1: 订单无法下发

**症状**
- 订单一直处于提交中状态
- 日志显示连接超时

**排查步骤**
1. 检查网络连接
2. 检查接口状态
3. 查看错误日志

**解决方案**
\`\`\`bash
# 重启接口连接
systemctl restart sanguo-gateway
\`\`\`

### 场景2: 行情中断

**症状**
- K线图不再更新
- Tick 数据停止

**排查步骤**
...

## 紧急联系人

| 角色 | 姓名 | 电话 |
|-----|------|------|
| 开发负责人 | xxx | xxx |
| 运维负责人 | xxx | xxx |
| 业务负责人 | xxx | xxx |
```

## 运维检查清单

### 日常检查（每日）
- [ ] 系统运行状态
- [ ] 接口连接状态
- [ ] 错误日志检查
- [ ] 数据备份确认

### 周期检查（每周）
- [ ] 磁盘空间检查
- [ ] 性能指标分析
- [ ] 安全补丁更新

### 月度检查（每月）
- [ ] 备份恢复测试
- [ ] 灾备演练
- [ ] 容量规划评估