# QuantumTest 测试用例管理平台

## 项目目录结构

```
用例管理平台/
├── backend/                     # Python 后端 (FastAPI + SQLite)
│   ├── database.py              # 数据库连接配置（SQLite/MySQL 可切换）
│   ├── models.py                # SQLAlchemy ORM 数据模型
│   ├── main.py                  # FastAPI 路由 & 应用入口
│   ├── seed.py                  # 初始化种子数据脚本
│   └── quantum_test.db          # 本地 SQLite 数据库文件
│
├── src/                         # 前端 (React + TypeScript + Vite)
│   ├── main.tsx                 # 应用入口
│   ├── App.tsx                  # 根组件，路由/视图切换
│   ├── App.css / index.css      # 全局样式
│   ├── user.json                # 用户名 & 飞书 OpenID 映射表
│   │
│   ├── store/
│   │   └── useStore.ts          # Zustand 全局状态（含 localStorage 持久化）
│   │
│   └── components/
│       ├── auth/                # 认证模块
│       │   └── LoginPage.tsx    # 登录页（用户名/密码校验）
│       │
│       ├── layout/              # 布局 & 导航
│       │   ├── Sidebar.tsx      # 左侧导航栏
│       │   └── Toast.tsx        # 全局消息通知
│       │
│       ├── editor/              # 核心用例编辑器
│       │   ├── TableView.tsx    # 用例列表视图（表格 + 脑图双模式）
│       │   ├── MindMapView.tsx  # 脑图视图（ReactFlow）
│       │   ├── PropertyPanel.tsx # 右侧属性面板（详情/步骤编辑）
│       │   ├── UserMentionInput.tsx # @提及用户输入组件
│       │   └── ImportModal.tsx  # AI 智能图片解析导入弹窗
│       │
│       ├── plans/               # 测试计划 & 执行
│       │   ├── PlanListView.tsx # 测试计划列表（创建/筛选/查看）
│       │   └── TaskExecutionView.tsx # 测试任务执行视图（列表/脑图双模式）
│       │
│       └── shared/              # 跨域通用视图
│           ├── DashboardView.tsx # 数据概览仪表盘
│           └── BugView.tsx      # 缺陷列表
│
├── public/                      # 静态资源
├── index.html                   # HTML 入口
├── package.json
├── vite.config.ts
└── tsconfig.json
```

## 技术栈

| 层级 | 技术 |
|------|------|
| 前端框架 | React 18 + TypeScript |
| 构建工具 | Vite |
| 状态管理 | Zustand（with localStorage persist） |
| 脑图渲染 | ReactFlow |
| 图标库 | lucide-react |
| 后端框架 | FastAPI |
| 数据库 | SQLite（可切换 MySQL） |
| ORM | SQLAlchemy |

## 快速启动

```bash
# 前端
npm install
npm run dev

# 后端（可选）
cd backend
pip install -r requirements.txt
uvicorn main:app --reload
```

## 账号体系

- 账号来源：`src/user.json`（姓名 → 飞书 OpenID 映射）
- 默认密码：`admin123`
- 登录状态通过 localStorage 持久化，刷新免登录