/api/web/records 是 findAndCountAll,列表本身走 idx_scan_time 只要 0.5ms, 慢的是后面那条 count(id):MySQL 只能选 (subject_id, barcode),索引里没有 scanner_id,于是按主键逐行回表判断 —— 线上 16.5 万条时 Rows_examined ≈ 33 万, 慢查询日志里 3.2s~9.9s(冷缓存时走磁盘)。 补 (subject_id, scanner_id, scan_time) 后 count 变成纯索引扫描(Using index), 实测 0.45s(热)/9.9s(冷) → 0.09s。 - 新增迁移 20261116200000-add-scan-record-list-index.js(幂等,已在生产执行) - sql/schema.sql 基线同步该索引 - README 补索引用途与实测数字 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
172 lines
11 KiB
SQL
172 lines
11 KiB
SQL
-- 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`),
|
||
-- ↓ 2026-11-16 新增(迁移 20261116200000):列表页 count(*) 走覆盖索引,不再逐行回表
|
||
KEY `idx_scan_subject_scanner_time` (`subject_id`, `scanner_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
|
||
);
|