Files
bj_power/bj_power_mes/internal/logic/dashboard_front.go
T

367 lines
13 KiB
Go
Raw Normal View History

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"`
2026-10-26 16:32:35 +08:00
// 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)
2026-10-26 16:32:35 +08:00
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)
}