137 lines
7.5 KiB
Go
137 lines
7.5 KiB
Go
package dto
|
||
|
||
import (
|
||
"assets/consts/stock"
|
||
|
||
"gitea.com/red-future/common/beans"
|
||
"github.com/gogf/gf/v2/frame/g"
|
||
"github.com/gogf/gf/v2/os/gtime"
|
||
"go.mongodb.org/mongo-driver/v2/bson"
|
||
)
|
||
|
||
// CreateLocationReq 创建库位请求
|
||
type CreateLocationReq struct {
|
||
g.Meta `path:"/createLocation" method:"post" tags:"库位管理" summary:"创建库位" dc:"创建新的库位"`
|
||
WarehouseId string `json:"warehouseId" v:"required" dc:"仓库ID"`
|
||
ZoneId string `json:"zoneId" v:"required" dc:"库区ID"`
|
||
LocationCode string `json:"locationCode" v:"required|max-length:50#库位编码不能为空|库位编码不能超过50个字符" dc:"库位编码"`
|
||
LocationName string `json:"locationName" v:"required|max-length:100#库位名称不能为空|库位名称不能超过100个字符" dc:"库位名称"`
|
||
LocationType stock.LocationType `json:"locationType" v:"required" dc:"库位类型"`
|
||
CapacityUnitType stock.CapacityUnitType `json:"capacityUnitType" v:"required" dc:"容量单位类型"`
|
||
CapacityUnit string `json:"capacityUnit" v:"required" dc:"容量单位（如箱、托盘）"`
|
||
MaxCapacity int `json:"maxCapacity" v:"required|min:1#最大容量不能为空|最大容量必须大于0" dc:"最大容量"`
|
||
Status *stock.LocationStatus `json:"status" dc:"库位状态（可选，默认空闲）"`
|
||
Remark string `json:"remark" dc:"备注"`
|
||
}
|
||
|
||
// CreateLocationRes 创建库位响应
|
||
type CreateLocationRes struct {
|
||
Id *bson.ObjectID `json:"id" dc:"库位ID"`
|
||
}
|
||
|
||
// UpdateLocationReq 更新库位请求
|
||
type UpdateLocationReq struct {
|
||
g.Meta `path:"/updateLocation" method:"put" tags:"库位管理" summary:"更新库位" dc:"更新库位信息"`
|
||
Id *bson.ObjectID `json:"id" v:"required" dc:"库位ID"`
|
||
WarehouseId string `json:"warehouseId" dc:"仓库ID"`
|
||
ZoneId string `json:"zoneId" dc:"库区ID"`
|
||
LocationCode string `json:"locationCode" dc:"库位编码"`
|
||
LocationName string `json:"locationName" dc:"库位名称"`
|
||
LocationType *stock.LocationType `json:"locationType" dc:"库位类型"`
|
||
CapacityUnitType *stock.CapacityUnitType `json:"capacityUnitType" dc:"容量单位类型"`
|
||
CapacityUnit string `json:"capacityUnit" dc:"容量单位"`
|
||
MaxCapacity *int `json:"maxCapacity" dc:"最大容量"`
|
||
Status *stock.LocationStatus `json:"status" dc:"库位状态"`
|
||
Remark string `json:"remark" dc:"备注"`
|
||
}
|
||
|
||
// UpdateLocationRes 更新库位响应
|
||
type UpdateLocationRes struct {
|
||
Id *bson.ObjectID `json:"id" dc:"库位ID"`
|
||
}
|
||
|
||
// DeleteLocationReq 删除库位请求
|
||
type DeleteLocationReq struct {
|
||
g.Meta `path:"/deleteLocation" method:"delete" tags:"库位管理" summary:"删除库位" dc:"删除库位"`
|
||
Id *bson.ObjectID `json:"id" v:"required" dc:"库位ID"`
|
||
}
|
||
|
||
// UpdateLocationStatusReq 更新库位状态请求
|
||
type UpdateLocationStatusReq struct {
|
||
g.Meta `path:"/updateLocationStatus" method:"put" tags:"库位管理" summary:"更新库位状态" dc:"单独更新库位状态（空闲/占用/锁定/维护）"`
|
||
Id *bson.ObjectID `json:"id" v:"required" dc:"库位ID"`
|
||
Status stock.LocationStatus `json:"status" v:"required|in:idle,occupied,locked,maintenance#状态不能为空|状态值无效" dc:"库位状态"`
|
||
}
|
||
|
||
// DeleteLocationRes 删除库位响应
|
||
type DeleteLocationRes struct {
|
||
Id *bson.ObjectID `json:"id" dc:"库位ID"`
|
||
}
|
||
|
||
// GetLocationReq 获取库位详情请求
|
||
type GetLocationReq struct {
|
||
g.Meta `path:"/getLocation" method:"get" tags:"库位管理" summary:"获取库位详情" dc:"获取库位详情"`
|
||
Id *bson.ObjectID `json:"id" v:"required" dc:"库位ID"`
|
||
}
|
||
|
||
// GetLocationRes 获取库位详情响应
|
||
type GetLocationRes struct {
|
||
Id *bson.ObjectID `json:"id" dc:"库位ID"`
|
||
WarehouseId *bson.ObjectID `json:"warehouseId" dc:"仓库ID"`
|
||
WarehouseName string `json:"warehouseName" dc:"仓库名称"`
|
||
ZoneId *bson.ObjectID `json:"zoneId" dc:"库区ID"`
|
||
ZoneName string `json:"zoneName" dc:"库区名称"`
|
||
LocationCode string `json:"locationCode" dc:"库位编码"`
|
||
LocationName string `json:"locationName" dc:"库位名称"`
|
||
LocationType stock.LocationType `json:"locationType" dc:"库位类型"`
|
||
LocationTypeText string `json:"locationTypeText" dc:"库位类型文本"`
|
||
MaxCapacity int `json:"maxCapacity" dc:"最大容量"`
|
||
CurrentCapacity int `json:"currentCapacity" dc:"当前容量"`
|
||
UsageRate float64 `json:"usageRate" dc:"使用率"`
|
||
Status stock.LocationStatus `json:"status" dc:"库位状态"`
|
||
StatusText string `json:"statusText" dc:"状态文本"`
|
||
Remark string `json:"remark" dc:"备注"`
|
||
CreatedAt *gtime.Time `json:"createdAt" dc:"创建时间"`
|
||
UpdatedAt *gtime.Time `json:"updatedAt" dc:"更新时间"`
|
||
}
|
||
|
||
// ListLocationReq 获取库位列表请求
|
||
type ListLocationReq struct {
|
||
g.Meta `path:"/listLocations" method:"get" tags:"库位管理" summary:"获取库位列表" dc:"分页查询库位列表"`
|
||
*beans.Page
|
||
OrderBy []beans.OrderBy `json:"orderBy" dc:"排序规则"`
|
||
WarehouseId string `json:"warehouseId" dc:"仓库ID（单个，兼容旧版）"`
|
||
WarehouseIds []string `json:"warehouseIds" dc:"仓库ID列表（批量查询）"`
|
||
ZoneId string `json:"zoneId" dc:"库区ID（单个，兼容旧版）"`
|
||
ZoneIds []string `json:"zoneIds" dc:"库区ID列表（批量查询）"`
|
||
LocationType *stock.LocationType `json:"locationType" dc:"库位类型"`
|
||
Status *stock.LocationStatus `json:"status" dc:"库位状态"`
|
||
Keyword string `json:"keyword" dc:"关键词搜索（编码/名称）"`
|
||
}
|
||
|
||
// ListLocationRes 获取库位列表响应
|
||
type ListLocationRes struct {
|
||
List []LocationListItem `json:"list" dc:"库位列表"`
|
||
Total int64 `json:"total" dc:"总数"`
|
||
}
|
||
|
||
// LocationListItem 库位列表项
|
||
type LocationListItem struct {
|
||
Id *bson.ObjectID `json:"id" dc:"库位ID"`
|
||
WarehouseId *bson.ObjectID `json:"warehouseId" dc:"仓库ID"`
|
||
WarehouseName string `json:"warehouseName" dc:"仓库名称"`
|
||
ZoneId *bson.ObjectID `json:"zoneId" dc:"库区ID"`
|
||
ZoneName string `json:"zoneName" dc:"库区名称"`
|
||
LocationCode string `json:"locationCode" dc:"库位编码"`
|
||
LocationName string `json:"locationName" dc:"库位名称"`
|
||
LocationType stock.LocationType `json:"locationType" dc:"库位类型"`
|
||
LocationTypeText string `json:"locationTypeText" dc:"库位类型文本"`
|
||
MaxCapacity int `json:"maxCapacity" dc:"最大容量"`
|
||
CurrentCapacity int `json:"currentCapacity" dc:"当前容量"`
|
||
UsageRate float64 `json:"usageRate" dc:"使用率"`
|
||
Status stock.LocationStatus `json:"status" dc:"库位状态"`
|
||
StatusText string `json:"statusText" dc:"状态文本"`
|
||
CreatedAt *gtime.Time `json:"createdAt" dc:"创建时间"`
|
||
UpdatedAt *gtime.Time `json:"updatedAt" dc:"更新时间"`
|
||
}
|