一、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 更新重新生成。
113 lines
7.8 KiB
Go
113 lines
7.8 KiB
Go
package schema
|
|
|
|
import (
|
|
"time"
|
|
|
|
"entgo.io/ent"
|
|
"entgo.io/ent/dialect"
|
|
"entgo.io/ent/dialect/entsql"
|
|
"entgo.io/ent/schema"
|
|
"entgo.io/ent/schema/field"
|
|
"entgo.io/ent/schema/index"
|
|
)
|
|
|
|
// MaterialRequest 叫料单(B5 定稿 2026-10-13):工位终端/数量不符补发从叫料池发起,
|
|
// 不绑工单、不绑排产;一次叫料按物料行拆 N 张单,每单 = 一个物料 + 一个量 + 一个目标接驳台 = 一个托盘 = 一次配送。
|
|
// 数量账在叫料池 call_pool(四数:需求/调整/已发/占用);本单只记请求量与实发量。
|
|
type MaterialRequest struct {
|
|
ent.Schema
|
|
}
|
|
|
|
func (MaterialRequest) Annotations() []schema.Annotation {
|
|
return []schema.Annotation{entsql.Annotation{Table: "material_request"}, entsql.WithComments(true), schema.Comment("MaterialRequest 叫料单:从叫料池发起,不绑工单/排产;七态状态机")}
|
|
}
|
|
|
|
func (MaterialRequest) Fields() []ent.Field {
|
|
return []ent.Field{
|
|
field.Int("id").Positive(),
|
|
field.String("requestNo").MaxLen(64).Comment("叫料单号"),
|
|
field.String("materialCode").MaxLen(64).Comment("物料编码"),
|
|
field.String("materialName").Default("").MaxLen(128),
|
|
field.String("unit").Default("").MaxLen(16),
|
|
// 是否逐件SN管理(冗余自物料档案 sn_mode,出库口径唯一依据):1 序列号=是(逐件SN) / 2 序列号=否
|
|
field.Int("snMode").Default(2),
|
|
field.Float("reqQty").Default(0).Comment("请求量(发起时占用叫料池可用量)"),
|
|
// 七态状态机(B5 定稿):
|
|
// PENDING 待备料(占用中)/ SHIPPED 已发货(仓库完成备料,WMS 已扣库存)
|
|
// DONE 已完成(工位签收)/ CANCELLED 已取消(待备料时工位撤销)
|
|
// REJECTED 已驳回(仓库拒发,带理由)/ RETURNING 退库中(签收前整单退,仓库取回中)
|
|
// RETURNED 已退库(仓库确认收回,叫料池已发额度回补)
|
|
field.String("status").Default("PENDING").MaxLen(20),
|
|
field.String("targetDock").Default("").MaxLen(20).Comment("期望接驳台(可空;配送时 WMS 确定实际接驳台,2026-11-05 降级)"),
|
|
// 工位级叫料:物料送达的工位号(叫料池行主体;工位只能叫自己的料)
|
|
field.Int("stationNo").Default(0).Comment("目标工位号"),
|
|
// 字段口径(2026-10-13 B5 定稿,一个字段只有一个写者):
|
|
// reqQty 请求量 [写者:发起叫料] —— 发起时占用 +reqQty
|
|
// sentQty 实发量 [写者:仓库完成备料] —— 完成时 已发 +sentQty、占用 −reqQty(差额自动释放)
|
|
// returnedQty 退库量 [写者:仓库确认收回] —— 退库收回时 已发 −returnedQty(额度回补)
|
|
field.Float("sentQty").Default(0).Comment("实发量(仓库完成备料时确定,禁单内分批)"),
|
|
field.Float("returnedQty").Default(0).Comment("退库量(整单退;仓库确认收回后叫料池额度回补)"),
|
|
// 来源:CALL=工位终端叫料(默认) / REFILL=数量不符补发(处理页定稿在 MES,同样消耗叫料池)
|
|
field.String("source").Default("CALL").MaxLen(16).Comment("来源 CALL/REFILL"),
|
|
// 补发来源:关联的数量不符单号(source=REFILL 且有值时填写)
|
|
field.String("refReportNo").Default("").MaxLen(64).Comment("关联数量不符单号"),
|
|
field.Bool("needAgv").Default(true).Comment("是否需要AGV配送到接驳台"),
|
|
// AGV 任务号(派车成功后由 DispatchAgvForCall 回写;派车失败不改状态机、只落预警)
|
|
field.String("agvTaskNo").Default("").MaxLen(64).Comment("AGV 任务号(派车成功后回写)"),
|
|
field.Bool("crossDay").Default(false).Comment("跨日标记:叫料池行含非今日排产(工位预警+仓库可驳回异常)"),
|
|
field.String("outboundNo").Default("").MaxLen(255).Comment("WMS 出库单号(完成备料回写,多个逗号分隔)"),
|
|
field.String("rejectReason").Default("").MaxLen(128).Comment("驳回理由(仓库拒发时必填)"),
|
|
// 跨工位借料来源:sourceStationNo(字符串键)→实际借用量;空 {} = 本工位自取(不借)。
|
|
// 当本工位可用不足时,系统自动从「同工艺候选工位」的剩余额度借用并如实记录;借出工位额度相应扣减。
|
|
// 叫料池四数账按真实消耗的工位行记账(与是否借料无关),来源仅用于追溯与额度回补。
|
|
field.JSON("borrowFrom", map[string]int{}).Optional().SchemaType(map[string]string{
|
|
dialect.Postgres: "jsonb",
|
|
}).Comment("跨工位借料来源 stationNo→借用量;空=本工位自取"),
|
|
field.String("operator").Default("").MaxLen(64),
|
|
// 2026-11-05 叫料包拍板:一次提交=一包(同批提交的所有行赋同一 package_no);
|
|
// 一包默认一个期望接驳台(可空),配送时 WMS 确定实际接驳台。存量单为空=单包。
|
|
field.String("packageNo").Default("").MaxLen(64).Comment("叫料包号(同批提交同号;空=存量单包)"),
|
|
field.String("callDate").Default("").MaxLen(10).Comment("叫料日(所选排产日 yyyy-MM-dd;默认当天)"),
|
|
// 物料挂工单(2026-11-05 拍板):本单量按 工单×排产日 拆分入明细,供 WMS 配送详情与
|
|
// 「当日剩余没叫/跨日量」提示使用;池底层 工位×物料 聚合记账不动(两层并存)。
|
|
field.JSON("planBreakdown", []CallPlanBreakdown{}).Optional().SchemaType(map[string]string{
|
|
dialect.Postgres: "jsonb",
|
|
}).Comment("工单×排产日明细 [{orderNo,planDate,flowId,flowName,qty}]"),
|
|
// 关联工单号(2026-11-03 转产按工单精确退料):普通叫料单为空;
|
|
// 转产退库单写入对应工单号,实现「按工单归集退料」——叫料池底层「工位×物料」聚合设计不变,
|
|
// 仅在退库单上记录工单归属,由库管按工单分别确认收货。
|
|
field.String("workOrderNo").Default("").MaxLen(64).Comment("关联工单号(转产按工单精确退料;普通叫料单为空)"),
|
|
// 2026-11-03 拍板:退料必须指定接驳台(AGV 要从接驳台出发拉货);退料差额(实际<理论)即损耗,必填原因、后审核
|
|
field.String("returnDock").Default("").MaxLen(20).Comment("退料接驳台(退料/还库时指定从哪个接驳台拉走,AGV 派车依据)"),
|
|
field.Float("theoryQty").Optional().Nillable().Comment("理论应退量(转产/下班退料按 BOM 计算;实际<理论差额=损耗)"),
|
|
field.Float("lossQty").Optional().Nillable().Comment("损耗量(理论应退-实际退回>0 时记录)"),
|
|
field.String("lossReason").Default("").MaxLen(200).Comment("损耗原因(有损耗时必填,主管在损耗台账批注)"),
|
|
// 2026-11-03 拍板(R18):库管确认收货可记录收货差异——实收<应退即为差异,记「待核」,
|
|
// 不自动计入损耗台账;差异经库管真实核实为损耗后,再由主管走损耗登记挂工单。
|
|
field.Float("receiveQty").Optional().Nillable().Comment("库管实收量(WMS 确认收货回写)"),
|
|
field.Float("receiveDiff").Optional().Nillable().Comment("收货差异=应退-实收(>0 为少收,记待核,不自动进损耗台账)"),
|
|
field.String("receiveNote").Default("").MaxLen(200).Comment("收货差异备注(库管填写,说明差异原因)"),
|
|
field.Time("createdAt").Default(time.Now).Immutable(),
|
|
field.Time("updatedAt").Default(time.Now).UpdateDefault(time.Now).Optional().Nillable(),
|
|
}
|
|
}
|
|
|
|
// CallPlanBreakdown 叫料单的 工单×排产日 明细行(plan_breakdown jsonb 元素)。
|
|
type CallPlanBreakdown struct {
|
|
OrderNo string `json:"orderNo"`
|
|
PlanDate string `json:"planDate"`
|
|
FlowID int `json:"flowId"`
|
|
FlowName string `json:"flowName"`
|
|
Qty float64 `json:"qty"`
|
|
}
|
|
|
|
func (MaterialRequest) Indexes() []ent.Index {
|
|
return []ent.Index{
|
|
index.Fields("stationNo"),
|
|
index.Fields("materialCode"),
|
|
index.Fields("status"),
|
|
index.Fields("workOrderNo"),
|
|
index.Fields("packageNo"),
|
|
}
|
|
}
|