2025年04月27日

上周工作回顾

KH2248 项目：WEB 客户端开发

目标: redmine.intelbras.com.br 上分配的任务处理
进度：已完成 100% 达成预期目标。

中心服务平台：1.0.1 版本, 处理已测试出的问题, 制作安装程序和升级程序并开展自测工作。待自测通过后, 更新测试手册, 随后将其提供给测试进行集成测试。

目标：优先处理耗时较少的任务。
进度：计划完成 50%, 已完成 50% 达成预期目标。

中心服务平台：1.0.1 版本, 服务端程序, 依赖库升级

目标：定期更新依赖库, 确保服务端程序的稳定运行。
进度：已完成 100% 达成预期目标。

中心服务平台：1.0.2 版本, 销售或测试建议新增的功能

目标：优先处理耗时较少的任务。
进度：已完成 100% 达成预期目标。

Webrtc 开发文档

目标：为巴西客户提供详细的 WebRTC 开发技术支持文档。因为该文档涉及多个技术细节, 全部完成可能需要较长时间。暂时只以提供代码示例和基本概念为主。
进度：已完成 100% 达成预期目标。

本周工作计划

中心服务平台：1.0.1 版本, 处理已测试出的问题, 制作安装程序和升级程序并开展自测工作。待自测通过后, 更新测试手册, 随后将其提供给测试进行集成测试。

目标：优先处理耗时较少的任务。
预期进度：计划完成 80%。

日常协作事宜

以下为当前需协作完成的关键任务列表。姚海涛作为主要协助人员, 将全力配合各位同事, 保障项目高效推进。

APP 接口联调与文档优化

内容：协助郭工对 APP 的 HTTP API 和 MQTT 信令交互接口进行全面联调。采用专业测试工具与规范测试方法, 严格验证接口功能的正确性、数据传输的准确性与稳定性。同时, 系统梳理相关接口文档, 补充接口参数（如参数类型、取值范围、默认值等）、返回值格式（如数据结构、字段含义等）以及异常处理（如异常类型、错误码、处理方式等）的详细说明, 确保文档符合行业规范、逻辑清晰, 便于后续开发与测试人员参考使用。

KH2248 项目设备 WEB 前端定制开发技术支持

内容：为韦工在 KH2248 项目的设备 WEB 前端定制开发中提供全方位技术支持。针对开发过程中可能出现的页面布局合理性、交互效果流畅性、浏览器与设备兼容性等问题, 凭借专业知识和实践经验进行深入分析。与韦工保持高效沟通, 及时了解项目进展与问题反馈, 共同制定可行解决方案, 确保项目按时交付高质量前端页面。

设备对接接口联调与文档优化

内容：协助孙工在设备联调过程中, 运用先进的通信监测与数据验证工具, 全面检查设备与服务间的通信状况, 确保数据传输稳定、准确且无丢包。同时, 深度优化对接设备的 MQTT 信令交互接口文档, 详细记录调试经验、问题及解决方案, 为服务的平稳过渡和稳定运行提供坚实的文档支撑, 方便后续维护人员快速解决问题。

数证管理服务器对接接口联调与文档优化

内容：协助绍工对数证管理服务器的 HTTP API 和 MQTT 信令交互接口进行联调。运用数据验证算法和模拟测试场景, 严格测试前后端数据交互的准确性与完整性。使用网络监测与性能分析工具, 检查采集站与服务器间的通信和数据采集传输情况。全面优化对接接口文档, 补充联调细节, 如网络配置参数、数据采集频率、异常处理机制及问题解决方案, 确保系统功能完整、运行稳定, 为平台上线做好准备。

平台使用咨询、测试问题排查与文档优化

内容：协助王工为中心服务平台提供专业的使用咨询服务。针对用户在平台操作流程、功能使用及系统故障等方面的问题, 及时响应并提供准确、详细的解答与指导。在测试阶段, 利用专业技术和问题定位工具, 深度排查测试问题, 分析问题根源并制定解决方案。同时, 全面优化测试说明文档, 记录问题排查过程与解决方案, 为后续测试工作提供清晰有效的指导, 提升用户使用体验和平台满意度, 为平台优化升级提供支持。

本周工作进度

