f

internal/application/finance/dto/commands/finance_commands.go

@@ -0,0 +1,38 @@
+package commands
+
+// CreateWalletCommand 创建钱包命令
+type CreateWalletCommand struct {
+	UserID string `json:"user_id" binding:"required,uuid"`
+}
+
+// TransferRechargeCommand 对公转账充值命令
+type TransferRechargeCommand struct {
+	UserID          string `json:"user_id" binding:"required,uuid"`
+	Amount          string `json:"amount" binding:"required"`
+	TransferOrderID string `json:"transfer_order_id" binding:"required" comment:"转账订单号"`
+	Notes           string `json:"notes" binding:"omitempty,max=500" comment:"备注信息"`
+}
+
+// GiftRechargeCommand 赠送充值命令
+type GiftRechargeCommand struct {
+	UserID string `json:"user_id" binding:"required,uuid"`
+	Amount string `json:"amount" binding:"required"`
+	Notes  string `json:"notes" binding:"omitempty,max=500" comment:"备注信息"`
+}
+
+// CreateAlipayRechargeCommand 创建支付宝充值订单命令
+type CreateAlipayRechargeCommand struct {
+	UserID   string `json:"-"`                                           // 用户ID（从token获取）
+	Amount   string `json:"amount" binding:"required"`                   // 充值金额
+	Subject  string `json:"-"`                                           // 订单标题
+	Platform string `json:"platform" binding:"required,oneof=app h5 pc"` // 支付平台：app/h5/pc
+}
+
+// CreateWechatRechargeCommand 创建微信充值订单命令
+type CreateWechatRechargeCommand struct {
+	UserID   string `json:"-"`                                                           // 用户ID（从token获取）
+	Amount   string `json:"amount" binding:"required"`                                   // 充值金额
+	Subject  string `json:"-"`                                                           // 订单标题
+	Platform string `json:"platform" binding:"required,oneof=wx_native native wx_h5 h5"` // 仅支持微信Native扫码，兼容传入native/wx_h5/h5
+	OpenID   string `json:"openid" binding:"omitempty"`                                  // 前端可直接传入的 openid（用于小程序/H5）
+}

internal/application/finance/dto/invoice_responses.go

