Files
bj_power/bj_power_mes/internal/logic/dashboard_front.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

367 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 logic
import (
"context"
"strings"
"time"
)
/*
看板前端契约层(bj_power_dashboard/src/types.ts)
MES 内部保留一套“富”聚合(DashboardSnapshot:质量/报警/绩效/AGV 等,供后续扩展),
而看板对外只暴露甲方约定的正面指标(见 types.ts 注释):
- 不直接下发合格率/不良/报警等负面字段
- 当前订单卡片:合同 / 负责人 / 工期 / 完成度 / 可追溯
- 设备一律以“在线台数”等正面口径
此文件把富快照映射为前端 JSON,字段名与 types.ts 一一对应。
*/
// FrontToolState 单把工具(扫码枪 / 拧紧枪)
type FrontToolState struct {
Status string `json:"status"` // online / offline / busy / alarm
CurrentSn string `json:"currentSn,omitempty"`
ProcessedCount int `json:"processedCount"`
}
// FrontStation 工位(前端 Station)
type FrontStation struct {
ID int `json:"id"`
Name string `json:"name"`
Status string `json:"status"` // running / idle / alarm / offline
ScanGun FrontToolState `json:"scanGun"`
TighteningGun FrontToolState `json:"tighteningGun"`
CurrentSn string `json:"currentSn"`
CurrentOperator string `json:"currentOperator"`
CurrentProcess string `json:"currentProcess"` // 最近一道工序名
DoneCount int `json:"doneCount"` // 今日完成数
Paused bool `json:"paused"` // 当天已停单(前端仅图标提示)
PauseReason string `json:"pauseReason,omitempty"`
}
// FrontProduction 产能总览(前端 ProductionOverview)
type FrontProduction struct {
OutputToday int `json:"outputToday"`
TargetToday int `json:"targetToday"`
PassCount int `json:"passCount"` // 一次通过件数(替代合格率)
TorqueCount int `json:"torqueCount"`
InLine int `json:"inLine"`
DeviceOnline int `json:"deviceOnline"`
DeviceTotal int `json:"deviceTotal"`
CycleTimeMin float64 `json:"cycleTime"` // 实际生产节拍(分钟)
StationSummary StationSummary `json:"stationSummary"`
}
// FrontMovement 出入库动态(实时事件流)
type FrontMovement struct {
ID string `json:"id"`
Time string `json:"time"`
Type string `json:"type"` // in / out
Material string `json:"material"`
Qty int `json:"qty"`
Operator string `json:"operator"`
Batch string `json:"batch"` // 批次号
}
// FrontWarehouse 仓储动态(前端 WarehouseOverview,数据源 WMS 8890)
type FrontWarehouse struct {
TotalStock int `json:"totalStock"`
MaterialTypes int `json:"materialTypes"`
InboundToday int `json:"inboundToday"`
OutboundToday int `json:"outboundToday"`
LocationUsed int `json:"locationUsed"`
LocationTotal int `json:"locationTotal"`
PendingInbound int `json:"pendingInbound"`
PendingOutbound int `json:"pendingOutbound"`
Movements []FrontMovement `json:"movements"`
}
// FrontProgress 当前订单卡片(前端 ProductionProgress)
type FrontProgress struct {
OrderNo string `json:"orderNo"`
ContractNo string `json:"contractNo"`
ProductName string `json:"productName"`
Owner string `json:"owner"`
PlanStart string `json:"planStart"`
PlanEnd string `json:"planEnd"`
RemainDays int `json:"remainDays"`
TotalQty int `json:"totalQty"`
DoneQty int `json:"doneQty"`
Progress float64 `json:"progress"`
ProcessDone int `json:"processDone"`
ProcessTotal int `json:"processTotal"`
CurrentProcess string `json:"currentProcess"`
Status string `json:"status"`
TraceStepCount int `json:"traceStepCount"`
Traceable bool `json:"traceable"`
}
// FrontTrends 近 7 日产量趋势(前端 TrendData:{ production: [...] })
type FrontTrends struct {
Production []TrendPoint `json:"production"`
}
// FrontDashboard 前端全量快照(与 types.ts DashboardData 对齐;isDemo 由前端标注,不回传)
type FrontDashboard struct {
UpdatedAt string `json:"updatedAt"`
Production FrontProduction `json:"production"`
Warehouse FrontWarehouse `json:"warehouse"`
Equipment []FrontStation `json:"equipment"`
// VirtualStations 虚拟工位(OFFLINE,不连PLC):地图"虚拟工位"滚动栏展示,不混入 equipment(12 工位映射口径不变)
VirtualStations []FrontStation `json:"virtualStations"`
Progress FrontProgress `json:"progress"`
// ProgressList 当前在产订单列表(多订单轮播):进行中的工单排前,最多 6 条;
// 首条与 Progress 一致(老消费方可继续只用 progress)。
ProgressList []FrontProgress `json:"progressList"`
Traces []TraceItem `json:"traces"`
Trends FrontTrends `json:"trends"`
// Points 产线点位态(主线 15 位 / 接驳台 21 位 / 在途路径指令),驱动 2D 地图真实亮灭与流光
Points FrontPoints `json:"points"`
// Agv AGV 实时搬运任务(真实备料任务驱动;无坐标,前端按状态+目标接驳台做过渡动画)
Agv []FrontAgvRobot `json:"agv"`
// Events 实时事件流(已过滤 NG 结果项:大屏报喜不报忧,负面事件只走语音播报)
Events []EventItem `json:"events"`
// Alarms 仅用于前端语音播报(D2),不渲染到屏幕(报喜不报忧)。
Alarms []AlarmItem `json:"alarms"`
// RefreshSeconds 看板轮询兜底刷新间隔(秒,1~10),由 dashboard.refresh.seconds 配置驱动;
// 仅影响 SSE 实时通道不可用时的 HTTP 轮询周期,SSE 可用时不依赖此值。
RefreshSeconds int `json:"refreshSeconds"`
}
// DashboardFrontSnapshot 看板前端快照:富聚合 → 前端契约映射,走同一缓存(60s + 防击穿)。
func (s *Service) DashboardFrontSnapshot(ctx context.Context) (*FrontDashboard, error) {
return cachedTyped(ctx, s, "dashboard:front", dashboardTTL, func() (*FrontDashboard, error) {
rich, err := s.DashboardSnapshot(ctx)
if err != nil {
return nil, err
}
f := s.mapFrontDashboard(ctx, rich)
f.RefreshSeconds = s.CfgInt(ctx, CfgDashboardRefreshSeconds, 5)
return f, nil
})
}
// mapFrontDashboard 富快照 → 前端契约。
// 展示口径按甲方要求:负面字段(合格率/不良数/报警)一律不出现。
func (s *Service) mapFrontDashboard(ctx context.Context, r *DashboardSnapshot) *FrontDashboard {
f := &FrontDashboard{UpdatedAt: r.UpdatedAt}
// -------- production / equipment --------
onlineDevices := 0
summary := StationSummary{}
equipment := make([]FrontStation, 0, len(r.Equipment))
for _, st := range r.Equipment {
tool := "online"
switch st.Status {
case "running":
tool = "busy"
summary.Running++
case "alarm":
tool = "alarm"
summary.Alarm++
case "offline":
tool = "offline"
summary.Offline++
default:
summary.Idle++
}
if st.Status != "offline" {
onlineDevices += 2
}
equipment = append(equipment, FrontStation{
ID: st.StationNo,
Name: st.Name,
Status: st.Status,
ScanGun: FrontToolState{Status: tool, ProcessedCount: st.DoneToday},
TighteningGun: FrontToolState{Status: tool, CurrentSn: st.CurrentSn, ProcessedCount: st.DoneToday},
CurrentSn: st.CurrentSn,
CurrentOperator: st.CurrentOperator,
CurrentProcess: st.CurrentProcess,
DoneCount: st.DoneToday,
Paused: st.Paused,
PauseReason: st.PauseReason,
})
}
f.Equipment = equipment
// -------- 虚拟工位(OFFLINE):同构映射,但不计入设备在线/总数口径 --------
f.VirtualStations = make([]FrontStation, 0, len(r.VirtualEquipment))
for _, st := range r.VirtualEquipment {
tool := "online"
switch st.Status {
case "running":
tool = "busy"
case "alarm":
tool = "alarm"
case "offline":
tool = "offline"
}
f.VirtualStations = append(f.VirtualStations, FrontStation{
ID: st.StationNo,
Name: st.Name,
Status: st.Status,
ScanGun: FrontToolState{Status: tool, ProcessedCount: st.DoneToday},
TighteningGun: FrontToolState{Status: tool, CurrentSn: st.CurrentSn, ProcessedCount: st.DoneToday},
CurrentSn: st.CurrentSn,
CurrentOperator: st.CurrentOperator,
CurrentProcess: st.CurrentProcess,
DoneCount: st.DoneToday,
Paused: st.Paused,
PauseReason: st.PauseReason,
})
}
f.Production = FrontProduction{
OutputToday: r.Production.OutputToday,
TargetToday: r.Production.TargetToday,
PassCount: r.Production.QualityOk,
TorqueCount: r.Production.TorqueTotal,
InLine: r.Production.InLine,
DeviceOnline: onlineDevices,
DeviceTotal: len(r.Equipment) * 2,
CycleTimeMin: r.Production.CycleTimeMin,
StationSummary: summary,
}
// -------- warehouse --------
movements := make([]FrontMovement, 0, len(r.Warehouse.Movements))
for _, m := range r.Warehouse.Movements {
movements = append(movements, FrontMovement{
ID: m.ID, Time: m.Time, Type: m.Type, Material: m.Material,
Qty: m.Qty, Operator: m.Operator, Batch: m.Batch,
})
}
f.Warehouse = FrontWarehouse{
TotalStock: r.Warehouse.TotalQty,
MaterialTypes: r.Warehouse.MaterialTypes,
InboundToday: r.Warehouse.InToday,
OutboundToday: r.Warehouse.OutToday,
LocationUsed: r.Warehouse.LocationUsed,
LocationTotal: r.Warehouse.LocationTotal,
PendingInbound: r.Warehouse.PendingInbound,
PendingOutbound: r.Warehouse.PendingOutbound,
Movements: movements,
}
// -------- 当前订单卡片 --------
pr := FrontProgress{ProcessTotal: 12, Status: "待排产"}
if c := r.Production.CurrentOrder; c != nil {
pr = FrontProgress{
OrderNo: c.OrderNo,
ProductName: c.ProductName,
TotalQty: c.TotalQty,
DoneQty: c.DoneQty,
Progress: c.Progress,
Status: c.Status,
CurrentProcess: c.CurrentProcess,
PlanStart: shortDate(c.PlanStart),
PlanEnd: shortDate(c.PlanEnd),
RemainDays: remainDays(c.PlanEnd),
ProcessTotal: 12,
}
}
// 追溯:取最近完工工件,汇总工序实绩条数 → “全程可追溯”
stepCount := 0
allOk := true
for _, t := range r.Trace.Recent {
stepCount += t.StepCount
if t.NgCount > 0 {
allOk = false
}
}
pr.TraceStepCount = stepCount
pr.Traceable = stepCount > 0 && allOk
f.Progress = pr
// -------- 多订单列表(轮播):进行中工单排前,最多 6 条,首条与 progress 一致 --------
f.ProgressList = make([]FrontProgress, 0, len(r.Production.WorkOrders))
for i, wo := range r.Production.WorkOrders {
if i >= 6 {
break
}
f.ProgressList = append(f.ProgressList, FrontProgress{
OrderNo: wo.OrderNo,
ProductName: wo.ProductName,
TotalQty: wo.TotalQty,
DoneQty: wo.DoneQty,
Progress: wo.Progress,
Status: wo.Status,
CurrentProcess: wo.CurrentProcess,
PlanStart: shortDate(wo.PlanStart),
PlanEnd: shortDate(wo.PlanEnd),
RemainDays: remainDays(wo.PlanEnd),
ProcessTotal: 12,
TraceStepCount: stepCount,
Traceable: stepCount > 0 && allOk,
})
}
// -------- traces / trends / points / agv / events --------
f.Traces = r.Trace.Recent
if f.Traces == nil {
f.Traces = []TraceItem{}
}
f.Trends = FrontTrends{Production: r.Trends}
if f.Trends.Production == nil {
f.Trends.Production = []TrendPoint{}
}
// 点位态:PLC 读取失败时 buildPoints 已降级为 Mock 空态,前端角落标「模拟数据」
f.Points = s.buildPoints(ctx)
if f.Points.Transit == nil {
f.Points.Transit = []InTransit{}
}
// AGV:真实备料任务 → 稳定码 + 中文显示名(DOCK01..21 → G1L..G10R/JBT21);无假坐标、无假进度
f.Agv = make([]FrontAgvRobot, 0, len(r.Agv.Robots))
for _, rb := range r.Agv.Robots {
f.Agv = append(f.Agv, FrontAgvRobot{
Code: rb.Code,
Status: rb.Status,
From: dockCnLabel(dockCodeToCode(rb.FromDock)),
To: dockCnLabel(dockCodeToCode(rb.ToDock)),
Carrier: rb.Carrier,
TaskNo: rb.TaskNo,
})
}
// 事件流:过滤 NG 结果项(大屏报喜不报忧;负面事件只进语音播报 alarms)
f.Events = make([]EventItem, 0, len(r.Events))
for _, e := range r.Events {
if strings.EqualFold(e.Level, "error") {
continue
}
f.Events = append(f.Events, e)
}
// 报警仅透传给前端做语音播报(D2),屏幕不渲染(报喜不报忧)。
f.Alarms = r.Alarms
if f.Alarms == nil {
f.Alarms = []AlarmItem{}
}
return f
}
// shortDate "2006-01-02 15:04:05" → "2006-01-02"
func shortDate(s string) string {
if len(s) >= 10 {
return s[:10]
}
return strings.TrimSpace(s)
}
// remainDays 距交期剩余天数:按自然日差(负数 = 已超期)。
// 工期为空的订单返回 0,前端显示“—”即可。
func remainDays(planEnd string) int {
layout := dashboardTimeLayout
if len(planEnd) == 10 {
layout = "2006-01-02"
}
t, err := time.ParseInLocation(layout, strings.TrimSpace(planEnd), time.Local)
if err != nil {
return 0
}
// 取日期差(跨过当天 0 点即视为到期)
now := time.Now()
start := time.Date(now.Year(), now.Month(), now.Day(), 0, 0, 0, 0, now.Location())
end := time.Date(t.Year(), t.Month(), t.Day(), 0, 0, 0, 0, t.Location())
return int(end.Sub(start).Hours() / 24)
}