refactor: 重命名 CardWallet 模型为 AssetWallet，新增 DTO

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

internal/model/asset_wallet.go

@@ -6,9 +6,9 @@ import (
 	"gorm.io/gorm"
 )
 
-// CardWallet 卡钱包模型
+// AssetWallet 资产钱包模型
 // 管理物联网卡和设备级别的钱包
-type CardWallet struct {
+type AssetWallet struct {
 	ID              uint           `gorm:"column:id;primaryKey" json:"id"`
 	ResourceType    string         `gorm:"column:resource_type;type:varchar(20);not null;index;comment:资源类型(iot_card-物联网卡 | device-设备)" json:"resource_type"`
 	ResourceID      uint           `gorm:"column:resource_id;not null;index;comment:资源ID(关联tb_iot_card.id或tb_device.id)" json:"resource_id"`
@@ -25,20 +25,20 @@ type CardWallet struct {
 }
 
 // TableName 指定表名
-func (CardWallet) TableName() string {
+func (AssetWallet) TableName() string {
-	return "tb_card_wallet"
+	return "tb_asset_wallet"
 }
 
 // GetAvailableBalance 获取可用余额 = balance - frozen_balance
-func (w *CardWallet) GetAvailableBalance() int64 {
+func (w *AssetWallet) GetAvailableBalance() int64 {
 	return w.Balance - w.FrozenBalance
 }
 
-// CardWalletTransaction 卡钱包交易记录模型
+// AssetWalletTransaction 资产钱包交易记录模型
-// 记录所有卡钱包余额变动
+// 记录所有资产钱包余额变动
-type CardWalletTransaction struct {
+type AssetWalletTransaction struct {
 	ID              uint           `gorm:"column:id;primaryKey" json:"id"`
-	CardWalletID    uint           `gorm:"column:card_wallet_id;not null;index;comment:卡钱包ID" json:"card_wallet_id"`
+	AssetWalletID   uint           `gorm:"column:asset_wallet_id;not null;index;comment:资产钱包ID" json:"asset_wallet_id"`
 	ResourceType    string         `gorm:"column:resource_type;type:varchar(20);not null;index;comment:资源类型(冗余字段,便于查询)" json:"resource_type"`
 	ResourceID      uint           `gorm:"column:resource_id;not null;index;comment:资源ID(冗余字段,便于查询)" json:"resource_id"`
 	UserID          uint           `gorm:"column:user_id;not null;comment:操作人用户ID" json:"user_id"`
@@ -47,8 +47,8 @@ type CardWalletTransaction struct {
 	BalanceBefore   int64          `gorm:"column:balance_before;type:bigint;not null;comment:变动前余额(单位:分)" json:"balance_before"`
 	BalanceAfter    int64          `gorm:"column:balance_after;type:bigint;not null;comment:变动后余额(单位:分)" json:"balance_after"`
 	Status          int            `gorm:"column:status;type:int;not null;default:1;comment:交易状态(1-成功 2-失败 3-处理中)" json:"status"`
-	ReferenceType   *string        `gorm:"column:reference_type;type:varchar(50);comment:关联业务类型(order | topup)" json:"reference_type,omitempty"`
+	ReferenceType   *string        `gorm:"column:reference_type;type:varchar(50);comment:关联业务类型(order | recharge)" json:"reference_type,omitempty"`
-	ReferenceID     *uint          `gorm:"column:reference_id;comment:关联业务ID" json:"reference_id,omitempty"`
+	ReferenceNo     *string        `gorm:"column:reference_no;type:varchar(50);comment:关联业务编号(充值单号CRCH…或订单号ORD…)" json:"reference_no,omitempty"`
 	Remark          *string        `gorm:"column:remark;type:text;comment:备注" json:"remark,omitempty"`
 	Metadata        *string        `gorm:"column:metadata;type:jsonb;comment:扩展信息(如套餐信息、支付方式等)" json:"metadata,omitempty"`
 	Creator         uint           `gorm:"column:creator;not null;comment:创建人ID" json:"creator"`
@@ -60,16 +60,16 @@ type CardWalletTransaction struct {
 }
 
 // TableName 指定表名
-func (CardWalletTransaction) TableName() string {
+func (AssetWalletTransaction) TableName() string {
-	return "tb_card_wallet_transaction"
+	return "tb_asset_wallet_transaction"
 }
 
-// CardRechargeRecord 卡充值记录模型
+// AssetRechargeRecord 资产充值记录模型
-// 记录所有卡充值操作
+// 记录所有资产钱包充值操作
-type CardRechargeRecord struct {
+type AssetRechargeRecord struct {
 	ID                   uint           `gorm:"column:id;primaryKey" json:"id"`
 	UserID               uint           `gorm:"column:user_id;not null;index;comment:操作人用户ID" json:"user_id"`
-	CardWalletID         uint           `gorm:"column:card_wallet_id;not null;comment:卡钱包ID" json:"card_wallet_id"`
+	AssetWalletID        uint           `gorm:"column:asset_wallet_id;not null;comment:资产钱包ID" json:"asset_wallet_id"`
 	ResourceType         string         `gorm:"column:resource_type;type:varchar(20);not null;index;comment:资源类型(冗余字段)" json:"resource_type"`
 	ResourceID           uint           `gorm:"column:resource_id;not null;index;comment:资源ID(冗余字段)" json:"resource_id"`
 	RechargeNo           string         `gorm:"column:recharge_no;type:varchar(50);not null;uniqueIndex;comment:充值订单号(格式:CRCH+时间戳+随机数)" json:"recharge_no"`
@@ -88,6 +88,6 @@ type CardRechargeRecord struct {
 }
 
 // TableName 指定表名
-func (CardRechargeRecord) TableName() string {
+func (AssetRechargeRecord) TableName() string {
-	return "tb_card_recharge_record"
+	return "tb_asset_recharge_record"
 }

internal/model/dto/asset_wallet_dto.go

@@ -0,0 +1,52 @@
+package dto
+
+import "time"
+
+// AssetWalletResponse 资产钱包概况响应
+type AssetWalletResponse struct {
+	WalletID         uint      `json:"wallet_id" description:"钱包数据库ID"`
+	ResourceType     string    `json:"resource_type" description:"资源类型：iot_card 或 device"`
+	ResourceID       uint      `json:"resource_id" description:"对应卡或设备的数据库ID"`
+	Balance          int64     `json:"balance" description:"总余额（分）"`
+	FrozenBalance    int64     `json:"frozen_balance" description:"冻结余额（分）"`
+	AvailableBalance int64     `json:"available_balance" description:"可用余额 = balance - frozen_balance（分）"`
+	Currency         string    `json:"currency" description:"币种，目前固定 CNY"`
+	Status           int       `json:"status" description:"钱包状态：1-正常 2-冻结 3-关闭"`
+	StatusText       string    `json:"status_text" description:"状态文本"`
+	CreatedAt        time.Time `json:"created_at" description:"创建时间（RFC3339）"`
+	UpdatedAt        time.Time `json:"updated_at" description:"更新时间（RFC3339）"`
+}
+
+// AssetWalletTransactionListRequest 资产钱包流水列表请求（路径参数 + 查询参数）
+type AssetWalletTransactionListRequest struct {
+	AssetType       string     `path:"asset_type" description:"资产类型：card 或 device" required:"true"`
+	ID              uint       `path:"id" description:"资产ID" required:"true"`
+	Page            int        `json:"page" query:"page" description:"页码，默认1"`
+	PageSize        int        `json:"page_size" query:"page_size" validate:"omitempty,min=1,max=100" description:"每页数量，默认20，最大100"`
+	TransactionType *string    `json:"transaction_type" query:"transaction_type" validate:"omitempty,oneof=recharge deduct refund" description:"交易类型过滤：recharge/deduct/refund"`
+	StartTime       *time.Time `json:"start_time" query:"start_time" description:"开始时间（RFC3339）"`
+	EndTime         *time.Time `json:"end_time" query:"end_time" description:"结束时间（RFC3339）"`
+}
+
+// AssetWalletTransactionItem 单条流水记录
+type AssetWalletTransactionItem struct {
+	ID                  uint      `json:"id" description:"流水记录ID"`
+	TransactionType     string    `json:"transaction_type" description:"交易类型：recharge/deduct/refund"`
+	TransactionTypeText string    `json:"transaction_type_text" description:"交易类型文本：充值/扣款/退款"`
+	Amount              int64     `json:"amount" description:"变动金额（分），充值为正数，扣款/退款为负数"`
+	BalanceBefore       int64     `json:"balance_before" description:"变动前余额（分）"`
+	BalanceAfter        int64     `json:"balance_after" description:"变动后余额（分）"`
+	ReferenceType       *string   `json:"reference_type,omitempty" description:"关联业务类型：recharge 或 order（可空）"`
+	ReferenceNo         *string   `json:"reference_no,omitempty" description:"关联业务编号：充值单号（CRCH…）或订单号（ORD…）（可空）"`
+	Remark              *string   `json:"remark,omitempty" description:"备注（可空）"`
+	CreatedAt           time.Time `json:"created_at" description:"流水创建时间（RFC3339）"`
+}
+
+// AssetWalletTransactionListResponse 资产钱包流水列表响应
+type AssetWalletTransactionListResponse struct {
+	List       []*AssetWalletTransactionItem `json:"list" description:"流水列表"`
+	Total      int64                         `json:"total" description:"总记录数"`
+	Page       int                           `json:"page" description:"当前页码"`
+	PageSize   int                           `json:"page_size" description:"每页数量"`
+	TotalPages int                           `json:"total_pages" description:"总页数"`
+}