2.0.1#

版本：2.0.1-20260913#

项目	内容
版本号	2.0.1-20260913
更新日期	2026-08-25 ~ 2026-09-13
更新范围	☑ 前端 ☑ 后端 □ 全量 □ 其他
影响范围	☑ 新增功能 ☑ 存量功能优化 ☑ 问题修复 □ 无业务影响（仅底层调整）

核心更新内容#

1. 新增功能

   • [Web 客户端] 新增单兵地图初始设备巡览：首次进入页面时对有效 GPS 设备逐台飞行浏览，每台停留约一秒，任意地图操作可立即接管并终止巡览。
   • [Web 客户端] 设备入群通知新增群组名称、采样率与音频编码字段，设备入群即可获得完整群组音频配置。

2. 功能优化

   • [Web 客户端] 对讲界面文案与状态呈现整体优化：以业务语言替代协议术语与内部标识，连接失败按来源（超时、服务通信、会话确认、音频、通话设置）分类呈现，在线数量、参考容量、音频预设命名等表述校准，多语言文案补齐收敛。
   • [Web 客户端] 大规模设备场景性能优化：多路直播设备树、单兵地图标记与全局界面渲染在 500 台设备规模下显著减负，操作与输入响应更流畅。
   • [Web 客户端] 定位与地址查询结果本地持久缓存，地图定位与国家/反向地址查询更快，弱网环境下已有结果仍可使用。
   • [Web 客户端] 报表日志查询改用按月/日分区检索并合并排序，大时间范围查询更稳定，支持滚动加载。
   • [Web 客户端] 报表页面 Excel 导入导出入口统一，Excel 组件改为使用时加载，页面打开更轻快。
   • [Web 客户端] 地图飞行按真实落点判定到达，切换目标或退出页面时安全取消动画，定位飞行更精准稳定。
   • [Web 客户端] 对讲信令处理收敛，迟到或无关回包不再误推进房间状态，进房与配置流程更可靠。
   • [Web 客户端] 表单错误提示与对讲状态文案统一在展示层翻译，多语言呈现更完整准确。
   • [Web 客户端] 登录失败后自动刷新验证码，无需手动更换。
   • [服务端] 优化数据库连接池配置与空闲回收策略，降低常驻与峰值资源占用，连接生命周期管理更可靠，更适合小规格服务器部署。
   • [服务端] 组织、租户、用户组、设备类别等树形数据的展示与重算统一收敛，自动修正重复节点与关系断环，层级展示更可靠。

3. 问题修复

   • [Web 客户端] 修复设备离线后对讲成员列表仍显示残留在线状态的问题。
   • [Web 客户端] 修复设备入房补偿与 PTT 配置下发请求参数格式错误导致功能失效的问题。
   • [服务端] 恢复存量客户端认证与权限异常响应的旧版兼容（HTTP 200 传输与原错误码、错误信息），避免旧版设备与 Web 端无法正常认证。
   • [服务端] 修复对讲发话出现明显声音延时的问题（依据现场接入反馈优化建房音频参数）。
   • [服务端] 修复首次管理员登录场景消息租户作用域缺失导致初始化流程失败的问题。
   • [服务端] 补齐团队管理默认角色的 Janus 管理页面入口与配置更新权限，按模板初始化的角色可直接进入页面编辑配置。
   • [服务端] 修复设备归属转移过程中的数据一致性问题，转移收口为原子事务，不再出现半转换状态。
   • [服务端] 修复事务提交后回调异常导致已成功操作被误报失败的问题。
   • [服务端] 修复事务场景下操作日志漏发的问题，审计日志记录更完整。
   • [服务端] 统一「仅本人创建」数据权限的判定与查询条件来源，不再采信客户端传入的权限字段，防止越权查询。

4. 策略调整

   • [服务端] PTT 默认对讲群组机制调整：平台不再维护设备与群组关系上的默认群组标记，默认组改由设备侧保留，需要变更时在管理界面按单台设备显式下发本次默认组；PTT 配置刷新与查询合同同步更新——配置刷新请求可携带本次默认组，设备查询返回本次选择的默认组与完整群组列表（不再返回默认标记字段），入群通知字段同步调整。仍在读取默认标记字段或旧刷新载荷的对接端请完成适配。

