2025年05月06日

上周工作回顾

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

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

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

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

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

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

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

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

WebRTC 开发文档

目标：为巴西客户提供详细的 WebRTC 开发技术支持文档。由于该文档涉及多个技术细节, 全部完成可能需要较长时间。目前, 优先完成了微信群中客户提出的急需部分。
进度：已完成 100% 达成预期目标。

本周工作计划

KH2248 项目：WEB 客户端开发

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

日常协作事宜

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

APP 接口联调与文档优化

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

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

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

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

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

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

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

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

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

本周工作进度

KH2248 项目：WEB 客户端, 客户 redmine 系统中分配给我的任务

目标: redmine.intelbras.com.br 上分配的任务处理
当前进度：已完成 100%。
任务清单：
- #62798
- #62845
- #61956
- #61966
- #62215
- #58694

KH2248 项目：WEB 客户端, 测试及自测发现的问题

目标: 测试及自测发现的问题
当前进度：已完成 100%。
任务清单：
- 用户体验优化
  - 在WiFi SSID配置成功后, 启动状态轮询机制：
    - 每间隔1秒调用接口查询当前连接状态
    - 状态码处理逻辑：
      - 成功匹配场景：
        
        当用户输入的SSID/PASSWORD与接口返回值一致且net_connect_status == 1 → 触发「连接成功」提示
      - 失败匹配场景：
        
        当用户输入的SSID/PASSWORD与接口返回值一致且net_connect_status == 15 → 触发「连接失败」提示
    - 安全终止机制：
      - 当连续查询次数超过30次（即30秒）时自动终止轮询
      - 根据最终状态码显示对应提示信息：
        
        net_connect_status == 1 → 显示「连接成功」提示
        
        net_connect_status == 0 → 显示「连接失败」提示
  - 密码输入框优化
    - 实现密码明文/密文切换功能：默认隐藏密码内容, 右侧添加可视化切换开关
    - 增强安全性配置：设置autoComplete="off"防止浏览器记忆, 禁止历史记录
    - 视觉优化：在输入框左侧添加密码图标前缀（使用锁形图标）
  - SSID输入框优化
    - 视觉统一：在两个SSID输入框左侧分别添加WiFi信号图标前缀
    - 保持原有功能不变, 仅增加图标标识以提升用户识别度
  - 在WIFI设置界面, 当接口中返回的ap list数组为空值时, 不进行变量替换。
- 多处表单字段, 根据api接口的业务进行字符串输入上限及下限的校验控制, 比如：wifi及ap的ssid、password, 用户密码修改等
- 一百多处接口调用, 在客户端加上缓存及防抖处理
- 全面排查有没有遗漏的国际化词条, 补充: “4G information”, “WLAN information”, “2.4 GHz”, “3G”, “4G”, “AP”, “APN”, “Host”, “IMEI”, “IPV4”, “IPV6”, “MQTT”, “Port”, “SSID”, “SSL/TLS”, “Url”, “WIFI”, “Websocket”, “Wi-Fi”
- UnoCSS配置改进：@unocss/preset-wind 和 @unocss/preset-uno 已弃用, 并重命名为 @unocss/preset-wind3。此预设继承自 @unocss/preset-mini。
- 第三方库升级:
  - “@types/node”: “^22.13.9” -> “^22.15.14”
  - “typescript”: “5.8.2” -> “5.8.3”
  - “i18next”: “^24.2.2” -> “^25.1.1”
  - “i18next-browser-languagedetector”: “^8.0.4” -> “^8.1.0”
  - “antd”: “^5.24.3” -> “^5.24.9”
  - “mobx”: “^6.13.6” -> “^6.13.7”
  - “react”: “^19.0.0” -> “^19.1.0”
  - “react-dom”: “^19.0.0” -> “^19.1.0”
  - “react-i18next”: “^15.4.1” -> “^15.5.1”
  - “react-markdown”: “^10.0.1” -> “^10.1.0”
  - “react-router”: “^7.3.0” -> “^7.5.3”
  - “react-router-dom”: “^7.3.0” -> “^7.5.3”
  - “@iconify/json”: “^2.2.314” -> “^2.2.335”
  - “@types/leaflet”: “^1.9.16” -> “^1.9.17”
  - “@types/node”: “^22.13.9” -> “^22.15.14”
  - “@types/react”: “^19.0.10” -> “^19.1.3”
  - “@types/react-dom”: “^19.0.4” -> “^19.1.3”
  - “@unocss/preset-icons”: “^66.0.0” -> “^66.1.0”
  - “@unocss/preset-uno”: “^66.0.0” -> “^66.1.0”
  - “@vitejs/plugin-legacy”: “^6.0.2” -> “^6.1.1”
  - “@vitejs/plugin-react”: “^4.3.4” -> “^4.4.1”
  - “less”: “^4.2.2” -> “^4.3.0”
  - “rollup”: “^4.34.9” -> “^4.40.2”
  - “typescript”: “^5.8.2” -> “^5.8.3”
  - “unocss”: “^66.0.0” -> “^66.1.0”
  - “unplugin-auto-import”: “^19.1.1” -> “^19.2.0”
  - “vite”: “^6.2.1” -> “^6.3.5”

中心服务平台：1.0.2 版本, 新增功能。

目标：新增功能。
进度：已完成 100% 非计划内目标。
任务清单：
- 服务端
  - 服务端项目云原生改造(完成 10%): 集成Native Maven插件（native-maven-plugin）, 通过AOT编译实现容器镜像体积优化与启动性能提升, 为后续容器化部署的资源效率和冷启动响应优化提供技术支撑
- Web 客户端
  - 在 P2P 直播界面中, 复用原有的麦克风按钮组件。实现点击该按钮时, 通过信令触发相应逻辑, 以启用或禁用设备的音频输出功能。同时, 麦克风按钮的状态会根据设备返回的音频输出状态进行动态变更, 即音频输出开启时按钮启用, 音频输出关闭时按钮禁用。
  - 当 WebRTC 连接成功后, 系统会自动获取一次设备端的音频输出状态。