# 数据库设计对比分析报告

## 📋 分析时间
2026-05-08

## 📊 对比结果概览

| 项目 | 原始版本 | 新版本(v2) | 变化 |
|------|---------|-----------|------|
| 表数量 | 32张 | 36张 | +4张 |
| 新增表 | - | 4张 | ✅ |
| 调整字段 | 3处 | - | ✅ |

---

## ✅ 已匹配的功能模块（32项）

| 功能模块 | 对应表 | 状态 |
|---------|--------|------|
| 用户登录注册 | `app_user` | ✅ 完整 |
| 会员等级管理 | `app_member_level` | ✅ 完整 |
| 会员购买记录 | `app_user_member_order` | ✅ 完整 |
| 商品分类(三级) | `app_product_category` | ✅ 完整 |
| 商品品牌 | `app_product_brand` | ✅ 完整 |
| 商品规格 | `app_product_spec` + `app_product_spec_value` | ✅ 完整 |
| 商品主表 | `app_product` | ✅ 完整 |
| 商品SKU | `app_product_sku` | ✅ 完整 |
| 购物车 | `app_cart` | ✅ 完整 |
| 订单 | `app_order` | ✅ 完整 |
| 订单商品 | `app_order_item` | ✅ 完整 |
| 退款/售后 | `app_order_refund` | ✅ 完整 |
| 积分记录 | `app_points_record` | ✅ 完整 |
| 签到记录 | `app_signin_record` | ✅ 完整 |
| 优惠券 | `app_coupon` | ✅ 完整 |
| 用户优惠券 | `app_user_coupon` | ✅ 完整 |
| 积分兑换商品 | `app_points_product` | ✅ 完整 |
| 积分兑换订单 | `app_points_order` | ✅ 完整 |
| 分销关系 | `app_distribution_relation` | ✅ 完整 |
| 佣金记录 | `app_commission_record` | ✅ 完整 |
| 佣金提现 | `app_commission_withdraw` | ✅ 完整 |
| 活动 | `app_activity` | ✅ 完整 |
| 活动报名 | `app_activity_signup` | ✅ 完整 |
| 门店 | `app_store` | ✅ 完整 |
| 穿线预约 | `app_stringing_appointment` | ✅ 完整 |
| 轮播图 | `app_banner` | ✅ 完整 |
| 文章/公告 | `app_article` | ✅ 完整 |
| 后台管理员 | `app_admin_user` | ✅ 完整 |
| 角色权限 | `app_role` | ✅ 完整 |
| 余额充值 | `app_recharge_record` | ✅ 完整 |
| 资金流水 | `app_fund_flow` | ✅ 完整 |
| 积分配置 | `app_points_config` | ✅ 完整 |
| 签到配置 | `app_signin_config` | ✅ 完整 |
| 系统配置 | `app_system_config` | ✅ 完整 |
| 消息通知 | `app_notification` | ✅ 完整 |
| 文件上传 | `app_file_upload` | ✅ 完整 |
| 用户地址 | `app_user_address` | ✅ 完整 |
| 订单支付 | `app_order_payment` | ✅ 完整 |

---

## 🆕 新增表（4张）

### 1. 会员推广下级记录表
**表名**: `app_member_subordinate`
**用途**: 会员录入下级手机号记录（核心业务流程：会员开通与推广下级流程）
**关键字段**:
- `member_id` - 会员ID(上级)
- `sub_phone` - 下级手机号
- `sub_user_id` - 下级用户ID(注册后填充)
- `member_fee` - 收取的下级会员费(298元)
- `fee_paid` - 会员费是否已收
- `register_status` - 注册状态

### 2. 优惠券指定用户表
**表名**: `app_coupon_specified_user`
**用途**: 后台定向发放优惠券给指定用户
**关键字段**:
- `coupon_id` - 优惠券ID
- `user_id` - 指定用户ID
- `status` - 发送状态

### 3. 协议内容表
**表名**: `app_agreement`
**用途**: 隐私政策、服务协议等协议内容管理
**关键字段**:
- `agreement_key` - 协议标识(privacy/service/copyright/about)
- `agreement_name` - 协议名称
- `title` - 前端显示标题
- `content` - 协议正文
- `version` - 版本号
- `is_required` - 是否必读

