Skip to Content
工作周报2026 年度总结2026年02月02日

2026年02月02日

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

中心服务平台 - 轻量化跨境分布式第二阶段改造

  • 目标: 控制变更范围，降低引入风险，实现面向客户可用的初步功能体验。
  • 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
    • 以往已完成的工作不再重复，详情请查看上周及上月报告
    • 〔工作量〕services 80 次（设计 13 · 代码 67）· 代码 +5.9k/-8.3k ｜ web-app 8 次（设计 2 · 代码 6）｜ install-app 11 次（设计 2 · 代码 9）
    • 〔方法论〕测试驱动缺陷收敛（主线流程全量/增量验证暴露问题再修复）｜ 数据同步模块内聚化与工具类精简（归档流程收敛、文件移动原子化、API 精简）｜ 国际化写入性能优化（内存队列去重 + 流式查询 + 布隆过滤器）｜ 构建工程化起步（引入 Spotless 格式化）
    • 2-02: 数据同步归档体系重构与文件工具类精简〔services〕
      • ✅ 数据同步归档流程与文件工具类
        • 重构 触发器安装服务清理与完善；归档目录明确按字典序排序并引入回调机制支持过期目录处理；归档流程内聚化与工具类代码清理
        • 重构 文件工具类统一移动操作与 API 精简、路径计算方法重构；文件移动改用原子操作并支持自定义路径映射
        • 设计 数据同步模块代码注释规范整改；归档目录排序优化变更文档归档提升为正式规格
    • 2-03 ~ 2-05: 数据同步导入导出主体、缺陷修复与主线流程测试〔services〕
      • ✅ 数据同步导入导出功能完善
        • 实施 数据同步模块支持复合主键并规范 MapUtils 使用；优化导出 JSONB 处理；归档 JSONB 解析修复与依赖审计变更
        • 重构 简化表列元数据获取实现；使用 queryForStream 优化数据导出策略并归档流式数据导出规格；调整 SFTP 下载器与增量导出策略
        • 排障 修复 extractTableName 无法处理含下划线的表名；修复全量导入起始序号后缀生成；修复导入时 timestamp 类型转换错误（新增 DataTypeConverter）；修复 JSONB 导出 PGobject 多层嵌套
        • 排障 增量导入分区表不能使用 ON CONFLICT（该语法会将数据写入父表），改为先 UPDATE 无影响后再 INSERT
        • 排障 SFTP 下载报错: Apache Commons VFS2 在 URI 内联认证信息时，密码特殊字符（@/://）致解析器无法区分密码与分隔符，改用 Apache MINA SSHD
        • 测试 主线流程全量/增量导出测试: 覆盖 79 张表，验证初始化目录、文件流转、失败重试、防重、归档与过期清理机制，抽查 1/10 导出文件内容
        • 测试 主线流程全量/增量导入测试: 覆盖 79 张表，每次导入完成后做主从节点数据一致性测试，抽查 1/10 导入数据库内容
    • 2-03 ~ 2-05: 从节点导入通知机制与国际化模块性能优化〔services〕
      • ✅ 从节点导入新数据通知机制
        • 实施 导入新用户、设备及采集服务器数据后创建对应 MQTT 账号；导入国际化数据后生成对应国际化 JSON 文件
        • 测试 通过 MQTTX 工具验证 MQTT 账号有效性；核对国际化 JSON 文件内容一致性
      • ✅ 国际化模块写入性能优化
        • 重构 国际化数据写入改用内存队列 + Guava Cache 批量去重；引入 TranslationGroup 值对象与脏数据防御机制；移除重复代码并增强队列去重
        • 实施 saveMissing 接口引入布隆过滤器防重复数据；重构国际化调度模块常量类
        • 重构 简化入队方法签名；使用 JdbcTemplate queryForStream 改造翻译生成为流式查询降低内存占用；归档 JDBC fetchsize 与翻译调度优化变更
        • 排障 修复 drainQueue 未正确从队列移除元素；修复定时任务方法可见性
        • 设计 建立国际化改进 OpenSpec 变更并归档，提升翻译变更追踪与去重缓存为正式规格
    • 2-04 ~ 2-06: 定时任务调度修复、构建工程化与依赖治理〔services〕
      • ✅ 定时任务与设备数据采集
        • 排障 修复 @Scheduled 与定时任务方法可见性问题
        • 实施 优化定时任务线程池配置；调整设备数据采集控制器与定时任务调度方法
        • 设计 建立设备验证修复 OpenSpec 变更
      • ✅ Spotless 代码格式化与依赖清理
        • 实施 引入并完善 Spotless 代码格式化配置；归档 Spotless 配置完善变更提升为正式规格
        • 重构 移除未使用第三方依赖；优化 gt-common-core 代码质量；修复空值判断规范违规
        • 设计 归档 ktlint 可行性分析变更
    • 2-06 ~ 2-07: 公网 IP 检测、ApiResult 与 AI 开发环境奠基〔services〕
      • ✅ 公网 IP 检测与 ApiResult
        • 实施 增强 IP 检测逻辑，支持多种代理头部与公网 IP 验证；ApiResult 自动初始化 extraData
        • 设计 建立 API 结果自动初始化 OpenSpec 变更
      • ✅ AI 开发环境奠基
        • 设计 引入 speckit 与 opencode 命令模板体系；添加 AI 编码代理参考文档 AGENTS.md；补充提示词记录与 git hooks；核对修正 .ai/repowiki 文档以匹配代码实现
    • 2-04 ~ 2-08: 前端 v2 APK 下载页与法律协议〔web-app〕
      • ✅ v2 APK 下载页
        • 实施 新增 v2 APK 下载页（apk-download.html）与二维码库；多轮微调下载页
      • ✅ 法律协议文档
        • 设计 修复法律协议「隐私政策」「使用条款」文档（中英文）
    • 2-04 ~ 2-05: 构建部署脚本体系〔install-app〕
      • ✅ 构建与多环境部署脚本
        • 排障 修复 build.sh 系列 shell 兼容性问题并建立 OpenSpec 变更；归档 fix-build-sh-script 并将 build-pipeline 提升为正式规格
        • 实施 更新多环境部署脚本（cs-1、ge-zxs-ca/hs、zxs-cs/ls、zxs）；调整 build.conf、打包脚本与各环境 .env 配置
        • 设计 更新 CLAUDE.md 补充构建系统与测试章节；引入 Claude opsx 命令模板

其它工作

  • 目标: 记录日常耗时的杂项工作、协作事项，以及必要的沟通、讨论等隐性事务。
  • 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
    • 以往已完成的工作不再重复，详情请查看上周及上月报告
    • 03 日
      • 自测发现国际化数据入库问题并修复: 前端自动上报的词条没有写入数据库
      • 修复韦忠正反馈的修改设备配置时提示问题: 后端验证取值不对，提示 Data acquisition device no exists: HS25020001;
    • 04 日
      • 原部署在公网服务器上的 lbs 服务切换到内网运行，通过 frp 提供公网访问
      • 多次制作更新程序部署至 zxs-cs/zxs-c 上进行测试
    • 05 日
      • 多次制作更新程序部署至 zxs-cs/zxs-c 上进行测试
      • 为印度客户定制开发获取公网 IP 的接口，通过白名单设置，无需 token 即可访问
      • 确保所有接口返回的 JSON 数据中都包含 extraData.clientIp 字段

备忘

  • 采集服务器调用的同步设备接口需排查 token 验证不通过的问题。
Last updated on
2026年01月26日2026年02月24日