wangjia
4fd0bb8b83
- 字段重命名（旧列弃用保留，启动幂等回填 BackfillPricingColumns）： 入库 unit_price/total_price/total_amount → cost_price/cost_amount/cost_total； 出库同前缀 + 新增 sale_amount（售价小计）/ sale_total（应收）/ profit_total（总利润） - 建单落三值；确认售价联动重算 sale_amount/sale_total/profit_total； 确认进价回填成本后联动重算受影响出库单利润（recalcStockOutProfit） - 出库 List/Get 对 operator/readonly 抹零成本与利润（stripStockOutCost 服务端兜底） - 兼容一版：Create/Update 接受旧 key unit_price 回落（v1.0.87 及之前客户端） - SUM 聚合/价格趋势/导入/种子工具同步切新列；测试全量改名 + 6 个新回归 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01JJ1g8XV1YhhmHRzhwWEW7o
206 lines
11 KiB
Go
206 lines
11 KiB
Go
package model
|
||
|
||
import "time"
|
||
|
||
// -------- 入库单 --------
|
||
|
||
type StockInOrder struct {
|
||
TenantBase
|
||
OrderNo string `gorm:"size:50;uniqueIndex:uk_shop_order_no" json:"order_no"`
|
||
Type string `gorm:"size:30;default:'purchase'" json:"type"`
|
||
WarehouseID uint64 `gorm:"not null" json:"warehouse_id" binding:"required,min=1"`
|
||
PartnerID *uint64 `json:"partner_id"`
|
||
OperatorID uint64 `gorm:"not null" json:"operator_id"`
|
||
CreatorID *uint64 `json:"creator_id"`
|
||
ReviewerID *uint64 `json:"reviewer_id"`
|
||
Status string `gorm:"type:enum('draft','pending','approved','rejected');default:'draft'" json:"status"`
|
||
OrderDate Date `gorm:"type:date" json:"order_date"`
|
||
// 应付合计 = Σ 明细总进价（2026-07 定价字段消歧：旧列 total_amount 弃用，启动回填）
|
||
CostTotal float64 `gorm:"column:cost_total;type:decimal(16,2);default:0" json:"cost_total"`
|
||
ReviewedAt *time.Time `json:"reviewed_at"`
|
||
// 退单状态：none=无 / partial=部分退单 / full=已全退（仅 approved 单可退）
|
||
ReturnState string `gorm:"size:20;default:'none'" json:"return_state"`
|
||
CustomFields JSON `gorm:"type:json" json:"custom_fields,omitempty"`
|
||
Remark string `gorm:"size:500" json:"remark"`
|
||
|
||
Items []StockInItem `gorm:"foreignKey:OrderID" json:"items,omitempty"`
|
||
Warehouse *Warehouse `gorm:"foreignKey:WarehouseID" json:"warehouse,omitempty"`
|
||
Partner *Partner `gorm:"foreignKey:PartnerID" json:"partner,omitempty"`
|
||
Operator *User `gorm:"foreignKey:OperatorID" json:"operator,omitempty"`
|
||
Creator *User `gorm:"foreignKey:CreatorID" json:"creator,omitempty"`
|
||
Reviewer *User `gorm:"foreignKey:ReviewerID" json:"reviewer,omitempty"`
|
||
}
|
||
|
||
type StockInItem struct {
|
||
Base
|
||
OrderID uint64 `gorm:"not null;index" json:"order_id"`
|
||
ShopID uint64 `gorm:"not null" json:"shop_id"`
|
||
ProductID uint64 `gorm:"not null" json:"product_id"`
|
||
// 历史导入快照列：源明细自带的商品信息，不依赖 product 主数据（product_id 可为 0）。
|
||
ProductCode string `gorm:"size:50" json:"product_code"`
|
||
ProductName string `gorm:"size:255" json:"product_name"`
|
||
Series string `gorm:"size:100" json:"series"`
|
||
Spec string `gorm:"size:100" json:"spec"`
|
||
Quantity float64 `gorm:"type:decimal(12,3);not null" json:"quantity"`
|
||
// 进价（单瓶成本）。2026-07 定价字段消歧：unit_price → cost_price（旧列弃用，启动回填）
|
||
CostPrice float64 `gorm:"column:cost_price;type:decimal(16,2);default:0" json:"cost_price"`
|
||
// 兼容一版：旧客户端(≤1.0.87)建单仍发 unit_price，入参回落到 CostPrice（不落库不出参）
|
||
LegacyUnitPrice *float64 `gorm:"-" json:"unit_price,omitempty"`
|
||
// 参考售价：仅用于入库建产品时写入 product.SalePrice，不落 stock_in_items 表（gorm:"-"）。
|
||
SalePrice float64 `gorm:"-" json:"sale_price"`
|
||
// 总进价 = quantity × cost_price（旧列 total_price 弃用）
|
||
CostAmount float64 `gorm:"column:cost_amount;type:decimal(16,2);default:0" json:"cost_amount"`
|
||
// 已退数量：0=未退，=Quantity 表示整行已退单（整行退，不做部分数量）
|
||
ReturnedQuantity float64 `gorm:"type:decimal(12,3);default:0" json:"returned_quantity"`
|
||
BatchNo string `gorm:"size:50" json:"batch_no"`
|
||
ProductionDate *Date `gorm:"type:date" json:"production_date"`
|
||
CustomFields JSON `gorm:"type:json" json:"custom_fields,omitempty"`
|
||
Remark string `gorm:"size:255" json:"remark"`
|
||
|
||
Product *Product `gorm:"foreignKey:ProductID" json:"product,omitempty"`
|
||
Order *StockInOrder `gorm:"foreignKey:OrderID" json:"order,omitempty"`
|
||
}
|
||
|
||
// -------- 出库单 --------
|
||
|
||
type StockOutOrder struct {
|
||
TenantBase
|
||
OrderNo string `gorm:"size:50;uniqueIndex:uk_shop_order_no" json:"order_no"`
|
||
Type string `gorm:"size:30;default:'sale'" json:"type"`
|
||
WarehouseID uint64 `gorm:"not null" json:"warehouse_id" binding:"required,min=1"`
|
||
PartnerID *uint64 `json:"partner_id"`
|
||
OperatorID uint64 `gorm:"not null" json:"operator_id"`
|
||
CreatorID *uint64 `json:"creator_id"`
|
||
ReviewerID *uint64 `json:"reviewer_id"`
|
||
Status string `gorm:"type:enum('draft','pending','approved','rejected');default:'draft'" json:"status"`
|
||
OrderDate Date `gorm:"type:date" json:"order_date"`
|
||
// 应收合计 = Σ 明细售价小计（2026-07 定价字段消歧：旧列 total_amount 弃用，启动回填）
|
||
SaleTotal float64 `gorm:"column:sale_total;type:decimal(16,2);default:0" json:"sale_total"`
|
||
// 总利润 = Σ(sale_price>0 ? (sale_price-cost_price)×qty : 0)，建单落库，
|
||
// 确认售价 / 确认进价（成本回填）时联动重算
|
||
ProfitTotal float64 `gorm:"column:profit_total;type:decimal(16,2);default:0" json:"profit_total"`
|
||
ReviewedAt *time.Time `json:"reviewed_at"`
|
||
// 退单状态：none / partial / full
|
||
ReturnState string `gorm:"size:20;default:'none'" json:"return_state"`
|
||
CustomFields JSON `gorm:"type:json" json:"custom_fields,omitempty"`
|
||
Remark string `gorm:"size:500" json:"remark"`
|
||
|
||
Items []StockOutItem `gorm:"foreignKey:OrderID" json:"items,omitempty"`
|
||
Warehouse *Warehouse `gorm:"foreignKey:WarehouseID" json:"warehouse,omitempty"`
|
||
Partner *Partner `gorm:"foreignKey:PartnerID" json:"partner,omitempty"`
|
||
Operator *User `gorm:"foreignKey:OperatorID" json:"operator,omitempty"`
|
||
Creator *User `gorm:"foreignKey:CreatorID" json:"creator,omitempty"`
|
||
Reviewer *User `gorm:"foreignKey:ReviewerID" json:"reviewer,omitempty"`
|
||
}
|
||
|
||
type StockOutItem struct {
|
||
Base
|
||
OrderID uint64 `gorm:"not null;index" json:"order_id"`
|
||
ShopID uint64 `gorm:"not null" json:"shop_id"`
|
||
ProductID uint64 `gorm:"not null" json:"product_id"`
|
||
// 历史导入快照列：源明细自带的商品信息，不依赖 product 主数据（product_id 可为 0）。
|
||
ProductCode string `gorm:"size:50" json:"product_code"`
|
||
ProductName string `gorm:"size:255" json:"product_name"`
|
||
Series string `gorm:"size:100" json:"series"`
|
||
Spec string `gorm:"size:100" json:"spec"`
|
||
Quantity float64 `gorm:"type:decimal(12,3);not null" json:"quantity"`
|
||
// 成本单价（入库成本快照）。2026-07 消歧：unit_price → cost_price（旧列弃用）
|
||
CostPrice float64 `gorm:"column:cost_price;type:decimal(16,2);default:0" json:"cost_price"`
|
||
// 兼容一版：旧客户端(≤1.0.87)建单仍发 unit_price，入参回落到 CostPrice（不落库不出参）
|
||
LegacyUnitPrice *float64 `gorm:"-" json:"unit_price,omitempty"`
|
||
// 售价：出库实际销售单价（可编辑），应收账款按 售价×数量 计；与 CostPrice(入库成本) 区分
|
||
SalePrice float64 `gorm:"type:decimal(16,2);default:0" json:"sale_price"`
|
||
// 成本小计 = quantity × cost_price（旧列 total_price 弃用）
|
||
CostAmount float64 `gorm:"column:cost_amount;type:decimal(16,2);default:0" json:"cost_amount"`
|
||
// 售价小计 = quantity × sale_price（待定价=0；确认售价时重算）
|
||
SaleAmount float64 `gorm:"column:sale_amount;type:decimal(16,2);default:0" json:"sale_amount"`
|
||
// 已退数量：0=未退，=Quantity 表示整行已退单
|
||
ReturnedQuantity float64 `gorm:"type:decimal(12,3);default:0" json:"returned_quantity"`
|
||
BatchNo string `gorm:"size:50" json:"batch_no"`
|
||
ProductionDate *Date `gorm:"type:date" json:"production_date"`
|
||
CustomFields JSON `gorm:"type:json" json:"custom_fields,omitempty"`
|
||
Remark string `gorm:"size:255" json:"remark"`
|
||
|
||
Product *Product `gorm:"foreignKey:ProductID" json:"product,omitempty"`
|
||
}
|
||
|
||
// -------- 实时库存（批次模式：每条记录代表一个批次/批次） --------
|
||
|
||
type Inventory struct {
|
||
ID uint64 `gorm:"primaryKey;autoIncrement" json:"id"`
|
||
ShopID uint64 `gorm:"not null" json:"shop_id"`
|
||
WarehouseID *uint64 `json:"warehouse_id"`
|
||
ProductID *uint64 `json:"product_id"`
|
||
StockInItemID *uint64 `json:"stock_in_item_id"`
|
||
InventoryCheckID *uint64 `json:"inventory_check_id"`
|
||
Quantity float64 `gorm:"type:decimal(12,3);not null;default:0" json:"quantity"`
|
||
// Snapshot fields: copied from product/warehouse/stock-in at approval time.
|
||
// They reflect the state at the moment of stock-in and are NOT updated when the
|
||
// referenced product or warehouse record is later modified.
|
||
ProductCode string `gorm:"size:50" json:"product_code"`
|
||
ProductName string `gorm:"size:200" json:"product_name"`
|
||
Series string `gorm:"size:100" json:"series"`
|
||
Spec string `gorm:"size:100" json:"spec"`
|
||
Unit string `gorm:"size:20" json:"unit"`
|
||
WarehouseName string `gorm:"size:100" json:"warehouse_name"`
|
||
UnitPrice *float64 `gorm:"type:decimal(16,2)" json:"unit_price"`
|
||
ProductionDate *Date `gorm:"type:date" json:"production_date"`
|
||
BatchNo string `gorm:"size:50" json:"batch_no"`
|
||
SupplierName string `gorm:"size:200" json:"supplier_name"`
|
||
Remark string `gorm:"size:500" json:"remark"`
|
||
CreatedAt time.Time `json:"created_at"`
|
||
UpdatedAt time.Time `json:"updated_at"`
|
||
DeletedAt *time.Time `gorm:"index" json:"-"`
|
||
|
||
StockInItem *StockInItem `gorm:"foreignKey:StockInItemID" json:"stock_in_item,omitempty"`
|
||
Product *Product `gorm:"foreignKey:ProductID" json:"product,omitempty"`
|
||
Warehouse *Warehouse `gorm:"foreignKey:WarehouseID" json:"warehouse,omitempty"`
|
||
}
|
||
|
||
// -------- 库存流水 --------
|
||
|
||
type InventoryLog struct {
|
||
ID uint64 `gorm:"primaryKey;autoIncrement" json:"id"`
|
||
ShopID uint64 `gorm:"not null;index:idx_shop_product" json:"shop_id"`
|
||
WarehouseID uint64 `gorm:"not null" json:"warehouse_id"`
|
||
ProductID uint64 `gorm:"not null;index:idx_shop_product" json:"product_id"`
|
||
Direction string `gorm:"type:enum('in','out')" json:"direction"`
|
||
Quantity float64 `gorm:"type:decimal(12,3)" json:"quantity"`
|
||
QtyBefore float64 `gorm:"type:decimal(12,3)" json:"qty_before"`
|
||
QtyAfter float64 `gorm:"type:decimal(12,3)" json:"qty_after"`
|
||
RefType string `gorm:"size:30" json:"ref_type"`
|
||
RefID uint64 `json:"ref_id"`
|
||
OperatorID *uint64 `json:"operator_id"`
|
||
CreatedAt time.Time `json:"created_at"`
|
||
|
||
Product *Product `gorm:"foreignKey:ProductID" json:"product,omitempty"`
|
||
Warehouse *Warehouse `gorm:"foreignKey:WarehouseID" json:"warehouse,omitempty"`
|
||
}
|
||
|
||
// -------- 库存盘点 --------
|
||
|
||
type InventoryCheck struct {
|
||
TenantBase
|
||
CheckNo string `gorm:"size:50;uniqueIndex:uk_shop_check_no" json:"check_no"`
|
||
WarehouseID uint64 `gorm:"not null" json:"warehouse_id"`
|
||
OperatorID uint64 `gorm:"not null" json:"operator_id"`
|
||
Status string `gorm:"type:enum('draft','completed');default:'draft'" json:"status"`
|
||
CheckDate Date `gorm:"type:date" json:"check_date"`
|
||
Remark string `gorm:"size:500" json:"remark"`
|
||
|
||
Items []InventoryCheckItem `gorm:"foreignKey:CheckID" json:"items,omitempty"`
|
||
}
|
||
|
||
type InventoryCheckItem struct {
|
||
Base
|
||
CheckID uint64 `gorm:"not null;index" json:"check_id"`
|
||
ShopID uint64 `gorm:"not null" json:"shop_id"`
|
||
ProductID uint64 `gorm:"not null" json:"product_id"`
|
||
SystemQty float64 `gorm:"type:decimal(12,3)" json:"system_qty"`
|
||
ActualQty float64 `gorm:"type:decimal(12,3)" json:"actual_qty"`
|
||
DiffQty float64 `gorm:"->" json:"diff_qty"` // generated column，只读
|
||
Remark string `gorm:"size:255" json:"remark"`
|
||
|
||
Product *Product `gorm:"foreignKey:ProductID" json:"product,omitempty"`
|
||
}
|