2025年03月31日

上周工作回顾

KH2248 项目 - Web 定制开发

目标：日常跟进 redmine.intelbras.com.br 平台分配给自己的任务。
进度：已完成 100% 达成预期目标。

KH2248 项目 - Web 定制开发

目标：日常跟进 redmine.intelbras.com.br 平台分配给自己的任务。
进度：已完成 100% 达成预期目标。

中心服务平台：主线版与多定制化版编译打包环境隔离

目标：优化编译打包流程, 消除各定制化版本编译打包环境间可能存在的冲突, 显著提升编译打包工作效率。主线和各定制化版本的源代码将从对应的 Git 分支获取进行编译打包。每个版本的打包工作对应一个虚拟机, 该虚拟机平时处于关机状态, 仅在使用时开机。
进度：已完成 100% 达成预期目标。

中心服务平台：安装程序可配置化扩展后的应用联动改造

目标：对 es-center-server-main-service 和 es-center-server-device-service 进行改造, 以支持通过环境变量注入的方式实现配置化。具体涉及的环境变量如下：
ES_CENTER_SERVER_COTURN_EXTERNAL_IP
ES_CENTER_SERVER_COTURN_PORT
ES_CENTER_SERVER_COTURN_TURN_USERNAME
ES_CENTER_SERVER_COTURN_TURN_CREDENTIAL
ES_CENTER_SERVER_DOMAIN_NAME
ES_CENTER_SERVER_REDIS_PASSWORD
ES_CENTER_SERVER_PG_POSTGRESQL_USERNAME
ES_CENTER_SERVER_PG_POSTGRESQL_PASSWORD
ES_CENTER_SERVER_ACTIVEMQ_ARTEMIS_USER
ES_CENTER_SERVER_ACTIVEMQ_ARTEMIS_PASSWORD
进度：已完成 100% 达成预期目标。

中心服务平台：App 接口开发与接口文档完善

目标：补充 App 原型设计中未明确呈现的隐含业务逻辑。例如, 消费类设备需与数证管理服务器绑定, 并获取绑定的数证管理服务器相关信息。
进度：已完成 100% 达成预期目标。

中心服务平台：近期反馈与建议处理

目标：集中处理近期收集到的反馈与建议。例如, 解决地图在北半球定位准确但在南半球定位不准确的问题, 以及解决因浏览器缓存导致设备列表界面需刷新页面才能显示新增设备的问题。
进度：已完成 100% 达成预期目标。

中心服务平台：增量升级程序开发

目标：在不影响现有已安装服务正常运行的前提下, 对特定部分实施增量升级。为降低后续开发成本, 所开发的增量升级程序需具备广泛适用性, 能够应对多种不同应用场景。
进度：原计划进度为 20%, 但实际进度为 3%, 受 KH2248 项目 - Web 定制开发 及 日常协作 的影响.

本周工作计划

KH2248 项目 - Web 定制开发

目标：日常跟进 redmine.intelbras.com.br 平台分配给自己的任务。
预期进度：计划完成 100%。

中心服务平台：改进安装程序, 集成 Certbot 以生成免费的 SSL 证书

目标：Certbot 将显著简化 HTTPS 的部署过程, 帮助网站轻松实现安全通信。计划在 CLI 程序中新增一个子命令, 用于停止 Nginx 服务、调用 Certbot 生成免费 SSL 证书, 然后重新启动 Nginx 服务。
预期进度：计划完成 100%。

中心服务平台：增量升级程序开发

目标：在不影响现有已安装服务正常运行的前提下, 对特定部分实施增量升级。为降低后续开发成本, 所开发的增量升级程序需具备广泛适用性, 能够应对多种不同应用场景。
预期进度：计划完成 100%。

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

目标：优先处理耗时较少的任务。对于耗时较长的任务, 具体如下：
- 轨迹回放：涉及大量定位信息、电量信息和开关机记录等数据, 这些数据不能存储在业务数据库中, 以免影响其性能和备份。因此, 需额外集成 Elasticsearch 服务来存储和快速查询这些大数据。
- 位置信息（最好是解析后的地理位置信息）：将集成 Photon 位置解析服务, 并提供授权的 API 接口, 确保只有经过身份验证的用户才能访问。
预期进度：计划完成 10%。

日常协作事宜

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

APP 接口联调与文档优化

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

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

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

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

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

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

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

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

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

本周工作进度

KH2248 项目 - Web 定制开发

目标：日常跟进 redmine.intelbras.com.br 平台分配给自己的任务。
当前进度：已完成 100%。
任务清单：
- MQTT 配置界面修改
- 登录前跳转到登录页面BUG修复, 去掉 0.5秒的延时。
- 首页4G面板Network字段显示修改
- 61966 :完善多语言词库, 确保从葡萄牙语（pt）或西班牙语（es）切换回英语（en）时, 界面字段能正确显示英文翻译。避免因缺失英文词条导致部分字段保留原语言状态。

中心服务平台：改进安装程序, 集成 Certbot 以自动化生成免费 SSL 证书

目标：通过集成 Certbot, 将显著简化 HTTPS 的部署流程, 使网站能够高效实现安全通信。计划在 CLI 程序中新增一个子命令, 自动执行以下流程：
1. 暂停 Nginx 服务,
2. 调用 Certbot 生成免费 SSL 证书,
3. 重新启动 Nginx 服务。
当前进度：已完成 90%, 自测通过, 等待王工的测试反馈并进行进一步优化。
任务清单：
- 研究阶段：手动使用 Certbot 生成免费 SSL 证书, 梳理流程并整理为自动化脚本。
- 依赖处理：实现 Certbot 离线安装功能, 减少对外部网络的依赖。
- 配置适配：修改 NGINX 配置文件模板以适配自动化证书部署。
- 功能开发：
  - 在 CLI 程序中新增子命令, 支持一键生成或更新或申请 SSL 证书。

中心服务平台：增量升级程序开发

目标：在不影响现有已安装服务正常运行的前提下, 对特定部分实施增量升级。为降低后续开发成本, 所开发的增量升级程序需具备广泛适用性, 能够应对多种不同应用场景。
当前进度：已完成 90%, 自测通过, 等待王工的测试反馈并进行进一步优化。
任务清单：
- 功能开发：在 CLI 程序中新增子命令, 支持一键触发增量升级流程。
- 增量升级实现：
  - 配置更新：动态加载新版配置文件, 支持现有字段覆盖与新增字段注入。
  - 镜像同步：实现离线镜像包导入系统, 完成容器配置的版本化迁移
  - 服务更新策略：建立容器优雅重启策略, 确保配置/镜像变更原子化生效

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

目标：优先处理耗时较少的任务。对于耗时较长的任务, 具体如下：
当前进度：已完成 3%
任务清单：
- bug 修复
- 用户体验优化
- 新功能开发

信息化管理完善：工作周报模板

目标：规范开发流程, 确保全流程的可追溯性；重点针对新增功能进行测试覆盖, 同时实现对开发成果的量化评估。
当前进度：已完成 50%