2026年08月17日

内容截止日：2026年08月23日

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

中心服务平台 - 功能完善

• 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
  • 以往已完成的工作不再重复，详情请查看上周及上月报告
  • 〔工作量〕es-center-server-services 190 次（设计 81 · 代码 109）· 代码 +20.0k/-9.3k ｜ es-center-server-web-app 132 次（设计 43 · 代码 89）· 代码 +8.8k/-6.6k ｜ es-center-server-install-app 6 次 · 代码 +0.1k/-0.1k ｜ es-ext-doc-website 4 次（设计 4 · 代码 0） ｜ es-center-server-build 1 次
  • 〔方法论〕审查终报驱动整改闭环 ｜ 契约测试锁定租户写边界 ｜ 成熟能力复用四层判定 ｜ auth 语义对齐权威来源 ｜ 同栈架构对标排产（P0/P1）｜ 真库回归接缝（ADR-0025）｜ 通道契约归档消费者 ｜ 退役闸门双采样实证 ｜ i18n 同义收敛 ｜ 声驱动效实测定档
  • 8-17：冻结审查终报与整改计划 · 认证白名单与公开接口退役 · 工程治理
    • ✅ 冻结 END 代码审查：终报发布与整改计划 〔es-center-server-services〕
      • 审查（AI 辅助） 发布冻结审查唯一正式结论报告：收口覆盖账本、跨域裁决与 END 内容验证三门禁，锁定 15 个破坏性 bug、46 个条件性风险与 106 项标准
      • 设计 依据终报定义 34 张本地整改票与 317 行 spec，修订 3 份 ADR、新增 2 份 ADR（设备授权码读取合同、设备对讲群组绑定增量合同）
    • ✅ 认证边界：白名单合同固化与公开接口退役 〔es-center-server-services〕
      • 设计 以 ADR-0024 固化「白名单是唯一匿名边界」，两份契约测试把白名单行为锁为可回归合同
      • 实施 退役废弃公开接口：缓存任意读写与对讲群组计数端点整体删除，新增契约测试断言退役路由不再可达
    • ✅ 工程治理：指令文档单一真源与预算措辞精化 〔es-center-server-web-app〕
      • 设计（AI 辅助） 立 ADR 0027：AGENTS.md 为 Agent 指令文档唯一真源，CLAUDE.md 壳化为一行引用
      • 设计（AI 辅助） 拆票上下文预算双线措辞精化：硬线改称强制交接线，余量定位为安全边界而非堆叠许可
  • 8-17：对讲群组与采集绑定合同加固 · 租户写边界系列落地
    • ✅ 对讲群组与采集服务器：绑定合同加固与当前态门禁 〔es-center-server-services〕
      • 实施 加固对讲群组-采集设备绑定合同：save 服务端下发租户并强制置空防改写分区列，四处查询收敛统一数据域
      • 重构 落地合同评审意见：数据域收敛重载合并为单一版本，消除重复实现
      • 实施 采集服务器绑定当前态门禁：新增当前态查询、软删 gate 提升为固定谓词、恢复列表授权
      • 测试 关闭采集读取评审发现：两条检索路径抽取共用 gate 片段，消除孤儿过滤不一致
      • 重构 当前态 detail 查询抽为共用片段
    • ✅ 租户写边界：员工、参考配置与权限 〔es-center-server-services〕
      • 实施 员工/组织租户写边界与 BMC 合同：8 个服务 save 置空、恢复组织授权、JMS 监听以信封为租户来源，833 行契约测试
      • 实施 员工用户唯一性合同下沉：查重移入 service 默认方法，update 排除自身记录
      • 实施 参考配置租户写边界：8 个 controller 下发/置空，恢复字典授权并参与主键，691 行契约测试
      • 测试 补齐参考配置 upsert 分支测试
      • 实施（AI 辅助） 权限域租户写边界：9 个 controller 统一下发/置空，修正受保护角色校验，554 行契约测试
    • ✅ 租户写边界：消息、翻译与用户接缝 〔es-center-server-services〕
      • 实施（AI 辅助） 消息域租户写边界：14 个 controller 下发/置空，921 行契约测试
      • 实施（AI 辅助） 翻译 save 租户边界，153 行契约测试
      • 实施（AI 辅助） 用户-租户跨租户接缝：管理员专属绑定入口、按目标租户去重与计数、恢复自助入口，615 行契约测试
  • 8-17：talkgroup 整改票收口 · 成熟能力复用与 Shiro 语义同步
    • ✅ Talkgroup 整改票 08~16 收口 〔es-center-server-web-app〕
      • 重构（AI 辅助） softFail 封装消费收敛：ensureRoom/pushPttConfig 迁回统一封装，恢复状态检查，删除调用处静默吞错
      • 重构（AI 辅助） room 实时侧五项机械收敛：守卫归一、attempt 改名、死字段删除
      • 重构（AI 辅助） WebRTC 调试日志整体链路删除，信令/ICE 正文不再产出
      • 实施（AI 辅助） 读权限 gate 对齐后端权限 key：双 key 逐 key AND、三函数收敛，表驱动测试锁定放行/误拦两态
      • 测试（AI 辅助） 补齐三文件契约测试共 74 用例
      • 设计（AI 辅助） 补勾 05 票：softFail 选项与断言链清除已前置落地，核验后关票
      • 重构（AI 辅助） relation 链路纯函数收敛：flag 判定三份拷贝归一到统一判定
      • 重构（AI 辅助） 主路由 JSX 收敛：disclosure 抽有状态 Popover 壳、空错态共享渲染、分页局部子渲染，DOM 零变化
      • 重构（AI 辅助） 编辑器收尾：删除死 prop，补 beforeunload 守卫兜住丢草稿
      • 重构（AI 辅助） 位置收敛与加载态归一：断点 hook 收敛父级目录、加载态上移、手写占位改 Skeleton
    • ✅ 成熟能力复用整改：规范先行与样板落地 〔es-center-server-web-app〕
      • 设计（AI 辅助） 发布复用整改 spec：四层判定顺序（零 JS → ahooks → 共享库 → 三方库）落地 ADR 0028
      • 设计（AI 辅助） 发布整改票 5 张，标的清单 grep 复核全有效
      • 重构（AI 辅助） 落地票 01/02/03：断点注册单一真源、ahooks 等价替换、共享提炼与 ADR 0029 AutoImport 消费纪律
      • 重构（AI 辅助） 落地票 04：auth 函数族完整同步 Apache Shiro 命名及语义（真 ALL、改名 96 处、组合原子）
      • 设计（AI 辅助） 落地票 05：repo-wiki 复用整改样板手册（291 行，含 Shiro 考据）
      • 设计（AI 辅助） realtime 补对讲话音 AudioBridge 小节：自听不可用系 Janus 混音固有行为
  • 8-17：错误 i18n 与 auth Any 家族回归
    • ✅ 错误 i18n 与 auth Any 家族回归 〔es-center-server-web-app〕
      • 设计（AI 辅助） 发布 spec 与整改票 4 张：根因定位字面量复核漏数据驱动调用点，裁决判定函数族 2×3 对称矩阵
      • 重构（AI 辅助） 落地票 01：auth Any 家族回归与 All/Any 组合原子对称拆分，契约矩阵 22→42 例
      • 重构（AI 辅助） 落地票 02：nav 可见性判定收拢为递归纯函数，修复 report 菜单回退
      • 重构（AI 辅助） 落地票 03：错误描述双态翻译收口，技术文案进入缺翻译上报管道
      • 重构（AI 辅助） 落地票 04：业务拒绝判定与组合提炼共享层，17 例测试随迁
  • 8-18：认证收紧与安全加固 · 字典兜底与固件合同恢复
    • ✅ 认证与安全加固：登录 claims 统一与过滤边界收紧 〔es-center-server-services〕
      • 实施（AI 辅助） 四登录入口 claims 装配统一抽为单一函数：管理员固定 default 租户、普通用户恢复上次租户
      • 实施（AI 辅助） 认证过滤收紧：JWT 异常安全 401、技术失败 500 兜底、绑定异常 400，736 行契约测试
      • 实施（AI 辅助） 上传路径遏制：单一安全路径段校验 + 词法/物理双证明，176 行 Web 测试
      • 实施（AI 辅助） 敏感日志脱敏：签名 key 与携带 payload 的异常不再渲染进日志，360 行测试
    • ✅ 字典兜底、缺失翻译与固件合同恢复 〔es-center-server-services〕
      • 实施（AI 辅助） 字典 listCache default 兜底：业务租户优先合并去重，自定义默认上限，599 行契约测试
      • 重构（AI 辅助） 字典兜底支持移入 function 包公开
      • 实施（AI 辅助） 缺失翻译摄取与验证邮件固定 default 租户，单请求上限 500
      • 实施（AI 辅助） 通用固件保存恢复对象型 binaryHeader：手写 HTTP DTO + JSON 编码
      • 重构（AI 辅助） 固件 DTO 映射改用 BeanUtils 复制同名字段
  • 8-18：同栈架构对标账本与 P0/P1 排产
    • ✅ 同栈架构对标：账本发布与 P0 落地 〔es-center-server-web-app〕
      • 设计（AI 辅助） 发布同栈对标账本：4 个 OSS 深挖与裁决账本，P0 四项 + P1 排产
      • 设计（AI 辅助） 发布 P0 四项 spec 与拆票：CI 门禁、规范微条目、表格模式、依赖导入限制
      • 实施（AI 辅助） 落地 verify 门禁：pnpm verify 聚合入口 + 流水线配置文档
      • 设计（AI 辅助） 落地规范微条目：AGENTS.md 编码微约定五条 + STANDARDS 索引
      • 设计（AI 辅助） 落地表格模式：patterns.md 表格三件套扩写 + STANDARDS §1 索引
    • ✅ P1 排产：Faro 可观测性与 Playwright E2E 〔es-center-server-web-app〕
      • 设计（AI 辅助） 发布 Faro 简化版 spec 与 5 张整改票，估 3.5~4.5 天含跨仓协同
      • 设计（AI 辅助） 发布 Playwright E2E 核心场景冒烟集 spec 与 6 张整改票，估 5~8 天
  • 8-18：冻结整改冲刺续收 · 真库 PostgreSQL 回归与快照触发器加固
    • ✅ 冻结整改冲刺续收：授权码投影、Janus 租户安全与 webrtc 路由恢复 〔es-center-server-services〕
      • 实施（AI 辅助） 三个手写读投影补选授权码列，设备列表/缓存/分页与零售详情恢复返回绑定授权码，读合同测试断言四条读语句
      • 实施（AI 辅助） Janus 服务器保存与删除补租户安全边界，两层合同测试锁定生命周期语义；管理密钥解析只取完全活跃记录，防软删与跨租户孤儿
      • 实施（AI 辅助） 新增 Janus Normal 上行解析器：整个输入恰为一个完整合法 JSON 对象才放行，封堵截断 JSON 与尾随垃圾两类绕过，四个入口统一接入
      • 实施（AI 辅助） 平台模拟 retrieve 打来源标记，不再把断线物理设备标在线；IotV1 失败路径先定唯一终态再写响应，成功包不补失败包
      • 排障（AI 辅助） 恢复旧设备 webrtc retrieve/telemetry 的 MQTT 路由——被 default 静默吞掉、拿不到 ICE 配置的根因修复，对应 18 日线上排障
    • ✅ BMC 设备绑定生命周期投影 〔es-center-server-services〕
      • 实施（AI 辅助） 绑定列表内核替换为专用手写投影：六列生命周期字段、按设备+目标服务器取最新关系、上限 10,000 钳制；再扩六组时间区间过滤，协议层成对校验
    • ✅ 真库 PostgreSQL 回归体系与快照触发器加固 〔es-center-server-services〕
      • 设计（AI 辅助） 立测试服务器使用边界 ADR 与集成测试规则，五张改过手写 SQL 的票补真库回归待办；立 handler-method-validation-400 与前端可观测性接收端点两项排产
      • 测试（AI 辅助） BMC 生命周期/六区间/采集端点门/密钥解析/授权码投影逐项真库验证，throwaway schema 播种软删、跨租户等真实数据形态；接缝 jdbc 跨境稳定性调优
      • 实施（AI 辅助） 快照触发器整月加固：正常路径确保子表存在、删除按业务身份限定防跨租户误删，真库接缝红→绿验证；调度器关闭扫描目录流修复资源泄漏
    • ✅ 集成交付审计与部署预检手册 〔es-center-server-services〕
      • 设计（AI 辅助） 集成交付审计留档；冻结终版部署预检手册：活跃配置清单、群组凭据缺口、孤儿清单、签名密钥日志金丝雀与 BMC 六列切换核查
      • 实施（AI 辅助） NFC notify-ready 员工号改从匹配员工取值；删除遗留 boxId 认领清理分支
  • 8-18：英文构建档位与工程规则治理
    • ✅ 发布批次推进与英文档位构建支持 〔es-center-server-build〕
      • 实施 发布批次从 08-04 推进到 08-18，构建脚本支持第三参 FLAVOR 档位透传，版本/时间改经 Docker ARG 注入（18 日 zxs-test 部署的构建侧准备）
    • ✅ 英文版构建档位与 E2E 登录裁决 〔es-center-server-web-app〕
      • 实施（AI 辅助） 新增 build:en/dev:en 档位，档位定义收口前端，占位符未注入即终止构建杜绝进产物
      • 设计（AI 辅助） E2E 冒烟集 spec 补全自动登录裁决：验证码后门、env 分法与切租户程序化，消除登录冒烟票阻塞
    • ✅ AGENTS.md 渐进瘦身与跨仓规则对齐 〔es-center-server-web-app〕
      • 设计（AI 辅助） AGENTS.md 渐进瘦身 spec 定稿并拆票：速赢票修复引用漂移、核心规则压一行；收口主体 191→91 行、场景规范下沉 STANDARDS，新建 ADR 0030 取代双写纪律
      • 协作（AI 辅助） 跨仓规则对齐：拆票预算表述改 1M 窗口 3/8 与 5/8 比例化；ADR 0031 固化跨仓编码规则，STANDARDS 四处落地
  • 8-19：MQTT 通道契约与消费者家族收敛
    • ✅ Subject 判定族三族定稿与协议错误族对齐 〔es-center-server-services〕
      • 设计（AI 辅助） ADR-0026 裁决 Subject 判定族语义：六入口按 Any/All/Not 三族定型，判定委托下沉进 Subject，157 行测试钉住三族真值表
      • 实施（AI 辅助） 设备创建门控迁移 isPermittedAny 保行为；两服务适配器收敛薄委托，All 族真 ALL 语义生效
      • 实施（AI 辅助） 协议错误族 4xx 良性化与两服务对齐：绑定/类型/方法/媒体类型/无资源五类，绑定合同与 Web 层测试逐类钉住
    • ✅ 规范化文档健康：通用规则对齐与票库收口 〔es-center-server-services〕
      • 设计（AI 辅助） ADR-0027 裁决与前端仓通用规则对齐 6 项；ADR-0028 裁决 ByTenantId 命名语义；api-design §6 重写、AGENTS 微约定压缩、拆票预算单源化；产出跨仓差异清单 51 行收尾
    • ✅ mqttSourceTopic 统一盖章与六通道拆分 〔es-center-server-services〕
      • 设计（AI 辅助） ADR-0029/0030 裁决 mqttSourceTopic 属性与按通道拆 destination，ADR-0015/0016 补修订注
      • 实施（AI 辅助） 网关对入站消息统一盖 mqttSourceTopic，三族拆六个独立 destination，检索与遥测上报体提炼两个共享 Function；Janus 转发对收敛为家族基类
      • 实施（AI 辅助） 删除 08-18 引入的 pttRetrieveOrigin 负向标记，D2 推送回归裸 payload
      • 实施 评审修正：destination 常量化、V1Params 统一载荷提取、死方法与复述注释清理
    • ✅ 通道契约归档消费者：MqttConfig 纯调度表 〔es-center-server-services〕
      • 设计 消费者家族评审产出：编码微约定新增「同一数据流命名一致」
      • 设计 ADR-0031 裁决通道契约归档于消费者、MqttConfig 退化为纯调度表
      • 实施 janus 物理 from 正则单源化，网关谓词与解析器共用
      • 实施（AI 辅助） 六通道与 Sys 各自持有 destination 与来源判定，网关清除全部 Pattern 与裸字面量；JanusTopics TO/FROM/inbound 常量归档各消费者；编码微约定第 6 条入文档
  • 8-19：Talkgroup 设备请离请求六票收口
    • ✅ 请离专项设计：命令契约与实测双轨 〔es-center-server-web-app〕
      • 设计 Talkgroup 设备请离请求专项 spec 定稿并拆 6 张票（命令契约、资格门控、确认流、pending 反馈、校验抽取、ADR 修订）
      • 实施（AI 辅助） 落地票 01 kick 命令契约：镜像既有 join hook、错误三段式、发布前校验脱敏，契约测试 12 例冻结发布边界；ADR 0033 固化 MQTT 实测双轨，mosquitto 实测报文与冻结局逐项一致
    • ✅ 入口门控、确认流与 pending 防重 〔es-center-server-web-app〕
      • 实施（AI 辅助） 票 02 成员列表新增 destructive 请离入口，按房间可用性与成员资格组装；票 03 单例受控弹窗确认直通发布，关闭路径一律不发布
      • 实施（AI 辅助） 票 04 pending 防重：in-flight 骨架双轨防并发重复、按钮 pending 态镜像通知加入，失败脱敏 toast 可原地重试；票 05 join/kick 校验抽取共享模块
      • 设计（AI 辅助） 票 06 ADR 0011 kick 兼容扩展修订与 CONTEXT 对称术语
      • 协作 ADR-0034 补齐拆票预算动作义务条款，与 services 仓 ADR-0017 同文
  • 8-19：i18n 存量清扫与 sentence case 规范 · 文档健康收口
    • ✅ 文档健康 P0 收口 〔es-center-server-web-app〕
      • 设计（AI 辅助） 拆票预算表述第三处副本收口为指针 + resize 同步（ADR 0032）；自研技能不入锁说明，50 个技能拆 46+4、排除理由直引上游
    • ✅ i18n 存量清扫与 sentence case 规范 〔es-center-server-web-app〕
      • 设计（AI 辅助） i18n 专项 consensus 与 spec 起草（清扫范围、收敛规则与验收口径）并拆 2 张票
      • 实施（AI 辅助） 票 01 存量硬编码文案清扫：缩放档位、演示标题、shadcn 生成物 7 文件全部经 t() 纳管，缺失上报 17 个新 key 服务端 200
      • 设计（AI 辅助） 落 STANDARDS §10 文案规范：当日两次拍板全部文案统一 sentence case、Title Case 分类取消
  • 8-20：旧前缀退役与 WebRTC Janus 转发通道族
    • ✅ Sys 客户端事件二拆与平台直通白名单 〔es-center-server-services〕
      • 设计 ADR-0032 裁决 Sys 客户端事件按生命周期与活跃二拆，「活跃即在线」规则与双写防假离线注释钉入代码
      • 实施（AI 辅助） 活跃监听器落地承接六写迁移；Manage* 26 类 destination 提升静态常量、八类 16 处内联注解提取；网关宽前缀兜底切换为 49 标签直通白名单，孤儿队列停止增长
    • ✅ 旧 web-ui 通道与 server/center/ 旧前缀族退役 〔es-center-server-services〕
      • 实施 旧 web-ui 两条 Janus 转发通道整链移除；真实环境 37 队列双采样零增长通过硬闸门后删除宽订阅与双账号 ACL
      • 实施 29 类旧前缀消费者与基类整体删除，DAS 设备清单方法族连带摘除，直通白名单 49→12
      • 设计 退役 spec 与三票：尾斜杠精确串防误伤 16 条活通道、删前 37 队列双采样为出口闸门两道保险；ADR-0035 记录退役决策
    • ✅ 防 reply topic 回环：retrieve 回复与 Janus 转发入口等值守卫 〔es-center-server-services〕
      • 设计 ADR-0038 裁决 retrieve reply 入口以自地址等值判定替代依赖 topic 命名的前缀清单；ADR-0037 回环 reply topic 按插件+领域命名惯例（通用名封死命名空间、后来者复用即竞争消费陷阱）
      • 实施 iot/v1 直通族 retrieve 回复判定：reply 主题与消息来源主题相同即丢弃并告警，topic-prefix 前缀配置随之删除；接受至多 10 次有界污染以避免重新引入前缀清单
      • 实施 Janus 转发入口（iot/webrtc 两族共用基类）回环阻断：入口读来源主题与 reply 主题等值比较，相等即丢弃并告警；房间结果回环通道按插件领域命名防竞争消费
      • 实施 守卫抽为共用 MqttReplyTopicGuard 并迁 mqtt 领域包供两族共用，135 行守卫测试落地
    • ✅ WebRTC Janus 转发通道族 〔es-center-server-services〕
      • 设计 ADR-0036 裁决 WebRTC 独立 Janus 转发通道族方案（iot 族约 2027-02 退役），CONTEXT 词条与两票结构入库
      • 实施 WebrtcV1 两消费者落地复用家族基类，634 行测试钉住转发与 admin 密钥注入合同
    • ✅ 编码微约定扩至十条与违规修复 〔es-center-server-services〕
      • 设计 黄山版 Java 开发手册转换稿 840 行入库作非权威参考；微约定七条扩至十条并钉「评审纠正必须落档」元规则；违规修复 spec 双主线（5 组点名违规 + 全仓布尔裸判回填一次性授权）
      • 实施 违规修复三组零行为变化改写；UtilityClass 新建与迁移门禁区分；IotV1 消费入口内聚来源派生，ADR-0029 补记派生合同
    • ✅ 通道收口与工程杂项 〔es-center-server-services〕
      • 实施（AI 辅助） server/janus/to 改名对称收口（MQTT topic 不动、旧 web-ui 零感知）；ExceptionAdvice 魔法值提取常量；Spring Boot 插件钉 3.5.16 终版并入库 ADR-0034，jasypt CVE 核实不适用
      • 设计（AI 辅助） 设备接入文档新增 Web 请离通知（sub:“kick”）契约，join/kick 线级合同经真实 EMQX 实测
      • 测试 复用五组 MQTT 来源消息测试数据，统一消息正文、来源属性与 IoT/PTT 通道名称
  • 8-20：i18n 同义收敛落地与旧 xlsx 链路清退
    • ✅ i18n 同义收敛落地 〔es-center-server-web-app〕
      • 实施（AI 辅助） 票 02 全量重扫五语底稿（1416→1400 keys），45 组收敛映射替换 109 点、孤儿 key 55 条清单，拼写统一表落 STANDARDS §10
      • 设计（AI 辅助） ADR 0011 补录 kick 不经 Janus Admin 强制移除的依据；随提交清退 2026-06 旧 i18n 链路与 superpowers 文档 4995 行及 6 个 xlsx
  • 8-20：Talkgroup 麦克风电平信号系列与实测调参
    • ✅ 麦克风电平信号三票落地 〔es-center-server-web-app〕
      • 实施（AI 辅助） 票 01 电平信号源：会话只读 getLocalStream 生命周期 + 单流单链电平 hook + 频域→gamma→包络→分档纯函数管线
      • 实施（AI 辅助） 票 02 工具栏麦克风电平分段条：rAF 每帧只写一次 CSS 变量、8 段点亮零 React 重渲染、meter 无障碍语义
      • 实施（AI 辅助） 票 03 发话状态环电平化：有声才旋转（按帧间真实时长积分）、安静完全静止，双挂载共享传输环
    • ✅ 实测反馈迭代与逐档定档 〔es-center-server-web-app〕
      • 实施（AI 辅助） 实测反馈：分段条色相跟随 stage 语义、外环转速平方映射拉层次；双轴代码审查报告 Standards 轴 0 硬违规
      • 实施（AI 辅助） 外环转速三次逐档拍板（360→720→底速+声驱增速 1200→1800°/s），停顿滑向底速消除断裂感
  • 8-21：增量冻结审查与知识、认证协议重校准
    • ✅ 增量冻结窗口审查：合同、清单与三域复审 〔es-center-server-services〕
      • 设计 定义增量冻结窗口审查合同与任务，初始化并两轮修正冻结清单，补齐生成产物、身份安全、配置消息租户及设备读绑定/固件四域审查入口
      • 审查 完成生成产物、身份安全与配置消息租户三域首轮审查和复审，校正候选映射、基线证据、汇总口径与责任归属，记录设备读绑定及固件修复族审查结论
      • 协作 串行编排审查票并保持执行清单、报告账本与修复决策同步
    • ✅ 知识基线、认证异常合同与布尔微约定 〔es-center-server-services〕
      • 设计 重校准配置管理、安全认证、数据模型、接口参考、构建、架构、模块依赖与核心库知识至 08-21 基线，轻核验消息与设备知识并同步数据结构元数据日期
      • 设计 固化认证异常兼容合同并明确安全协议责任归属
      • 实施 补齐认证异常兼容值；按编码微约定统一全仓布尔判定
  • 8-21：UI 事件全族迁移 · 双语更新日志与安装发布链路
    • ✅ UI 事件命名治理全族迁移 〔es-center-server-web-app〕
      • 实施 建立事件命名工厂与文法契约，统一事件声明入口
      • 重构 依次迁移直播视频、回放文件、GPS 轨迹、杂项及预留事件族，删除死事件并遵循自动导入消费纪律
      • 测试 增加命名入口正向守卫、转义字面量与源码静态审计，防止调用点回退到裸事件名
      • 实施 开发环境服务地址由 test 整组切换至 cs，保留互换入口
    • ✅ 安装包同步、构建上传收紧与测试服务器入口 〔es-center-server-install-app〕
      • 实施 将主服务、设备服务与 Web App 镜像同步至 08-20 批次，安装包与构建/上传/部署入口推进至 08-21 发布物，并修正 Nacos HTTP 控制台端口说明
      • 实施 构建后停止自动上传客户环境，保留按需手动入口；新增 zxs-test 上传、安装/升级、服务检查及 Nacos 鉴权验证脚本
      • 实施 同步 Upgrade App 构建过程记录；该 .ai/promgt 条目仅更新过程材料，有效代码量为零
    • ✅ 2.0.1-20260824 双语更新日志周中草稿 〔es-ext-doc-website〕
      • 设计 统一规划 08-13～08-24 中英文更新日志增量，拆为中文草稿、英文同步、中文收口与英文再同步四张线性票
      • 设计 从 es-center-server-services 与 es-center-server-web-app 素材提炼中文 30 条对外变化，再以中文落盘稿为唯一素材同步英文版，保留周一人审裁决入口
  • 8-22：增量冻结审查定稿 · administrator 与固件租户修复
    • ✅ 增量冻结审查：四域补齐、覆盖账本与终报发布 〔es-center-server-services〕
      • 审查 补齐数据库与同步、消息通道、平台运行时及瞬态持久副作用四域审查，核对冻结整改票与修复交接
      • 审查 合并候选并建立覆盖账本门禁，记录冻结 END 全量动态门禁，裁决候选、修正瞬态清单校验和后关闭覆盖门禁并发布增量审查终报
      • 测试 记录提交门禁执行事实，修正现场核验表名与逻辑删除漏报风险
    • ✅ administrator 保护、文档边界与固件租户写入 〔es-center-server-services〕
      • 实施 保护既有 administrator 角色并将重复守卫收敛为单一函数，以命名化普通测试角色锁定允许/拒绝边界
      • 设计 落档增量审查四项裁决与租户注入合同；退役 Repo Wiki，将现役文档边界收敛至 ADR、CONTEXT 与 AGENTS
      • 实施 固化消息乱序接受与弱网连接优化裁决注记，发布批次 2 修复及写入对象断根票；阻止固件写入透传请求租户身份
  • 8-22：前端深模块加深与 Repo Wiki 退役
    • ✅ UI 事件与 GPS 时间线纯层治理 〔es-center-server-web-app〕
      • 重构 移除 GPS 轨迹事件包装并抽取时间线纯层，保持缺失端点时间时的最大回放时长语义
      • 测试 对齐事件分发合同，增加命名入口正向与转义字面量审计守卫
      • 设计 建立 8 个模块加深候选账本，固化 GPS 时间线合同并规划 Talkgroup 房间展示抽取
    • ✅ Talkgroup 房间展示与候选分页深模块 〔es-center-server-web-app〕
      • 重构 抽出房间恢复、失败阶段、常开麦阶段与禁用原因纯派生，再将恢复控制和常开麦舞台迁为页面局部组件，保持界面与交互合同
      • 实施 统一候选分页、防抖与立即查询，避免重复请求并在刷新失败时保留结果；接入两处候选查询和工作台双分页实例
      • 测试 修正首帧可见性、组织筛选同步与错误保留逻辑，完成三票行为核对和验证闭环
      • 设计 裁决镜像绑定交互对称与两套共享列表 seam，规划关系暂存和候选结果骨架
      • 重构 抽出关系暂存列表骨架并统一在线徽标判定，表驱动测试锁定实时消息、接口查询与过期回退；无障碍测试钉住含目标名称的移除按钮
    • ✅ Dashboard 排名、共享地图引擎与数据页脚手架 〔es-center-server-web-app〕
      • 设计 裁决排名预览、参数化在线排名、共享地图引擎与 Dashboard 数据页脚手架边界，按试点和渐进迁移拆票
      • 重构 四张排名预览卡统一接入分页、榜头/榜行/骨架及汇总工具；服务器与设备在线排名路由收敛为参数化薄配置层
      • 实施 建立共享地图引擎与参数化在线排名页，集中底图/坐标/飞行动画及 KPI、筛选、排名表和分页请求
      • 重构 GPS 轨迹与单兵直播地图接入共享引擎，停止非 Google 底图的无效数据轮询并保留各自生命周期合同
    • ✅ Repo Wiki 退役 〔es-center-server-web-app〕
      • 设计 以 ADR-0037 退役与 ADR/STANDARDS/CONTEXT 重叠且持续漂移的 Repo Wiki，清理现役引用并复核引用计数，历史档案保持不回改
  • 8-23：认证翻译与租户写边界根切
    • ✅ 验证邮件翻译与注册成员租户边界 〔es-center-server-services〕
      • 实施 验证邮件改按自然键精确匹配翻译并补真实 SQL 集成覆盖，避免模糊匹配选中无关记录
      • 重构 注册成员保存收敛为统一服务，以认证租户限定邮件/手机号两入口写入边界，并以合同测试和执行记录闭环
    • ✅ SpiritCam 固件与剩余租户写入收口 〔es-center-server-services〕
      • 重构 移除 SpiritCam 固件写入对象中可伪造的租户字段，改由认证租户注入；合同测试覆盖异步上下文，真实数据库测试锁定更新不越租户
      • 重构 清理控制器、监听器和服务中的剩余数据携带式及覆盖式租户写入，统一员工导入、字典、翻译、设备采集、注册与用户租户等持久化观察工具
      • 测试 从被测实体推导观察租户并强化真实持久化断言，避免测试数据自带租户值与生产边界漂移
    • ✅ 写入对象租户字段根切验收 〔es-center-server-services〕
      • 重构 从生成器模板及已生成写入对象移除租户字段，删除控制器覆盖注入与生成器残留，切断请求数据进入认证租户写边界的旁路
      • 设计 澄清租户身份注入与业务数据投影的例外边界，修正清理清单并完成根切验收，避免误伤合法读路径
  • 8-23：候选交互韧性与 Dashboard 数据页脚手架
    • ✅ Talkgroup 候选查询与双向绑定交互收口 〔es-center-server-web-app〕
      • 排障 释放候选分页卸载时的在途请求锁，恢复 React 严格模式重复挂载后的首轮请求
      • 重构 抽出通用候选结果骨架，统一群组侧与设备侧的桌面表格/移动列表、加载、刷新、错误保留、选择和新增反馈
      • 测试 补齐刷新失败时保留结果的错误描述，避免共享骨架掩盖可恢复请求失败；四组分页与绑定测试覆盖严格模式回归
    • ✅ Dashboard 数据页脚手架分阶段落地 〔es-center-server-web-app〕
      • 重构 先以电池资源页与服务器页试点 KPI、校验分页、排名列和表格壳，再批量迁移设备、存储、上传、告警等五页与总览 KPI
      • 重构 在线排名页和总览排名预览统一复用分页、表格壳与排名列工厂，同时保留预览卡页数及首次失败语义
      • 实施 删除开发环境重复的辅助主服务地址，并归档已完成的镜像骨架与数据页脚手架执行入口

