break
1aa4eacee2
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 9m26s
用 PRD 2.14 语义整体替换退款佣金「整单全额失效」实现：原佣金保持已发放不变， 回溯事实落在新表 tb_commission_clawback_record 的负数、不可提现明细上。 - 新增成对迁移 000220 建 tb_commission_clawback_record，唯一约束 (refund_id, original_commission_id) 为权威幂等键，附店铺+时间/原佣金/订单索引。 - 回溯用例（internal/service/refund/clawback.go）：准入仅由退款申请状态、审批异常 标记与退款方式决定；金额按分整数计算，分母取冻结实收（缺失回落审批尝试）、 分子原路取渠道成功金额，乘法用 math/big 中间量，舍入差自末条起向前补差； 终态判据要求订单佣金已离开待计算且不存在 status IN (1,2,99) 的记录。 - 三层幂等：唯一约束兜底、佣金行行锁 + 钱包乐观锁、commission_deducted 仅作投影 并带 WHERE commission_deducted = false 条件置位；闭合三结果为已回溯、无需回溯、 审批异常转人工。 - 事务内顺序固定：锁提现申请行 → 锁尝试行 → 解冻冻结 → 置驳回 → 插回溯明细 → 扣 balance（允许为负）→ 写负数流水 → 审计；删除旧全额失效写入与其两个审计调用点， refund.invalidate_commission 仅保留常量与注册供历史审计读取。 - 读侧：佣金明细列表 status 筛选透传，两表 UNION ALL 合并分页并以 source ASC 作 末位次序键；新增佣金明细详情接口并同步路由与 OpenAPI 装配。 - 导出：新增 commission_record 场景（白名单、exporter 注册、DTO oneof、DataSource 与列定义），粒度为佣金记录，原佣金与回溯各一行，金额保持分且可为负。 - 新增退款佣金回溯周期补偿任务（@every 1m / MaxRetry(3) / Timeout(10m) / Unique(10m)，独立队列），保留启动时补偿扫描，判据与既有实现一致。 Refs: AUG26-012
97 lines
6.7 KiB
Go
97 lines
6.7 KiB
Go
package dto
|
||
|
||
import "time"
|
||
|
||
// CreateExportTaskRequest 创建导出任务请求。
|
||
type CreateExportTaskRequest struct {
|
||
Scene string `json:"scene" validate:"required,oneof=device iot_card order package agent_wallet_transaction agent_recharge refund exchange commission_record" required:"true" description:"导出场景 (device:设备, iot_card:IoT卡, order:订单, package:套餐, agent_wallet_transaction:代理主钱包流水, agent_recharge:代理充值, refund:退款, exchange:换货, commission_record:佣金明细)"`
|
||
Format string `json:"format" validate:"required,oneof=xlsx csv" required:"true" description:"导出格式 (xlsx:Excel, csv:CSV)"`
|
||
Query map[string]interface{} `json:"query,omitempty" description:"导出筛选参数(JSON对象，可选)"`
|
||
}
|
||
|
||
// CreateExportTaskResponse 创建导出任务响应。
|
||
type CreateExportTaskResponse struct {
|
||
TaskID uint `json:"task_id" description:"导出任务ID"`
|
||
TaskNo string `json:"task_no" description:"任务编号"`
|
||
Status int `json:"status" description:"任务状态 (1:待处理, 2:处理中, 3:已完成, 4:已失败, 5:已取消)"`
|
||
StatusName string `json:"status_name" description:"任务状态名称（中文）"`
|
||
Message string `json:"message" description:"提示信息"`
|
||
}
|
||
|
||
// ListExportTaskRequest 导出任务列表请求。
|
||
type ListExportTaskRequest 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:"每页数量"`
|
||
Scene string `json:"scene" query:"scene" validate:"omitempty,oneof=device iot_card order package agent_wallet_transaction agent_recharge refund exchange commission_record" description:"导出场景 (device:设备, iot_card:IoT卡, order:订单, package:套餐, agent_wallet_transaction:代理主钱包流水, agent_recharge:代理充值, refund:退款, exchange:换货, commission_record:佣金明细)"`
|
||
Status *int `json:"status" query:"status" validate:"omitempty,min=1,max=5" minimum:"1" maximum:"5" description:"任务状态 (1:待处理, 2:处理中, 3:已完成, 4:已失败, 5:已取消)"`
|
||
StartTime *time.Time `json:"start_time" query:"start_time" description:"创建时间起始"`
|
||
EndTime *time.Time `json:"end_time" query:"end_time" description:"创建时间结束"`
|
||
}
|
||
|
||
// ExportTaskItem 导出任务列表项。
|
||
type ExportTaskItem struct {
|
||
ID uint `json:"id" description:"任务ID"`
|
||
TaskID uint `json:"task_id" description:"任务ID"`
|
||
TaskNo string `json:"task_no" description:"任务编号"`
|
||
Scene string `json:"scene" description:"导出场景 (device:设备, iot_card:IoT卡, order:订单, package:套餐, agent_wallet_transaction:代理主钱包流水, agent_recharge:代理充值, refund:退款, exchange:换货, commission_record:佣金明细)"`
|
||
Format string `json:"format" description:"导出格式 (xlsx:Excel, csv:CSV)"`
|
||
Status int `json:"status" description:"任务状态 (1:待处理, 2:处理中, 3:已完成, 4:已失败, 5:已取消)"`
|
||
StatusName string `json:"status_name" description:"任务状态名称（中文）"`
|
||
Progress int `json:"progress" description:"任务进度(0-100)"`
|
||
TotalRows int `json:"total_rows" description:"总行数"`
|
||
ProcessedRows int `json:"processed_rows" description:"已处理行数"`
|
||
TotalShards int `json:"total_shards" description:"总分片数"`
|
||
SuccessShards int `json:"success_shards" description:"成功分片数"`
|
||
FailedShards int `json:"failed_shards" description:"失败分片数"`
|
||
TotalCount int `json:"total_count" description:"统一任务总数"`
|
||
SuccessCount int `json:"success_count" description:"统一任务成功数"`
|
||
FailedCount int `json:"failed_count" description:"统一任务失败数"`
|
||
CancelRequested bool `json:"cancel_requested" description:"是否已请求取消"`
|
||
FileKey string `json:"file_key,omitempty" description:"导出文件Key"`
|
||
ErrorMessage string `json:"error_message,omitempty" description:"错误信息"`
|
||
ErrorCode string `json:"error_code,omitempty" description:"安全错误码"`
|
||
ErrorSummary string `json:"error_summary,omitempty" description:"安全失败摘要"`
|
||
CreatedAt time.Time `json:"created_at" description:"创建时间"`
|
||
UpdatedAt time.Time `json:"updated_at" description:"更新时间"`
|
||
StartedAt *time.Time `json:"started_at,omitempty" description:"开始处理时间"`
|
||
CompletedAt *time.Time `json:"completed_at,omitempty" description:"完成时间"`
|
||
CreatorUserID uint `json:"creator_user_id" description:"创建人用户ID"`
|
||
CreatorUserType int `json:"creator_user_type" description:"创建人用户类型 (2:平台, 3:代理, 4:企业)"`
|
||
CreatorShopID *uint `json:"creator_shop_id,omitempty" description:"创建人店铺ID"`
|
||
CreatorEnterpriseID *uint `json:"creator_enterprise_id,omitempty" description:"创建人企业ID"`
|
||
}
|
||
|
||
// ListExportTaskResponse 导出任务列表响应。
|
||
type ListExportTaskResponse struct {
|
||
List []*ExportTaskItem `json:"items" description:"任务列表"`
|
||
Total int64 `json:"total" description:"总数"`
|
||
Page int `json:"page" description:"当前页码"`
|
||
PageSize int `json:"size" description:"每页数量"`
|
||
}
|
||
|
||
// GetExportTaskRequest 导出任务详情请求。
|
||
type GetExportTaskRequest struct {
|
||
ID uint `path:"id" description:"任务ID" required:"true"`
|
||
}
|
||
|
||
// ExportTaskDetailResponse 导出任务详情响应。
|
||
type ExportTaskDetailResponse struct {
|
||
ExportTaskItem
|
||
DownloadURL string `json:"download_url,omitempty" description:"下载链接（仅已完成任务返回）"`
|
||
DownloadExpiresAt *time.Time `json:"download_expires_at,omitempty" description:"下载链接过期时间"`
|
||
}
|
||
|
||
// CancelExportTaskRequest 取消导出任务请求。
|
||
type CancelExportTaskRequest struct {
|
||
ID uint `path:"id" description:"任务ID" required:"true"`
|
||
}
|
||
|
||
// CancelExportTaskResponse 取消导出任务响应。
|
||
type CancelExportTaskResponse struct {
|
||
TaskID uint `json:"task_id" description:"任务ID"`
|
||
Status int `json:"status" description:"任务状态 (1:待处理, 2:处理中, 3:已完成, 4:已失败, 5:已取消)"`
|
||
StatusName string `json:"status_name" description:"任务状态名称（中文）"`
|
||
CancelRequested bool `json:"cancel_requested" description:"是否已请求取消"`
|
||
Message string `json:"message" description:"提示信息"`
|
||
}
|