实现库存管理相关逻辑

internal/app/dto/inventory_converter.go

@@ -0,0 +1,66 @@
+package dto
+
+import (
+	"time"
+
+	"git.huangwc.com/pig/pig-farm-controller/internal/infra/models"
+)
+
+// ConvertCurrentStockToDTO 将原料及其最新库存日志转换为 CurrentStockResponse DTO
+func ConvertCurrentStockToDTO(material *models.RawMaterial, latestLog *models.RawMaterialStockLog) *CurrentStockResponse {
+	if material == nil {
+		return nil
+	}
+
+	stock := float32(0)
+	lastUpdated := material.CreatedAt.Format(time.RFC3339) // 默认使用创建时间
+
+	if latestLog != nil {
+		stock = latestLog.AfterQuantity
+		lastUpdated = latestLog.HappenedAt.Format(time.RFC3339)
+	}
+
+	return &CurrentStockResponse{
+		RawMaterialID:   material.ID,
+		RawMaterialName: material.Name,
+		Stock:           stock,
+		LastUpdated:     lastUpdated,
+	}
+}
+
+// ConvertStockLogToDTO 将 models.RawMaterialStockLog 转换为 StockLogResponse DTO
+func ConvertStockLogToDTO(log *models.RawMaterialStockLog) *StockLogResponse {
+	if log == nil {
+		return nil
+	}
+
+	return &StockLogResponse{
+		ID:              log.ID,
+		RawMaterialID:   log.RawMaterialID,
+		RawMaterialName: log.RawMaterial.Name, // 假设 RawMaterial 已被预加载
+		ChangeAmount:    log.ChangeAmount,
+		BeforeQuantity:  log.BeforeQuantity,
+		AfterQuantity:   log.AfterQuantity,
+		SourceType:      string(log.SourceType),
+		SourceID:        log.SourceID,
+		HappenedAt:      log.HappenedAt,
+		Remarks:         log.Remarks,
+	}
+}
+
+// ConvertStockLogListToDTO 将 []models.RawMaterialStockLog 转换为 ListStockLogResponse DTO
+func ConvertStockLogListToDTO(logs []models.RawMaterialStockLog, total int64, page, pageSize int) *ListStockLogResponse {
+	logDTOs := make([]StockLogResponse, len(logs))
+	for i, log := range logs {
+		logDTOs[i] = *ConvertStockLogToDTO(&log)
+	}
+
+	return &ListStockLogResponse{
+		List: logDTOs,
+		Pagination: PaginationDTO{
+			Page:     page,
+			PageSize: pageSize,
+			Total:    total,
+		},
+	}
+}

internal/app/dto/inventory_dto.go

@@ -0,0 +1,67 @@
+package dto
+
+import "time"
+
+// =============================================================================================================
+// 库存 (Inventory) 相关 DTO
+// =============================================================================================================
+
+// StockAdjustmentRequest 手动调整库存的请求体
+type StockAdjustmentRequest struct {
+	RawMaterialID uint32  `json:"raw_material_id" validate:"required"`    // 要调整的原料ID
+	ChangeAmount  float32 `json:"change_amount" validate:"required,ne=0"` // 变动数量, 正数为入库, 负数为出库, 单位: g
+	Remarks       string  `json:"remarks" validate:"max=255"`             // 备注
+}
+
+// CurrentStockResponse 单个原料及其当前库存的响应体
+type CurrentStockResponse struct {
+	RawMaterialID   uint32  `json:"raw_material_id"`   // 原料ID
+	RawMaterialName string  `json:"raw_material_name"` // 原料名称
+	Stock           float32 `json:"stock"`             // 当前库存量, 单位: g
+	LastUpdated     string  `json:"last_updated"`      // 最后更新时间
+}
+
+// ListCurrentStockRequest 定义了获取当前库存列表的请求参数
+type ListCurrentStockRequest struct {
+	Page            int     `json:"page" query:"page"`                           // 页码
+	PageSize        int     `json:"page_size" query:"page_size"`                 // 每页数量
+	RawMaterialName *string `json:"raw_material_name" query:"raw_material_name"` // 按原料名称模糊查询
+	OrderBy         string  `json:"order_by" query:"order_by"`                   // 排序字段, 例如 "stock DESC"
+}
+
+// ListCurrentStockResponse 是获取当前库存列表的响应结构
+type ListCurrentStockResponse struct {
+	List       []CurrentStockResponse `json:"list"`
+	Pagination PaginationDTO          `json:"pagination"`
+}
+
+// StockLogResponse 库存变动历史记录的响应体
+type StockLogResponse struct {
+	ID              uint32    `json:"id"`
+	RawMaterialID   uint32    `json:"raw_material_id"`
+	RawMaterialName string    `json:"raw_material_name"`
+	ChangeAmount    float32   `json:"change_amount"`
+	BeforeQuantity  float32   `json:"before_quantity"`
+	AfterQuantity   float32   `json:"after_quantity"`
+	SourceType      string    `json:"source_type"`
+	SourceID        *uint32   `json:"source_id,omitempty"`
+	HappenedAt      time.Time `json:"happened_at"`
+	Remarks         string    `json:"remarks"`
+}
+
+// ListStockLogRequest 定义了获取库存变动历史的请求参数
+type ListStockLogRequest struct {
+	Page          int      `json:"page" query:"page"`                       // 页码
+	PageSize      int      `json:"page_size" query:"page_size"`             // 每页数量
+	RawMaterialID *uint32  `json:"raw_material_id" query:"raw_material_id"` // 按原料ID精确查询
+	SourceTypes   []string `json:"source_types" query:"source_types"`       // 按来源类型查询
+	StartTime     *string  `json:"start_time" query:"start_time"`           // 开始时间 (RFC3339格式, e.g., "2023-01-01T00:00:00Z")
+	EndTime       *string  `json:"end_time" query:"end_time"`               // 结束时间 (RFC3339格式)
+	OrderBy       string   `json:"order_by" query:"order_by"`               // 排序字段
+}
+
+// ListStockLogResponse 是获取库存变动历史列表的响应结构
+type ListStockLogResponse struct {
+	List       []StockLogResponse `json:"list"`
+	Pagination PaginationDTO      `json:"pagination"`
+}