integral-shop/single_uniapp22miao/docs/商品寄卖服务模块PRD.md

# 商品寄卖服务模块产品需求文档（PRD）

## 1. 产品概述

### 1.1 产品背景
基于现有uniapp商城项目，新增商品寄卖服务模块，为用户提供商品寄卖、代售服务，打造C2C交易平台。


### 1.3 目标用户
- **卖方用户**：有闲置商品需要变现的个人用户
- **买方用户**：寻找性价比商品的消费者
- **平台管理员**：负责审核、管理寄卖商品

## 页面交互流程
按照h5网站：http://miao1.suzhouyuqi.com/#/pages/index/index
登录账号：18621810000，登录密码：123456


## 数据库设计
- Mysql版本： 5.7
- 详细查看“数据库设计说明.md”和“db.sql”文档内容


## 2. 功能需求

### 2.1 用户认证模块

#### 2.1.1 登录功能
**页面对应**：登录页面UI设计
- **功能描述**：用户通过账号密码登录系统
- **输入字段**：
  - 账号（手机号/用户名）
  - 密码
- **功能点**：
  - 账号密码验证
  - 记住密码功能
  - 忘记密码链接
  - 登录状态保持
- **交互逻辑**：
  - 输入验证（非空、格式校验）
  - 登录成功跳转到首页
  - 登录失败显示错误提示

#### 2.1.2 注册功能
**页面对应**：注册页面UI设计
- **功能描述**：新用户注册账号
- **输入字段**：
  - 手机号
  - 验证码
  - 邀请码（可选）
  - 登录密码
- **功能点**：
  - 手机号验证码发送
  - 验证码校验
  - 密码强度检测
  - 用户协议确认
- **交互逻辑**：
  - 获取验证码倒计时
  - 实时密码强度提示
  - 注册成功自动登录

### 2.2 商品展示模块

#### 2.2.1 商品列表页
**页面对应**：商品展示页UI设计
- **功能描述**：展示寄卖商品列表
- **展示内容**：
  - 商品图片
  - 商品名称
  - 寄卖价格
  - 商品状态（寄卖中/已售出）
  - 寄卖人信息
- **功能点**：
  - 商品搜索功能
  - 分类筛选
  - 价格排序
  - 上拉加载更多
- **交互逻辑**：
  - 点击商品进入详情页
  - 搜索实时联想
  - 筛选条件组合

#### 2.2.2 商品搜索功能
- **搜索方式**：
  - 关键词搜索
  - 分类搜索
  - 价格区间筛选
- **搜索结果**：
  - 相关度排序
  - 搜索历史记录
  - 热门搜索推荐

### 2.3 活动促销模块

#### 2.3.1 限时活动页
**页面对应**：活动页面UI设计
- **功能描述**：展示寄卖商品的限时促销活动
- **活动类型**：
  - 限时抢购
  - 降价促销
  - 新品推荐
- **展示内容**：
  - 活动倒计时
  - 活动商品列表
  - 活动规则说明
- **功能点**：
  - 实时倒计时显示
  - 活动商品快速购买
  - 活动提醒设置

### 2.4 商品采购下单模块

#### 2.4.1 商品详情页
**页面对应**：寄卖商品采购下单交互页面UI设计
- **功能描述**：展示寄卖商品详细信息，支持用户下单购买
- **页面布局**：
  - **商品信息区域**：
    - 商品轮播图片
    - 商品名称和描述
    - 寄卖价格（原价/现价）
    - 商品状态（可购买/已售出）
    - 商品规格选择（颜色、尺寸等）
  - **卖家信息区域**：
    - 卖家头像和昵称
    - 卖家信用等级
    - 在线状态
    - 联系卖家按钮
  - **商品详情区域**：
    - 商品详细描述
    - 商品图片展示
    - 商品参数信息
    - 购买须知

#### 2.4.2 下单购买功能
- **购买流程**：
  - 选择商品规格（如有）
  - 确认购买数量
  - 点击"立即购买"按钮
  - 进入订单确认页面
