feat: 多系统新增扫码中间件与 AGV 对接,优化拧紧与退库流程

新增扫码中间件支持网络型扫码枪键盘注入,AGV 对接从 WMS 迁至 MES 统一管理;新增拧紧不合格人工处置与 PLC 对账机制,优化退库单关联与工位终端功能,同时清理旧 AGV 任务表,完善数据库与配置项。
This commit is contained in:
SunYF
2026-10-14 17:24:59 +08:00
parent 8e6048c64b
commit f65a52d9e1
170 changed files with 15415 additions and 10572 deletions
+53
View File
@@ -0,0 +1,53 @@
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"
"time"
)
// AgvTask AGV 搬运任务记录(2026-10-14 由 WMS 迁至 MES 为唯一真源)。
// MES 在仓库完成备料后调度海康 RCS 派车,任务落库用于状态跟踪/追溯。
// status 流转:PENDING待下发 → DISPATCHED(已下发) → DELIVERING搬运中 → DONE已到位 / FAILED失败 / CANCELLED已取消
type AgvTask struct {
ent.Schema
}
func (AgvTask) Annotations() []schema.Annotation {
return []schema.Annotation{entsql.Table("agv_tasks"), entsql.WithComments(true), schema.Comment("AgvTask AGV 搬运任务记录:MES 调度海康 RCS 派车后落库,用于状态跟踪/追溯。")}
}
func (AgvTask) Fields() []ent.Field {
return []ent.Field{
field.String("task_no").Unique().MaxLen(64).Comment("我方任务号(内部)"),
field.String("hik_task_code").Default("").MaxLen(64).Comment("海康返回 robotTaskCode(MOCK- 开头为模拟)"),
field.String("source_dock").Default("").MaxLen(20).Comment("起点接驳台(常为 DOCK21 库房)"),
field.String("target_dock").Default("").MaxLen(20).Comment("终点接驳台 DOCK01..20"),
field.String("materials_json").Default("").MaxLen(4000).Comment("物料清单 JSON"),
field.String("related_request_no").Default("").MaxLen(64).Optional().Comment("关联叫料单号(MES material_request.requestNo)"),
field.String("related_outbound_no").Default("").MaxLen(64).Optional().Comment("关联出库单号(可选, WMS 回传)"),
field.String("status").Default("PENDING").MaxLen(20).Comment("PENDING/DISPATCHED/DELIVERING/DONE/FAILED/CANCELLED"),
field.String("operator").Default("").MaxLen(64).Comment("下发人"),
field.Int64("dispatched_at").Default(0).Comment("下发时间 unix秒"),
field.Int64("arrived_at").Default(0).Comment("到位时间 unix秒"),
field.String("remark").Default("").MaxLen(500).Optional().Comment("备注/失败原因"),
field.Int64("created_at").DefaultFunc(nowUnix).Comment("创建时间"),
}
}
func (AgvTask) Indexes() []ent.Index {
return []ent.Index{
index.Fields("task_no").Unique(),
index.Fields("target_dock"),
index.Fields("status"),
index.Fields("hik_task_code"),
}
}
// nowUnix 与 WMS 端 schema 保持一致:created_at 用 unix 秒(前端 fmtTime 直接消费)。
func nowUnix() int64 {
return time.Now().Unix()
}
+1 -1
View File
@@ -31,7 +31,7 @@ func (Alert) Fields() []ent.Field {
field.String("level").Default("").MaxLen(20).Comment("级别:信息/警告/严重(空=历史数据未分级)"),
// 目标对象:工位号/库房/物料编码/SN 等(人工可读),供检索定位
field.String("target").Default("").MaxLen(128).Comment("目标对象(工位/库房/SN 等)"),
field.String("title").MaxLen(120).Comment("标题"),
field.String("title").MaxLen(255).Comment("标题"),
field.String("content").Default("").MaxLen(500).Comment("内容"),
field.String("refType").Default("").MaxLen(40).Comment("关联业务类型"),
field.String("refId").Default("").MaxLen(64).Comment("关联业务ID"),
+59
View File
@@ -0,0 +1,59 @@
package schema
import (
"time"
"entgo.io/ent"
"entgo.io/ent/dialect/entsql"
"entgo.io/ent/schema"
"entgo.io/ent/schema/field"
"entgo.io/ent/schema/index"
)
// CallPool 叫料池(B5 定稿 2026-10-13):工位级物料行四数账,一行 = 一个工位 + 一个物料。
//
// 池子来源 = 启用状态(CONFIRMED)的日排产 × 工单工艺组合(flow_combination) × 工艺物料清单(flow_material),
// 按 工位+物料 聚合;需求量 = Σ 该工位排产量 × 单台用量 ×(1+损耗率),逐排产行向上取整后求和
// (与旧备料单 reqQty 口径一致,避免拆单合计与整体取整不一致)。
//
// 四数(B5 数量账):
// - req_qty 需求(启用排产派生重算;人工调整见 adj_qty)
// - adj_qty 人工调整量(可正可负,默认 0;改动留痕 event_log 谁/何时/原值→新值)
// - sent_qty 已发净额(完成备料实发量累加;退库收回时扣减,额度回补)
// - reserved_qty 占用中(待备料(PENDING)叫料单请求量合计;完成/取消/驳回时释放)
// 可用 = req_qty + adj_qty − sent_qty − reserved_qty;叫料时对行 FOR UPDATE 防护,可用 < 请求量即拒(耗尽即止)。
// 工位只能叫自己工位的行;无工艺 → 无行 → 不能叫。
type CallPool struct {
ent.Schema
}
func (CallPool) Annotations() []schema.Annotation {
return []schema.Annotation{entsql.Annotation{Table: "call_pool"}, entsql.WithComments(true), schema.Comment("CallPool 叫料池:工位级物料行四数账(需求/调整/已发/占用),来源=启用状态日排产")}
}
func (CallPool) Fields() []ent.Field {
return []ent.Field{
field.Int("id").Positive(),
field.Int("stationNo").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.Int("reqQty").Default(0).Comment("需求量(启用排产派生,逐行向上取整后合计)"),
field.Int("adjQty").Default(0).Comment("人工调整量(可正可负;改动留痕 event_log)"),
field.Int("sentQty").Default(0).Comment("已发净额(完成备料实发累加;退库收回扣减回补)"),
field.Int("reservedQty").Default(0).Comment("占用中(待备料叫料单请求量合计)"),
field.Bool("crossDay").Default(false).Comment("是否含非今日排产(跨日叫料预警/仓库驳回异常标记)"),
field.String("planDates").Default("").MaxLen(255).Comment("派生快照:贡献需求的排产日期(逗号分隔,可空)"),
field.Time("createdAt").Default(time.Now).Immutable(),
field.Time("updatedAt").Default(time.Now).UpdateDefault(time.Now),
}
}
func (CallPool) Indexes() []ent.Index {
return []ent.Index{
index.Fields("stationNo", "materialCode").Unique(),
index.Fields("stationNo"),
}
}
+29 -27
View File
@@ -10,50 +10,52 @@ import (
"entgo.io/ent/schema/index"
)
// MaterialRequest 备料单:按日排产自动算料生成
// 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 备料单:按日排产自动算料生成")}
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("orderNo").MaxLen(64).Comment("工单号"),
field.String("planDate").MaxLen(10).Comment("对应排产日"),
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("需备数量"),
// PENDING / LOCKED / DELIVERING / DONE
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("目标接驳台 DOCK01..20"),
// 工位级备料:物料送达的工位号(由 工单工艺组合+日排产分产量 派生)
field.Int("stationNo").Default(0).Comment("目标工位号(0=未指定)"),
field.Int("flowId").Default(0).Comment("该物料所属工艺ID(0=整线共用)"),
// 字段口径(2026-09-19 定稿,一个字段只有一个写者):
// sentQty 已发出量 [写者:自动出库/WMS 回写],同时是「还需发多少 = reqQty − sentQty」的幂等基准
// receivedQty 已接料量 [写者:工位扫码接料]
// 派生:在途 = sentQty − receivedQty
field.Float("sentQty").Default(0).Comment("已发出量(分批出库累加;幂等基准,勿与已接料混用)"),
field.Float("receivedQty").Default(0).Comment("已接料量(工位扫码接料累加)"),
field.Int64("receivedAt").Default(0).Comment("最近接料时间(unix 秒)"),
field.String("receiveBy").Default("").MaxLen(64).Comment("接料人"),
// 来源:PLAN=日排产备料(默认) / REFILL=工位叫料·数量不符补发(优先级高于 PLAN)
field.String("source").Default("PLAN").MaxLen(16).Comment("来源 PLAN/REFILL"),
// 补料/超领:超出 物料清单需求的量与原因为必填(超领不硬卡,但必须留痕可统计)
field.Float("overQty").Default(0).Comment("超出 物料清单需求的数量"),
field.String("overReason").Default("").MaxLen(64).Comment("超领原因 损耗/报废/返修/其他"),
field.String("targetDock").Default("").MaxLen(20).Comment("目标接驳台(GxR1/GxR2,一单一个托盘)"),
// 工位级叫料:物料送达的工位号(叫料池行主体;工位只能叫自己的料)
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(false).Comment("是否需要AGV配送到接驳台"),
field.String("batchNo").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("驳回理由(仓库拒发时必填)"),
field.String("operator").Default("").MaxLen(64),
field.Time("createdAt").Default(time.Now).Immutable(),
field.Time("updatedAt").Default(time.Now).UpdateDefault(time.Now).Optional().Nillable(),
@@ -62,7 +64,7 @@ func (MaterialRequest) Fields() []ent.Field {
func (MaterialRequest) Indexes() []ent.Index {
return []ent.Index{
index.Fields("orderNo"),
index.Fields("stationNo"),
index.Fields("materialCode"),
index.Fields("status"),
}
+6
View File
@@ -39,6 +39,12 @@ func (Workpiece) Fields() []ent.Field {
field.Time("doneAt").Optional().Nillable().Comment("完工时间"),
field.Time("createdAt").Default(time.Now).Immutable(),
field.Time("updatedAt").Default(time.Now).UpdateDefault(time.Now).Optional().Nillable(),
// 拧紧不合格「待人工处置」标记(B6 最小闭环,2026-10-13):非工件六态,仅标记位。
// NG 写入后置 true;返工重拧合格不自动清(不在此处清零),必须质检/班组长确认放行(DisposeTorqueNg)才清。
// 置位期间阻断该件后续报工(ReportProcess)与下线完工(DoneWorkpiece)。
field.Bool("torque_ng_pending").Default(false).Comment("拧紧扭矩不合格待人工处置标记"),
field.Time("torque_ng_at").Optional().Nillable().Comment("拧紧不合格标记时间"),
field.String("torque_ng_by").Optional().Nillable().MaxLen(64).Comment("拧紧不合格标记操作人"),
}
}