chore: 批量完成项目多模块迭代优化

1. 废弃半成品库存表并统一库存主表
2. 修复列表排序与搜索大小写不敏感问题
3. 新增用户最近登录时间、工单BOM名称字段
4. 完善角色管理、工位选择器功能
5. 增加拧紧数据补录、成品自动回流WMS能力
6. 统一导出时间范围校验规则
7. 丰富物料/备料单筛选条件
8. 调整菜单与权限命名适配产品型号业务

bj_power_wms/internal/handler/misc.go

@@ -4,19 +4,31 @@ import (
 	"net/http"
 	"strconv"
 	"strings"
+	"time"
 
 	"bj_power_wms/ent"
+	"bj_power_wms/ent/inventory"
+	"bj_power_wms/ent/material"
 	"bj_power_wms/ent/ordermaterialledger"
-	"bj_power_wms/ent/semifinished"
 	"bj_power_wms/internal/svc"
 )
 
+// 库存品类（与 schema/inventory.go 保持一致）：1=原材料 2=半成品 3=成品
+const (
+	invCatRaw      = 1
+	invCatSemi     = 2
+	invCatFinished = 3
+)
+
 // 半成品 / 台账 相关（盘点见 stocktake.go）
+//
+// 【统一库存主表收编 2026-09-07】半成品不再写独立 semi_finisheds 表，
+// 全部落 inventories（manage_mode=2 SN单件, category=2 半成品）。
+// 三个 semi 接口签名与响应结构保持不变，MES / 前端零改造平滑切换。
 
 // semiInboundHandler 半成品入库（携带已完成工序）
-// 与 MES 闭环：MES 工位报工暂存退库时调用本接口，把半成品 SN 入 WMS 库。
-// 为保持两系统解耦，materialCode 不强制要求——优先用请求传入，
-// 其次按 SN 反查 WMS 序列号台账，都没有则留空（SN 本身即追溯锚点）。
+// 与 MES 闭环：MES 工位报工暂存退库时调用本接口，把半成品 SN 入 WMS 库（inventories, category=2）。
+// 为保持两系统解耦，materialCode 不强制要求——优先用请求传入，都没有则留空（SN 本身即追溯锚点）。
 func semiInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
 	return func(w http.ResponseWriter, r *http.Request) {
 		var req struct {
@@ -37,8 +49,9 @@ func semiInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
 			return
 		}
 
-		exists, err := ctx.EntClient.SemiFinished.Query().
-			Where(semifinished.SnEQ(req.Sn)).
+		// SN 防重：同一 SN 只允许一条在库/锁定/出库的库存行（含已出库历史，避免重复回流）
+		exists, err := ctx.EntClient.Inventory.Query().
+			Where(inventory.CategoryEQ(invCatSemi), inventory.SnCodeEQ(req.Sn)).
 			Exist(ctx0())
 		if err != nil {
 			fail(w, http.StatusInternalServerError, err.Error())
@@ -59,16 +72,29 @@ func semiInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
 			completed = strings.Join(parts, ",")
 		}
 
-		// 物料编码：以请求传入为准（半成品是独立固定业务类型，不依赖统一库存表）
+		// 物料编码：以请求传入为准；名称从物料档案补齐（档案缺失则用编码兜底）
 		materialCode := req.MaterialCode
+		materialName := materialCode
+		if materialCode != "" {
+			if m, err := ctx.EntClient.Material.Query().Where(material.CodeEQ(materialCode)).First(ctx0()); err == nil && m != nil {
+				materialName = m.Name
+			}
+		}
 
-		rec, err := ctx.EntClient.SemiFinished.Create().
-			SetSn(req.Sn).
-			SetNillableMaterialCode(strPtr(materialCode)).
-			SetNillableCompletedProcess(strPtr(completed)).
+		rec, err := ctx.EntClient.Inventory.Create().
+			SetManageMode(2).
+			SetCategory(invCatSemi).
+			SetSnCode(req.Sn).
+			SetMaterialCode(materialCode).
+			SetMaterialName(materialName).
+			SetQuantity(1).
+			SetQualityStatus("未检").
 			SetNillableZoneCode(strPtr(req.ZoneCode)).
 			SetStatus("在库").
-			SetNillableOrderNo(strPtr(req.OrderNo)).
+			SetNillableInboundNo(strPtr(req.OrderNo)).
+			SetOrderNo(req.OrderNo).
+			SetCompletedProcess(completed).
+			SetRemark("半成品完工暂存回流").
 			Save(ctx0())
 		if err != nil {
 			fail(w, http.StatusInternalServerError, err.Error())
@@ -77,11 +103,11 @@ func semiInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
 
 		ctx.EventLog.Write(ctx0(), "semi.inbound", r.Header.Get("X-Username"), "semi", req.Sn,
 			"半成品入库 "+req.Sn, map[string]any{"materialCode": materialCode})
-		ok(w, rec)
+		ok(w, semiView(rec))
 	}
 }
 
