Files
opsxsql/ROADMAP.md
T
logan 27989274f5 feat: Phase 2 — frontend-backend integration complete
- All 5 core pages now use real API instead of mock data
  - Dashboard: /api/v1/dashboard/stats
  - Tickets: list/create/detail/approve/execute/statistics
  - Users: list/create/toggle-active/delete
  - Instances: list/create/test-connection/delete
  - Queries: execute with result display + sensitive field masking
- Updated DashboardStats type to match backend schema
- Fixed InstancePage to work with InstanceResponse (no qps/cpu/metrics yet)
- Added create forms for Tickets, Users, Instances
- Added connection test in InstanceDetail
- Updated TDD_PLAN.md: Phase 1 ✅ (44 tests), Phase 2 ✅
- Updated ROADMAP.md: v0.2.0 ✅
- Updated PROJECT_EVALUATION.md: score 5.7 → 6.2
- Frontend build passes with zero TS errors
- 44 backend tests still passing
2026-05-22 12:39:48 +08:00

4.0 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 — 前后端打通 + 核心功能完善 ✅

已完成:

  • 44 个后端 API 测试全部通过 (pytest)
    • auth: 8 (登录/登出/token验证/过期/禁用)
    • users: 8 (CRUD/权限/删自己)
    • instances: 8 (CRUD/连接测试mock/权限)
    • tickets: 11 (列表过滤/CRUD/审批/拒绝/执行/统计/分页)
    • query: 4 (SELECT/DROP拒绝/DELETE拒绝/guest禁止)
    • dashboard: 2 (统计数据/未登录)
  • 前端对接真实 API — 所有页面已替换 mock 数据
    • Dashboard → /api/v1/dashboard/stats
    • 工单 → /api/v1/tickets (列表/创建/详情/审批/执行/统计)
    • 查询 → /api/v1/query (执行+结果展示+敏感字段脱敏)
    • 实例 → /api/v1/instances (列表/创建/连接测试)
    • 用户 → /api/v1/users (列表/创建/切换状态/删除)
  • Vite proxy 配置 — /api → http://localhost:9000
  • 前端 TypeScript 编译通过 — build 无错误

待完成:

  • SQLite → MySQL 生产数据库迁移支持
  • 密码加密存储 — Instance.password 字段加密/解密
  • SQL 审核引擎 — 基于 AST 的 SQL 规则检查
  • 工单自动审核 — 提交时自动跑审核规则
  • 操作审计日志完善 — 所有关键操作记录 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 生产就绪