其它工作

• 目标: 记录日常杂项工作、协作沟通等事务
• 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
  • 📌 以往已自测工作不再重复，详情请查看上周及上月报告
  • 17 日
    • ✅ 协作 git → svn 源代码同步
  • 18 日
    • ✅ 实施 最新版本部署到 zxs-test 服务器：最新程序编译 → 制作 docker 映像 → 制作升级程序 → 上传服务器 → 升级部署
    • ✅ 排障 排查 device/{deviceNo}/webrtc/deliver/v1 及 device/{deviceNo}/webrtc/telemetry/v1 主题回复消失的问题
  • 21 日
    • 发布验证闭环
      • ✅ 实施 滚动部署最新版本到 zxs-cs 服务器：程序编译 → 制作 Docker 镜像 → 制作升级程序 → 上传服务器 → 升级部署，并根据验证结果迭代
      • ✅ 测试 在 zxs-cs 服务器验证近期改进：
        • 旧设备 webrtc retrieve/telemetry 主题回复恢复（18 日线上排障根因修复）
        • MQTT 通道契约切换：设备上报经 mqttSourceTopic 统一盖章、平台直通白名单替代宽前缀兜底，消息收发正常
        • MQTT → JMS 防 reply topic 回环：iot/v1 直通族 retrieve 回复与 Janus 转发入口对 reply 主题与来源相同即丢弃，设备消息不再回流重复转发
        • 新增 WebRTC 专属通道族：设备走 server/center-server/webrtc/v1/retrieve 与 /telemetry 上报、/forward/janus/to 与 /forward/janus/admin/to 转发正常
        • 旧 web-ui 通道与 server/center/ 旧前缀退役后，Web 界面设备控制回归正常
        • 设备在线状态显示正确（平台模拟 retrieve 不再把断线设备标在线）
        • 对讲界面请离设备成员后，被请离设备收到离开通知并退出
        • 对讲界面新增功能回归测试：麦克风电平分段条与发话状态环声驱动效、界面文案中英切换
      • ✅ 排障 根据测试结果持续修复问题
    • ✅ 实施 zxs-cs 验证通过后，同一版本已部署到 zxs-test 服务器 〔es-center-server-build〕