Files
bj_power/bj_power_wms/schema/outbound_order.go
T
SunYF af554cea75 feat: 同步失败台账双向可重试 + 拧紧枪按工位配置 + 虚拟工位体系 + 去Redis与文档口径对齐
- 同步失败台账:MES/WMS 双端新增台账与页面,跨系统通知失败落台账、人工重试或标记已处理,不自动重传;重试前先判对端终态;叫料、配送、出库回写失败提示指向台账;补幂等建表脚本与菜单权限。
- 拧紧枪:新增按工位配置页,展示控制器地址与三把枪通道号(仅供查看,不参与采集校验);「允许手填」由全局开关改为每工位开关,关闭时校验该工位已配控制器;终端启动/登录上报配置并按本工位拉取,扭矩手填框按本工位置灰;补全局值迁移到各工位的脚本。
- 工位体系:终端未配置工位号时登录页可选(含虚拟工位),固定工位模式保留;虚拟/线下位不叫料、不退料、不作转产目标,未采集绑定放行并说明原因;叫料期望接驳台改为选填。
- AGV与出库:补「出库单已送达」回写;空车回充、接驳台传感器失联、配送状态更新失败均落预警或留痕并提示人工核对;人工出库不引入送达状态;出库单支持目标工位/接驳台并扩展导出列。
- 基础设施:看板缓存由Redis改为MES进程内实现,文档与启动脚本同步去Redis;扫码监听支持多地址、端口被占自动降级;PLC对账与工位报警在MES不可达时降级放行并留日志。
- 文档与帮助:案例与部署手册按实测订正(工位绑定、菜单名称、补料由班组长代提、菜单覆盖对照、虚拟工位);迁移脚本改为本地即时执行并登记7个已执行脚本;三端页面帮助改为「业务/操作/影响范围/后果」四要素。
- 测试:新增独立Go模块,按三个业务场景做真实HTTP与真实写库的流水测试,含运行报告。
2026-11-09 18:58:47 +08:00

