Files
bj_power/bj_power_mes/bj_power_mes.go
T
SunYF 46fcb59079 feat: 退料闭环定稿(损耗台账/备料清单/退料AGV自动派车/剩余量参考)+ 工位托盘守卫
- MES 新增损耗台账 loss_ledger,差异确认损耗接口 ConfirmReceiveLoss(按工单归集)
- 备料清单 preparation:MES 按 日计划×工单×工位×物料 实时计算,WMS 只读展示 PreparationList
- 退料闭环:N5 工位托盘守卫(未完成禁止退料)、退料 AGV 自动派车(JBT21 空位判定 + 托盘回收链路)、退料参考剩余量接口(应剩余=实备-已耗-已退-已损)
- 新增 AGV 车辆状态表 agv_vehicle_state 及查询
- 整合接驳台/叫料池/库存锁既有闭环,清理 sql 目录注释生成脚本与 catalog,更新文档
2026-11-04 19:06:03 +08:00

375 lines
13 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 main
import (
"bufio"
"context"
"crypto/md5"
"crypto/subtle"
"embed"
"encoding/hex"
"flag"
"fmt"
"io"
"io/fs"
"net/http"
"os"
"os/exec"
"path"
"path/filepath"
"runtime"
"strings"
"time"
"bj_power_mes/common/logx"
"bj_power_mes/internal/config"
"bj_power_mes/internal/db"
"bj_power_mes/internal/eventlog"
"bj_power_mes/internal/handler"
"bj_power_mes/internal/logic"
"bj_power_mes/internal/scanbridge"
"bj_power_mes/internal/svc"
"github.com/zeromicro/go-zero/core/conf"
gologx "github.com/zeromicro/go-zero/core/logx"
"github.com/zeromicro/go-zero/rest"
)
// 前端静态资源(Vue 构建产物:frontend/ npm run build 输出到 public/)。
// 8888 一个端口同时提供管理后台页面与 API。
//
//go:embed all:public
var webFS embed.FS
var configFile = flag.String("f", "etc/bj_power_mes-api.yaml", "the config file")
// promptPassword 从终端读取一行输入(不隐藏回显,用于运维终端操作)
func promptPassword(msg string) string {
fmt.Print(msg)
line, _ := bufio.NewReader(os.Stdin).ReadString('\n')
return strings.TrimRight(line, "\r\n")
}
// adminGate 管理员密码门禁:敏感命令行操作(migrate/seed/reset-all)必须输入与配置
// Cli.AdminPassword 一致的密码才放行;校验失败记录日志并终止,绝不继续执行。
func adminGate(c config.Config) bool {
pwd := promptPassword("请输入管理员密码以执行 [" + flag.Arg(0) + "]: ")
if subtle.ConstantTimeCompare([]byte(pwd), []byte(c.Cli.AdminPassword)) != 1 {
gologx.Errorf("敏感命令 [%s] 因管理员密码校验失败被终止", flag.Arg(0))
fmt.Println("管理员密码不正确,已终止该操作。")
return false
}
gologx.Infof("敏感命令 [%s] 已通过管理员密码校验", flag.Arg(0))
return true
}
// newSvc 最小 ServiceContext(CLI 场景:只连库 + 事件日志写入器)
func newSvc(c config.Config) *svc.ServiceContext {
client, _ := db.MustNewDB(c.Database)
return &svc.ServiceContext{
Config: c,
EntClient: client,
EventLog: eventlog.NewWriter(client),
}
}
// runMigrate 建库(若不存在)+ 建表/补列/清理旧结构(幂等,不删业务数据)
func runMigrate(c config.Config) {
if err := db.EnsureDB(c.Database); err != nil {
gologx.Errorf("ensure database failed: %v", err)
os.Exit(1)
}
client, sqlDB := db.MustNewDB(c.Database)
defer client.Close()
defer sqlDB.Close()
if err := db.EnsureSchema(client, sqlDB); err != nil {
gologx.Errorf("migrate failed: %v", err)
os.Exit(1)
}
fmt.Println("migrate: 数据库结构迁移成功(建表/补列/清理退役结构,未删除业务数据)。")
}
// runSeed 建库建表(若不存在)+ 灌基础种子(工位/接驳台/权限等,不删数据)
func runSeed(c config.Config) {
if err := db.EnsureDB(c.Database); err != nil {
gologx.Errorf("ensure database failed: %v", err)
os.Exit(1)
}
client, sqlDB := db.MustNewDB(c.Database)
defer client.Close()
defer sqlDB.Close()
if err := db.EnsureSchema(client, sqlDB); err != nil {
gologx.Errorf("seed migrate failed: %v", err)
os.Exit(1)
}
s := logic.New(newSvc(c))
if err := s.Seed(context.Background()); err != nil {
gologx.Errorf("seed failed: %v", err)
os.Exit(1)
}
fmt.Println("seed: 基础数据已对齐(工位/接驳台/权限等)。")
}
// runResetAll 清空并重建全部表 + 重灌全部种子。此操作不可恢复!
func runResetAll(c config.Config) {
if err := db.EnsureDB(c.Database); err != nil {
gologx.Errorf("ensure database failed: %v", err)
os.Exit(1)
}
if err := db.DropAllTables(c.Database); err != nil {
gologx.Errorf("reset-all drop failed: %v", err)
os.Exit(1)
}
client, sqlDB := db.MustNewDB(c.Database)
defer client.Close()
defer sqlDB.Close()
if err := db.EnsureSchema(client, sqlDB); err != nil {
gologx.Errorf("reset-all migrate failed: %v", err)
os.Exit(1)
}
s := logic.New(newSvc(c))
if err := s.Seed(context.Background()); err != nil {
gologx.Errorf("reset-all seed failed: %v", err)
os.Exit(1)
}
fmt.Println("reset-all: 已清空并重建全部表,写入基础数据(管理员 admin/123456)。")
}
// newStaticHandler 嵌入式静态文件:命中则直接返回;未命中的非 /api 路径
// 回退到 index.html(SPA history 路由),由浏览器端 Vue Router 接管。
func newStaticHandler(fsys embed.FS) http.Handler {
sub, err := fs.Sub(fsys, "public")
if err != nil {
panic(fmt.Sprintf("嵌入静态目录不可用: %v", err))
}
fileServer := http.FileServer(http.FS(sub))
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
name := strings.TrimPrefix(path.Clean(r.URL.Path), "/")
if name == "" {
name = "index.html"
}
if f, openErr := sub.Open(name); openErr == nil {
f.Close()
fileServer.ServeHTTP(w, r)
return
}
r2 := r.Clone(r.Context())
r2.URL.Path = "/"
fileServer.ServeHTTP(w, r2)
})
}
// openBrowser 用系统默认浏览器打开 url(Windows/macOS/Linux)
func openBrowser(url string) {
var cmd *exec.Cmd
switch runtime.GOOS {
case "windows":
cmd = exec.Command("rundll32", "url.dll,FileProtocolHandler", url)
case "darwin":
cmd = exec.Command("open", url)
default:
cmd = exec.Command("xdg-open", url)
}
if err := cmd.Start(); err != nil {
gologx.Errorf("自动打开浏览器失败(%s): %v", url, err)
}
}
// logRuntimeBinaryFingerprint 在启动早期打印当前运行 EXE 的指纹(真实路径/大小/MD5/修改时间),
// 走本项目 logx(go-zero)落盘,与业务日志同文件,便于生产机直接翻日志核对运行版本。
// 任何环节失败仅记错误日志并继续,绝不中断启动。
func logRuntimeBinaryFingerprint() {
exePath, err := os.Executable()
if err != nil {
gologx.Errorf("svc: runtime binary fingerprint skipped: os.Executable failed: %v", err)
return
}
realPath, err := filepath.EvalSymlinks(exePath)
if err != nil {
// 解析软链接失败:降级用原始路径,仅记日志不影响启动
gologx.Errorf("svc: runtime binary fingerprint: EvalSymlinks failed, fallback to raw path: %v", err)
realPath = exePath
}
info, err := os.Stat(realPath)
if err != nil {
gologx.Errorf("svc: runtime binary fingerprint skipped: os.Stat failed: %v", err)
return
}
f, err := os.Open(realPath)
if err != nil {
gologx.Errorf("svc: runtime binary fingerprint skipped: open failed: %v", err)
return
}
defer f.Close()
h := md5.New()
if _, err := io.Copy(h, f); err != nil {
gologx.Errorf("svc: runtime binary fingerprint skipped: read failed: %v", err)
return
}
gologx.Infof("svc: runtime binary fingerprint path=%s size=%d md5=%s modTime=%s",
realPath, info.Size(), hex.EncodeToString(h.Sum(nil)), info.ModTime().Format("2006-01-02 15:04:05"))
}
func main() {
flag.Parse()
var c config.Config
conf.MustLoad(*configFile, &c)
// 按天日志:logs/bj_power_mes-2026-01-02.log,保留 30 天(go-zero logx Writer 适配 slog)
if c.Logger.Filename != "" {
logger := logx.NewLogger(c.Logger)
logx.SetDefault(logger)
gologx.SetWriter(logger)
}
// 启动指纹:打印当前 EXE 真实路径/大小/MD5/修改时间,便于核对运行版本
logRuntimeBinaryFingerprint()
// 命令行子命令:DDL/删库/种子等敏感操作一律显式触发 + 管理员密码门禁,
// 绝不随服务启动自动执行(migrate / seed / reset-all / serve)。
switch cmd := flag.Arg(0); cmd {
case "reset-all":
fmt.Println("reset-all: 即将清空并重建 MES 全部表,此操作不可恢复!")
if !adminGate(c) {
os.Exit(1)
}
runResetAll(c)
return
case "seed":
if !adminGate(c) {
os.Exit(1)
}
runSeed(c)
return
case "migrate":
if !adminGate(c) {
os.Exit(1)
}
runMigrate(c)
return
case "", "serve":
// 正常启动服务:落到下方启动逻辑
default:
fmt.Println("未知命令: " + cmd + ";可用命令: migrate / seed / reset-all / serve")
os.Exit(1)
}
staticHandler := newStaticHandler(webFS)
// 兜底路由:已注册的 /api/* 走正常匹配;未注册的非 /api 路径走嵌入式静态资源
//(/api 下未注册的路径仍返回 404,不回退页面)
notFound := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
if strings.HasPrefix(r.URL.Path, "/api/") || r.URL.Path == "/api" {
http.NotFound(w, r)
return
}
staticHandler.ServeHTTP(w, r)
})
server := rest.MustNewServer(c.RestConf,
rest.WithNotFoundHandler(notFound),
// JWT 鉴权失败统一回调(条17):401 业务码 JSON,前端据此跳登录页。
// 仅作用于 JWT 保护路由(/api/v1 业务组),内部 X-API-TOKEN 路由不走此回调。
rest.WithUnauthorizedCallback(func(w http.ResponseWriter, r *http.Request, err error) {
w.Header().Set("Content-Type", "application/json; charset=utf-8")
w.WriteHeader(http.StatusUnauthorized)
_, _ = w.Write([]byte(`{"code":401,"message":"登录已过期,请重新登录"}`))
}),
)
defer server.Stop()
ctx := svc.NewServiceContext(c)
// 扫码中间件(键盘 HID 注入):默认关闭(Scanner.Enabled=false),需在 yaml 启用并重启。
// 与 WMS 同机且都开时,7757 谁先启动谁监听,后到的只记日志、不影响主程序。
if c.Scanner.Enabled {
go func() {
if err := scanbridge.Start(context.Background(), scanbridge.Options{}); err != nil {
gologx.Errorf("扫码中间件启动失败(不影响主程序): %v", err)
}
}()
}
// PLC↔MES 对账(#8 T6):PLC 通讯恢复回调——连续失败后首次成功沿触发一次全量对账。
// mock 模式无失败,不触发;真实 S7 连接恢复时触发 CheckAllMismatch(落预警中心)。
ctx.PLC.SetOnRecover(func(recoverCtx context.Context) {
if _, err := logic.New(ctx).CheckAllMismatch(recoverCtx, "plc_recover", "system"); err != nil {
gologx.Errorf("PLC 恢复全量对账失败: %v", err)
}
})
// 断电恢复启动对账(#8 T8,2026-11-03 补全):服务(含产线断电重启后)冷启动时,
// 若 PLC 首连即成功则没有"失败→成功沿",T6 不会触发——这里延迟 15 秒补一次全量对账,
// 比对 PLC 托盘位实读与 MES 在制工件记录,命中落预警中心(trigger=boot),不阻断启动。
// 与 T7 管理员手动核对、T6 恢复沿互为补充:断电场景靠本兜底自动发现"PLC 有件、MES 无记录"。
go func() {
time.Sleep(15 * time.Second)
bctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
defer cancel()
if hits, err := logic.New(ctx).CheckAllMismatch(bctx, "boot", "system"); err != nil {
gologx.Errorf("启动全量对账失败(PLC 未接入或未就绪属正常): %v", err)
} else if len(hits) > 0 {
gologx.Infof("启动全量对账发现 %d 处 PLC↔MES 不一致,已落预警中心", len(hits))
}
}()
// 滑动续签(条17):全局挂载 RenewalMiddleware——每个携带有效 Bearer token 的请求
// 重签新 token 写入响应头 X-Renewed-Token,前端/工位终端据此滚动续期;
// 无 Bearer 头的请求(登录、内部 X-API-TOKEN、静态资源)原样放行。
server.Use(handler.RenewalMiddleware(ctx))
handler.RegisterRoutes(server, ctx)
handler.RegisterProductionRoutes(server, ctx)
// 磁盘空间监控:每天 DiskCheckHour 点检测附件根目录剩余空间
handler.StartDiskMonitor(ctx)
// 事件日志保留期清理:每小时检查,保留天数在「基础设置」页配置(0=不清理)
handler.StartEventLogRetention(ctx)
// 预警定时扫描器:每小时扫描工单超期(task_overdue),启用规则后才落预警
handler.StartAlertScanner(ctx)
// AGV 卸货超时扫描(2026-11-03 拍板):每分钟巡检一次,发现派发超过阈值(基础设置
// CfgAgvUnloadTimeoutMinutes,默认 5 分钟)仍未「卸货完成(状态9)」的 AGV 任务,落预警通知人工干预。
// AGV 只有把货卸到目标点位才算完成任务;若接驳台满载/设备故障无处卸货,必须报警而非靠人工确认。
go func() {
time.Sleep(20 * time.Second)
ticker := time.NewTicker(60 * time.Second)
defer ticker.Stop()
for range ticker.C {
bctx := context.Background()
timeoutMin := logic.New(ctx).CfgInt(bctx, logic.CfgAgvUnloadTimeoutMinutes, 5)
if _, err := logic.New(ctx).ScanAgvUnloadTimeout(bctx, timeoutMin); err != nil {
gologx.Errorf("AGV 卸货超时扫描失败: %v", err)
}
}
}()
// 退料 AGV 自动派车扫描(2026-11-04 口径定稿):每 10 秒一轮,拉取 WMS「PENDING+运输方式=AGV+未派车」
// 退料单,传感器检测到退料接驳台有托盘且 JBT21 有空位才自动派车(JBT21 无空位等待,库管不点派车)。
// PLC 托盘传感器为被动读取,物理上必须轮询才能"检测到";每轮仅查未派退料单,开销极小。
go func() {
time.Sleep(15 * time.Second)
ticker := time.NewTicker(10 * time.Second)
defer ticker.Stop()
for range ticker.C {
bctx := context.Background()
if _, err := logic.New(ctx).AutoDispatchReturnAGV(bctx); err != nil {
gologx.Errorf("退料 AGV 自动派车扫描失败(WMS 不可达属正常): %v", err)
}
}
}()
fmt.Printf("Starting bj_power_mes server at %s:%d...\n", c.Host, c.Port)
gologx.Infof("Starting bj_power_mes server at %s:%d...", c.Host, c.Port)
// 启动后自动打开管理后台(等 1 秒让端口就绪;Host=0.0.0.0 时用 127.0.0.1 访问)
go func() {
time.Sleep(time.Second)
openBrowser(fmt.Sprintf("http://127.0.0.1:%d", c.Port))
}()
server.Start()
}