- **订单确认页**：
  - **商品信息确认**：
    - 商品图片、名称、规格
    - 购买数量和单价
    - 小计金额
  - **收货信息**：
    - 收货人姓名和电话
    - 收货地址选择
    - 配送方式选择
  - **支付信息**：
    - 商品金额
    - 运费（如有）
    - 优惠券使用
    - 实付金额
  - **支付方式选择**：
    - 余额支付
    - 微信支付
    - 支付宝支付
    - 银行卡支付

#### 2.4.3 交互功能
- **商品收藏**：收藏感兴趣的商品
- **分享功能**：分享商品给好友
- **客服咨询**：在线咨询商品问题
- **举报功能**：举报违规商品
- **评价查看**：查看其他买家评价

### 2.5 用户中心模块

#### 2.5.1 个人中心页
**页面对应**：用户中心页UI设计
- **功能描述**：用户个人信息和交易管理中心
- **主要功能区域**：
  - **个人信息**：头像、昵称、邀请码
  - **买方功能**：
    - 买方仓库（已购买商品）
    - 交易中订单
    - 已完成订单
  - **卖方功能**：
    - 卖方仓库（寄卖商品管理）
    - 交易中订单
    - 已完成订单
  - **财务管理**：
    - 余额显示
    - 优惠券管理
    - 奖金统计
    - 推广奖金
  - **社交功能**：
    - 邀请好友
    - 我的粉丝

### 2.6 邀请推广模块

#### 2.6.1 邀请好友页面
**页面对应**：邀请好友UI设计
- **功能描述**：用户通过邀请码或二维码邀请好友注册获得奖励
- **页面元素**：
  - **邀请二维码**：
    - 动态生成个人专属二维码
    - 二维码包含用户邀请信息
    - 支持长按保存二维码图片
  - **推荐码显示**：
    - 显示用户专属推荐码（如：xmrkqq）
    - 支持一键复制推荐码
    - 推荐码可用于手动输入邀请
  - **邀请说明**：
    - "扫描二维码进入系统"提示文字
    - 邀请奖励规则说明
    - 邀请成功后的奖励机制

#### 2.6.2 邀请奖励机制
- **邀请奖励**：
  - 成功邀请好友注册奖励
  - 被邀请人首次消费奖励
  - 多级推广奖励体系
- **奖励类型**：
  - 现金奖励
  - 优惠券奖励
  - 积分奖励
  - VIP权益奖励

#### 2.6.3 推广数据统计
- **邀请统计**：
  - 邀请人数统计
  - 成功注册人数
  - 有效消费人数
  - 累计奖励金额
- **推广排行**：
  - 邀请排行榜
  - 奖励排行榜
  - 推广达人认证

### 2.7 优惠券管理模块

#### 2.7.1 优惠券中心页面
**页面对应**：优惠券管理UI设计
- **功能描述**：用户优惠券余额管理和收支明细查看
- **页面布局**：
  - **余额显示区域**：
    - 当前优惠券余额（如：0.000）
    - 余额数字突出显示
    - 实时更新余额信息
  - **操作按钮区域**：
    - 提现按钮（橙色突出显示）
    - 全部优惠券数量显示（如：全部优惠券：0）
  - **明细查看区域**：
    - 收入明细Tab
    - 支出明细Tab
    - 明细列表展示

#### 2.7.2 优惠券收支管理
- **收入明细**：
  - 邀请奖励收入
  - 交易返佣收入
  - 活动奖励收入
  - 签到奖励收入
- **支出明细**：
  - 购买商品使用
  - 提现记录
  - 转赠他人记录
  - 过期失效记录

#### 2.7.3 优惠券使用规则
- **使用条件**：
  - 满减条件设置
  - 商品类别限制
  - 使用时间限制
  - 单次使用限额
- **提现规则**：
  - 最低提现金额
  - 提现手续费率
  - 提现到账时间
  - 提现方式选择

