收口审计治理与套餐任务进展

Constraint: 在线热修前必须保存当前迭代分支全部有效代码进展
Confidence: medium
Scope-risk: broad
Directive: 后续修改需保持审计事件与业务事务边界一致
Tested: git diff --cached --check
Not-tested: 未运行全量测试，提交用于切换分支前保存既有工作

internal/application/agentrecharge/online_payment.go

@@ -5,8 +5,26 @@ import (
 	"time"
 
 	"github.com/break/junhong_cmp_fiber/internal/model"
+	"gorm.io/gorm"
 )
 
+// PaymentAudit 描述代理充值支付记录的实际生命周期变化。
+type PaymentAudit struct {
+	ActionCode         string
+	Summary            string
+	Payment            *model.Payment
+	Recharge           *model.AgentRechargeRecord
+	BeforeData         map[string]any
+	AfterData          map[string]any
+	RechargeBeforeData map[string]any
+	RechargeAfterData  map[string]any
+}
+
+// PaymentAuditWriter 在支付业务事务内追加统一 Audit Event。
+type PaymentAuditWriter interface {
+	WriteAgentRechargePayment(ctx context.Context, tx *gorm.DB, change PaymentAudit) error
+}
+
 const (
 	// OnlinePaymentStatePending 表示渠道仍在等待付款。
 	OnlinePaymentStatePending = "pending"