break
67893617fe
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m33s
补齐 PRD §2.3.1「退款管理补充字段」：退款列表、详情与导出新增 「当前退款套餐已用量」与「当前退款套餐总量」两个纯展示字段。 - 套餐定位口径与退款套餐失效保持一致，按优先级取唯一一条： 冻结的 package_usage_id（且属于该订单）→ 订单主套餐 → 订单任一套餐， 同级按标识升序。不按当前世代或当前生效套餐推断；不按套餐状态过滤， 使退款后套餐转已失效时仍能回看用量。 - 列表与详情用固定两次查询批量解析（按标识、按订单），查询次数不随条数增长； 详情复用同一函数。解析不到套餐或记录已物理删除时返回 0，不阻断读取。 - 导出新增两列并改用同一优先级的 LATERAL 取法，不再依赖只按 r.package_usage_id 的 join——生产库 1296 条退款仅 157 条带该字段，旧取法会让多数行显示零值。 - 不改变退款金额校验、冻结实收、套餐失效、接续、停机与佣金回溯任何规则。 验证：测试库 junhong_cmp_test 实测冻结记录、订单主套餐回退、记录缺失返回 0 三项 解析场景与「4 条退款固定 2 次查询」；并以同批 43 条退款对拍 Go 解析器与导出 SQL， 口径不一致 0 条；导出 43 行列数与表头一致。无迁移、无接口路径变化。
267 lines
10 KiB
Go
267 lines
10 KiB
Go
package exporter
|
|
|
|
import (
|
|
"context"
|
|
"strconv"
|
|
"time"
|
|
|
|
"gorm.io/gorm"
|
|
|
|
"github.com/break/junhong_cmp_fiber/internal/model"
|
|
"github.com/break/junhong_cmp_fiber/pkg/constants"
|
|
)
|
|
|
|
// RefundDataSource 退款记录导出数据源。
|
|
type RefundDataSource struct {
|
|
db *gorm.DB
|
|
}
|
|
|
|
// NewRefundDataSource 创建退款记录导出数据源。
|
|
func NewRefundDataSource(db *gorm.DB) *RefundDataSource {
|
|
return &RefundDataSource{db: db}
|
|
}
|
|
|
|
// Scene 返回导出场景编码。
|
|
func (s *RefundDataSource) Scene() string {
|
|
return constants.ExportTaskSceneRefund
|
|
}
|
|
|
|
// Count 统计退款记录导出行数。
|
|
func (s *RefundDataSource) Count(ctx context.Context, params ExportParams) (int, error) {
|
|
var total int64
|
|
query := s.applyFilters(s.baseQuery(ctx), params)
|
|
if err := query.Count(&total).Error; err != nil {
|
|
return 0, err
|
|
}
|
|
return int(total), nil
|
|
}
|
|
|
|
// Headers 返回退款记录导出表头。
|
|
func (s *RefundDataSource) Headers(context.Context, ExportParams) ([]string, error) {
|
|
return []string{
|
|
"退款单号", "代理店铺名称", "关联的支付订单号", "资产类型", "资产标识", "套餐名称",
|
|
"当前退款套餐已用量(MB)", "当前退款套餐总量(MB)", "原订单金额(元)",
|
|
"实收金额(元)", "可退金额(元)", "申请退款金额(元)", "实际退款金额(元)", "状态", "退款方式",
|
|
"冻结实收金额(元)", "渠道退款状态", "渠道退款流水号", "渠道退款金额(元)", "失败分类", "异常标记",
|
|
"退款原因", "审批备注",
|
|
"审批来源", "审批状态", "退款处理状态", "退款申请时间", "退款审批时间", "提交人", "退款凭证",
|
|
}, nil
|
|
}
|
|
|
|
// Fetch 按 offset/limit 查询退款记录导出数据。
|
|
func (s *RefundDataSource) Fetch(ctx context.Context, params ExportParams, offset, limit int) ([][]string, error) {
|
|
if limit <= 0 {
|
|
return [][]string{}, nil
|
|
}
|
|
|
|
var items []refundExportRow
|
|
query := s.applyFilters(s.baseQuery(ctx), params).
|
|
Select(`
|
|
r.refund_no,
|
|
r.order_no,
|
|
r.order_type,
|
|
r.asset_identifier,
|
|
r.actual_received_amount,
|
|
r.requested_refund_amount,
|
|
r.approved_refund_amount,
|
|
r.status,
|
|
r.method,
|
|
r.frozen_actual_received_amount,
|
|
r.channel_refund_status,
|
|
r.channel_refund_no,
|
|
r.channel_refund_amount,
|
|
r.failure_reason,
|
|
r.anomaly_flag,
|
|
r.refund_reason,
|
|
r.remark,
|
|
r.commission_deducted,
|
|
r.asset_reset,
|
|
r.created_at,
|
|
r.processed_at,
|
|
COALESCE(sh.shop_name, '') AS shop_name,
|
|
o.total_amount AS original_amount,
|
|
o.actual_paid_amount AS refundable_amount,
|
|
COALESCE(pu.package_name, items.package_names, '') AS package_name,
|
|
-- 当前退款套餐用量：与展示口径一致，按冻结套餐记录 → 订单主套餐 → 订单任一套餐
|
|
-- 取唯一一条，且不按套餐状态过滤（退款后套餐已失效仍需展示其用量）。
|
|
COALESCE(usage.data_usage_mb, 0) AS refund_package_used_mb,
|
|
COALESCE(usage.data_limit_mb, 0) AS refund_package_total_mb,
|
|
COALESCE(ac.username, '') AS submitter_name,
|
|
ai.provider AS approval_provider,
|
|
ai.status AS approval_status,
|
|
COALESCE((SELECT string_agg(voucher.value, ',' ORDER BY voucher.ordinality)
|
|
FROM jsonb_array_elements_text(COALESCE(r.refund_voucher_key, '[]'::jsonb)) WITH ORDINALITY AS voucher(value, ordinality)), '') AS voucher_keys
|
|
`).
|
|
Joins("LEFT JOIN tb_shop AS sh ON sh.id = r.shop_id").
|
|
Joins("LEFT JOIN tb_order AS o ON o.id = r.order_id AND o.deleted_at IS NULL").
|
|
Joins("LEFT JOIN tb_package_usage AS pu ON pu.id = r.package_usage_id AND pu.deleted_at IS NULL").
|
|
Joins("LEFT JOIN tb_account AS ac ON ac.id = r.creator").
|
|
Joins("LEFT JOIN tb_approval_instance AS ai ON ai.id = r.approval_instance_id").
|
|
Joins(`LEFT JOIN LATERAL (
|
|
SELECT string_agg(oi.package_name, ',' ORDER BY oi.id) AS package_names
|
|
FROM tb_order_item AS oi
|
|
WHERE oi.order_id = r.order_id AND oi.deleted_at IS NULL
|
|
) AS items ON TRUE`).
|
|
Joins(`LEFT JOIN LATERAL (
|
|
SELECT candidate.data_usage_mb, candidate.data_limit_mb
|
|
FROM tb_package_usage AS candidate
|
|
WHERE candidate.deleted_at IS NULL
|
|
AND (
|
|
(r.package_usage_id IS NOT NULL AND candidate.id = r.package_usage_id AND candidate.order_id = r.order_id)
|
|
OR (candidate.order_id = r.order_id)
|
|
)
|
|
ORDER BY
|
|
CASE WHEN r.package_usage_id IS NOT NULL AND candidate.id = r.package_usage_id THEN 0
|
|
WHEN candidate.master_usage_id IS NULL THEN 1
|
|
ELSE 2 END,
|
|
candidate.id ASC
|
|
LIMIT 1
|
|
) AS usage ON TRUE`).
|
|
Order("r.id ASC").
|
|
Limit(limit).
|
|
Offset(offset)
|
|
if err := query.Scan(&items).Error; err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
rows := make([][]string, 0, len(items))
|
|
for _, item := range items {
|
|
rows = append(rows, []string{
|
|
item.RefundNo,
|
|
item.ShopName,
|
|
item.OrderNo,
|
|
formatRefundAssetType(item.OrderType),
|
|
item.AssetIdentifier,
|
|
item.PackageName,
|
|
strconv.FormatInt(item.RefundPackageUsedMB, 10),
|
|
strconv.FormatInt(item.RefundPackageTotalMB, 10),
|
|
formatOptionalMoneyYuan(item.OriginalAmount),
|
|
formatMoneyYuan(item.ActualReceivedAmount),
|
|
formatOptionalMoneyYuan(item.RefundableAmount),
|
|
formatMoneyYuan(item.RequestedRefundAmount),
|
|
formatOptionalMoneyYuan(item.ApprovedRefundAmount),
|
|
constants.GetRefundStatusName(item.Status),
|
|
constants.RefundMethodName(item.Method),
|
|
formatMoneyYuan(item.FrozenActualReceivedAmount),
|
|
constants.RefundChannelStatusName(item.ChannelRefundStatus),
|
|
item.ChannelRefundNo,
|
|
formatMoneyYuan(item.ChannelRefundAmount),
|
|
constants.RefundFailureReasonName(item.FailureReason),
|
|
formatRefundAnomalyFlag(item.AnomalyFlag),
|
|
item.RefundReason,
|
|
item.Remark,
|
|
formatRefundApprovalSource(item.ApprovalProvider),
|
|
formatOptionalApprovalStatus(item.ApprovalStatus),
|
|
formatRefundProcessingStatus(item.Status, item.CommissionDeducted, item.AssetReset),
|
|
item.CreatedAt.Format(exportTimeLayout),
|
|
formatOptionalTime(item.ProcessedAt),
|
|
item.SubmitterName,
|
|
item.VoucherKeys,
|
|
})
|
|
}
|
|
return rows, nil
|
|
}
|
|
|
|
func (s *RefundDataSource) baseQuery(ctx context.Context) *gorm.DB {
|
|
return s.db.WithContext(ctx).Table("tb_refund_request AS r").Where("r.deleted_at IS NULL")
|
|
}
|
|
|
|
func (s *RefundDataSource) applyFilters(query *gorm.DB, params ExportParams) *gorm.DB {
|
|
query = applyExportShopScope(query, params, "r.shop_id")
|
|
if status, ok := filterInt(params.Filters, "status"); ok {
|
|
query = query.Where("r.status = ?", status)
|
|
}
|
|
if orderID, ok := filterUint(params.Filters, "order_id"); ok {
|
|
query = query.Where("r.order_id = ?", orderID)
|
|
}
|
|
if shopID, ok := filterUint(params.Filters, "shop_id"); ok {
|
|
query = query.Where("r.shop_id = ?", shopID)
|
|
}
|
|
if identifier, ok := filterString(params.Filters, "asset_identifier"); ok {
|
|
query = query.Where("r.asset_identifier = ?", identifier)
|
|
}
|
|
return query
|
|
}
|
|
|
|
type refundExportRow struct {
|
|
RefundNo string `gorm:"column:refund_no"`
|
|
ShopName string `gorm:"column:shop_name"`
|
|
OrderNo string `gorm:"column:order_no"`
|
|
OrderType string `gorm:"column:order_type"`
|
|
AssetIdentifier string `gorm:"column:asset_identifier"`
|
|
PackageName string `gorm:"column:package_name"`
|
|
RefundPackageUsedMB int64 `gorm:"column:refund_package_used_mb"`
|
|
RefundPackageTotalMB int64 `gorm:"column:refund_package_total_mb"`
|
|
OriginalAmount *int64 `gorm:"column:original_amount"`
|
|
ActualReceivedAmount int64 `gorm:"column:actual_received_amount"`
|
|
RefundableAmount *int64 `gorm:"column:refundable_amount"`
|
|
RequestedRefundAmount int64 `gorm:"column:requested_refund_amount"`
|
|
ApprovedRefundAmount *int64 `gorm:"column:approved_refund_amount"`
|
|
Status int `gorm:"column:status"`
|
|
Method string `gorm:"column:method"`
|
|
FrozenActualReceivedAmount int64 `gorm:"column:frozen_actual_received_amount"`
|
|
ChannelRefundStatus int `gorm:"column:channel_refund_status"`
|
|
ChannelRefundNo string `gorm:"column:channel_refund_no"`
|
|
ChannelRefundAmount int64 `gorm:"column:channel_refund_amount"`
|
|
FailureReason string `gorm:"column:failure_reason"`
|
|
AnomalyFlag int `gorm:"column:anomaly_flag"`
|
|
RefundReason string `gorm:"column:refund_reason"`
|
|
Remark string `gorm:"column:remark"`
|
|
ApprovalProvider *string `gorm:"column:approval_provider"`
|
|
ApprovalStatus *int `gorm:"column:approval_status"`
|
|
CommissionDeducted bool `gorm:"column:commission_deducted"`
|
|
AssetReset bool `gorm:"column:asset_reset"`
|
|
CreatedAt time.Time `gorm:"column:created_at"`
|
|
ProcessedAt *time.Time `gorm:"column:processed_at"`
|
|
SubmitterName string `gorm:"column:submitter_name"`
|
|
VoucherKeys string `gorm:"column:voucher_keys"`
|
|
}
|
|
|
|
func formatRefundAssetType(orderType string) string {
|
|
switch orderType {
|
|
case model.OrderTypeSingleCard:
|
|
return "物联网卡"
|
|
case model.OrderTypeDevice:
|
|
return "设备"
|
|
case "":
|
|
return ""
|
|
default:
|
|
return "未知"
|
|
}
|
|
}
|
|
|
|
func formatRefundApprovalSource(provider *string) string {
|
|
if provider == nil || *provider == "" {
|
|
return "历史审批"
|
|
}
|
|
return formatApprovalProvider(provider)
|
|
}
|
|
|
|
func formatRefundProcessingStatus(status int, commissionDeducted, assetReset bool) string {
|
|
switch status {
|
|
case model.RefundStatusPending, model.RefundStatusReturned:
|
|
return "待审批"
|
|
case model.RefundStatusRejected:
|
|
return "无需处理"
|
|
case model.RefundStatusApproved:
|
|
if commissionDeducted && assetReset {
|
|
return "已完成"
|
|
}
|
|
return "处理中"
|
|
case model.RefundStatusChannelProcessing:
|
|
return "原路退款处理中"
|
|
case model.RefundStatusChannelFailed:
|
|
return "原路退款失败待人工处理"
|
|
default:
|
|
return "未知"
|
|
}
|
|
}
|
|
|
|
// formatRefundAnomalyFlag 将异常标记转为导出用中文描述。
|
|
func formatRefundAnomalyFlag(flag int) string {
|
|
if flag == 0 {
|
|
return "无异常"
|
|
}
|
|
return "有异常"
|
|
}
|