128 lines
4.5 KiB
Markdown
128 lines
4.5 KiB
Markdown
# Release Notes
|
||
|
||
## 2026-03-29 - 场馆入场计费逻辑重构
|
||
|
||
### 一、按时计费流程
|
||
|
||
```
|
||
入场 join()
|
||
├─ price = basePrice × 2 (2小时押金)
|
||
├─ 返回 flg=2, 等待支付
|
||
└─ 支付成功 → paySuccess()
|
||
└─ 创建订单 (orderSn=原始订单号, paying=0)
|
||
|
||
出场 out()
|
||
├─ actualCost = (minutes / 60) × basePrice (保留2位小数)
|
||
├─ deposit = basePrice × 2
|
||
├─ difference = actualCost - deposit
|
||
│
|
||
├─ difference > 0 (需补费)
|
||
│ └─ 返回 flg=2, 等待支付
|
||
│ └─ 支付成功 → paySuccess(enterFlag=OUT)
|
||
│ └─ 设置 orderAddSn=补费订单号, paying=2
|
||
│
|
||
├─ difference < 0 (需退款)
|
||
│ └─ payMoney = |difference| (BigDecimal, 2位小数)
|
||
│ └─ paying=1, status=USED
|
||
│ └─ 用户可立即重新入场
|
||
│ └─ 批处理退款
|
||
│
|
||
└─ difference = 0 (刚好)
|
||
└─ paying=2, status=USED
|
||
|
||
批处理 refundOrder()
|
||
├─ 扫描 paying=1 的订单
|
||
├─ 如果 orderAddSn 存在 → 跳过（补费订单）
|
||
├─ 如果 orderAddSn 不存在 → 退款
|
||
└─ 调用微信退款接口 (元转分)
|
||
```
|
||
|
||
### 二、按次计费流程
|
||
|
||
```
|
||
入场 join()
|
||
├─ price = basePrice (单次费用)
|
||
├─ 返回 flg=2, 等待支付
|
||
└─ 支付成功 → paySuccess()
|
||
└─ 创建订单 (orderSn=原始订单号, paying=0, 有效期=timePayHour)
|
||
|
||
出场 out()
|
||
└─ paying=1, 10分钟宽限期
|
||
|
||
重新入场 join()
|
||
├─ 如果 paying=1 且按次计费 → 重置 paying=0
|
||
└─ 否则 → 已在场内
|
||
|
||
批处理 refundOrder()
|
||
├─ 扫描 paying=1 的订单
|
||
├─ 按次计费: 10分钟后关闭订单
|
||
└─ 按时计费: 立即退款（如果无补费记录）
|
||
|
||
批处理 execute()
|
||
└─ order_end < now → 关闭订单
|
||
```
|
||
|
||
### 三、管理员手动退费
|
||
|
||
```
|
||
enterOrderAccount(enterId, payMoney)
|
||
├─ 检查: paying != 1 (不能重复结算)
|
||
├─ 检查: orderAddSn 为空 (不能退补费订单)
|
||
├─ 检查: 退款金额 <= 原订单金额
|
||
└─ 设置 paying=1, payMoney=指定金额
|
||
└─ 等待批处理处理
|
||
```
|
||
|
||
### 四、金额类型规范
|
||
|
||
| 位置 | 类型 | 精度 | 说明 |
|
||
|---|---|---|---|
|
||
| 数据库 pay_money | DECIMAL(10,2) | 2位小数 | |
|
||
| 数据库 sum_pay_money | DECIMAL(10,2) | 2位小数 | |
|
||
| 实体 BarcodeOrderTime.payMoney | BigDecimal | 2位小数 | |
|
||
| 实体 BarcodeOrderTime.sumPayMoney | BigDecimal | 2位小数 | |
|
||
| 微信支付接口 | Integer | 分 | 元×100 |
|
||
| 微信退款接口 | Integer | 分 | 元×100 |
|
||
|
||
### 五、关键表字段变动
|
||
|
||
| 场景 | sv_barcode_order_time | sv_member_refund | sv_member_money_log |
|
||
|---|---|---|---|
|
||
| 入场支付成功 | order_sn=A, paying=0 | - | type=JOIN |
|
||
| 出场需退款 | paying=1, payMoney=退款额 | - | - |
|
||
| 批处理退款 | paying=0, status=USED | money=退款额 | type=REFUND |
|
||
| 出场需补费 | paying=1, payMoney=-1 | - | - |
|
||
| 补费支付成功 | order_add_sn=B, paying=2 | - | type=JOIN |
|
||
| 管理员退费 | paying=1, payMoney=指定额 | - | - |
|
||
|
||
### 六、已修复的问题
|
||
|
||
| 问题 | 修复 |
|
||
|---|---|
|
||
| payMoney 类型 | Integer → BigDecimal |
|
||
| sumPayMoney 类型 | Integer → BigDecimal |
|
||
| XML 映射 | jdbcType INTEGER → DECIMAL |
|
||
| 金额比较 | \> 0 → compareTo(ZERO) > 0 |
|
||
| 金额计算 | int 加法 → BigDecimal.add() |
|
||
| 退款金额精度 | intValue() → setScale(2) |
|
||
| 退款金额单位混乱 | 统一为元，微信接口转分 |
|
||
| 补费订单退款 | 跳过不处理 |
|
||
| 管理员退费限制 | 有补费记录时拒绝 |
|
||
| 8小时兜底逻辑 | 删除（冗余） |
|
||
| 10分钟宽限期 | 只给按次计费 |
|
||
| 出场退款后无法立即入场 | 设置 status=USED，允许立即重新入场 |
|
||
|
||
### 七、修改文件清单
|
||
|
||
| 文件 | 修改内容 |
|
||
|---|---|
|
||
| `BarcodeOrderTime.java` | payMoney, sumPayMoney: Integer → BigDecimal |
|
||
| `BarcodeOrderTimeMapper.xml` | jdbcType: INTEGER → DECIMAL |
|
||
| `VenueEnterService.java` | 重写 out() 按分钟计费；setPayMoney() 参数改为 BigDecimal |
|
||
| `OrderService.java` | setPayMoney(-1) → setPayMoney(new BigDecimal(-1)) |
|
||
| `MemberRefundService.java` | sumPayMoney 计算改为 BigDecimal.add() |
|
||
| `BarcodeTimeOrderTask.java` | 删除8小时兜底；getPayMoney() 比较改为 compareTo() |
|
||
| `ServerMessageHandlerAdapter.java` | getPayMoney() 比较改为 compareTo() |
|
||
| `MemberEnterVeneuLogController.java` | payMoney 参数改为 BigDecimal |
|
||
| `WechatPayService.java` | refundInputMoney() 方法签名改为接收原订单金额和退款金额 |
|