Initial commit of akmon project

doc_mall/database/mock_data_documentation.md

@@ -0,0 +1,194 @@
+# 商城系统模拟数据说明
+
+## 数据概览
+
+模拟数据脚本 `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. **数据量**: 适合开发测试，生产环境需要更大数据量
+
+---
+
+**建议**: 在开发环境中使用此模拟数据，生产环境请使用真实的业务数据。