huang
623a622298
Some checks failed
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Has been cancelled
F-1: 佣金链断裂时创建 status=99 零额待审记录，新增修正接口 POST /commission-records/:id/resolve F-4: C端订单查询从 Handler 迁移至 Service 层，移除 SkipPermissionCtx J-1: 富友支付 JSAPI/MiniApp 预下单实现，回调补全签名验证 J-2: 平台钱包代购支持（buyerType 为空时使用资产所属代理钱包） J-3: 套餐激活后自动更新卡/设备 status=3，最后套餐过期后更新 status=4 支付抽象: 引入 PaymentProvider 接口 + 微信/富友适配器，CreateOrder 支持多支付渠道 修复: 设备/IoT卡响应 DTO 移除 omitempty，空值字段返回 null 而非省略
83 lines
5.3 KiB
Go
83 lines
5.3 KiB
Go
package dto
|
||
|
||
// CommissionRecordResponse 佣金记录响应
|
||
type CommissionRecordResponse struct {
|
||
ID uint `json:"id" description:"佣金记录ID"`
|
||
ShopID uint `json:"shop_id" description:"店铺ID"`
|
||
ShopName string `json:"shop_name" description:"店铺名称"`
|
||
OrderID uint `json:"order_id" description:"订单ID"`
|
||
OrderNo string `json:"order_no" description:"订单号"`
|
||
IotCardID *uint `json:"iot_card_id" description:"关联卡ID"`
|
||
IotCardICCID string `json:"iot_card_iccid" description:"卡ICCID"`
|
||
DeviceID *uint `json:"device_id" description:"关联设备ID"`
|
||
VirtualNo string `json:"virtual_no" description:"设备虚拟号"`
|
||
CommissionSource string `json:"commission_source" description:"佣金来源 (cost_diff:成本价差, one_time:一次性佣金)"`
|
||
Amount int64 `json:"amount" description:"佣金金额（分）"`
|
||
BalanceAfter int64 `json:"balance_after" description:"入账后钱包余额（分）"`
|
||
Status int `json:"status" description:"状态 (1:已入账, 2:已失效, 99:待人工修正)"`
|
||
ReleasedAt string `json:"released_at" description:"入账时间"`
|
||
Remark string `json:"remark" description:"备注"`
|
||
CreatedAt string `json:"created_at" description:"创建时间"`
|
||
}
|
||
|
||
// CommissionRecordListRequest 佣金记录列表请求
|
||
type CommissionRecordListRequest struct {
|
||
Page int `json:"page" query:"page" validate:"omitempty,min=1" minimum:"1" description:"页码"`
|
||
PageSize int `json:"page_size" query:"page_size" validate:"omitempty,min=1,max=100" minimum:"1" maximum:"100" description:"每页数量"`
|
||
ShopID *uint `json:"shop_id" query:"shop_id" validate:"omitempty" description:"店铺ID"`
|
||
CommissionSource *string `json:"commission_source" query:"commission_source" validate:"omitempty,oneof=cost_diff one_time" description:"佣金来源 (cost_diff:成本价差, one_time:一次性佣金)"`
|
||
StartTime *string `json:"start_time" query:"start_time" validate:"omitempty" description:"开始时间"`
|
||
EndTime *string `json:"end_time" query:"end_time" validate:"omitempty" description:"结束时间"`
|
||
Status *int `json:"status" query:"status" validate:"omitempty,oneof=1 2 99" description:"状态 (1:已入账, 2:已失效, 99:待人工修正)"`
|
||
}
|
||
|
||
// CommissionRecordPageResult 佣金记录分页结果
|
||
type CommissionRecordPageResult struct {
|
||
List []*CommissionRecordResponse `json:"list" description:"佣金记录列表"`
|
||
Total int64 `json:"total" description:"总数"`
|
||
Page int `json:"page" description:"当前页"`
|
||
PageSize int `json:"page_size" description:"每页数量"`
|
||
TotalPages int `json:"total_pages" description:"总页数"`
|
||
}
|
||
|
||
// CommissionStatsResponse 佣金统计响应
|
||
type CommissionStatsResponse struct {
|
||
TotalAmount int64 `json:"total_amount" description:"总收入（分）"`
|
||
CostDiffAmount int64 `json:"cost_diff_amount" description:"成本价差收入（分）"`
|
||
OneTimeAmount int64 `json:"one_time_amount" description:"一次性佣金收入（分）"`
|
||
CostDiffPercent int64 `json:"cost_diff_percent" description:"成本价差占比（千分比）"`
|
||
OneTimePercent int64 `json:"one_time_percent" description:"一次性佣金占比（千分比）"`
|
||
TotalCount int64 `json:"total_count" description:"总笔数"`
|
||
CostDiffCount int64 `json:"cost_diff_count" description:"成本价差笔数"`
|
||
OneTimeCount int64 `json:"one_time_count" description:"一次性佣金笔数"`
|
||
}
|
||
|
||
// DailyCommissionStatsResponse 每日佣金统计响应
|
||
type DailyCommissionStatsResponse struct {
|
||
Date string `json:"date" description:"日期（YYYY-MM-DD）"`
|
||
TotalAmount int64 `json:"total_amount" description:"当日总收入（分）"`
|
||
TotalCount int64 `json:"total_count" description:"当日总笔数"`
|
||
}
|
||
|
||
// CommissionStatsRequest 佣金统计请求
|
||
type CommissionStatsRequest struct {
|
||
ShopID *uint `json:"shop_id" query:"shop_id" validate:"omitempty" description:"店铺ID"`
|
||
StartTime *string `json:"start_time" query:"start_time" validate:"omitempty" description:"开始时间"`
|
||
EndTime *string `json:"end_time" query:"end_time" validate:"omitempty" description:"结束时间"`
|
||
}
|
||
|
||
// DailyCommissionStatsRequest 每日佣金统计请求
|
||
type DailyCommissionStatsRequest struct {
|
||
ShopID *uint `json:"shop_id" query:"shop_id" validate:"omitempty" description:"店铺ID"`
|
||
StartDate *string `json:"start_date" query:"start_date" validate:"omitempty" description:"开始日期（YYYY-MM-DD）"`
|
||
EndDate *string `json:"end_date" query:"end_date" validate:"omitempty" description:"结束日期（YYYY-MM-DD）"`
|
||
Days *int `json:"days" query:"days" validate:"omitempty,min=1,max=365" minimum:"1" maximum:"365" description:"查询天数（默认30天）"`
|
||
}
|
||
|
||
// CommissionRecordResolveRequest 佣金记录修正请求
|
||
type CommissionRecordResolveRequest struct {
|
||
Action string `json:"action" validate:"required,oneof=release invalidate" required:"true" description:"操作 (release:入账, invalidate:作废)"`
|
||
Amount *int64 `json:"amount" validate:"omitempty,min=1" minimum:"1" description:"佣金金额（分），release 时必填"`
|
||
Remark string `json:"remark" validate:"omitempty,max=500" maxLength:"500" description:"处理备注"`
|
||
}
|