SunYF
62e45b7379
1. 新增跨平台磁盘空间监控能力，每日7点自动检测附件目录剩余空间，触发阈值告警 2. 重构附件存储方案为年/月/日/文件类型分层结构，统一MES与WMS的附件管理逻辑 3. 对齐物料档案与入库单的质量状态校验规则，仅合格品计入库存与出库 4. 实现入库单作废功能与区域库位的多级父子结构管理 5. 删除物料简称字段，补充规格型号与单位必填项，统一系统数据口径 6. 新增附件中心与磁盘状态查询接口，完善权限控制与操作日志
214 lines
12 KiB
Go
214 lines
12 KiB
Go
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()
|
||
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")
|
||
}
|
||
}
|
||
slog.Info("数据库迁移完成")
|
||
return nil
|
||
}
|
||
|
||
// applyColumnPatches 幂等补齐已有表的新增列。
|
||
// 背景：ent 的 Schema.Create 对已存在表不会 ADD COLUMN，故新增字段必须在此登记，
|
||
// 否则新库正常、存量库缺列导致运行时 500。
|
||
func applyColumnPatches(ctx context.Context) {
|
||
if rawDB == nil {
|
||
return
|
||
}
|
||
stmts := []string{
|
||
// 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`,
|
||
// 缺货预警：物料安全库存
|
||
`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`,
|
||
// 库存明细：库位贯通 货架/层/位置（问题记录 一.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`,
|
||
// 入库单质量状态（问题记录 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）不参与唯一性；batch_no 仅约束结构件(manage_mode=1)。
|
||
// 注：存量若有重复数据会导致建索引失败（仅告警不阻断启动），上线前须先清理重复。
|
||
`CREATE UNIQUE INDEX IF NOT EXISTS ux_inventories_batch_no ON inventories (batch_no) WHERE manage_mode = 1 AND batch_no IS NOT NULL AND batch_no <> ''`,
|
||
`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)`,
|
||
// 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`,
|
||
// 接驳台是独立主数据（不依附工位）：产线/库房/其他三类；与工位 1:1 绑定。
|
||
// 部分唯一索引只约束产线接驳台（station_no > 0），库房/其他(station_no=0)不参与。
|
||
`CREATE UNIQUE INDEX IF NOT EXISTS ux_docks_station_no ON docks (station_no) WHERE station_no > 0`,
|
||
// 入库作废（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`,
|
||
// 附件：新存储方案（年/月/日/文件类型/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 archived boolean NOT NULL DEFAULT false`,
|
||
`ALTER TABLE attachments ADD COLUMN IF NOT EXISTS archived_at bigint`,
|
||
`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`,
|
||
}
|
||
for _, s := range stmts {
|
||
if _, err := rawDB.ExecContext(ctx, s); err != nil {
|
||
slog.Warn("补齐列失败(可忽略): " + err.Error())
|
||
}
|
||
}
|
||
}
|