feat: 完成客户第12条需求+多系统改造

1. 新增预警表添加工单号字段，支持按工单号检索预警
2. 添加工单过滤在制品/绩效报表/预警中心查询
3. 补全WMS台账字段口径与权限配置
4. 修复备料单与数量不符处理流程
5. 新增配送进度/库位联动/自动出库功能
6. 修复AGV配送状态更新逻辑
7. 优化退料与库存管理细节

bj_power_mes/schema/alert.go

@@ -28,6 +28,8 @@ func (Alert) Fields() []ent.Field {
 		field.String("content").Default("").MaxLen(500).Comment("内容"),
 		field.String("refType").Default("").MaxLen(40).Comment("关联业务类型"),
 		field.String("refId").Default("").MaxLen(64).Comment("关联业务ID"),
+		// 关联工单号（客户第12条「记录查看加一项看工单号查询」）：预警中心按工单号检索用，可空。
+		field.String("orderNo").Default("").MaxLen(64).Comment("关联工单号(按工单号查询用)"),
 		field.String("status").Default("UNREAD").MaxLen(10).Comment("UNREAD/READ"),
 		field.String("receiver").Default("").MaxLen(255).Comment("接收人"),
 		field.Time("createdAt").Default(time.Now).Immutable(),

bj_power_mes/schema/material_qty_report.go

@@ -32,7 +32,16 @@ func (MaterialQtyReport) Fields() []ent.Field {
 		field.Int("actualQty").Default(0).Comment("实收数量"),
 		field.Int("diffQty").Default(0).Comment("差异=应发-实收"),
 		field.String("cause").Default("").MaxLen(255).Comment("差异原因"),
-		field.String("status").Default("PENDING").MaxLen(10).Comment("PENDING/RESOLVED"),
+		// 状态机（2026-09-19 定稿）：
+		//   PENDING待处理 → PROCESSING处理中 → REPLENISHED已补发 / RETURNED已退库 / ADJUSTED已调整 → CLOSED已关闭
+		//   兼容旧值 RESOLVED（历史数据，读时按 CLOSED 处理）
+		field.String("status").Default("PENDING").MaxLen(16).Comment("PENDING/PROCESSING/REPLENISHED/RETURNED/ADJUSTED/CLOSED"),
+		// 处理信息（处理侧在 MES，单一真源，WMS 不另存一份）
+		field.String("handleType").Default("").MaxLen(16).Comment("处理方式 REPLENISH补发/RETURN退库/ADJUST调整"),
+		field.String("handleDocNo").Default("").MaxLen(64).Comment("处理生成的单据号(补料单号/退库单号)"),
+		field.String("handleNote").Default("").MaxLen(255).Comment("处理说明"),
+		field.String("handledBy").Default("").MaxLen(64).Comment("处理人"),
+		field.Int64("handledAt").Default(0).Comment("处理时间(unix 秒)"),
 		field.String("operator").Default("").MaxLen(64).Comment("上报人"),
 		field.Time("createdAt").Default(time.Now).Immutable(),
 		field.Time("resolvedAt").Optional().Nillable(),

bj_power_mes/schema/material_request.go

@@ -36,7 +36,22 @@ func (MaterialRequest) Fields() []ent.Field {
 		// 工位级备料：物料送达的工位号（由 station_process 派工 + 日排产分配派生）
 		field.Int("stationNo").Default(0).Comment("目标工位号(0=未指定)"),
 		field.Int("processCode").Default(0).Comment("该物料所属装配工序(1~12)"),
-		field.Float("sentQty").Default(0).Comment("已发料数量（分批出库累加）"),
+		// 字段口径（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"),
+		// 补料/超领：超出 BOM 需求的量与原因为必填（超领不硬卡，但必须留痕可统计）
+		field.Float("overQty").Default(0).Comment("超出 BOM 需求的数量"),
+		field.String("overReason").Default("").MaxLen(64).Comment("超领原因 损耗/报废/返修/其他"),
+		// 补发来源：关联的数量不符单号（source=REFILL 且有值时填写）
+		field.String("refReportNo").Default("").MaxLen(64).Comment("关联数量不符单号"),
+		field.Bool("needAgv").Default(false).Comment("是否需要AGV配送到接驳台"),
 		field.String("batchNo").Default("").MaxLen(64).Comment("发料批次号（分批出库时填写）"),
 		field.String("operator").Default("").MaxLen(64),
 		field.Time("createdAt").Default(time.Now).Immutable(),