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

2026年01月12日

内容截止日: 2026年01月18日

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

中心服务平台 - 功能完善

  • 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
    • 以往已完成的工作不再重复，详情请查看上周及上月报告
    • 〔工作量〕es-center-server-services 40 次 · 代码 +0.8k/-0.7k ｜ es-center-server-web-app 21 次（设计 6 · 代码 15）· 代码 +1.0k/-0.9k ｜ es-center-server-install-app 7 次 · 代码 +0.4k/-0.2k ｜ es-center-server-build 2 次 ｜ es-ext-doc-website 1 次
    • 〔方法论〕qoder → opencode → claude code 多轮审查后整改、再扫描 ｜ 审查报告与方案先行 ｜ 命名规范与依赖锁定
    • 1-12 ~ 1-18: 跨境数据同步准备
      • 🟡 数据同步中间件已部署，完成链路验证与资源需求核对 〔es-center-server-services〕
        • 实施 为轻量化跨境分布式第二阶段改造准备数据同步环境。在长沙开发服务器安装所需中间件，即支撑同步运行的基础软件，并完成配置与性能调优。
        • 测试 将各中间件串成完整链路，验证端到端连通性，同时摸清整条链路对服务器资源的需求。本周记录的是前置准备，数据同步改造继续推进。
    • 1-12 ~ 1-15: 多轮代码审查与整改
      • ✅ 后端按审查报告逐轮整改，命名与授权校验同步修正 〔es-center-server-services〕
        • 审查 qoder、opencode、claude code 三个 AI 工具先后扫描前端、后端和安装程序。三仓共进行四轮「扫描 → 按报告改进 → 重新扫描」，分别产出代码质量、安全、架构与性能报告。
        • 审查 后端核对 SQL 注入、空指针异常（NPE）、资源泄漏、并发、异常处理、性能和配置风险；另记录未使用 Bean（由框架管理的对象）的候选清单，并形成 737 行系统综合评审文档。
        • 实施 按每轮报告改进后端。设备绑定授权码补上 V2 识别、设备号后缀及校验段约束，统一 V1/V2 摘要输入；BCMS App 的绑定接口按 TOKEN（登录凭证）生成规则补充业务逻辑。
        • 实施 将数据权限、管理员角色与通配符提取到常量类，命名规范落到代码。
        • 设计 代码质量监控文档与工程执行约束同步整理。
        • 实施 升级后端依赖：mybatis-plus 3.5.15 → 3.5.16、阿里云短信 SDK 4.0.6 → 4.0.8、meilisearch 0.17.1 → 0.18.0；同步两处依赖版本清单（BOM 与 version catalog）。
        • 设计 README 从 3 行占位扩写为 781 行完整项目说明，补齐 Java 21/Spring Boot 3.5.9/Gradle 标识、项目简介、快速开始、核心技术栈、项目架构与文档资源导航。
      • ✅ 前端完成深度审查，形成阶段一紧急修复计划 〔es-center-server-web-app〕
        • 审查 全面深度审查报告记录前端问题，供后续整改核对。
        • 设计 将紧急问题整理为「阶段一紧急修复」实施计划；更新 Agent 指南与项目说明，保留审查和实施的输入。
        • 实施 删除 admin-1 远控旧页，给相关组件补空状态防御，并将错误边界组件接入应用根部以捕获渲染异常。
      • ✅ 安装程序冻结审查结果，并按建议调整构建流程 〔es-center-server-install-app〕
        • 审查 记录代码质量、安全、架构、错误处理、改进建议与正向发现，保存静态工具输出、主要风险及处置优先级。
        • 设计 建立仓库级 Agent 协作指南和初始化安装指南，重组环境准备、安装、打包、分发与验证说明。
      • ✅ 规格工具链试用后撤回，改用轻量文档记录方案 〔es-center-server-services〕
        • 设计 引入 spec-kit（一套先写规格、再实施的工具链）命令、脚本与文档模板；当天又移除 speckit 脚手架，改用代码质量监控文档。这里记录的是一次工具选择调整，工具链未继续保留。
        • 设计 随审查工作整理执行命令、知识库与报告目录；临时报告和旧工具产物清理后，历史审查材料归并到 .ai/review。
        • 实施 调整本地 Agent/编辑器配置。
    • 1-13 ~ 1-14: 重复设备与远控抖动
      • ✅ 重复设备排查未发现接口逻辑缺陷，判断为联调遗留脏数据 〔es-center-server-services〕
        • 排障 设备列表出现重复设备编号，逐一核对绑定（含强制绑定）、分享、取消分享和解除分享接口。通读相关代码未发现逻辑缺陷，判断是联调阶段遗留的脏数据，即不符合现行规则的历史数据。
        • 重构 排查时复用分享链路已有查询结果，整理判断与查询写法；设备改名按设备号更新同号跨租户投影。
      • ✅ 界面统一去重，远控请求最多重试三次 〔es-center-server-web-app〕
        • 实施 单直播、多屏监控、远控和回放界面对接口返回的设备数据去重。远控拓扑先在渲染层处理，随后将去重上移到列表数据源，避免重复设备继续进入界面。
        • 排障 远控界面抖动来自未配置采集服务器时的无限重复请求。服务器和设备列表增加重试计数，最多重试三次后停止，抖动消除。
    • 1-13: 启动信息与基础写法
      • ✅ 双服务启动信息改由模板生成，运行信息展示同步对齐 〔es-center-server-services〕
        • 重构 用 FreeMarker（将数据套进模板生成文本的引擎）替换启动监听器中的大段字符串拼接。主服务与设备服务同步调整，后续修改启动信息只动模板、不改代码。
        • 实施 将展示时机改到应用准备完成之后，输出应用、URL、JVM（Java 运行环境）、操作系统、Nacos（配置中心）、数据库与 Redis（缓存服务）信息。固定显示 Actuator/Health（运行监控与健康状态），修正默认值及 context-path，链接统一用 localhost，并清理无用 IP 解析与过宽的模板兼容设置。
      • ✅ 代码写法与命名按当时规范整改 〔es-center-server-services〕
        • 实施 switch 从冒号语法改为箭头语法；集合工具类修复「零容忍」规则不允许的写法；统一命名、配置类名称及数据权限变量拼写。
    • 1-12 ~ 1-17: 安装构建与前端工作环境
      • ✅ 安装程序构建拆成可单独失败的阶段 〔es-center-server-install-app〕
        • 实施 新增 BUILD_README 与系列构建脚本。编译、完整安装包、升级包、Coturn 包和 Janus 包分别执行，顶层脚本按顺序编排，将原手工构建过程改为工程化流程。
        • 设计 清理过时生成资料与旧报告，整理发布状态、复测说明及显式 Shell 上传示例；保留测试环境已部署和本轮主要用于代码优化、问题梳理的结论。
      • ✅ 前端启用代码压缩，依赖版本锁定到具体版本号 〔es-center-server-web-app〕
        • 实施 启用 Terser（JavaScript 代码压缩工具），缩小前端产物；全部依赖从版本范围改为具体版本号，并补充辅助脚本，避免随上游版本漂移。
        • 重构 1-14 ~ 1-15，检查与格式化工具链由 Biome 迁到 Oxc（oxlint + oxfmt），同步脚本、编辑器设置与工程指引。Vite（前端构建工具）、IP 查询及开发/生产环境配置一并调整。
        • 实施 工具函数注释转为英文并同步到组件，调整 Agent 配置；随后调整根部语言调用与编辑器模型设置。
        • 设计 整理项目 README 与分支记录。
    • 1-12 ~ 1-15: 发布物与更新日志同步
      • ✅ 构建仓同步本周发布物与镜像复制源 〔es-center-server-build〕
        • 实施 Web 与后端发布物推进到 01-12、01-14 版本，主服务和设备服务 Dockerfile 的 JAR（Java 运行包）复制源由 1.1.0 改为 2.0.1；后端构建前清空共享 Gradle 缓存，并关闭构建仓的 Copilot/Chat AI 功能。
      • ✅ 安装包与部署上传入口跟随本周版本更新 〔es-center-server-install-app〕
        • 实施 同步 01-12、01-14 服务镜像、安装包及各目标部署/上传入口；保留当次静态检查、类型检查和测试输出作为发布辅助证据。
      • ✅ 2.0.1 更新日志已建立并加入导航 〔es-ext-doc-website〕
        • 实施 记录 BCMS 协议去公司化与英文化、App 绑定接口 v2 Token/强制绑定支持，以及前后端多轮质量扫描改进。

其它工作

  • 目标: 记录日常杂项工作、协作沟通等事务
  • 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
    • 📌 以往已自测工作不再重复，详情请查看上周及上月报告
    • 12 日
      • ✅ 将改进后的新版本制作安装及升级程序，部署至 zxs-cs 与 zxs-ca 服务器开展测试。
    • 13 日
      • ✅ 延续部署工作，在 zxs-cs 与 zxs-ca 服务器上继续测试新版本安装及升级程序。
      • ✅ 修复测试中发现的前端代码问题: 单直播、多屏监控、远控和回放等界面在设备列表或采集服务器列表存在重复设备时显示异常，对 API 获取的数据做去重处理。
    • 14 日
      • ✅ 后端排查设备列表出现重复设备编号的问题，从设备绑定（含强制绑定逻辑）、设备分享、取消分享和解除分享等接口查找根因；通读相关代码未发现缺陷，顺手做了性能优化，判断系联调历史遗留脏数据所致。
      • ✅ 修复前端自测发现的远控界面抖动问题: 未配置采集服务器时页面不停重复请求采集服务器列表，改为最多重试三次。
Last updated on
2026年01月05日2026年01月19日