# AIOps 智能运维平台 — 开发路线图

> 版本: v2.0
> 更新日期: 2026-06-21
> 当前阶段: **v0.3.0 — 质量加固** (从功能驱动转向质量驱动)
> 关联文档: [PROJECT_EVALUATION.md](./PROJECT_EVALUATION.md) | [TDD_PLAN.md](./TDD_PLAN.md)

---

## 版本规划总览

```
已完成                                        当前聚焦
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━►
  v0.1.0          v0.2.0          v0.3.0          v0.4.0          v1.0.0
  MVP核心    →    AI能力增强  →   质量加固    →   企业级特性  →   智能化升级
  [完成]          [完成]          [进行中]        [计划]          [计划]
                                      
                  ┌─────────────────────────────────────────────┐
                  │  v0.3.0 重点: 测试 + CI + 重构 + API 文档    │
                  │  目标: 工程质量 30 → 75, 综合评分 72 → 82    │
                  └─────────────────────────────────────────────┘
```

| 版本 | 主题 | 状态 | 目标周期 | 核心交付 |
|------|------|------|---------|---------|
| v0.1.0 | MVP 核心功能 | ✅ 完成 | — | 资产/监控/发布/自动化 |
| v0.2.0 | AI 能力增强 | ✅ 完成 | — | AI 告警分析/脚本生成/故障诊断 |
| **v0.3.0** | **质量加固** | **🔄 进行中** | **2-4 周** | **测试 + CI/CD + 重构 + API 文档** |
| v0.4.0 | 企业级特性 | 📋 计划 | Q3 2026 | MySQL 迁移 / 多云增强 / 安全合规 |
| v1.0.0 | 智能化升级 | 📋 计划 | Q4 2026 | 智能自愈 / 知识图谱 / 开放 API |

---

## v0.3.0 — 质量加固 (当前版本)

> **战略转折点**: 从"功能开发"转向"质量加固"
> **验收标准**: 工程质量 ≥ 75, 后端测试覆盖率 ≥ 50%, CI 流水线全绿

### Sprint 1: 测试基建 (第 1 周)

| # | 任务 | 类型 | 优先级 | 验收标准 | 状态 |
|---|------|------|--------|---------|------|
| 1 | 后端测试框架搭建 | 后端 | P0 | `testify` + `httptest` 引入, `make test` 可运行 | ☐ |
| 2 | K8s handler 单元测试 (第一批) | 后端 | P0 | 覆盖 cluster CRUD + sync, ≥ 15 个测试函数 | ☐ |
| 3 | 认证模块测试 | 后端 | P0 | login/register/JWT 验证全覆盖 | ☐ |
| 4 | 前端测试框架搭建 | 前端 | P1 | Vitest + Testing Library 引入, `npm test` 可运行 | ☐ |
| 5 | CI 流水线搭建 | DevOps | P0 | `.gitea/workflows/ci.yml`: lint → test → build | ☐ |

### Sprint 2: 核心重构 (第 2 周)

| # | 任务 | 类型 | 优先级 | 验收标准 | 状态 |
|---|------|------|--------|---------|------|
| 6 | 拆分 kubernetes.go (96KB → 8 文件) | 后端 | P0 | cluster/deployment/pod/service/hpa/cronjob/config/node 各自独立 | ☐ |
| 7 | Go module 重命名 ezops → aiops | 后端 | P1 | `go.mod` module 名 + 全量 import 路径替换 | ☐ |
| 8 | K8s handler 测试 (第二批) | 后端 | P0 | 覆盖 deployment/scale/restart/HPA, ≥ 20 个测试函数 | ☐ |
| 9 | Pipeline executor 测试 | 后端 | P1 | 覆盖 pipeline 创建/执行/日志流 | ☐ |
| 10 | golangci-lint 集成 | DevOps | P1 | `.golangci.yml` 配置, CI 中 lint 零 error | ☐ |

### Sprint 3: API 文档 + 前端测试 (第 3 周)

| # | 任务 | 类型 | 优先级 | 验收标准 | 状态 |
|---|------|------|--------|---------|------|
| 11 | 引入 Swagger/swaggo | 后端 | P1 | `swag init` 生成 API 文档, 核心路由注解覆盖 | ☐ |
| 12 | 告警引擎测试 | 后端 | P1 | 覆盖告警规则评估/通知触发/静默逻辑 | ☐ |
| 13 | 前端核心组件测试 | 前端 | P2 | K8s/Login/Dashboard 组件 ≥ 10 个测试用例 | ☐ |
| 14 | Playwright E2E 冒烟测试 | 前端 | P2 | 登录/服务器列表/K8s 集群 3 条核心流程 | ☐ |
| 15 | 审计 CSV 导出 TODO | 后端 | P2 | `audit.go:223` 实现 CSV/Excel 导出 | ☐ |

### Sprint 4: 质量收尾 (第 4 周)

| # | 任务 | 类型 | 优先级 | 验收标准 | 状态 |
|---|------|------|--------|---------|------|
| 16 | 全量回归测试 | QA | P0 | 15 模块手动回归 + 自动化测试全绿 | ☐ |
| 17 | 覆盖率报告 | DevOps | P1 | 后端 ≥ 50%, 生成覆盖率徽章 | ☐ |
| 18 | 代码规范文档 | 文档 | P2 | 更新 CLAUDE.md + 新增 CONTRIBUTING.md | ☐ |
| 19 | v0.3.0 Release Notes | 文档 | P2 | CHANGELOG.md 更新 | ☐ |
| 20 | v0.3.0 发布部署 | DevOps | P0 | 3 种部署方式全部验证通过 | ☐ |

