break
5ed6b39deb
Some checks failed
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Has been cancelled
- 新增六对成对迁移 000232–000237：H5 弹窗类型、退款结算标识与申请人备注、优先轮询事实字段与两个新终态、通道阈值命中留痕、手机号最近解绑人、提现资格校验留痕 - 退款：原因必填与申请人备注、来源支付与渠道流水冻结、线下处理流水号补录审计、按订单查询可选退款方式、企微审批材料补齐且新增字段缺失映射即明确失败 - 优先轮询：人工关闭、有效期到期独立周期任务、失败与过期人工重触发、事实字段与异常重试查询、资产解析端点只读投影 - 通道阈值：命中事实同事务留痕与命中记录查询；员工账单：列表筛选与详情投影；商户池：列表投影与统计周期语义；H5：弹窗类型与类别排序 - 手机号：有效关联数量与最近解绑人、短信验证码失败次数限制；导出：佣金明细十五列与报表序号列 - 时间筛选：三处新增筛选纳入统一严格解析契约，员工账单产生时间参数改名 - 同步 12 份主 Spec 需求、两端点与异步任务证据链，门禁 context-health 与 OpenSpec 校验通过
277 lines
10 KiB
Go
277 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.source_payment_no,
|
|
r.original_channel_trade_no,
|
|
r.offline_settlement_no,
|
|
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),
|
|
item.SourcePaymentNo,
|
|
item.OriginalChannelTradeNo,
|
|
item.OfflineSettlementNo,
|
|
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"`
|
|
SourcePaymentNo string `gorm:"column:source_payment_no"`
|
|
OriginalChannelTradeNo string `gorm:"column:original_channel_trade_no"`
|
|
OfflineSettlementNo string `gorm:"column:offline_settlement_no"`
|
|
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 "有异常"
|
|
}
|