@@ -0,0 +1,121 @@
+package dto
+
+import (
+	"time"
+
+	"hyapi-server/internal/domains/finance/entities"
+	"hyapi-server/internal/domains/finance/value_objects"
+
+	"github.com/shopspring/decimal"
+)
+
+// InvoiceApplicationResponse 发票申请响应
+type InvoiceApplicationResponse struct {
+	ID          string                    `json:"id"`
+	UserID      string                    `json:"user_id"`
+	InvoiceType value_objects.InvoiceType `json:"invoice_type"`
+	Amount      decimal.Decimal           `json:"amount"`
+	Status      entities.ApplicationStatus `json:"status"`
+	InvoiceInfo *value_objects.InvoiceInfo `json:"invoice_info"`
+	CreatedAt   time.Time                 `json:"created_at"`
+}
+
+// InvoiceInfoResponse 发票信息响应
+type InvoiceInfoResponse struct {
+	CompanyName    string `json:"company_name"`    // 从企业认证信息获取，只读
+	TaxpayerID     string `json:"taxpayer_id"`     // 从企业认证信息获取，只读
+	BankName       string `json:"bank_name"`       // 用户可编辑
+	BankAccount    string `json:"bank_account"`    // 用户可编辑
+	CompanyAddress string `json:"company_address"` // 用户可编辑
+	CompanyPhone   string `json:"company_phone"`   // 用户可编辑
+	ReceivingEmail string `json:"receiving_email"` // 用户可编辑
+	IsComplete     bool   `json:"is_complete"`
+	MissingFields  []string `json:"missing_fields,omitempty"`
+	// 字段权限标识
+	CompanyNameReadOnly bool `json:"company_name_read_only"` // 公司名称是否只读
+	TaxpayerIDReadOnly  bool `json:"taxpayer_id_read_only"`  // 纳税人识别号是否只读
+}
+
+// InvoiceRecordResponse 发票记录响应
+type InvoiceRecordResponse struct {
+	ID          string                    `json:"id"`
+	UserID      string                    `json:"user_id"`
+	InvoiceType value_objects.InvoiceType `json:"invoice_type"`
+	Amount      decimal.Decimal           `json:"amount"`
+	Status      entities.ApplicationStatus `json:"status"`
+	// 开票信息（快照数据）
+	CompanyName    string `json:"company_name"`    // 公司名称
+	TaxpayerID     string `json:"taxpayer_id"`     // 纳税人识别号
+	BankName       string `json:"bank_name"`       // 开户银行
+	BankAccount    string `json:"bank_account"`    // 银行账号
+	CompanyAddress string `json:"company_address"` // 企业地址
+	CompanyPhone   string `json:"company_phone"`   // 企业电话
+	ReceivingEmail string `json:"receiving_email"` // 接收邮箱
+	// 文件信息
+	FileName    *string   `json:"file_name,omitempty"`
+	FileSize    *int64    `json:"file_size,omitempty"`
+	FileURL     *string   `json:"file_url,omitempty"`
+	// 时间信息
+	ProcessedAt *time.Time `json:"processed_at,omitempty"`
+	CreatedAt   time.Time  `json:"created_at"`
+	// 拒绝原因
+	RejectReason *string `json:"reject_reason,omitempty"`
+}
+
+// InvoiceRecordsResponse 发票记录列表响应
+type InvoiceRecordsResponse struct {
+	Records    []*InvoiceRecordResponse `json:"records"`
+	Total      int64                    `json:"total"`
+	Page       int                      `json:"page"`
+	PageSize   int                      `json:"page_size"`
+	TotalPages int                      `json:"total_pages"`
+}
+
+// FileDownloadResponse 文件下载响应
+type FileDownloadResponse struct {
+	FileID      string `json:"file_id"`
+	FileName    string `json:"file_name"`
+	FileSize    int64  `json:"file_size"`
+	FileURL     string `json:"file_url"`
+	FileContent []byte `json:"file_content"`
+}
+
+// AvailableAmountResponse 可开票金额响应
+type AvailableAmountResponse struct {
+	AvailableAmount     decimal.Decimal `json:"available_amount"`      // 可开票金额
+	TotalRecharged      decimal.Decimal `json:"total_recharged"`       // 总充值金额
+	TotalGifted         decimal.Decimal `json:"total_gifted"`          // 总赠送金额
+	TotalInvoiced       decimal.Decimal `json:"total_invoiced"`        // 已开票金额
+	PendingApplications decimal.Decimal `json:"pending_applications"`  // 待处理申请金额
+}
+
+// PendingApplicationResponse 待处理申请响应
+type PendingApplicationResponse struct {
+	ID             string                    `json:"id"`
+	UserID         string                    `json:"user_id"`
+	InvoiceType    value_objects.InvoiceType `json:"invoice_type"`
+	Amount         decimal.Decimal           `json:"amount"`
+	Status         entities.ApplicationStatus `json:"status"`
+	CompanyName    string                    `json:"company_name"`
+	TaxpayerID     string                    `json:"taxpayer_id"`
+	BankName       string                    `json:"bank_name"`
+	BankAccount    string                    `json:"bank_account"`
+	CompanyAddress string                    `json:"company_address"`
+	CompanyPhone   string                    `json:"company_phone"`
+	ReceivingEmail string                    `json:"receiving_email"`
+	FileName       *string                   `json:"file_name,omitempty"`
+	FileSize       *int64                    `json:"file_size,omitempty"`
+	FileURL        *string                   `json:"file_url,omitempty"`
+	ProcessedAt    *time.Time                `json:"processed_at,omitempty"`
+	CreatedAt      time.Time                 `json:"created_at"`
+	RejectReason   *string                   `json:"reject_reason,omitempty"`
+}
+
+// PendingApplicationsResponse 待处理申请列表响应
+type PendingApplicationsResponse struct {
+	Applications []*PendingApplicationResponse `json:"applications"`
+	Total        int64                         `json:"total"`
+	Page         int                           `json:"page"`
+	PageSize     int                           `json:"page_size"`
+	TotalPages   int                           `json:"total_pages"`
+}

