# 商品寄卖服务模块 - 数据库设计说明

> **项目名称**: 商品寄卖服务模块  
> **数据库类型**: MySQL 5.7  
> **字符集**: utf8mb4  
> **存储引擎**: InnoDB  
> **文档版本**: V1.0  
> **创建日期**: 2024年12月

---

## 目录

1. [数据库概述](#一数据库概述)
2. [数据表分类](#二数据表分类)
3. [核心业务表设计](#三核心业务表设计)
4. [用户相关表设计](#四用户相关表设计)
5. [商品相关表设计](#五商品相关表设计)
6. [订单交易表设计](#六订单交易表设计)
7. [财务相关表设计](#七财务相关表设计)
8. [系统配置表设计](#八系统配置表设计)
9. [表关系图](#九表关系图)
10. [索引设计建议](#十索引设计建议)
11. [数据字典](#十一数据字典)

---

## 一、数据库概述

### 1.1 设计原则
- **规范性**: 遵循第三范式，减少数据冗余
- **扩展性**: 预留扩展字段，便于后期功能升级
- **性能**: 合理设计索引，优化查询效率
- **安全性**: 敏感信息加密存储，权限严格控制
- **完整性**: 使用外键约束保证数据一致性

### 1.2 命名规范
- **表名**: 统一前缀 `wa_`，使用小写字母和下划线
- **字段名**: 使用小写字母和下划线，语义清晰
- **主键**: 统一使用 `id` 作为主键名
- **时间字段**: 统一使用 `created_at`（创建时间）和 `updated_at`（更新时间）

### 1.3 数据表统计
| 分类 | 表数量 | 说明 |
|------|--------|------|
| 用户相关 | 3张 | 用户表、地址表、支付账户表 |
| 商品相关 | 3张 | 商品表、寄售商品表、商品分类表 |
| 订单交易 | 1张 | 订单表 |
| 财务相关 | 5张 | 余额、优惠券、奖金、提现记录表 |
| 系统配置 | 5张 | 轮播图、设置、短信、上传、选项表 |
| 权限管理 | 4张 | 管理员、角色、权限规则表 |
| **总计** | **22张** | - |

---

## 二、数据表分类

### 2.1 核心业务表（7张）
```
wa_users          # 用户表
wa_goods          # 商品表
wa_merchandise    # 寄售商品表
wa_order          # 订单表
wa_category       # 商品分类表
wa_address        # 收货地址表
wa_banner         # 轮播图表
```

### 2.2 财务相关表（5张）
```
wa_money_log         # 余额变动表
wa_coupon_log        # 优惠券变动表
wa_selfbonus_log     # 个人奖金变动表
wa_sharebonus_log    # 推广奖金变动表
wa_withdraw          # 提现表
```

### 2.3 支付相关表（2张）
```
wa_alipay         # 用户支付宝表
wa_bank           # 用户银行卡表
```

### 2.4 系统管理表（8张）
```
wa_admins         # 管理员表
wa_admin_roles    # 管理员角色关联表
wa_roles          # 角色表
wa_rules          # 权限规则表
wa_options        # 选项表
wa_setting        # 设置配置表
wa_sms            # 短信验证码表
wa_uploads        # 附件上传表
```

---

## 三、核心业务表设计

### 3.1 用户表 (wa_users)

**表说明**: 存储用户基本信息、财务信息、邀请关系等核心数据

**表结构**:
| 字段名 | 类型 | 长度 | 允许NULL | 默认值 | 说明 |
|--------|------|------|----------|--------|------|
| id | int | 10 | 否 | - | 主键ID |
| pid | int | 11 | 是 | 0 | 父级用户ID（推荐人） |
| username | varchar | 32 | 否 | - | 用户名 |
| nickname | varchar | 40 | 否 | - | 昵称 |
| mobile | varchar | 16 | 是 | - | 手机号 |
| password | varchar | 255 | 是 | - | 密码（加密） |
| salt | varchar | 128 | 是 | - | 密码盐 |
| sex | enum | - | 否 | 1 | 性别: 0=女, 1=男 |
| avatar | varchar | 255 | 是 | - | 头像URL |
| invite | varchar | 11 | 是 | - | 邀请码 |
| level | tinyint | 4 | 否 | 1 | 用户等级 |
| birthday | date | - | 是 | - | 生日 |
| money | decimal | 13,3 | 否 | 0.000 | 余额（元） |
| coupon | decimal | 13,3 | 否 | 0.000 | 优惠券余额 |
| self_bonus | decimal | 13,3 | 否 | 0.000 | 我的奖金 |
| share_bonus | decimal | 13,3 | 否 | 0.000 | 推广奖金 |
| score | int | 11 | 否 | 0 | 积分 |
| last_time | datetime | - | 是 | - | 最后登录时间 |
| last_ip | varchar | 50 | 是 | - | 最后登录IP |
| join_time | datetime | - | 是 | - | 注册时间 |
| join_ip | varchar | 50 | 是 | - | 注册IP |
| token | varchar | 50 | 是 | - | 登录Token |
| status | tinyint | 4 | 否 | 1 | 状态: 0=禁用, 1=启用 |
| is_vip | tinyint | 1 | 是 | 0 | 是否VIP: 0=否, 1=是 |
| viptime | datetime | - | 是 | - | VIP截止时间 |
| contract | varchar | 255 | 是 | '' | 合同文件 |
| max_order | int | 10 | 否 | 0 | 最高可抢单数 |
| is_resell | tinyint | 1 | 是 | 1 | 是否可转拍: 0=否, 1=是 |
| created_at | datetime | - | 是 | - | 创建时间 |
| updated_at | datetime | - | 是 | - | 更新时间 |

**业务逻辑**:
- `pid`: 记录推荐人关系，用于推广奖励计算
- `invite`: 用户专属邀请码，用于邀请新用户
- `money/coupon/self_bonus/share_bonus`: 四种财务账户，独立管理
- `is_vip`: VIP用户可享受提前抢购等特权
- `max_order`: 限制用户最大可抢购订单数量
- `is_resell`: 控制用户是否可以进行商品转拍

**索引建议**:
```sql
PRIMARY KEY (`id`)
UNIQUE KEY `mobile` (`mobile`)
UNIQUE KEY `invite` (`invite`)
INDEX `idx_pid` (`pid`)
INDEX `idx_status` (`status`)
```

---

### 3.2 商品表 (wa_goods)

**表说明**: 存储平台自营商品信息

**表结构**:
| 字段名 | 类型 | 长度 | 允许NULL | 默认值 | 说明 |
|--------|------|------|----------|--------|------|
| id | int | 11 | 否 | - | 主键ID |
| goods_category_id | int | 11 | 是 | - | 商品分类ID |
| images | varchar | 1500 | 否 | - | 商品图片（JSON数组） |
| title | varchar | 255 | 否 | - | 商品标题 |
| price | decimal | 10,2 | 否 | 0.00 | 售价 |
| line_price | decimal | 10,2 | 否 | 0.00 | 原价（划线价） |
| stock_num | int | 11 | 否 | 0 | 库存数量 |
| sales_volume | int | 11 | 是 | 0 | 显示销量 |
| content | text | - | 是 | - | 商品详情（富文本） |
| notes | text | - | 是 | - | 购买须知 |
| status | tinyint | 1 | 否 | 1 | 状态: 0=下架, 1=上架 |
| created_at | datetime | - | 否 | - | 创建时间 |
| updated_at | datetime | - | 否 | - | 更新时间 |

**业务逻辑**:
- `images`: 存储JSON格式的图片URL数组，如: `["url1","url2"]`
- `line_price`: 原价用于显示折扣，增强营销效果
- `sales_volume`: 虚拟销量，可手动设置
- `content`: 富文本商品详情，支持HTML格式

**索引建议**:
```sql
PRIMARY KEY (`id`)
INDEX `idx_category` (`goods_category_id`)
INDEX `idx_status` (`status`)
INDEX `idx_created_at` (`created_at`)
```

---

### 3.3 寄售商品表 (wa_merchandise)

**表说明**: 存储用户寄售的二手商品信息

**表结构**:
| 字段名 | 类型 | 长度 | 允许NULL | 默认值 | 说明 |
|--------|------|------|----------|--------|------|
| id | int | 11 | 否 | - | 主键ID |
| old_id | int | 11 | 是 | 0 | 从订单转拍过来的原订单ID |
| user_id | int | 11 | 否 | - | 卖家用户ID |
| title | varchar | 255 | 是 | '' | 商品标题 |
| image | varchar | 1500 | 是 | '' | 商品图片 |
| price | decimal | 10,2 | 否 | 0.00 | 寄售价格 |
| is_show | tinyint | 1 | 是 | 1 | 是否显示: 0=隐藏, 1=显示 |
| status | tinyint | 1 | 否 | 1 | 状态: 0=已售, 1=未售 |
| created_at | datetime | - | 否 | - | 创建时间 |
| updated_at | datetime | - | 否 | - | 更新时间 |

**业务逻辑**:
- `old_id`: 支持从已购订单转拍，记录原订单ID，实现二次流转
- `user_id`: 卖家ID，关联到用户表
- `is_show`: 管理员审核通过后设为1，才在前台显示
- `status`: 售出后自动更新为0

**索引建议**:
```sql
PRIMARY KEY (`id`)
INDEX `idx_user_id` (`user_id`)
INDEX `idx_status` (`status`, `is_show`)
INDEX `idx_old_id` (`old_id`)
```

---

### 3.4 订单表 (wa_order)

**表说明**: 存储所有交易订单信息（包括商品订单和寄售商品订单）

**表结构**:
| 字段名 | 类型 | 长度 | 允许NULL | 默认值 | 说明 |
|--------|------|------|----------|--------|------|
| id | int | 10 | 否 | - | 主键ID |
| old_id | int | 11 | 是 | - | 从订单转拍过来的原订单ID |
| seller_id | int | 11 | 否 | - | 卖家ID（平台或用户） |
| buyer_id | int | 11 | 是 | 0 | 买家ID |
| order_sn | varchar | 255 | 是 | - | 订单编号 |
| total_money | decimal | 10,2 | 是 | 0.00 | 支付金额 |
| pay_time | datetime | - | 是 | - | 支付时间 |
| pay_img | varchar | 255 | 是 | - | 支付凭证图片 |
| status | tinyint | 1 | 否 | 0 | 订单状态: 0=待付款, 1=已支付, 2=已完成 |
| is_resell | tinyint | 1 | 是 | 0 | 是否转拍: 0=否, 1=是 |
| is_show | tinyint | 1 | 是 | 1 | 是否显示: 0=隐藏, 1=显示 |
| is_cancel | tinyint | 1 | 是 | 0 | 是否取消: 0=否, 1=是 |
| consignee | char | 50 | 是 | - | 收货人 |
| phone | char | 50 | 是 | - | 收货电话 |
| province | char | 50 | 是 | - | 省份 |
| city | char | 50 | 是 | - | 城市 |
| area | char | 50 | 是 | - | 区县 |
| address | varchar | 255 | 是 | - | 详细地址 |
| merchandise_id | int | 11 | 是 | 0 | 寄售商品ID（如果是寄售商品订单） |
| confirm_time | datetime | - | 是 | - | 确认收货时间 |
| buy_time | datetime | - | 是 | - | 下单抢购时间 |
| buy_ip | varchar | 50 | 是 | - | 下单IP |
| cancel_ip | varchar | 50 | 是 | - | 取消订单IP |
| created_at | datetime | - | 否 | - | 创建时间 |
| updated_at | datetime | - | 否 | - | 更新时间 |

**订单状态说明**:
| 状态值 | 状态名称 | 说明 | 可执行操作 |
|--------|----------|------|-----------|
| 0 | 待付款 | 订单已创建，等待支付 | 支付、取消 |
| 1 | 已支付 | 买家已支付，等待卖家发货 | 申请退款 |
| 2 | 已完成 | 交易完成，确认收货 | 评价、申请售后 |

**业务逻辑**:
- `order_sn`: 唯一订单号，格式建议：年月日+时分秒+随机数
- `seller_id`: 0表示平台自营，>0表示用户寄售
- `merchandise_id`: >0表示这是一个寄售商品订单
- `is_resell`: 标记该订单是否已转拍
- `pay_img`: 如果采用线下支付，上传支付凭证
- 收货地址字段冗余存储，防止用户修改地址后历史订单地址变更

**索引建议**:
```sql
PRIMARY KEY (`id`)
UNIQUE KEY `order_sn` (`order_sn`)
INDEX `idx_seller_buyer` (`seller_id`, `buyer_id`)
INDEX `idx_status` (`status`)
INDEX `idx_merchandise` (`merchandise_id`)
INDEX `idx_created_at` (`created_at`)
```

---

## 四、用户相关表设计

### 4.1 收货地址表 (wa_address)

**表说明**: 存储用户收货地址信息

**表结构**:
| 字段名 | 类型 | 长度 | 允许NULL | 默认值 | 说明 |
|--------|------|------|----------|--------|------|
| id | int | 11 | 否 | - | 主键ID |
| user_id | int | 11 | 是 | - | 用户ID |
| consignee | varchar | 255 | 是 | '' | 收货人姓名 |
| phone | char | 50 | 是 | - | 手机号 |
| province | varchar | 255 | 是 | '' | 省份 |
| city | varchar | 255 | 是 | '' | 城市 |
| area | varchar | 255 | 是 | '' | 区县 |
| address | varchar | 255 | 是 | '' | 详细地址 |
| is_default | tinyint | 1 | 否 | - | 是否默认地址: 0=否, 1=是 |
| created_at | datetime | - | 是 | - | 创建时间 |
| updated_at | datetime | - | 是 | - | 更新时间 |

**业务逻辑**:
- 每个用户可以有多个收货地址
- `is_default=1` 的地址在下单时自动选中
- 设置新默认地址时，需要将该用户其他地址的`is_default`设为0

**索引建议**:
```sql
PRIMARY KEY (`id`)
INDEX `idx_user_id` (`user_id`)
INDEX `idx_default` (`user_id`, `is_default`)
```

---

### 4.2 用户支付宝表 (wa_alipay)

**表说明**: 存储用户支付宝收款账户信息

**表结构**:
| 字段名 | 类型 | 长度 | 允许NULL | 默认值 | 说明 |
|--------|------|------|----------|--------|------|
| id | int | 11 | 否 | - | 主键ID |
| user_id | int | 11 | 是 | - | 用户ID |
| username | varchar | 255 | 是 | '' | 真实姓名 |
| account | varchar | 255 | 是 | '' | 支付宝账号 |
| qrcode | varchar | 255 | 是 | '' | 收款码图片URL |
| phone | char | 50 | 是 | - | 手机号 |
| created_at | datetime | - | 是 | - | 创建时间 |
| updated_at | datetime | - | 是 | - | 更新时间 |

**业务逻辑**:
- 用于提现时选择支付宝收款方式
- `qrcode`: 可选，用户上传收款二维码

**索引建议**:
```sql
PRIMARY KEY (`id`)
INDEX `idx_user_id` (`user_id`)
```

---

### 4.3 用户银行卡表 (wa_bank)

**表说明**: 存储用户银行卡信息

**表结构**:
| 字段名 | 类型 | 长度 | 允许NULL | 默认值 | 说明 |
|--------|------|------|----------|--------|------|
| id | int | 11 | 否 | - | 主键ID |
| user_id | int | 11 | 是 | - | 用户ID |
| username | varchar | 255 | 是 | '' | 持卡人姓名 |
| bank | varchar | 255 | 是 | '' | 开户行 |
| account | varchar | 255 | 是 | '' | 银行卡号（加密存储） |
| phone | char | 50 | 是 | - | 预留手机号 |
| created_at | datetime | - | 是 | - | 创建时间 |
| updated_at | datetime | - | 是 | - | 更新时间 |

**业务逻辑**:
- 用于提现时选择银行卡收款方式
- `account`: 银行卡号需要加密存储，保护用户隐私

**索引建议**:
```sql
PRIMARY KEY (`id`)
INDEX `idx_user_id` (`user_id`)
```

---

## 五、商品相关表设计

### 5.1 商品分类表 (wa_category)

**表说明**: 商品分类管理

**表结构**:
| 字段名 | 类型 | 长度 | 允许NULL | 默认值 | 说明 |
|--------|------|------|----------|--------|------|
| id | int | 10 | 否 | - | 主键ID |
| name | varchar | 255 | 否 | - | 分类名称 |
| weight | int | 11 | 是 | 0 | 排序权重（数字越大越靠前） |
| status | tinyint | 4 | 否 | 1 | 状态: 0=隐藏, 1=显示 |
| created_at | datetime | - | 否 | - | 创建时间 |
| updated_at | datetime | - | 否 | - | 更新时间 |

**业务逻辑**:
- `weight`: 用于前台分类排序展示
- 当前为一级分类，如需多级分类可增加`pid`字段

**索引建议**:
```sql
PRIMARY KEY (`id`)
INDEX `idx_status_weight` (`status`, `weight`)
```

---

### 5.2 轮播图表 (wa_banner)

**表说明**: 首页轮播图管理

**表结构**:
| 字段名 | 类型 | 长度 | 允许NULL | 默认值 | 说明 |
|--------|------|------|----------|--------|------|
| id | int | 10 | 否 | - | 主键ID |
| image | varchar | 255 | 否 | - | 图片URL |
| url | varchar | 255 | 是 | '' | 跳转地址（页面路径或外部链接） |
| weight | int | 11 | 是 | 0 | 排序权重 |
| created_at | datetime | - | 否 | - | 创建时间 |
| updated_at | datetime | - | 否 | - | 更新时间 |

**业务逻辑**:
- `url`: 点击轮播图跳转的目标地址
- `weight`: 控制轮播图显示顺序

**索引建议**:
```sql
PRIMARY KEY (`id`)
INDEX `idx_weight` (`weight`)
```

---

## 六、订单交易表设计

订单表已在核心业务表中详细说明，此处补充订单关联的业务说明。

### 6.1 订单业务流程

```
创建订单 (status=0)
    ↓
支付订单 (status=1, 记录pay_time)
    ↓
卖家发货
    ↓
买家确认收货 (status=2, 记录confirm_time)
    ↓
交易完成
```

### 6.2 订单取消逻辑

| 场景 | 操作 | 数据变更 |
|------|------|----------|
| 待付款取消 | 买家/系统超时 | is_cancel=1, 记录cancel_ip |
| 已支付取消 | 需要双方协商或平台介入 | is_cancel=1, 退款处理 |

### 6.3 订单转拍逻辑

```
买家购买商品
    ↓
确认收货 (status=2)
    ↓
申请转拍 (is_resell=1)
    ↓
创建寄售商品记录 (wa_merchandise, old_id=订单ID)
    ↓
其他用户购买
    ↓
生成新订单
```

---

## 七、财务相关表设计

### 7.1 余额变动表 (wa_money_log)

**表说明**: 记录用户余额的所有变动记录

**表结构**:
| 字段名 | 类型 | 长度 | 允许NULL | 默认值 | 说明 |
|--------|------|------|----------|--------|------|
| id | int | 10 | 否 | - | 主键ID |
| user_id | int | 10 | 否 | 0 | 用户ID |
| type | tinyint | 1 | 是 | 1 | 类型: 1=收入, 2=支出 |
| money | decimal | 13,3 | 否 | 0.000 | 变更金额 |
| before | decimal | 13,3 | 否 | 0.000 | 变更前余额 |
| after | decimal | 13,3 | 否 | 0.000 | 变更后余额 |
| memo | varchar | 255 | 是 | '' | 备注说明 |
| created_at | datetime | - | 否 | - | 创建时间 |
| updated_at | datetime | - | 否 | - | 更新时间 |

**业务逻辑**:
- 每次余额变动都需要记录一条日志
- `before`和`after`字段用于核对余额计算是否正确
- `memo`记录变动原因，如："购买商品"、"充值"、"退款"等

**收入场景**:
- 充值
- 退款
- 活动奖励

**支出场景**:
- 购买商品
- 提现

**索引建议**:
```sql
PRIMARY KEY (`id`)
INDEX `idx_user_type` (`user_id`, `type`)
INDEX `idx_created_at` (`created_at`)
```

---

### 7.2 优惠券变动表 (wa_coupon_log)

**表说明**: 记录用户优惠券的所有变动记录

**表结构**:
| 字段名 | 类型 | 长度 | 允许NULL | 默认值 | 说明 |
|--------|------|------|----------|--------|------|
| id | int | 10 | 否 | - | 主键ID |
| user_id | int | 10 | 否 | 0 | 用户ID |
| type | tinyint | 1 | 是 | 1 | 类型: 1=收入, 2=支出, 3=提现驳回 |
| money | decimal | 13,3 | 否 | 0.000 | 变更金额 |
| before | decimal | 13,3 | 否 | 0.000 | 变更前金额 |
| after | decimal | 13,3 | 否 | 0.000 | 变更后金额 |
| memo | varchar | 255 | 是 | '' | 备注说明 |
| created_at | datetime | - | 否 | - | 创建时间 |
| updated_at | datetime | - | 否 | - | 更新时间 |

**业务逻辑**:
- 优惠券是平台发放的虚拟货币，不可提现（根据业务规则可能可以提现）
- `type=3` 提现驳回，将扣除的金额返还

**索引建议**:
```sql
PRIMARY KEY (`id`)
INDEX `idx_user_type` (`user_id`, `type`)
```

---

### 7.3 个人奖金变动表 (wa_selfbonus_log)

**表说明**: 记录用户个人奖金的所有变动记录

**表结构**:
| 字段名 | 类型 | 长度 | 允许NULL | 默认值 | 说明 |
|--------|------|------|----------|--------|------|
| id | int | 10 | 否 | - | 主键ID |
| user_id | int | 10 | 否 | 0 | 用户ID |
| type | tinyint | 1 | 是 | 1 | 类型: 1=收入, 2=支出 |
| money | decimal | 13,3 | 否 | 0.000 | 变更金额 |
| before | decimal | 13,3 | 否 | 0.000 | 变更前金额 |
| after | decimal | 13,3 | 否 | 0.000 | 变更后金额 |
| memo | varchar | 255 | 是 | '' | 备注说明 |
| created_at | datetime | - | 否 | - | 创建时间 |
| updated_at | datetime | - | 否 | - | 更新时间 |

**业务逻辑**:
- 个人奖金来源于用户自己的交易奖励
- 可以提现或转入余额

**索引建议**:
```sql
PRIMARY KEY (`id`)
INDEX `idx_user_id` (`user_id`)
```

---

### 7.4 推广奖金变动表 (wa_sharebonus_log)

**表说明**: 记录用户推广奖金的所有变动记录

**表结构**:
| 字段名 | 类型 | 长度 | 允许NULL | 默认值 | 说明 |
|--------|------|------|----------|--------|------|
| id | int | 10 | 否 | - | 主键ID |
| user_id | int | 10 | 否 | 0 | 用户ID |
| type | tinyint | 1 | 是 | 1 | 类型: 1=收入, 2=支出, 3=提现驳回 |
| money | decimal | 13,3 | 否 | 0.000 | 变更金额 |
| before | decimal | 13,3 | 否 | 0.000 | 变更前金额 |
| after | decimal | 13,3 | 否 | 0.000 | 变更后金额 |
| memo | varchar | 255 | 是 | '' | 备注说明 |
| created_at | datetime | - | 否 | - | 创建时间 |
| updated_at | datetime | - | 否 | - | 更新时间 |

**业务逻辑**:
- 推广奖金来源于邀请用户的消费返佣
- 支持提现功能

**索引建议**:
```sql
PRIMARY KEY (`id`)
INDEX `idx_user_type` (`user_id`, `type`)
```

---

### 7.5 提现表 (wa_withdraw)

**表说明**: 记录用户提现申请和处理结果

**表结构**:
| 字段名 | 类型 | 长度 | 允许NULL | 默认值 | 说明 |
|--------|------|------|----------|--------|------|
| id | int | 10 | 否 | - | 主键ID |
| transfer_no | varchar | 255 | 否 | '' | 提现编号（唯一） |
| user_id | int | 11 | 否 | 0 | 用户ID |
| cate | tinyint | 1 | 否 | 0 | 提现类型: 2=优惠券, 4=推广奖金 |
| account_type | tinyint | 1 | 是 | 1 | 账号类型: 1=银行卡, 2=支付宝 |
| account_id | int | 11 | 是 | 0 | 收款账号ID（关联银行卡或支付宝表） |
| account_info | text | - | 是 | - | 收款账号信息（JSON格式） |
| money | decimal | 13,2 | 否 | 0.00 | 提现金额 |
| handling_fee | decimal | 13,2 | 否 | 0.00 | 手续费 |
| actual_amount | decimal | 13,2 | 否 | 0.00 | 实际到账金额 |
| status | tinyint | 3 | 否 | 0 | 状态: 0=待审核, 1=通过, 2=驳回 |
| remark | varchar | 255 | 是 | '' | 备注（驳回原因等） |
| created_at | datetime | - | 否 | - | 申请时间 |
| updated_at | datetime | - | 是 | - | 更新时间 |

**提现类型说明**:
| cate | 名称 | 对应字段 |
|------|------|----------|
| 2 | 优惠券提现 | wa_users.coupon |
| 4 | 推广奖金提现 | wa_users.share_bonus |

**提现状态流转**:
```
用户申请 (status=0)
    ↓
管理员审核
    ↓
通过 (status=1, 扣除相应账户余额) / 驳回 (status=2, 返还金额)
```

**业务逻辑**:
- `transfer_no`: 唯一提现流水号
- `account_info`: 冗余存储收款账号信息，防止用户修改账号后历史记录丢失
- `actual_amount = money - handling_fee`
- 驳回时需要返还扣除的金额，并记录到对应的变动表（type=3）

**索引建议**:
```sql
PRIMARY KEY (`id`)
UNIQUE KEY `transfer_no` (`transfer_no`)
INDEX `idx_user_status` (`user_id`, `status`)
INDEX `idx_created_at` (`created_at`)
```

---

## 八、系统配置表设计

### 8.1 管理员表 (wa_admins)

**表说明**: 后台管理员账号信息

**表结构**:
| 字段名 | 类型 | 长度 | 允许NULL | 默认值 | 说明 |
|--------|------|------|----------|--------|------|
| id | int | 10 | 否 | - | 主键ID |
| username | varchar | 32 | 否 | - | 登录账号 |
| nickname | varchar | 40 | 否 | - | 昵称 |
| password | varchar | 255 | 否 | - | 密码（加密） |
| avatar | varchar | 255 | 是 | /app/admin/avatar.png | 头像 |
| email | varchar | 100 | 是 | - | 邮箱 |
| mobile | varchar | 16 | 是 | - | 手机号 |
| qrcode | varchar | 255 | 是 | '' | 二维码 |
| login_at | datetime | - | 是 | - | 最后登录时间 |
| status | tinyint | 4 | 是 | - | 状态: 0=禁用, 1=启用 |
| created_at | datetime | - | 是 | - | 创建时间 |
| updated_at | datetime | - | 是 | - | 更新时间 |

**索引建议**:
```sql
PRIMARY KEY (`id`)
UNIQUE KEY `username` (`username`)
INDEX `idx_status` (`status`)
```

---

### 8.2 角色表 (wa_roles)

**表说明**: 管理员角色配置

**表结构**:
| 字段名 | 类型 | 长度 | 允许NULL | 默认值 | 说明 |
|--------|------|------|----------|--------|------|
| id | int | 10 | 否 | - | 主键ID |
| name | varchar | 80 | 否 | - | 角色名称 |
| rules | text | - | 是 | - | 权限规则ID集合（JSON数组） |
| pid | int | 10 | 是 | - | 父级角色ID |
| created_at | datetime | - | 否 | - | 创建时间 |
| updated_at | datetime | - | 否 | - | 更新时间 |

**索引建议**:
```sql
PRIMARY KEY (`id`)
```

---

### 8.3 管理员角色关联表 (wa_admin_roles)

**表说明**: 管理员与角色的多对多关系

**表结构**:
| 字段名 | 类型 | 长度 | 允许NULL | 默认值 | 说明 |
|--------|------|------|----------|--------|------|
| id | int | 11 | 否 | - | 主键ID |
| role_id | int | 11 | 否 | - | 角色ID |
| admin_id | int | 11 | 否 | - | 管理员ID |

**索引建议**:
```sql
PRIMARY KEY (`id`)
INDEX `idx_admin_role` (`admin_id`, `role_id`)
```

---

### 8.4 权限规则表 (wa_rules)

**表说明**: 后台权限菜单和功能规则

**表结构**:
| 字段名 | 类型 | 长度 | 允许NULL | 默认值 | 说明 |
|--------|------|------|----------|--------|------|
| id | int | 10 | 否 | - | 主键ID |
| title | varchar | 255 | 否 | - | 菜单标题 |
| icon | varchar | 255 | 是 | - | 图标 |
| key | varchar | 255 | 否 | - | 权限标识（唯一） |
| pid | int | 10 | 是 | 0 | 父级菜单ID |
| href | varchar | 255 | 是 | - | 链接地址 |
| type | int | 11 | 否 | 1 | 类型: 1=菜单, 2=按钮 |
| weight | int | 11 | 是 | 0 | 排序权重 |
| created_at | datetime | - | 否 | - | 创建时间 |
| updated_at | datetime | - | 否 | - | 更新时间 |

**索引建议**:
```sql
PRIMARY KEY (`id`)
UNIQUE KEY `key` (`key`)
INDEX `idx_pid` (`pid`)
```

---

### 8.5 短信验证码表 (wa_sms)

**表说明**: 存储发送的短信验证码记录

**表结构**:
| 字段名 | 类型 | 长度 | 允许NULL | 默认值 | 说明 |
|--------|------|------|----------|--------|------|
| id | int | 10 | 否 | - | 主键ID |
| mobile | varchar | 16 | 否 | - | 手机号 |
| event | varchar | 16 | 否 | - | 事件名（register/login/forget等） |
| code | varchar | 10 | 否 | - | 验证码 |
| times | int | 11 | 是 | 0 | 已验证次数 |
| ip | varchar | 50 | 否 | - | 发送IP |
| created_at | datetime | - | 是 | - | 创建时间 |
| updated_at | datetime | - | 是 | - | 更新时间 |

**业务逻辑**:
- 验证码有效期通常为5-10分钟，通过`created_at`判断
- `times`记录验证失败次数，超过限制（如3次）则失效
- 同一手机号、同一事件类型，1分钟内只能发送一次

**索引建议**:
```sql
PRIMARY KEY (`id`)
INDEX `idx_mobile_event` (`mobile`, `event`)
INDEX `idx_created_at` (`created_at`)
```

---

### 8.6 附件上传表 (wa_uploads)

**表说明**: 记录所有上传的文件信息

**表结构**:
| 字段名 | 类型 | 长度 | 允许NULL | 默认值 | 说明 |
|--------|------|------|----------|--------|------|
| id | int | 11 | 否 | - | 主键ID |
| name | varchar | 128 | 否 | - | 文件名称 |
| url | varchar | 255 | 否 | - | 文件URL |
| admin_id | int | 11 | 是 | - | 上传管理员ID |
| file_size | int | 11 | 否 | - | 文件大小（字节） |
| mime_type | varchar | 255 | 否 | - | MIME类型 |
| image_width | int | 11 | 是 | - | 图片宽度（如果是图片） |
| image_height | int | 11 | 是 | - | 图片高度（如果是图片） |
| ext | varchar | 128 | 否 | - | 文件扩展名 |
| storage | varchar | 255 | 否 | local | 存储位置: local/oss/qiniu等 |
| category | varchar | 128 | 是 | - | 文件分类 |
| created_at | date | - | 是 | - | 上传时间 |
| updated_at | date | - | 是 | - | 更新时间 |

**索引建议**:
```sql
PRIMARY KEY (`id`)
INDEX `idx_admin_id` (`admin_id`)
INDEX `idx_created_at` (`created_at`)
```

---

### 8.7 选项表 (wa_options)

**表说明**: 存储系统配置的键值对

**表结构**:
| 字段名 | 类型 | 长度 | 允许NULL | 默认值 | 说明 |
|--------|------|------|----------|--------|------|
| id | int | 10 | 否 | - | 主键ID |
| name | varchar | 255 | 否 | - | 配置键名 |
| value | longtext | - | 否 | - | 配置值 |
| created_at | datetime | - | 否 | 2022-08-15 00:00:00 | 创建时间 |
| updated_at | datetime | - | 否 | 2022-08-15 00:00:00 | 更新时间 |

**使用示例**:
```json
{
  "name": "site_name",
  "value": "寄卖商城"
}
```

**索引建议**:
```sql
PRIMARY KEY (`id`)
UNIQUE KEY `name` (`name`)
```

---

### 8.8 设置配置表 (wa_setting)

**表说明**: 系统设置的结构化存储

**表结构**:
| 字段名 | 类型 | 长度 | 允许NULL | 默认值 | 说明 |
|--------|------|------|----------|--------|------|
| id | int | 10 | 否 | - | 主键ID |
| name | varchar | 30 | 是 | '' | 变量名 |
| group | varchar | 30 | 是 | '' | 分组名 |
| title | varchar | 100 | 是 | '' | 变量标题 |
| tip | varchar | 100 | 是 | '' | 变量描述 |
| value | text | - | 是 | - | 变量值 |

**索引建议**:
```sql
PRIMARY KEY (`id`)
INDEX `idx_group` (`group`)
```

---

## 九、表关系图

### 9.1 核心业务表关系

```
┌─────────────┐         ┌──────────────┐         ┌─────────────┐
│  wa_users   │────1:N──│  wa_address  │         │ wa_category │
│  (用户表)    │         │  (地址表)     │         │ (商品分类)   │
└─────────────┘         └──────────────┘         └─────────────┘
       │                                                  │
       │ 1:N                                             1:N
       │                                                  │
       ↓                                                  ↓
┌─────────────┐                                  ┌─────────────┐
│wa_merchandise│                                 │  wa_goods   │
│ (寄售商品)   │                                  │  (商品表)    │
└─────────────┘                                  └─────────────┘
       │                                                  │
       │ 1:N                                             1:N
       │                                                  │
       └──────────────┬──────────────────────────────────┘
                      ↓
              ┌──────────────┐
              │   wa_order   │
              │   (订单表)    │
              └──────────────┘
```

### 9.2 财务表关系

```
┌─────────────┐
│  wa_users   │
│  (用户表)    │
│  - money    │──────1:N────→  wa_money_log (余额变动)
│  - coupon   │──────1:N────→  wa_coupon_log (优惠券变动)
│  - self_bonus│─────1:N────→  wa_selfbonus_log (个人奖金变动)
│  - share_bonus│────1:N────→  wa_sharebonus_log (推广奖金变动)
└─────────────┘
       │
       │ 1:N
       ↓
┌──────────────┐
│  wa_withdraw │
│  (提现表)     │
└──────────────┘
       │
       ├──────→  wa_bank (银行卡)
       └──────→  wa_alipay (支付宝)
```

### 9.3 权限管理表关系

```
┌─────────────┐
│  wa_admins  │
│  (管理员)    │
└─────────────┘
       │
       │ N:M (through wa_admin_roles)
       ↓
┌─────────────┐         ┌──────────────┐
│  wa_roles   │────1:N──│  wa_rules    │
│  (角色表)    │         │  (权限规则)   │
└─────────────┘         └──────────────┘
```

---

## 十、索引设计建议

### 10.1 主键索引
所有表都应该有主键索引：
```sql
PRIMARY KEY (`id`)
```

### 10.2 唯一索引
对于需要保证唯一性的字段：
```sql
-- 用户表
UNIQUE KEY `mobile` (`mobile`)
UNIQUE KEY `invite` (`invite`)

-- 订单表
UNIQUE KEY `order_sn` (`order_sn`)

-- 提现表
UNIQUE KEY `transfer_no` (`transfer_no`)

-- 管理员表
UNIQUE KEY `username` (`username`)
```

### 10.3 普通索引
常用查询字段添加索引：

**用户相关**:
```sql
-- wa_users
INDEX `idx_pid` (`pid`)
INDEX `idx_status` (`status`)
INDEX `idx_mobile` (`mobile`)
INDEX `idx_invite` (`invite`)

-- wa_address
INDEX `idx_user_id` (`user_id`)
INDEX `idx_default` (`user_id`, `is_default`)
```

**商品相关**:
```sql
-- wa_goods
INDEX `idx_category` (`goods_category_id`)
INDEX `idx_status` (`status`)
INDEX `idx_created_at` (`created_at`)

-- wa_merchandise
INDEX `idx_user_id` (`user_id`)
INDEX `idx_status` (`status`, `is_show`)
```

**订单相关**:
```sql
-- wa_order
INDEX `idx_seller_buyer` (`seller_id`, `buyer_id`)
INDEX `idx_status` (`status`)
INDEX `idx_merchandise` (`merchandise_id`)
INDEX `idx_created_at` (`created_at`)
```

**财务相关**:
```sql
-- wa_money_log, wa_coupon_log等
INDEX `idx_user_type` (`user_id`, `type`)
INDEX `idx_created_at` (`created_at`)

-- wa_withdraw
INDEX `idx_user_status` (`user_id`, `status`)
```

### 10.4 复合索引说明
- 复合索引遵循最左前缀原则
- 查询频率高的字段放在前面
- 区分度高的字段放在前面

---

## 十一、数据字典

### 11.1 枚举值说明

#### 用户状态 (wa_users.status)
| 值 | 说明 |
|----|------|
| 0 | 禁用 |
| 1 | 启用 |

#### 性别 (wa_users.sex)
| 值 | 说明 |
|----|------|
| 0 | 女 |
| 1 | 男 |

#### 订单状态 (wa_order.status)
| 值 | 说明 |
|----|------|
| 0 | 待付款 |
| 1 | 已支付 |
| 2 | 已完成 |

#### 财务变动类型 (money_log.type等)
| 值 | 说明 |
|----|------|
| 1 | 收入 |
| 2 | 支出 |
| 3 | 提现驳回（部分表） |

#### 提现类型 (wa_withdraw.cate)
| 值 | 说明 |
|----|------|
| 2 | 优惠券提现 |
| 4 | 推广奖金提现 |

#### 提现账号类型 (wa_withdraw.account_type)
| 值 | 说明 |
|----|------|
| 1 | 银行卡 |
| 2 | 支付宝 |

#### 提现状态 (wa_withdraw.status)
| 值 | 说明 |
|----|------|
| 0 | 待审核 |
| 1 | 通过 |
| 2 | 驳回 |

#### 商品状态 (wa_goods.status)
| 值 | 说明 |
|----|------|
| 0 | 下架 |
| 1 | 上架 |

#### 寄售商品状态 (wa_merchandise.status)
| 值 | 说明 |
|----|------|
| 0 | 已售 |
| 1 | 未售 |

---

## 十二、数据库优化建议

### 12.1 性能优化
1. **合理使用索引**: 为常用查询字段添加索引，但避免过多索引影响写入性能
2. **分表策略**: 
   - 日志类表（money_log等）按月分表
   - 订单表按年分表
3. **读写分离**: 主库负责写入，从库负责查询
4. **缓存策略**: 
   - 热点数据缓存到Redis
   - 商品列表、分类等查询缓存

### 12.2 安全建议
1. **敏感信息加密**: 
   - 密码使用bcrypt加密
   - 银行卡号使用AES加密
2. **SQL注入防护**: 使用参数化查询
3. **数据备份**: 
   - 每天全量备份
   - 每小时增量备份

### 12.3 扩展性建议
1. **预留字段**: 每个表预留1-2个扩展字段
2. **软删除**: 重要数据不要物理删除，使用软删除（添加deleted_at字段）
3. **版本控制**: 数据库表结构变更使用migration工具管理

---

## 十三、数据初始化脚本

### 13.1 创建数据库
```sql
CREATE DATABASE IF NOT EXISTS `uniapp_mall` 
DEFAULT CHARACTER SET utf8mb4 
DEFAULT COLLATE utf8mb4_unicode_ci;

USE `uniapp_mall`;
```

### 13.2 添加主键和索引
```sql
-- 用户表
ALTER TABLE `wa_users`
  ADD PRIMARY KEY (`id`),
  ADD UNIQUE KEY `mobile` (`mobile`),
  ADD UNIQUE KEY `invite` (`invite`),
  ADD KEY `idx_pid` (`pid`),
  ADD KEY `idx_status` (`status`);

-- 订单表
ALTER TABLE `wa_order`
  ADD PRIMARY KEY (`id`),
  ADD UNIQUE KEY `order_sn` (`order_sn`),
  ADD KEY `idx_seller_buyer` (`seller_id`, `buyer_id`),
  ADD KEY `idx_status` (`status`),
  ADD KEY `idx_merchandise` (`merchandise_id`);

-- 其他表类似...
```

### 13.3 自增ID设置
```sql
ALTER TABLE `wa_users`
  MODIFY `id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT;

ALTER TABLE `wa_order`
  MODIFY `id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT;

-- 其他表类似...
```

---

## 十四、常见查询SQL示例

### 14.1 用户相关查询

**查询用户及其推荐人信息**:
```sql
SELECT 
  u.id, u.nickname, u.mobile, 
  p.nickname AS parent_nickname
FROM wa_users u
LEFT JOIN wa_users p ON u.pid = p.id
WHERE u.id = 123;
```

**查询用户的所有财务账户余额**:
```sql
SELECT 
  id, nickname, 
  money AS 余额,
  coupon AS 优惠券,
  self_bonus AS 个人奖金,
  share_bonus AS 推广奖金
FROM wa_users 
WHERE id = 123;
```

**查询用户的推广下线列表**:
```sql
SELECT id, nickname, mobile, join_time
FROM wa_users
WHERE pid = 123
ORDER BY join_time DESC;
```

---

### 14.2 订单相关查询

**查询用户的买家订单**:
```sql
SELECT o.*, m.title AS goods_title, m.image
FROM wa_order o
LEFT JOIN wa_merchandise m ON o.merchandise_id = m.id
WHERE o.buyer_id = 123
ORDER BY o.created_at DESC;
```

**查询用户的卖家订单**:
```sql
SELECT o.*, u.nickname AS buyer_nickname
FROM wa_order o
LEFT JOIN wa_users u ON o.buyer_id = u.id
WHERE o.seller_id = 123
ORDER BY o.created_at DESC;
```

**统计订单金额**:
```sql
SELECT 
  COUNT(*) AS order_count,
  SUM(total_money) AS total_amount,
  status
FROM wa_order
WHERE buyer_id = 123
GROUP BY status;
```

---

### 14.3 财务相关查询

**查询余额变动明细**:
```sql
SELECT *
FROM wa_money_log
WHERE user_id = 123
ORDER BY created_at DESC
LIMIT 20;
```

**统计用户收支情况**:
```sql
SELECT 
  type,
  SUM(money) AS total_money,
  COUNT(*) AS count
FROM wa_money_log
WHERE user_id = 123
GROUP BY type;
```

**查询待审核的提现申请**:
```sql
SELECT w.*, u.nickname, u.mobile
FROM wa_withdraw w
LEFT JOIN wa_users u ON w.user_id = u.id
WHERE w.status = 0
ORDER BY w.created_at ASC;
```

---

### 14.4 商品相关查询

**查询寄售商品列表（含卖家信息）**:
```sql
SELECT m.*, u.nickname AS seller_nickname
FROM wa_merchandise m
LEFT JOIN wa_users u ON m.user_id = u.id
WHERE m.status = 1 AND m.is_show = 1
ORDER BY m.created_at DESC;
```

**查询用户的寄售商品**:
```sql
SELECT *
FROM wa_merchandise
WHERE user_id = 123
ORDER BY created_at DESC;
```

---

## 十五、数据库变更记录

### 15.1 版本历史

| 版本号 | 日期 | 变更内容 | 变更人 |
|--------|------|----------|--------|
| V1.0 | 2024-12-01 | 初始数据库设计 | 产品团队 |
| V1.1 | 待定 | 待添加的扩展功能 | - |

### 15.2 待优化项
- [ ] 添加商品评价表
- [ ] 添加物流信息表
- [ ] 添加消息通知表
- [ ] 添加积分商城相关表
- [ ] 优化财务日志表的分表策略

---

**文档维护**: 产品团队  
**最后更新**: 2024年12月  
**下次审查**: 2025年1月