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

2026年03月16日

内容截止日: 2026年03月22日

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

中心服务平台 - 功能完善

  • 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
    • 以往已完成的工作不再重复，详情请查看上周及上月报告
    • 〔工作量〕es-center-server-services 14 次 · 代码 +0.7k ｜ es-center-server-web-app 57 次（设计 14 · 代码 43）· 代码 +11.8k/-2.5k ｜ es-center-server-install-app 2 次 · 代码 +0.1k/-0.1k ｜ es-qt-tools-map 2 次 ｜ es-server-deploy 2 次 · 代码 +0.6k/-0.1k
    • 〔方法论〕AI 数字员工协作编排（openspec 文档 → 拆解任务 → 逐个执行 → 多轮 AI 审核 → 人工审核 → 改进优化）｜ 设计先行·规格固化（组件 proposal/design/spec 先于代码落地）｜ 多轮联调修复收敛 ｜ 参考既有实现（qt-tools）
    • 3-16 ~ 3-17: GPS 轨迹组件设计与基础层
      • ✅ 单设备轨迹方案定型，数据解析、图层和播放基础落地 〔es-center-server-web-app〕
        • 设计 OpenSpec 初稿支持多设备和自定义样式，评审后收敛为单设备，用 mitt 事件在组件间传数据；补斑马线、图层、gcj02/wgs84 两种坐标系自动切换、错误处理、性能、生命周期与国际化。
        • 设计 overview/types/nmea-parser 等规格拆为 00-08 模块结构，详细附录合回设计；自动导入与 lodash 前缀约定同步，注释改为解释原因。
        • 实施 types/constants/nmea-parser/popup-template/map-layers 落地。NMEA 是 GPS 输出格式，解析要求时间戳前缀并提供 localTime、ew/ns；轨迹图层包含双层线、方向箭头、起终点和当前位置标记。
        • 实施 GPS 数据处理、地图初始化、飞行动画、完整轨迹和回放 hook（封装可复用逻辑的函数）及主组件完成，第 2~4 阶段落地。mock（模拟）数据、自动导入类型随实现更新，全仓 272 个 TS/TSX 文件和编解码器格式同步。
      • ✅ 桌面地图参考实现修正终点弹窗 〔es-qt-tools-map〕
        • 设计 参考 qt-tools 既有轨迹实现。
        • 设计 补 React Router/Vite/Tauri 开发指南。
        • 排障 完整轨迹终点标记曾读取首个 GPS 点，改为最后一点，经纬度、时间和地址与标记位置一致。
    • 3-18 ~ 3-20: GPS 演示与联调整改
      • ✅ 3-18 完成组件与演示页，多轮联调修复地图和播放问题 〔es-center-server-web-app〕
        • 实施 新增 playback-demo（实际路由 playback-demo-1），供自测及同事参考调用方式；设计变更归档，落地正式规格。
        • 排障 修复瓦片显示不全、CSS 尺寸、组件依赖、飞行动画队列堆积、中心跟随、终点图标和动画流畅度。地图类型切换先在演示页 reInit 重新挂载，再将 key 重挂载和尺寸重算封装进组件。
        • 实施 设置/清除轨迹合为单一按钮，播放/停止切换，无轨迹禁用操作；低缩放增大斑马线间隔，地图供应商由环境配置控制，国际化用英文 Key。
        • 重构 提取公共轨迹线创建函数，精简 ref/state、重复语言监听、注释和演示页状态，使用 useBoolean；地图初始位置按指定位置 > IP 反查 > 语言默认排序，50 公里阈值与 attribution 抽为常量。
        • 审查 多轮 AI 审核后人工核对并改进，生成两批报告再清理，建立第二轮任务清单、交叉验证和增量日志，保留发现与修复的区别。
        • 实施 更新 review agents 与工作流程，拆分 mock 数据。
    • 3-19: 服务器迁移与联调配置
      • ✅ 安装目标和发布基线跟随新 zxs-cs 服务器 〔es-center-server-install-app〕
        • 实施 build.conf 与共享上传配置同步，构建脚本 shell 兼容性修复归档；zxs-cs/zxs 部署脚本推进到 03-19 10:28，补安装、升级、SSL 更新、检查与 Nacos 管理入口。
      • ✅ 后端开发依赖与同步配置指向同一环境 〔es-center-server-services〕
        • 实施 .dev.env 与 Nacos 草稿统一 Nacos、Meilisearch、EMQX、内外网、Coturn 和 SFTP 目标，更新 SFTP 凭据，承接 zxs-cs 迁移。
      • ✅ 第六云节点部署基线与长沙内网迁移配置建立 〔es-server-deploy〕
        • 实施 补主机初始化、Nginx/证书、FRP、升级包多目标上传与启动脚本；两台长沙内网服务器同步 IP、账号、目录，第二台 Docker 数据根改 /es，校准镜像源、Nominatim 路径和 bodycam 构建包地址。
    • 3-16 ~ 3-20: 前端编码环境与知识库
      • ✅ 前端编码环境更新，知识库补齐 12 份项目 Wiki 〔es-center-server-web-app〕
        • 设计 repo-wiki 记录 README、API、代码约定、组件、依赖、开发、目录、国际化、项目概览、路由、状态管理和排障。
        • 实施 引入 all-MiniLM-L6-v2 本地 RAG（在仓库内离线按语义检索资料）与 code-review/代码简化/提示/设计/React 技能，OpenSpec 命令从 Claude 迁 OpenCode；shadcn-ui 先删除后恢复，模型与 Agent 配置同步刷新。
    • 3-20 ~ 3-22: 空值审查与账号注销需求
      • ✅ 两批属性复制防护合回主线，三处业务缺陷修复 〔es-center-server-services〕
        • 审查 专项报告记录 123 处 BeanUtils.copyProperties（对象间批量复制属性的工具方法）风险点，建立总览、交叉验证与首批任务；提出复制前判空、失败抛业务异常的整改要求。
        • 设计 fix-beanutils-null-check 定义 proposal/design/specs/tasks 和分模块修复、输入/回归/回滚验证要求。
        • 实施 两批覆盖 29 + 31 = 60 个服务/监听文件，合并支线实现，空指针改为明确业务提示。active change 与 archive 暂同时保留，后续统一整理；合并不重复算第二套实现。
        • 排障 审查发现员工 NFC count 返回值错误、设备解密误调 encrypt、设备状态快照端口重复赋值，三处修正并清理冗余代码，补 15 个模块交叉审查。
      • 🟡 账号注销 PRD 迭代为单页方案，仍属需求与设计 〔es-center-server-services〕
        • 设计 delete-account 正名为 deactivate-account，PRD（产品需求文档）深化到 E-PRD v2~v4；区分 Web 验证码注销和 App 既有直接注销，校准邮箱优先、5 分钟验证码、限频、用户名锁、JMS（服务内部消息传递机制）及级联范围。
        • 设计 3-22 将三页面简化为 /deactivate 单页，未登录先验证，登录后验证码确认，成功弹出 Dialog（确认结果的对话框）；后端拟新增 deactivate 类型、专用短信模板和两个接口，复用已有发送机制。
      • ✅ AI 审查工作台收敛到后端所需能力 〔es-center-server-services〕
        • 实施 OpenCode 与本地 MiniLM RAG、code-review/代码简化技能就位；GitHub Copilot 技能先全量引入，再裁掉 500 多个技能文件（共 507 个）过时或无关文件，保留后端 API、架构、安全、性能、测试、调试和 DevOps。
        • 审查 Audit-Cascade 从 React/Tailwind 纠偏为 Java 后端审查，模型与审查 Agent 配置持续调整。
      • 🟡 后续待开发任务列表继续整理，部分完成 〔es-center-server-web-app〕
        • 设计 结合组件联调与项目规范整理后续任务，保留待开发状态。

