liufumingren bca8f7270c 本机预览/云台/拉通道全部改走 WebSocket(桌面 1.0.75)
桌面端
- 新增 LocalWsServer(ws://127.0.0.1:17301):hello / ping / get_channels /
  start_preview / stop_preview / open_window / close_window / ptz / ptz_preset,
  一条连接可同时推多路 JPEG 帧(帧头带 sid);慢命令并发派发,云台命令按连接串行,
  页面断开自动清理会话与满帧率窗口
- LocalHttpServer 删除预览(MJPEG/快照/满帧率窗口)、/api/hik/channels、/api/hik/ptz*,
  HTTP 17300 只保留 /api/query/{code}、/api/activate-login、/api/playback/download,
  其余 POST 统一回 404 并提示已迁到 WS;不再依赖 HCNetSDK
- App 自行组装 HikStreamService -> HikPreviewService + HikNativePreviewService 注入 WS
- 后台服务加固:框架依赖(开发版)安装/启动时自动写服务环境变量 DOTNET_ROOT,
  避免 LocalSystem 找不到用户目录里的 .NET 8 而报「后台服务启动超时」

前端
- 新增 api/localWs.ts(连接/断线/请求-响应/二进制帧分发),补 getChannels / openWindow /
  closeWindow / ptz / ptzPreset
- CamerasView 预览只走 WS(保留「唤起本机软件 -> 等待 -> 提示安装」兜底),
  满帧率窗口、云台、预置点改走 WS
- NvrsView 拉取通道改走 WS(连不上时自动唤起一次再重试)
- CameraLayoutCanvas 合成画面 4 路改 WS 推帧
- 删除 createHikPreview/closeHikPreview*/openHikWindow/closeHikWindow*/ptzControl/ptzPreset
  与 isLocalServiceAlive/waitForLocalService

其他
- 移除 cameras.has_ptz(迁移 20261019233000)与相关接口/字段/UI
- 通道号按 struStreamMode 映射(IP 通道空槽导致 51 之后整体错位)
- 扫码 24 小时内只保留最后一次扫描(后上报时间更新时覆盖)
- 清理历史 DESKTOP 占位通道(迁移 20261019230000)
- README / desktop README 补 17301 与 WS 接口说明,修正已删除的 /api/health 描述
2026-10-20 00:47:31 +08:00
..

数据库变更规范(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。