2026年07月27日

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

中心服务平台 - 功能完善

• 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
  • 以往已完成的工作不再重复，详情请查看上周及上月报告
  • 〔工作量〕services 75 次（设计 10 · 代码 65）· 代码 +14.4k/-11.2k ｜ web-app 34 次（设计 4 · 代码 30）· 代码 +7.1k/-1.2k ｜ install-app 1 次
  • 〔方法论〕合同固化先行 ｜ 性能优化（缓存 / 并发 / 弱网）｜ 执行器并发迁移 ｜ 全链路回归审查
  • 7-26 ~ 7-27：集群对讲后端收尾与合同固化
    • ✅ 集群对讲后端：在线状态查询简化与组件抽取 〔services〕
      • 重构（AI 辅助） 抽取在线状态批量查询组件、统一批量读取、复用查询并简化分批
      • 重构（AI 辅助） 多处简化：在线状态缓存读取、角色/用户组 ID 列表、初始化租户 ID 集合、内存分页范围、Janus 来源 topic 空值归一化、自定义日期区间取值
      • 设计 修正缓存 ADR 与实现偏好
    • ✅ 回归审查与规范沉淀 〔services〕
      • 审查 回归审查（提示词 + 报告 + 复核报告 + 复核工作流脚本 + repair session prompts）
      • 设计 二轮复核未实现清单修订、任务分析记录更新、完善编码规范与体验提示词
    • 📌 合同固化与 Janus room PIN 〔services〕
      • 设计 room PIN 契约（恢复 Janus session 兼容、澄清 fallback、详情返回 room pin）、Janus number 持久化不变量
      • 测试 固化 listCache 最新绑定合同、管理员默认租户登录合同
    • ✅ 杂项修复 〔services〕
      • 实施（AI 辅助） 个人空间查询限流策略、IoT 安全错误诊断、dev 运行时与 SFTP 路径配置、对讲群组详情独立投影
  • 7-28 ~ 8-02：集群对讲前后端全链路对接与执行器迁移
    • ✅ 集群对讲前端：全链路契约对接与 Janus/AudioBridge 集成 〔web-app〕
      • 设计 后端接口对接计划拆分、项目规范与对讲契约对齐、AI 原生开发流程模板沉淀
      • 实施（AI 辅助） 前端最小单元测试基建、SFU/PTT 在线状态合同对接
      • 实施（AI 辅助） 管理端契约逐项对接：群组分页/权限/批量删除、设备分页实时/反向绑定、管理更新与只读房间配置
      • 实施（AI 辅助） 管理页 Room PIN 安全展示、进房前强制校验 Room PIN、新增群组真实闭环对接
      • 实施（AI 辅助） Janus 控制切换到 PTT topic、进房补偿对齐、成员快照 single-flight 与轮询、有界清理主动离房
      • 实施（AI 辅助） AudioBridge 浏览器 offer 协商、Janus session 保活、成员刷新视图稳定、成员恢复与 PTT 静音保护
      • 排障（AI 辅助） AudioBridge ICE 配置加载修复，沉淀 AudioBridge 诊断与恢复方案
    • ✅ 集群对讲后端：房间补偿、缓存与 Janus 转发优化 〔services〕
      • 重构（AI 辅助） 房间补偿流程简化（动作去重、移除废弃代码、缓存活跃房间路由）、Janus 缓存 Bean 与领域组件分离、TalkGroup 房间缓存查询链路简化
      • 实施（AI 辅助） 设备状态缓存批量查询、PTT 配置查询与分发优化（含默认标识修正）
      • 重构（AI 辅助） 数据权限常量与 Janus topic 定义归一
      • 实施（AI 辅助） 恢复 Janus 纯裸转发并优化弱网并发链路
      • 实施（AI 辅助） 修复设备信息上报租户隔离、列表排序补 NULLS LAST、处理 MQTT 字节数组载荷、移除 PlusMapper 重复 select；性能优化：缓存 Janus 管理密钥查询、缓存 WebRTC 节点解析、流式普通事务提取
      • 排障（AI 辅助） 生成器重跑诊断分析与业务边界修复
    • ✅ Function 执行器与虚拟线程迁移 〔services〕
      • 设计 虚拟线程执行器职责迁移规划、执行器边界记录
      • 实施（AI 辅助） Function 执行器运行时上下文适配器
      • 实施（AI 辅助） gt-common / es-common / main / main-service / device-service 各层 Function 调用迁移至 Executor
      • 实施（AI 辅助） 框架执行器迁移，新增 MQTT 任务执行器与 JMS 业务执行器
    • ✅ 回归审查与规范沉淀（续） 〔services〕
      • 审查 缓存规范最终审计、Janus 路由实现审查与最终集成验证、Janus 提示词交叉评审
      • 审查 基线对比代码审查路线手册与分段编排、S0.1 认证凭证配置审查、S0.2 租户隔离横切审查
      • 设计 集群对讲 PTT 通道契约与差距决策修订、缓存审计与对讲差距分析
      • 重构（AI 辅助） 数据访问边界与跨租户查询规范完善、跨租户命名统一为 AllTenant、统一异常分层与异步消息边界
    • ✅ 杂项 〔services〕
      • 实施（AI 辅助） 仪表盘保留租户范围、数据源连接池调优与容量指导
      • 实施（AI 辅助） 本地启动与 Gradle 构建配置优化
      • 实施 更新 EMQX API secret 与 COTURN TURN 凭证
    • ✅ 部署与配置 〔install-app〕
      • 实施 调整服务启动延迟并新增 Janus HTTP/管理端口配置，启动前睡眠避免与 BMC 程序冲突

其它工作

• 目标: 记录日常杂项工作、协作沟通等事务
• 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
  • 📌 以往已自测工作不再重复，详情请查看上周及上月报告
  • 27 日
    • ✅ 协作 git → svn 源代码同步
    • ✅ 排障 KH3980：处理线上问题——客户删除租户后，在新租户中添加采集服务器失败；已通过数据库在已删除租户中清理采集服务器及采集设备数据。后续改进：删除租户后，同步由 JMS 队列执行对应租户的数据清理任务