Files
bj_power/bj_power_wms/internal/handler/misc.go
T

358 lines
11 KiB
Go
Raw Normal View History

2026-08-28 15:06:01 +08:00
package handler
import (
"net/http"
"strconv"
"strings"
"time"
2026-08-28 15:06:01 +08:00
"bj_power_wms/ent"
"bj_power_wms/ent/inventory"
"bj_power_wms/ent/material"
2026-08-28 15:06:01 +08:00
"bj_power_wms/ent/ordermaterialledger"
"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 表,
// 全部落 inventoriesmanage_mode=2 SN单件, category=2 半成品)。
// 三个 semi 接口签名与响应结构保持不变,MES / 前端零改造平滑切换。
2026-08-28 15:06:01 +08:00
// semiInboundHandler 半成品入库(携带已完成工序)
// 与 MES 闭环:MES 工位报工暂存退库时调用本接口,把半成品 SN 入 WMS 库(inventories, category=2)。
// 为保持两系统解耦,materialCode 不强制要求——优先用请求传入,都没有则留空(SN 本身即追溯锚点)。
2026-08-28 15:06:01 +08:00
func semiInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
var req struct {
Sn string `json:"sn"`
MaterialCode string `json:"materialCode"`
DoneProcessCodes []int `json:"doneProcessCodes"`
2026-08-28 15:06:01 +08:00
CompletedProcess string `json:"completedProcess"`
ZoneCode string `json:"zoneCode"`
OrderNo string `json:"orderNo"`
Operator string `json:"operator"`
}
if err := parseJSON(r, &req); err != nil {
fail(w, http.StatusBadRequest, "参数错误")
return
}
if req.Sn == "" {
fail(w, http.StatusBadRequest, "sn 必填")
2026-08-28 15:06:01 +08:00
return
}
// SN 防重:同一 SN 只允许一条在库/锁定/出库的库存行(含已出库历史,避免重复回流)
exists, err := ctx.EntClient.Inventory.Query().
Where(inventory.CategoryEQ(invCatSemi), inventory.SnCodeEQ(req.Sn)).
2026-08-28 15:06:01 +08:00
Exist(ctx0())
if err != nil {
fail(w, http.StatusInternalServerError, err.Error())
return
}
if exists {
fail(w, http.StatusConflict, "半成品已存在: "+req.Sn)
return
}
// 已完成工序:MES 传 doneProcessCodes([]int) 优先,否则用 completedProcess 字符串
completed := req.CompletedProcess
if len(req.DoneProcessCodes) > 0 {
parts := make([]string, 0, len(req.DoneProcessCodes))
for _, c := range req.DoneProcessCodes {
parts = append(parts, strconv.Itoa(c))
}
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.Inventory.Create().
SetManageMode(2).
SetCategory(invCatSemi).
SetSnCode(req.Sn).
SetMaterialCode(materialCode).
SetMaterialName(materialName).
SetQuantity(1).
SetQualityStatus("未检").
2026-08-28 15:06:01 +08:00
SetNillableZoneCode(strPtr(req.ZoneCode)).
SetStatus("在库").
SetNillableInboundNo(strPtr(req.OrderNo)).
SetOrderNo(req.OrderNo).
SetCompletedProcess(completed).
SetRemark("半成品完工暂存回流").
2026-08-28 15:06:01 +08:00
Save(ctx0())
if err != nil {
fail(w, http.StatusInternalServerError, err.Error())
return
}
ctx.EventLog.Write(ctx0(), "semi.inbound", r.Header.Get("X-Username"), "semi", req.Sn,
"半成品入库 "+req.Sn, map[string]any{"materialCode": materialCode})
ok(w, semiView(rec))
2026-08-28 15:06:01 +08:00
}
}
// semiOutboundHandler 半成品出库(重上线):更新 inventories 状态
2026-08-28 15:06:01 +08:00
func semiOutboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
var req struct {
Sn string `json:"sn"`
ZoneCode string `json:"zoneCode"`
Operator string `json:"operator"`
}
if err := parseJSON(r, &req); err != nil {
fail(w, http.StatusBadRequest, "参数错误")
return
}
if req.Sn == "" {
fail(w, http.StatusBadRequest, "sn 必填")
return
}
rec, err := ctx.EntClient.Inventory.Query().
Where(inventory.CategoryEQ(invCatSemi), inventory.SnCodeEQ(req.Sn)).
2026-08-28 15:06:01 +08:00
Only(ctx0())
if err != nil {
fail(w, http.StatusNotFound, "半成品不存在: "+req.Sn)
return
}
if rec.Status != "在库" {
fail(w, http.StatusConflict, "半成品不在库: "+rec.Status)
return
}
ctx.EntClient.Inventory.UpdateOneID(rec.ID).
2026-08-28 15:06:01 +08:00
SetStatus("出库").
SetUpdatedAt(time.Now().Unix()).
2026-08-28 15:06:01 +08:00
ExecX(ctx0())
ctx.EventLog.Write(ctx0(), "semi.outbound", r.Header.Get("X-Username"), "semi", req.Sn,
"半成品出库(重上线) "+req.Sn, nil)
2026-08-28 15:06:01 +08:00
ok(w, map[string]any{"sn": req.Sn, "status": "出库"})
}
}
// 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)
2026-08-28 15:06:01 +08:00
func querySemiHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
page := atoi(r.URL.Query().Get("page"), 1)
pageSize := atoi(r.URL.Query().Get("pageSize"), 20)
materialCode := r.URL.Query().Get("materialCode")
status := r.URL.Query().Get("status")
q := ctx.EntClient.Inventory.Query().Where(inventory.CategoryEQ(invCatSemi))
2026-08-28 15:06:01 +08:00
if materialCode != "" {
q = q.Where(inventory.MaterialCodeEqualFold(materialCode))
2026-08-28 15:06:01 +08:00
}
if status != "" {
q = q.Where(inventory.StatusEQ(status))
2026-08-28 15:06:01 +08:00
}
total, err := q.Count(ctx0())
if err != nil {
fail(w, http.StatusInternalServerError, err.Error())
return
}
2026-09-03 18:13:59 +08:00
list, err := q.Order(ent.Desc("created_at"), ent.Desc("id")).
2026-08-28 15:06:01 +08:00
Offset((page - 1) * pageSize).Limit(pageSize).All(ctx0())
if err != nil {
fail(w, http.StatusInternalServerError, err.Error())
return
}
rows := make([]*semiViewRow, 0, len(list))
for _, inv := range list {
rows = append(rows, semiView(inv))
}
2026-08-28 15:06:01 +08:00
ok(w, map[string]any{
"total": total,
"list": rows,
2026-08-28 15:06:01 +08:00
"page": page,
"pageSize": pageSize,
})
}
}
2026-09-15 16:37:39 +08:00
// 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 工单物料台账查询(含备料四态)
2026-08-28 15:06:01 +08:00
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")
2026-09-03 18:13:59 +08:00
materialName := r.URL.Query().Get("materialName")
status := r.URL.Query().Get("status")
2026-09-15 16:37:39 +08:00
state := r.URL.Query().Get("state") // 四态筛选:齐套/未齐套/预警/未到货
2026-08-28 15:06:01 +08:00
page := atoi(r.URL.Query().Get("page"), 1)
pageSize := atoi(r.URL.Query().Get("pageSize"), 20)
2026-09-15 16:37:39 +08:00
if page < 1 {
page = 1
}
if pageSize < 1 {
pageSize = 20
}
2026-08-28 15:06:01 +08:00
q := ctx.EntClient.OrderMaterialLedger.Query()
if orderNo != "" {
q = q.Where(ordermaterialledger.OrderNoEQ(orderNo))
}
if materialCode != "" {
q = q.Where(ordermaterialledger.MaterialCodeEqualFold(materialCode))
2026-08-28 15:06:01 +08:00
}
2026-09-03 18:13:59 +08:00
if materialName != "" {
q = q.Where(ordermaterialledger.MaterialNameContains(materialName))
}
if status != "" {
2026-09-15 16:37:39 +08:00
// 兼容旧口径(进行中/领料完结)
switch status {
2026-09-15 16:37:39 +08:00
case "进行中":
q = q.Where(ordermaterialledger.StatusEQ("进行中"))
case "领料完结":
q = q.Where(ordermaterialledger.StatusEQ("领料完结"))
}
2026-09-03 18:13:59 +08:00
}
2026-09-15 16:37:39 +08:00
all, err := q.Order(ent.Desc("created_at"), ent.Desc("id")).All(ctx0())
2026-08-28 15:06:01 +08:00
if err != nil {
fail(w, http.StatusInternalServerError, err.Error())
return
}
2026-09-15 16:37:39 +08:00
// 计算可用库存 + 四态(四态需实时库存,故在 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,
})
2026-08-28 15:06:01 +08:00
}
2026-09-15 16:37:39 +08:00
total := len(rows)
start := (page - 1) * pageSize
if start > total {
start = total
}
end := start + pageSize
if end > total {
end = total
}
pageRows := rows[start:end]
2026-08-28 15:06:01 +08:00
ok(w, map[string]any{
"total": total,
2026-09-15 16:37:39 +08:00
"list": pageRows,
2026-08-28 15:06:01 +08:00
"page": page,
"pageSize": pageSize,
})
}
}