rsgltzyd/testing-tool
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

docs: 更新测试数据生成器功能设计文档

Browse Source 
主要更新：
- 添加字段必填/选填设置和空值率配置
- 移除标签管理系统（20条规则无需标签）
- 添加组合策略保证唯一性生成
- 添加价格生成器（真实分布/心理定价）
- 添加场景化生成器（年龄/数量/评分/折扣/库存）
- 更新所有文档移除emoji，使用纯文字
- 更新类型定义和生成逻辑
This commit is contained in:
雨霖铃
2026-06-05 23:40:36 +08:00
parent f55fd4338d
commit c40b66b703
5 changed files with 1225 additions and 178 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/test-data-generator/generators.md
+228 -22
View File
@@ -2,13 +2,13 @@
## 分类概览
| 分类 | 生成器数量 | 说明 |
| ----------- | ---------- | ------------------------ |
| 👤 个人信息 | 5 个 | 中文姓名、邮箱、手机号等 |
| 💼 业务数据 | 4 个 | 订单号、价格、日期等 |
| 🔧 技术数据 | 3 个 | UUID、IP地址、URL |
| 📝 基础类型 | 4 个 | 整数、浮点数、字符串等 |
| **总计** | **16 个** | |
| 分类 | 生成器数量 | 说明 |
| ----------- | ---------- | ------------------------------------------------ |
| 👤 个人信息 | 6 个 | 中文姓名、邮箱、手机号、年龄等 |
| 💼 业务数据 | 8 个 | 订单号、价格、日期、状态、数量、评分、折扣、库存 |
| 技术数据 | 3 个 | UUID、IP地址、URL |
| 基础类型 | 4 个 | 整数、浮点数、字符串等 |
| **总计** | **21 个** | |
---
@@ -148,6 +148,44 @@
---
### 6. 年龄 (age)
**说明**: 生成真实分布的年龄数据
**参数**:
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
| -------- | ----------------------------------------- | ---- | ----------- | -------- |
| min | number | 否 | 1 | 最小年龄 |
| max | number | 否 | 100 | 最大年龄 |
| strategy | 'realistic' \| 'demographic' \| 'uniform' | 否 | 'realistic' | 生成策略 |
**策略说明**:
| 策略 | 说明 | 适用场景 |
| ----------- | ---------------------------- | ------------ |
| realistic | 正态分布，均值 35，标准差 10 | 通用用户数据 |
| demographic | 按中国人口年龄比例分布 | 市场调研数据 |
| uniform | 均匀随机 | 测试数据 |
**示例**:
```json
{
"name": "age",
"generator": "age",
"params": {
"min": 18,
"max": 65,
"strategy": "realistic"
}
}
```
**生成结果**: 28, 42, 35, 51, 23
---
## 💼 业务数据生成器
### 1. 订单号 (orderId)
@@ -180,31 +218,45 @@
### 2. 价格 (price)
**说明**: 生成价格，保留 2 位小数
**说明**: 生成真实的价格数据，支持多种分布策略
**参数**:
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
| -------- | ----------------------- | ---- | ------- | -------- |
| min | number | 否 | 0.01 | 最小值 |
| max | number | 否 | 9999.99 | 最大值 |
| currency | 'CNY' \| 'USD' \| 'EUR' | 否 | 'CNY' | 货币类型 |
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
| -------- | ------------------------------------------- | ---- | ----------- | -------- |
| min | number | 是 | 1 | 最低价 |
| max | number | 是 | 9999 | 最高价 |
| decimals | 0 \| 1 \| 2 | 否 | 2 | 小数位数 |
| strategy | 'realistic' \| 'uniform' \| 'psychological' | 否 | 'realistic' | 生成策略 |
**生成策略说明**:
| 策略 | 说明 | 适用场景 |
| ------------- | ------------------------------ | ------------ |
| realistic | 对数正态分布，模拟真实商品价格 | 通用电商场景 |
| uniform | 均匀随机，所有价格等概率 | 测试数据 |
| psychological | 心理定价，.99/.98/.95 结尾 | 营销场景 |
**示例**:
```json
{
"name": "amount",
"name": "price",
"generator": "price",
"params": {
"min": 10,
"max": 5000,
"currency": "CNY"
"decimals": 2,
"strategy": "realistic"
}
}
```
**生成结果**: 299.00, 1599.50, 0.01
**生成结果**:
- 真实分布: 299.00, 1599.50, 49.99, 1299.00
- 心理定价: 299.99, 1599.98, 49.95, 1299.99
- 均匀随机: 1234.56, 5678.90, 890.12
---
@@ -265,7 +317,161 @@
---
## 🔧 技术数据生成器
### 5. 数量 (quantity)
**说明**: 生成真实分布的数量数据
**参数**:
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
| -------- | ---------------------------------- | ---- | ----------- | -------- |
| min | number | 否 | 1 | 最小值 |
| max | number | 否 | 100 | 最大值 |
| strategy | 'realistic' \| 'bulk' \| 'uniform' | 否 | 'realistic' | 生成策略 |
**策略说明**:
| 策略 | 说明 | 适用场景 |
| --------- | --------------------------- | -------- |
| realistic | 泊松分布，大多数购买 1-3 件 | 零售订单 |
| bulk | 10-100 之间均匀分布 | 批发订单 |
| uniform | 均匀随机 | 测试数据 |
**示例**:
```json
{
"name": "quantity",
"generator": "quantity",
"params": {
"min": 1,
"max": 50,
"strategy": "realistic"
}
}
```
**生成结果**: 2, 1, 5, 3, 1
---
### 6. 评分 (rating)
**说明**: 生成真实分布的评分数据
**参数**:
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
| -------- | ------------------------------------ | ---- | ----------- | -------- |
| min | number | 否 | 1 | 最低分 |
| max | number | 否 | 5 | 最高分 |
| decimals | number | 否 | 1 | 小数位数 |
| strategy | 'realistic' \| 'strict' \| 'uniform' | 否 | 'realistic' | 生成策略 |
**策略说明**:
| 策略 | 说明 | 适用场景 |
| --------- | ------------------ | -------- |
| realistic | 偏态分布，偏向高分 | 电商平台 |
| strict | 偏态分布，偏向低分 | 严格评审 |
| uniform | 均匀随机 | 测试数据 |
**示例**:
```json
{
"name": "rating",
"generator": "rating",
"params": {
"min": 1,
"max": 5,
"decimals": 1,
"strategy": "realistic"
}
}
```
**生成结果**: 4.5, 4.8, 3.9, 5.0, 4.2
---
### 7. 折扣 (discount)
**说明**: 生成真实分布的折扣数据
**参数**:
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
| -------- | ------------------------------------------- | ---- | --------------- | -------- |
| min | number | 否 | 0.1 | 最低折扣 |
| max | number | 否 | 0.9 | 最高折扣 |
| strategy | 'psychological' \| 'clearance' \| 'uniform' | 否 | 'psychological' | 生成策略 |
**策略说明**:
| 策略 | 说明 | 适用场景 |
| ------------- | ------------------------ | -------- |
| psychological | 常见折扣点（8折、9折等） | 电商促销 |
| clearance | 大折扣区间（3-7折） | 清仓处理 |
| uniform | 均匀随机 | 测试数据 |
**示例**:
```json
{
"name": "discount",
"generator": "discount",
"params": {
"min": 0.1,
"max": 0.9,
"strategy": "psychological"
}
}
```
**生成结果**: 0.80, 0.90, 0.85, 0.95, 0.70
---
### 8. 库存 (stock)
**说明**: 生成真实分布的库存数据
**参数**:
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
| -------- | --------------------------------- | ---- | ----------- | -------- |
| min | number | 否 | 0 | 最小库存 |
| max | number | 否 | 1000 | 最大库存 |
| strategy | 'realistic' \| 'hot' \| 'uniform' | 否 | 'realistic' | 生成策略 |
**策略说明**:
| 策略 | 说明 | 适用场景 |
| --------- | ------------------------ | -------- |
| realistic | 指数分布，大多数库存较少 | 通用商品 |
| hot | 低库存区间（0-50） | 热销商品 |
| uniform | 均匀随机 | 测试数据 |
**示例**:
```json
{
"name": "stock",
"generator": "stock",
"params": {
"min": 0,
"max": 500,
"strategy": "realistic"
}
}
```
**生成结果**: 23, 8, 156, 45, 12
---
## 技术数据生成器
### 1. UUID (uuid)
@@ -347,7 +553,7 @@
---
## 📝 基础类型生成器
## 基础类型生成器
### 1. 随机整数 (randomInt)
@@ -469,17 +675,17 @@
```
┌─────────────────────────────────────────────────────────────────────┐
│ 🔧 选择生成器 │
│ 选择生成器 │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ 🔍 搜索: [搜索生成器... ] │
│ 搜索: [搜索生成器... ] │
│ │
│ 📁 分类筛选 │
│ 分类筛选 │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ 全部 │ │ 个人信息 │ │ 业务数据 │ │ 技术数据 │ │ 基础类型 │ │
│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
│ │
│ 📋 生成器列表 │
│ 生成器列表 │
│ ┌───────────────────────────────────────────────────────────────┐ │
│ │ 👤 个人信息 │ │
│ │ ┌─────────────────────────────────────────────────────────┐ │ │