FE/README.md
2026-05-06 19:43:57 +08:00

3.1 KiB
Raw Blame History

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
状态管理 Zustandwith localStorage persist
脑图渲染 ReactFlow
图标库 lucide-react
后端框架 FastAPI
数据库 SQLite可切换 MySQL
ORM SQLAlchemy

快速启动

# 前端
npm install
npm run dev

# 后端(可选)
cd backend
pip install -r requirements.txt
uvicorn main:app --reload

账号体系

  • 账号来源:src/user.json(姓名 → 飞书 OpenID 映射)
  • 默认密码:admin123
  • 登录状态通过 localStorage 持久化,刷新免登录