Files
bj_power/bj_power_mes/internal/handler/settings.go
T
SunYF 42bcf395d2 feat: AGV三段链安全机制、补料/损耗/下班闭环、接驳台左右互换
AGV 调度:
- 任务重构为 GO_LOAD/TRANSPORT/EMPTY_RETURN/FREE 三段链,到位即停(ARRIVED)需人工确认装卸
- 自由调度单点步进,每段强制弹"请确保路径畅通无杂物";托盘回收独立工作台
- 接驳台 PLC 传感器检测到托盘即自动卸货放行,传感器故障由人工按钮兜底(无轮询)
- 车辆状态只读展示(海康3.1.7 queryAgvStatus),调度仍由 RCS 负责

物料闭环:
- 补料管理(SHORTAGE):工位申请 + 主管审批调增叫料池额度,与借料/差异补发三轨并行
- 损耗台账(loss_ledger):退料实际 < 理论必填原因、后审核,工单不记损耗
- 退料强制指定左/右接驳台,WMS 库管可代工位退料

下班闭环:
- 工位终端自检接驳台剩余物料后下班;库管收货 + 托盘拉走后事件驱动自动结班
- 退出登录未下班仅作安全提示(不强制拦截、不新增责任审批)

接驳台左右按操作员朝向建模(dock.side 字段),废除"奇左偶右"隐式约定;
看板标签 / seed / 迁移补丁 / 布局文档统一为中文左/右。

产线布局说明:C1 前线头 AGV 点、C15 后线尾 AGV 点、外部 O1/O2/O3 散点,
清理修订痕迹为最终态描述。
2026-11-03 18:29:31 +08:00

95 lines
3.0 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 (
"context"
"net/http"
"time"
"bj_power_mes/common/httpx"
"bj_power_mes/internal/logic"
"bj_power_mes/internal/svc"
"github.com/zeromicro/go-zero/core/logx"
)
// SettingsHandler GET /api/v1/settings 基础设置 + 本机基础信息(只读)
func SettingsHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
data, err := logic.New(svcCtx).GetSettings(r.Context())
if err != nil {
httpx.Fail(w, 2501, err.Error())
return
}
httpx.Ok(w, data)
}
}
// SaveSettingsHandler PUT /api/v1/settings 保存基础设置(WMS 地址热切换;sys.settings:edit 权限)
func SaveSettingsHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
var req logic.SettingsReq
if err := httpx.ParseJSON(r, &req); err != nil {
httpx.BadRequest(w, "请求体解析失败")
return
}
if err := logic.New(svcCtx).SaveSettings(r.Context(), req, operator(r, "")); err != nil {
httpx.Fail(w, 2502, err.Error())
return
}
httpx.OkMessage(w, "已保存并生效", nil)
}
}
// WmsTestHandler GET /api/v1/settings/wms-test?url= 测试 WMS 连通性(url 为空测当前生效地址)
func WmsTestHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
msg, err := logic.New(svcCtx).TestWms(r.Context(), r.URL.Query().Get("url"))
if err != nil {
httpx.Fail(w, 2503, err.Error())
return
}
httpx.OkMessage(w, msg, nil)
}
}
// PublicConfigHandler GET /api/internal/public-config 受信内部端(工位终端)读取的公开配置快照:
// 拧紧手填开关 / 多工单缓存策略 / AGV 卸货超时等,供终端按配置显隐或约束交互(2026-11-03 拍板)。
// 仅需内部 X-API-TOKEN,不绑定工位会话。
func PublicConfigHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
vo, err := logic.New(svcCtx).GetSettings(r.Context())
if err != nil {
httpx.Fail(w, 2504, "读取配置失败")
return
}
httpx.Ok(w, map[string]any{
"torqueManualInput": vo.TorqueManualInput,
"multiOrderCachePolicy": vo.MultiOrderCachePolicy,
"agvUnloadTimeoutMinutes": vo.AgvUnloadTimeoutMinutes,
})
}
}
// StartEventLogRetention 事件日志保留期清理:每小时检查一次(保留天数在「基础设置」页
// 配置 eventlog.retention.days,0=不清理),删除超过保留期的操作日志。
func StartEventLogRetention(ctx *svc.ServiceContext) {
go func() {
ticker := time.NewTicker(time.Hour)
defer ticker.Stop()
for range ticker.C {
days := logic.New(ctx).CfgInt(context.Background(), logic.CfgLogRetention, 0)
if days <= 0 {
continue
}
n, err := ctx.EventLog.CleanupBefore(context.Background(), time.Now().AddDate(0, 0, -days))
if err != nil {
logx.Errorf("事件日志清理失败: %v", err)
continue
}
if n > 0 {
logx.Infof("事件日志保留 %d 天:已清理 %d 条过期记录", days, n)
}
}
}()
}