116 lines
3.0 KiB
Markdown
116 lines
3.0 KiB
Markdown
|
|
# E2E 测试脚本
|
|||
|
|
|
|||
|
|
本目录包含端到端(End-to-End)测试脚本,用于验证WWJCloud NestJS应用的完整功能。
|
|||
|
|
|
|||
|
|
## 📋 测试脚本说明
|
|||
|
|
|
|||
|
|
### 1. 模块功能测试
|
|||
|
|
|
|||
|
|
#### `modules-test.ps1` (PowerShell版本)
|
|||
|
|
- **用途**: 测试4个核心模块的API接口
|
|||
|
|
- **测试模块**: Admin、Member、RBAC、Auth
|
|||
|
|
- **运行环境**: Windows PowerShell
|
|||
|
|
- **运行方式**: `.\modules-test.ps1`
|
|||
|
|
|
|||
|
|
#### `modules-test.sh` (Bash版本)
|
|||
|
|
- **用途**: 测试4个核心模块的API接口
|
|||
|
|
- **测试模块**: Admin、Member、RBAC、Auth
|
|||
|
|
- **运行环境**: Linux/macOS Bash
|
|||
|
|
- **运行方式**: `./modules-test.sh`
|
|||
|
|
|
|||
|
|
### 2. 配置中心测试
|
|||
|
|
|
|||
|
|
#### `config-center-test.ps1`
|
|||
|
|
- **用途**: 测试配置中心功能
|
|||
|
|
- **测试功能**:
|
|||
|
|
- 系统配置获取
|
|||
|
|
- 动态配置管理
|
|||
|
|
- 配置验证
|
|||
|
|
- 配置统计
|
|||
|
|
- 动态配置创建
|
|||
|
|
- **运行环境**: Windows PowerShell
|
|||
|
|
- **运行方式**: `.\config-center-test.ps1`
|
|||
|
|
|
|||
|
|
## 🚀 使用方法
|
|||
|
|
|
|||
|
|
### 前置条件
|
|||
|
|
1. 确保WWJCloud NestJS应用正在运行(默认端口3000)
|
|||
|
|
2. 确保数据库连接正常
|
|||
|
|
3. 确保有测试用的管理员账号(默认: admin/123456)
|
|||
|
|
|
|||
|
|
### 运行测试
|
|||
|
|
|
|||
|
|
#### Windows环境
|
|||
|
|
```powershell
|
|||
|
|
# 进入测试目录
|
|||
|
|
cd test\e2e
|
|||
|
|
|
|||
|
|
# 运行模块测试
|
|||
|
|
.\modules-test.ps1
|
|||
|
|
|
|||
|
|
# 运行配置中心测试
|
|||
|
|
.\config-center-test.ps1
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### Linux/macOS环境
|
|||
|
|
```bash
|
|||
|
|
# 进入测试目录
|
|||
|
|
cd test/e2e
|
|||
|
|
|
|||
|
|
# 给脚本执行权限
|
|||
|
|
chmod +x modules-test.sh
|
|||
|
|
|
|||
|
|
# 运行模块测试
|
|||
|
|
./modules-test.sh
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 📊 测试覆盖范围
|
|||
|
|
|
|||
|
|
### 核心模块测试
|
|||
|
|
- ✅ **基础连接测试**: 验证应用是否正常启动
|
|||
|
|
- ✅ **Swagger文档测试**: 验证API文档是否可访问
|
|||
|
|
- ✅ **Admin模块**: 管理员CRUD操作
|
|||
|
|
- ✅ **Member模块**: 会员CRUD操作
|
|||
|
|
- ✅ **RBAC模块**: 角色权限管理
|
|||
|
|
- ✅ **Auth模块**: 认证授权功能
|
|||
|
|
- ✅ **认证接口测试**: 需要token的接口
|
|||
|
|
|
|||
|
|
### 配置中心测试
|
|||
|
|
- ✅ **登录认证**: 获取访问令牌
|
|||
|
|
- ✅ **系统配置**: 获取系统配置信息
|
|||
|
|
- ✅ **动态配置**: 配置的增删改查
|
|||
|
|
- ✅ **配置验证**: 配置有效性检查
|
|||
|
|
- ✅ **配置统计**: 配置使用统计
|
|||
|
|
|
|||
|
|
## 🔧 测试配置
|
|||
|
|
|
|||
|
|
### 默认配置
|
|||
|
|
- **应用地址**: `http://localhost:3000`
|
|||
|
|
- **管理员账号**: `admin`
|
|||
|
|
- **管理员密码**: `123456`
|
|||
|
|
|
|||
|
|
### 自定义配置
|
|||
|
|
可以修改脚本中的以下变量来适应不同环境:
|
|||
|
|
- `$BaseUrl` / `BASE_URL`: 应用访问地址
|
|||
|
|
- 登录凭据: 根据实际环境调整
|
|||
|
|
|
|||
|
|
## 📝 测试结果
|
|||
|
|
|
|||
|
|
测试脚本会输出彩色的测试结果:
|
|||
|
|
- ✅ **绿色**: 测试通过
|
|||
|
|
- ❌ **红色**: 测试失败
|
|||
|
|
- ℹ️ **蓝色**: 信息提示
|
|||
|
|
|
|||
|
|
## 🛠️ 维护说明
|
|||
|
|
|
|||
|
|
这些测试脚本应该:
|
|||
|
|
1. **定期更新**: 随着API接口的变化及时更新
|
|||
|
|
2. **持续集成**: 可集成到CI/CD流程中
|
|||
|
|
3. **环境适配**: 支持不同的部署环境
|
|||
|
|
4. **错误处理**: 提供详细的错误信息和调试帮助
|
|||
|
|
|
|||
|
|
## 📚 相关文档
|
|||
|
|
|
|||
|
|
- [API接口文档](../../docs/API_INTERFACE_COMPARISON.md)
|
|||
|
|
- [认证授权指南](../../docs/AUTHENTICATION_GUIDE.md)
|
|||
|
|
- [配置设置指南](../../docs/CONFIG_SETUP.md)
|