internal/application/finance/dto/queries/finance_queries.go

@@ -0,0 +1,21 @@
+package queries
+
+// GetWalletInfoQuery 获取钱包信息查询
+type GetWalletInfoQuery struct {
+	UserID string `form:"user_id" binding:"required"`
+}
+
+// GetWalletQuery 获取钱包查询
+type GetWalletQuery struct {
+	UserID string `form:"user_id" binding:"required"`
+}
+
+// GetWalletStatsQuery 获取钱包统计查询
+type GetWalletStatsQuery struct {
+	UserID string `form:"user_id" binding:"required"`
+}
+
+// GetUserSecretsQuery 获取用户密钥查询
+type GetUserSecretsQuery struct {
+	UserID string `form:"user_id" binding:"required"`
+}

internal/application/finance/dto/responses/alipay_order_status_response.go

@@ -0,0 +1,25 @@
+package responses
+
+import (
+	"time"
+
+	"github.com/shopspring/decimal"
+)
+
+// AlipayOrderStatusResponse 支付宝订单状态响应
+type AlipayOrderStatusResponse struct {
+	OutTradeNo    string          `json:"out_trade_no"`    // 商户订单号
+	TradeNo       *string         `json:"trade_no"`        // 支付宝交易号
+	Status        string          `json:"status"`          // 订单状态
+	Amount        decimal.Decimal `json:"amount"`          // 订单金额
+	Subject       string          `json:"subject"`         // 订单标题
+	Platform      string          `json:"platform"`        // 支付平台
+	CreatedAt     time.Time       `json:"created_at"`      // 创建时间
+	UpdatedAt     time.Time       `json:"updated_at"`      // 更新时间
+	NotifyTime    *time.Time      `json:"notify_time"`     // 异步通知时间
+	ReturnTime    *time.Time      `json:"return_time"`     // 同步返回时间
+	ErrorCode     *string         `json:"error_code"`      // 错误码
+	ErrorMessage  *string         `json:"error_message"`   // 错误信息
+	IsProcessing  bool            `json:"is_processing"`   // 是否处理中
+	CanRetry      bool            `json:"can_retry"`       // 是否可以重试
+} 

internal/application/finance/dto/responses/finance_responses.go

