2026年09月07日

内容截止日: 2026年09月13日

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

中心服务平台 - 功能完善

• 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
  • 以往已完成的工作不再重复，详情请查看上周及上月报告
  • 〔工作量〕es-center-server-services 92 次（设计 21 · 代码 71）· 代码 +14.2k/-3.5k ｜ es-center-server-web-app 75 次（设计 22 · 代码 53）· 代码 +9.4k/-3.2k ｜ es-center-server-install-app 84 次（设计 20 · 代码 64）· 代码 +1.1k/-0.8k ｜ es-ext-doc-website 33 次（设计 25 · 代码 8）· 代码 +0.2k/-0.1k ｜ es-center-server-build 4 次 · 代码 +0.1k/-0.1k
  • 〔方法论〕契约先行 ｜ 终态优先 ｜ 取证先行 ｜ 先复现后修复 ｜ 精确对账 ｜ 失败关闭 ｜ 稳定优先于性能 ｜ 有条件放行
  • 9-07 ~ 9-08: PCM 数据迁移修复与人工交接
    • ✅ 提交后回调异常不再误报失败 〔es-center-server-services〕
      • 排障 修复 PCM（目标租户）数据迁移中提交成功仍报失败的问题。数据库提交后执行的收尾回调一旦报错，原来会把整次操作误报为失败。现在普通回调异常只记安全日志，后续回调继续执行，已成功提交的数据绑定不受影响；立即执行、异常传播、中断标记三条原有语义不变，Error（严重运行错误）继续传播。
      • 测试 为修复补合同测试，覆盖四种场景：回调逐个继续执行、批量逐项处理、安全日志、PostgreSQL（数据库）绑定故障。此轮全仓 1382 个测试零失败，其中 21 项因外部集成门控跳过；另有 188 项启用集成的定向回归全过、零跳过。
      • 重构 代码复审发现三个测试文件重复定义同一批常量（故障文本、日志字段、测试设备、提交事件），统一收口到一处；注入的故障与断言结果不变。
      • 审查 登记 13 项验收证据：五个调用点逐一核对、修复前失败与修复后通过的对照、真实 PostgreSQL 验证、清理后零残留、复审无遗留问题。
      • 设计 边界写入 ADR-0068：提交成功后的普通异常一律隔离、不向调用方误报失败；不走事务的立即执行仍按原样抛出异常。
    • ✅ 设备转移时的一段冗余数据库检查下线 〔es-center-server-services〕
      • 重构 设备归属转移原来每次都扫描数据库列结构是否匹配（内部叫「结构巡检」）。按 ADR-0067 的决定下线：转移流程改为按已发布的结构执行。删掉三个 SQL 公用表表达式（命名的临时查询结果）、三处更新门禁、贯穿 SQL 与 Java 两层的结构匹配标记；三项清退内容、业务行数对比、新建投影的事务约定全部保留。
      • 测试 原来专测列结构漂移的用例一并退役，换成公开绑定入口的真实数据流验证——路由行数不匹配即回滚。定向 25 项全过，全仓 1382 个测试保持零失败。
      • 审查 登记 12 项验收证据：删除范围逐项核对、各轮测试汇总、清退与回滚证据、全库检索确认巡检标识零残留、规范与实现两条轴复审零发现。
      • 设计 决策记录在 ADR-0067：数据库结构变更统一做兼容性评估，不再每次绑定都扫描列结构；离线结构发现与迁移资格检查两处继续保留。
      • 设计 原迁移票状态回写完成，补记 ADR-0067 的取代关系；三项清退、事务与行级对账继续有效。
    • ✅ PCM 迁移工具五票修复完成，交接人工执行 〔es-center-server-services〕
      • 评审 汇总 Java、Python 两条轴的复审证据，确认四个行为缺陷：投影漂移漏检、多表 UPDATE 行数错位、空模型被错误拒绝、等价组织引用没有改写。按用户确认，迁移方式收敛为「导出文件、本地准备一次、人工执行 SQL」，登记五张修复票。
      • 排障 修复漂移漏检：库存、全租户投影、固件与冻结数据逐列做多重集合比对（不看行序，但保留重复次数），预检、无变化、精确回滚三种边界闭合。新增隔离 PostgreSQL 回归，独立核对 23 张表、执行 60 次迁移 SQL。
      • 排障 修复逐表 UPDATE 计数错位与空模型的来源迁移；等价组织迁移改用迁移前的完整原始行精确恢复组织引用——行数碰巧相等也不再放过旧映射漂移。
      • 实施 准备步骤收敛为一条离线命令，执行交给人工：默认只输出脱敏演练摘要；包内 SQL 带哈希、资格单独绑定，防止手抄错用；提交结果不明时先只读核对数量。
      • 审查 五票逐一记录交付证据：两条轴复审零发现、78 项套件回归、144 次生成 SQL 的执行计数、隔离库零残留。
      • 设计 工作流说明精简，保留领域、工单、分诊规范入口与拆票预算正本。
      • 实施 批次入口切到修复票，使用执行器默认 Codex 后端与实现指令。
      • 审查 Java/Mapper（数据库映射层）复审记录保留当时尚未闭合的正向 App HTTP 冒烟检查，不用后续局部验证替它补签。
      • 测试 单会话、串行限速与连接采样要求接入后续修复；144 次 SQL 分为 88 次成功和 56 次预期拒绝，52 次连接采样峰值为 1。
      • 实施 人工交接保留客户端与日志各自退出码；28 份包、178 次 SQL 和 68 次单连接采样记录组合输入验证，生产新产物仍由操作员认证。
    • ✅ 团队管理入口权限补齐，演练目标显式登记 〔es-center-server-services〕
      • 实施 团队管理角色此前进不了 Janus（音视频网关）页面。补齐页面入口与更新权限后，按模板初始化的角色可以直接进入页面编辑配置。
      • 实施 支持把演练服务器和目标库登记为测试目标：按主机、精确库名、集群身份显式登记；未登记的目标一律拒绝，防止误连维护库、共享库或身份不符的库。
  • 9-07 ~ 9-08: 共机资源预算与恢复规则
    • ✅ 2c8g（2 核 CPU、8 GB 内存）共机配置完成，生产效果待人工验收 〔es-center-server-install-app〕
      • 设计 给实施票补齐背景：双 PostgreSQL（数据库）、Pgpool（数据库代理）与两个 Java 服务的资源约束、预算和验收标准；生产部署与效果验收留待人工安排。
      • 实施 定下两个 Java 应用的堆内存与容器内存上限，限制两个 PG（PostgreSQL）节点的资源与 Pgpool 连接并发。之后改为按容器限额的百分比堆，撤掉显式数据库调优、保留容器上限。
      • 设计 新增 2c8g 配置说明：五个容器预算合计约 4.65 GiB，名义剩余约 3.35 GiB。文档明确区分「预算改进」与「尚未验证的生产效果」。
      • 设计 接入本地工单规范与双端共 37 项技能，并记录容器限额、镜像默认参数的当前方案。
      • 实施 发布示例、构建部署脚本与操作记录的版本引用统一到 20260907 轮次。
      • 设计 2c8g 方案先固定双应用堆与数据库调优，再按容器百分比堆撤下数据库覆写；撤销项含原 WAL（数据库写入日志）与复制参数，复制兼容和生产效果仍待人工验收。
      • 实施 发布包引用先后为 202609071617、202609071811，镜像保持 20260907 批次。
    • ✅ 全部服务配上内存预算，新增健康检查和异常退出重启 〔es-center-server-install-app〕
      • 实施 26 份 Compose（容器编排配置文件）里 20 个服务全部配上内存预算，修正 Artemis（消息中间件）的堆大小；新增 26 个健康检查，业务服务异常退出时自动重启。
      • 重构 统一服务属性顺序、日志配置移到末尾；模型逐字节等价，行为不变。
      • 设计 资源预算、恢复边界与属性排序的依据写进说明文档。
      • 设计 Compose 审查验收与包版本同步的票面回写完成。
      • 实施 包版本推进到 202609082047，部署脚本与构建安装说明同步替换。
      • 设计 单组 15 容器预算为 6.5 GiB，其中核心五容器 3.75 GiB，按整机 8 GiB 名义剩余约 1.5 GiB。健康检查只观察，on-failure（异常退出重启）与 launcher（启动与兜底服务）分工明确。
      • 测试 26 份 Compose、30 个服务定义完成离线验收；属性与换行保持，JSON 模型逐字节等价。此处不表示生产负载效果已验收。
  • 9-07 ~ 9-08: 固件交付记录与中文工作流
    • ✅ 固件文件入口规格收尾，工单流程改中文直读 〔es-center-server-web-app〕
      • 设计 固件头 intake（统一接收文件对象的入口）的父规格补上终态与交付证据，消除「实施票已交付、父规格还挂着待实施」的状态偏差。
      • 设计 本地工单流程精简为直接可读的中文操作说明，寻路状态统一；领域文档指引收敛到单一布局，探索与演进动作统一从 ADR 分类入口进。
  • 9-09: 模拟生产登录与连接池
    • ✅ 修复首次管理员登录的消息缺陷 〔es-center-server-services〕
      • 排障 首次管理员登录时，保存账号的消息缺少执行租户，登录流程走不通。修复后仅为首次管理员补建系统执行租户，消息正常驱动账号保存，外层上下文恢复；缺租户的消息仍返回业务结果并留一条安全诊断。新增 18 项展开回归覆盖。
      • 设计 连接池约束回写票面；登录修复的事实核对与单票拆分依据归档。
    • ✅ 连接池降占用，本地环境指向内网 〔es-center-server-services〕
      • 实施 两个服务的连接池下调常驻与峰值占用；本地依赖地址统一切到内网演练主机，库名改为参数配置。
      • 实施 MQTT 入站日志按语义分级：契约外的预期记录与真实处理失败用不同级别，生产环境既不刷屏也不漏报。
      • 实施 默认池最小空闲由 6 降为 1、最大活跃由 12 降为 8，两服务合计上限由 24 降为 16；开发档最小空闲由 3 降为 1。依赖配置的敏感凭据留在本地。
    • ✅ 开发环境整组切到模拟生产主机 〔es-center-server-services〕
      • 实施 开发环境的依赖整组切到模拟生产主机，库名与凭据同步；非生产环境放开初始化 DDL，保持与生产同构的初始化。演练目标必须显式登记，旧主机与库名前缀不再被隐式放行。
      • 测试 修复错误值用例的前置条件：先用集群别名构造可用基线跑通预检，再覆盖目标断言。
      • 设计 模拟生产交付记录含 32 项离线回归、两轮固定命令模拟与 8 项文档边界检查；真实 SQL、App 与资格验证仍交操作员执行。
    • ✅ 测试主机称呼统一，文档不再各叫各的 〔es-center-server-services〕
      • 设计 21 份文档与 7 张票面里的测试主机引用统一成一套称呼，包含票面、演练证据、runbook 操作手册与 ADR。
      • 测试 SQL 集成测试的 3 处缺省主机由 106.55.28.88 改为 192.168.1.53，显式环境变量仍优先生效；测试源码编译与格式检查通过。
      • 实施 开发环境锚定内网演练主机并同步 Nacos 凭据，保留演练库名切换示例。
      • 设计 本地演练修复准备与迁移交接草案归档（保持待确认）；登记操作员入口票面与阶段验证进展；模拟生产批次交付回写。
      • 实施 批次入口切到已完成的管理员登录修复工单，只调整工作清单，不重新执行该批次。
      • 实施 Python 字节码缓存加入忽略清单，避免误入库。
  • 9-09: 容器限额与构建环境
    • ✅ 七个服务上调内存限额，修一处批量导出崩溃 〔es-center-server-install-app〕
      • 实施 按运行余量上调 7 个服务的内存限额，补齐 Pgpool 与 rnacos 参数；主服务与设备服务提额后，运行期被杀退出的风险降低。
      • 排障 生产批量导出会触发并行查询、耗尽共享内存导致故障；给 PG 节点加共享内存上限后修复。
      • 实施 升级包补上 Redis（缓存数据库）内存变量，取值与安装包统一。
      • 实施 2c8g 资源预算文档的限额示例同步更新，并如实标注预算表滞后——避免误读成已生效配置。
      • 审查 共享内存修复按实际 diff 记为 512m；提交正文的 1g 写值差异已登记。2c8g 预算表后续约 11.3 GiB 已超过整机 8 GiB，含义改为单容器隔离上限，不视作整机容量已证实。
    • ✅ 构建临时目录迁出 /tmp，接入新测试机 〔es-center-server-install-app〕
      • 实施 构建与开发脚本的临时目录从 /tmp 迁到 /var/tmp，避免系统清理临时文件打断构建；新增内网新测试机的升级与安装脚本。
    • ✅ 包版本一日推进三轮 〔es-center-server-install-app〕
      • 实施 包版本连续推进三轮（202609082108 → 202609091517 → 202609091900），部署脚本与文档逐轮同步；服务镜像标签推进到 20260909 构建批次。
      • 实施 构建收尾恢复四站点全量上传；构建日志示例随批次推进。
      • 实施 四站点上传目标完整保留：zxs、zxs-ca、zxs-hs、zxs-cs。构建失败示例更新到 202609091530，脚本 local 用法问题仍未修复。
    • ✅ 票面回写与忽略项 〔es-center-server-install-app〕
      • 设计 三轮包版本同步的票面回写，含核对基线订正与计数口径扩展。
      • 实施 AI 助手本地配置与工作目录加入忽略。
  • 9-10: 迁移人工验收与默认群组决策
    • ✅ PCM 演练收尾，放行改为人工验收 〔es-center-server-services〕
      • 设计 操作员入口的验证记录与 13 份脱敏证据归档：101 项离线回归、19 项真实 PostgreSQL、10 项初始化边界、56 项 Java 合同，外加两轮 23 张表逐列对账。
      • 实施 执行卡（操作员按步执行的操作脚本）改为以人工演练验收放行，删除资格报告门禁——不再读取和裁决资格报告；目标登记、manifest/hash（包清单与内容指纹）及包内绑定完整性等数据保护保留。
      • 排障 一致性导出改为串行查询，绕开共享内存不足的问题；共享内存中断时保留失败目录、可从导出事务开头完整重跑。
      • 测试 保留操作员入口从只读身份核验、真实数据库回归执行中，到最终 101/19/10/56 项结果的过程；自建库清理完成，SSH 排查曾按用户指示停止。
    • ✅ PTT（按住讲话）默认群组改由设备保留，数据库迁移就绪 〔es-center-server-services〕
      • 设计 五组决策归档（默认组作用域、代码生成边界、PTT 对象合同、后端切换、删列恢复），发布三张实施工单。ADR-0069 定下方案：默认对讲群组由设备保留，平台只在一次手动推送里指定。
      • 实施 工作清单改读默认标记退场三票，按数据库准备、人工重生成、后端完整交付的顺序继续；人工票完成后才进入下一票。
      • 实施 数据库准备完成：关系父表与确认的租户子表放进单个原子迁移，退场默认列、补设备查询索引；交付 21 个真实数据库用例、备份恢复证据与人工生成手册。
      • 设计 收到维护者实际生成的退场模型，保存生成器身份与只读结构证据。当前是不可部署的中间状态，完整后端交付随后闭合。
      • 重构 DDL（数据库结构变更脚本）排序改用文件名 API 表达。
      • 设计 「语义等价时优先选直接、简洁、成熟的 API」写入编码规范。
    • ✅ 依赖地址切回内网，轮换 Nacos 密码 〔es-center-server-services〕
      • 实施 开发依赖地址切回内网测试服务器；按维护者裁决撤回批量地址替换。轮换 Nacos 管理员密码，本地登录保持可用。
  • 9-10: 前端性能取证与修正方向
    • ✅ 前端性能痛点逐项实测取证 〔es-center-server-web-app〕
      • 设计 目标是在 8 GB 服务器上支撑 500 台设备。新建前端高影响性能痛点寻路图并预检运行环境，拆成八张取证/裁决票：设备状态派生、地图 marker（设备位置标记）、设备组织树、长轨迹回放、全局活动渲染、多路播放、多语言后台成本逐项取证，区分真实样本、隔离复现与规模估算。
      • 测试 六组关键数据入库，真实样本缺口如实留档。设备状态派生的真实 14 台样本中位耗时为 112 毫秒，500 台规模的 0.22–0.32 秒为估算。
      • 测试 500 个 marker 的隔离复现场景耗时 108–286 毫秒；设备组织树的 500 台全展开场景中，整棵树重渲染约 325–489 毫秒。前三项取证留存 9 件证据资产。
      • 测试 28,800 个点在无探针条件下按时间过滤耗时 64.2–77.2 毫秒，同一数据取整约 64–77 毫秒；后段图层耗时 19.6–28.8 毫秒，每秒 8 个测量窗口均出现 long task（阻塞界面的长任务）。取证记录、5,678 行测量 JSON、Trace 摘要与复现脚本四件材料留存，真实线上轨迹样本仍缺失。
      • 测试 合成鼠标移动时，父路由每秒被更新约 34 次；因果对照为 190→6→199 次，倒计时静止渲染中位约 40.6/45.8 毫秒。58,675 行测量 JSON 与脱敏摘要留存，生产收益仍是缺口。
      • 审查 长轨迹回放保留真实样本缺口，多语言后台成本建议不列为高影响痛点；Trace（浏览器性能轨迹）自动分析失败后改用流式脱敏摘要，生产收益未补造。
      • 测试 多路播放的 4–9 路场景里，单设备回复引发全体播放器更新，渲染中位耗时 4.5/7.1 毫秒；MQTT 待办在 12 秒内从 18 增到 126。24,502 行测量 JSON 与三段复现函数留存，隔离副本保留实际订阅、回复、轮询，解码成本仍是观察缺口。
      • 审查 多语言初始化五种语言为 256,613 字节，gzip（压缩传输）后为 53,726 字节；每文档仅一个 45 秒刷新计时器，缓存命中窗口没有 React 提交。4,135 行测量 JSON、摘要、复现记录与解析脚本留存，本轮不将它列为高影响痛点。
    • ✅ 三项性能修正立项并排定顺序 〔es-center-server-web-app〕
      • 设计 三项修正补齐因果、价值与风险说明后经用户裁决：全部有改进价值，按推荐顺序执行。
      • 设计 三项分别整理成独立规格并发布实施票：全局活动监听与授权倒计时渲染隔离、多路直播设备树渲染隔离、单兵地图 marker 按需更新。
      • 实施 批次管线按确认的优先级串行指向三张修正票。
      • 设计 设备树先交付样板，再供单路改造参考；地图保留重复记录、新鲜度、按钮资格、聚合与清理语义。三项代码实施不互相伪造前置依赖。
    • ✅ 环境杂项 〔es-center-server-web-app〕
      • 实施 AI 本地工具配置与会话目录加入忽略，已跟踪技能库保持；开发环境默认后端切到测试环境。
  • 9-10: 配置生效规则与运行基线
    • ✅ 2c8g 服务纠错定路线：先纠错、后优化 〔es-center-server-install-app〕
      • 设计 建立 2c8g 服务纠错寻路图并入库十张工单，原则是先纠正失效、无效、冲突的配置，再在资源约束下提升性能——稳定优先于性能。纠错决议回写：本轮只清理无效变量和拼写修正，复杂方案暂缓；新设价值门槛「大改动必须先说明价值、风险与回退」。
    • ✅ 九份研究文档摸清 2c8g 底细 〔es-center-server-install-app〕
      • 设计 九份研究文档入库，讲清楚：Compose 与 JVM 各自的生效规则、PG/Pgpool 容量模型、Redis 配置的真实入口、基线隔离条件、JVM（Java 运行环境）容器识别不准的根因、GC（内存回收）监控方法与遥测观测点。
      • 设计 纠错候选与业务输入契约归档：认证入口、设备更新必填字段、租户边界逐项固化（配置指纹全匹配才一致），并给出测试机 JVM 的临时堆方案。
      • 测试 多轮有界采集记录测试机基线，两个 Java 容器按临时堆方案重建并做业务验证；原始记录入库。
      • 设计 配置盘点证据与采集脚本归档：安装产物的生效链、失效候选与运行态直读对照、远端采集运行清单。
      • 排障 JVM 实测容器限额为 1536 MiB、最大堆却达 6.75 GiB，定位为 Temurin 21.0.9 对 cgroup v2（容器资源限制机制）的识别失败；上游修复进入 21.0.10。临时方案显式按容器限额计算堆，Pgpool 阈值不被写成五秒旧读硬保证。
    • ✅ Artemis 内存限额上调 〔es-center-server-install-app〕
      • 实施 上调 Artemis 容器内存限额，余量留给堆外内存与页缓存；票面回写各轮调整后的当前值，已知滞后如实登记。
  • 9-11: 告警、旧客户端与默认群组后端
    • ✅ 修复 MQTT 告警失效，隔离 Janus 用例问题 〔es-center-server-services〕
      • 设计 建立修复寻路地图并发布决策票，原则是先复现、再定修复方向。
      • 排障 复现后锁定根因：无消费者告警失效，是之前下调日志级别时没同步决策边界。按现行合同恢复告警，不做整笔回滚。Janus 真实数据用例跳过的问题定性为共享数据缺失、不是缺陷：补上隔离所需的回归，只读检查改为显式启用。
      • 排障 无消费者消息告警恢复（白名单、丢弃、零发送三条合同保留）；Janus（音视频网关）必需回归在隔离 schema（独立数据库命名空间）里真实执行并补排序回归——模块 618 例中 617 通过。
      • 排障 基线实跑 54 例、1 失败：预期两条 ERROR，实际零条。只恢复无消费者告警，不回滚真实入站处理失败已升为 error 的修复；连接失败、未启开关与共享数据缺失分别报告。
    • ✅ 旧客户端认证兼容恢复 〔es-center-server-services〕
      • 实施 存量客户端依赖旧的应答形态：认证出口恢复返回 HTTP 200，业务异常消息与精确错误值保留在响应体里。两个服务的合同用例冻结响应行为，旧版 Web 回放验证通过。
      • 实施 主服务三个认证出口、设备服务五个认证与权限入口恢复旧传输；body（响应内容）里的 1000/1001、精确 error、业务 message/status/extraData（附加业务数据）保留，以 UTF-8 输出。主服务历史 advice（异常响应处理器）的 401/403 行为保留，六处设备凭据拒绝类型纠正。
    • ✅ PTT 默认群组退场：后端三侧交付完成 〔es-center-server-services〕
      • 设计 配置刷新载荷合同登记，切换恢复手册更新。
      • 实施 三个服务端各就各位：基础数据侧删掉关系默认标记字段并对齐重生成结构；主服务交付默认群组的一次性选择入口、停止写入默认标记；设备服务的 PTT 查询按本次选择返回默认组，刷新载荷统一。
      • 设计 交付回写完成，10 份证据入库：32 例数据库复验、198 例协议回归、两条轴的评审闭合。
      • 设计 自动刷新、设备主动拉取不恢复平台选择；仅平台内部 retrieve 传递本次默认组，三族 MQTT 主动拉取忽略同名参数。PTT 响应保留默认组与完整 groups（群组列表），逐组不再带 isDefault（默认标记）。
    • ✅ 连接池空闲连接 3 分钟回收 〔es-center-server-services〕
      • 实施 两个服务的连接池空闲回收改为 1 分钟扫描一次、空闲超过 3 分钟回收。
      • 设计 「动态 Map 用字符串直读」的选型偏好记录在案，并同步进成熟选型索引。
  • 9-11: 渲染隔离与初始设备巡览
    • ✅ 三项性能隔离落地，实测重复渲染归零 〔es-center-server-web-app〕
      • 重构 鼠标键盘活动与共享授权倒计时改挂到路由内的非视觉组件上。
      • 测试 开发环境六窗口对照实测，布局多余渲染降为 0。
      • 重构 多路直播设备树的搜索、筛选、统计改为独立订阅；设备行按完整显示输入复用、按生命周期淘汰缓存。这套做法成为后续改造的样板。
      • 重构 单兵地图 marker 改为按显示输入更新：图标与弹窗的输入快照只在真实变化后才重新呈现。
      • 测试 500 个 marker 的稳定轮次里，图标与弹窗的重复工作归零。
      • 实施 多路设备树结构变化时的布局动画恢复：稳定行的内容与容器分别缓存，结构签名变化才触发布局重算。
    • ✅ 新功能「初始设备巡览」交付 〔es-center-server-web-app〕
      • 设计 巡览规格定稿并发布两票。新增领域词条「初始设备巡览」：用户首次进入时，系统逐台带看设备、每台约一秒，随时可以接管；带看有明确终点，用户一动就退出。
      • 实施 地图飞行动画收尾：按最后阶段与真实落点报告到达，取消与卸载用信号统一收束；30 项公开飞行回归通过。
      • 实施 首次进入时逐台巡览有效 GPS 设备，用户可随时接管；各入口都能立即取消，并支持减少动态偏好设置。
      • 实施 取消入口覆盖地图、列表、播放、定位、追踪与底图；隔离旧访问和排队回调，保持最后设备身份并释放终态资源。OSM（开源地图底图）的自动审批限制继续单列，不扩大百度、高德的实际验收范围。
    • ✅ 三项实现的审查与收尾 〔es-center-server-web-app〕
      • 审查 三项隔离实现审查完成：规范违规 0 项；发现 1 项规格偏差（布局动画丢失），已由修复工单闭合。
      • 设计 三张工单回写，规格关闭。
      • 实施 工作清单跳过已完成的三项隔离改造，随后指向设备树布局修复与初始设备巡览。
  • 9-11: 压力基线与写后读取
    • ✅ 压测基线收口，揪出连接池配置不生效 〔es-center-server-install-app〕
      • 测试 预热、日常、高峰组合负载全部跑通，形成压力基线。
      • 排障 两个 Java 连接池的关键声明实测不生效，定位为框架版本与旧 starter（框架自动装配入口）注册方式不匹配，据此新立 Druid（数据库连接池）生效纠错决策票。
      • 设计 六份研究文档沉淀连接池与基线负载的输入；基线运行、连接池实测与授权叠加的证据入库——219 个文件按同毫秒起跑组合计量。
      • 测试 组合负载按同毫秒起跑计量，包含 TURN（媒体中继）、下载、索引授权叠加与备份恢复核对；分页 P95（九成五请求的耗时界限）超目标等边界如实记录。
    • ✅ 数据库读写一致修复：写后强制读主库 〔es-center-server-install-app〕
      • 排障 新装与升级场景启用 Pgpool 的写后读主 always 模式——同一连接写库之后强制读主库，避免读到旧数据。已发现的「写后读旧」缺陷修正，测试机确认生效。
      • 实施 清理 PG、Pgpool、Meilisearch 的无效配置入口，核验升级产物完整。
    • ✅ 版本推进与同步 〔es-center-server-install-app〕
      • 实施 包版本推进到 202609111052、服务镜像标签推进到 20260911 构建批次；版本票面与日志示例同步。
    • ✅ 构建上传改人工时机 〔es-center-server-install-app〕
      • 实施 构建收尾的自动上传改为注释停用，上传时机由人工决定；新增常用容器重启与日志速查命令。
  • 9-11 ~ 9-12: 机构 App 接口说明与发布边界
    • ✅ 机构 App 的 385 个接口调用已有交付路线与公共基础 〔es-ext-doc-website〕
      • 设计 规划执行路线：盘点全部 385 项接口调用，覆盖口径与接口模板作为可追溯的证据基线；实施拆成 15 张票（内容、复核、整合、验收）。
      • 设计 搭好公共基础：中文根目录、公共约定、15 个业务域的导航骨架，错误出口与验证边界明确。
      • 设计 基础票结案回写。
    • ✅ 技能与执行器统一 〔es-ext-doc-website〕
      • 设计 技能改为共享副本单一受控版本，双端代理规范入口统一。
      • 实施 执行器改为按票确认的循环执行，支持退出、中断和逐轮重读工作清单。
    • ✅ 九大业务域接口说明全部交付 〔es-ext-doc-website〕
      • 设计 逐域对照源码登记接口说明正本（以源码为唯一依据）：访问与工作空间 15 个操作、组织与人员 46、设备与资产 85、设备远控 13 页、对讲与音频 19 页、监看 14 页、回放与文件 6 页、配置字典与值集 60 页、公共资源与共享接口 31 页。无法发布的缺口如实标注。
      • 设计 设备远控、监看、回放与文件的缺口分别标明设备固件、采集服务器、媒体节点或 Janus 插件证据缺席。配置域记录权限串差异、仓外 JMS 消费、缓存失效与省略字段写空行为；公共资源补读 Rust Agent 源码，闭合备份和时间接口。
    • ✅ 三轮独立复核，链接零断链 〔es-ext-doc-website〕
      • 审查 三轮独立复核逐域跑全量脚本：链接零断链、JSON 全部可解析、权限声明与源码注解逐条对拍零偏差；另按当前源码重开薄页核验，修正了行号漂移。
      • 审查 身份、组织与设备资产覆盖 146 页正本、2 张 schema（共享字段模型）：964 链接零断链、399 JSON 全解析、129 项权限对拍零偏差；重开 12 张薄页，修正 4 处，补登四个业务域导航。
      • 审查 远控、对讲、直播与回放覆盖 52 页、101 个操作标识，三方一致、325 链接零断链；22 页关键缺口无漏标或误标，修正 3 处行号漂移。
      • 审查 配置与公共资源覆盖 91 页、101 个操作标识，三方一致、487 链接零断链、166 JSON 全解析；重读三仓源码，修正 4 文件的 8 处占位符与行号漂移，补强满员静默丢弃语义。
    • ✅ 发布门验收：有条件放行 〔es-ext-doc-website〕
      • 设计 错误差异覆盖索引与 App 流程整合：385 个操作全部登记归属，对账补齐无主调用。
      • 评审 最终完整性验收：操作零重复、三方一致零问题、2323 个链接零断链。结论是有条件放行——中文交付物准予发布；「全量接口契约已完成」的声明被否决，10 组具名缺口列明。
      • 设计 结案回写。
      • 审查 对 385 项调用重新核对唯一归属，656 个 JSON 全解析，331 个无英文镜像的中文文件逐项登记放行边界；不把有条件发布改成全量接口契约完成。
    • ✅ 侧边栏空标题根治 〔es-ext-doc-website〕
      • 实施 统一栏目组织，修复侧边栏出现空标题的根因；新增源码级守卫脚本，按同一套标题解析规则校验空白标题。
  • 9-12: 公共基座、树结构与历史整理
    • ✅ 基座细化的决策与工单全部就位 〔es-center-server-services〕
      • 设计 新增细化决策地图与六张决策票承接用户裁决；发布第二批细化 ADR（0070–0078），规范、索引与领域词同步。
      • 设计 发布九张实现工单与认证兼容规格（恢复旧传输形态、保留认证族的响应合同）；常用列表的免鉴权边界改用「为什么」注释标明，防止再被误报立项。
    • ✅ 九票实施完成，覆盖树、日志与权限 〔es-center-server-services〕
      • 重构 Holder Bean（框架对象的上下文持有与查找）的解析入口统一：上下文持有与查找集中收口，迁移 15 个执行器、删除旧支撑类；真实上下文回归约束发布时机。
      • 排障 修复操作日志在事务提交后漏发的问题：每条日志事实统一走既有发布入口登记，保持「提交后发送、回滚不发送」；100 项定向回归通过。
      • 排障 两个应用的数据源改用 druid-spring-boot-3-starter 1.2.27，并替换 Nacos 引入的旧 starter。每池 8 连接、500 毫秒等待、借还校验、3 分钟空闲回收与 30 分钟物理寿命统一；关闭 PS cache（预编译语句缓存）、wall（SQL 检查过滤器）及未采用的监控入口。
      • 实施 「MY」创建者范围与查询条件来源统一：两个宿主的共同判定集中收口，闭合 20 个入口，客户端权限字段清除。
      • 实施 四棵树（组织、租户、用户组、设备类别）统一展示与重算：按用途集中主键去重、范围选择、逐环节单边修正，旧祖先路径保留。
      • 重构 旧树入口改用共同构树能力、公开 API 保留；37 项树合同覆盖兼容行为。
      • 实施 缺失动作提前拒绝、判断顺序落实：五个执行入口先验证动作、再产生副作用；30 项行为回归通过。
      • 设计 本轮覆盖日志登记、MY 仅本人创建、Holder 对象查找、树拓扑、判断顺序与访问边界；个人空间免分档、采集设备常用列表对所有登录用户开放，租户与数据权限继续有效。
      • 测试 四棵树的展示不写回数据库，重算每环只断一边并保留旧祖先路径；复核 12 处展示和 4 处重算。数据权限在身份或取值函数异常时先拒绝，不能把客户端权限字段当查询来源。
    • ✅ 真实数据检查默认启用 〔es-center-server-services〕
      • 测试 按用户裁决，真实数据只读检查默认启用、允许空结果通过；裁决落入测试规范，验收记录归档。
    • ✅ 三票收尾，历史目录清理 〔es-center-server-services〕
      • 设计 用户组树端到端、旧树兼容、设备类别树三票收尾回写，修复前后对照证据归档。
      • 设计 旧基座深化地图与剩余候选票关闭，四项人工验收回写完成；已结束批次清单清空。历史任务目录清理 878 个文件，清理前完整快照存仓库外，长期文档的过程证据固定到恢复入口。
      • 协作 四项人工验收分别是跨端在线状态、设备重连拉取、Janus 恢复与跨端发布；维护者确认后才补记完成。清理前 909 文件快照逐文件校验，29 份长期文档保留 Git 恢复入口。
  • 9-12: 默认群组下发与业务文案
    • ✅ 默认群组下发打通四个入口 〔es-center-server-web-app〕
      • 实施 绑定上的默认标记移除，改用六字段入群通知；没有新字段的旧响应仍可编辑。
      • 实施 正向绑定与候选行可下发默认群组：在组合路由族内确认与请求能力，共享资格，同设备跨群组防重。
      • 实施 设备查看与管理面板可下发：反向关系与候选复用确认，只读用户也能操作，同设备跨群组防重。
      • 实施 房间设备可下发默认群组：复用已保存绑定行的确认与单设备下发，由房间共同父级协调防重。
      • 审查 核对候选刷新失败时的下发资格，修正为失败即撤销资格，防止用不可信的旧快照确认；51 条用户故事建立实现与测试的映射。
      • 审查 关闭、切换或重开界面后，旧请求不能反馈或解锁新请求；候选确认关闭要恢复焦点，反向保存只说明绑定变更，不暗示默认群组随保存生效。
    • ✅ 默认群组的合同定稿 〔es-center-server-web-app〕
      • 设计 寻路收口、五票实施计划发布。合同确定：平台不保存默认群组状态，只在手动推送时一次性指定；入群通知带六个字段。
      • 设计 实现流水线的技能名称引用统一。
      • 设计 六张工单回写。
      • 实施 工作清单切到默认群组退场与下发五票，先删旧标记、再加各入口、最后审查；不重新执行已完成的初始巡览。
    • ✅ 对讲界面全面改用业务语言（i18n） 〔es-center-server-web-app〕
      • 设计 对讲多语言寻路裁决完成，发布八票实施计划：4295 行正式映射、四张 grilling 裁决票 resolved（已解决）。新 ADR 接受业务语言边界——协议术语和内部标识不再出现在界面上。
      • 设计 i18n 文案与清扫规范收口到单一来源；传输状态调整的前端兼容共识记录在案。
      • 实施 五处音频配置名称统一按采样率区分预设；工作台的对讲状态改用业务事实表达；群组配置与正向绑定的文案校准，暂存与生效两个阶段分清。
      • 设计 三张 i18n 工单回写。
      • 设计 界面用业务对象、实际影响与可执行动作表达；在线数量、按讲与常开麦说明层级、参考容量、按采样率命名四项经 grilling 裁决。HTTP 状态后续仅改传输码而 JSON 合同不变时，前端现状兼容，无需同步改码。
  • 9-12: 容器预算与精简实机验收
    • ✅ 容器优化先收窄范围再动手 〔es-center-server-install-app〕
      • 设计 复盘后范围收窄：备份复测、大批索引门禁、请求时限、SQL 提效移出本轮。资源预算、验证路线、Druid 绑定三张决策票的决议落档。
      • 设计 Druid 绑定入口的研究与决策依据、资源预算提案与分阶段验证路线、测试机配置对齐的维护证据留存。
      • 审查 同源基线结果留存：多轮原始负载归档、遥测内容集合核对；读超时与缓存的观察缺口如实保留。
      • 测试 同源基线保存 10 分钟预热、170 分钟日常、两轮 60 分钟高峰及被要求提前停止的第三轮；保留 6 次读超时与 1063 个缓存观察缺口，294384 条遥测按最终内容集合核对。配置维护与恢复核验不等于新资源候选已经实施。
    • ✅ 容器优化八票实施完成 〔es-center-server-install-app〕
      • 设计 发布容器配置纠错与资源优化的实施规格，配七张工单。
      • 实施 新增工单批次执行器，逐轮重读清单，经人工确认启动。
      • 实施 新装与升级的两应用镜像标签推进到 20260912-druid1 纠错批次，两应用追加 MaxRAM=1536m，基数对应 1536MiB 容器限额，防止识别失败时按宿主机内存计算堆。
      • 测试 Druid 精简配置实机验收与回退交付：候选、回退、最终候选串行切换，六组业务冒烟全部通过；切换失败的现场保留为已知风险。
      • 实施 Redis、Meilisearch 的资源预算接通；JVM 直接内存与小容器预算统一，15 个容器的合计上限固定。
      • 实施 Redis 新装与升级共用 384MiB/noeviction（不自动淘汰旧键），容器预算为 1024MiB，替换此前失效的 256mb/allkeys-lru（按最近使用情况淘汰键）声明；Meilisearch 采用 1GiB 容器、128MiB 索引预算与单索引线程。
      • 实施 两应用直接内存各限 128MiB，launcher、nginx、web-app 三个小容器各限 128MiB，15 容器合计上限为 12800MiB。
      • 测试 保留数据的参数回退验证通过：Redis 仅重建自身并核对候选、原参数回退、候选恢复三阶段；Meilisearch 仅切换自身并演练原参数回退，小容器与 JVM 仅串行切换五个受影响服务。
      • 设计 Redis 预算票按精简验收结票，原长负载方案如实记为未测。
      • 设计 资源候选票证据补充，审查摘录修正。
      • 测试 Redis 核对 464 个键，Meilisearch 核对 229 个资源样本与 80 个任务；小容器与直接内存统一后，15 容器合计上限为 12800MiB。取消的长时、完整集成、性能收益和 2 核 8 GB 容量验证继续记为未测。
    • ✅ 发布标签对齐，回退路径固定 〔es-center-server-install-app〕
      • 实施 发布镜像标签恢复跟随现有自动制作制品；交付精简恢复验证——组合短测的数百次请求与消息证据。
      • 测试 精简共存与阶段回退核对：60 秒日常、20 秒高峰负载结果全匹配；四阶段的历史回退材料固定。
      • 测试 最终候选精简核对与交接：15 个容器与 27 份配置来源固定，阶段回退集合交付。
      • 测试 精简短测记录 450 次 HTTP、750 条消息及设备进程退出、搜索短暂停、身份重连的恢复；共存核对另记录 600 次 HTTP、1100 条消息、两路媒体与两份 100MiB 下载。严格 120 秒恢复门槛、8 小时与 24 小时长测均未宣称通过。
    • ✅ 本地凭据不进仓库 〔es-center-server-install-app〕
      • 实施 本地凭据目录加入忽略；工单只记录凭据的读取位置，不落库。
  • 9-13: 对讲反馈与紧凑下发入口
    • ✅ 对讲多语言余下五票完成，240 条文案逐项留证 〔es-center-server-web-app〕
      • 实施 反向绑定与默认群组的请求反馈校准：勾选、暂存、保存三个阶段分开提示；超限提示改为按实际绑定总数说明。
      • 实施 房间连接失败按来源提示：用业务描述符区分超时、服务通信、会话确认、音频、通话设置五类失败。
      • 实施 发话帮助与麦克风反馈去重：按顶部状态、发话主控、麦克风操作分工提示；成员与临时设备的请求反馈保留超时、会话恢复与部分失败设备明细。
      • 实施 多语言覆盖收敛，240 条呈现记录与逐项证据留存，核算词条集合的实际差异。
      • 测试 集成验收的浏览器流程验收完成。
      • 设计 四张工单回写，八票规格关闭。
      • 实施 保留常开麦四阶段后果与恢复步骤、超时后的旧成员与媒体状态；覆盖房间返回、复制、加载骨架和服务连接，路由词条由 577 减为 396，含共享选择器由 583 减为 399。不将源码减量解释为线上词库验证。
    • ✅ 默认群组下发入口改紧凑样式 〔es-center-server-web-app〕
      • 设计 紧凑布局规格发布，单票实施：统一六类入口的发送图标按钮，并调查全部调用点。
      • 实施 六类已保存关系的下发入口统一按钮尺寸、复用状态说明；长译文按容器宽度自动折行。
      • 设计 实施票回写，交付证据与验收状态对应。
      • 实施 工作清单将已交付的对讲多语言八票注释归档，唯一活动目标切到紧凑布局单票，不启动 runner。
      • 实施 开发环境五项端点 WEB_UI（网页）、STATIC（静态资源）、MAIN（主服务）、DEVICE（设备服务）、EMQX（消息服务器）切到内网测试机 192.168.1.53；原 test 组保留可切回，仅影响本地开发连接目标。
      • 实施 六类入口采用纸飞机描边图标：PC 为 32×32，小屏为 44×44。发送中保留名称与尺寸，禁用显示禁止光标，房间明确离线只显示一次说明。
  • 9-13: 20260913 发布推进
    • ✅ 一键构建发布链路恢复完整 〔es-center-server-install-app〕
      • 实施 发布环境的镜像标签随自动制作制品推进到 20260913，包版本引用同步 202609131224；构建后向四台服务器自动上传恢复——一键构建发布全流程可用。
      • 设计 包引用同步的票面回写，并订正一处全局替换的误伤；构建日志示例的版本跟随另在实施活动记录。
      • 实施 四台上传目标为 zxs-ca、zxs-cs、zxs-hs、zxs，构建日志示例更新到 202609131530；脚本 local 用法问题继续留待后续处理。
  • 9-13: 20260913 发布准备
    • ✅ 发布脚本两处修正 〔es-center-server-build〕
      • 实施 发布版本号票面统一回写为 20260913；发布脚本的镜像暂存路径从 /tmp 统一迁到 /var/tmp。
      • 排障 es-center-server-web-app 段的容器命令补权限前缀，避免非 root 会话执行失败；新增测试服镜像上传通道。
  • 9-13: 零售 App 接口文档交付
    • ✅ 零售 App 接口文档手册重写发布 〔es-ext-doc-website〕
      • 设计 零售场景的手册重写：四层新树 68 个文件，接口契约以后端源码为准；覆盖对账三表零差异。收录口径为 18 正本、21 引用、6 缺口、5 兼容候选；三表分别核对消费端点、general/public（通用与公共接口）归属及账号族覆盖。
      • 实施 英文镜像旧树移除、侧栏条目清理；两侧处置解耦，便于回溯。
      • 设计 零售批次九票结案、规划资产入库；终检发布门三方对账零差异，放行。
      • 设计 四层分别是入门、操作、流程与覆盖；操作含账号、个人空间设备和设备分享三域，旧字段释义吸收入新正本。英文旧树近期整体删除，未承诺同步新镜像。
  • 9-13: 对外更新日志定稿
    • ✅ 对外更新日志 2.0.1-20260913 中文定稿并同步英文 〔es-ext-doc-website〕
      • 设计 补录 2.0.1-20260824 节漏收的两条修复：验证邮件翻译精确匹配修复、内置 administrator 角色的更新保护修复。与周报语料比对确认达收录线，既有条目与编号零改动；英文条目一一对应补齐。
      • 设计 新增 2.0.1-20260913 小节：覆盖 8 月 25 日至 9 月 13 日共 24 条（新增功能 2、功能优化 11、问题修复 10、策略调整 1）。素材从周报语料按规则蒸馏——窗口内净效果为零的不收、未交付的骨架不收，最后由维护者裁决定稿。
      • 设计 英文版同步：与中文小节 1:1、24 条一一对应；时序是中文定稿后才翻译，多语言文案类条目按先例保留原文。
      • 实施 biome 收敛两处历史格式漂移：dependency-cruiser 配置的模板字符串占位、handoffs JSON 的引号缩进，检查退出码 0。
      • 设计 changelog-20260913 批次的规划资产入库、三票结案：spec 与补口/新节/英文同步三票全文入库，批次命令归档。