版本：2.0.1-20260824#

项目	内容
版本号	2.0.1-20260824
更新日期	2026-08-13 ~ 2026-08-24
更新范围	☑ 前端 ☑ 后端 □ 全量 □ 其他
影响范围	☑ 新增功能 ☑ 存量功能优化 ☑ 问题修复 □ 无业务影响（仅底层调整）

核心更新内容#

1. 新增功能

   • [Web 客户端] 新增对讲群组设备请离功能，可在成员列表中对在房设备发起请离请求，确认后下发请离通知并等待设备离开。
   • [Web 客户端] 新增麦克风电平分段条与发话状态环，发话音量与传输状态实时可视化，动效随音量起伏。
   • [Web 客户端] 新增界面缺失翻译自动采集与批量上报，缺失词条自动回传，提升多语言完整性。
   • [服务端] 新增 BMC 设备绑定生命周期查询，返回绑定生命周期字段并支持按创建/修改/删除时间区间过滤。
   • [服务端] 新增 WebRTC 独立 Janus 转发通道族，为 WebRTC 设备提供独立的消息转发通道。

2. 功能优化

   • [Web 客户端] 对讲进房链路提速：精简信令交互并让进房步骤并行执行，进房耗时明显缩短；ICE 配置本地缓存，弱网环境进房更稳定。
   • [Web 客户端] 错误提示呈现优化：业务失败信息本地准确呈现并完成国际化，消除全局与本地重复提示。
   • [Web 客户端] 界面文案规范化：统一大小写与术语拼写，存量硬编码文案纳入多语言管理。
   • [Web 客户端] 对讲组编辑器新增离开确认提示，防止误刷新或关闭标签页丢失未保存的配置。
   • [Web 客户端] 新增英文版构建档位与版本信息注入防呆，支撑国外版部署发布。❓（面向国外版部署的构建能力，国内集成方无直接感知，是否对外收录请裁决）
   • [服务端] 多租户写边界加固：员工、组织、字典、权限、消息、翻译等全域写操作统一由服务端下发租户，防止跨租户数据越权写入。
   • [服务端] 安全加固：上传文件路径遏制、敏感日志脱敏、Janus 上行报文严格校验与 Janus 服务器管理租户边界。
   • [服务端] 协议错误响应规范化：参数校验失败、请求方法/媒体类型不匹配、资源不存在等统一返回 4xx，不再落入 500，便于按状态码处理错误。
   • [服务端] 设备在线状态判定优化，客户端活跃事件即时刷新在线状态，避免设备被误判离线。
   • [服务端] 统一四个登录入口的租户上下文装配，各入口登录后租户恢复行为一致。
   • [服务端] 字典查询支持业务租户自定义条目覆盖公共默认值。

3. 问题修复

   • [Web 客户端] 修复直播画面在设备 P2P 过渡状态下长时间卡死的问题，并提升信令消息投递可靠性。
   • [Web 客户端] 修复特定角色组合下报表菜单不显示的问题；停用账号后权限相关界面即时隐藏。
   • [Web 客户端] 修复对讲组读权限判定与后端权限标识不一致导致的页面入口误拦问题。
   • [服务端] 修复旧版 WebRTC 固件设备获取 ICE 配置无响应（webrtc 主题回复消失）的问题。
   • [服务端] 修复设备列表与详情接口丢失绑定授权码字段的问题。
   • [服务端] 修复平台侧模拟检索导致已断线设备被误标在线的问题。
   • [服务端] 修复设备消息处理失败时响应重复发送或向设备回显内部异常的问题。
   • [服务端] 修复数据库快照触发器在异常场景下漏建历史表或跨租户误删历史数据的问题。
   • [服务端] 修复 Janus 转发与检索回包消息回环导致的重复消费问题。
   • [服务端] 修复权限判定 All 族语义（此前任一权限命中即放行），多权限组合校验恢复严格匹配。
   • [服务端] 修复通用固件保存接口 binaryHeader 字段丢失对象结构的问题。
   • [服务端] 修复验证邮件翻译匹配不精确的问题，多语言用户收到的验证邮件语言与其界面语言保持一致。
   • [服务端] 修复内置 administrator 角色可被更新覆盖的问题，防止内置管理员角色被改动导致权限体系失效。

