2026年09月14日

内容截止日：2026年09月20日

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

中心服务平台 - 功能完善

• 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
  • 以往已完成的工作不再重复，详情请查看上周及上月报告
  • 〔工作量〕es-center-server-services 1 次 ｜ es-center-server-web-app 10 次（设计 5 · 代码 5） ｜ es-ext-doc-website 32 次（设计 13 · 代码 19）· 代码 +18.5k/-1.0k
  • 〔方法论〕契约先行 ｜ 取证先行 ｜ 单一事实源 ｜ 门禁前置 ｜ 人工闸门
  • 9-14：全站 i18n 呈现基线与公共反馈两票交付
    • ✅ 全站 i18n 呈现基线与规范落档 〔es-center-server-web-app〕
      • 设计 固化全站呈现基线与共用词条消费证据：归档 734 个源码文件、218 个注册路由的 AST/symbol 呈现基线，1318 个有限候选 key、795 项动态来源分类与 82 个公共/多消费者文件的符号消费关系及四类语义证据；baseline 与 shared-copy 冻结 JSON 保留原始字节，不用当前源码覆盖历史基点
      • 设计 归档设备语义研究与分批验收依据：两份设备合同研究区分通道收到回复、配置返回值与实际保存/生效，89 个既有测试文件定位清单与呈现链矩阵入库，用户已采纳的九批范围、共享归属及规格交接提案落档
      • 设计 共用词条判据与设备编号语义入规范：先核对事实和实际动作、再按通用 key、插值模板、必要专属词条顺序复用，区分无匹配、加载失败、权限不足与未知状态；设备编号允许平台登记号与机身/本机编号共用标签但不推定取值相等
    • ✅ 公共错误反馈与选择器查询反馈两票交付 〔es-center-server-web-app〕
      • 实施 校准全局错误通知与根错误页：全局出口直接呈现安全业务拒绝与插值、以请求摘要替换技术原文，根错误页区分页面不存在与一般异常并保留原始日志；新增 25 项通知/Router 边界回归，有限 key 净增 3 个补齐遗漏国际化
      • 实施 统一公共选择器查询反馈与默认文案：按请求参数、加载错误与已同步结果区分首次读取、查询等待、成功无匹配及刷新失败，八个真实适配器统一判读业务拒绝、非成功状态与缺失数组，19 个呈现文件与 82 个消费者核对，全站有限候选 key 从 1321 收敛到 1310，新增 44 项公开交互用例
      • 协作 两工单结案回写与寻路批归档：全局错误反馈与选择器查询反馈工单验收全部勾选，11 张已解决寻路票及决策索引入库，公共呈现首批规格拆出 7 张实施票（八票 61 项验收）
      • 协作 实施清单切换至公共呈现 i18n 批次，唯一活动命令指向已发布的八张实施票，不自动执行剩余工单
    • ✅ 全租户组织管理前端接入预备 〔es-center-server-web-app〕
      • 协作 登记全租户组织管理 API 交付后的前端接入任务：建立接入地图与两张寻路票，明确后端 API 交付为外部前置、先组织试点再推广，交付前不启动前端接入
  • 9-14：开发手册重构批次推进
    • ✅ 决策拆票与术语统一 〔es-ext-doc-website〕
      • 协作 图清结案：01–06 六票决策全文入库——调研三票（HTTP 提取定生产域 api-docs 主源与源码漂移检测、MQTT 真实面纠偏为静态/谓词族/动态下行、部署站盘点逐字节一致）、结构票（模块=springdoc 分组、接入视角平级四目录）、样板票（三模式改写与七件样张）、收口票（存量实测 390 页、批=目录族、五道门验收与 zh→en 交接口径）；map.md 置 closed，25 件调研证据入库
      • 协作 方案 spec 化并拆执行票 07–21：21 条 user stories 与十一节实现决策，15 张执行票按依赖链成链；编排引导载主代理循环、停车条件与三个人工闸门，不自动放行硬约束入票
      • 设计 CONTEXT.md 增「文档分层模型」术语五条：清单层/场景层/接入视角/模块/资源各带 Avoid 歧义标注，作为 spec 与执行票的统一用语
    • ✅ 清单层、business 页与迁移基建落地 〔es-ext-doc-website〕
      • 实施 清单层生成器落地并铺开 data-service 端点清单：现场拉生产域 api-docs 生成平级索引+overview+9 模块页共 904 端点，内嵌源码比对不变量（921 个方法级映射差集恰为 17 个分组外端点，破坏即拒绝生成）
      • 实施 铺开 device-service/agent-service 清单层与 runtime 三页：device 17 端点线上=源码双向零差集，agent 局域网实例实测刷新 openapi，定时任务/缓存/消费者三页内置 curated 表与源码扫描双向吻合校验
      • 实施 MQTT 主题清单页与 7 个重点 yaml 漂移修正：扫源码五处生成四节机器表格（静态 18+谓词族 7+$SYS 2+动态下行 5，计数不变量破坏即拒绝），10 个 public yaml 按源码核对修正通配形状与字段矛盾，新增 verify 门禁并以变异测试验证有效
      • 实施 endpoint-module-map 机器可读化：943 条映射 JSON（main 904+分组外 17+device 17+agent 5）含清单页与 business 页锚点构件，覆盖校验扫 390 页 319 次端点引用、缺口出 needs-human 清单不阻塞；排障 修正 agent 端点页深链示例锚点与构建产物不一致
      • 实施 迁移脚本三层落地并注册 verify-api-inventory 提交前门禁：A/B 模式改写骨架 dry-run 390 页无崩溃，摘要种子新增 236 key，场景页引用 ⊆ 清单层检查入提交前门禁、缺口走 allowlist 承接不放宽规则
      • 实施 data-service business 业务语义页 9 张与 device-service 4 张：叙事素材取自存量场景页已核验内容并附归类索引，行为规则一句话点名并链细节；business 锚点口径对齐为完整 slug 后 943 条映射全部闭合
    • ✅ 场景层四批迁移 〔es-ext-doc-website〕
      • 协作 编排 runbook 成文并登记 15–21 逐票命令：双驱动总览、机械四门顺序表、两笔提交规范、停车条件与检查点协议，批 1 人工放行、终验收不代结案
      • 实施 access-and-account 11 页 A 模式去事实化改写与 retail/account 24 页处理：六类事实小节删除改为端点导航行+双链接、18 指针页翻转清单层直链、6 页 B 模式逐页改写，链接机器校验与映射精确一致
      • 协作 批 1 由用户人工放行：票 15 补记用户人工放行记录，批 2 解锁，无人值守批次自此起批
      • 实施 批 2 C 模式收拢：configuration 69→1 与 device-and-asset 86→3 领域页，schemas.md 字段枚举归 Swagger、通用查询控制语义升为领域页小节；双轴复查修正补回遗失规则、消除与 business 页的双份全文复述
      • 实施 批 3 大族 A/B 改写：organization-and-people 46 页收于七节形态、talk-group 19 页 HTTP/MQTT 双轨处理；复查修正补回混合范围更新规则与租户拦截器约束、QoS 细节下沉 business 页
      • 实施 批 4 中小族与零售专有页改写：institutional 9 族 55 页 A 模式、retail 12 页 B 模式，15 组行为规则落 business 页既有节；复查修正 v1-share 收敛、janusNo 级联与 Web 直发 QoS 约定归位
    • ✅ 执行票结案与人工放行 〔es-ext-doc-website〕
      • 协作 票 07–18 逐票结案：Status 翻 resolved 并补写 Answer、关联对应实现提交；票 15 注明待人工重抽查放行，放行后批 2 起无人值守

其它工作

• 目标: 记录日常杂项工作、协作沟通等事务
• 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
  • 📌 以往已自测工作不再重复，详情请查看上周及上月报告
  • 14 日
    • ✅ 实施 es-center-server-services 手动建分支 2.0.1-cn-1-yaoht-20260916，为新版本做切换
    • ✅ 协作 git → svn 源代码同步