2025年07月14日

上周回顾

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

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

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

目标：处理历史回放模块前端实现过程中发现的服务端接口问题, 包括修复 BUG 或优化接口设计。
进度：未开始(未发现问题) | 计划完成 100%

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

目标：优先修复 BUG, 将新增功能记录到 1.1.0 版本, 留待后续开发。
进度：已完成 100%, 属于非计划内事务。收到反馈后被动处理。

中心服务平台 1.1.0-la-1 版本 - KH3980客户执法仪沟通群

目标：群中反馈的客戶定制化需求處理, 制作安裝程序, 自測通過后, 提供給王工。
进度：已完成 100%, 属于處计划内事务。裝到反馈后測动過理。

本周计划

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

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

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

目标：处理历史回放模块前端实现过程中发现的服务端接口问题, 包括修复 BUG 或优化接口设计。
预期进度：计划完成 100%

本周进度

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

目标：历史回放模块前端实现
当前进度：已暂停, 已完成45% | 计划完成 80%。受多个非计划内事务的影响, 涉及到的采集服务器服务端接口需要调整, 孙工调整好之后再继续进行。
- 设备列表图形化展示, 含上传至采集服务器的各类文件统计饼图报表
- 设备每日文件按小时分组显示
- 文件播放器支持 P2P 加载内网采集服务器文件：
  - 图片播放器：支持放大、缩小及小地图
  - 音频播放器：支持进度条拖动、暂停 / 播放、音量控制等
  - 视频播放器：支持进度条拖动、暂停 / 播放、音量控制等

中心服务平台-单/多直播模块重制

目标：参考”远程管理平台更新内容汇总”文档中的内容, 进行重制开发
当前进度：完成 5%, 属于非计划内事务, 因历史回放模块前端涉及到的采集服务器服务端接口需要调整, 孙工调整好之后再继续进行。
- 低保真原型设计及沟通讨论
- 登录界面改造
  - 默认状态：启用验证码；隐藏注册、邮箱、电话登录及忘记密码功能, 仅保留用户名登录。适用于企业用户, 用户名和密码由出厂分配, 客户如遗忘密码需由我们协助找回, 支持客户私有化部署。
  - 在地址栏添加参数 login-mode=all（如：http://localhost:3000/login?login-mode=all）可开启隐藏功能。
- 单直播界面重制开发

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

目标：处理历史回放模块前端实现过程中发现的服务端接口问题, 包括修复 BUG 或优化接口设计。
当前进度：未开始(未发现问题) | 计划完成 100%

其它

目标：记录日常耗时的杂项工作、协作事项，以及必要的沟通、讨论等隐性事务。
当前进度：已完成, 属于非计划内事务。
- 中心服务平台
  - Web 客户端
    - 单屏/多屏直播设备列表菜单默认展开, 不缓存展/缩状态, 每次进入均展开。
    - 二级菜单的伸缩按钮, 调大尺寸, 便于点击和查看。
    - 菜单名 History replay, Real time video, Multi screen live 调整为 Playback, Single live video, Multi live video, 涉及前端源代码目录结构、图标更换及菜单项配置。
  - 服务端
    - 菜单名 History replay, Real time video, Multi screen live 调整为 Playback, Single live video, Multi live video, 涉及服务端用户权限配置变更。
    - 手机 app 接口 /main-service/main-api/v1/retail/device/data-acquisition-device/list 添加 cache 传参（默认值 true, 表示从缓存读取数据；可设为 false 表示不从缓存读取）, 通过 BooleanUtils 解析支持 true/false、yes/no、on/off、1/0、Y/N 等格式。
    - 升级 spring boot 3.4.7 -> 3.5.3, 涉及到过时的 API, 需调整代码。
  - 其它
    - 向王工提供升级程序：完成编译打包、升级程序制作、服务器部署及自测, 确保为优化版本
- 采集服务器回放服务
  - 项目名称由 webrtc-service 改为 es-playback
  - 日志文件路径由 log/es-center-server-webrtc-service 更新为 log/es-playback
  - 改造程序, 支持部署到采集服务器后的文件读取：实现文件存储根目录配置化, 读取时自动拼接至文件路径前
  - 修复 ICE 服务器配置获取时的参数拼写错误：MQTT client ID 前缀错误导致查询结果异常, 服务端依赖该值返回对应采集服务器的 ICE 配置
  - 验证跨平台编译部署：在 WSL Ubuntu 24.04 上交叉编译, 并部署至采集服务器（192.168.0.16, CentOS 7）验证运行通过
- KH3980 客户反馈问题处理
  - Web 客户端
    - 修复经纬度转换问题：设备定位数据为数字类型, 前端已增加补零处理逻辑
    - 优化多屏直播界面地图定位功能：点击设备时地图放大级别由 18 调整为 15
    - 更新翻译图标
  - 其它
    - 向王工提供升级程序：完成编译打包、升级程序制作、服务器部署及自测, 确保为优化版本

日常协作

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

APP 接口联调与文档优化

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

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

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

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

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

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

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

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

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