-- packservice 库初始化脚本(幂等,可重复执行) -- -- 前提:数据库 `packservice` 已存在(账号 packservice 只有该库的权限,无法建库)。 -- 若需新建库,请用有权限的账号执行: -- CREATE DATABASE IF NOT EXISTS `packservice` -- DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; -- -- 执行方式: -- npm run db:init -- mysql -h127.0.0.1 -P3307 -upackservice -p packservice < sql/schema.sql -- -- ⚠️ 历史变更(旧库需要按顺序补跑一次迁移): -- 1. users 表结构重建(旧的 demo 表只有 id/name/email/age) -- npm run db:init sql/migrations/20261016_rebuild_users.sql -- 2. users 表增加登录密码字段 -- npm run db:init sql/migrations/20261016_add_user_password.sql -- -- 通用约定:BIGINT UNSIGNED 自增主键 + created_at/updated_at + deleted_at(软删除) + status USE `packservice`; -- --------------------------------------------------------------- -- 用户表 -- --------------------------------------------------------------- CREATE TABLE IF NOT EXISTS `users` ( `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '主键', `username` VARCHAR(64) DEFAULT NULL COMMENT '登录名(可空,纯微信登录用户可不设)', `nickname` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '昵称', `email` VARCHAR(128) DEFAULT NULL COMMENT '邮箱(可选,可作登录账号)', `avatar` VARCHAR(255) NOT NULL DEFAULT '' COMMENT '头像地址', `phone` VARCHAR(20) DEFAULT NULL COMMENT '手机号', `password_hash` VARCHAR(100) DEFAULT NULL COMMENT '密码哈希(bcrypt),登录用', `password_changed_at` DATETIME DEFAULT NULL COMMENT '最近一次设置/重置密码的时间(用于让旧 JWT 失效)', `gender` TINYINT UNSIGNED NOT NULL DEFAULT 0 COMMENT '性别:0未知 1男 2女', `status` TINYINT UNSIGNED NOT NULL DEFAULT 1 COMMENT '状态:1正常 0禁用', `remark` VARCHAR(255) DEFAULT NULL COMMENT '备注', `last_login_at` DATETIME DEFAULT NULL COMMENT '最近登录时间', `created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', `updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', `deleted_at` DATETIME DEFAULT NULL COMMENT '软删除时间', PRIMARY KEY (`id`), UNIQUE KEY `uk_username` (`username`), UNIQUE KEY `uk_phone` (`phone`), UNIQUE KEY `uk_email` (`email`), KEY `idx_status` (`status`), KEY `idx_created_at` (`created_at`) ) ENGINE = InnoDB DEFAULT CHARSET = utf8mb4 COMMENT = '用户表'; -- --------------------------------------------------------------- -- 系统配置表:group_name + config_key 唯一定位一条配置 -- 注意:唯一性由 service 层保证(先查后写),这里只建普通索引 —— -- 本表用 deleted_at 软删除,唯一索引会被已删除的记录占用,导致同 key 无法重建。 -- --------------------------------------------------------------- CREATE TABLE IF NOT EXISTS `sys_config` ( `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '主键', `group_name` VARCHAR(64) NOT NULL DEFAULT 'default' COMMENT '分组', `config_key` VARCHAR(128) NOT NULL COMMENT '配置键', `config_value` TEXT COMMENT '配置值', `value_type` VARCHAR(16) NOT NULL DEFAULT 'string' COMMENT 'string/number/boolean/json', `remark` VARCHAR(255) DEFAULT NULL COMMENT '备注', `status` TINYINT UNSIGNED NOT NULL DEFAULT 1 COMMENT '状态:1启用 0禁用', `created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', `updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', `deleted_at` DATETIME DEFAULT NULL COMMENT '软删除时间', PRIMARY KEY (`id`), KEY `idx_group_key` (`group_name`, `config_key`), KEY `idx_group` (`group_name`) ) ENGINE = InnoDB DEFAULT CHARSET = utf8mb4 COMMENT = '系统配置表'; -- --------------------------------------------------------------- -- 扫描器表:扫描器(条码/二维码)端登录后注册到服务,并与账号绑定(user_id 为空 = 未绑定) -- --------------------------------------------------------------- CREATE TABLE IF NOT EXISTS `scanners` ( `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '主键', `user_id` BIGINT UNSIGNED DEFAULT NULL COMMENT '绑定的用户 id,未绑定为 NULL', `sn` VARCHAR(64) NOT NULL COMMENT '扫描器 SN(唯一标识)', `name` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '名称 / 别名', `vendor` VARCHAR(64) DEFAULT NULL COMMENT '厂商', `model` VARCHAR(64) DEFAULT NULL COMMENT '型号', `firmware` VARCHAR(32) DEFAULT NULL COMMENT '固件 / 客户端版本', `ip` VARCHAR(45) DEFAULT NULL COMMENT '最近登录 IP', `secret_hash` VARCHAR(100) DEFAULT NULL COMMENT '扫描器密钥哈希(bcrypt),扫描器端登录用', `token_jti` VARCHAR(64) DEFAULT NULL COMMENT '当前 JWT 的 jti(重签即失效旧令牌)', `token_expires_at` DATETIME DEFAULT NULL COMMENT '令牌过期时间', `status` TINYINT UNSIGNED NOT NULL DEFAULT 1 COMMENT '状态:1正常 0禁用', `last_register_at` DATETIME DEFAULT NULL COMMENT '最近注册时间', `last_login_at` DATETIME DEFAULT NULL COMMENT '最近登录时间', `last_seen_at` DATETIME DEFAULT NULL COMMENT '最近心跳时间', `created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', `updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', `deleted_at` DATETIME DEFAULT NULL COMMENT '软删除时间', PRIMARY KEY (`id`), UNIQUE KEY `uk_sn` (`sn`), UNIQUE KEY `uk_token_jti` (`token_jti`), KEY `idx_user_id` (`user_id`), KEY `idx_status` (`status`) ) ENGINE = InnoDB DEFAULT CHARSET = utf8mb4 COMMENT = '扫描器表'; -- --------------------------------------------------------------- -- 扫描中控通道表:中控(绑定端)上报的通道,一个通道一行 -- 一台中控可接多个扫码设备,每个扫码设备对应一个通道(channel_id + channel_name) -- channel_id 只在同一中控内唯一,所以唯一键是 (scanner_id, channel_id) -- --------------------------------------------------------------- CREATE TABLE IF NOT EXISTS `scan_channels` ( `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '主键', `scanner_id` BIGINT UNSIGNED NOT NULL COMMENT '上报的中控(= scanners.id)', `channel_id` VARCHAR(64) NOT NULL COMMENT '通道 id(中控上报,同一中控内唯一)', `channel_name` VARCHAR(128) NOT NULL DEFAULT '' COMMENT '通道名(中控上报)', `last_report_at` DATETIME DEFAULT NULL COMMENT '最近一次上报时间', `status` TINYINT UNSIGNED NOT NULL DEFAULT 1 COMMENT '状态:1正常 0停用', `remark` VARCHAR(255) DEFAULT NULL COMMENT '备注', `created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', `updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', `deleted_at` DATETIME DEFAULT NULL COMMENT '软删除时间', PRIMARY KEY (`id`), UNIQUE KEY `uk_scanner_channel` (`scanner_id`, `channel_id`), KEY `idx_channel_id` (`channel_id`), KEY `idx_status` (`status`) ) ENGINE = InnoDB DEFAULT CHARSET = utf8mb4 COMMENT = '扫描中控通道表'; -- --------------------------------------------------------------- -- 扫码记录表:中控上报的扫码流水(条码 + 扫描时间 + 通道) -- 去重:唯一键 (scanner_id, channel_id, barcode, scan_time) —— -- 同一中控 + 同一通道 + 同一时间 + 同一条码 的重复上报只入库一次(幂等重试安全)。 -- 时间精确到秒;重复上报不会报错,接口返回 duplicated 计数。 -- 说明:本表是流水表,不用软删除(软删除会占用唯一键,导致同一条记录无法再入库); -- 需要清理请按时间物理删除(DELETE ... WHERE scan_time < ?)。 -- --------------------------------------------------------------- CREATE TABLE IF NOT EXISTS `scan_records` ( `id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '主键', `scanner_id` BIGINT UNSIGNED NOT NULL COMMENT '上报的中控(= scanners.id)', `channel_id` VARCHAR(64) NOT NULL COMMENT '通道 id', `barcode` VARCHAR(255) NOT NULL COMMENT '条码内容', `scan_time` DATETIME NOT NULL COMMENT '扫描时间(中控上报,秒级)', `reported_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '服务端接收时间', `subject_id` BIGINT UNSIGNED NULL COMMENT '所属主体 subjects.id(跟随中控)', -- ↓ 2026-10-18 新增(迁移 20261018240000):运单回放要按「当时」的工作台配置拉流 `workstation_id` BIGINT UNSIGNED NULL COMMENT '当时绑定的工作台 workstations.id', `workstation_snapshot` JSON NULL COMMENT '工作台快照(录像机/摄像头/布局/录制范围)', `created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', `updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', PRIMARY KEY (`id`), UNIQUE KEY `uk_scan_dedup` (`scanner_id`, `channel_id`, `barcode`, `scan_time`), KEY `idx_scan_time` (`scan_time`), KEY `idx_barcode` (`barcode`), KEY `idx_channel_scan_time` (`channel_id`, `scan_time`), KEY `idx_scan_subject_barcode` (`subject_id`, `barcode`), KEY `idx_scan_channel_seq` (`scanner_id`, `channel_id`, `scan_time`) ) ENGINE = InnoDB DEFAULT CHARSET = utf8mb4 COMMENT = '扫码记录表(同 中控+通道+条码+扫描时间 去重;带当时的工作台快照)'; -- --------------------------------------------------------------- -- 初始化配置(可选) -- --------------------------------------------------------------- INSERT INTO `sys_config` (`group_name`, `config_key`, `config_value`, `value_type`, `remark`) SELECT 'wechat', 'default_appid', '', 'string', '默认微信 appid' FROM DUAL WHERE NOT EXISTS ( SELECT 1 FROM `sys_config` WHERE `group_name` = 'wechat' AND `config_key` = 'default_appid' AND `deleted_at` IS NULL );