一、MES — 叫料单扩展(schema + 逻辑) material_request 新增字段:packageNo(叫料包号,一次提交=一包)、callDate(叫料日,默认当天)、planBreakdown(jsonb,工单×排产日明细 []CallPlanBreakdown);targetDock 语义降级为"期望接驳台(可空,配送时 WMS 确定实际台)"。 新增 internal/logic/call_plan.go:实时计算「叫料需求明细(工单×排产日×物料)」,派生两类提示(当日剩余未叫 / 跨日量明细),不落库、不拦提交;接驳台空台校验 EnsureStationDocksEmpty、托盘回库 DispatchPalletReturnManual、人工清台 ClearDockLedger、配送单派车 DispatchDeliveryAgv、工位物料明细 StationMaterialDetail。 新增 internal/handler/production/call_pkg.go:8 个 MES 内部端点(X-API-TOKEN 网关),供 WMS 调用——叫料需求明细、按包查单、接驳台状态、托盘回库、人工清台、配送单派车、叫料池原始行、工位物料明细、WMS 代叫料。 internal/handler/production/call.go、internal/logic/call.go、agv.go、qty_report.go、routes_production.go、wmsclient/client.go、db.go 同步接入上述逻辑。 二、WMS — 配送单(新功能,叫料与送料彻底拆开) 新增 schema/delivery_order.go + delivery_order_item.go 及 ent 生成代码:delivery_order(PENDING→DISPATCHED→DONE / CANCELLED,一单=一次托盘配送)、delivery_order_item(配送物料明细快照:工单/工艺/排产日)。 新增 internal/handler/delivery.go + 路由 + DeliveryOrders.vue 页面(仓储作业 → 配送单)。 mesclient/client.go 扩展:MES 叫料单结构补 packageNo/callDate/workOrderNo/planBreakdown,新增 PoolRow/DockPalletState/DeliveryAgvItem/getJSON 等。 CallQueue.vue:按叫料包展示,新增「代叫料」「建配送单」按钮与对话框;出库单回写所属配送单号(outbound_order 加字段);AGV 派送改由配送单驱动。 三、工位终端 — 叫料体验升级 MaterialPanel.vue:新增「本工位物料明细」卡(工艺物料全集×工位账四数,量为 0 也显示);叫料改为「叫料包」模式(默认当天、可勾选分批、可选其他排产日、期望接驳台可空),新增叫料日选择器、两条提示横幅(当日剩余未叫 / 跨日量明细)、托盘回库按钮。 InspectPanel.vue/Main.vue/OnlinePanel.vue/OfflinePanel.vue/WorkPanel.vue/SyncQueueDialog.vue/api/index.js/internal/handler/line.go/routes.go 同步接入接驳台状态、托盘回库、下班双台空台校验等。 web/static/index.html 构建刷新。 四、文档 案例.md:重写第 5/6/8/9 节与新「配送单」流程,补「模拟模式跳过接驳台校验」说明,库管员菜单加「配送单」;并修正"本单箱体"等措辞歧义。 客户问题.md:同步本轮拍板口径。 五、构建产物 / 同步 多个 MES 前端页面(.vue)随本次改动统一重新构建刷新;ent 生成代码(MES material_request、WMS delivery_order/outbound_order 相关)随 schema 更新重新生成。
92 lines
6.0 KiB
Go
92 lines
6.0 KiB
Go
package schema
|
||
|
||
import (
|
||
"entgo.io/ent"
|
||
"entgo.io/ent/dialect/entsql"
|
||
"entgo.io/ent/schema"
|
||
"entgo.io/ent/schema/field"
|
||
"entgo.io/ent/schema/index"
|
||
)
|
||
|
||
// OutboundOrder 出库统一主表
|
||
// 所有出库(备料出库 workorder / 补料出库 refill / 通用出库 general)都落在这一张表,
|
||
// 用 outbound_type 区分;装箱属性(箱号/SN清单/合同号)直接存本表,不再单独建装箱表。
|
||
// 备料出库强约束:净领用(out_qty − returned_qty) ≤ 工单物料清单需求量,由 WMS 侧台账校验。
|
||
//
|
||
// 注:报工反冲不再生成出库单(2026-09-19 起反冲只核销台账 consumed_qty,不做物理位移)。
|
||
type OutboundOrder struct {
|
||
ent.Schema
|
||
}
|
||
|
||
func (OutboundOrder) Annotations() []schema.Annotation {
|
||
return []schema.Annotation{entsql.Table("outbound_orders"), entsql.WithComments(true), schema.Comment("OutboundOrder 出库统一主表")}
|
||
}
|
||
func (OutboundOrder) Fields() []ent.Field {
|
||
return []ent.Field{
|
||
field.String("outbound_no").Unique().Comment("出库单号"),
|
||
// 类型:workorder(备料出库/MES) refill(工位叫料补料) general(通用出库,不依赖工单)
|
||
field.String("outbound_type").Default("workorder").Comment("出库类型"),
|
||
// 出库单状态:出库即扣库存,故创建即为「已出库」;叫 AGV 配送到位后置「已送达」。
|
||
// 「已接料」不在本表(归备料单 material_request.received_qty),避免三处状态互斗。
|
||
field.String("status").Default("已出库").Comment("出库单状态 已出库/已送达"),
|
||
field.Bool("need_agv").Default(false).Comment("是否需要AGV配送到接驳台"),
|
||
// 出库类别(客户诉求 问题记录 L96-108):通用出库先点选类别——
|
||
// return(退料)/sample(样品)/scrap(报废)/deliver(发货)/other(其他,手输原因)
|
||
field.String("outbound_category").Optional().Comment("出库类别 return/sample/scrap/deliver/other"),
|
||
// 归属(客户诉求 L96-108):工单号/科技项目号/其他;与入库 ownership_type 口径一致
|
||
field.String("ownership_type").Optional().Comment("归属类型 workorder/project/other"),
|
||
field.String("ownership_no").Optional().Comment("归属编号(工单号/科技项目号)"),
|
||
// 目标工位(客户诉求 L96-108):出库送到哪个装配工位
|
||
field.String("target_station").Optional().Comment("目标工位(装配工位号)"),
|
||
field.String("order_no").Optional().Comment("关联工单号(工单为唯一挂靠载体)"),
|
||
field.String("material_code").Comment("物料编码"),
|
||
field.String("material_name").Optional().Comment("物料名称(冗余)"),
|
||
// 类型(分类语境):1结构件/2电气件/3其他
|
||
field.Int("manage_mode").Default(1).Comment("类型 1结构件/2电气件/3其他"),
|
||
// 序列号(2026-09-30 解耦定稿):1序列号=是(逐件SN)/2序列号=否(数量)
|
||
field.Int("sn_mode").Default(0).Comment("序列号 1=是(逐件SN)/2=否(按数量)/0未选择"),
|
||
field.String("batch_no").Optional().Comment("批次号(结构件)"),
|
||
// 出库库位四级(客户诉求:出库与入库同口径,2026-09-19 补齐)
|
||
field.String("zone_code").Optional().Comment("出库区域(大区)"),
|
||
field.String("shelf_no").Optional().Comment("货架号(与入库同口径)"),
|
||
field.String("layer_no").Optional().Comment("第几层(与入库同口径)"),
|
||
field.String("position_no").Optional().Comment("位置号(与入库同口径)"),
|
||
field.Int("quantity").Default(0).Comment("本次出库总数量"),
|
||
field.String("operator").Optional().Comment("操作人"),
|
||
field.String("reviewer").Optional().Comment("复核人"),
|
||
field.String("target_dock").Optional().Comment("目标接驳台(AGV配送)"),
|
||
field.String("remark").Optional().Comment("备注"),
|
||
// 装箱属性:出库时一并记录箱号/SN清单/合同号,统一落在出库主表,不再单独建装箱表
|
||
field.String("box_no").Optional().Comment("箱号(装箱出库时填写,用于整箱发货追溯)"),
|
||
field.String("box_sn_list").Optional().Comment("装箱 SN 清单(JSON 数组字符串)"),
|
||
field.String("contract_no").Optional().Comment("合同号(装箱选填)"),
|
||
// 跨工位借料来源(call 备料出库专用):stationNo→借用量;空=本工位自取(不借)。
|
||
// 库房备料发货时据此知悉"此单混用了借工位额度",避免糊涂账(2026-11-02 借料知情权)。
|
||
field.JSON("borrowFrom", map[string]int{}).Optional().Comment("跨工位借料来源 stationNo→借用量(call 备料出库专用);空=本工位自取"),
|
||
// 检测单号(2026-09-21 对齐入库单字段):退货/报废等需要溯源检验单据的出库场景可选填写
|
||
field.String("inspection_no").Optional().Comment("检测单号(溯源关联检验单据)"),
|
||
// 配送单关联(2026-11-05 叫料配送拆分):叫料类出库回写所属配送单号,配送历史可追溯
|
||
field.String("delivery_no").Default("").Comment("关联配送单号(叫料配送出库回写)"),
|
||
// 产品工号(随库存带入,出库记录展示/筛选,2026-09-29 五页带出)
|
||
field.String("product_work_no").Optional().Comment("产品工号(随库存带入,出库记录展示/筛选)"),
|
||
// 作废(2026-11-03 断头路补全):仅通用出库(general)/科技项目出库(project)可作废——
|
||
// 人工手工出库填错时的纠错闭环(对齐入库作废 inbound_void);备料/补料/叫料出库(workorder/refill/call)
|
||
// 与 MES 台账联动,不提供作废,走退库逆向闭环。作废=回滚库存+标记保留记录。
|
||
field.Bool("voided").Default(false).Comment("是否已作废"),
|
||
field.String("void_reason").Default("").Comment("作废原因(必填留痕)"),
|
||
field.String("voided_by").Default("").Comment("作废操作人"),
|
||
field.Int64("voided_at").Optional().Nillable().Comment("作废时间戳"),
|
||
field.Int64("created_at").DefaultFunc(nowUnix).Comment("创建时间"),
|
||
}
|
||
}
|
||
|
||
func (OutboundOrder) Indexes() []ent.Index {
|
||
return []ent.Index{
|
||
index.Fields("order_no"),
|
||
index.Fields("material_code"),
|
||
index.Fields("outbound_type"),
|
||
index.Fields("box_no"),
|
||
index.Fields("inspection_no"),
|
||
}
|
||
}
|