181 lines
8.0 KiB
Go
181 lines
8.0 KiB
Go
|
package dto
|
|||
|
|
|
|||
|
|
import (
|
|||
|
|
knapsackConsts "shop-user-trade/consts/knapsack"
|
|||
|
|
"shop-user-trade/model/config"
|
|||
|
|
|
|||
|
|
"gitea.com/red-future/common/beans"
|
|||
|
|
"github.com/gogf/gf/v2/frame/g"
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
// CreateKnapsackReq 创建背包项请求
|
|||
|
|
type CreateKnapsackReq struct {
|
|||
|
|
g.Meta `path:"/createKnapsack" method:"post" tags:"背包管理" summary:"创建背包项" dc:"创建新的背包项"`
|
|||
|
|
|
|||
|
|
UserID int64 `json:"userId" v:"required" dc:"用户ID"`
|
|||
|
|
AssetID int64 `json:"assetId" v:"required" dc:"资产ID"`
|
|||
|
|
AssetName string `json:"assetName" v:"required" dc:"资产名称"`
|
|||
|
|
SkuID int64 `json:"skuId,omitempty" dc:"SKU ID"`
|
|||
|
|
SkuName string `json:"skuName,omitempty" dc:"SKU名称"`
|
|||
|
|
SpecValues map[string]interface{} `json:"specValues,omitempty" dc:"规格值"`
|
|||
|
|
ImageURL string `json:"imageUrl" dc:"资产图片URL"`
|
|||
|
|
Type knapsackConsts.KnapsackAssetType `json:"type" v:"required" dc:"资产类型"`
|
|||
|
|
StockDetailID int64 `json:"stockDetailId,omitempty" dc:"库存明细ID（明细模式）"`
|
|||
|
|
BatchID int64 `json:"batchId,omitempty" dc:"批次ID（批次模式）"`
|
|||
|
|
BatchNo string `json:"batchNo,omitempty" dc:"批次号（批次模式）"`
|
|||
|
|
StockMode int `json:"stockMode" v:"required" dc:"库存管理模式：1-明细模式，2-批次模式"`
|
|||
|
|
ExpireAt *int64 `json:"expireAt,omitempty" dc:"过期时间（时间戳）"`
|
|||
|
|
PhysicalAssetConfig *config.PhysicalKnapsackConfig `json:"physicalAssetConfig,omitempty" dc:"实物资产配置"`
|
|||
|
|
ServiceAssetConfig *config.ServiceKnapsackConfig `json:"serviceAssetConfig,omitempty" dc:"服务资产配置"`
|
|||
|
|
VirtualAssetConfig *config.VirtualKnapsackConfig `json:"virtualAssetConfig,omitempty" dc:"虚拟资产配置"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// GetKnapsackReq 获取背包项请求
|
|||
|
|
type GetKnapsackReq struct {
|
|||
|
|
g.Meta `path:"/getKnapsack" method:"get" tags:"背包管理" summary:"获取背包项" dc:"获取背包项详情"`
|
|||
|
|
|
|||
|
|
Id int64 `json:"id" v:"required" dc:"背包项ID"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// UpdateKnapsackReq 更新背包项请求（内部使用）
|
|||
|
|
type UpdateKnapsackReq struct {
|
|||
|
|
Id int64 `json:"id" v:"required" dc:"背包项ID"`
|
|||
|
|
Status *knapsackConsts.KnapsackStatus `json:"status,omitempty" dc:"状态"`
|
|||
|
|
UsedAt *int64 `json:"usedAt,omitempty" dc:"使用时间"`
|
|||
|
|
Updater string `json:"updater,omitempty" dc:"更新者"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// DeleteKnapsackReq 删除背包项请求
|
|||
|
|
type DeleteKnapsackReq struct {
|
|||
|
|
g.Meta `path:"/deleteKnapsack" method:"delete" tags:"背包管理" summary:"删除背包项" dc:"删除背包项"`
|
|||
|
|
|
|||
|
|
Id int64 `json:"id" v:"required" dc:"背包项ID"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ListKnapsackReq 获取背包列表请求
|
|||
|
|
type ListKnapsackReq struct {
|
|||
|
|
g.Meta `path:"/listKnapsack" method:"get" tags:"背包管理" summary:"获取背包列表" dc:"分页查询背包列表，支持多条件筛选"`
|
|||
|
|
*beans.Page
|
|||
|
|
|
|||
|
|
UserID int64 `json:"userId,omitempty" dc:"用户ID"`
|
|||
|
|
Status *int `json:"status,omitempty" dc:"状态"`
|
|||
|
|
Type string `json:"type,omitempty" dc:"资产类型"`
|
|||
|
|
Keyword string `json:"keyword,omitempty" dc:"关键词搜索"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// UseKnapsackReq 使用背包项请求
|
|||
|
|
type UseKnapsackReq struct {
|
|||
|
|
g.Meta `path:"/useKnapsack" method:"post" tags:"背包管理" summary:"使用背包项" dc:"手动使用背包中的物品"`
|
|||
|
|
|
|||
|
|
ID int64 `json:"id" v:"required" dc:"背包项ID"`
|
|||
|
|
OperatorID int64 `json:"operatorId" v:"required" dc:"操作者ID"`
|
|||
|
|
OperatorName string `json:"operatorName" v:"required" dc:"操作者名称"`
|
|||
|
|
Reason string `json:"reason,omitempty" dc:"使用原因"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ListToMarketReq 上架背包项请求
|
|||
|
|
type ListToMarketReq struct {
|
|||
|
|
g.Meta `path:"/listToMarket" method:"post" tags:"背包管理" summary:"上架到市场" dc:"将背包项上架到市场"`
|
|||
|
|
|
|||
|
|
ID int64 `json:"id" v:"required" dc:"背包项ID"`
|
|||
|
|
OperatorID int64 `json:"operatorId" v:"required" dc:"操作者ID"`
|
|||
|
|
OperatorName string `json:"operatorName" v:"required" dc:"操作者名称"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// UnlistKnapsackReq 下架背包项请求
|
|||
|
|
type UnlistKnapsackReq struct {
|
|||
|
|
g.Meta `path:"/unlistKnapsack" method:"post" tags:"背包管理" summary:"从市场下架" dc:"将背包项从市场下架"`
|
|||
|
|
|
|||
|
|
ID int64 `json:"id" v:"required" dc:"背包项ID"`
|
|||
|
|
OperatorID int64 `json:"operatorId" v:"required" dc:"操作者ID"`
|
|||
|
|
OperatorName string `json:"operatorName" v:"required" dc:"操作者名称"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// VerifyKnapsackReq 核销背包项请求
|
|||
|
|
type VerifyKnapsackReq struct {
|
|||
|
|
g.Meta `path:"/verifyKnapsack" method:"post" tags:"背包管理" summary:"核销背包项" dc:"核销背包中的物品"`
|
|||
|
|
|
|||
|
|
ID int64 `json:"id" v:"required" dc:"背包项ID"`
|
|||
|
|
OperatorID int64 `json:"operatorId" v:"required" dc:"操作者ID"`
|
|||
|
|
OperatorName string `json:"operatorName" v:"required" dc:"操作者名称"`
|
|||
|
|
VerifyLocation string `json:"verifyLocation,omitempty" dc:"核销位置"`
|
|||
|
|
VerifyDevice string `json:"verifyDevice,omitempty" dc:"核销设备"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// GenerateQRCodeReq 生成二维码请求
|
|||
|
|
type GenerateQRCodeReq struct {
|
|||
|
|
g.Meta `path:"/generateQRCode" method:"post" tags:"背包管理" summary:"生成核销二维码" dc:"生成用于核销的二维码"`
|
|||
|
|
|
|||
|
|
ID int64 `json:"id" v:"required" dc:"背包项ID"`
|
|||
|
|
ExpireDuration int64 `json:"expireDuration" v:"required" dc:"过期时长（秒）"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ========== 响应 ==========
|
|||
|
|
|
|||
|
|
// CreateKnapsackRes 创建背包项响应
|
|||
|
|
type CreateKnapsackRes struct {
|
|||
|
|
ID int64 `json:"id" dc:"背包项ID"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// GetKnapsackRes 获取背包项响应
|
|||
|
|
type GetKnapsackRes struct {
|
|||
|
|
*KnapsackItem
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ListKnapsackRes 获取背包列表响应
|
|||
|
|
type ListKnapsackRes struct {
|
|||
|
|
List []*KnapsackItem `json:"list" dc:"背包列表"`
|
|||
|
|
Total int `json:"total" dc:"总数"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// UseKnapsackRes 使用背包项响应
|
|||
|
|
type UseKnapsackRes struct {
|
|||
|
|
Success bool `json:"success"`
|
|||
|
|
Message string `json:"message"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ListToMarketRes 上架背包项响应
|
|||
|
|
type ListToMarketRes struct {
|
|||
|
|
Success bool `json:"success"`
|
|||
|
|
Message string `json:"message"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// UnlistKnapsackRes 下架背包项响应
|
|||
|
|
type UnlistKnapsackRes struct {
|
|||
|
|
Success bool `json:"success"`
|
|||
|
|
Message string `json:"message"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// VerifyKnapsackRes 核销背包项响应
|
|||
|
|
type VerifyKnapsackRes struct {
|
|||
|
|
Success bool `json:"success"`
|
|||
|
|
Message string `json:"message"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// GenerateQRCodeRes 生成二维码响应
|
|||
|
|
type GenerateQRCodeRes struct {
|
|||
|
|
QRCode string `json:"qrCode,omitempty"`
|
|||
|
|
VerifyCode string `json:"verifyCode,omitempty"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// KnapsackItem 背包项视图
|
|||
|
|
type KnapsackItem struct {
|
|||
|
|
ID int64 `json:"id" dc:"背包项ID"`
|
|||
|
|
UserID int64 `json:"userId" dc:"用户ID"`
|
|||
|
|
AssetID int64 `json:"assetId" dc:"资产ID"`
|
|||
|
|
AssetName string `json:"assetName" dc:"资产名称"`
|
|||
|
|
SkuID int64 `json:"skuId,omitempty" dc:"SKU ID"`
|
|||
|
|
SkuName string `json:"skuName,omitempty" dc:"SKU名称"`
|
|||
|
|
ImageURL string `json:"imageUrl" dc:"资产图片URL"`
|
|||
|
|
Type knapsackConsts.KnapsackAssetType `json:"type" dc:"资产类型"`
|
|||
|
|
Status knapsackConsts.KnapsackStatus `json:"status" dc:"状态"`
|
|||
|
|
ExpireAt *int64 `json:"expireAt,omitempty" dc:"过期时间"`
|
|||
|
|
// 库存相关字段
|
|||
|
|
StockDetailID int64 `json:"stockDetailId,omitempty" dc:"库存明细ID"`
|
|||
|
|
BatchID int64 `json:"batchId,omitempty" dc:"批次ID"`
|
|||
|
|
BatchNo string `json:"batchNo,omitempty" dc:"批次号"`
|
|||
|
|
StockMode int `json:"stockMode" dc:"库存管理模式"`
|
|||
|
|
CreatedAt string `json:"createdAt" dc:"创建时间"`
|
|||
|
|
UpdatedAt string `json:"updatedAt" dc:"更新时间"`
|
|||
|
|
}
|