wangjia/jiu
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases 130 Wiki Activity

feat(backend): 出入库定价字段消歧 + 总利润落库 + 成本仅管理员可见

Browse Source 
- 字段重命名（旧列弃用保留，启动幂等回填 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
This commit is contained in:
wangjia
2026-07-03 12:44:22 +08:00
parent 607b8aa763
commit 4fd0bb8b83
24 changed files with 601 additions and 135 deletions
Download Patch File Download Diff File Expand all files Collapse all files
backend/internal/model/stock.go
+32 -17
View File
@@ -13,10 +13,11 @@ type StockInOrder struct {
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"`
TotalAmount float64 `gorm:"type:decimal(16,2);default:0" json:"total_amount"`
ReviewedAt *time.Time `json:"reviewed_at"`
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"`
@@ -40,11 +41,15 @@ type StockInItem struct {
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"`
UnitPrice float64 `gorm:"type:decimal(16,2);default:0" json:"unit_price"`
// 建议售价：仅用于入库建产品时写入 product.SalePrice，不落 stock_in_items 表（gorm:"-"）。
SalePrice float64 `gorm:"-" json:"sale_price"`
TotalPrice float64 `gorm:"type:decimal(16,2);default:0" json:"total_price"`
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"`
@@ -67,9 +72,13 @@ type StockOutOrder struct {
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"`
TotalAmount float64 `gorm:"type:decimal(16,2);default:0" json:"total_amount"`
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"`
@@ -94,11 +103,17 @@ type StockOutItem struct {
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"`
UnitPrice float64 `gorm:"type:decimal(16,2);default:0" json:"unit_price"`
// 售价：出库实际销售单价（可编辑），应收账款按 售价×数量 计；与 UnitPrice(入库成本) 区分
SalePrice float64 `gorm:"type:decimal(16,2);default:0" json:"sale_price"`
TotalPrice float64 `gorm:"type:decimal(16,2);default:0" json:"total_price"`
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"`