Files
bj_power/bj_power_wms/internal/handler/excel.go
T
SunYF 619fc8983d feat: 全端体验与稳定性整改(帮助文档清理/收集式报错/操作列统一/托盘与WS通知/物料同步重推)
- 移除 bj_power_dashboard 旧 React 大屏源码(迁移至 2D SVG 方案)
- MES/WMS/工位终端前端:清理 help.js 与 PageHelp 帮助文档,统一操作列与布局,接入请求拦截器
- 新增收集式校验错误弹窗(ErrorListDialog 统一拦截 3015,逐条列现象+建议)
- 新增托盘程序(tray)与 WebSocket(ws) 实时通知模块(三端共用)
- MES/WMS 物料档案新增同步状态字段,补齐双向失败重推与默认角色 seed
- 工单/产能/产品工艺/日排产逻辑调整;拧紧枪按工位配置
- 新增迁移 SQL:扭矩按工位、sysconfig 序列修复
- 更新 技术约束/案例/部署手册/项目说明 等文档
2026-11-10 23:42:50 +08:00

677 lines
23 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
package handler
import (
"bytes"
"errors"
"fmt"
"net/http"
"net/url"
"strings"
"time"
"unicode/utf8"
"bj_power_wms/ent/inventory"
"bj_power_wms/ent/material"
"bj_power_wms/internal/svc"
"github.com/xuri/excelize/v2"
)
// normalizeExportRange 导出时间范围硬规则(2026-09-08 全项目统一):
// ① 起止都空 → 默认近 3 个月;② 只传一个 → 报错;③ 间隔 > 1 年 → 报错;④ 结束早于起始 → 报错。
// 返回归一化后的 YYYY-MM-DD 字符串,调用方按原有逻辑解析过滤。
func normalizeExportRange(startDate, endDate string) (string, string, error) {
if startDate == "" && endDate == "" {
now := time.Now()
return now.AddDate(0, -3, 0).Format("2006-01-02"), now.Format("2006-01-02"), nil
}
if startDate == "" || endDate == "" {
return "", "", errors.New("导出必须同时提供起始时间与结束时间")
}
st, err1 := time.ParseInLocation("2006-01-02", startDate, time.Local)
et, err2 := time.ParseInLocation("2006-01-02", endDate, time.Local)
if err1 != nil || err2 != nil {
return "", "", errors.New("时间格式应为 YYYY-MM-DD")
}
if et.Before(st) {
return "", "", errors.New("结束时间不能早于起始时间")
}
if et.Sub(st) > 366*24*time.Hour {
return "", "", errors.New("导出时间间隔不能超过 1 年")
}
return startDate, endDate, nil
}
// exportRangeUnix 把 YYYY-MM-DD 区间转为 unix 秒闭区间 [start, end+1天)
func exportRangeUnix(startDate, endDate string) (int64, int64) {
st, _ := time.ParseInLocation("2006-01-02", startDate, time.Local)
et, _ := time.ParseInLocation("2006-01-02", endDate, time.Local)
return st.Unix(), et.Add(24*time.Hour).Unix() - 1
}
// xlsxColumn 导出列定义:列名 + 取值函数(返回字符串)
type xlsxColumn struct {
Title string
Get func(map[string]any) string
}
// xlsxFilename 生成导出文件名:{页面名}_{YYYYMMDDHHMMSS}.xlsx(URL 安全,避免中文编码问题)
func xlsxFilename(page string) string {
return fmt.Sprintf("%s_%s.xlsx", page, time.Now().Format("20060102_150405"))
}
// sendExcel 用 excelize 生成 .xlsx 并写回响应(UTF-8 表头,列宽自适应,冻结首行)
// headers 与 rows 为字符串二维数组;filename 用于 Content-Disposition。
func sendExcel(w http.ResponseWriter, filename string, headers []string, rows [][]any /* any: string|int|int64 */) {
buf, err := buildXlsx(headers, rows)
if err != nil {
fail(w, http.StatusInternalServerError, "生成 Excel 失败: "+err.Error())
return
}
// RFC 5987:中文文件名用 filename*=UTF-8''...(URL 编码)。
// ASCII 兜底名恒为纯 ASCII(中文原样放 filename="" 会被浏览器按 latin-1 渲染成乱码),
// 前端优先解析 filename* 拿到中文原名。
asciiName := "export.xlsx"
encName := ""
if utf8.ValidString(filename) {
encName = "filename*=UTF-8''" + url.QueryEscape(filename)
}
w.Header().Set("Content-Type", "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet")
cd := fmt.Sprintf("attachment; filename=\"%s\"", asciiName)
if encName != "" {
cd += "; " + encName
}
w.Header().Set("Content-Disposition", cd)
w.Header().Set("X-Excel-Filename", url.QueryEscape(filename))
w.WriteHeader(http.StatusOK)
_, _ = w.Write(buf.Bytes())
}
// sendExcelWithGuide 生成带「填写说明」页的导入模板(2026-11-10:与 MES 模板对齐,含示例行+字段说明)。
// 数据页仍用 buildXlsx,额外追加一个说明 sheet;导入端只读第一个 sheet,说明页不影响解析。
func sendExcelWithGuide(w http.ResponseWriter, filename string, headers []string, rows [][]any, guides []string) {
buf, err := buildXlsx(headers, rows)
if err != nil {
fail(w, http.StatusInternalServerError, "生成 Excel 失败: "+err.Error())
return
}
f, err := excelize.OpenReader(bytes.NewReader(buf.Bytes()))
if err != nil {
fail(w, http.StatusInternalServerError, "生成 Excel 说明页失败: "+err.Error())
return
}
defer f.Close()
if _, err = f.NewSheet("填写说明"); err != nil {
fail(w, http.StatusInternalServerError, "生成 Excel 说明页失败: "+err.Error())
return
}
for i, g := range guides {
cell, _ := excelize.CoordinatesToCellName(1, i+1)
_ = f.SetCellValue("填写说明", cell, g)
}
_ = f.SetColWidth("填写说明", "A", "A", 110)
out, err := f.WriteToBuffer()
if err != nil {
fail(w, http.StatusInternalServerError, "生成 Excel 失败: "+err.Error())
return
}
asciiName := "export.xlsx"
encName := ""
if utf8.ValidString(filename) {
encName = "filename*=UTF-8''" + url.QueryEscape(filename)
}
w.Header().Set("Content-Type", "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet")
cd := fmt.Sprintf("attachment; filename=\"%s\"", asciiName)
if encName != "" {
cd += "; " + encName
}
w.Header().Set("Content-Disposition", cd)
w.Header().Set("X-Excel-Filename", url.QueryEscape(filename))
w.WriteHeader(http.StatusOK)
_, _ = w.Write(out.Bytes())
}
// buildXlsx 生成 xlsx 字节流(含表头样式、列宽自适应)
func buildXlsx(headers []string, rows [][]any) (*bytes.Buffer, error) {
f := excelize.NewFile()
defer f.Close()
sheet := f.GetSheetName(0)
for i, h := range headers {
cell, _ := excelize.CoordinatesToCellName(i+1, 1)
_ = f.SetCellValue(sheet, cell, h)
}
style, _ := f.NewStyle(&excelize.Style{
Font: &excelize.Font{Bold: true},
Fill: excelize.Fill{Type: "pattern", Color: []string{"D9E1F2"}, Pattern: 1},
Alignment: &excelize.Alignment{Horizontal: "center", Vertical: "center"},
})
_ = f.SetRowStyle(sheet, 1, 1, style)
for r, row := range rows {
for c, v := range row {
cell, _ := excelize.CoordinatesToCellName(c+1, r+2)
_ = f.SetCellValue(sheet, cell, v)
}
}
// 列宽按显示宽度估算(中文=2,ASCII=1,宁宽勿窄)
widths := make([]float64, len(headers))
for c := range headers {
widths[c] = float64(displayWidth(headers[c]) + 2)
}
for _, row := range rows {
for c, v := range row {
if c >= len(widths) {
break
}
cw := float64(displayWidth(fmt.Sprintf("%v", v)) + 2)
if cw > widths[c] {
widths[c] = cw
}
}
}
for c, wd := range widths {
col, _ := excelize.ColumnNumberToName(c + 1)
_ = f.SetColWidth(sheet, col, col, wd)
}
return f.WriteToBuffer()
}
// displayWidth 估算字符串在 Excel 中的显示宽度(中文=2,ASCII=1)
func displayWidth(s string) int {
n := 0
for _, r := range s {
if r > 0x2E7F { // 含中文/全角
n += 2
} else {
n++
}
}
return n
}
// manageModeLabel 类型中文名:1=结构件 2=电气件 3=其他(纯类型语境,2026-09-30 与SN行为解耦)
func manageModeLabel(m int) string {
switch m {
case 1:
return "结构件"
case 2:
return "电气件"
case invManageOther:
return "其他"
}
return "-"
}
// snModeLabel 序列号中文名:1=序列号=是 2=序列号=否(2026-09-30 解耦定稿)
func snModeLabel(v int) string {
switch v {
case snModeSN:
return "序列号=是"
case snModeBatch:
return "序列号=否"
}
return "-"
}
// locLabel 拼接完整库位串:大区/货架/层/位置,跳过空段(方案 E 库位四级贯通)。
// 例:"Z01/A架/3层/12位";仅有大区时返回大区;全空返回 "-"。
func locLabel(zoneCode, shelfNo, layerNo, positionNo string) string {
parts := make([]string, 0, 4)
if zoneCode != "" {
parts = append(parts, zoneCode)
}
if shelfNo != "" {
parts = append(parts, shelfNo+"架")
}
if layerNo != "" {
parts = append(parts, layerNo+"层")
}
if positionNo != "" {
parts = append(parts, positionNo+"位")
}
if len(parts) == 0 {
return "-"
}
return strings.Join(parts, "/")
}
// unixFmt 把 unix 秒转成 yyyy-MM-dd HH:mm:ss(时间戳<=0 返回空串)
func unixFmt(ts int64) string {
if ts <= 0 {
return ""
}
return time.Unix(ts, 0).Format("2006-01-02 15:04:05")
}
// intOrDash 数量列导出:0=未填 显示 "-"(如检验记录 第几批/共几件)
func intOrDash(v int) any {
if v == 0 {
return "-"
}
return v
}
// inspectionTypeLabel 检验类型中文名
func inspectionTypeLabel(t string) string {
switch t {
case "incoming":
return "来料检"
case "process":
return "过程检"
case "finished":
return "成品检"
}
return t
}
// importErr 单行校验错误(行号 + 物料 + 原因),用于"全失败"时回给前端定位
type importErr struct {
Row int `json:"row"`
MaterialCode string `json:"materialCode"`
Message string `json:"message"`
}
// excelInboundHandler Excel 批量导入入库
// mode=batch(序列号=否) 列头(首行忽略):
//
// 图号 | 数量 | 生产日期 | 供应商 | 区域 | 架 | 层 | 位 | 备注 | 检测单号 | 产品工号 | 归属类型 | 归属编号
//
// 批次号不再出现在模板中(2026-10-21 批次号收口):一律由系统自动生成(物料编码-日期-流水号)。
// mode=sn(序列号=是) 列头(首行忽略):
//
// 图号 | SN | 区域 | 生产日期 | 供应商 | 架 | 层 | 位 | 备注 | 检测单号 | 产品工号 | 归属类型 | 归属编号
//
// 新增列(架/层/位/备注/检测单号/产品工号/归属) 均为【可选、追加在末尾】,老模板文件缺这些列仍可导入(对应字段留空)。
// 归属类型填 workorder/project/other(其他值按 other 处理);workorder/project 必须同时填归属编号,other 可不填。
//
// 强约束:全成功或全失败(一次性全导入 or 全失败,禁止部分成功)。
// 流程:阶段1 逐行解析+校验(物料存在/数量>0/SN不重复/区域必填/归属编号规则) → 任一错则整体拒绝并列出错误行(一行不写);
// 阶段2 全部通过 → 开启单事务,整体提交,任一步失败整体回滚。
// excelInboundImportTemplateHandler 入库批量导入模板下载(2026-10-21):
// ?mode=batch 序列号=否(按批次记账)模板;?mode=sn 序列号=是(按 SN 记账)模板。
// 第1行表头 + 第2行示例数据(导入前请删除),列顺序与 /inbound/batch-excel 解析一致(批次号由系统自动生成,模板不含该列)。
func excelInboundImportTemplateHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
mode := r.URL.Query().Get("mode")
var headers []string
var rows [][]any
if mode == "sn" {
headers = []string{"图号", "序列号", "区域", "生产日期", "供应商", "架", "层", "位", "备注", "检测单号", "产品工号", "归属类型", "归属编号"}
rows = [][]any{
{"DX100-001", "SN0001", "A区", "2026-10-21", "示例供应商", "1", "1", "1", "示例备注", "Jian001", "WO-20261021-001", "workorder", "HT-001"},
}
sendExcel(w, "入库序列号导入模板.xlsx", headers, rows)
return
}
headers = []string{"图号", "数量", "生产日期", "供应商", "区域", "架", "层", "位", "备注", "检测单号", "产品工号", "归属类型", "归属编号"}
rows = [][]any{
{"DX100-001", "100", "2026-10-21", "示例供应商", "A区", "1", "1", "1", "示例备注", "Jian001", "WO-20261021-001", "workorder", "HT-001"},
}
sendExcel(w, "入库批次导入模板.xlsx", headers, rows)
}
}
func excelInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
if err := r.ParseMultipartForm(20 << 20); err != nil {
fail(w, http.StatusBadRequest, "文件上传失败: "+err.Error())
return
}
mode := r.FormValue("mode")
if mode != "sn" {
mode = "batch"
}
f, _, err := r.FormFile("file")
if err != nil {
fail(w, http.StatusBadRequest, "缺少 file 字段")
return
}
defer f.Close()
xl, err := excelize.OpenReader(f)
if err != nil {
fail(w, http.StatusBadRequest, "无法解析 Excel: "+err.Error())
return
}
defer xl.Close()
sheet := xl.GetSheetList()[0]
rows, err := xl.GetRows(sheet)
if err != nil {
fail(w, http.StatusBadRequest, "读取工作表失败: "+err.Error())
return
}
if len(rows) <= 1 {
fail(w, http.StatusBadRequest, "文件无数据行(首行为表头,需至少一行数据)")
return
}
// ---- 阶段1:解析 + 校验(不落库)——与预检端点 excelInboundPreviewHandler 共用同一函数,规则同源 ----
plans, errs, _ := parseInboundImportPlan(ctx, rows, mode)
// ---- 阶段2:有错则整体拒绝,一行都不写 ----
if len(errs) > 0 {
ok(w, map[string]any{"success": 0, "failed": len(errs), "errors": errs})
return
}
// ---- 阶段3:全部通过 → 单事务整体提交(原子,全成功或全失败) ----
tx, e := ctx.EntClient.Tx(ctx0())
if e != nil {
fail(w, http.StatusInternalServerError, "开启事务失败: "+e.Error())
return
}
var generatedNos []string
committed := false
defer func() {
if !committed {
_ = tx.Rollback()
}
}()
for _, pr := range plans {
inboundNo, _ := nextDailyNo(ctx, "IB")
generatedNos = append(generatedNos, inboundNo)
m, _ := tx.Material.Query().Where(material.CodeEQ(pr.code)).Only(ctx0())
if mode == "sn" {
if _, e = tx.Inventory.Create().
SetManageMode(m.ManageMode).
SetSnMode(m.SnMode).
SetMaterialCode(pr.code).
SetNillableMaterialName(strPtr(m.Name)).
SetSnCode(pr.sn).
SetQuantity(1).SetLockedQty(0).
SetQualityStatus("未检").
SetNillableProductionDate(strPtr(pr.prodDate)).
SetNillableSupplier(strPtr(pr.supplier)).
SetNillableZoneCode(strPtr(pr.zone)).
SetNillableShelfNo(strPtr(pr.shelfNo)).
SetNillableLayerNo(strPtr(pr.layerNo)).
SetNillablePositionNo(strPtr(pr.positionNo)).
SetNillableProductWorkNo(strPtr(pr.productWorkNo)).
SetNillableOwnershipType(strPtr(pr.ownershipType)).
SetNillableOwnershipNo(strPtr(pr.ownershipNo)).
SetStatus("在库").
SetInboundNo(inboundNo).
Save(ctx0()); e != nil {
fail(w, http.StatusInternalServerError, "创建 SN 库存失败: "+e.Error())
return
}
if _, e = tx.InboundDetail.Create().
SetInboundNo(inboundNo).SetSnCode(pr.sn).SetMaterialCode(pr.code).SetQuantity(1).
Save(ctx0()); e != nil {
fail(w, http.StatusInternalServerError, "创建入库明细失败: "+e.Error())
return
}
} else {
// 批次号一律系统自动生成(物料编码-日期-流水号);同一导入内多行自动取得递增流水,天然唯一
batchNo := genBatchNo(ctx, pr.code)
existing, e2 := tx.Inventory.Query().
Where(inventory.SnModeEQ(snModeBatch), inventory.BatchNoEQ(batchNo)).Only(ctx0())
if e2 == nil {
if _, e = tx.Inventory.UpdateOneID(existing.ID).
AddQuantity(pr.qty).
SetNillableSupplier(strPtr(pr.supplier)).
SetNillableProductWorkNo(strPtr(pr.productWorkNo)).
SetNillableShelfNo(strPtr(pr.shelfNo)).
SetNillableLayerNo(strPtr(pr.layerNo)).
SetNillablePositionNo(strPtr(pr.positionNo)).
Save(ctx0()); e != nil {
fail(w, http.StatusInternalServerError, "追加批次失败: "+e.Error())
return
}
} else {
if _, e = tx.Inventory.Create().
SetManageMode(m.ManageMode).
SetSnMode(m.SnMode).
SetBatchNo(batchNo).
SetMaterialCode(pr.code).
SetNillableMaterialName(strPtr(m.Name)).
SetQuantity(pr.qty).SetLockedQty(0).
SetNillableProductionDate(strPtr(pr.prodDate)).
SetNillableSupplier(strPtr(pr.supplier)).
SetQualityStatus("未检").
SetNillableZoneCode(strPtr(pr.zone)).
SetNillableShelfNo(strPtr(pr.shelfNo)).
SetNillableLayerNo(strPtr(pr.layerNo)).
SetNillablePositionNo(strPtr(pr.positionNo)).
SetNillableProductWorkNo(strPtr(pr.productWorkNo)).
SetNillableOwnershipType(strPtr(pr.ownershipType)).
SetNillableOwnershipNo(strPtr(pr.ownershipNo)).
SetStatus("在库").
SetInboundNo(inboundNo).
Save(ctx0()); e != nil {
fail(w, http.StatusInternalServerError, "创建库存失败: "+e.Error())
return
}
}
if _, e = tx.InboundDetail.Create().
SetInboundNo(inboundNo).SetBatchNo(batchNo).SetMaterialCode(pr.code).SetQuantity(pr.qty).
Save(ctx0()); e != nil {
fail(w, http.StatusInternalServerError, "创建入库明细失败: "+e.Error())
return
}
}
if _, e = tx.InboundOrder.Create().
SetInboundNo(inboundNo).
SetNillableInboundType(strPtr("purchase")).
SetMaterialCode(pr.code).
SetNillableMaterialName(strPtr(m.Name)).
SetManageMode(m.ManageMode).
SetSnMode(m.SnMode).
SetNillableZoneCode(strPtr(pr.zone)).
SetNillableShelfNo(strPtr(pr.shelfNo)).
SetNillableLayerNo(strPtr(pr.layerNo)).
SetNillablePositionNo(strPtr(pr.positionNo)).
SetQuantity(ternary(mode == "sn", 1, pr.qty)).
SetNillableRemark(strPtr(pr.remark)).
SetInspectionNo(pr.inspectionNo).
SetOwnershipType(ownershipTypeOrNone(pr.ownershipType)).
SetNillableOwnershipNo(strPtr(pr.ownershipNo)).
SetNillableProductWorkNo(strPtr(pr.productWorkNo)).
SetNillableQualityStatus(strPtr("未检")).
SetOperator("excel-import").
Save(ctx0()); e != nil {
fail(w, http.StatusInternalServerError, "创建入库单失败: "+e.Error())
return
}
}
if e = tx.Commit(); e != nil {
fail(w, http.StatusInternalServerError, "提交事务失败: "+e.Error())
return
}
committed = true
ok(w, map[string]any{
"success": len(plans),
"failed": 0,
"errors": []importErr{},
"inboundNos": generatedNos, // 每张入库单生成的单号(与导入行一一对应)
})
}
}
// inboundImportPlan 入库导入单行写入计划(预检与写入共用同一解析/校验,规则同源不漂移)。
type inboundImportPlan struct {
row int
code string
sn string
qty int
prodDate string
supplier string
zone string
remark string
shelfNo string
layerNo string
positionNo string
inspectionNo string
productWorkNo string
ownershipType string
ownershipNo string
}
// parseInboundImportPlan 入库导入阶段1:解析 + 逐行校验(只读不落库):
// 物料存在/数量>0/SN 不重复/区域与货位必填/归属编号规则。返回行计划、逐行错误与总数据行数。
func parseInboundImportPlan(ctx *svc.ServiceContext, rows [][]string, mode string) ([]inboundImportPlan, []importErr, int) {
total := len(rows) - 1
plans := make([]inboundImportPlan, 0, total)
errs := make([]importErr, 0)
snSeen := map[string]bool{}
for i, row := range rows {
if i == 0 {
continue // 表头
}
cell := func(idx int) string {
if idx < len(row) {
return strings.TrimSpace(row[idx])
}
return ""
}
pr := inboundImportPlan{row: i + 1}
pr.code = cell(0)
if mode == "sn" {
// 图号|SN|区域|生产日期|供应商|架|层|位|备注|检测单号|产品工号|归属类型|归属编号
pr.sn = cell(1)
pr.zone = cell(2)
pr.prodDate = cell(3)
pr.supplier = cell(4)
pr.shelfNo = cell(5)
pr.layerNo = cell(6)
pr.positionNo = cell(7)
pr.remark = cell(8)
pr.inspectionNo = cell(9)
pr.productWorkNo = cell(10)
pr.ownershipType = cell(11)
pr.ownershipNo = cell(12)
} else {
// 图号|数量|生产日期|供应商|区域|架|层|位|备注|检测单号|产品工号|归属类型|归属编号(批次号由系统自动生成,模板不再含该列)
pr.qty = atoi(cell(1), 0)
pr.prodDate = cell(2)
pr.supplier = cell(3)
pr.zone = cell(4)
pr.shelfNo = cell(5)
pr.layerNo = cell(6)
pr.positionNo = cell(7)
pr.remark = cell(8)
pr.inspectionNo = cell(9)
pr.productWorkNo = cell(10)
pr.ownershipType = cell(11)
pr.ownershipNo = cell(12)
}
if pr.code == "" {
errs = append(errs, importErr{pr.row, pr.code, "图号为空"})
continue
}
m, e := ctx.EntClient.Material.Query().Where(material.CodeEQ(pr.code)).Only(ctx0())
if e != nil {
errs = append(errs, importErr{pr.row, pr.code, "物料不存在"})
continue
}
if mode == "sn" {
if m.SnMode != snModeSN {
errs = append(errs, importErr{pr.row, pr.code, "该物料序列号=否(按数量管理),SN 导入仅支持序列号=是(逐件SN)"})
continue
}
if pr.sn == "" {
errs = append(errs, importErr{pr.row, pr.code, "SN 为空"})
continue
}
if snSeen[pr.sn] {
errs = append(errs, importErr{pr.row, pr.code, "SN 在文件中重复: " + pr.sn})
continue
}
snSeen[pr.sn] = true
exists, _ := ctx.EntClient.Inventory.Query().
Where(inventory.SnModeEQ(snModeSN), inventory.SnCodeEQ(pr.sn)).Exist(ctx0())
if exists {
errs = append(errs, importErr{pr.row, pr.code, "SN 已存在: " + pr.sn})
continue
}
} else {
if m.SnMode != snModeBatch {
errs = append(errs, importErr{pr.row, pr.code, "该物料序列号=是(逐件SN管理),请使用 SN 导入"})
continue
}
if pr.qty <= 0 {
errs = append(errs, importErr{pr.row, pr.code, "数量必须大于 0"})
continue
}
}
if pr.zone == "" {
errs = append(errs, importErr{pr.row, pr.code, "区域为空(必填)"})
continue
}
// 货位必填(货架/层/位置):与手动录入(InboundEntry)口径一致,杜绝"有区域无货架"脏数据;任一为空则整批拒绝
if pr.shelfNo == "" || pr.layerNo == "" || pr.positionNo == "" {
errs = append(errs, importErr{pr.row, pr.code, "货位不完整(货架/层/位置均为必填)"})
continue
}
// 归属校验(与手动录入口径一致:workorder/project 必填编号;other/空 不需要)
pr.ownershipType = ownershipTypeOrNone(pr.ownershipType)
if pr.ownershipType == "workorder" || pr.ownershipType == "project" {
if pr.ownershipNo == "" {
errs = append(errs, importErr{pr.row, pr.code, "归属类型为" + pr.ownershipType + "时归属编号必填"})
continue
}
}
plans = append(plans, pr)
}
return plans, errs, total
}
// excelInboundPreviewHandler POST /api/inbound/batch-excel/preview 入库导入预检(只读):
// 复用写入端点的阶段1校验(parseInboundImportPlan,同一函数保证规则同源),不写任何数据。
// 返回 {total 总行数, success 将成功行数, failed 失败行数, errors 逐行失败原因(行号+图号+原因)}。
func excelInboundPreviewHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
if err := r.ParseMultipartForm(20 << 20); err != nil {
fail(w, http.StatusBadRequest, "文件上传失败: "+err.Error())
return
}
mode := r.FormValue("mode")
if mode != "sn" {
mode = "batch"
}
f, _, err := r.FormFile("file")
if err != nil {
fail(w, http.StatusBadRequest, "缺少 file 字段")
return
}
defer f.Close()
xl, err := excelize.OpenReader(f)
if err != nil {
fail(w, http.StatusBadRequest, "无法解析 Excel: "+err.Error())
return
}
defer xl.Close()
sheet := xl.GetSheetList()[0]
rows, err := xl.GetRows(sheet)
if err != nil {
fail(w, http.StatusBadRequest, "读取工作表失败: "+err.Error())
return
}
if len(rows) <= 1 {
fail(w, http.StatusBadRequest, "文件无数据行(首行为表头,需至少一行数据)")
return
}
plans, errs, total := parseInboundImportPlan(ctx, rows, mode)
if errs == nil {
errs = []importErr{}
}
ok(w, map[string]any{"total": total, "success": len(plans), "failed": len(errs), "errors": errs})
}
}
// ternary 小工具:condition 为真返回 a,否则 b
func ternary(cond bool, a, b int) int {
if cond {
return a
}
return b
}