2026年08月03日

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

中心服务平台 - 功能完善

进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
- 以往已完成的工作不再重复，详情请查看上周及上月报告
- 〔工作量〕services 51 次（设计 27 · 代码 24）· 代码 +7.5k/-1.2k ｜ web-app 45 次（设计 16 · 代码 29）· 代码 +12.6k/-3.3k ｜ install-app 2 次
- 〔方法论〕设计先行·契约固化｜诊断驱动编排（掉房→确定性恢复）｜流程逐个核对纠偏｜所有权抽取与队列限流
- 8-03 ~ 8-04：对讲群组 PTT 配置接缝固化与 AudioBridge 房间合同冻结
  - ✅ 对讲群组 PTT 配置：接缝设计与刷新实现〔services〕
    - 设计 搭建对讲群组流程逐个核对工作台；补 pushPttConfig 流程并标注设备绑定全量替换语义；记录 PTT 配置下发接缝架构（ADR-0015）并补对讲群组术语
    - 审查 核对 plan-01 更新流程，纠偏 ADR-0015 并建修复批次
    - 设计 编写关系变更后 PTT 配置刷新规格与实施票
    - 实施（AI 辅助）统一群组侧、设备侧关系变更、关系删除后的 PTT 配置刷新
    - 实施（AI 辅助）事务提交成功后再发送消息与操作日志
  - ✅ AudioBridge 房间：合同冻结与恢复规格固化〔web-app〕
    - 设计 编排 AudioBridge hook 拆分任务；记录掉房诊断与执行方案；补充发话方式验收约束与麦克风降级 ADR
    - 设计 编排房间恢复与交互改进任务；固化 AudioBridge 恢复与本地发话规格；拆分恢复实施票
    - 审查 hook 拆分 G0 验证
    - 实施（AI 辅助）冻结 AudioBridge 房间公开合同
    - 实施 清理 .tmp 临时截图与快照
  - ✅ 部署与构建〔install-app〕
    - 实施 注释 nginx chunked_transfer_encoding 配置并调整服务启动延迟；更新构建版本号至 20260804
  - ✅ 杂项〔services〕
    - 实施（AI 辅助）本地 dev 存储路径迁移到 WSL 持久挂载
- 8-05：AudioBridge 所有权抽取与确定性恢复 · 对讲群组原子删除链路
  - ✅ AudioBridge 房间：所有权抽取与确定性恢复主干〔web-app〕
    - 重构（AI 辅助）抽出房间成员出席所有者、AudioBridge 信令所有者、浏览器音频会话所有者
    - 实施（AI 辅助）交付 receiver-first 本地发话链路；建立确定性 AudioBridge 恢复主干；按会话健康与可用性裁决恢复；新增有界恢复
    - 实施（AI 辅助）统一播放音量与 autoplay 解锁；完善房间成员状态生命周期；完善响应式房间主控；增加房间状态栏分隔线
    - 设计 记录 AudioBridge issue 08 目标与实施日志
  - ✅ 对讲群组：原子删除链路与设备侧 PTT 定向刷新〔services〕
    - 审查 完成对讲群组流程现状复核；完善编排模板与群组更新流程复核
    - 设计 规划对讲群组原子删除与实时收敛并发布实施票；对齐群组更新流程与当前实现；将对讲流程文档统一命名为 workflow
    - 实施（AI 辅助）原子删除对讲群组及设备绑定；删除后先销毁房间再刷新 PTT；新增群组时优先投递房间任务
    - 重构（AI 辅助）强制 TalkGroup 监听器构造注入；收敛群组设备关系 PTT 刷新
    - 设计 修正设备侧 PTT 刷新流程规格并发布定向刷新实施票
    - 测试 关闭 workflow-02 审查遗留项
