- 新表 admin_members(user_id 唯一、name、role、status、remark,软删):平台级管理员, 与「主体管理员」完全分开;迁移会把内置管理员(username=admin,没有则 id=1)先入表 - 鉴权:middleware/platform_admin.js —— admin_members 启用行 **或** INTERNAL_ADMIN_IDS(内置/救急入口), 其余一律 403 not_platform_admin;接口挂在 /api/web/admin/* - 主体管理:GET 所有主体(成员数/管理员/是否过期)+ PUT 改授权到期时间 (直接设 expireAt 或 extendDays 顺延),改完失效 subjectState 缓存,设备心跳立刻生效 - 订单管理:GET 所有订单(主体名/下单人/续期前后)+ POST 确认订单 —— 复用支付回调的 payNotify()(标记已支付 + 主体顺延 + 失效缓存 + 幂等),渠道记 manual - 管理员:GET/POST/DELETE /api/web/admin/members(按账号加人、不能删自己/最后一个); 软删行仍占唯一键,查重带 paranoid:false + restore 复用 - 前端:左侧菜单新增「平台管理」组(只有平台管理员可见,路由 meta.platformAdmin 守卫、 不需要选主体),新增 AdminSubjectsView / AdminOrdersView / AdminMembersView - 顶栏右侧新增「下载桌面端 / 下载 Android 扫码台」两个按钮(与权限无关,所有人都显示), 版本号读 /download/version.json 与 /download/android_client/version.json,未发布则置灰提示 - 测试:admin.test.js 12 例(403/表内/内置/列表/添加/重复/删自己/主体列表/改期限/顺延/订单/确认幂等) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
数据库变更规范(DDL)
所有表结构变更只允许通过 sequelize-cli 迁移脚本执行,禁止直接连库改表。
为什么
- 迁移记录在
SequelizeMeta表里,换环境(开发 / 测试 / 生产)按同一条命令重放,不会漏表、漏字段; - 直接
ALTER TABLE无法回溯,环境之间会悄悄不一致; - 回滚有据可依(每个迁移都有
down)。
目录与配置
backend/
├─ .sequelizerc # sequelize-cli 路径配置
├─ database/
│ ├─ config.cjs # 连接信息(与环境变量 / config.local.js 同源)
│ ├─ migrations/ # ★ DDL 脚本放这里
│ └─ seeders/ # 初始数据(可选)
连接信息由 scripts/db-config.js 统一解析:环境变量 > config/config.local.js > 默认值,
与运行时服务完全一致,避免「迁移改 A 库、服务连 B 库」。
常用命令
npm run db:migrate # 执行全部未执行的迁移
npm run db:migrate:status # 查看哪些执行过
npm run db:migrate:undo # 回滚最后一条
npm run db:migration:generate -- create_xxx_tables # 生成迁移骨架
写迁移的约定
- 表名/字段名用下划线,与既有表保持一致;
- 主键统一
BIGINT UNSIGNED自增; - 时间字段统一
created_at/updated_at/deleted_at(软删除),status用TINYINT UNSIGNED; - 不建物理外键(与
users、scanners等既有表一致),只建索引; up()必须能重复执行前先看SequelizeMeta(由 CLI 保证只跑一次),down()必须能干净回滚。
已执行过的迁移
| 迁移 | 内容 |
|---|---|
20261018100000-create-nvr-camera-workstation-tables |
nvrs / cameras / workstations / workstation_cameras / workstation_scan_channels |
20261018150000-add-channel-name-to-cameras |
cameras.channel_name(设备通道名,与业务别名分开) |
20261018180000-add-has-ptz-to-cameras |
cameras.has_ptz(是否支持云台) |
20261018200000-add-workstation-layout |
workstations.canvas_width/height + workstation_cameras.x/y/width/height/stream_type/z_index |
20261018200100-backfill-workstation-camera-layout |
回填已有绑定关系的画布位置(第 1 条铺满 / 第 2 条右上 / 其余左下) |
20261018210000-add-workstation-type |
workstations.ws_type(1 散单 / 2 团购) |
20261018220000-add-workstation-record-range |
workstations.record_before_sec/record_after_sec/record_max_sec(录制范围与最大录制时长) |
20261018230000-create-subject-tables |
新表 subjects / subject_members;scanners/nvrs/cameras/workstations/scan_channels/scan_records 加 subject_id,并把已有数据回填到「每人一个主体」 |
历史遗留的
sql/schema.sql+sql/migrations/*.sql(用npm run db:init执行)是接入 sequelize-cli 之前的做法, 只用于初始化老表;新变更一律写database/migrations/*.js。