其它工作

• 目标: 记录日常杂项工作、协作沟通等事务
• 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
  • 📌 以往已自测工作不再重复，详情请查看上周及上月报告
  • 7 日
    • ✅ 协作 git → svn 源代码同步
    • ✅ 实施 将最新版本部署到 zxs-cs, zxs-test 服务器: 编译最新程序 → 制作 Docker 镜像 → 制作升级程序 → 上传服务器 → 升级部署 〔es-center-server-build〕
    • ✅ 实施 长沙内网测试用服务器系统安装, 用于快速验证改进成果, 在测试服务器演练 default 租户 -> pcm 租户的数据迁移
  • 9 日
    • ✅ 实施 多次将最新版本部署到 192.168.1.53 服务器, 不断调整改进 -> 测试稳定性
  • 10 日
    • ✅ 实施 将最新版本部署到 192.168.1.53/zxs-cs/zxs-ca/zxs-test/zxs-hs/zxs 服务器
    • ✅ 实施 zxs 服务器上, 数据库备份, default 租户 -> pcm 租户的数据迁移
  • 11 日
    • ✅ 实施 将最新版本部署到 192.168.1.53/zxs-cs/zxs-test 服务器: 编译最新程序 → 制作 Docker 镜像 → 制作升级程序 → 上传服务器 → 升级部署 〔es-center-server-build〕
  • 12 日
    • ✅ 实施 将最新版本部署到 192.168.1.53/zxs-test 服务器: 编译最新程序 → 制作 Docker 镜像 → 制作升级程序 → 上传服务器 → 升级部署 〔es-center-server-build〕
  • 13 日
    • ✅ 实施 将最新版本部署到 192.168.1.53/zxs-cs/zxs-ca/zxs-test/zxs-hs/zxs 服务器: 编译最新程序 → 制作 Docker 镜像 → 制作升级程序 → 上传服务器 → 升级部署 〔es-center-server-build〕