4. 策略调整

   • [服务端] 退役废弃公开接口（缓存读写、对讲组计数），如仍在调用请迁移至替代接口。
   • [服务端] 退役旧版 MQTT 通道族（server/center/ 前缀通道族与旧版 Web UI Janus 转发通道），过渡期已满，仍在使用旧通道的接入端请完成切换。
   • [Web 客户端] WebRTC 状态事件主题统一为 device/{deviceNo}/webrtc/status 规范格式。❓（前后端同步迁移的内部事件主题，是否对集成方构成契约承诺存疑，请裁决是否收录）

版本：2.0.1-20260812#

项目	内容
版本号	2.0.1-20260812
更新日期	2026-08-03 ~ 2026-08-12
更新范围	☑ 前端 ☑ 后端 □ 全量 □ 其他
影响范围	☑ 新增功能 ☑ 存量功能优化 ☑ 问题修复 □ 无业务影响（仅底层调整）

核心更新内容#

1. 新增功能

   • [Web 客户端] 新增 PTT 设备集成指南与 ICE 配置获取功能。
   • [Web 客户端] 新增本地发话链路与 AudioBridge 确定性恢复机制，按会话健康与可用性自动裁决恢复策略。
   • [Web 客户端] 新增成员花名册视图，优化成员列表体验，并新增设备绑定加入通知与临时设备批量通知。
   • [Web 客户端] 新增房间处理流程与重试状态可视化呈现，并暴露信令与媒体调试日志便于排障。
   • [服务端] 新增翻译视图发布与缺失翻译批量摄取功能，支持有界轮次处理。
   • [服务端] PTT retrieve 接口新增返回 ICE 配置功能。

2. 功能优化

   • [服务端] Meilisearch 新增磁盘 spool 机制与队列限流，提升历史数据处理性能与可靠性。
   • [服务端] 优化翻译发布逻辑，统一轮次处理并重构发布器，降低资源占用。
   • [服务端] 统一入房动作权限并授予默认角色完整对讲群组权限，优化权限体系。
   • [Web 客户端] 统一播放音量管理并解锁 autoplay，完善房间成员状态生命周期。
   • [Web 客户端] 统一页面头部状态呈现、工作台交互与设备工作空间对齐，新增响应式房间主控。
   • [Web 客户端] 新增入房 PTT 配置刷新功能，提升实时性。

3. 问题修复

   • [服务端] 修复事务边界问题，确保消息和操作日志只在事务提交成功后发送。
   • [服务端] 修复对讲群组删除顺序问题，群组删除后先销毁房间再刷新 PTT。
   • [服务端] 修复 PTT 配置刷新时机，确保在事务提交成功后触发。
   • [服务端] 修复对讲群组与设备绑定同事务软删除的数据一致性问题。

版本：2.0.1-20260802#

项目	内容
版本号	2.0.1-20260802
更新日期	2026-07-06 ~ 2026-08-02
更新范围	☑ 前端 ☑ 后端 □ 全量 □ 其他
影响范围	☑ 新增功能 ☑ 存量功能优化 ☑ 问题修复 □ 无业务影响（仅底层调整）

核心更新内容#

1. 新增功能

   • [Web 客户端] 新增集群对讲设备管理与设备绑定列表功能，支持在设备侧管理对讲组关系。
   • [Web 客户端] 新增对讲组管理页面，支持查看和编辑对讲组配置及关联设备。
   • [Web 客户端] 对讲组在线状态实时显示，区分 PTT/SFU 客户端类型。
   • [Web 客户端] 对讲房间功能增强，支持成员列表、房间信息及 Room PIN 安全展示与验证。
   • [服务端] 新增对讲组复合保存/更新接口，支持一次性保存对讲组及关联设备。
   • [服务端] 新增设备对讲组绑定接口与对讲组设备详情查询 API。
   • [服务端] 新增 PTT 配置在线刷新功能，支持对在线设备动态下发配置。
   • [服务端] 新增房间补偿机制，自动修复不一致或异常的对讲房间状态；并新增已删除对讲房间每日销毁补偿任务。