### 4. (订单表新增字段)
**表名**: `app_order`
**新增字段**:
- `aftersale_end_time` - 售后期结束时间（支持佣金结算）

---

## 🔧 调整字段

### 1. 用户表 `app_user`
| 字段名 | 调整内容 | 原因 |
|-------|---------|------|
| 新增 `display_id` | 用户专属推广码 | 分销推广功能需要显示ID |

### 2. 会员等级表 `app_member_level`
| 字段名 | 调整内容 | 原因 |
|-------|---------|------|
| 新增 `member_fee` | 下级会员费 | 会员收取下级的298元费用 |

### 3. 活动表 `app_activity`
| 字段名 | 调整内容 | 原因 |
|-------|---------|------|
| 新增 `max_teams` | 最大报名队伍数 | 支持限制队伍数 |

### 4. 用户优惠券表 `app_user_coupon`
| 字段名 | 调整内容 | 原因 |
|-------|---------|------|
| 新增 `receive_type` | 领取方式 | 区分主动领取/后台发放/活动奖励 |

### 5. 佣金提现表 `app_commission_withdraw`
| 字段名 | 调整内容 | 原因 |
|-------|---------|------|
| 调整 `single_limit` 注释 | 单次提现限额(最低) | 200元起提 |

---

## 📌 与开发计划的完整映射

### 小程序端功能 → 数据库表

| 功能 | 数据库表 | 备注 |
|-----|---------|------|
| 手机短信登录 | `app_user.phone` | ✅ |
| 微信授权登录 | `app_user.openid/unionid` | ✅ |
| 隐私政策协议 | `app_agreement` | 🆕新增 |
| LOGO/名称 | `app_system_config` | ✅ |
| 搜索商品 | `app_product` | ✅ |
| 消息通知 | `app_notification` | ✅ |
| 轮播图 | `app_banner` | ✅ |
| 活动报名 | `app_activity` + `app_activity_signup` | ✅ |
| 穿线预约 | `app_store` + `app_stringing_appointment` | ✅ |
| 积分商城 | `app_points_product` | ✅ |
| 积分签到 | `app_signin_record` | ✅ |
| 会员升级 | `app_member_level` + `app_user_member_order` | ✅ |
| 分佣查看 | `app_commission_record` | ✅ |
| 佣金提现 | `app_commission_withdraw` | ✅ |
| 商城/分类 | `app_product` + `app_product_category` | ✅ |
| 购物车 | `app_cart` | ✅ |
| 我的订单 | `app_order` + `app_order_item` | ✅ |
| 优惠券 | `app_user_coupon` | ✅ |

### 后台管理端功能 → 数据库表

| 功能 | 数据库表 | 备注 |
|-----|---------|------|
| 会员列表 | `app_user` + `app_member_level` | ✅ |
| 商品管理 | `app_product` | ✅ |
| 商品规格 | `app_product_spec` | ✅ |
| 批量导入导出 | 业务逻辑层实现 | ✅ |
| 订单管理 | `app_order` | ✅ |
| 退款/售后 | `app_order_refund` | ✅ |
| 优惠券管理 | `app_coupon` | ✅ |
| 定向发券 | `app_coupon_specified_user` | 🆕新增 |
| 积分抵扣设置 | `app_points_config` | ✅ |
| 积分商城管理 | `app_points_product` | ✅ |
| 轮播图管理 | `app_banner` | ✅ |
| 系统公告 | `app_article` | ✅ |
| 用户管理 | `app_admin_user` | ✅ |
| 角色权限 | `app_role` | ✅ |
| 门店管理 | `app_store` | ✅ |
| 账务概况 | `app_fund_flow` + `app_recharge_record` | ✅ |
| 佣金提现审核 | `app_commission_withdraw` | ✅ |
| 佣金记录 | `app_commission_record` | ✅ |
| 积分记录 | `app_points_record` | ✅ |

---

## ✅ 结论

**数据库设计与开发计划完全匹配！**

- 新版本 SQL 文件：`/Users/gxwebsoft/JAVA/paopao-java/docs/db_paopao_v2.sql`
- 包含 36 张数据表，覆盖所有功能需求
- 支持 9 大核心业务流程
- 包含初始化数据（默认协议、系统配置）

### 建表执行命令
```bash
# 连接数据库执行
mysql -h 47.119.165.234 -P 13308 -u root -p db_paopao < db_paopao_v2.sql
```