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

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

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
This commit is contained in:
2026-03-16 15:43:11 +08:00
parent 4156bfc9dd
commit b6c379265d
2 changed files with 71 additions and 19 deletions

View File

@@ -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:"总页数"`
}