2025年06月23日

上周回顾

中心服务平台 1.0.2 版本 - 处理微信群反馈问题与自测问题

• 目标：优先修复 BUG, 将新增功能记录到 1.1.0 版本, 留待后续开发。
• 进度：已完成 100% | 计划完成 100%。收到反馈后被动处理。
  • 优化原有的地图语言切换逻辑：此前, 切换到非中文时将地图设置为谷歌地图, 切换回中文时设置为百度地图。现改为依据配置项进行判断。
    • 若配置项中包含谷歌地图, 在切换到非中文时将地图设置为谷歌地图；若不包含, 则不做处理。
    • 若配置项中包含百度地图, 在切换回中文时将地图设置为百度地图；若不包含, 则不做处理。

中心服务平台-历史回放模块服务端相关接口实现

• 目标：历史回放模块服务端相关接口实现, 为后续的前端开发提供接口支持
  • 中心服务平台（数据服务 HTTP 接口）
  • 中心服务平台（设备服务 MQTT 接口）
• 进度：已完成 100% | 计划完成 100%

中心服务平台-历史回放模块前端实现

• 目标：历史回放模块前端实现
• 进度：已完成 3% | 计划完成 10%。受多个非计划内事务的影响。

中心服务平台-服务端-零售类 app 接口开发

• 目标：基于原型设计中标注的交互逻辑, 系统化推进接口定制开发工作, 具体涵盖：
  • 深度理解需求并与需求方完成高效沟通
  • 完成接口设计并输出标准化文档, 经多方确认后定稿
  • 实现接口功能并完成自测验证
  • 制作安装程序并部署至测试云服务器, 开展全流程集成自测
• 进度：已完成 100%, 属于非计划内事务。
  • 设备共享列表接口
  • 添加共享接口

中心服务平台-历史回放模块, 多方 api 设计文档修订

• 目标：在对照文档开展开发工作过程中, 对发现的设计文档问题进行及时修订
• 进度：已完成 100%, 属于非计划内事务。

本周计划

中心服务平台-历史回放模块前端实现

• 目标：历史回放模块前端实现
• 预期进度：计划完成 20%

中心服务平台-服务端-零售类 app 接口开发

• 目标：基于原型设计中标注的交互逻辑, 系统化推进接口定制开发工作, 具体涵盖：
  • 深度理解需求并与需求方完成高效沟通
  • 完成接口设计并输出标准化文档, 经多方确认后定稿
  • 实现接口功能并完成自测验证
  • 制作安装程序并部署至测试云服务器, 开展全流程集成自测
• 预期进度：计划完成 100%
  • 设备共享列表接口
  • 添加共享接口

本周进度

中心服务平台-历史回放模块前端实现

• 目标：历史回放模块前端实现
• 当前进度：已完成 8% | 计划完成 20%。受多个非计划内事务的影响。

中心服务平台-服务端-零售类 app 接口开发

• 目标：基于原型设计中标注的交互逻辑, 系统化推进接口定制开发工作, 具体涵盖：
  • 深度理解需求并与需求方完成高效沟通
  • 完成接口设计并输出标准化文档, 经多方确认后定稿
  • 实现接口功能并完成自测验证
  • 制作安装程序并部署至测试云服务器, 开展全流程集成自测
• 当前进度：已完成 100% | 计划完成 100%.
  • 设备共享列表接口
  • 添加共享接口

中心服务平台-服务端-历史回放模块相关 API 改进

• 目标：处理历史回放模块前端实现过程中发现的服务端接口问题, 包括修复 BUG 或优化接口设计。
• 当前进度：已完成 100% | 计划完成 100%, 此为非计划内事务。
  • 在线与离线状态优化：当收到设备离线通知时, 删除redis中的缓存, 防止缓存占用。记录mqtt client id的在线和离线状态, 以实现某些业务逻辑。
  • 完善设备列表接口：添加对应的采集服务器信息（绑定给该设备的）, 并包含采集服务器的 iot 和 file 两个服务的在线状态。
  • 某些接口业务逻辑优化, 例如：当查询不到当前租户下设备绑定的采集服务器信息时, 会从 “default” 租户下进行查询。这一优化使系统能够兼容机构（从设备当前租户下查询）及零售（从 “default” 租户下查询）两种模式。
  • 优化了获取指定MQTT客户端上报至服务端的多种分类信息的接口, 确保传参与返回值一一对应, 有效提升了接口的可读性与易用性。
  • 对原有设备上报信息拉取接口及获取设备上报信息接口进行改造, 使其兼容新的通用接口。新接口不仅能够上报及获取设备（iot、webrtc）信息, 还支持服务器（iot、file）以及用户（web、app）等多维度信息的处理。

中心服务平台-定制演示版改进

• 目标：直播验证增强
• 当前进度：已完成 100% | 计划完成 100%, 此为非计划内事务。
  • 直播验证增强：离开当前设备直播或该设备离线后, 需再次进行直播密码验证。

日常协作

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

APP 接口联调与文档优化

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

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

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

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

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

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

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

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

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