#### 2.7.4 空状态处理
- **无数据状态**：
  - 显示"没有数据哦~"提示
  - 空状态插图展示
  - 引导用户获取优惠券的操作提示

#### 2.5.2 交易状态管理
- **买方交易状态**：
  - 买方仓库：已购买待收货商品
  - 交易中：正在进行的交易
  - 已完成：交易完成的订单
- **卖方交易状态**：
  - 卖方仓库：寄卖中的商品
  - 交易中：已有买家的商品
  - 已完成：交易完成的商品

## 3. 核心业务流程

### 3.1 商品寄卖流程
1. **商品提交**：卖家提交商品信息和图片
2. **平台审核**：管理员审核商品信息
3. **上架展示**：审核通过后商品上架
4. **买家下单**：买家选择商品并下单
5. **交易确认**：双方确认交易详情
6. **商品交付**：通过平台完成商品交付
7. **交易完成**：确认收货后交易完成
8. **资金结算**：扣除手续费后资金到账

### 3.2 采购下单流程
1. **商品浏览**：买家浏览寄卖商品列表
2. **商品详情**：查看商品详细信息
3. **规格选择**：选择商品规格和数量
4. **立即购买**：点击购买按钮
5. **订单确认**：确认商品信息、收货地址、支付方式
6. **支付处理**：选择支付方式完成支付
7. **订单生成**：系统生成订单，资金托管
8. **卖家确认**：卖家确认订单并准备发货
9. **物流配送**：商品发货并提供物流信息
10. **确认收货**：买家确认收货，交易完成
11. **资金结算**：资金释放给卖家，扣除平台手续费

### 3.3 订单状态管理
#### 3.3.1 订单状态流转
- **待支付**：订单已创建，等待买家支付
- **已支付**：买家已支付，等待卖家确认
- **待发货**：卖家已确认，准备发货
- **已发货**：商品已发货，等待买家收货
- **已完成**：买家确认收货，交易完成
- **已取消**：订单被取消（超时未支付/双方协商）
- **退款中**：发生纠纷，正在处理退款
- **已退款**：退款完成

#### 3.3.2 订单操作权限
- **买家操作**：
  - 待支付：支付订单、取消订单
  - 已发货：确认收货、申请退款
  - 已完成：评价商品、申请售后
- **卖家操作**：
  - 已支付：确认订单、拒绝订单
  - 待发货：发货操作、修改订单
  - 已发货：查看物流、处理售后

#### 3.3.3 订单取消确认机制
**页面对应**：订单取消确认UI设计
- **取消确认弹窗**：
  - 弹窗标题："确认取消订单"
  - 确认提示信息："确认要取消这个订单吗？"
  - 操作按钮：
    - "确认"按钮（红色警告色）
    - "取消"按钮（灰色次要色）
- **取消原因选择**：
  - 不想要了
  - 商品信息有误
  - 卖家沟通问题
  - 其他原因（可输入）
- **取消后处理**：
  - 已支付订单：自动退款流程
  - 未支付订单：直接取消
  - 通知卖家订单取消

#### 3.3.4 订单管理页面优化
**页面对应**：订单管理UI设计
- **订单列表展示**：
  - 订单状态标签显示
  - 商品缩略图和基本信息
  - 订单金额和时间
  - 快捷操作按钮
- **订单筛选功能**：
  - 全部订单
  - 待支付
  - 待发货
  - 待收货
  - 已完成
  - 已取消
- **批量操作功能**：
  - 批量取消订单
  - 批量确认收货
  - 批量删除订单

### 3.4 交易保障机制
- **商品审核**：平台审核商品真实性
- **资金托管**：买家资金平台代管
- **纠纷处理**：平台介入纠纷调解
- **信用评价**：交易后双方互评
- **售后保障**：7天无理由退货（特殊商品除外）
- **物流保险**：商品运输保险保障

