2026年08月10日

内容截止日: 2026年08月16日

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

中心服务平台 - 功能完善

• 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
  • 以往已完成的工作不再重复，详情请查看上周及上月报告
  • 〔工作量〕es-center-server-services 131 次（设计 122 · 代码 9）· 代码 +2.5k/-0.8k ｜ es-center-server-web-app 91 次（设计 29 · 代码 62）· 代码 +34.5k/-20.8k ｜ es-center-server-install-app 1 次 ｜ es-ext-doc-website 12 次（设计 11 · 代码 1）
  • 〔方法论〕状态与异步反馈统一 ｜ 成熟库优先、稳定性>安全>性能 ｜ 契约先行的 ICE/PTT 集成 ｜ 固定版本审查与独立对抗复核 ｜ 顺序优先的 Loop 执行
  • 8-10: 视觉对齐与在线状态
    • ✅ 对讲界面完成视觉验收，在线状态读写统一到一个入口 〔es-center-server-web-app〕
      • 实施 正向/反向设备绑定、房间准备度工具栏、语音恢复、成员与详情按设计稿逐项再对齐。
      • 测试 浏览器侧视觉合同的静态审计验收完成，页面呈现与约定逐项核对。
      • 设计 品牌竞争力专项覆盖在线状态、响应基线、状态语言、房间控制、异步反馈、集成验收六面；冻结响应基线与阈值，供后续变化对照。
      • 实施 新增空间范围的在线状态 store（集中存放状态的模块），随后将读写集中到在线状态适配器。移除分散的协调器与查询模块，各处接入同一入口；状态语言与图标同步统一。
    • ✅ PTT 设备集成指南交付，主流程与验收边界写清 〔es-center-server-services〕
      • 评审 记录 Q1～Q27 grilling（逐条追问的设计评审）决定，核对设备对设备的 PTT（按键对讲）链路。
      • 设计 指南串联 MQTT（设备消息协议）、JMS（服务间异步消息）、Janus AudioBridge（音频会议插件）、参与者同步、可靠性与验收清单，供孙工设备联调使用；Normal 转发边界限定为合法 JSON 对象内原文。
  • 8-11 ~ 8-12: 房间状态与界面密度
    • ✅ 房间就绪、处理步骤和重试状态可见，等待反馈统一 〔es-center-server-web-app〕
      • 实施 新增房间主状态与「准备度」组件，精炼无线电控制布局和动效；直接呈现处理步骤、重试与加载状态。
      • 实施 工作台与房间加载加固，编辑器、反向绑定和辅助选择器共用加载帧与请求反馈，刷新行为同步调整。
      • 实施 暴露信令与媒体调试日志，生产构建保留调试输出。
      • 实施 补移动端 Shell（应用外壳）的可访问名称，清理已验证的遗留代码，并完成在线状态适配器接入。
      • 测试 集成验收完成，覆盖移动端外壳、遗留代码清理及在线状态适配器。
    • ✅ 信息按需展开，工作台卡片与入口更紧凑 〔es-center-server-web-app〕
      • 设计 可用性打磨、紧凑工作台卡片与中央入口分别形成规格和实施票，明确渐进披露、扫描路径、编辑器/绑定流程和房间控制层级。
      • 实施 渐进披露（先展示主干、按需展开细节）接入工作台、编辑器、侧板、房间及候选结果；扫描路径与入口、双向绑定流程同步打磨。
      • 实施 房间控件层级精炼，卡片信息与操作收拢，密度随容器宽度调整，工作台房间卡片布局继续精炼。
  • 8-11 ~ 8-12: ICE 与翻译发布
    • ✅ 设备拉取对讲配置时可一并获得 ICE 建连参数 〔es-center-server-services〕
      • 评审 grilling 核对 ICE（网络建连所需的 STUN/TURN 配置）的获取协议及分支失败边界。
      • 设计 ICE 获取方案与设备指南同步完善并发布实施票；主动 PTT 刷新不携带 TURN 凭据。
      • 实施 PTT retrieve（拉取）按精确小写 ptt/ice 项独立或组合返回当前配置，复用 WebRTC 转换函数。组合请求任一分支失败只返回一个错误信封，不泄露部分数据；消费者同步更新。
      • 测试 补齐独立与组合请求、分支失败的组合测试。
    • ✅ i18n 有效翻译统一发布，缺失翻译改为批量摄取 〔es-center-server-services〕
      • 设计 i18n（多语言）缺失翻译以租户、语言、命名空间和 key 四维自然键（唯一识别词条的组合）判重，形成批量摄取与有界处理方案。
      • 实施 跨租户读取全部有效翻译，从同一稳定视图发布文件与 Cache（缓存）。
      • 设计 BMC（采集工作站）同步记录增量 UPSERT、每日全量对账和时间戳问题。
      • 重构 用成熟库有序二维表表达翻译视图，替换手写嵌套 map 与排序；删除无生产调用的 AtomicLongMapPlus 包装器。
      • 实施 数据库批量查询/插入替代 BloomFilter 单条判重，处理最多 20 批、空批提前结束。缺失摄取与完整视图发布统一到六秒轮次，每小时脏数据清理保留，旧 TranslationGroup（翻译分组对象）删除。
      • 设计 修订发布器 JMS 规格，规定唯一生产调用入口；脏清理只有成功删除非零行才投递发布触发，零行或失败保持静默。
      • 重构 发布逻辑统一并重命名为 TranslationViewPublisher（翻译视图发布器），缺失轮次、脏清理与 data-sync 导入共用入口；JMS 串行化及更广消费者治理留给后续任务。
    • ✅ 成熟库优先的简化方案与选型索引建立 〔es-center-server-services〕
      • 审查 按「稳定性>安全>性能」复核架构问题，排除缺调用链证据的静态误报；短信等待超时只提出建议，安全改动追调用方、性能改动先测量。
      • 设计 盘点 Guava、Lombok、Apache Commons 已有能力，形成窄范围简化方案与实施票；选型索引区分自动采用和新增依赖审批边界。
  • 8-12: 后台任务与产品文档
    • ✅ 四个 Janus 上游端点交给独立后台执行入口 〔es-center-server-services〕
      • 设计 JMS 分离任务明确 listener（消息监听器）提交任务与后台完成是两件事；规定有明确名称的虚拟线程执行器、失败日志与测试边界，接受 at-most-once（最多处理一次）及进程退出时任务丢失。
      • 实施 PTT Normal/Admin 与两条 legacy Janus 上行任务交给既有 jmsTaskExecutor，listener 提交后立即返回，原文路由与服务端 admin secret（管理密钥）合同保留。
      • 测试 完善可控执行器及失败边界测试。
    • ✅ 安装、升级和上传入口同步到本次发布物 〔es-center-server-install-app〕
      • 实施 部署脚本、环境变量、构建说明版本号统一；主服务、设备服务、Web App 镜像及各目标构建、安装、升级、上传入口由 08-04 推进到 08-12 发布物。
    • ✅ 2.0.1 安装手册与更新日志交付，英文镜像待同步清单清零 〔es-ext-doc-website〕
      • 设计 2.0.1 更新日志补构建版本说明，区分语义版本、国内/国外版与内部构建 tag。
      • 实施 项目 Agent 配置和协作说明纳入版本控制。
      • 设计 安装手册按准备、快速安装、特殊情况、附录整理步骤，核对防火墙端口与 .env 母模，硬件下限纠正为 4 核 8GB。
      • 设计 英文镜像按产品域 × P1/P2 规划 9 张票：center / collection / net-body-camera 的 API 与 guide 逐域英文化，center 的 change-log 与 development-manual 同步补齐。国外版裁剪国内地图及语言切换说明，中文空骨架保持相同深度。
      • 设计 采集服务器完成 7 份 API、7 份手写 OpenAPI（接口说明文件）及 9 份 P1 Guide；执法记录仪完成 7 份 API、11 份手写 OpenAPI 及 8 份 P1 Guide；中心服务器 P2 补齐 8 份 change-log 和 14 份 development-manual，按中文源的国外版规则逐页镜像。
      • 审查 主代理纠偏执法记录仪 API 镜像的子代理偏差，核对手写 OpenAPI、导航和多语言收尾。
      • 测试 verify-en 核对待同步清单从 76 清到 0，en 站达到 zh 国外版镜像终态。
      • 实施 部署服务器地址与凭据更新。
  • 8-12 ~ 8-14: 固定版本代码审查
    • ✅ 冻结审查按模块铺开，结论与可重复证据对应 〔es-center-server-services〕
      • 设计 frozen baseline audit（锁定代码版本再逐模块审查）固定 BASE/END、路径唯一负责人、证据层级和报告格式；问题、计划与日志模板同步对齐。
      • 设计 发布 49 张审查工单，配所有权清单、预算、阻塞 DAG（依赖关系图）与独立对抗复核门禁。工单 02–49 的基线路径全集及报告 schema（字段格式）初始化；执行审查逻辑的 workflow 从证据类改为主审输入。
      • 审查 逐模块审查通用记录领域、对讲群组聚合 API、设备基础数据、群组设备关系、AudioBridge 生命周期、Janus WebRTC ICE 与路由转发、设备目录/分享/外设、固件分发、采集基础设施拓扑、IoT 检索控制、租户与组织生命周期、用户联系人/登录、安全 HTTP 边界、权限访问、翻译摄取/发布、运行配置/启动，覆盖约 20 个模块。
      • 审查 MQTT 连接状态、Meilisearch 遥测管道、TalkGroup 提交后 PTT、数据库迁移触发器单独复核；补齐生成器、设备审查可复现性和冻结终点完整性证据。
      • 审查 员工文件与凭证、参考配置、公共合同、运行时执行器、构建工具、Spring 框架装配补齐；翻译、安全 HTTP、权限、登录、Meilisearch/MQTT、固件、采集拓扑、设备目录、AudioBridge 及 Janus ICE/转发高风险证据再验。
      • 审查 区分静态 SQL/XML、Mock 测试和真实数据库/设备证据。复验中修正登录可达链、软删除密钥、JSON 尾部合同、测试统计及输入归属，真实环境缺口继续保留。
  • 8-12 ~ 8-13: Loop 执行体系
    • ✅ Loop 执行合同定稿，顺序与独立复核要求分开写清 〔es-center-server-services〕
      • 设计 新增 Loop Engineering（循环工程）指南，把 AI 工作组织为逐步执行、逐步检查的循环；/goal 管跨轮继续，/implement 管单票 TDD、review 与 commit 纪律。
      • 设计 顺序优先、编码 11 条契约、执行模式路由、日常操作和异常退出规则补齐。移除并行专用 slot 与过度承诺，主/子 Agent 入口统一，临时复盘解除模板依赖。
      • 设计 subagent（子代理）治理拆为上下文新鲜度与可证明的身份隔离两轴。一般新会话要求前者；对抗复核要求真正独立会话，并加入契约审核硬门禁。
      • 设计 执行契约经 finalize / tighten / rebuild / approve 多轮修订、重建和批准，最终两份合同进入可采用状态。
  • 8-13 ~ 8-14: 缺失翻译与性能基线
    • ✅ 缺失翻译持久保存、批量上报，包体组成建立对照 〔es-center-server-web-app〕
      • 设计 缺失翻译的捕获、保存、批量受理和定时移交形成工作流；架构计划与日志标准同步建立。
      • 实施 用持久 store 和单并发队列按确定顺序保存捕获结果，再批量移交已接受词条；根部 reporter（上报组件）定时执行，离线跳过并防并发，对齐异步处理标准。
      • 实施 bundle（前端打包产物）分析按开关启用，只分析客户端，避免构建阶段覆盖报告；gzip 产物在 manifest（构建清单）落盘后生成，失败即停止，不据此宣称弱网指标提升。
      • 设计 性能测量面固定为已登录、Nginx 提供编译产物的测试服；localhost 只作开发对照，旧测量基线失效。
      • 测试 建立并刷新 bundle 组成基线，确认体积大头是生成物，不属于业务代码；如实保留历史格式失败，未把各项门禁写成全部通过。
  • 8-14: 实时链路与工程门禁
    • ✅ 空占用者 ID 的 P2P 卡顿修复，MQTT 日志集中到边界 〔es-center-server-web-app〕
      • 实施 P2P（点对点视频）状态却没有占用者 ID 时显示独立过渡态，持续请求推动恢复；只有空闲或本会话占用时挂载播放器。Janus/P2P 事件收发合同同步对齐，MQTT 发布可靠等级调整。
      • 重构 MQTT 上下行原文集中到客户端收发边界，取消子路由重复日志；全部已订阅下行统一分发，旧在线保活发布移除。Talkgroup 调试半边清理，WebRTC 专项日志在本日仍保留。
    • ✅ 提交前检查与架构巡检建立，历史格式基线完成统一 〔es-center-server-web-app〕
      • 实施 Oxc 历史格式失败先建立增量基线，新增模式检测、pre-commit（提交前检查）与格式门禁；生成声明停止跟踪，gzip 构建产物生成加固。
      • 重构 全仓纯格式统一完成，删除临时基线例外。
      • 测试 核验应用代码 token 和 JSON 值不变。
      • 设计 架构健康巡检只在显式调用时检查固定版本，复用增量禁令检测口径；治理存量债按业务触发，不启动全仓补测试或主动依赖减法。
      • 审查 建立并修订巡检基线、文档时效与代码主张，校正发现数量；保留一次无文件差异的空提交，不据标题推断实际改动。
      • 实施 校正巡检验证器，本地 Agent skills 同步更新。
    • ✅ PTT telemetry 上报方案定稿，实施任务拆出 〔es-center-server-services〕
      • 评审 在 grilling 中核对 telemetry（设备运行数据上报）的短窗口、单向双 topic（消息主题）和离线边界。
      • 设计 ADR 写定设备连接后短窗口单向上报版本、复用状态刷新与缓存的方案；兼容两个 topic，不改共有离线逻辑。实施拆为上报链路与旧 keep-alive 待废弃标记两项，旧行为不在此删除。
  • 8-12 ~ 8-16: 审查汇总与裁决
    • ✅ 覆盖账本通过检查，四类跨域候选完成独立复核与裁决 〔es-center-server-services〕
      • 审查 补设备领取/归还、状态快照、Dashboard、数据同步、订单产品及瞬态副作用报告，再按业务数据、身份消息、设备实时、平台运行四组汇总候选。
      • 审查 覆盖账本（逐路径是否已审查的台账）检查路径、候选与来源守恒。五份报告的风险维度不一致先使门禁失败，逐项修正后才关闭；未覆盖项不会被构建绿灯掩盖。
      • 测试 在精确冻结 END 隔离工作树执行全量 Gradle（Java 构建工具）验证与复验，构建和测试保持绿灯。whitespace（空白格式差异）单独保留失败，真实环境 E2E 未验证。
      • 审查 四组对抗复核纠正过度合并、失效事实及漏扫项；跨域裁决完成，覆盖完整性门禁关闭，最终结论报告留待下周发布。
      • 设计 异常合同、文档/测试真值优先级、接口分层与规范治理写入 ADR；直接执行权限与上下文预算边界明确，防止旧流程状态无授权暂停单票。
  • 8-15 ~ 8-16: 请求入口与进房时序
    • ✅ 请求定义移到 API 层，架构账本按实际验证更新 〔es-center-server-web-app〕
      • 设计 建立架构改进 backlog（待办清单）与 ADR，校准测试范围、API 残留和依赖事实；旧巡检票按裁决标为 wontfix，历史结论保留。
      • 重构 Dashboard（数据看板）概览及子页面请求移到 API 层，静态字典与轨迹演示请求分别迁入对应模块；复用既有端点，保留参数、响应及页面错误反馈。仅注释的回放脚手架删除，mock API（模拟接口）文件命名统一。
      • 测试 API 聚合票关闭，账本记录机器验证与手工冒烟未执行的边界。
    • ✅ 进房减少串行等待，ICE 缓存命中不再等配置回包 〔es-center-server-web-app〕
      • 重构 PTT 语音门控和 Janus 会话保活分别抽出所有者，主 hook 保留稳定委托；观察一个迭代，修复频率未下降就停止机械拆分。
      • 实施 ICE trickle（逐步发送建连候选）首批攒批，Janus create 与 ICE 查询并行启动；joined 和配置回包均可触发 WebRTC，但守卫防止重复启动，阶段超时继续区分原因。
      • 实施 ICE 配置按用户名 × Janus 编号持久缓存，命中即用并后台刷新；损坏回退未命中，迟到回包不重建连接。StrictMode（React 开发期重复挂载检查）入口改为仅开发启用。
      • 重构 Vite（前端构建工具）代理超时统一，移除未生效配置与 AutoImport（自动导入）单文件特例。
      • 测试 核对所有权合同、进房时序、缓存隔离和损坏回退；用户实测及机器验收结果记录在案。
      • 设计 并行编排、缓存和工具链不设业务模块例外写入 ADR；mock API 命名规则定稿。
  • 8-16: 对讲整改规则
    • ✅ Talkgroup 审查完成，错误与反馈处理开始整改 〔es-center-server-web-app〕
      • 设计 先规划四分片、全局及汇总三级审查；HTTP 与 body（响应正文）两层异常合同、ADR 生命周期与抽取门槛写成规则。
      • 审查 完成全量审查并形成 blocker 0 的处置共识，记录维护者逐项裁决。
      • 设计 依据裁决开出 16 张整改票。
      • 设计 region（职责分区）、fire-and-forget（发后不等待）补偿、ICE 同步缓存、测试 DEBUG/生产 ERROR 手动日志流程、移动/桌面触控目标与 destructive（破坏性）实时挂断/离开例外分别明确。
      • 实施 fetch（网络请求）封装增加 softFail（局部降级处理）的 opt-out（退出默认处理）开关，body 合同放宽；业务拒绝直接返回，技术失败保留调试摘要，不进入全局错误。
      • 重构 feedback（请求过程反馈）三套实现统一到父级；软失败判定、翻译与呈现统一，extraData（返回附加信息）的 message 按翻译 key 或原文两态处理。
      • 测试 补时序合同与真实 i18n 翻译测试，核对阶段推进、切换重置及卸载清理。
      • 设计 拆票上下文预算统一为 512k/640k 双线，明确它们是防注意力衰减的工程界限。

其它工作

• 目标: 记录日常杂项工作、协作沟通等事务
• 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
  • 📌 以往已自测工作不再重复，详情请查看上周及上月报告
  • 10 日
    • ✅ 协作 git → svn 源代码同步
    • ✅ 协作 与孙工沟通设备对接平台，明确我方需提供详细对接文档
  • 11 日
    • ✅ 协作 帮孙工解读在理解对接文档时碰到的问题
    • ✅ 协作 核对绍工反馈的采集服务器对接本平台 api 的错误数据, 应对: 使用 ai 生成详细对接文档提供给他, 并指出调用 api 传参错误
  • 12 日
    • ✅ 实施 最新版本部署到 zxs-cs 服务器: 最新程序编译 → 制作 docker 映像 → 制作升级程序 → 上传服务器 → 升级部署