2. 功能优化

   • [服务端] 设备列表查询改用静态缓存及批量数据补全，降低数据库压力，提升查询性能。
   • [服务端] 批量优化设备状态缓存、Janus 管理密钥、WebRTC 节点解析等高频查询。
   • [服务端] 调整数据库连接池容量配置，提升资源利用率。
   • [Web 客户端] 对讲组列表采用自然网格布局，支持分页加载和搜索过滤。
   • [Web 客户端] 优化对讲组保存流程，增加变更摘要和防重复提交机制。
   • [Web 客户端] 优化深色模式主题适配，修复 toast 描述文字对比度问题。

3. 问题修复

   • [服务端] 修复对讲组设备关系同步可能导致的更新丢失问题。
   • [服务端] 修复 PTT MQTT 负载编码错误与 MQTT 字节数组负载处理异常，确保消息正确解析。
   • [服务端] 修复唯一索引导致默认设备无法跨对讲组使用的问题。
   • [服务端] 修复设备信息上报租户隔离问题与列表排序时空值置顶问题。
   • [Web 客户端] 修复对讲房间成员刷新及 MQTT 断线重连后状态恢复问题。
   • [Web 客户端] 修复 AudioBridge 浏览器 offer 协商失败问题。
   • [Web 客户端] 修复 Janus session 保活及成员静音保护问题。

版本：2.0.1-20260705#

项目	内容
版本号	2.0.1-20260705
更新日期	2026-06-01 ~ 2026-07-05
更新范围	☑ 前端 ☑ 后端 □ 全量 □ 其他
影响范围	☑ 新增功能 ☑ 存量功能优化 ☑ 问题修复 □ 无业务影响（仅底层调整）

核心更新内容#

1. 新增功能

   • [Web 客户端] 新增集群对讲工作台，支持对讲群组创建与管理、设备选择与实时对讲控制。
   • [Web 客户端] 新增 Janus 服务器管理界面，支持服务器列表查看、新增、编辑与筛选。
   • [Web 客户端] Dashboard 模块全面上线，支持设备、服务器、存储、电池、上传、告警等多维度数据监控与可视化。
   • [服务端] 新增对讲群组完整功能（群组分页查询、保存、设备成员关系管理、设备视图查询等）。
   • [服务端] 新增 Janus 服务器管理服务，支持服务器信息维护与在线状态查询。
   • [服务端] Dashboard 新增设备绑定分页查询与固件包管理 API。

2. 功能优化

   • [服务端] 设备绑定分页查询改用 LATERAL LIMIT 1，提升查询性能。
   • [服务端] 完成租户数据迁移（default → pcm），统一多租户数据架构。
   • [服务端] 固件包描述字段拆分为双语（en/zh），支持国际化。
   • [Web 客户端] 导航菜单数据源简化，支持租户隔离配置，优化导航缓存策略。

3. 问题修复

   • [服务端] 修复设备在线率计算逻辑，改用历史时长计算并增加防御性上限校验，提升数据准确性。
   • [服务端] 修复对讲群组设备成员关系刷新，确保成员状态实时同步。
   • [服务端] 修复若干数据同步问题（含 timestamp 类型转换）。
   • [服务端] 补全固件包/采集服务器查询的租户迁移遗漏，确保数据完整性。
   • [Web 客户端] Dashboard 分页参数统一为 current/pageSize 规范。

版本：2.0.1-20260531#

项目	内容
版本号	2.0.1-20260531
更新日期	2026-05-04 ~ 2026-05-31
更新范围	☑ 前端 ☑ 后端 □ 全量 □ 其他
影响范围	☑ 新增功能 ☑ 存量功能优化 ☑ 问题修复 □ 无业务影响（仅底层调整）

核心更新内容#

