tyapi-server/可开票金额计算逻辑更新说明.md

# 可开票金额计算逻辑更新说明

## 更新概述

本次更新修改了可开票金额的计算逻辑，从原来的"总充值金额 - 总赠送金额"改为"支付宝充值金额 + 对公转账金额"。

## 修改内容

### 1. 计算逻辑变更

**原逻辑：**
```
可开票金额 = 总充值金额 - 总赠送金额 - 已开票金额 - 待处理申请金额
```

**新逻辑：**
```
可开票金额 = 真实充值金额（支付宝充值 + 对公转账） - 已开票金额 - 待处理申请金额
```

### 2. 代码修改位置

#### 文件：`internal/application/finance/invoice_application_service.go`

**方法：`getAmountSummary`**
- 修改了充值金额的计算逻辑
- 只统计 `RechargeTypeAlipay`（支付宝充值）和 `RechargeTypeTransfer`（对公转账）的金额
- 赠送金额（`RechargeTypeGift`）不再计入可开票金额

**方法：`calculateAvailableAmount`**
- 更新了注释和变量名
- 移除了对赠送金额的扣除逻辑
- 直接使用真实充值金额进行计算

**方法：`GetAvailableAmount`**
- 更新了响应DTO中的 `TotalRecharged` 字段
- 现在返回的是真实充值金额（支付宝充值+对公转账）

### 3. 充值类型说明

根据 `internal/domains/finance/entities/recharge_record.go` 中的定义：

```go
const (
    RechargeTypeAlipay   RechargeType = "alipay"   // 支付宝充值
    RechargeTypeTransfer RechargeType = "transfer" // 对公转账
    RechargeTypeGift     RechargeType = "gift"     // 赠送
)
```

**计入可开票金额的类型：**
- `alipay` - 支付宝充值
- `transfer` - 对公转账

**不计入可开票金额的类型：**
- `gift` - 赠送金额

### 4. 影响范围

#### 后端影响
- 可开票金额计算逻辑变更
- 前端显示的"总充值"字段现在显示的是真实充值金额
- 赠送金额不再影响可开票金额

#### 前端影响
- 用户端发票页面显示的"总充值"金额会发生变化
- 可开票金额的计算结果会发生变化
- 赠送金额不再从可开票金额中扣除

### 5. 业务逻辑

**为什么这样修改？**
1. **合规性**：只有真实的充值金额才能开具发票
2. **准确性**：赠送金额不应该计入可开票金额
3. **清晰性**：明确区分真实充值和赠送金额

**计算示例：**
```
用户充值记录：
- 支付宝充值：1000元
- 对公转账：500元
- 赠送金额：200元

原逻辑可开票金额：1000 + 500 + 200 - 200 = 1500元
新逻辑可开票金额：1000 + 500 = 1500元

结果相同，但逻辑更清晰
```

### 6. 注意事项

1. **历史数据**：此修改会影响所有用户的可开票金额计算
2. **前端显示**：前端显示的"总充值"字段含义发生变化
3. **业务验证**：需要验证新的计算逻辑是否符合业务需求
4. **测试建议**：建议在测试环境充分验证后再部署到生产环境

## 部署建议

1. 在测试环境验证新的计算逻辑
2. 确认前端显示正确
3. 通知相关业务人员了解变更
4. 监控生产环境的可开票金额计算