83 lines
3.1 KiB
Markdown
83 lines
3.1 KiB
Markdown
# 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 持久化，刷新免登录 |