2025年04月21日

上周工作回顾

中心服务平台：app 接口改进

• 目标：根据郭工联调反馈的信息, 对接口进行改进。具体包括区分系统错误信息和业务验证错误信息, 以及复现并修复某个接口的 SQL 插入错误问题。
• 进度：已完成 100% 达成预期目标。

中心服务平台：安装程序优化改进

• 目标：上个月自测通过的多个程序, 根据王工的测试反馈并进行进一步优化改进。
• 进度：已完成 100% 达成预期目标。

中心服务器测试 250327.xlsx 中的任务处理

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

中心服务平台：WEB 客户端依赖库升级

• 目标：升级已停止维护的 Web 客户端依赖库, 确保应用能够正常运行。
• 进度：已完成 100%, 非原定计划。

本周工作计划

中心服务平台：已测试出的问题处理

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

KH2248 项目：WEB 客户端开发

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

日常协作事宜

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

APP 接口联调与文档优化

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

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

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

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

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

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

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

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

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

本周工作进度

KH2248 项目：WEB 客户端开发

• 目标: redmine.intelbras.com.br 上分配的任务处理
• 当前进度：已完成 100%。
• 任务清单：
  • #62026 
  • #62797 
  • #62498 
  • #61959 
  • #62236 
  • #62008 
  • #62746 

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

• 目标：优先处理耗时较少的任务。
• 当前进度：计划完成 50%, 已完成 50%
• 任务清单：
  • redmine.netbodycamera.com 上分配的任务处理
    • #17 
    • #18 
    • #19 
    • #20 
    • #21 
  • 测试发现的问题
    • 升级程序
      • 源目录路径错误
  • 自测发现的问题
    • WEB 客户端
      • 针对所有涉及密码输入的功能界面（如修改密码、通过邮箱找回密码、通过手机验证码找回密码、租户绑定用户等）：
        • 正则表达式调整：移除了原正则表达式中的 (?!.*(\w)\1\1), 该部分用于检查是否存在三个连续相同的字符。
        • 错误提示信息优化：删除了原提示信息中“不能有连续相同字符”的内容。
      • 每隔30秒自动重新加载i18n资源, 以确保国际化内容的实时性和准确性。
      • GPS信息验证逻辑调整：经与韦工确认, valid === 0 表示GPS信息无效, 现已修改为 valid < 1。
    • 服务端
      • MQTT订阅设备上报消息：GPS信息验证逻辑调整, 经与韦工确认, valid === 0 表示GPS信息无效, 现已修改为 valid < 1。
    • 安装程序
      • 去掉 docker-buildx-plugin 安装包, 生产环境不需要。Docker Buildx 让开发者能够通过一致的流程, 高效生成多平台兼容的容器镜像, 适配现代多云、混合架构的部署需求。
      • 去掉 docker-ce-rootless-extras 安装包, 生产环境不需要。该组件是实现 Docker 无 root 权限运行的关键依赖, 在保障安全性的同时, 让普通用户能便捷管理容器, 适用于权限受限或多用户共享的场景。

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

• 目标：优先处理耗时较少的任务。
• 当前进度：100%。
• 任务清单：-　WEB 客户端
  • 直播界面下, 补充更多的设备信息展示。比如：LAN信息, WIFI信息, GPS信息等。
  • 直播界面下, 设备信息展示改进, 增加高级/简单模式切换, 用于展示更多设备信息, 默认为简单模式。

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

• 目标：定期更新依赖库, 确保服务端程序的稳定运行。
• 当前进度：已完成 100%。
• 任务清单：
  • spring-boot-starter-parent: 3.4.1 -> 3.4.4
  • springdoc-openapi: 2.8.3 -> 2.8.6
  • swagger-annotations-jakarta: 2.2.27 -> 2.2.30
  • mybatis-plus: 3.5.10.1 -> 3.5.11
  • java-jwt: 4.4.0 -> 4.5.0
  • guava: 33.4.0-jre -> 33.4.8-jre
  • hutool-bom: 5.8.35 -> 5.8.37

Webrtc 开发文档

• 目标：为巴西客户提供详细的 WebRTC 开发技术支持文档。因为该文档涉及多个技术细节, 全部完成可能需要较长时间。暂时只以提供代码示例和基本概念为主。
• 当前进度：已完成 100%。
• 任务清单：
  • Web 客户端相关代码示例
  • 服务器端相关代码示例
  • 基本概念介绍