中心服务平台：1.0.1 版本, 处理已测试出的问题, 制作安装程序和升级程序并开展自测工作。待自测通过后, 更新测试手册, 随后将其提供给测试进行集成测试。

目标：优先处理耗时较少的任务。
当前进度：已完成 100%。
任务清单：
- redmine.netbodycamera.com 上分配的任务处理
  - #28

中心服务平台：1.0.1 版本, 微信群中反馈的问题以及自测发现的问题。

目标：优先处理耗时较少的任务。
当前进度：已完成 100%。
任务清单：
- WEB 客户端
  - 核心功能修复
    - 修复了 MQTT 客户端未成功建立连接前的尝试发送 ping 信令定时间隔问题, 将其从 0.01 秒调整为 0.1 秒。当 MQTT 客户端成功建立连接并尝试发送 ping 信令时, 间隔时间将重置为默认值 3 秒。
  - 交互体验升级
    - 增加了直播重试功能：如果在直播信令交互开始后的 8 秒内未能成功建立 WebRTC 连接, 则将重新进行信令交互。
- 服务端
  - 更新了 Maven 编译配置, 将 JDK 版本从 23 升级到 24, 以适应 Spring Boot 3.x 主要支持的 JDK 版本。
  - 升级了依赖库至最新稳定版本, 确保服务端程序的高效与稳定运行：
    - org.springframework.boot:spring-boot-starter-parent: 3.4.4 -> 3.4.5
    - com.baomidou:mybatis-plus-bom: 3.5.11 -> 3.5.12
    - com.baomidou:mybatis-plus: 3.5.11 -> 3.5.12
    - com.alicp.jetcache:jetcache-starter-redis-lettuce: 2.7.7 -> 2.7.8
    - com.alicp.jetcache:jetcache-anno: 2.7.7 -> 2.7.8
    - com.alicp.jetcache:jetcache-autoconfigure: 2.7.7 -> 2.7.8
    - org.apache.commons:commons-collections4: 4.4 -> 4.5.0
  - 移除了过时代码, 减少了不必要的内存占用：
    - 删除了基于 Netty 实现的 socket 通信服务端 API, 共计 61 个文件。
  - 统一了 HTTP API 异常处理：
    - 多处涉及修改密码的地方返回的错误信息不一致, 现已统一为一致的错误信息。
- Docker 镜像
  - 将 es-center-server-main-service 和 es-center-server-device-service 的 Docker 父镜像从 openjdk:23-slim 升级至 openjdk:24-slim。

中心服务平台：1.0.2 版本, 微信群中反馈的问题以及自测发现的问题。

目标：优先处理耗时较少的任务。
当前进度：已完成 100%。
任务清单：
- WEB 客户端
  - 核心功能修复
    - 修复直播界面数据加载异常：动态监听租户ID变化自动触发数据更新（原需手动刷新）
    - 优化界面兼容性：新增的”设备运行信息”模块, 实现手机/平板/PC端（宽屏/大屏显示器）多场景自适应
  - 交互体验升级
    - 优化设备详情页逻辑：未绑定组织时自动隐藏组织信息字段
    - 移除了不必要的 WebRTC API 调用, 例如 rtcPeerConnection.getTransceivers();。
    - 提升系统响应效率：关键操作响应速度提升5%
    - 完善本地化资源：更新中文词条文件(xlsx), 新增近期功能对应国际化内容
    - 主界面左侧菜单默认收起, 仅展示大图标, 鼠标悬停时会显示简要提示信息。
  - 技术架构改进
    - 升级前端框架：Tailwind CSS 从 v3 升级至 v4
    - 前端框架升级：将 shadcn-ui 升级至新版本。此升级的前置条件为 Tailwind CSS 已从 v3 升级至 v4。

WebRTC 开发文档

目标：为巴西客户提供详细的 WebRTC 开发技术支持文档。由于该文档涉及多个技术细节, 全部完成可能需要较长时间。目前, 优先完成了微信群中客户提出的急需部分。
当前进度：已完成 100%。
任务清单：
- 整理并提供 Google 官方 WebRTC 示例源代码
- 整理并提供 WebRTC-rs 示例源代码
- 更新文档中的 P2P 和 SFU 切换实现示例源代码, 以及进行说明。维护　zh-cn　与 en 两个语言版本。