FastAPI backend with auth, user, instance, ticket, query, dashboard APIs. React + TypeScript frontend with mock data UI (10 pages). SQLite + async SQLAlchemy, JWT auth, role-based access control. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
3.5 KiB
3.5 KiB
Web-Lite 数据审核平台 - 开发路线图
项目路径: ~/devops/sql-platform 创建时间: 2025-05-22 当前版本: v0.1.0-dev
技术栈
| 层 | 技术 |
|---|---|
| 前端 | React 19 + TypeScript 5.9 + Vite 7 + Tailwind CSS 3.4 + shadcn/ui + ECharts 6 |
| 后端 | FastAPI + SQLAlchemy 2 (async) + Pydantic 2 + python-jose + passlib |
| 数据库 | SQLite (开发) / 目标 MySQL/PostgreSQL (生产) |
| 部署 | Docker Compose |
版本规划
v0.1.0 — 基础骨架 ✅ (当前)
后端 API 已实现:
- JWT 认证 (login/logout/me)
- 用户 CRUD (admin only)
- 数据源实例 CRUD + 连接测试 + 列库/列表
- 工单全流程 (创建/审核/执行) + 统计
- SQL 查询执行 + 审计日志
- Dashboard 统计接口
- 角色权限 (admin/dba/developer/guest)
前端已实现:
- 登录页 + 路由守卫
- Dashboard 仪表盘 (统计卡片 + ECharts 趋势图 + 实例状态 + 待处理工单)
- 工单管理页 (列表/筛选/详情/新建/审批)
- 查询审计页 (列表/筛选/详情/新建查询)
- 数据源管理页 (MySQL/PG/Redis/Mongo 实例)
- 用户管理 / 角色管理 / 数据权限 / 审核规则 / 工作流 / 自动任务 / 公告管理 / 平台配置 页面骨架
- API 层 (request.ts + 5 个模块 API)
- Mock 数据层 (lib/mock.ts)
- 主题切换 (dark/light)
v0.2.0 — 前后端打通 + 核心功能完善 🔜
优先级 P0 — 必须完成:
- 前端对接真实 API — 替换所有 mock 数据调用
- Dashboard 对接
/api/v1/dashboard/stats - 工单对接
/api/v1/tickets - 查询对接
/api/v1/query - 实例对接
/api/v1/instances - 用户对接
/api/v1/users
- Dashboard 对接
- Vite proxy 配置 — 开发环境 API 代理到后端 9000 端口
- SQLite → MySQL 生产数据库迁移支持
优先级 P1 — 重要:
- 密码加密存储 — Instance.password 字段加密/解密
- SQL 审核引擎 — 基于 AST 的 SQL 规则检查 (非关键词匹配)
- 工单自动审核 — 提交时自动跑审核规则,生成 audit_result
- 操作审计日志完善 — 所有关键操作记录 AuditLog
v0.3.0 — 审核规则 + 工作流
- 审核规则管理 — 后端 CRUD API + 前端页面
- 工作流引擎 — 多级审批、条件审批
- 数据权限管理 — 库/表/列级权限控制
- 公告管理 — 后端 CRUD + WebSocket 实时推送
v0.4.0 — 高级功能
- SQL 编辑器 — Monaco Editor + 语法高亮 + 自动补全
- 慢查询分析 — 慢查询日志采集 + Explain 执行计划
- 数据脱敏 — 查询结果敏感字段自动脱敏
- 回滚执行 — 工单执行失败自动回滚
- 定时任务 — 自动任务管理 + 定时执行
v0.5.0 — 生产就绪
- 多数据库支持 — PostgreSQL / Redis / MongoDB 实际连接
- WebSocket 通知 — 实时工单状态推送
- LDAP/SSO 集成
- 数据库切换 — 支持 MySQL/PostgreSQL 作为后端存储
- Docker 生产部署 — Nginx 反向代理 + 多阶段构建
- 单元测试 + E2E 测试 — 覆盖率 > 60%
里程碑时间线
| 版本 | 目标日期 | 关键交付 |
|---|---|---|
| v0.2.0 | 2025-06-05 | 前后端打通,核心功能可用 |
| v0.3.0 | 2025-06-20 | 审核规则+工作流完善 |
| v0.4.0 | 2025-07-10 | SQL 编辑器+高级功能 |
| v0.5.0 | 2025-07-30 | 生产就绪 |