@@ -0,0 +1,171 @@
+package responses
+
+import (
+	"time"
+
+	"github.com/shopspring/decimal"
+)
+
+// WalletResponse 钱包响应
+type WalletResponse struct {
+	ID            string          `json:"id"`
+	UserID        string          `json:"user_id"`
+	IsActive      bool            `json:"is_active"`
+	Balance       decimal.Decimal `json:"balance"`
+	BalanceStatus string          `json:"balance_status"` // normal, low, arrears
+	IsArrears     bool            `json:"is_arrears"`     // 是否欠费
+	IsLowBalance  bool            `json:"is_low_balance"` // 是否余额较低
+	CreatedAt     time.Time       `json:"created_at"`
+	UpdatedAt     time.Time       `json:"updated_at"`
+}
+
+// TransactionResponse 交易响应
+type TransactionResponse struct {
+	TransactionID string          `json:"transaction_id"`
+	Amount        decimal.Decimal `json:"amount"`
+}
+
+// UserSecretsResponse 用户密钥响应
+type UserSecretsResponse struct {
+	ID         string     `json:"id"`
+	UserID     string     `json:"user_id"`
+	AccessID   string     `json:"access_id"`
+	AccessKey  string     `json:"access_key"`
+	IsActive   bool       `json:"is_active"`
+	LastUsedAt *time.Time `json:"last_used_at"`
+	ExpiresAt  *time.Time `json:"expires_at"`
+	CreatedAt  time.Time  `json:"created_at"`
+	UpdatedAt  time.Time  `json:"updated_at"`
+}
+
+// WalletStatsResponse 钱包统计响应
+type WalletStatsResponse struct {
+	TotalWallets      int64           `json:"total_wallets"`
+	ActiveWallets     int64           `json:"active_wallets"`
+	TotalBalance      decimal.Decimal `json:"total_balance"`
+	TodayTransactions int64           `json:"today_transactions"`
+	TodayVolume       decimal.Decimal `json:"today_volume"`
+}
+
+// RechargeRecordResponse 充值记录响应
+type RechargeRecordResponse struct {
+	ID              string              `json:"id"`
+	UserID          string              `json:"user_id"`
+	Amount          decimal.Decimal     `json:"amount"`
+	RechargeType    string              `json:"recharge_type"`
+	Status          string              `json:"status"`
+	AlipayOrderID   string              `json:"alipay_order_id,omitempty"`
+	WechatOrderID   string              `json:"wechat_order_id,omitempty"`
+	TransferOrderID string              `json:"transfer_order_id,omitempty"`
+	Platform        string              `json:"platform,omitempty"` // 支付平台：pc/wx_native等
+	Notes           string              `json:"notes,omitempty"`
+	OperatorID      string              `json:"operator_id,omitempty"`
+	CompanyName     string              `json:"company_name,omitempty"`
+	User            *UserSimpleResponse `json:"user,omitempty"`
+	CreatedAt       time.Time           `json:"created_at"`
+	UpdatedAt       time.Time           `json:"updated_at"`
+}
+
+// WalletTransactionResponse 钱包交易记录响应
+type WalletTransactionResponse struct {
+	ID            string              `json:"id"`
+	UserID        string              `json:"user_id"`
+	ApiCallID     string              `json:"api_call_id"`
+	TransactionID string              `json:"transaction_id"`
+	ProductID     string              `json:"product_id"`
+	ProductName   string              `json:"product_name"`
+	Amount        decimal.Decimal     `json:"amount"`
+	CompanyName   string              `json:"company_name,omitempty"`
+	User          *UserSimpleResponse `json:"user,omitempty"`
+	CreatedAt     time.Time           `json:"created_at"`
+	UpdatedAt     time.Time           `json:"updated_at"`
+}
+
+// WalletTransactionListResponse 钱包交易记录列表响应
+type WalletTransactionListResponse struct {
+	Items []WalletTransactionResponse `json:"items"`
+	Total int64                       `json:"total"`
+	Page  int                         `json:"page"`
+	Size  int                         `json:"size"`
+}
+
+// RechargeRecordListResponse 充值记录列表响应
+type RechargeRecordListResponse struct {
+	Items []RechargeRecordResponse `json:"items"`
+	Total int64                    `json:"total"`
+	Page  int                      `json:"page"`
+	Size  int                      `json:"size"`
+}
+
+// AlipayRechargeOrderResponse 支付宝充值订单响应
+type AlipayRechargeOrderResponse struct {
+	PayURL     string          `json:"pay_url"`      // 支付链接
+	OutTradeNo string          `json:"out_trade_no"` // 商户订单号
+	Amount     decimal.Decimal `json:"amount"`       // 充值金额
+	Platform   string          `json:"platform"`     // 支付平台
+	Subject    string          `json:"subject"`      // 订单标题
+}
+
+// RechargeConfigResponse 充值配置响应
+type RechargeConfigResponse struct {
+	MinAmount           string                            `json:"min_amount"`            // 最低充值金额
+	MaxAmount           string                            `json:"max_amount"`            // 最高充值金额
+	RechargeBonusEnabled bool                             `json:"recharge_bonus_enabled"` // 是否启用充值赠送
+	ApiStoreRechargeTip string                            `json:"api_store_recharge_tip"` // API 商店充值提示（大额/批量联系商务）
+	AlipayRechargeBonus []AlipayRechargeBonusRuleResponse `json:"alipay_recharge_bonus"`
+}
+
+// AlipayRechargeBonusRuleResponse 支付宝充值赠送规则响应
+type AlipayRechargeBonusRuleResponse struct {
+	RechargeAmount float64 `json:"recharge_amount"`
+	BonusAmount    float64 `json:"bonus_amount"`
+}
+
+// UserSimpleResponse 用户简单信息响应
+type UserSimpleResponse struct {
+	ID          string `json:"id"`
+	CompanyName string `json:"company_name"`
+	Phone       string `json:"phone"`
+}
+
+// PurchaseRecordResponse 购买记录响应
+type PurchaseRecordResponse struct {
+	ID            string              `json:"id"`
+	UserID        string              `json:"user_id"`
+	OrderNo       string              `json:"order_no"`
+	TradeNo       *string             `json:"trade_no,omitempty"`
+	ProductID     string              `json:"product_id"`
+	ProductCode   string              `json:"product_code"`
+	ProductName   string              `json:"product_name"`
+	Category      string              `json:"category,omitempty"`
+	Subject       string              `json:"subject"`
+	Amount        decimal.Decimal     `json:"amount"`
+	PayAmount     *decimal.Decimal    `json:"pay_amount,omitempty"`
+	Status        string              `json:"status"`
+	Platform      string              `json:"platform"`
+	PayChannel    string              `json:"pay_channel"`
+	PaymentType   string              `json:"payment_type"`
+	BuyerID       string              `json:"buyer_id,omitempty"`
+	SellerID      string              `json:"seller_id,omitempty"`
+	ReceiptAmount decimal.Decimal     `json:"receipt_amount,omitempty"`
+	NotifyTime    *time.Time          `json:"notify_time,omitempty"`
+	ReturnTime    *time.Time          `json:"return_time,omitempty"`
+	PayTime       *time.Time          `json:"pay_time,omitempty"`
+	FilePath      *string             `json:"file_path,omitempty"`
+	FileSize      *int64              `json:"file_size,omitempty"`
+	Remark        string              `json:"remark,omitempty"`
+	ErrorCode     string              `json:"error_code,omitempty"`
+	ErrorMessage  string              `json:"error_message,omitempty"`
+	CompanyName   string              `json:"company_name,omitempty"`
+	User          *UserSimpleResponse `json:"user,omitempty"`
+	CreatedAt     time.Time           `json:"created_at"`
+	UpdatedAt     time.Time           `json:"updated_at"`
+}
+
+// PurchaseRecordListResponse 购买记录列表响应
+type PurchaseRecordListResponse struct {
+	Items []PurchaseRecordResponse `json:"items"`
+	Total int64                    `json:"total"`
+	Page  int                      `json:"page"`
+	Size  int                      `json:"size"`
+}

