新增 ErrorListDialog 组件用于统一展示结构化校验错误信息,实现报错一次收全;新增工位报警语音播报功能,通过浏览器 SpeechSynthesis 播放本工位相关报警;调整物料类别及序列号字段文案,移除「其他」类别;新增工单实际开始字段及采集方式配置;优化 AGV 及 PlcSend 页签刷新逻辑;新增看板物料追溯及工位报警接口;删除 PLC 强制写 M 位及相关测试代码;同步数据库字段注释及补丁。
68 lines
2.3 KiB
Go
68 lines
2.3 KiB
Go
// Package verr 收集式校验错误(报错一次收全 + 每条带怎么办,2026-10-20 拍板):
|
||
// 校验函数从「发现错就 return」改为逐条收集,收尾用 OrNil() 一次性返回全部问题,
|
||
// 由 handler 层 FailErr 识别后输出 code=3015 + data.errors 结构化响应,
|
||
// 前端拦截器识别后用 ErrorListDialog 一次弹全,不再挤牙膏。
|
||
package verr
|
||
|
||
import "fmt"
|
||
|
||
// ErrAction 可跳转动作:前端渲染为按钮,点击新开标签页跳转 URL(当前页表单草稿保留)。
|
||
type ErrAction struct {
|
||
Label string `json:"label"`
|
||
URL string `json:"url"`
|
||
}
|
||
|
||
// FieldError 单条校验错误:现象(Message)+ 怎么办(Suggestion)+ 可选跳转(Action)。
|
||
type FieldError struct {
|
||
Field string `json:"field"`
|
||
Message string `json:"message"`
|
||
Suggestion string `json:"suggestion"`
|
||
Action *ErrAction `json:"action,omitempty"`
|
||
}
|
||
|
||
// ValidationError 收集容器:errors 非空时整体作为一个 error 返回。
|
||
type ValidationError struct {
|
||
Errors []FieldError
|
||
}
|
||
|
||
// New 新建收集器。
|
||
func New() *ValidationError { return &ValidationError{} }
|
||
|
||
// Add 追加一条「现象 + 怎么办」。
|
||
func (e *ValidationError) Add(field, message, suggestion string) {
|
||
e.Errors = append(e.Errors, FieldError{Field: field, Message: message, Suggestion: suggestion})
|
||
}
|
||
|
||
// AddAction 追加一条带跳转按钮的错误(label=按钮文案,url=新标签页打开的路由)。
|
||
func (e *ValidationError) AddAction(field, message, suggestion, label, url string) {
|
||
e.Errors = append(e.Errors, FieldError{Field: field, Message: message, Suggestion: suggestion,
|
||
Action: &ErrAction{Label: label, URL: url}})
|
||
}
|
||
|
||
// Merge 把另一个收集器的条目并入本收集器。
|
||
func (e *ValidationError) Merge(o *ValidationError) {
|
||
if o != nil && len(o.Errors) > 0 {
|
||
e.Errors = append(e.Errors, o.Errors...)
|
||
}
|
||
}
|
||
|
||
// Len 已收集条数。
|
||
func (e *ValidationError) Len() int {
|
||
if e == nil {
|
||
return 0
|
||
}
|
||
return len(e.Errors)
|
||
}
|
||
|
||
// OrNil 收尾:无错误返回 nil,有错误返回自身(校验函数统一调用)。
|
||
func (e *ValidationError) OrNil() error {
|
||
if e == nil || len(e.Errors) == 0 {
|
||
return nil
|
||
}
|
||
return e
|
||
}
|
||
|
||
func (e *ValidationError) Error() string {
|
||
return fmt.Sprintf("保存失败,共 %d 项需要处理", len(e.Errors))
|
||
}
|