97 lines
6.6 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 schema
import (
"entgo.io/ent"
"entgo.io/ent/dialect/entsql"
"entgo.io/ent/schema"
"entgo.io/ent/schema/field"
"entgo.io/ent/schema/index"
)
// OutboundOrder 出库统一主表
// 所有出库(备料出库 workorder / 补料出库 refill / 通用出库 general)都落在这一张表,
// 用 outbound_type 区分;装箱属性(箱号/SN清单/合同号)直接存本表,不再单独建装箱表。
// 备料出库强约束:净领用(out_qty − returned_qty) ≤ 工单物料清单需求量,由 WMS 侧台账校验。
//
// 注:报工反冲不再生成出库单(2026-09-19 起反冲只核销台账 consumed_qty,不做物理位移)。
type OutboundOrder struct {
ent.Schema
}
func (OutboundOrder) Annotations() []schema.Annotation {
return []schema.Annotation{entsql.Table("outbound_orders"), entsql.WithComments(true), schema.Comment("OutboundOrder 出库统一主表")}
}
func (OutboundOrder) Fields() []ent.Field {
return []ent.Field{
field.String("outbound_no").Unique().Comment("出库单号"),
// 类型:workorder(备料出库/MES) refill(工位叫料补料) general(通用出库,不依赖工单)
field.String("outbound_type").Default("workorder").Comment("出库类型"),
// 出库单状态:出库即扣库存,故创建即为「已出库」;叫 AGV 配送到位后置「已送达」。
// 「已接料」不在本表(归备料单 material_request.received_qty),避免三处状态互斗。
// 2026-11-09 拍板(用户):人工出库(通用 general/科技项目 project)不需要「已送达」概念——
// 是否送达不是库管的责任、也不确定送到哪里,止于「已出库」终态;不引入送达写者/按钮/权限。
field.String("status").Default("已出库").Comment("出库单状态 已出库/已送达"),
// 语义收口(2026-11-09):本字段仅作叫料类出库(call)的 AGV 标记快照(handler/call.go:217
// 自叫料单 needAgv 落库);通用/科技项目出库前端无叫车选项、恒 false,且全库无读消费者。
// 保留字段防历史数据迁移(对齐 work_order.projectNo 先例),不删列、不清理叫料链路写入。
field.Bool("need_agv").Default(false).Comment("是否需要AGV配送到接驳台"),
// 出库类别(客户诉求 问题记录 L96-108):通用出库先点选类别——
// return(退料)/sample(样品)/scrap(报废)/deliver(发货)/other(其他,手输原因)
field.String("outbound_category").Optional().Comment("出库类别 return/sample/scrap/deliver/other"),
// 归属(客户诉求 L96-108):工单号/科技项目号/其他;与入库 ownership_type 口径一致
field.String("ownership_type").Optional().Comment("归属类型 workorder/project/other"),
field.String("ownership_no").Optional().Comment("归属编号(工单号/科技项目号)"),
// 目标工位(客户诉求 L96-108):出库送到哪个装配工位
field.String("target_station").Optional().Comment("目标工位(装配工位号)"),
field.String("order_no").Optional().Comment("关联工单号(工单为唯一挂靠载体)"),
field.String("material_code").Comment("物料编码"),
field.String("material_name").Optional().Comment("物料名称(冗余)"),
// 类型(分类语境):1结构件/2电气件/3其他
field.Int("manage_mode").Default(1).Comment("类型 1结构件/2电气件/3其他"),
// 序列号(2026-09-30 解耦定稿):1序列号=是(逐件SN)/2序列号=否(数量)
field.Int("sn_mode").Default(0).Comment("序列号 1=是(逐件SN)/2=否(按数量)/0未选择"),
field.String("batch_no").Optional().Comment("批次号(结构件)"),
// 出库库位四级(客户诉求:出库与入库同口径,2026-09-19 补齐)
field.String("zone_code").Optional().Comment("出库区域(大区)"),
field.String("shelf_no").Optional().Comment("货架号(与入库同口径)"),
field.String("layer_no").Optional().Comment("第几层(与入库同口径)"),
field.String("position_no").Optional().Comment("位置号(与入库同口径)"),
field.Int("quantity").Default(0).Comment("本次出库总数量"),
field.String("operator").Optional().Comment("操作人"),
field.String("reviewer").Optional().Comment("复核人"),
field.String("target_dock").Optional().Comment("目标接驳台(AGV配送)"),
field.String("remark").Optional().Comment("备注"),
// 装箱属性:出库时一并记录箱号/SN清单/合同号,统一落在出库主表,不再单独建装箱表
field.String("box_no").Optional().Comment("箱号(装箱出库时填写,用于整箱发货追溯)"),
field.String("box_sn_list").Optional().Comment("装箱 SN 清单(JSON 数组字符串)"),
field.String("contract_no").Optional().Comment("合同号(装箱选填)"),
// 跨工位借料来源(call 备料出库专用):stationNo→借用量;空=本工位自取(不借)。
// 库房备料发货时据此知悉"此单混用了借工位额度",避免糊涂账(2026-11-02 借料知情权)。
field.JSON("borrowFrom", map[string]int{}).Optional().Comment("跨工位借料来源 stationNo→借用量(call 备料出库专用);空=本工位自取"),
// 检测单号(2026-09-21 对齐入库单字段):退货/报废等需要溯源检验单据的出库场景可选填写
field.String("inspection_no").Optional().Comment("检测单号(溯源关联检验单据)"),
// 配送单关联(2026-11-05 叫料配送拆分):叫料类出库回写所属配送单号,配送历史可追溯
field.String("delivery_no").Default("").Comment("关联配送单号(叫料配送出库回写)"),
// 产品工号(随库存带入,出库记录展示/筛选,2026-09-29 五页带出)
field.String("product_work_no").Optional().Comment("产品工号(随库存带入,出库记录展示/筛选)"),
// 作废(2026-11-03 断头路补全):仅通用出库(general)/科技项目出库(project)可作废——
// 人工手工出库填错时的纠错闭环(对齐入库作废 inbound_void);备料/补料/叫料出库(workorder/refill/call)
// 与 MES 台账联动,不提供作废,走退库逆向闭环。作废=回滚库存+标记保留记录。
field.Bool("voided").Default(false).Comment("是否已作废"),
field.String("void_reason").Default("").Comment("作废原因(必填留痕)"),
field.String("voided_by").Default("").Comment("作废操作人"),
field.Int64("voided_at").Optional().Nillable().Comment("作废时间戳"),
field.Int64("created_at").DefaultFunc(nowUnix).Comment("创建时间"),
}
}
func (OutboundOrder) Indexes() []ent.Index {
return []ent.Index{
index.Fields("order_no"),
index.Fields("material_code"),
index.Fields("outbound_type"),
index.Fields("box_no"),
index.Fields("inspection_no"),
}
}