# Liuma-platform

**Repository Path**: keivnx/liuma-platform

## Basic Information

- **Project Name**: Liuma-platform
- **Description**: 轻量级低代码自动化测试平台，一个平台解决API/WebUI/AppUI测试，本项目为平台端
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: http://www.liumatest.cn
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 10
- **Created**: 2022-11-02
- **Last Updated**: 2022-11-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 流马-低代码测试平台
## 一、项目概述

流马是一款低代码自动化测试平台，旨在采用最简单的架构统一支持API/WebUI/AppUI的自动化测试。平台采用低代码设计模式，将传统测试脚本以配置化实现，从而让代码能力稍弱的用户快速上手自动化测试。同时平台也支持通过简单的代码编写实现自定义组件，使用户可以灵活实现自己的需求。

本项目分为平台端和引擎端，采用分布式执行设计，可以将测试执行的节点(即引擎)注册在任意环境的任意一台机器上，从而突破资源及网络限制。同时，通过将引擎启动在本地PC上，方便用户快速调试测试用例，实时查看执行过程，带来传统脚本编写一致的便捷。

项目体验地址: [演示环境](http://demo.liumatest.cn)，用户名密码: demo/123456

## 二、功能介绍

![系统架构图](http://www.liumatest.cn/assets/images/mocs/system.png)

1. API测试
```
(1) 支持单接口测试和链路测试。
(2) 支持接口统一管理，支持swagger导入。
(3) 支持一键生成字段校验的接口健壮性用例。
(4) 支持全局变量、关联、断言、内置函数、自定义函数。
(5) 支持前后置脚本、失败继续、超时时间、等待/条件/循环等逻辑控制器。
(6) 支持环境与用例解耦，多种方式匹配域名，让一套用例可以在多个环境上执行。
```

2. WebUI测试
```
(1) 支持关键字驱动，零代码编写用例。
(2) 支持UI元素统一管理，Excel模板批量导入。
(3) 支持自定义关键字，封装公共的操作步骤，提升用例可读性。
(4) 支持本地引擎执行，实时查看执行过程。
(5) 支持与API用例在同一用例集合顺序执行。
```

3. AppUI测试(1.1版本上线)
```
(1) 支持WebUI同等用例编写和执行能力
(2) 支持安卓和苹果系统
(3) 支持持真机管理、投屏和在线操作
(4) 支持控件元素在线获取，一键保存元素
(5) 支持实时查看执行过程
```

更多功能及详细请参考: [用户手册](https://docs.qq.com/doc/p/1e36932d41b40df896c1627a004068df9a28fc3f)


## 三、开发环境

环境依赖: nodejs 14、java 1.8、mysql 8
IDE推荐: vue使用VSCode、java使用IDEA

1. 前端启动
```
# 切换目录
cd Liuma-platform/LiuMa-frontend

# 安装依赖
npm install

# 启动项目
npm run dev
```

2. 后端启动
```
Step1: IDEA打开目录 Liuma-platform/LiuMa-backend

Step2: maven安装依赖

Step3: 新建数据库名: liuma

Step4: 配置application.properties数据库连接

Step5: 配置阿里云邮件和七牛云存储相关信息(配置见4，可跳过)

Step6: 启动LiuMaApplication文件
```

3. 验证启动成功

项目启动后，默认会新建两个用户: 系统管理员LMadmin/Liuma@123456、演示项目的项目管理员demo/123456

使用上述初始用户登录平台，登录成功，即表示项目启动成功

4. 第三方服务

（一）阿里云邮件

主要用于计划执行后发送邮件，不配置不影响平台运行
```
Step1: 注册阿里云账号，申请开通邮件服务

Step2: 按照指引配置邮箱服务的相关配置

Step3: 获取accessKey/accessSecret和邮箱地址

Step4: 将以上信息填写在文件~/application.properties对应位置
```

（二）七牛云存储

主要用于存放UI测试执行截图，不配置不影响平台运行
```
Step1: 注册七牛云账号，开通空间存储服务

Step2: 创建存储空间bucket，获取ak/sk信息，同时获取加速域名和上传域名

Step3: 将以上信息填写在文件~/application.properties对应位置
```


## 四、容器部署

容器部署请参考: [部署手册](https://docs.qq.com/doc/p/c989fa8bf467eca1a1e0fa59b32ceab017407168)


## 五、关于我们

流马秉持着帮助中小企业的测试团队快速建立自动化体系的目标，将会不断迭代并吸取用户的建议，欢迎大家给我们提出宝贵的意见。

如需在线交流，可关注微信公众号【流马测试】

![qr](https://user-images.githubusercontent.com/96771570/161195670-3868f409-ed49-431f-8650-185e3e179679.png)