feat(代理自充): AUG26-017 代理自充收款方式与线下预存款审批字段

- 受控配置新增代理在线自充允许范围（仅微信/仅支付宝/同时支持），读侧与创建侧取允许范围与可用商户池交集，两侧失败关闭
- 新增允许范围查询与修改端点，读限代理与平台账号、写限超级管理员，复用受控配置写服务留痕
- tb_agent_recharge_record 新增交易流水号、线下收款方式三列快照与其他凭证列（成对迁移 000213）
- 线下申请校验启用的收款方式字典项与必填交易流水号，交易流水号独立于在线渠道交易号、不参与去重
- 扩展 offline_recharge_approval 场景可映射字段白名单与字典引用保护
- 新增付款凭证识别能力与交易流水号预填接口，识别不落库、日志不记录载荷

pkg/constants/agent_recharge.go

@@ -23,6 +23,34 @@ const (
 	AgentRechargeSourceAgentOnline = "agent_online"
 )
 
+// 代理线下预存款审批字段边界。
+const (
+	// AgentRechargeExternalTransactionNoMaxLength 表示线下充值交易流水号最大长度。
+	AgentRechargeExternalTransactionNoMaxLength = 128
+	// AgentRechargePaymentVoucherMaxCount 表示一次线下充值允许的最多支付凭证数量。
+	AgentRechargePaymentVoucherMaxCount = 5
+	// AgentRechargeOtherVoucherMaxCount 表示一次线下充值允许的最多其他凭证数量。
+	AgentRechargeOtherVoucherMaxCount = 5
+	// AgentRechargeVoucherKeyMaxLength 表示单个凭证对象键最大长度。
+	AgentRechargeVoucherKeyMaxLength = 500
+	// AgentRechargeVoucherMaxBytes 表示单张付款凭证图片允许的最大字节数。
+	AgentRechargeVoucherMaxBytes = 10 << 20
+)
+
+// GetAgentSelfRechargeAllowedMethodsName 返回代理在线自充允许范围的中文名称。
+func GetAgentSelfRechargeAllowedMethodsName(value string) string {
+	switch value {
+	case AgentSelfRechargeAllowedWechatOnly:
+		return "仅微信"
+	case AgentSelfRechargeAllowedAlipayOnly:
+		return "仅支付宝"
+	case AgentSelfRechargeAllowedBoth:
+		return "同时支持微信和支付宝"
+	default:
+		return "未知允许范围"
+	}
+}
+
 // GetAgentRechargeSource 根据支付方式返回稳定的充值来源及中文名称。
 func GetAgentRechargeSource(paymentMethod string) (string, string) {
 	if paymentMethod == RechargeMethodWechat || paymentMethod == RechargeMethodAlipay {