wangjia
c1ed81dfab
后端 - 新增 shop handler：GET/PUT /shop/info（管理员权限） - 新增 finance CloseByRef：按单据 ref_type+ref_id 结清账款 - 新增 inventory UpdateRemark：PUT /inventory/:id/remark - 入库/出库审批自动生成财务应付/应收记录（去除金额>0限制） - 种子数据 S001-S003 补充真实门店信息 前端 - 设置页新增「酒行信息」Tab，管理员可编辑门店名称/地址/电话/负责人 - 入库单列表新增结清按钮（含确认弹窗），出库单同步 - 入库表单：规格、系列、生产日期、供应商、商品名称改为提交必填 - 入库/出库列表新增入库时间、出库时间、创建时间列 - 商品标签标题改为读取 shop 表门店名，扫码文案改为「扫码溯源 · TRACE」 - 标签页脚显示门店地址和电话（从 API 读取，不再依赖编译时 dart-define） - 库存备注支持点击编辑，超4字截断显示+Hover展示全文 - ApiClient 新增 patch() 方法（已改用 PUT 规避 CORS） 文档 - 新增 docs/user-manual.md 完整用户操作手册（12章） Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
160 lines
7.7 KiB
Go
160 lines
7.7 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"`
|
|
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"`
|
|
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"`
|
|
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"`
|
|
Quantity float64 `gorm:"type:decimal(12,3);not null" json:"quantity"`
|
|
UnitPrice float64 `gorm:"type:decimal(16,2);default:0" json:"unit_price"`
|
|
TotalPrice float64 `gorm:"type:decimal(16,2);default:0" json:"total_price"`
|
|
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"`
|
|
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"`
|
|
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"`
|
|
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"`
|
|
Quantity float64 `gorm:"type:decimal(12,3);not null" json:"quantity"`
|
|
UnitPrice float64 `gorm:"type:decimal(16,2);default:0" json:"unit_price"`
|
|
TotalPrice float64 `gorm:"type:decimal(16,2);default:0" json:"total_price"`
|
|
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"`
|
|
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"`
|
|
}
|