feat: 完成多模块迭代更新

- 新增过程巡检按步骤上报、数量不符上报、工位退料功能
- 增加工单工程编号三级归属字段
- 新增物料安全库存与缺货预警
- 新增附件管理、退库单管理模块
- 优化生产看板展示逻辑与前端页面文案
- 清理冗余的工艺路线相关代码与备份文件

bj_power_wms/internal/handler/misc.go

@@ -217,15 +217,77 @@ func querySemiHandler(ctx *svc.ServiceContext) http.HandlerFunc {
 	}
 }
 
-// ledger 相关：queryLedgerHandler 工单物料台账查询
+// ledgerRow 台账行（服务端派生 可用库存 / 缺口 / 四态）
+type ledgerRow struct {
+	*ent.OrderMaterialLedger
+	AvailableQty int    `json:"availableQty"` // 实时可用库存
+	ShortQty     int    `json:"shortQty"`     // 缺口 = 需求 - 可用（下限 0）
+	State        string `json:"state"`        // 备料四态：齐套/未齐套/预警/未到货
+}
+
+// ledgerState 备料四态判定（客户诉求 问题记录 L242-258），优先级：未到货 > 预警 > 未齐套 > 齐套。
+//
+// 说明：客户原始口径「预警 = 可用 < 未来5天需求量」，该需求量需 MES 日排产数据；
+// 当前 WMS 侧无该数据源，暂以「已开始领料（已出库>0）但可用仍不足」作为预警判定——
+// 语义等价（已在领料却仍不够，随时可能停线）。待 MES 提供日排产接口后替换即可。
+func ledgerState(avail, need, out int) string {
+	if avail >= need {
+		return "齐套"
+	}
+	if avail <= 0 && out <= 0 {
+		return "未到货"
+	}
+	if out > 0 {
+		return "预警"
+	}
+	return "未齐套"
+}
+
+// materialAvailableQty 物料可用库存汇总（在库/锁定 且 质量状态非 不合格/待退）。
+func materialAvailableQty(ctx *svc.ServiceContext, code string) int {
+	rows, err := ctx.EntClient.Inventory.Query().
+		Where(
+			inventory.MaterialCodeEQ(code),
+			inventory.StatusIn("在库", "锁定"),
+			inventory.QualityStatusNotIn("不合格", "待退"),
+		).All(ctx0())
+	if err != nil {
+		return 0
+	}
+	avail := 0
+	for _, inv := range rows {
+		if inv.ManageMode == 1 {
+			avail += inv.Quantity - inv.LockedQty
+		} else if inv.Status == "在库" {
+			avail++
+		}
+	}
+	return avail
+}
+
+func max0(n int) int {
+	if n < 0 {
+		return 0
+	}
+	return n
+}
+
+// queryLedgerHandler 工单物料台账查询（含备料四态）
 func queryLedgerHandler(ctx *svc.ServiceContext) http.HandlerFunc {
 	return func(w http.ResponseWriter, r *http.Request) {
 		orderNo := r.URL.Query().Get("orderNo")
 		materialCode := r.URL.Query().Get("materialCode")
 		materialName := r.URL.Query().Get("materialName")
 		status := r.URL.Query().Get("status")
+		state := r.URL.Query().Get("state") // 四态筛选：齐套/未齐套/预警/未到货
 		page := atoi(r.URL.Query().Get("page"), 1)
 		pageSize := atoi(r.URL.Query().Get("pageSize"), 20)
+		if page < 1 {
+			page = 1
+		}
+		if pageSize < 1 {
+			pageSize = 20
+		}
 
 		q := ctx.EntClient.OrderMaterialLedger.Query()
 		if orderNo != "" {
@@ -238,41 +300,56 @@ func queryLedgerHandler(ctx *svc.ServiceContext) http.HandlerFunc {
 			q = q.Where(ordermaterialledger.MaterialNameContains(materialName))
 		}
 		if status != "" {
-			// 状态枚举：待领料 / 部分领料 由「进行中 + 累计出库数」派生（表内只存 进行中/领料完结）
-			// 待领料 = 进行中 且 已出库=0；部分领料 = 进行中 且 已出库>0
+			// 兼容旧口径（进行中/领料完结）
 			switch status {
-			case "待领料":
-				q = q.Where(ordermaterialledger.And(
-					ordermaterialledger.StatusEQ("进行中"),
-					ordermaterialledger.OutQtyEQ(0),
-				))
-			case "部分领料":
-				q = q.Where(ordermaterialledger.And(
-					ordermaterialledger.StatusEQ("进行中"),
-					ordermaterialledger.OutQtyGT(0),
-				))
+			case "进行中":
+				q = q.Where(ordermaterialledger.StatusEQ("进行中"))
 			case "领料完结":
 				q = q.Where(ordermaterialledger.StatusEQ("领料完结"))
-			case "进行中": // 兼容旧调用：看全部未完结
-				q = q.Where(ordermaterialledger.StatusEQ("进行中"))
-			default:
-				q = q.Where(ordermaterialledger.StatusEQ(status))
 			}
 		}
-		total, err := q.Count(ctx0())
+
+		all, err := q.Order(ent.Desc("created_at"), ent.Desc("id")).All(ctx0())
 		if err != nil {
 			fail(w, http.StatusInternalServerError, err.Error())
 			return
 		}
-		list, err := q.Order(ent.Desc("created_at"), ent.Desc("id")).
-			Offset((page - 1) * pageSize).Limit(pageSize).All(ctx0())
-		if err != nil {
-			fail(w, http.StatusInternalServerError, err.Error())
-			return
+
+		// 计算可用库存 + 四态（四态需实时库存，故在 Go 侧派生）
+		availCache := map[string]int{}
+		rows := make([]*ledgerRow, 0, len(all))
+		for _, lg := range all {
+			avail, ok := availCache[lg.MaterialCode]
+			if !ok {
+				avail = materialAvailableQty(ctx, lg.MaterialCode)
+				availCache[lg.MaterialCode] = avail
+			}
+			st := ledgerState(avail, lg.TotalQty, lg.OutQty)
+			if state != "" && st != state {
+				continue
+			}
+			rows = append(rows, &ledgerRow{
+				OrderMaterialLedger: lg,
+				AvailableQty:        avail,
+				ShortQty:            max0(lg.TotalQty - avail),
+				State:               st,
+			})
 		}
+
+		total := len(rows)
+		start := (page - 1) * pageSize
+		if start > total {
+			start = total
+		}
+		end := start + pageSize
+		if end > total {
+			end = total
+		}
+		pageRows := rows[start:end]
+
 		ok(w, map[string]any{
 			"total":    total,
-			"list":     list,
+			"list":     pageRows,
 			"page":     page,
 			"pageSize": pageSize,
 		})