opsxsql/docs/ROADMAP.md

# SQL-Platform 开发路线图

> 更新时间: 2026-05-26 | 当前版本: **v0.3.1** (Go/Gin 后端)

## 当前版本: v0.3.1

### Python → Go 迁移历程

| 阶段 | 版本 | 后端 | 关键交付 |
|------|------|------|----------|
| Phase 1 | v0.1.0 | Python/FastAPI | 后端 API + TDD 测试 |
| Phase 2 | v0.2.0 | Python/FastAPI | 前后端集成 |
| Phase 3 | v0.3.0 | Python/FastAPI | AES 加密 + SQL 审核引擎 + 审计日志 |
| Phase 4 | v0.4.0 | Python/FastAPI | SQL AST + 规则 CRUD + Alembic + Docker |
| Phase 5 | v0.5.0 | Python/FastAPI | run.sh 运维 + DBConnector + CI/CD |
| Phase 6 | v0.6.0 | Python/FastAPI | Redis/MongoDB + 权限组 + 多步审批流 |
| Phase 7 | v0.7.0 | Python/FastAPI | 多数据库查询/执行引擎 + SQL 助手 |
| Phase 8 | v0.8.0 | Python/FastAPI | P2 高级功能测试 + endpoint 修复 |
| Phase 9 | v0.9.0 | Python/FastAPI | P0 安全修复 — 实例访问控制全线接入权限组 |
| Phase 10 | v0.9.5 | Python/FastAPI | 公告 + Dashboard |
| Phase 11 | v0.9.9 | Python/FastAPI | 审核引擎优化 + 执行结果结构化 |
| Phase 12 | v1.0 | Python/FastAPI | 多数据库浏览 + Redis 树 + 权限体系统一 + 代码分割 |
| Phase 13 | v1.1 | Python/FastAPI | 定时执行工单 + 日志自动清理 + 设置种子 |
| **Migration** | **v0.3.0-go** | **Go/Gin** | **Python→Go 全量重写: Gin + GORM + 120+ 路由 + 25 模型** |
| **Current** | **v0.3.1** | **Go/Gin** | **5 种登录页主题 + Appearance 设置 + 审计员角色 + LDAP** |

### v0.3.1 功能详情

| 功能 | 说明 | 状态 |
|------|------|------|
| Go/Gin 后端 | 完整替代 Python/FastAPI，Gin + GORM + SQLite | ✅ |
| CancelTicket/RollbackTicket | 独立处理器，工单取消/回滚 | ✅ |
| GetTicketTimeline/GetTicketApprovals | 工单时间线 + 审批记录 | ✅ |
| MySQL Instance Detail | 7 个端点 (databases/tables/schema/table_detail/processlist/status/users) | ✅ |
| Redis 9 个 Handler | info/dbsize/keys/key_detail/slowlog/clients/command/create_key/delete_key | ✅ |
| SQL 审核 | POST /tickets/audit | ✅ |
| SQL 格式化/分析 | POST /sql-assistant/format, /sql-assistant/analyze | ✅ |
| 字典/MongoDB stub | 桩端点预留 | ✅ |
| 工单状态: success | 完成（非 completed） | ✅ |
| 4 个种子用户 | admin/张三(dba)/老六(auditor)/路人甲(developer) | ✅ |
| auditor 角色 | 只读审计规则 + 工单 | ✅ |
| LDAP 集成 | 配置/测试/OU管理/用户管理/批量导入 | ✅ |
| 5 种登录页主题 🆕 | SplitView/CenteredCard/SidePanel/FullImage/MinimalDark | ✅ |
| Appearance 设置 🆕 | 主题切换 + 登录页风格选择 | ✅ |
| useLogin 共享 hook 🆕 | 统一登录逻辑，5 主题复用 | ✅ |

---

## Sprint 计划

### Sprint 1: 通知集成完善 (当前)
- [ ] 通知模板管理 UI 完善
- [ ] 通知事件绑定 (工单创建/审批/执行自动触发)
- [ ] 飞书/钉钉/企业微信/邮件 webhook 真实发送
- [ ] 通知发送失败重试机制
- [ ] 通知历史记录查看

### Sprint 2: E2E 测试
- [ ] Playwright E2E 测试框架搭建
- [ ] 登录流程 E2E (5 种主题覆盖)
- [ ] 工单创建-审批-执行全链路 E2E
- [ ] 查询执行 E2E (MySQL/PG/Redis)
- [ ] 用户管理 E2E (CRUD + 权限)
- [ ] Go 后端单元测试覆盖提升
- [ ] API 集成测试

### Sprint 3: 工作流 UI 优化
- [ ] 审批流可视化编辑器 (拖拽节点)
- [ ] 审批流步骤预览
- [ ] 工单时间线可视化
- [ ] 条件分支 UI 配置
- [ ] 审批转审 UI
- [ ] 超时设置可视化

### Sprint 4: 数据脱敏
- [ ] MaskingRule 模型激活 (已有 GORM 模型)
- [ ] 脱敏规则 CRUD UI
- [ ] 内置脱敏函数 (手机号/身份证/邮箱/银行卡)
- [ ] 查询结果自动脱敏
- [ ] 导出数据脱敏
- [ ] 脱敏规则测试预览

### Sprint 5: 生产部署
- [ ] PostgreSQL 生产元数据库支持 (替代 SQLite)
- [ ] Docker 多阶段构建 (Go 二进制 + Nginx 前端)
- [ ] docker-compose 生产配置
- [ ] 数据库备份/恢复
- [ ] 滚动更新策略
- [ ] HTTPS/TLS 配置
- [ ] 生产环境配置分离 (.env.production)

### Sprint 6: 监控与运维
- [ ] Prometheus 指标集成 (Gin middleware)
- [ ] Grafana 仪表盘模板
- [ ] 健康检查增强 (DB/Redis/LDAP 连通性)
- [ ] 慢查询监控面板
- [ ] 系统告警规则
- [ ] 日志聚合 (结构化 JSON 日志)
- [ ] 性能剖析 (pprof 集成)

---

## 远期规划 (P3)

- [ ] 多租户支持
- [ ] 库级权限控制
- [ ] Schema 漂移检测 + 可视化 (SchemaRevision 模型已有)
- [ ] 慢查询实时推送 (WebSocket)
- [ ] 查询审批工作流
- [ ] 集群模式 (分布式会话)
- [ ] 国际化 (i18n)
- [ ] CSV/Excel 导出功能
- [ ] 移动端适配