-// semiOutboundHandler 半成品出库（重上线）
+// semiOutboundHandler 半成品出库（重上线）：更新 inventories 状态
 func semiOutboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
 	return func(w http.ResponseWriter, r *http.Request) {
 		var req struct {
@@ -98,8 +124,8 @@ func semiOutboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
 			return
 		}
 
-		rec, err := ctx.EntClient.SemiFinished.Query().
-			Where(semifinished.SnEQ(req.Sn)).
+		rec, err := ctx.EntClient.Inventory.Query().
+			Where(inventory.CategoryEQ(invCatSemi), inventory.SnCodeEQ(req.Sn)).
 			Only(ctx0())
 		if err != nil {
 			fail(w, http.StatusNotFound, "半成品不存在: "+req.Sn)
@@ -110,17 +136,47 @@ func semiOutboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
 			return
 		}
 
-		ctx.EntClient.SemiFinished.UpdateOneID(rec.ID).
+		ctx.EntClient.Inventory.UpdateOneID(rec.ID).
 			SetStatus("出库").
+			SetUpdatedAt(time.Now().Unix()).
 			ExecX(ctx0())
 
 		ctx.EventLog.Write(ctx0(), "semi.outbound", r.Header.Get("X-Username"), "semi", req.Sn,
-			"半成品出库 "+req.Sn, nil)
+			"半成品出库(重上线) "+req.Sn, nil)
 		ok(w, map[string]any{"sn": req.Sn, "status": "出库"})
 	}
 }
 
-// querySemiHandler 半成品查询
+// semiView 把统一库存行映射为半成品视图（保持原 /api/semi/query 响应结构，前端零改造）
+type semiViewRow struct {
+	ID               int    `json:"id"`
+	Sn               string `json:"sn"`
+	MaterialCode     string `json:"materialCode"`
+	CompletedProcess string `json:"completedProcess"`
+	Quantity         int    `json:"quantity"`
+	ZoneCode         string `json:"zoneCode"`
+	Status           string `json:"status"`
+	OrderNo          string `json:"orderNo"`
+	CreatedAt        int64  `json:"createdAt"`
+	UpdatedAt        int64  `json:"updatedAt"`
+}
+
+func semiView(inv *ent.Inventory) *semiViewRow {
+	return &semiViewRow{
+		ID:               inv.ID,
+		Sn:               inv.SnCode,
+		MaterialCode:     inv.MaterialCode,
+		CompletedProcess: inv.CompletedProcess,
+		Quantity:         inv.Quantity,
+		ZoneCode:         inv.ZoneCode,
+		Status:           inv.Status,
+		OrderNo:          inv.OrderNo,
+		CreatedAt:        inv.CreatedAt,
+		UpdatedAt:        inv.UpdatedAt,
+	}
+}
+
+// querySemiHandler 半成品查询（读统一库存主表 category=2）
 func querySemiHandler(ctx *svc.ServiceContext) http.HandlerFunc {
 	return func(w http.ResponseWriter, r *http.Request) {
 		page := atoi(r.URL.Query().Get("page"), 1)
@@ -128,12 +184,12 @@ func querySemiHandler(ctx *svc.ServiceContext) http.HandlerFunc {
 		materialCode := r.URL.Query().Get("materialCode")
 		status := r.URL.Query().Get("status")
 
-		q := ctx.EntClient.SemiFinished.Query()
+		q := ctx.EntClient.Inventory.Query().Where(inventory.CategoryEQ(invCatSemi))
 		if materialCode != "" {
-			q = q.Where(semifinished.MaterialCodeEQ(materialCode))
+			q = q.Where(inventory.MaterialCodeEqualFold(materialCode))
 		}
 		if status != "" {
-			q = q.Where(semifinished.StatusEQ(status))
+			q = q.Where(inventory.StatusEQ(status))
 		}
 
 		total, err := q.Count(ctx0())
@@ -147,10 +203,14 @@ func querySemiHandler(ctx *svc.ServiceContext) http.HandlerFunc {
 			fail(w, http.StatusInternalServerError, err.Error())
 			return
 		}
+		rows := make([]*semiViewRow, 0, len(list))
+		for _, inv := range list {
+			rows = append(rows, semiView(inv))
+		}
 
 		ok(w, map[string]any{
 			"total":    total,
-			"list":     list,
+			"list":     rows,
 			"page":     page,
 			"pageSize": pageSize,
 		})
@@ -172,7 +232,7 @@ func queryLedgerHandler(ctx *svc.ServiceContext) http.HandlerFunc {
 			q = q.Where(ordermaterialledger.OrderNoEQ(orderNo))
 		}
 		if materialCode != "" {
-			q = q.Where(ordermaterialledger.MaterialCodeEQ(materialCode))
+			q = q.Where(ordermaterialledger.MaterialCodeEqualFold(materialCode))
 		}
 		if materialName != "" {
 			q = q.Where(ordermaterialledger.MaterialNameContains(materialName))