其它工作

  • 目标: 记录日常杂项工作、协作沟通等事务
  • 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
    • 📌 以往已完成的工作不再重复，详情请查看上周及上月报告
    • 16 日
      • ✅ 调优 opencode 及 continue 所用到的模型配置
    • 17 日
      • ✅ 调优 opencode 智能体配置
    • 18 日
      • ✅ 整理最新的 AI 开发资料并分享给同事
    • 19 日
      • ✅ zxs-cs 服务器即将到期，迁移至新购的腾讯云服务器（43.133.186.162）
      • ✅ 新部署的 zxs-cs 与 zxs-ca 服务器联调，调整 nacos 配置
      • ✅ 从深圳带回的一体式采集服务器，安装调试并投入使用
      • ✅ 办公室内两台小主机重装 Linux 系统，部署免费 MCP 服务，为 AI 开发提供便利
    • 20 日
      • ✅ 根据绍工反馈，联调并优化 GPS 轨迹可视化组件及 Demo 页面
        • 解决 UI 异步化问题: 为避免地图未初始化完成就发送轨迹数据导致无法绘制，发送前增加 1 秒延时，确保地图初始化完成
        • 优化 Demo 页面: 地图类型选择改为受配置控制，便于按需显示特定地图类型（部分客户仅需 Google 地图）
        • 解决 getById 接口报错: zxs-ca 会自动同步 zxs-cs 的数据，在 zxs-ca 手动添加数据后 getById 报错，原因是数据已被同步覆盖；需在代码中返回具体业务异常以便定位（已梳理出一百多处待修复点，逐步处理）
      • ✅ 王工测试反馈的问题排查与处理
        • 新部署的 zxs-cs 存在登录闪退，重启服务后恢复，需进一步排查根因
Last updated on
2026年03月09日2026年03月23日