Files
akmon/doc_mall/database/mock_data_documentation.md
2026-01-20 08:04:15 +08:00

195 lines
5.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 商城系统模拟数据说明
## 数据概览
模拟数据脚本 `mock_data_insert.sql` 为商城系统生成了完整的测试数据,便于开发和测试各种功能场景。
## 📊 数据统计
| 数据类型 | 数量 | 说明 |
|---------|------|------|
| 测试用户 | 8个 | 包含管理员、商家、消费者、配送员 |
| 用户地址 | 7个 | 包含家庭、办公室等不同类型地址 |
| 商品分类 | 20+个 | 二级分类体系涵盖8大主要分类 |
| 品牌 | 10个 | 苹果、华为、小米、耐克等知名品牌 |
| 店铺 | 2个 | 数码专营店、时尚小铺 |
| 商品 | 6个 | iPhone、华为手机、小米笔记本、运动鞋、T恤、连衣裙 |
| 商品SKU | 50+个 | 多规格SKU颜色、尺寸、存储等 |
| 订单 | 15+个 | 不同状态的订单(待付款、已完成等) |
| 商品评价 | 10+个 | 真实的用户评价内容 |
| 优惠券 | 5个模板 | 平台券、商家券、各种优惠类型 |
## 👥 测试用户角色
### 管理员
- **用户名**: admin
- **邮箱**: admin@mall.com
- **角色**: 系统管理员
- **权限**: 全部功能权限
### 商家用户
- **商家1**: merchant1 / merchant1@mall.com (张三丰数码专营店)
- **商家2**: merchant2 / merchant2@mall.com (李四海时尚小铺)
- **功能**: 商品管理、订单处理、店铺运营
### 消费者用户
- **用户1**: customer1 / customer1@mall.com (王小明)
- **用户2**: customer2 / customer2@mall.com (刘小红)
- **用户3**: customer3 / customer3@mall.com (陈小华)
- **功能**: 购物、下单、评价、收藏
### 配送员
- **配送员1**: driver1 / driver1@mall.com (赵配送)
- **配送员2**: driver2 / driver2@mall.com (钱师傅)
- **功能**: 接单配送、位置跟踪
## 🛍️ 商品测试数据
### 数码电器类
#### iPhone 15 Pro 256GB
- **价格**: ¥8,999 (市场价¥9,999)
- **规格**: 3种颜色 × 3种存储容量 = 9个SKU
- **特点**: 设为热门商品、新品
- **库存**: 每个SKU 15件
#### 华为 Mate 60 Pro 512GB
- **价格**: ¥6,999 (市场价¥7,999)
- **特点**: 设为热门商品
- **库存**: 28件
#### 小米笔记本 Pro 14
- **价格**: ¥5,999 (市场价¥6,999)
- **特点**: 设为新品
- **库存**: 18件
### 时尚服饰类
#### Nike Air Max 270 男士运动鞋
- **价格**: ¥899 (市场价¥1,099)
- **规格**: 3种颜色 × 5个尺码 = 15个SKU
- **特点**: 设为热门商品、精选商品
- **库存**: 每个SKU 10件
#### UNIQLO 优质棉T恤
- **价格**: ¥59 (市场价¥79)
- **规格**: 4种颜色 × 4个尺码 = 16个SKU
- **特点**: 基础款,高库存
- **库存**: 每个SKU 25件
#### UNIQLO 女装雪纺连衣裙
- **价格**: ¥299 (市场价¥399)
- **特点**: 设为精选商品、新品
- **库存**: 75件
## 📦 订单测试场景
### 订单状态分布
- **已完成**: 60% (便于测试评价功能)
- **待收货**: 20% (测试物流跟踪)
- **待发货**: 15% (测试商家发货)
- **待付款**: 5% (测试支付流程)
### 订单特征
- 每个消费者用户有2-4个订单
- 订单金额范围¥100-¥2,100
- 包含单商品和多商品订单
- 支持不同的收货地址
## 🎟️ 优惠券系统
### 平台优惠券
1. **新用户专享券**: 无门槛50元券
2. **满200减30**: 全平台通用
3. **9折优惠券**: 最高减100元
### 商家优惠券
1. **数码专营店**: 满1000减100
2. **时尚小铺**: 免运费券
### 发放规则
- 每个消费者用户随机获得60%的优惠券
- 支持多种优惠券类型测试
## 📍 地理位置数据
### 地址覆盖
- **主要城市**: 北京市
- **主要区域**: 朝阳区、海淀区、东城区
- **具体地址**: 望京SOHO、国贸大厦、三里屯等知名地标
### 配送范围
- 配送员服务区域:朝阳区、海淀区、东城区
- 配送距离5-20公里
- 配送时间20-60分钟
## 🔍 用户行为数据
### 浏览行为
- 40%的商品有浏览记录
- 浏览时长10-300秒
- 近30天内的浏览历史
### 收藏行为
- 20%的商品被收藏
- 30%的店铺被收藏
- 支持商品和店铺两种收藏类型
### 搜索行为
- 热门搜索词iPhone、华为手机、运动鞋等
- 搜索结果数1-50个
- 近30天的搜索历史
## 📊 评价系统
### 评价分布
- **5星**: 40%
- **4星**: 40%
- **3星**: 20%
- 70%的已完成订单有评价
### 评价内容
- 真实的评价文案
- 30%的评价包含图片
- 10%的评价为匿名评价
## 🚚 配送系统
### 配送任务
- 80%的已发货订单有配送任务
- 配送状态完整覆盖
- 包含取货码、配送轨迹等
### 配送员数据
- 2名配送员
- 包含车辆信息、服务区域
- 实时位置坐标(北京地区)
## 🎯 使用建议
### 开发阶段
1. **API测试**: 使用不同角色用户测试各种API接口
2. **功能测试**: 验证商品展示、下单、支付、配送等完整流程
3. **权限测试**: 测试不同用户角色的权限控制
### 测试场景
1. **购物流程**: 浏览商品 → 加入购物车 → 下单 → 付款 → 配送 → 评价
2. **商家管理**: 商品上架 → 订单处理 → 发货 → 客户服务
3. **营销功能**: 优惠券使用、商品推荐、搜索排序
### 数据维护
- 可根据测试需要调整商品价格和库存
- 可添加更多测试用户和商品数据
- 定期清理测试订单数据
## ⚠️ 注意事项
1. **依赖关系**: 必须先执行 `complete_mall_database.sql` 创建表结构
2. **数据冲突**: 脚本包含冲突处理逻辑,可重复执行
3. **随机性**: 部分数据使用随机生成,每次执行结果略有不同
4. **数据量**: 适合开发测试,生产环境需要更大数据量
---
**建议**: 在开发环境中使用此模拟数据,生产环境请使用真实的业务数据。