Skip to Content
工作文档周报2025年度总结2025年11月17日

2025年11月17日

本周工作计划与执行完成进度

中心服务平台 - 新增功能

  • 目标: 完善运维相关功能
  • 进度: 已完成 30% | 计划完成 50%。受多个非计划内事务的影响。
    • 完成本周计划(35%): 新增功能 中心服务器数据库备份：支持通过界面点击手动触发备份，并实现每日凌晨 1 点自动定时备份；为避免磁盘空间占用过大，当备份文件数量超过 30 个时，自动删除最旧的备份文件。
      • 调研跨 docker 容器，执行数据备份指令最佳实践
      • 搭建 es-center-server-agent 项目，并选用当前 Rust 生态中最合适的第三方库：axum、tokio、serde、serde_json、color-eyre、ring、ulid、flurry 和 redis。
      • 实现读取配置文件的代码实现：.env(生产环境配置) 与 .env.development(开发环境配置) 两个文件，后者覆盖前者。
      • 完成端到端链路的代码实现：从 swagger-ui 及其自动生成的 openapi.json 规范出发，依次调用用户 API 层、用户服务层、用户仓库层，执行底层 SQL 查询，最终将结果封装为统一的接口响应 JSON 格式并返回。
      • 实现数据库自动备份机制：每小时检查一次当日数据库备份文件是否存在；若未导出，则自动触发备份流程。备份成功后，清理超过30个的最旧备份文件，确保备份的时效性与存储合理性。
      • 移除/agent-api/v1/user测试接口（该接口为前期测试所用）。
      • 新增3个接口：手动触发数据库备份接口、获取数据库备份目录文件列表接口、下载数据库备份文件接口。
      • 为所有接口添加安全防护机制，避免恶意调用。
      • 开发UI界面，支持手动触发备份、查看备份文件列表及下载备份文件功能。
      • 将agent集成到已有安装及更新程序中，实现自动安装为Linux系统服务的功能。
    • 本周计划: 新增功能 提供设备日志上传接口，并制定上传协议，确保日志完整上传至服务器，便于客户分析问题、排查原因。
    • 非本周计划: 新增功能 在多个采集设备信息界面中，增加其绑定的采集服务器信息及最新固件版本信息，例如：直播（地图）模块和远程模块中的设备运行信息页面。

其它

  • 目标: 记录日常耗时的杂项工作、协作事项，以及必要的沟通、讨论等隐性事务。
  • 进度: 属非计划内事务
    • 17 日
      • 跟进王工测试结果，排查新租户权限缺失问题：问题根源已定位，预计明日完成修复。
    • 18 日
      • 与姚和平沟通讨论, 结论: qt-tools 地图功能仍需进一步优化，以支持更复杂的路线展示需求。根据姚和平提出的新场景，未来可能存在多个视频共享同一条路线的情况，且后端计划在解析完任一视频后即向地图推送一次增量数据，由前端逐步构建完整路线。该方案与原先“一次性提供所有视频路线数据”的设计存在差异，需对现有架构进行调整。此外，还存在多个视频对应多条独立路线的潜在需求，尤其当视频间时间间隔差异较大时，需在地图上分线路展示。为此，已提出统一解决方案：将接口调整为支持多个数组形式的定位数据，每组数据对应一条独立路线，各路线可独立添加和更新。调整后，前端需承担更多数据处理逻辑，如多源增量数据的合并、时间序列排序及去重等操作，开发复杂度相应提升；而后端接口逻辑则更为简洁，整体系统灵活性和扩展性得到增强。
      • 简历筛选分析
      • BCMS 平台后端 Bug 修复：修复新租户初始化过程中权限配置缺失的问题，确保权限策略能够正确加载与应用。
      • BCMS 平台后端功能优化：在邮件发送功能中新增发件人别名支持，默认别名为 PonyCam；若系统配置中已设置自定义别名，则优先采用配置项中的值。
      • BCMS 平台版本更新部署：在 zxs 服务器完成 BCMS 平台新国内版本的升级，涵盖上述 Bug 修复与功能优化内容。
      • 线上面试 app 岗应聘者
    • 19 日
      • qt-tools 地图功能改进: 默认地图放大级别为 13, 调整为 17; 播放时间点的定位，自动跟随为中心点
      • 完成 BCMS 新国际版升级与安装程序的制作，并通过升级程序部署至 zxs-ca 服务器，完成部署验证与功能测试
      • zxs-ca 服务器上的 https 证书续期
      • 维护 zxs-dev 网站的版本更新日志，同步更新发布信息，并通知测试开展新版本验证工作
      • 线下面试 dms 岗应聘者
      • 协同孙工完成设备端frpc代理穿透方案的验证与落地，成功将设备本地的HTTP服务通过frpc隧道暴露至公网（已与服务端frps建立稳定连接）。目前可通过 http://142.171.225.20:3133 访问目标服务，经测试，服务内视频文件可正常播放；期间由我负责提供frps服务端的相关支持。
    • 20 日
      • qt-tools 地图功能改进: 去掉地图内的全屏功能，这个功能与 qt 内置的 webview 的全屏功能冲突
      • qt-tools 将各地图的缩放级别调整为其对应的最大支持值，以最大程度展现行走路线的细节。
        • 百度地图：18
        • 高德地图：18
        • 腾讯地图：18
        • 谷歌地图：22
        • OSM 地图：24
    • 21 日
      • qt-tools 地图功能改进: 多处地图移动动效，用队列方式依次执行，避免冲突
      • 线下面试 dms 岗应聘者

总结

  • 原定计划进展：

    • 数据库备份 Agent 程序已完成开发，并成功部署至 zxs-ca 服务器，可为下周的前端联调工作提供支持。

  • 安全提示：用于前端调用 Agent 程序 API 接口的认证 Token 生成逻辑不得在 JavaScript 中直接实现。为提升代码的抗逆向能力与整体安全性，建议将该核心逻辑封装于 WebAssembly（WASM）二进制模块中执行，以保障敏感逻辑在客户端环境中的保密性与完整性。

  • 非原定计划事项：

    • 针对 qt-tools 模块，投入较多时间跟进测试阶段发现的问题。另有一项优化任务暂缓至后续迭代处理：当前地图缩放到较低级别时，图形元素过于密集，影响视觉清晰度。为此制定如下显示控制规则：当日志放大级别小于 15 时，暂不渲染以下元素：
      • 线路起止位置的大型起始图标
      • 当前播放位置的大型定位图标
      • 全线路叠加的密集路标方向箭头
      • 已行驶路线的可视化叠加层
    • 跟进王工测试结果，排查并修复了新租户权限缺失问题也投入较多时间
Last updated on
2025年11月10日2025年11月24日