#### 3.4.1 纠纷处理流程
- **纠纷发起**：
  - 买家/卖家可发起纠纷申请
  - 选择纠纷类型（商品质量、物流问题、服务态度等）
  - 上传相关证据材料
  - 填写纠纷描述
- **纠纷处理**：
  - 系统自动通知对方当事人
  - 双方在线协商沟通
  - 平台客服介入调解
  - 根据证据和规则裁决
- **纠纷结果**：
  - 协商成功：按协商结果执行
  - 平台裁决：按裁决结果执行
  - 退款处理：自动执行退款流程
  - 信用记录：记录纠纷处理结果

#### 3.4.2 售后服务体系
- **售后申请**：
  - 7天无理由退货
  - 商品质量问题退换
  - 物流损坏赔偿
  - 服务不满意投诉
- **售后处理**：
  - 在线客服支持
  - 专业售后团队
  - 快速响应机制
  - 满意度回访


## 核心业务流程

### 1. 用户注册登录流程

```
访问网站
  ↓
注册/登录 (/pages/sub-pages/login/index)
  ↓
发送验证码 (POST /api/sms/send)
  ↓
注册/登录 (POST /api/user/register | POST /api/user/login)
  ↓
获取Token
  ↓
进入首页 (/pages/index/index)
```

### 2. 抢购交易流程

```
首页浏览 (/pages/index/index)
  ↓
进入抢购 (/pages/rushing/index)
  ↓
查看可购买商品 (GET /api/order/goods)
- **采购列表页面交互流程**
  - 选择“等待采购”的寄卖商品
  - 提示“是否采购“
  - 点击“确定”按钮提交抢单
  ↓
抢单 (POST /api/order/buy)
  ↓
选择地址 (/pages/sub-pages/address/index)
  ↓
支付订单 (POST /api/order/pay)
  ↓
卖家确认发货 (POST /api/order/confirm)
  ↓
订单完成
  ↓
分红到账
```


## 4. 技术实现要求

### 4.1 前端技术栈
- **框架**：基于现有uniapp项目
- **UI组件**：复用现有组件库
- **状态管理**：Vuex状态管理
- **路由管理**：uni-app路由系统

### 4.2 后端接口需求
- 参考后端API文档

### 4.3 数据库设计要点
- **用户表扩展**：增加寄卖相关字段
  - 信用等级、交易次数、好评率
  - 邀请码、推广奖金
- **商品寄卖表**：存储寄卖商品信息
  - 商品基本信息、图片、价格
  - 寄卖状态、审核状态
  - 卖家信息、上架时间
- **交易订单表**：记录寄卖交易订单
  - 订单基本信息、商品信息
  - 买卖双方信息、交易状态
  - 支付信息、物流信息
- **财务记录表**：记录资金流水
  - 交易金额、手续费、实际到账
  - 资金类型、交易时间
- **收货地址表**：用户收货地址管理
  - 收货人信息、详细地址
  - 默认地址标识
- **商品评价表**：交易后评价记录
  - 评价内容、评分、图片
  - 评价时间、回复内容

### 4.4 UI设计规范
#### 4.4.1 色彩规范
- **主色调**：沿用现有项目主题色
- **辅助色**：
  - 成功状态：#52c41a（绿色）
  - 警告状态：#faad14（橙色）
  - 错误状态：#f5222d（红色）
  - 信息提示：#1890ff（蓝色）

#### 4.4.2 字体规范
- **标题字体**：16px-20px，加粗
- **正文字体**：14px，常规
- **辅助文字**：12px，浅色
- **价格数字**：16px-18px，加粗，突出显示

#### 4.4.3 间距规范
- **页面边距**：左右各16px
- **组件间距**：12px-16px
- **内容间距**：8px-12px
- **按钮高度**：44px-48px

#### 4.4.4 图标规范
- **统一图标库**：使用uni-app内置图标或自定义SVG
- **图标尺寸**：16px、20px、24px三种规格
- **图标颜色**：与文字颜色保持一致