ycc-proxy-server/deploy/sql/利润统计API成本计入说明.md

# 利润统计API成本计入说明

## 修改内容

在后台统计面板的利润统计部分，将API调用成本计入成本计算中。

## 修改位置

文件：`ycc-proxy-server/app/main/api/internal/logic/admin_dashboard/admingetdashboardstatisticslogic.go`

方法：`calculateProfitStatistics`

## 修改详情

### 1. 今日利润计算

**修改前：**
```go
// 今日利润 = 营收 - 佣金 - 返利 - 税务成本 + 提现收税
stats.TodayProfit = todayRevenue - todayCommission - todayRebate - todayCompanyTax + todayTaxIncome
```

**修改后：**
```go
// 今日API调用成本
todayApiCost := 0.0
if l.svcCtx.TianyuanapiCallLogService != nil {
    todayApiStats, err := l.svcCtx.TianyuanapiCallLogService.GetStatistics(l.ctx, service.StatisticsFilter{
        StartDate: todayStart,
        EndDate:   todayEnd,
    })
    if err != nil {
        logx.Errorf("获取今日API调用成本失败: %v", err)
    } else {
        todayApiCost = todayApiStats.TotalCost
    }
}
// 今日利润 = 营收 - 佣金 - 返利 - 税务成本 - API调用成本 + 提现收税
stats.TodayProfit = todayRevenue - todayCommission - todayRebate - todayCompanyTax - todayApiCost + todayTaxIncome
```

### 2. 当月利润计算

**修改前：**
```go
// 当月利润
stats.MonthProfit = monthRevenue - monthCommission - monthRebate - monthCompanyTax + monthTaxIncome
```

**修改后：**
```go
// 当月API调用成本
monthApiCost := 0.0
if l.svcCtx.TianyuanapiCallLogService != nil {
    monthApiStats, err := l.svcCtx.TianyuanapiCallLogService.GetStatistics(l.ctx, service.StatisticsFilter{
        StartDate: monthStart,
        EndDate:   monthEnd,
    })
    if err != nil {
        logx.Errorf("获取当月API调用成本失败: %v", err)
    } else {
        monthApiCost = monthApiStats.TotalCost
    }
}
// 当月利润
stats.MonthProfit = monthRevenue - monthCommission - monthRebate - monthCompanyTax - monthApiCost + monthTaxIncome
```

### 3. 总利润计算

**修改前：**
```go
// 总利润
stats.TotalProfit = totalRevenue - totalCommission - totalRebate - totalCompanyTax + totalTaxIncome
```

**修改后：**
```go
// 总API调用成本
totalApiCost := 0.0
if l.svcCtx.TianyuanapiCallLogService != nil {
    totalApiStats, err := l.svcCtx.TianyuanapiCallLogService.GetStatistics(l.ctx, service.StatisticsFilter{})
    if err != nil {
        logx.Errorf("获取总API调用成本失败: %v", err)
    } else {
        totalApiCost = totalApiStats.TotalCost
    }
}
// 总利润
stats.TotalProfit = totalRevenue - totalCommission - totalRebate - totalCompanyTax - totalApiCost + totalTaxIncome
```

## 利润计算公式

修改后的利润计算公式为：

```
利润 = 营收 - 佣金 - 返利 - 税务成本 - API调用成本 + 提现收税
```

其中：
- **营收**：订单金额总和（status = 'paid'）
- **佣金**：代理佣金总和（status != 3）
- **返利**：代理返利总和（status != 3）
- **税务成本**：订单金额的 6%
- **API调用成本**：天元API成功调用的成本总和（从 `tianyuanapi_call_log` 表统计）
- **提现收税**：代理提现税总和（tax_status = 2）

## API调用成本统计说明

API调用成本通过 `TianyuanapiCallLogService.GetStatistics` 方法获取：

1. **今日API调用成本**：统计 `call_time >= todayStart AND call_time < todayEnd` 的成功调用成本
2. **当月API调用成本**：统计 `call_time >= monthStart AND call_time < monthEnd` 的成功调用成本
3. **总API调用成本**：统计所有成功调用的成本

**注意**：只有成功调用（`call_status = 1`）才会计入成本，失败调用不计成本。

## 错误处理

如果获取API调用成本失败，会记录错误日志，但不会影响利润计算（API成本默认为0），确保统计功能的稳定性。

## 依赖项

- `TianyuanapiCallLogService`：需要在 `servicecontext.go` 中初始化
- `tianyuanapi_call_log` 表：需要已创建并包含调用记录数据

## 验证

修改完成后，可以通过以下方式验证：

1. 查看后台统计面板的利润统计数据
2. 检查日志，确认API调用成本是否正确获取
3. 对比修改前后的利润数据，确认API成本已正确计入