285 lines
6.0 KiB
Markdown
285 lines
6.0 KiB
Markdown
# 🚀 第一阶段：核心支付流程实施方案
|
||
|
||
**实施日期**: 2026-01-23
|
||
**实施目标**: 打通支付闭环，确保业务可运转
|
||
**预计工期**: 1-2周
|
||
|
||
---
|
||
|
||
## 📋 实施范围
|
||
|
||
本阶段将实施以下5个核心功能：
|
||
|
||
1. **钱包支付功能** - 订单支付时支持钱包余额
|
||
2. **次卡支付功能** - 订单支付时支持次卡
|
||
3. **套餐支付功能** - 订单支付时支持套餐课时
|
||
4. **优惠券使用功能** - 订单支付时支持优惠券
|
||
5. **地址关联功能** - 订单关联服务地址
|
||
|
||
---
|
||
|
||
## 🎯 核心目标
|
||
|
||
### 业务目标
|
||
- 家长可以使用多种支付方式下单
|
||
- 订单完成后自动结算陪伴员收益
|
||
- 管理师自动获得提成
|
||
- 陪伴员可以查看服务地址
|
||
|
||
### 技术目标
|
||
- 完善订单支付流程
|
||
- 实现资金流转闭环
|
||
- 建立完整的数据关联
|
||
- 确保数据一致性
|
||
|
||
---
|
||
|
||
## 📊 实施步骤
|
||
|
||
### 步骤1: 数据库设计与扩展
|
||
- 扩展 `order` 表，添加支付相关字段
|
||
- 检查并完善相关表结构
|
||
- 创建必要的索引
|
||
|
||
### 步骤2: 后端接口实现
|
||
- 实现订单支付接口
|
||
- 实现资金结算接口
|
||
- 实现地址关联接口
|
||
|
||
### 步骤3: 前端页面实现
|
||
- 实现支付方式选择页面
|
||
- 实现优惠券选择页面
|
||
- 实现地址选择页面
|
||
|
||
### 步骤4: 测试与验证
|
||
- 单元测试
|
||
- 集成测试
|
||
- 端到端测试
|
||
|
||
---
|
||
|
||
## 🗂️ 文档结构
|
||
|
||
```
|
||
docs/fixes/2026-01-23-核心支付流程实施/
|
||
├── README.md # 总体方案（本文件）
|
||
├── 📋数据库设计.md # 数据库表结构设计
|
||
├── 📋业务流程设计.md # 业务流程详细设计
|
||
├── 🔧1-钱包支付功能实施.md # 钱包支付详细实施
|
||
├── 🔧2-次卡支付功能实施.md # 次卡支付详细实施
|
||
├── 🔧3-套餐支付功能实施.md # 套餐支付详细实施
|
||
├── 🔧4-优惠券使用功能实施.md # 优惠券使用详细实施
|
||
├── 🔧5-地址关联功能实施.md # 地址关联详细实施
|
||
├── 🧪测试指南.md # 测试用例和测试方法
|
||
└── ✅实施完成报告.md # 实施完成后的总结报告
|
||
```
|
||
|
||
---
|
||
|
||
## 🔄 业务流程概览
|
||
|
||
### 订单支付流程
|
||
|
||
```
|
||
家长下单
|
||
↓
|
||
选择支付方式
|
||
├─ 钱包余额支付
|
||
├─ 次卡支付
|
||
├─ 套餐课时支付
|
||
├─ 微信支付
|
||
└─ 组合支付（钱包+微信）
|
||
↓
|
||
选择优惠券（可选）
|
||
↓
|
||
选择服务地址
|
||
↓
|
||
确认订单
|
||
↓
|
||
支付成功
|
||
↓
|
||
订单状态：待派单
|
||
```
|
||
|
||
### 订单完成后结算流程
|
||
|
||
```
|
||
订单完成
|
||
↓
|
||
自动结算
|
||
├─ 扣减次卡/套餐次数
|
||
├─ 计算陪伴员收益
|
||
├─ 计算管理师提成
|
||
└─ 更新钱包余额
|
||
↓
|
||
生成结算记录
|
||
↓
|
||
发送通知
|
||
```
|
||
|
||
---
|
||
|
||
## 📐 数据库表关系
|
||
|
||
### 核心表
|
||
|
||
1. **order** - 订单表
|
||
- 关联 user_address (服务地址)
|
||
- 关联 user_coupon (优惠券)
|
||
- 关联 time_card (次卡)
|
||
- 关联 package (套餐)
|
||
|
||
2. **wallet_transaction** - 钱包交易记录
|
||
- 关联 order (订单)
|
||
- 关联 user (用户)
|
||
|
||
3. **teacher_salary** - 陪伴员收益
|
||
- 关联 order (订单)
|
||
- 关联 teacher (陪伴员)
|
||
|
||
4. **manager_commission** - 管理师提成（需创建）
|
||
- 关联 order (订单)
|
||
- 关联 manager (管理师)
|
||
|
||
---
|
||
|
||
## 🔑 关键技术点
|
||
|
||
### 1. 支付方式优先级
|
||
|
||
```
|
||
优惠券折扣 → 次卡/套餐 → 钱包余额 → 微信支付
|
||
```
|
||
|
||
### 2. 金额计算逻辑
|
||
|
||
```java
|
||
// 订单金额计算
|
||
原价 = 服务单价 × 服务时长
|
||
优惠券折扣 = 原价 × 优惠券折扣率
|
||
实付金额 = 原价 - 优惠券折扣
|
||
```
|
||
|
||
### 3. 资金结算逻辑
|
||
|
||
```java
|
||
// 陪伴员收益计算
|
||
陪伴员收益 = 实付金额 × 陪伴员分成比例
|
||
|
||
// 管理师提成计算
|
||
管理师提成 = 实付金额 × 管理师提成比例
|
||
|
||
// 平台收益
|
||
平台收益 = 实付金额 - 陪伴员收益 - 管理师提成
|
||
```
|
||
|
||
### 4. 事务处理
|
||
|
||
所有支付和结算操作必须在事务中完成，确保数据一致性：
|
||
|
||
```java
|
||
@Transactional(rollbackFor = Exception.class)
|
||
public void processPayment(Order order) {
|
||
// 1. 扣减支付方式（钱包/次卡/套餐）
|
||
// 2. 更新订单状态
|
||
// 3. 生成交易记录
|
||
// 4. 发送通知
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## ⚠️ 注意事项
|
||
|
||
### 1. 数据一致性
|
||
- 所有支付操作必须使用事务
|
||
- 失败时必须回滚
|
||
- 记录详细的操作日志
|
||
|
||
### 2. 并发控制
|
||
- 钱包余额扣减使用乐观锁
|
||
- 次卡/套餐次数扣减使用乐观锁
|
||
- 防止重复支付
|
||
|
||
### 3. 安全性
|
||
- 支付金额必须在后端计算
|
||
- 前端传递的金额仅供显示
|
||
- 验证用户权限
|
||
|
||
### 4. 用户体验
|
||
- 支付失败时给出明确提示
|
||
- 余额不足时提示充值
|
||
- 次卡/套餐用完时提示购买
|
||
|
||
---
|
||
|
||
## 📅 实施计划
|
||
|
||
### Week 1: 数据库和后端
|
||
|
||
**Day 1-2**: 数据库设计与扩展
|
||
- 设计表结构
|
||
- 编写 SQL 脚本
|
||
- 执行数据库变更
|
||
|
||
**Day 3-4**: 后端接口实现
|
||
- 实现支付接口
|
||
- 实现结算接口
|
||
- 单元测试
|
||
|
||
**Day 5**: 后端集成测试
|
||
- 测试支付流程
|
||
- 测试结算流程
|
||
- 修复 bug
|
||
|
||
### Week 2: 前端和测试
|
||
|
||
**Day 1-2**: 前端页面实现
|
||
- 支付方式选择页面
|
||
- 优惠券选择页面
|
||
- 地址选择页面
|
||
|
||
**Day 3-4**: 前后端联调
|
||
- 接口对接
|
||
- 流程测试
|
||
- 修复 bug
|
||
|
||
**Day 5**: 端到端测试
|
||
- 完整流程测试
|
||
- 性能测试
|
||
- 用户验收测试
|
||
|
||
---
|
||
|
||
## 🎯 成功标准
|
||
|
||
### 功能完整性
|
||
- ✅ 支持5种支付方式
|
||
- ✅ 支持优惠券使用
|
||
- ✅ 支持地址选择
|
||
- ✅ 自动结算收益
|
||
|
||
### 数据准确性
|
||
- ✅ 金额计算正确
|
||
- ✅ 余额扣减正确
|
||
- ✅ 次数扣减正确
|
||
- ✅ 收益计算正确
|
||
|
||
### 用户体验
|
||
- ✅ 支付流程顺畅
|
||
- ✅ 错误提示清晰
|
||
- ✅ 响应速度快
|
||
- ✅ 界面友好
|
||
|
||
---
|
||
|
||
## 📞 联系方式
|
||
|
||
如有问题，请联系：
|
||
- 技术负责人：Kiro AI Assistant
|
||
- 实施日期：2026-01-23
|
||
|
||
---
|
||
|
||
**下一步**: 查看 `📋数据库设计.md` 了解详细的数据库设计方案
|