- 8-06：入房动作权限统一与成员花名册体验 · 后端合同收口
  - ✅ 对讲群组：入房权限统一与后端复核收口〔services〕
    - 审查 闭环设备侧群组绑定流程复核；记录后端复核与决策检查点；完成后端问题把关与规格收口
    - 设计 规划对讲入房动作权限统一；发布 TalkGroup 删除 ID 合同与 Meilisearch 队列实施票
    - 实施（AI 辅助）对齐入房动作权限；完善默认角色与 Janus 权限；恢复周期性全量房间补偿；加固删除 ID 类型合同
    - 实施（AI 辅助）收敛运行时配置与未使用依赖
  - ✅ 对讲房间：成员花名册与入房体验〔web-app〕
    - 设计 编写成员体验规格与实施票；冻结设备入房请求合同；编写入房 PTT 刷新规格与实施票
    - 实施（AI 辅助）按群组配置设置 Web 参与者编码；校准参与者同步与导航权限；合并绑定设备在线查询并校准成员状态
    - 实施（AI 辅助）衍生成员花名册并优化列表体验；新增绑定设备入房通知与临时设备批量通知
    - 实施（AI 辅助）入房请求门控并按入房刷新 PTT 配置
    - 测试 补齐成员体验集成验证
- 8-07 ~ 8-09：Meilisearch 队列限流与历史保留门禁 · 前端设计再对齐
  - ✅ Meilisearch：队列限流、历史 spool 与保留门禁〔services〕
    - 设计 编写 Meilisearch 队列与 spool、历史索引保留实施票；记录历史 spool 窄例外（ADR）；记录 retention 实施入口
    - 实施（AI 辅助）建立磁盘 spool 写入与恢复；限制 GPS、MyLog、Battery、MQTT Connection、ZFYGB 队列并恢复历史
    - 实施（AI 辅助）实现历史索引六个月保留门禁闭环；关闭虚拟线程历史追踪
    - 设计 收口对讲群组历史流程文档后端实施状态；收口 O3/L2 历史 request 与 owner 决策对齐；新增版本分层测试手册与复用模板
    - 实施 删除零业务价值的空 prompt 与元指令文件
  - ✅ 对讲前端：设计再对齐〔web-app〕
    - 设计 沉淀 agent skills 与对讲设计审查；拆分设计再对齐实施票
    - 实施（AI 辅助）统一页头与状态呈现；再对齐工作台交互、设备工作区、新增与管理保存

其它工作

目标: 记录日常杂项工作、协作沟通等事务
进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
- 📌 以往已自测工作不再重复，详情请查看上周及上月报告
- 03 日
  - ✅ 协作 git → svn 源代码同步
  - ✅ 实施 zxs-cs 及 zxs 服务器上 nginx 配置改进：处理孙工反馈的设备端获取云服务器节点分配信息失败率较高的问题
- 04 日
  - ✅ 实施 最新程序编译 → 制作 docker 映像 → 制作升级程序 → 上传 zxs 服务器 → 升级部署
  - ✅ 文档 编写并提供给测试人员测试手册与版本更新日志（告知本次测什么）
  - ✅ 排障 郭工反馈 app 上部分设备在线状态与真实不符
    - 现象：app 显示在线状态不准；web 端无此问题
    - 排查：用 AI 辅以 Linux MQTT 客户端订阅消息分析，核对前后端源代码，并用 MCP 控制浏览器对比 web 与 app 产生的 MQTT 消息
    - 根因一（采样机制）：web 利用 MQTT 主题双向通信特性——调用接口时传参设置「连续 3 次、每间隔 3 秒回复一次最新在线状态」，一次请求即得多次采样，设备 WebRTC client 频繁断连时也容易捕到 true；app 未用此机制、仅单次采样（且 15 秒才轮询一次），断连瞬间易命中 false
      - 改进：app 改用与 web 相同的多次采样机制
    - 根因二（批量 vs 单个）：app 一次调用只获取一个设备的在线状态，而 web 一次可获取上千个；如同买 100 个鸡蛋，跑 1 趟买 100 个比跑 100 趟每次买 1 个高效
      - 改进：app 改为一次性批量获取所有设备的在线状态