Files
bj_power/bj_power_wms/internal/db/db.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

406 lines
27 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 db
import (
"context"
"database/sql"
"fmt"
"log/slog"
"bj_power_wms/ent"
"entgo.io/ent/dialect"
entsql "entgo.io/ent/dialect/sql"
_ "github.com/jackc/pgx/v5/stdlib"
)
// rawDB 持有底层 *sql.DB,供迁移期清理孤儿表(如已下线的 package_boxes)使用
var rawDB *sql.DB
// MustNewDB 创建 Ent 客户端并验证连接
func MustNewDB(c DatabaseConf) *ent.Client {
ec, err := NewDB(c)
if err != nil {
panic(fmt.Sprintf("数据库连接失败: %v", err))
}
return ec
}
func NewDB(c DatabaseConf) (*ent.Client, error) {
dsn := fmt.Sprintf("postgresql://%s:%s@%s:%d/%s?sslmode=disable",
c.User, c.Password, c.Host, c.Port, c.Dbname,
)
db, err := sql.Open("pgx", dsn)
if err != nil {
return nil, err
}
if err := db.Ping(); err != nil {
return nil, fmt.Errorf("ping db: %w", err)
}
rawDB = db
drv := entsql.OpenDB(dialect.Postgres, db)
return ent.NewClient(ent.Driver(drv)), nil
}
// EnsureDB 若目标数据库不存在则自动创建(先连 postgres 维护库做检查/创建)
func EnsureDB(c DatabaseConf) error {
maintenanceDSN := fmt.Sprintf("postgresql://%s:%s@%s:%d/%s?sslmode=disable",
c.User, c.Password, c.Host, c.Port, "postgres")
sqlDB, err := sql.Open("pgx", maintenanceDSN)
if err != nil {
return err
}
defer sqlDB.Close()
var exists bool
if err := sqlDB.QueryRow(
`SELECT EXISTS(SELECT 1 FROM pg_database WHERE datname = $1)`, c.Dbname,
).Scan(&exists); err != nil {
return err
}
if exists {
return nil
}
if _, err := sqlDB.Exec(`CREATE DATABASE "` + c.Dbname + `"`); err != nil {
return err
}
slog.Info("已自动创建数据库 " + c.Dbname)
return nil
}
// AutoMigrate 启动时自动建表/迁移
func AutoMigrate(client *ent.Client) error {
ctx := contextBackdrop()
// 迁移前补列:必须先于 ent 的 Schema.Create 执行(详见 applyPreMigratePatches 说明)。
applyPreMigratePatches(ctx)
if err := client.Schema.Create(ctx); err != nil {
return fmt.Errorf("自动迁移失败: %w", err)
}
// ent 的 Schema.Create 只会"建新表",不会给已存在的表补列(本项目已知约束)。
// 新增字段统一在此以幂等 DDL 补齐(ADD COLUMN IF NOT EXISTS 可重复执行)。
applyColumnPatches(ctx)
// 清理历史独立装箱表:装箱已合并到统一的出库主表 OutboundOrder,
// 原 package_boxes 表成为孤儿表,此处幂等删除(DROP TABLE IF EXISTS 可重复执行)。
if rawDB != nil {
if _, err := rawDB.ExecContext(ctx, "DROP TABLE IF EXISTS package_boxes"); err != nil {
slog.Warn("清理旧装箱表 package_boxes 失败(可忽略): " + err.Error())
} else {
slog.Info("已清理旧装箱表 package_boxes")
}
// 2026-10-14 AGV 唯一真源已迁至 MES:WMS 不再持有 agv_tasks 表,
// 原表成为孤儿表,此处幂等删除(DROP TABLE IF EXISTS 可重复执行)。
if _, err := rawDB.ExecContext(ctx, "DROP TABLE IF EXISTS agv_tasks"); err != nil {
slog.Warn("清理旧 AGV 任务表 agv_tasks 失败(可忽略): " + err.Error())
} else {
slog.Info("已清理旧 AGV 任务表 agv_tasks")
}
}
slog.Info("数据库迁移完成")
return nil
}
// applyPreMigratePatches 必须在 ent 的 Schema.Create 之前执行。
//
// 背景(2026-09-19 启动 panic 根因):ent(v0.14/Atlas) 给「已存在的表」新增「非空且无默认值」的列时,
// 只会先 ADD COLUMN(可空)再 ALTER COLUMN SET NOT NULL;存量行填不上值即报
// `column "xxx" of relation "yyy" contains null values (SQLSTATE 23502)`,直接 panic 打断启动。
// 因此这类列必须先用「带默认值」的 DDL 补齐(存量行被一次填满),Schema.Create 才能顺利收紧约束;
// 业务真实值随后由 applyColumnPatches 回填、并 DROP DEFAULT,使库内结构与 ent schema 完全一致。
//
// 登记口径:给「既有表」加非空且无默认值的列 → 必须登记在此;
// 只加可空列或带默认值的列 → 无需登记(ent 自己 ADD COLUMN 即可)。
func applyPreMigratePatches(ctx context.Context) {
if rawDB == nil {
return
}
stmts := []string{
// 区域库位父子层级重构:存量 zones 表补 level/code(ent schema 中二者均非空且无默认值)。
// 这里的默认值仅用于让存量行通过 NOT NULL 收紧,真实层级值由 applyColumnPatches 回填。
`ALTER TABLE zones ADD COLUMN IF NOT EXISTS level bigint NOT NULL DEFAULT 4`,
`ALTER TABLE zones ADD COLUMN IF NOT EXISTS code character varying NOT NULL DEFAULT ''`,
// B5 叫料单退库(2026-10-13):退库单关联叫料单号,仓库确认收回后凭此回调 MES 关单回补
`ALTER TABLE return_orders ADD COLUMN IF NOT EXISTS ref_no varchar(64) NOT NULL DEFAULT ''`,
// 2026-11-03 拍板:退料必须指定接驳台(AGV 要从接驳台出发拉货),WMS 退库单展示
`ALTER TABLE return_orders ADD COLUMN IF NOT EXISTS return_dock varchar(20) NOT NULL DEFAULT ''`,
// 2026-11-04 拍板撤除:撤销「未使用」归类(用户拍板不需要,退料数量以库管实际录入为准),
// 幂等清掉上一版登记的残留列
`ALTER TABLE return_orders DROP COLUMN IF EXISTS force_unused`,
}
for _, s := range stmts {
if _, err := rawDB.ExecContext(ctx, s); err != nil {
// 全新库此时表尚未建立,Schema.Create 会按 schema 全新建表,属正常情况
slog.Warn("迁移前补列跳过(新库属正常): " + err.Error())
}
}
}
// applyColumnPatches 幂等补齐已有表的新增列。
// 背景:ent 的 Schema.Create 对已存在表不会 ADD COLUMN,故新增字段必须在此登记,
// 否则新库正常、存量库缺列导致运行时 500。
func applyColumnPatches(ctx context.Context) {
if rawDB == nil {
return
}
stmts := []string{
// 质量状态口径收口(2026-10-10 用户裁决):让步接收整体清除,历史值并入合格(幂等数据迁移)
`UPDATE inventories SET quality_status='合格' WHERE quality_status='让步接收'`,
// P0-2 不合格品处置(问题记录 L135-145)
`ALTER TABLE inspection_records ADD COLUMN IF NOT EXISTS disposal_type text NOT NULL DEFAULT 'NONE'`,
`ALTER TABLE inspection_records ADD COLUMN IF NOT EXISTS disposal_remark text`,
`ALTER TABLE inspection_records ADD COLUMN IF NOT EXISTS return_tracking_no text`,
// D5 区域库位:货架号 / 第几层 / 位置号(手填)
`ALTER TABLE zones ADD COLUMN IF NOT EXISTS shelf_no text`,
`ALTER TABLE zones ADD COLUMN IF NOT EXISTS layer_no text`,
`ALTER TABLE zones ADD COLUMN IF NOT EXISTS position_no text`,
// D6 其他入库:归属(工单号/科技项目号/无)
`ALTER TABLE inbound_orders ADD COLUMN IF NOT EXISTS ownership_type text NOT NULL DEFAULT 'none'`,
`ALTER TABLE inbound_orders ADD COLUMN IF NOT EXISTS ownership_no text`,
// 新问题1(2026-09-28):产品工号(归属下手填二级编号)
`ALTER TABLE inbound_orders ADD COLUMN IF NOT EXISTS product_work_no text`,
// 新问题1 收尾(2026-09-29):产品工号贯通 库存/出库/检验(五页带出展示/筛选)
`ALTER TABLE inventories ADD COLUMN IF NOT EXISTS product_work_no text`,
`ALTER TABLE outbound_orders ADD COLUMN IF NOT EXISTS product_work_no text`,
`ALTER TABLE inspection_records ADD COLUMN IF NOT EXISTS product_work_no text`,
// 缺货预警:物料安全库存
`ALTER TABLE materials ADD COLUMN IF NOT EXISTS safety_stock bigint NOT NULL DEFAULT 0`,
// 备料台账:目标工位(备料送到哪个装配工位)
`ALTER TABLE order_material_ledgers ADD COLUMN IF NOT EXISTS target_station text`,
// 备料台账:完成时间(最后一笔出库时间,问题记录 六.10)
`ALTER TABLE order_material_ledgers ADD COLUMN IF NOT EXISTS completed_at bigint`,
// 通用出库:出库类别/归属/目标工位(问题记录 二.2/二.3/二.4)
`ALTER TABLE outbound_orders ADD COLUMN IF NOT EXISTS outbound_category text`,
`ALTER TABLE outbound_orders ADD COLUMN IF NOT EXISTS ownership_type text`,
`ALTER TABLE outbound_orders ADD COLUMN IF NOT EXISTS ownership_no text`,
`ALTER TABLE outbound_orders ADD COLUMN IF NOT EXISTS target_station text`,
// 出库库位四级贯通(客户诉求:出库与入库同口径,2026-09-19):区域已有 zone_code,补货架/层/位置
`ALTER TABLE outbound_orders ADD COLUMN IF NOT EXISTS shelf_no text`,
`ALTER TABLE outbound_orders ADD COLUMN IF NOT EXISTS layer_no text`,
`ALTER TABLE outbound_orders ADD COLUMN IF NOT EXISTS position_no text`,
// 库存明细:库位贯通 货架/层/位置(问题记录 一.4)
`ALTER TABLE inventories ADD COLUMN IF NOT EXISTS shelf_no text`,
`ALTER TABLE inventories ADD COLUMN IF NOT EXISTS layer_no text`,
`ALTER TABLE inventories ADD COLUMN IF NOT EXISTS position_no text`,
// 半成品/成品入库扩展(问题记录 L218/L222/L224/L230)
`ALTER TABLE inventories ADD COLUMN IF NOT EXISTS ownership_type text`,
`ALTER TABLE inventories ADD COLUMN IF NOT EXISTS ownership_no text`,
`ALTER TABLE inventories ADD COLUMN IF NOT EXISTS product_status text`,
`ALTER TABLE inventories ADD COLUMN IF NOT EXISTS related_standard text`,
`ALTER TABLE inventories ADD COLUMN IF NOT EXISTS test_record_no text`,
`ALTER TABLE inventories ADD COLUMN IF NOT EXISTS recorded_by text`,
`ALTER TABLE inventories ADD COLUMN IF NOT EXISTS recorded_at bigint`,
`ALTER TABLE inventories ADD COLUMN IF NOT EXISTS outbound_reason text`,
// 检验记录扩展(问题记录 L107/L149/L150/L494:归属/相关标准/生产厂家/名称冗余)
`ALTER TABLE inspection_records ADD COLUMN IF NOT EXISTS material_name text`,
`ALTER TABLE inspection_records ADD COLUMN IF NOT EXISTS ownership_type text`,
`ALTER TABLE inspection_records ADD COLUMN IF NOT EXISTS ownership_no text`,
`ALTER TABLE inspection_records ADD COLUMN IF NOT EXISTS related_standard text`,
`ALTER TABLE inspection_records ADD COLUMN IF NOT EXISTS manufacturer text`,
// 来料检验不合格数(问题记录 L150 三问题之三:检验/合格之外补不合格数,后端复核=检验-合格)
`ALTER TABLE inspection_records ADD COLUMN IF NOT EXISTS reject_qty bigint NOT NULL DEFAULT 0`,
// 来料检验 第几批/共几件(2026-10-04 客户需求):序列号=否必填≥1,序列号=是与历史数据留 0=未填
`ALTER TABLE inspection_records ADD COLUMN IF NOT EXISTS batch_seq bigint NOT NULL DEFAULT 0`,
`ALTER TABLE inspection_records ADD COLUMN IF NOT EXISTS batch_total bigint NOT NULL DEFAULT 0`,
// E7 历史回填:不合格数 = 检验数 - 合格数(仅补差异>0 的旧行,幂等可重复执行)
`UPDATE inspection_records SET reject_qty = inspect_qty - pass_qty WHERE reject_qty = 0 AND inspect_qty > pass_qty`,
// 可生产数量快照表下线(方案 §0:可生产套数迁出 WMS 迁 MES,WMS 不再持有 producible_snapshot)
`DROP TABLE IF EXISTS producible_snapshot`,
// 入库单质量状态(问题记录 L129:入库记录增加 合格/不合格 列)
`ALTER TABLE inbound_orders ADD COLUMN IF NOT EXISTS quality_status text`,
// 入库单库位四级贯通(方案 E):区域已有 zone_code,补货架/层/位置三列
`ALTER TABLE inbound_orders ADD COLUMN IF NOT EXISTS shelf_no text`,
`ALTER TABLE inbound_orders ADD COLUMN IF NOT EXISTS layer_no text`,
`ALTER TABLE inbound_orders ADD COLUMN IF NOT EXISTS position_no text`,
// 图号合并(问题记录 L18):drawing_no 已并入 code,存量库丢弃旧列
`ALTER TABLE materials DROP COLUMN IF EXISTS drawing_no`,
// 「简称」已按 2026-09-19 用户裁决整体删除(新增/编辑表单不再出现),存量库丢弃旧列
`ALTER TABLE materials DROP COLUMN IF EXISTS short_name`,
// 批次号/SN 唯一约束(P2-1/P2-2):并发导入防撞号。部分唯一索引只约束非空值——
// 空串/NULL(序列号=否无SN、序列号=是有批次)不参与唯一性。
// 批次唯一索引 ux_inventories_batch_no 已改按 sn_mode=2 约束(见下方 2026-09-30 解耦补丁:先回填再重建)。
`CREATE UNIQUE INDEX IF NOT EXISTS ux_inventories_sn_code ON inventories (sn_code) WHERE sn_code IS NOT NULL AND sn_code <> ''`,
// 区域库位父子层级重构(统一主表 + 层级类型字段 level/code/name/parent_code):
// 在扁平 zones 表上加层级列,把"一行一货位"升级为 区域(level1)→货架(level2)→层(level3)→位置号(level4) 父子结构。
`ALTER TABLE zones ADD COLUMN IF NOT EXISTS level integer NOT NULL DEFAULT 4`,
`ALTER TABLE zones ADD COLUMN IF NOT EXISTS code text`,
`ALTER TABLE zones ADD COLUMN IF NOT EXISTS name text`,
`ALTER TABLE zones ADD COLUMN IF NOT EXISTS parent_code text`,
// 删 ent 旧生成的 zone_code 单列唯一索引与旧组合索引,改建层级节点唯一索引(防同层级同父下编码重复)
`DROP INDEX IF EXISTS zones_zone_code_key`,
`DROP INDEX IF EXISTS ux_zones_location`,
`CREATE UNIQUE INDEX IF NOT EXISTS ux_zones_node ON zones (level, zone_code, COALESCE(shelf_no, ''), COALESCE(layer_no, ''), code)`,
// 存量数据回填(幂等,可重复执行):扁平货位 → 父子层级
// 1) 纯区域行(无货架/层/位置)→ 区域节点(level1)
`UPDATE zones SET level = 1, code = zone_code, parent_code = '' WHERE (shelf_no IS NULL OR shelf_no = '') AND (layer_no IS NULL OR layer_no = '') AND (position_no IS NULL OR position_no = '') AND (code IS NULL OR code = '')`,
// 2) 货位行(有 position_no)→ 位置节点(level4),parent_code 取层号(默认位置 layer_no 为空)
`UPDATE zones SET level = 4, code = position_no, parent_code = COALESCE(layer_no, ''), name = COALESCE(name, '') WHERE position_no IS NOT NULL AND position_no <> '' AND (code IS NULL OR code = '')`,
// 3) 补货架节点(level2):从货位行去重得到 (zone_code, shelf_no)
`INSERT INTO zones (level, code, parent_code, zone_code, shelf_no, status, created_at, updated_at)
SELECT DISTINCT 2, z.shelf_no, z.zone_code, z.zone_code, z.shelf_no, '启用', EXTRACT(EPOCH FROM NOW())::bigint, EXTRACT(EPOCH FROM NOW())::bigint
FROM zones z WHERE z.shelf_no IS NOT NULL AND z.shelf_no <> ''
AND NOT EXISTS (SELECT 1 FROM zones s WHERE s.level = 2 AND s.zone_code = z.zone_code AND s.code = z.shelf_no)`,
// 4) 补层节点(level3):从货位行去重得到 (zone_code, shelf_no, layer_no)
`INSERT INTO zones (level, code, parent_code, zone_code, shelf_no, layer_no, status, created_at, updated_at)
SELECT DISTINCT 3, z.layer_no, z.shelf_no, z.zone_code, z.shelf_no, z.layer_no, '启用', EXTRACT(EPOCH FROM NOW())::bigint, EXTRACT(EPOCH FROM NOW())::bigint
FROM zones z WHERE z.layer_no IS NOT NULL AND z.layer_no <> ''
AND NOT EXISTS (SELECT 1 FROM zones l WHERE l.level = 3 AND l.zone_code = z.zone_code AND l.shelf_no = z.shelf_no AND l.code = z.layer_no)`,
// level/code 回填完毕,撤销 applyPreMigratePatches 补列时的临时默认值,
// 使库内结构与 ent schema 对齐(非空、无默认值)。
`ALTER TABLE zones ALTER COLUMN level DROP DEFAULT`,
`ALTER TABLE zones ALTER COLUMN code DROP DEFAULT`,
// U18 盘点四级贯通:盘点快照冻结货架/层/位置,盘点差异可精确定位到货位。
`ALTER TABLE stocktake_items ADD COLUMN IF NOT EXISTS shelf_no text`,
`ALTER TABLE stocktake_items ADD COLUMN IF NOT EXISTS layer_no text`,
`ALTER TABLE stocktake_items ADD COLUMN IF NOT EXISTS position_no text`,
// 入库作废(2026-09-19):入库单可作废,记录原因/人/时间;库存回滚后单仍保留供追溯
`ALTER TABLE inbound_orders ADD COLUMN IF NOT EXISTS voided boolean NOT NULL DEFAULT false`,
`ALTER TABLE inbound_orders ADD COLUMN IF NOT EXISTS void_reason text`,
`ALTER TABLE inbound_orders ADD COLUMN IF NOT EXISTS voided_by text`,
`ALTER TABLE inbound_orders ADD COLUMN IF NOT EXISTS voided_at bigint`,
// ===== 2026-09-21 单号格式升级:IB/OB + YYYYMMDD + NNN + 高频查询字段统一加索引 =====
// 单号唯一:防止手工/自动生成撞号,应用层 validateUniqueNo 只做业务友好校验,DB 端唯一约束才是硬保证
// 注:存量库若有重复 IB433efbcc 这种旧单号会导致建索引失败,先在控制台 SELECT inbound_no, COUNT(*) GROUP BY 清掉重复
`CREATE UNIQUE INDEX CONCURRENTLY IF NOT EXISTS ux_inbound_orders_inbound_no ON inbound_orders (inbound_no)`,
`CREATE UNIQUE INDEX CONCURRENTLY IF NOT EXISTS ux_outbound_orders_outbound_no ON outbound_orders (outbound_no)`,
// 出库单也挂检测单号——退货/报废等场景需要溯源检验单据
`ALTER TABLE outbound_orders ADD COLUMN IF NOT EXISTS inspection_no text DEFAULT ''`,
// 跨工位借料知情权(2026-11-02):出库单记录借料来源,库房备料发货可见"含借工位X额度Y个"
`ALTER TABLE outbound_orders ADD COLUMN IF NOT EXISTS borrow_from jsonb`,
// B1/B2 逻辑拆分:存量「科技项目出库」此前以 (outbound_type='general', ownership_type='project') 混合存储。
// 拆分后科技项目出库统一用 outbound_type='project' 标识,此处一次性回填存量混合数据,不留兼容包袱。
// 幂等:回填后不再有 (general+project) 行,重复执行删除 0 行无害;后续代码不再为旧混合状态写兼容分支。
`UPDATE outbound_orders SET outbound_type='project' WHERE outbound_type='general' AND ownership_type='project'`,
// 高频查询/关联字段(ORDER BY / WHERE / JOIN)
`CREATE INDEX CONCURRENTLY IF NOT EXISTS idx_inbound_orders_created_at ON inbound_orders (created_at DESC)`,
`CREATE INDEX CONCURRENTLY IF NOT EXISTS idx_inbound_orders_material_code ON inbound_orders (material_code)`,
`CREATE INDEX CONCURRENTLY IF NOT EXISTS idx_inbound_orders_inspection_no ON inbound_orders (inspection_no)`,
`CREATE INDEX CONCURRENTLY IF NOT EXISTS idx_outbound_orders_order_no ON outbound_orders (order_no)`,
`CREATE INDEX CONCURRENTLY IF NOT EXISTS idx_outbound_orders_material_code ON outbound_orders (material_code)`,
`CREATE INDEX CONCURRENTLY IF NOT EXISTS idx_outbound_orders_inspection_no ON outbound_orders (inspection_no)`,
`CREATE INDEX CONCURRENTLY IF NOT EXISTS idx_inventories_inbound_no ON inventories (inbound_no)`,
`CREATE INDEX CONCURRENTLY IF NOT EXISTS idx_inventories_material_code ON inventories (material_code)`,
`CREATE INDEX CONCURRENTLY IF NOT EXISTS idx_inventories_quality_status ON inventories (quality_status)`,
`CREATE INDEX CONCURRENTLY IF NOT EXISTS idx_inventories_manage_mode ON inventories (manage_mode)`,
`CREATE INDEX CONCURRENTLY IF NOT EXISTS idx_outbound_details_outbound_no ON outbound_details (outbound_no)`,
`CREATE INDEX CONCURRENTLY IF NOT EXISTS idx_inbound_details_inbound_no ON inbound_details (inbound_no)`,
`CREATE INDEX CONCURRENTLY IF NOT EXISTS idx_inspection_records_target_id ON inspection_records (target_id)`,
`CREATE INDEX CONCURRENTLY IF NOT EXISTS idx_inspection_records_inspection_no ON inspection_records (inspection_no)`,
`CREATE INDEX CONCURRENTLY IF NOT EXISTS idx_inspection_records_status ON inspection_records (status)`,
`CREATE INDEX CONCURRENTLY IF NOT EXISTS idx_materials_code ON materials (code)`,
`CREATE UNIQUE INDEX CONCURRENTLY IF NOT EXISTS ux_order_material_ledger_order_material ON order_material_ledgers (order_no, material_code)`,
`CREATE UNIQUE INDEX CONCURRENTLY IF NOT EXISTS ux_agv_tasks_task_no ON agv_tasks (task_no)`,
// 附件:新存储方案(年/月/日/文件类型/uuid.ext)——补文件类型/UUID名/相对路径/逻辑删除/归档列
`ALTER TABLE attachments ADD COLUMN IF NOT EXISTS file_type text`,
`ALTER TABLE attachments ADD COLUMN IF NOT EXISTS file_ext text`,
`ALTER TABLE attachments ADD COLUMN IF NOT EXISTS file_md5 text`,
`ALTER TABLE attachments ADD COLUMN IF NOT EXISTS deleted boolean NOT NULL DEFAULT false`,
`ALTER TABLE attachments ADD COLUMN IF NOT EXISTS deleted_at bigint`,
`ALTER TABLE attachments ADD COLUMN IF NOT EXISTS deleted_by text`,
// 附件:删除留痕 + 彻底清除留痕(生命周期重构定稿:deleted_reason/purged_at/purged_by)
`ALTER TABLE attachments ADD COLUMN IF NOT EXISTS deleted_reason text`,
`ALTER TABLE attachments ADD COLUMN IF NOT EXISTS purged_at bigint`,
`ALTER TABLE attachments ADD COLUMN IF NOT EXISTS purged_by text`,
// 台账口径拆分(2026-09-19 出库与配送闭环):一个字段只有一个写者。
// returned_qty = 退库收货回写;consumed_qty = 报工反冲核销。均带默认值,存量行走 ent 亦可。
`ALTER TABLE order_material_ledgers ADD COLUMN IF NOT EXISTS returned_qty bigint NOT NULL DEFAULT 0`,
`ALTER TABLE order_material_ledgers ADD COLUMN IF NOT EXISTS consumed_qty bigint NOT NULL DEFAULT 0`,
// 出库单状态 + 是否叫AGV(配送进度只读展示用;「已接料」不落在本表)
`ALTER TABLE outbound_orders ADD COLUMN IF NOT EXISTS status text NOT NULL DEFAULT '已出库'`,
`ALTER TABLE outbound_orders ADD COLUMN IF NOT EXISTS need_agv boolean NOT NULL DEFAULT false`,
// 盘点15问(2026-09-20 最优方案):库存冻结标记 + 盘点单状态机/写回调整单/未盘项/取消原因
// inventories.stocktake_no 非空=该行正被盘点锁定,出库/入库/锁定入口据此拦截,保证盘点期间账实冻结。
`ALTER TABLE inventories ADD COLUMN IF NOT EXISTS stocktake_no text NOT NULL DEFAULT ''`,
`ALTER TABLE stocktake_orders ADD COLUMN IF NOT EXISTS diff_count bigint NOT NULL DEFAULT 0`,
`ALTER TABLE stocktake_orders ADD COLUMN IF NOT EXISTS adjusted boolean NOT NULL DEFAULT false`,
`ALTER TABLE stocktake_orders ADD COLUMN IF NOT EXISTS adjust_no text`,
`ALTER TABLE stocktake_orders ADD COLUMN IF NOT EXISTS written_at bigint`,
`ALTER TABLE stocktake_orders ADD COLUMN IF NOT EXISTS written_by text`,
`ALTER TABLE stocktake_orders ADD COLUMN IF NOT EXISTS uncounted_mode text`,
`ALTER TABLE stocktake_orders ADD COLUMN IF NOT EXISTS cancel_reason text`,
`ALTER TABLE stocktake_items ADD COLUMN IF NOT EXISTS counted_by text`,
`ALTER TABLE stocktake_items ADD COLUMN IF NOT EXISTS counted_at bigint`,
// ===== 2026-09-30 类型与SN行为解耦:materials/inventories/inbound_orders/outbound_orders 加 sn_mode =====
// sn_mode:1=序列号=是(逐件SN) 2=序列号=否(数量) 0=未选择。带默认值可空列,ent 亦可自行补,这里显式登记保持口径一致。
`ALTER TABLE materials ADD COLUMN IF NOT EXISTS sn_mode bigint NOT NULL DEFAULT 0`,
`ALTER TABLE inventories ADD COLUMN IF NOT EXISTS sn_mode bigint NOT NULL DEFAULT 0`,
`ALTER TABLE inbound_orders ADD COLUMN IF NOT EXISTS sn_mode bigint NOT NULL DEFAULT 0`,
`ALTER TABLE outbound_orders ADD COLUMN IF NOT EXISTS sn_mode bigint NOT NULL DEFAULT 0`,
// 存量回填(幂等,可重复执行):原 manage_mode=2(电气件)=逐件SN → 1;其余(结构件/其他)=批次数量 → 2。禁止留 0 存量。
`UPDATE materials SET sn_mode = CASE WHEN manage_mode = 2 THEN 1 ELSE 2 END WHERE sn_mode = 0`,
`UPDATE inventories SET sn_mode = CASE WHEN manage_mode = 2 THEN 1 ELSE 2 END WHERE sn_mode = 0`,
`UPDATE inbound_orders SET sn_mode = CASE WHEN manage_mode = 2 THEN 1 ELSE 2 END WHERE sn_mode = 0`,
`UPDATE outbound_orders SET sn_mode = CASE WHEN manage_mode = 2 THEN 1 ELSE 2 END WHERE sn_mode = 0`,
// 批次唯一索引改按 sn_mode=2 约束(原 WHERE manage_mode=1 的定义无法用 IF NOT EXISTS 更新,先删后建)
`DROP INDEX IF EXISTS ux_inventories_batch_no`,
`CREATE UNIQUE INDEX IF NOT EXISTS ux_inventories_batch_no ON inventories (batch_no) WHERE sn_mode = 2 AND batch_no IS NOT NULL AND batch_no <> ''`,
// sn_mode 高频过滤索引
`CREATE INDEX CONCURRENTLY IF NOT EXISTS idx_inventories_sn_mode ON inventories (sn_mode)`,
// 注释同步(2026-10-19):物料类别删「其他」+ sn_mode 文案统一「序列号(是/否)」;
// 显式 COMMENT ON 保证存量库列注释与 ent schema 一致(幂等,可重复执行)。
`COMMENT ON COLUMN materials.item_type IS '物料类别 1原材料/3成品(半成品不是物料类别,由库存 category=2 承载)'`,
`COMMENT ON COLUMN materials.sn_mode IS '序列号 1=是(逐件录SN)/2=否(按数量)/0未选择'`,
`COMMENT ON COLUMN outbound_orders.sn_mode IS '序列号 1=是(逐件SN)/2=否(按数量)/0未选择'`,
// 备份记录:强制清理留痕(姓名/手机号),带默认值;存量表补全
`ALTER TABLE backup_record ADD COLUMN IF NOT EXISTS ack_name varchar(64) NOT NULL DEFAULT ''`,
`ALTER TABLE backup_record ADD COLUMN IF NOT EXISTS ack_phone varchar(32) NOT NULL DEFAULT ''`,
// 出库单作废(2026-11-03 断头路补全,对齐入库作废):仅通用/科技项目出库可作废,
// 回滚库存+标记保留记录;voided 带默认值,voided_at 可空,存量库补列幂等。
`ALTER TABLE outbound_orders ADD COLUMN IF NOT EXISTS voided boolean NOT NULL DEFAULT false`,
`ALTER TABLE outbound_orders ADD COLUMN IF NOT EXISTS void_reason text`,
`ALTER TABLE outbound_orders ADD COLUMN IF NOT EXISTS voided_by text`,
`ALTER TABLE outbound_orders ADD COLUMN IF NOT EXISTS voided_at bigint`,
}
for _, s := range stmts {
if _, err := rawDB.ExecContext(ctx, s); err != nil {
slog.Warn("补齐列失败(可忽略): " + err.Error())
}
}
// ===== 2026-09-22 物料类别收编:半成品不是物料类别(是工件状态,由库存 category=2 承载)=====
// 物料档案不再允许 item_type=2,幂等清理存量半成品物料类别行(重复执行删 0 行,无害)。
if res, err := rawDB.ExecContext(ctx, `DELETE FROM materials WHERE item_type=2`); err != nil {
slog.Warn("清理 item_type=2 物料失败(可忽略): " + err.Error())
} else if n, err := res.RowsAffected(); err == nil && n > 0 {
slog.Info(fmt.Sprintf("物料类别清理:已删除半成品物料类别(item_type=2)物料档案 %d 行", n))
}
}
// DropAllTables 删除 public schema 下全部表(CASCADE 连带索引/序列/外键约束)。
// 仅供命令行 reset-all 使用:清空后由 AutoMigrate 重建结构、SeedIfEmpty + handler.SeedRBAC 重灌种子。
// 与 MES 的 db.DropAllTables 对齐(逐表 DROP 而非 DROP SCHEMA,保留 schema 权限归属)。
func DropAllTables(c DatabaseConf) error {
dsn := fmt.Sprintf("postgresql://%s:%s@%s:%d/%s?sslmode=disable",
c.User, c.Password, c.Host, c.Port, c.Dbname)
sqlDB, err := sql.Open("pgx", dsn)
if err != nil {
return err
}
defer sqlDB.Close()
rows, err := sqlDB.Query(`SELECT tablename FROM pg_tables WHERE schemaname='public'`)
if err != nil {
return err
}
var names []string
for rows.Next() {
var t string
if err := rows.Scan(&t); err != nil {
rows.Close()
return err
}
names = append(names, t)
}
rows.Close()
for _, t := range names {
if _, err := sqlDB.Exec(`DROP TABLE IF EXISTS "` + t + `" CASCADE`); err != nil {
return err
}
}
slog.Info(fmt.Sprintf("已删除全部表 %d 张", len(names)))
return nil
}