1. 新增功能

   • [服务端] API 错误响应支持国际化，返回本地化错误消息。
   • [服务端] 新增设备分享数量限制校验，目标用户名自动识别邮箱或手机号格式。
   • [服务端/Web 客户端] 新增用户头像上传与展示功能，支持头像路径统一管理与 Nginx 静态资源访问。
   • [服务端] 新增 SpiritCam 固件包更新接口，支持按版本前缀匹配查询。
   • [Web 客户端] 新增设备详情 Dashboard 页面，展示设备状态与趋势数据。
   • [Web 客户端] 新增在线状态页面（服务器/设备维度），支持状态筛选与数据刷新。
   • [Web 客户端] 新增资源/告警 Dashboard 页面，提供汇总视图与排行榜。
   • [Web 客户端] 新增租户特定导航数据加载，提升多租户场景隔离性。

2. 功能优化

   • [服务端] 租户列表查询改用缓存机制，降低数据库查询压力。
   • [服务端] JWT token 过期时间延长至 3 天，改善登录体验。
   • [服务端] 固件上传改为流式处理，避免大文件全量读入内存，提升上传稳定性。
   • [服务端] 租户删除保护逻辑重构，支持多租户预置与管理。
   • [服务端] 翻译缺失键自动入队回填，缺失时返回 key 作为兜底值，提升国际化健壮性。
   • [服务端] SpiritCam 固件包查询改为版本前缀匹配，公网接口迁移至 main-api 统一管理。
   • [Web 客户端] KPI 卡片与图表支持时间范围参数，数据查询更灵活。

3. 问题修复

   • [服务端] 修复数据同步若干数据处理问题（含 timestamp 类型转换）。
   • [Web 客户端] 修复 Dashboard 零除异常，目标值与总数计算增加边界检查。
   • [Web 客户端] 修复图表卡片区字段长度与换行问题，优化数据列宽度与文本显示。

版本：2.0.1-20260503#

项目	内容
版本号	2.0.1-20260503
更新日期	2026-04-06 ~ 2026-05-03
更新范围	☑ 前端 ☑ 后端 □ 全量 □ 其他
影响范围	☑ 新增功能 ☑ 存量功能优化 □ 问题修复 □ 无业务影响（仅底层调整）

核心更新内容#

1. 新增功能

   • [服务端] 新增数据采集设备按 ID 查询详情接口。
   • [服务端] 零售版设备列表接口增加固件包（firmwarePackage）数据返回。
   • [Web 客户端] 新增 Dashboard 首页布局，支持 KPI 卡片与趋势图表展示。

2. 功能优化

   • [Web 客户端] 报表首页完成 Dashboard 化改造，优化信息架构与视觉呈现。
   • [Web 客户端] 服务器详情页优化图表展示与 KPI 卡片，提升数据可读性。
   • [Web 客户端] 报表子页面重设计，统一视觉风格与交互规范。

版本：2.0.1-20260405#

项目	内容
版本号	2.0.1-20260405
更新日期	2026-03-02 ~ 2026-04-05
更新范围	☑ 前端 ☑ 后端 □ 全量 □ 其他
影响范围	☑ 新增功能 ☑ 存量功能优化 ☑ 问题修复 □ 无业务影响（仅底层调整）

核心更新内容#

1. 新增功能

   • [服务端] 实现从节点固件文件同步功能，支持固件包远程同步与调度管理。
   • [服务端] 支持数据采集服务器外网 IP 配置，增强复杂网络环境部署能力。
   • [服务端] 新增用户账号停用（注销）功能，支持邮箱/短信验证的账号停用流程。
   • [Web 客户端] 新增 GPS 轨迹可视化组件，支持设备轨迹实时显示、回放与样式自定义。

2. 功能优化

   • [服务端] 优化数据采集设备导入列表 ID 解析与验证逻辑，提升批量导入处理效率。
   • [服务端] 调整组织与设备权限边界，提升数据隔离准确性。
   • [Web 客户端] 优化 GPS 轨迹播放交互（中心点跟随、动画流畅度、终点图标显示）。
   • [Web 客户端] 统一登录跳转逻辑，优化账号状态变更后的路由处理。

3. 问题修复

   • [服务端] 修复设备号唯一性验证缓存一致性问题。
   • [服务端] 修复设备服务器绑定唯一性缺陷，防止重复绑定导致的业务异常。
   • [服务端] 修复固件包查询时 deviceModelId 空值检查缺失问题。
   • [服务端] 修复用户中心 Controller 中 employee 循环查找逻辑缺陷。
   • [Web 客户端] 修复 GPS 轨迹地图初始化位置优先级、瓦片显示不全及飞行动画队列问题。
   • [Web 客户端] 修复轨迹播放朝向旋转过渡动画卡顿问题。