### v0.3.0 验收检查点

- [ ] 后端测试覆盖率 ≥ 50%
- [ ] CI 流水线: push → lint → test → build → 全绿
- [ ] kubernetes.go 拆分完成, 单文件不超过 500 行
- [ ] API 文档可访问 (Swagger UI)
- [ ] 前端冒烟 E2E 3 条流程通过
- [ ] golangci-lint 零 error
- [ ] 3 种部署方式全部验证通过

---

## v0.4.0 — 企业级特性 (计划 Q3 2026)

> **目标**: 提升可扩展性和安全性,支撑生产级多租户部署

### 后端任务

| # | 任务 | 优先级 | 验收标准 |
|---|------|--------|---------|
| 1 | SQLite → MySQL 迁移 | P0 | 利用 GORM 抽象层,数据迁移脚本,双写过渡 |
| 2 | 告警异步化 (Redis Stream) | P1 | 告警引擎解耦, 告警队列消费器 |
| 3 | 多租户支持 (数据隔离) | P1 | tenant_id 全表注入, 查询自动过滤 |
| 4 | 安全基线检查模块 | P2 | CIS Benchmark 基础检查 |
| 5 | 漏洞扫描集成 | P2 | 对接 Trivy / Clair |

### 前端任务

| # | 任务 | 优先级 | 验收标准 |
|---|------|--------|---------|
| 6 | 自定义仪表盘 (拖拽) | P1 | 用户自定义监控面板组件 |
| 7 | 告警降噪和聚合视图 | P2 | 告警分组/抑制/聚合展示 |
| 8 | 多渠道告警通知配置 UI | P2 | 钉钉/飞书/企微/邮件/短信 |

### DevOps 任务

| # | 任务 | 优先级 | 验收标准 |
|---|------|--------|---------|
| 9 | Helm Chart 仓库 | P1 | 官方 Helm Chart + 版本管理 |
| 10 | 蓝绿/金丝雀发布支持 | P2 | Pipeline 增加发布策略 |
| 11 | 自动回滚机制 | P2 | 健康检查失败自动回滚 |

---

## v1.0.0 — 智能化升级 (计划 Q4 2026)

> **目标**: 全栈智能化, 降低人工干预

### 智能化

| # | 任务 | 优先级 | 验收标准 |
|---|------|--------|---------|
| 1 | 智能自愈引擎 | P0 | 故障检测 → 自动修复 → 效果验证闭环 |
| 2 | 运维知识图谱 | P1 | 故障知识沉淀 + 智能问答增强 |
| 3 | 容量预测与扩缩容 | P1 | 基于历史数据的资源预测 |
| 4 | AIOps 工作台 | P2 | 个性化运维视图 + 任务推荐 |

### 生态

| # | 任务 | 优先级 | 验收标准 |
|---|------|--------|---------|
| 5 | 开放 API 平台 (REST + GraphQL) | P1 | 完整 API 覆盖 + SDK |
| 6 | 插件市场框架 | P2 | 插件 SDK + 官方插件 |
| 7 | Webhook 体系完善 | P2 | 全事件 Webhook 通知 |

---

## 进度追踪表

| 版本 | 状态 | 开始日期 | 完成日期 | 备注 |
|------|------|---------|---------|------|
| v0.1.0 MVP | ✅ 完成 | — | 2026-06 | 15 模块核心功能 |
| v0.2.0 AI增强 | ✅ 完成 | — | 2026-06 | AI 告警/脚本/诊断 |
| v0.3.0 质量加固 | 🔄 进行中 | 2026-06-21 | — | 当前聚焦 |
| v0.4.0 企业级 | 📋 计划 | — | — | MySQL/多租户/安全 |
| v1.0.0 智能化 | 📋 计划 | — | — | 自愈/知识图谱 |

---

## 技术债务清单 (持续追踪)

| # | 债务 | 严重度 | 引入版本 | 计划清除版本 | 状态 |
|---|------|--------|---------|------------|------|
| 1 | 零测试覆盖 | 🔴 P0 | v0.1.0 | v0.3.0 | ☐ |
| 2 | kubernetes.go 巨型文件 (96KB) | 🟡 P1 | v0.1.0 | v0.3.0 | ☐ |
| 3 | Go module 名 `ezops` | 🟡 P1 | v0.1.0 | v0.3.0 | ☐ |
| 4 | SQLite 并发瓶颈 | 🟡 P1 | v0.1.0 | v0.4.0 | ☐ |
| 5 | 无 API 自动文档 | 🟡 P1 | v0.1.0 | v0.3.0 | ☐ |
| 6 | 无 CI/CD 流水线 | 🔴 P0 | v0.1.0 | v0.3.0 | ☐ |
| 7 | 审计 CSV 导出缺失 | 🟢 P2 | v0.1.0 | v0.3.0 | ☐ |
| 8 | 无消息队列 | 🟢 P2 | v0.2.0 | v0.4.0 | ☐ |
| 9 | 前端无 E2E 测试 | 🟢 P2 | v0.1.0 | v0.3.0 | ☐ |
| 10 | 无多租户隔离 | 🟢 P2 | — | v0.4.0 | ☐ |