# QAMgtPlatform

**Repository Path**: hefeixiao/qamgt-platform

## Basic Information

- **Project Name**: QAMgtPlatform
- **Description**: qa 用例、数据等管理平台，基于vue+spring boot 开发
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2023-02-10
- **Last Updated**: 2023-05-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

#### 简介

基于滴滴AgileTC用例管开源平台开发的一套敏捷测试管理平台，包括测试用例管理、测试数据管理、测试脚本管理等功能。其中用例管理利用开源Vue版本百度脑图组件，支持测试用例集管理、用例分级管理、任务管理等通用能力。适用于软件测试/开发人员用例编写、用例评审、测试任务管理等场景。

#### 特殊说明
- 相比AgileTC增加的功能
  - 支持任务执行中编辑用例并保存
  - 支持查询指定备份用例版本信息，颜色标识增删改
  - 展示当前选中节点个数统计
- 相比AgileTC缺少的功能
  - 添加图片（百度脑图不支持）
  - websocket实时上报功能

#### 功能
- 在线用例管理
  - 用例集服务
    -  搜索用例集
    -  支持xmind脑图格式导入导出
    -  需求关联
    -  用例集增删改
  - 任务服务
    - 需求绑定
    - 圈选用例
    - 任务执行
    - 进度计算
    - 任务增删改
    - 执行任务中编辑用例
  - 用例服务
    - 支持多人编辑
    - 历史记录
  - 文件夹服务
    - 用例集分类管理
- 测试数据管理
  - 测试账号管理
    - 搜索不同状态账号
    - 批量编辑账号使用状态
    - 批量导出测试账号
    

#### 启动方式

 - 环境依赖
    - linux/mac/windows
    - java 1.8
    - mysql

 - 准备
    - 创建依赖数据库，application-dev.properties中配置数据库名称为case_manager    create database case_manager
    - 利用sql中的脚本配置对应表。创建脚本路径：case-server/sql/case-server.sql
    - 修改properties中spring.datasource的配置

 - 运行
    - 后端：标记maven工程，配置application-dev.properties相关参数，idea配置运行
    - 前端：配置对接后端baseUrl，运行npm run dev即可访问
    - 浏览器打开 http://localhost:9528 (具体端口配置见vue.config.js)
    
 - nginx + docker 部署
   1. 前提：熟读docker-compose.yml、Dockerfile文件和agile.env文件,确保文件都在项目根目录
    <br>*(agile.env文件配置mysql容器部署后的用户名，密码等信息)* 
   2. 前端编译打包： `cd platform-ui; npm run build:prod`生成dist目录(命令基于项目根目录开始执行)
   3. 复制dist目录下所有文件到nginx的html目录，使用nginx容器部署，复制到挂载目录即可，如：```/data/release/nginx/qa-platform/html```
   4. 服务器配置nginx conf文件，内容如下（以http://ip:port 访问为例）
   ```
   #user  nginx;
   worker_processes  auto;
   events {
     worker_connections  1024;
   }
   http {
   include       mime.types;
   default_type  application/octet-stream;
   sendfile        on;
   keepalive_timeout  65;
   server {
   listen       8086;
   server_name  localhost;
   location / {
   root   /usr/share/nginx/html;
   try_files $uri $uri/ /index.html last; # 别忘了这个哈
   index  index.html index.htm;
   }
   error_page   500 502 503 504  /50x.html;
   location = /50x.html {
   root   html;
        }
      }
   }
   ```
   5. 后端打包：`cd platform-server; ./mvnw clean package`，src同级target目录生成jar包
   6. 确认本地有 docker 环境，并安装 docker-compose
   7. 停止并删除运行中容器，修改镜像版本: <br />
      执行命令查找当前镜像id:`sudo docker images|grep platform`; <br />
      修改镜像版本，相当于给原镜像打上一个tag:`sudo docker tag {image id} platform-server:{version}` <br />
      删除原镜像版本，相当于去掉之前的tag，比如latest tag: `sudo docker rmi platform-server:latest`
   8. 运行命令 `docker-compose up -d` 启动，会自动打包镜像：`platform-server:latest` 并运行java容器