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

450 lines
28 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"
"strings"
"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
// RawDB 返回启动期 MustNewDB 建立的底层连接池(只读共享,不额外建连接)。
// 供跨系统失败台账等轻量 raw SQL 场景使用;调用方须自行处理表不存在的错误。
func RawDB() *sql.DB { return rawDB }
// 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
}
// CheckSchema 启动期只读结构校验(2026-11-06 拍板:启动禁止改库):
// 核心表缺失直接报错并提示先执行 migrate 命令;本函数只查 information_schema,绝不做任何 DDL。
// 列级缺失不在启动期逐一枚举(随首个命中的业务查询以 42703 报错兜底,处理口径同:先 migrate)。
func CheckSchema(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()
required := []string{
"users", "roles", "permissions", // 权限/账号
"materials", "inventories", // 主数据/库存
"inbound_orders", "outbound_orders", // 出入库
"delivery_order", // 配送单
"sys_config", // 基础设置
}
missing := []string{}
for _, t := range required {
var exists bool
if err := sqlDB.QueryRow(
`SELECT EXISTS(SELECT 1 FROM information_schema.tables WHERE table_schema = current_schema() AND table_name = $1)`, t,
).Scan(&exists); err != nil {
return fmt.Errorf("检查表 %s 失败: %w", t, err)
}
if !exists {
missing = append(missing, t)
}
}
if len(missing) > 0 {
return fmt.Errorf("数据库结构未初始化或缺表(%s);启动已禁止自动建表/补列,请先手工执行迁移命令:bj_power_wms migrate", strings.Join(missing, ", "))
}
return 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-11-05 叫料配送拆分):叫料类出库回写所属配送单号
`ALTER TABLE outbound_orders ADD COLUMN IF NOT EXISTS delivery_no 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
}