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

2026年07月20日

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

中心服务平台 - 功能完善

  • 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
    • 以往已完成的工作不再重复，详情请查看上周及上月报告
    • 〔工作量〕services 94 次（设计 33 · 代码 61）· 代码 +8.0k/-3.1k ｜ web-app 69 次（设计 20 · 代码 49）· 代码 +4.7k/-2.1k
    • 〔方法论〕全量审查整改驱动 ｜ 缓存优化分阶段·门禁+云端验收 ｜ 查询限流统一保低配稳定 ｜ 编码规范 ADR 化+改码前必查清单
    • 7-20 ~ 7-21：集群对讲后端 — post-0619 审查整改与基础统一
      • ✅ 集群对讲后端：post-0619 审查整改与基础统一 〔services〕
        • 审查 搭建 post-0619 全量审查报告脚手架，固化 review-unit 契约与审查台账
        • 设计 编写审查整改方案与分阶段处理计划；统一 code review 报告归档至 .ai/review/code
        • 重构（AI 辅助） 查询限流策略全量统一：集中 query limit policies，迁移 device/platform/各 controller 至 QueryLimits
        • 重构（AI 辅助） MQTT 文本载荷按字符串处理：IoT JMS 文本直消费、模拟 PTT retrieve 走文本、停止记录消息载荷
        • 重构（AI 辅助） 基础归一化：布尔值归一、默认值移出 nacos、admin 登录限定 default 租户
        • 审查 Janus 路由合同收口：空值简化、接受非 UUID nonce、锁定标量路由合同、IoT client id 单次解析
        • 重构（AI 辅助） 关系软删除查询显式化：补 soft-delete 标志、显式查询已删除关系、收窄至 removal 范围
    • 7-22 ~ 7-23：设备列表缓存性能优化（分阶段）
      • ✅ 设备列表缓存性能优化（分阶段） 〔services〕
        • 设计 性能优化方案（静态查询 + 批量详情），分阶段拆分
        • 设计 设门禁脚本（行号无关）、云端验收与发布/回滚预案；修订静态缓存服务设计
        • 实施（AI 辅助） 阶段一：设备列表静态查询、批量服务器详情、批量固件详情
        • 实施（AI 辅助） 阶段二：缓存完整静态列表、批量 enrichment、收紧校验
        • 测试 阶段查询合同校验、phase 2 静态审查门禁修正
      • 📌 评审（grilling） 对讲架构 grilling 成果记录与缓存性能审查；重组对讲架构 issue 编号并扩写 spec 合同 〔services〕
    • 7-23 ~ 7-25：对讲在线状态与房间（后端）
      • ✅ 对讲在线状态与房间（后端） 〔services〕
        • 设计 在线状态按 PTT/SFU 客户端类型区分；room PIN 契约；PTT 房间操作前校验 SFU
        • 实施（AI 辅助） 在线状态批量读取缓存、归一化空白账号并预置 SFU 客户端常量
        • 实施（AI 辅助） PTT 下发保留数据库顺序、归一化 canSpeak 并强制下发空快照
        • 重构（AI 辅助） 移除 JetCache 在线状态读写冗余兜底；锁定旧版兼容性缓存键读取合同
        • 审查 收紧 TalkGroup 更新契约、改用跨租户存在性校验
        • 实施（AI 辅助） 房间补偿改分页增量 + 周期调度；新增已删除房间每日销毁补偿
        • 测试 后端预验收并新增构建脚本
    • 7-24 ~ 7-26：编码规范沉淀与全量简化重构
      • ✅ 编码规范沉淀与全量简化重构 〔services〕
        • 设计 重构规范文档改为 ADR + 改码前必查清单；完善编码规范与体验提示词；修正缓存 ADR 并记录实现偏好
        • 重构（AI 辅助） 全量简化：移除重复参数校验与统一判空、Java 原生集合构造器、下沉批量关系业务至服务层
        • 重构（AI 辅助） 抽取在线状态批量查询组件；简化在线状态缓存读取、统一批量读取与分批
        • 重构（AI 辅助） 简化角色/用户组/租户 ID 集合构造、Janus topic 空值归一化、自定义日期区间取值
        • 审查 新增回归审查提示词与回归审查报告；编写回归审查复核报告与复核工作流脚本
        • 实施（AI 辅助） 固化公开保存完成合同；强制个人空间查询限流策略与 Janus 号持久不变量
    • 7-21 ~ 7-24：集群对讲前端 — 在线状态、房间与防重提交
      • ✅ 集群对讲前端：在线状态、房间与防重提交 〔web-app〕
        • 设计 对讲在线状态走 MQTT，去掉集中注册与引用计数；明确 room 唯一 HTTP 契约（getByTalkGroupId）
        • 设计 room participant 身份与生命周期决策；新增三份实现计划；沉淀 web 对讲细化设计与 ADR 0003-0006
        • 设计 talkgroup 提交防重入 guard（设计 + 计划）；移除 Janus/talkgroup 提交节流
        • 实施（AI 辅助） 在线状态 store 与查询协调；解析工作台、反向绑定、绑定设备的在线状态
        • 实施（AI 辅助） room 元数据加载/复用/稳定化；参与者来源 Janus 与刷新状态守卫
        • 实施（AI 辅助） room 生命周期门控：MQTT 断连 fail-fast、可用性裁决、中断恢复、清理时保留 Janus 目标
        • 实施（AI 辅助） talkgroup 保存防重入；playback 路由组件拆分（player-2、box-2、route-last）
        • 审查 post-audit 整改（device-list-cleanup 分支合并）；Janus 与 room 元数据各类异常/竞态修复

其它工作

  • 目标: 记录日常杂项工作、协作沟通等事务
  • 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
    • 📌 以往已自测工作不再重复，详情请查看上周及上月报告
    • 20 日
      • ✅ 协作 git → svn 源代码同步
    • 23 日
      • ✅ 排障 KH3980（印度客户执法仪）：排查切换租户后异常（前后端版本不一致）并部署新版；回放改英文版并部署；协助排查回放地图问题
    • 24 日
      • ✅ 排障 KH3980：回退部署为旧版，避免上线未经系统化测试的新版本
    • 25 日
      • ✅ 排障 KH3980：处理线上问题——客户误删数据后重启无法登录，定位为 bmc 程序与本程序重启时相互抢资源，本项目 postgresql 未抢占成功导致启动失败
Last updated on
2026年07月13日2026年07月27日