packServer/backend/sql/schema.sql
liufumingren bd2363bf00 chore: 初始化仓库(backend / frontend / extension 三块)
- backend/:Egg 3 纯 JSON 接口服务(MySQL 8 + Redis),全部走 header 令牌鉴权;
  已彻底去掉服务端渲染(删除 page 控制器 / app/view / nunjucks / session / CSRF),
  开发时把页面请求反代到前端 dev server,生产托管 frontend/dist(SPA 回退)。
  单测 91 个通过(不需要本机数据库)。
- frontend/:Vite + Vue3 + TypeScript 的 SPA(登录 / 注册 / 找回密码 / 扫码登录与确认 /
  首页统计 / 设备管理 / 扫码记录 / 个人中心 / 测试页),vue-tsc 类型检查与构建通过。
- extension/:MV3 浏览器扩展(零构建),注入第三方 WMS 页面识别运单号并打开溯源页。
- 忽略规则统一放根 .gitignore:node_modules、dist、logs / logs-*、run、typings、
  .env*、config.local.js(含本机数据库与 Redis 密码,绝不入库)。
2026-10-17 08:50:32 +08:00

192 lines
12 KiB
SQL
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.

-- 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),登录用',
`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 = '用户表';
-- ---------------------------------------------------------------
-- 微信授权表:一条记录 = 某用户在某 appid 下的一次授权
-- 一个用户可绑定多个微信(公众号 / 小程序 / 开放平台)
-- ---------------------------------------------------------------
CREATE TABLE IF NOT EXISTS `wechat_oauth` (
`id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '主键',
`user_id` BIGINT UNSIGNED NOT NULL COMMENT '关联 users.id',
`appid` VARCHAR(64) NOT NULL COMMENT '微信 appid',
`openid` VARCHAR(64) NOT NULL COMMENT '用户在该 appid 下的 openid',
`unionid` VARCHAR(64) DEFAULT NULL COMMENT '开放平台 unionid',
`nickname` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '授权时微信昵称',
`avatar` VARCHAR(255) NOT NULL DEFAULT '' COMMENT '授权时微信头像',
`session_key` VARCHAR(128) DEFAULT NULL COMMENT '小程序 session_key',
`access_token` VARCHAR(512) DEFAULT NULL COMMENT '网页授权 access_token',
`refresh_token` VARCHAR(512) DEFAULT NULL COMMENT '刷新令牌',
`scope` VARCHAR(64) DEFAULT NULL COMMENT '授权 scope',
`token_expires_at` DATETIME DEFAULT NULL COMMENT 'access_token 过期时间',
`last_auth_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_appid_openid` (`appid`, `openid`),
KEY `idx_user_id` (`user_id`),
KEY `idx_unionid` (`unionid`)
) 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 '服务端接收时间',
`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`)
) 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
);