internal/application/finance/dto/responses/wechat_order_status_response.go

@@ -0,0 +1,25 @@
+package responses
+
+import (
+	"time"
+
+	"github.com/shopspring/decimal"
+)
+
+// WechatOrderStatusResponse 微信订单状态响应
+type WechatOrderStatusResponse struct {
+	OutTradeNo    string          `json:"out_trade_no"`   // 商户订单号
+	TransactionID *string         `json:"transaction_id"` // 微信支付交易号
+	Status        string          `json:"status"`         // 订单状态
+	Amount        decimal.Decimal `json:"amount"`         // 订单金额
+	Subject       string          `json:"subject"`        // 订单标题
+	Platform      string          `json:"platform"`       // 支付平台
+	CreatedAt     time.Time       `json:"created_at"`     // 创建时间
+	UpdatedAt     time.Time       `json:"updated_at"`     // 更新时间
+	NotifyTime    *time.Time      `json:"notify_time"`    // 异步通知时间
+	ReturnTime    *time.Time      `json:"return_time"`    // 同步返回时间
+	ErrorCode     *string         `json:"error_code"`     // 错误码
+	ErrorMessage  *string         `json:"error_message"`  // 错误信息
+	IsProcessing  bool            `json:"is_processing"`  // 是否处理中
+	CanRetry      bool            `json:"can_retry"`      // 是否可以重试
+}

internal/application/finance/dto/responses/wechat_recharge_order_response.go

@@ -0,0 +1,12 @@
+package responses
+
+import "github.com/shopspring/decimal"
+
+// WechatRechargeOrderResponse 微信充值下单响应
+type WechatRechargeOrderResponse struct {
+	OutTradeNo string          `json:"out_trade_no"` // 商户订单号
+	Amount     decimal.Decimal `json:"amount"`       // 充值金额
+	Platform   string          `json:"platform"`     // 支付平台
+	Subject    string          `json:"subject"`      // 订单标题
+	PrepayData interface{}     `json:"prepay_data"`  // 预支付数据（APP预支付ID或JSAPI参数）
+}