4. 策略调整

   • [服务端] 限制固件文件上传仅允许 .bin 与 .img 格式，提升固件管理安全性。

版本：2.0.1-20260301#

项目	内容
版本号	2.0.1-20260301
更新日期	2026-02-02 ~ 2026-03-01
更新范围	☑ 前端 ☑ 后端 □ 全量 □ 其他
影响范围	☑ 新增功能 ☑ 存量功能优化 ☑ 问题修复 □ 无业务影响（仅底层调整）

核心更新内容#

1. 新增功能

   • [Web 客户端] 新增 v2 APK 下载页，支持二维码扫码下载。
   • [Web 客户端] 地图缩放最大级别由统一 18 级改为按各地图类型分别设定，发挥各地图源高清层级，优化地图浏览体验。
   • [Web 客户端] 完善 to-C（面向消费者）模式路由。
   • [服务端] 数据同步支持复合主键表，增强复杂数据的集成同步能力。

2. 功能优化

   • [服务端] 数据查询与导出改用流式查询，降低内存占用，提升大数据量场景处理性能。
   • [服务端] 国际化翻译写入引入内存队列与批量去重缓存，提升翻译数据写入吞吐量。
   • [服务端] 日志检索后端迁移至 Meilisearch，提升日志检索性能与容量。
   • [服务端] IP 检测增强，支持多种代理头部与公网 IP 识别，提升部署网络适应性。

3. 问题修复

   • [Web 客户端] 修复「隐私政策」「使用条款」法律协议文档（中英文）。
   • [服务端] 修复数据同步若干数据处理问题（含 timestamp 类型转换、含下划线表名解析、全量导入起始序号生成）。

4. 策略调整

   • [服务端] IP 访问限流策略收紧（更严格限流规则）；集成方高频调用可能受限，请评估调用频率。

版本：2.0.1-20260201#

项目	内容
版本号	2.0.1-20260201
更新日期	2026-01-13 ~ 2026-02-01
更新范围	☑ 前端 ☑ 后端 □ 全量 □ 其他
影响范围	☑ 新增功能 ☑ 存量功能优化 ☑ 问题修复 □ 无业务影响（仅底层调整）

核心更新内容#

1. 新增功能

   • [服务端] 跨境数据同步功能完成，支持数据中心间的数据同步与集成。

2. 功能优化

   • [服务端] 数据同步模块改用游标方式查询，降低内存占用。
   • [服务端] 增量导出删除性能优化，减少锁竞争，提升并发处理能力。
   • [服务端] 数据同步导入后增加通知机制，增强集成方事件感知能力。
   • [服务端] 数据同步触发器安装服务优化，提升稳定性。
   • [Web 客户端] 启用 Terser 代码压缩，减小前端资源体积，提升加载性能。

3. 问题修复

   • [服务端] 修复数据同步触发器安装和表元数据查询问题。
   • [服务端] 修复数据同步无主键表处理逻辑，确保各类数据表正确同步。
   • [服务端] 修复设备列表重复设备编号问题（设备绑定、共享等接口数据一致性优化）。

版本：2.0.1-20260112#

项目	内容
版本号	2.0.1-20260112
更新日期	2026-01-12
更新范围	☑ 前端 ☑ 后端 ☑ 全量 □ 其他
影响范围	□ 新增功能 ☑ 存量功能优化 □ 问题修复 □ 无业务影响（仅底层调整）

核心更新内容#

1. 功能优化
   • [协议管理] BCMS 协议更新，去除公司相关信息，并翻译为英文版，共完成四个文件的更新。
   • [业务接口] BCMS App API 绑定接口改进，支持 v2 版本 token 验证，增加强制绑定传参控制功能。
   • [代码质量] 对后端代码进行多轮扫描检查代码质量和潜在 BUG，完成代码改进。
   • [代码质量] 对前端代码进行多轮扫描检查代码质量和潜在 BUG，完成代码改进。