Skip to Content

2026年09月14日

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

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

中心服务平台 - 功能完善

  • 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
    • 以往已完成的工作不再重复,详情请查看上周及上月报告
    • 〔工作量〕es-center-server-services 76 次(设计 23 · 代码 53)· 代码 +14.6k/-2.2k | es-center-server-web-app 97 次(设计 42 · 代码 55)· 代码 +14.5k/-4.2k | es-center-server-install-app 7 次(设计 1 · 代码 6) | es-ext-doc-website 68 次(设计 17 · 代码 51)· 代码 +22.5k/-1.4k
    • 〔方法论〕契约先行 | 取证先行 | 单一事实源 | 门禁前置 | 人工闸门 | 规格先行 | ADR 立法先行 | 性能取证驱动 | 双态合同收口
    • 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 起无人值守
    • 9-14(午前至午后): 开发手册重构末批收尾
      • ✅ 接入视角两章与门禁修复 〔es-ext-doc-website〕
        • 实施 采集服务器接入视角章 8 页: 面向采集服务器软件开发者给出身份认证、设备清单同步、消息链、文件上报检索与运维指令面的完整接入动线;顺带修复本章新发现的构建零死链检查空转缺陷,开启后全站构建真实零死链
        • 实施 票 19 双轴复查修正: 状态口径同步与引用边界收敛,动线页数值内联改纯指针
        • 协作 采集服务器接入视角章工单结案
        • 实施 记录仪设备接入视角章 8 页: 覆盖设备身份、上行遥测、下行指令、媒体通道族与在线状态四口径,与采集服务器章构成两接入面分工互链,新章纳入端点覆盖门禁
        • 实施 票 20 双轴复查修正: 状态口径同步与覆盖校验汇总基线修复
        • 协作 记录仪设备接入视角章工单结案
      • ✅ 末批收尾与空壳页裁决执行 〔es-ext-doc-website〕
        • 实施 31 页导航域改写与交接物清单: 收敛重构期前置表述指向清单层唯一权威源,删除孤儿手册整节、新建手册定位与四分册导航,英文侧校验全量重登全绿
        • 实施 票 21 双轴复查修正: 交接物状态同步与头注日期落定
        • 协作 末批收尾工单结案: 中文站门禁留待终验收不自动结案
        • 重构 去除 api 域 7 个空壳平级索引页: 落实用户「不预建空壳导航页」裁决,目录标题改由配置承载,四个生成器同步停写壳页
        • 协作 记录用户空壳页裁决并同步交接物统计
    • 9-14(午后至晚间): 全站 i18n 公共呈现五票连续实施与首批验收交接
      • ✅ 公共呈现 03–07 五票连续实施 〔es-center-server-web-app〕
        • 实施 校准表单错误与个人设置反馈: 资料、头像与密码结果判定按业务拒绝与技术失败分流,业务拒绝不再误报成功;服务器配置七个真实字段错误关联到输入,新增 45 项公开边界回归
        • 协作 表单错误与个人设置工单结案回写: 03 号票验收勾选并登记完成记录与交付资料链接,父规格同步实施进度
        • 实施 校准认证流程文案与结果反馈: 覆盖登录三种身份方式、注册与找回四个子表单,验证码与协议错误关联到控件,全站有限 key 从 1314 收敛到 1306,含新增认证用例 95 文件/1798 项单测通过
        • 协作 认证流程文案工单结案回写: 04 号票标 done、评审与验收记录回写
        • 实施 统一外壳导航与公共控件呈现: 桌面、移动与认证外壳的语言、账户和菜单名称统一,补齐键盘语言选择、权限分组与面包屑当前位置语义,本票有限 key 由 115 降至 92,新增 30 项消费测试
        • 协作 外壳导航与公共控件工单结案回写: 关联实现、1828 项验证与双轴审查证据
        • 实施 校准 XLSX 操作阶段与结果反馈: 模板与导出反馈校准为带文件名的下载触发,导入仅确认异步请求提交,新增 33 项公开 hook、真实菜单与 API 消费用例
        • 协作 XLSX 操作反馈工单结案回写: 06 号票七项验收全部勾选
        • 实施 校准文件大小与对象名称呈现边界: 16 个大小消费文件接入呈现端翻译,区分有效容量、零、缺失与异常并保持单位与舍入,全站仅新增一个词条
        • 协作 呈现边界工单结案回写: 07 号票标 done、父规格同步实施进度
      • ✅ 公共呈现首批验收交接归档 〔es-center-server-web-app〕
        • 协作 完成公共呈现首批验收与交接: 对账七张流程票 53 项独立验收与 42 条用户故事,全站有限 key 并集 1359→1327,交付可复跑取证与正式映射定位,具名移交账户、导航等独立问题
        • 协作 首批票据与规格收尾回写: 八项收口验收、父规格与实施索引回写为完成,全批 8 票共 61 项验收闭合
    • 9-14(午后): 管理员跨租户组织试点规划与新增/更新/删除三票交付
      • ✅ 跨租户组织试点决策地图归档 〔es-center-server-services〕
        • 设计 归档超级管理员组织试点 wayfinder 决策地图与 8 张子票: 试点范围、administrator 资格与目标租户、入口租户作用域、查询权威与树形结果、缓存异步与验收边界、生成器事实 6 张决策票全部解决
        • 设计 新增数据库能力优先、树形递归校验与生成器辅助三节编码规范,并澄清逻辑删除与租户过滤是两种机制的事实勘误
        • 设计 新增全租户查询结果的租户识别信息合同: 返回记录必须可对应所属租户的编号、类型、管理员与删除时间,不任取首条、不改变计数与分页
        • 设计 补组织身份与设备固件管理租户领域词并勘误 ADR-0042 表分类
        • 协作 关闭组织试点 05/08 决策票并收口地图: 05 票冻结全租户组织管理 11 个端点的 HTTP 合同,08 票确认生成模板三项取舍
        • 设计 接口版本策略改为仅插版本段并纠正删除 HTTP 映射
        • 设计 发布组织管理实施规格与九张实施票: 11 个 v1 端点、资格与目标准入、组织身份与租户资料展示,按新增→更新→删除/详情→检索→树→缓存树依赖排列
      • ✅ 字典缓存匿名白名单线上修复 〔es-center-server-services〕
        • 排障 恢复字典 listCache 匿名白名单: 线上 App 未登录即匿名调用两个字典缓存,白名单移除后认证报错,按裁决恢复并钉防回归合同测试
      • ✅ 组织新增/更新/删除三票交付 〔es-center-server-services〕
        • 设计 发布 ADR-0079 生成式与迁移式新增一律纯插入,部分替代 ADR-0003 的隐藏更新分支
        • 协作 关闭生成模式与纯插入合同票: 生成器与 ADR 先行交付的固定点入档,合成 72 文件与真实元数据 1915 文件三轮编译证据留存,全仓 1956 项测试通过
        • 实施 支持管理员跨租户新增组织: 共用组织新增迁为事务内纯插入并统一编号、有效父组织与拒环校验,全仓 2026 项测试通过
        • 实施 支持管理员跨租户更新组织: 完整租户作用域更新本体并保持角色集合及旧 HTTP 合同,复用组织 SQL 接缝验证 135 项写入行为
        • 实施 组织管理对外文案统一使用英文并统一 All-tenant 标识,防止后续生成中文 API 说明
        • 实施 支持管理员跨租户删除组织: 业务引用及未请求后代保留、真实树重算后子组织升根,新增 40 项隔离 schema 组合测试,全仓 2133 项通过
    • 9-14(午后): MQTT 契约补全立图与四票执行
      • ✅ MQTT 补全工作图与脱敏基线 〔es-ext-doc-website〕
        • 协作 建 MQTT 主题清单补全 wayfinder 图并拆四票成阻塞链,钉牢缺口本质是清单生成面与源码权威面从未系统性比对
        • 协作 增「已写文档脱敏检查与修正」必达项并钉暴露面快照: 源码行号引注 38 页 138 处、后端类名 10 余页等基线量级
        • 协作 为对账票增 ChannelContracts 三方对账防漏法: 逐常量核对源码引用、清单页收录与 topic 形状,比对走脚本不走肉眼
        • 协作 按用户纠偏重写图面主线: 核心目标定为 public OpenAPI yaml 同步补全(7 个契约 yaml + common),对账法扩为四方
      • ✅ MQTT 契约 7→17 补全与门禁转正 〔es-ext-doc-website〕
        • 协作 发布四批次实施 spec 与执行票 05–08: 对账资产四份与对账脚本、2000 行对账数据入库
        • 实施 补全 device-service MQTT 契约 10 项并全修既有 yaml 漂移: 对接方无需读源码即可对接转发族,真实设备转储示例脱敏
        • 实施 生成面与门禁对齐 17 契约世界: 清单详解扩节、verify 断言域 13→17、对账脚本转正入 scripts 并新增快照门禁(84 常量 × 17 yaml × 清单收录全对齐)
        • 实施 手册与场景页随动对齐 17 契约层: 过期文案修正为 items 检索口径、内部叙事降为业务动词、26 页哈希基线换日期基线
        • 实施 全站脱敏长尾批改 213 文件: 代码位置引用、安全公式、ADR 引用全线退场换日期基线,检索复核三类敏感面归零
        • 实施 生成器出处标记脱敏与令牌公式内置替换: 五个生成面重刷不再带回敏感面
        • 协作 脱敏长尾批改执行票结案与遗留登记
        • 实施 api 域与 en 侧同款脱敏补齐: 公式与状态码长文收口、en 镜像同步修复
        • 协作 票 08 Answer 计数修正与 en 镜像修复登记
        • 协作 MQTT 补全 05–08 四票执行完毕归档: 契约面 7→17、既有漂移全修、全站脱敏、对账快照门禁转正
    • 9-14(深夜至 15 日凌晨): net-body-camera api 域重写
      • ✅ api 域重写规划与结构重排 〔es-ext-doc-website〕
        • 协作 网络随身摄像机 api 域重写 spec 收口与 02–06 执行票预拆: manage 服务处置、webrtc-live 改名、iot-signaling 建壳与契约补全、verify 扩域、en 镜像
        • 实施 api 域结构重排一次到位: manage 服务整体移除、webrtc-live 更名、iot-signaling 双语建壳,五道门禁复跑全绿
        • 协作 结构重排执行票结案
        • 实施 落地 iot-signaling zh 契约 4 份: 按子命令分化、publish-only 不回包形态注记、词汇表以中心侧源码归纳为准
        • 协作 iot-signaling zh 契约票结案
        • 实施 落地 webrtc-live zh 契约: 旧薄壳全量重写为 7 子命令信令契约并新增 3 契约,SDP 示例 zh/en 双语脱敏
        • 协作 webrtc-live zh 契约票结案
        • 测试 verify:mqtt-yaml 扩域 net-body-camera 断言块: 无源码仓环境即可运行的 topic 常量表断言与 zh/en 结构指纹,反向自检 4 组均正确红退
        • 协作 verify 扩域票结案
        • 实施 en 末批镜像收口: 两服务规范说明真文翻译、8 份契约 yaml 全量同步、索引满键触发 en 断言自动收紧
        • 协作 en 末批镜像票结案
    • 9-15: 数值呈现三票与公共封装两票交付
      • ✅ 数值呈现三票实施 〔es-center-server-web-app〕
        • 实施 保留共享选择器数值原文并过滤缺失翻译数字候选: 数值与数字字符串保留格式、不再被历史译文替换,真实字典类型与选择交互验证通过
        • 协作 数值选择器呈现与上报工单结案回写
        • 实施 视频布局标记按原值呈现: 移除 5 处布局翻译调用,防止历史译文或语言切换替换 10 种默认布局标记
        • 协作 视频布局标记工单结案回写
        • 实施 保留其余动态数值原文并完成呈现入口清扫: 核对 53 处原有翻译调用并处理,记录 742 文件扫描与完整动态调用归属
        • 协作 数值呈现清扫工单结案回写
        • 协作 数值呈现父规格与拆票计划按已交付事实回写 done
      • ✅ 无翻译价值数值边界入规范 〔es-center-server-web-app〕
        • 设计 明确无翻译价值数值的呈现与上报边界: 静态与动态数值、数字字符串及既有格式化结果直接呈现,保留前导零、符号、精度、分隔符与百分号
        • 协作 实施批次清单切换到数值呈现工单
      • ✅ 公共封装收敛两票 〔es-center-server-web-app〕
        • 重构 设备导入排除反馈收回设备侧: 设备父路由共享 adapter 统一解释排除名单,公共 XLSX 保持业务拒绝优先,XLSX 验收扩充到 70 项
        • 协作 设备 XLSX 导入反馈工单结案回写
        • 重构 共享认证与个人设置的默认请求错误通知: 新增固定请求错误呈现原子,个人设置五处调用点直接消费并删除重复包装
        • 协作 默认请求错误通知工单结案回写
        • 评审 落档 i18n 公共封装两项寻路裁决: XLSX 设备导入反馈归属设备侧共享 adapter、错误通知采纳共享固定通知原子
        • 设计 发布公共封装职责调整与通知复用规格: 30 条用户故事、20 项实施决策、14 组验收场景
        • 协作 实施批次切换至公共封装收敛工单
    • 9-15: 组织管理实施票 05–09 交付闭环
      • ✅ 跨租户组织管理端点五票交付 〔es-center-server-services〕
        • 实施 支持管理员跨租户查看组织详情: 详情单次查询同取组织行、同租户有效父资料与租户识别资料,不凭成员猜租户类型,新增 27 项集成测试
        • 实施 支持管理员跨租户检索、计数与分页组织: 查询合同覆盖精确/模糊、父条件递归子树与时间范围半开区间,含独立参考查询与执行计划核对
        • 实施 支持管理员跨租户查看组织普通树与记录分页树: 先限量/分页再构树、构树集中服务层单一入口——缺父升根、自指断自身父边、多节点环每环只断一边
        • 实施 支持管理员跨租户读取组织缓存树完整投影: 热缓存不能绕过后来生效的禁管,修复生产缓存键编码器不认时间字段的坑
        • 测试 以最终模板再生成并完成组合验收闭环: 11 端点同生命周期组合测试,全仓 2251 项测试零跳过
      • ✅ 批次运行方式登记 〔es-center-server-services〕
        • 协作 记录组织管理批次以 claude 代理经批次脚本串行执行的运行方式
        • 协作 登记 ponytail 系列技能锁 6 条,供后续全仓过度设计审计与精简评审
    • 9-16: nginx 客户端 IP 链路批次交付
      • ✅ 客户端 IP 链路术语与配置治理 〔es-center-server-install-app〕
        • 设计 建立 nginx 客户端 IP 链路术语表: 边缘/内层 nginx、三目录分工、客户端变量与信任锚不变量等 5 个术语入根 CONTEXT
        • 实施 补齐升级配置缺失的静态路径,使三份内层 nginx 配置逐字节一致
        • 实施 清洗边缘客户端 IP 并提供查询接口: 27 处转发头以连接来源覆盖客户端传入值,防止伪造头干扰后端限流
        • 实施 修复内层客户端 IP 透传并提供查询接口: 48 处反代 IP 头改写、删除 48 处协议/端口覆盖使边缘信息透传
        • 测试 增加客户端 IP 链路静态回归断言: 六份配置 28 项断言保护 51 处反代位置,16 种定向回退均被捕获
        • 实施 修复内层来源信任并完成内网部署验收: 移除可由直连方伪造的头映射,两层 nginx 检查与 14 项现场请求证据留存
        • 协作 批次入口切换至 nginx-client-ip-chain 票目录
    • 9-16: i18n 冗余清扫与远程选择器已选名称保留
      • ✅ i18n 冗余清扫 〔es-center-server-web-app〕
        • 重构 清理冗余等待判断与闲置 helper: 删除选择器重复等待条件与三个无生产消费者的 helper,避免继续推荐退休入口,定向回归 136 项、全量 2020 项通过
        • 协作 冗余清扫工单结案归档
        • 协作 实施批次滚动补记与公共封装父规格补 done 状态
      • ✅ 远程选择器已选名称保留 〔es-center-server-web-app〕
        • 实施 保留有界查询中的已选名称: 八种同族选择器共享当前已选快照与请求编排,清搜或刷新后不再退回裸编号,公开组件契约扩展至 68 项
        • 协作 已选名称保留工单结案归档
    • 9-16: 组织管理封装改进三票交付
      • ✅ 封装改进批次发布与规范沉淀 〔es-center-server-services〕
        • 设计 发布管理员组织全租户管理封装改进批次: 查询组装位置、完整投影与纯构树合同、写准入集中方式、跨租户资料批量获取四项封装发现 6 票全部解决,实施批次按三票发布
        • 设计 新增 Mapper 查询归属原则: 归属跟随数据职责而非调用者所在模块,「查询归属审查」成为具名触发动作
        • 协作 移除 ponytail 系列技能锁,与技能只维护项目级的约定一致
      • ✅ 统一写准入、完整读取归位与最终再生成 〔es-center-server-services〕
        • 重构 统一组织管理写准入与目标租户作用域: 四个管理写入口复用同一资格、目标检查和完整代理作用域,2256 项测试通过
        • 协作 统一写准入票结案: 入库隔离生成清单、测试汇总与实现记录等交付证据
        • 重构 归位完整管理读取并迁移投影缓存: 两类用户资料投影与完整查询归回角色、用户租户领域,2268 项测试通过
        • 测试 完成组织管理最终再生成与组合交付: 最终业务副本隔离生成输入与 1942 份产物摘要留存
        • 排障 恢复新旧组织更新的角色集合处理: 区分角色省略保持、空列表清空和去重替换,2350 项零失败
        • 协作 回写统一写准入票交付记录并纳入复审验收
        • 设计 采纳样板设计复审并回写来源规格与拆票记录
        • 协作 批次 runner 入口切换到组织更新角色合同复审
    • 9-17: 远程选择器统一六票与三项前置修复
      • ✅ 拆票补录与批次预登记 〔es-center-server-web-app〕
        • 设计 补录 tenant-tree-select 规格拆票票面与调研共识: 远程选择器同族八控件「统一操作、只读刷新、已选项保留」合同定稿
        • 协作 实施批次滚动补记;组织保存角色合同复审批次预登记(规划入库待完成)
      • ✅ 领域下拉统一操作与只读刷新 〔es-center-server-web-app〕
        • 实施 统一领域下拉操作并支持只读刷新: 刷新、管理、显隐和整组禁用进共享操作层,47 个使用点与 36 个消费文件记录在案
        • 协作 下拉统一操作工单结案回写
      • ✅ 远程选择统一三项前置修复 〔es-center-server-web-app〕
        • 实施 修复采集柜详情与型号保存接线: 详情查询统一接入采集柜接口,型号标识不再被表单校验剥离
        • 协作 采集柜接线修复工单结案归档
        • 实施 修复值集映射详情参数与类型回显: 详情取参与面包屑统一为映射主键参数
        • 协作 值集映射详情修复工单结案归档
        • 实施 统一字典读取与租户缓存一致性: 显式按当前租户共用完整读取、隔离账号租户切换后的晚到响应
        • 协作 字典一致性修复工单结案归档
      • ✅ 远程选择统一六票实施收尾 〔es-center-server-web-app〕
        • 实施 统一六种远程单选与可配查询上限: 厂商、通用及三种采集型号、值集类型选择器复用共享搜索、回填和反馈
        • 协作 六种远程单选统一工单结案归档
        • 实施 统一设备类型展开树选择: 以名称搜索和类型回填替代独立查询、缓存及折叠状态
        • 协作 设备类型树选择工单结案归档
        • 实施 字典选择器统一接入远程搜索: 名称搜索对公共候选补充精确身份确认,新增 20 项公开行为测试
        • 协作 字典选择器统一工单结案归档,六票至此全部交付
    • 9-17: 组织新增统一与保存角色合同复审
      • ✅ 组织新增统一与复审三笔裁决 〔es-center-server-services〕
        • 实施 统一普通组织新增与初始角色保存: 新旧新增共用服务端 NanoID 和目标租户有效角色交集,全仓 2416 项测试通过
        • 重构 移除角色 ID 的专用反序列化防护,恢复普通字符串列表绑定
        • 重构 更新时过滤未命中的角色,对齐新增与更新的有效角色交集
        • 协作 回写组织保存角色合同复审票面与诊断证据: 旧实现 13 项断言 7 失败与当前实现全绿的红绿对照入档
        • 排障 组织命中后再查询并写入有效角色交集: 复合保存顺序调整为组织先行,红绿证明顺序缺口
      • ✅ ADR 与规范沉淀 〔es-center-server-services〕
        • 设计 新增 ADR-0080 组织普通新增由服务端生成 NanoID
        • 设计 确立通用能力选型优先级并新增执行顺序复核: JDK 语法糖、Lombok、Guava、Apache、Hutool 固定顺序
        • 协作 批次 runner 入口切换到组织保存角色合同复审
    • 9-18: 跨租户组织前端寻路收口与实施规格发布
      • ✅ 补录与批次滚动 〔es-center-server-web-app〕
        • 设计 补录 remote-select-unification 调研共识与拆票票面: 九种待迁移选择器盘点(84 处界面、58 个消费文件)与三项前置修复核查
        • 协作 实施批次滚动补记,组织保存角色合同复审批次维持预登记
      • ✅ 跨租户组织前端寻路收口 〔es-center-server-web-app〕
        • 设计 回写跨租户组织前端寻路票面并补录冒烟与方案产出: 11 端点对接映射、管理员实测全部符合合同、试点范围等三项方案裁决完成
        • 设计 跨租户目标租户参数一律走地址栏参数规范入工程规范: 后端绑定会忽略请求体中的租户字段
        • 设计 发布跨租户组织管理实施规格与 8 张实施票: 组织试点范围裁决为树浏览、筛选、新增、编辑、删除、详情与 Excel 导出
        • 实施 default 租户导航按「做好一个功能,开放一个入口」裁决收口: 未改造的设备组菜单整组下架、待逐项回补
        • 协作 实施批次切换至跨租户组织管理工单
      • ✅ 组织 v1 API 封装与选择器租户作用域两票交付 〔es-center-server-web-app〕
        • 实施 新增组织管理 v1 跨租户 API 类型化封装与 wire 合同测试: 11 端点全覆盖、租户与主键参数一律走地址栏参数,12 用例逐端点锁定合同
        • 协作 组织 v1 API 封装工单结案回写
        • 实施 远程选择控件共享层与组织选择器支持租户作用域: 作用域变化即受控清空已选值,25 处消费零改动
        • 协作 选择器租户作用域工单结案回写
      • ✅ 测试环境造数授权入规范 〔es-center-server-web-app〕
        • 设计 记录 192.168.1.53 测试环境造数授权与免清理约定: 授权只覆盖造数与免清理、登录态与部署对应关系仍逐次确认
    • 9-18: 设备高频读取优化——缓存租户 ADR、两规格与五票实施
      • ✅ 高频读取决策地图复盘与 ADR 立法 〔es-center-server-services〕
        • 协作 回写设备视图与仪表盘高频读取决策地图票面与两轮复盘证据: 九张已解决决策票入库,第二轮独立复盘九票决策全部维持
        • 设计 立缓存租户两份通用合同: 键控缓存结果随租户变化的 key 必须显式包含租户标识,跨租户读取的租户条件必须显式进入查询
        • 设计 交付设备读取视图与仪表盘在线分页两份规格及拆票: 列表动态富化批量装配、主记录短缓存、先计数本页再按需富化
        • 设计 留档统一响应客户端 IP 元数据退场规划: 停止在普通响应自动注入客户端 IP、按需从入口获取
        • 协作 批次 runner 入口切换到设备读取视图与仪表盘分页,并改用 claude 代理执行实施
      • ✅ 设备读取视图五票实施 〔es-center-server-services〕
        • 排障 采集设备列表缓存键补时间条件序列化: 带时间条件的列表缓存请求原先在键编码阶段抛异常、时间筛选实际不可用
        • 重构 缓存键切换全局时间转换器: 任何携带时间字段的请求自动可编码、现存缓存条目不变
        • 重构 缓存键转换器配置类移入 cache.config 子包,装配行为不变
        • 重构 采集设备共享数据对象退役最近点击时间字段: 写入口已删、消费者确认不使用,净删除为主
        • 重构 设备列表动态富化集中为列表视图组件: 每千实际行一批、一次调用所有批次共用已读状态
        • 实施 采集服务器批量关联具名缓存方法: 发现分区裁剪要害——子查询内租户用显式常量才能让规划器下推,结论立规入数据库能力优先章节
        • 设计 测试服务器造数授权写入测试执行规范,脏数据无需清理
        • 实施 普通 list 主记录缓存与批量服务器装配: 按行租户分组、设备号去重排序、每批 200,新增 20 例控制器测试
    • 9-19: 组织管理员变体四票连续交付
      • ✅ 管理员变体 03–06 票交付 〔es-center-server-web-app〕
        • 实施 组织页面变体按需加载骨架: 按租户分流懒加载、未命中变体不进入下载,浏览器实测两租户各自只请求命中变体
        • 协作 组织路由懒加载骨架工单结案回写
        • 实施 组织管理员变体跨租户平铺检索台: 目标租户选择加名称、编号、创建人、创建时间范围筛选与服务端排序、无限滚动分页,新增组织详情抽屉
        • 协作 跨租户平铺检索工单结案回写
        • 协作 实施批次执行代理切换为 kimi
        • 实施 组织管理员变体选定租户树浏览与父组织筛选: 当前页树展平为带深度与子节点标记的行,真实环境实测跨页构树通过
        • 协作 树浏览与父组织筛选工单结案回写
        • 实施 组织管理员变体写操作(新增/编辑/删除): 后端拒绝原文逐条核对分类为编号重复、父无效、成环、禁管并就地映射表单错误,新增 18 例拒绝分类合同测试
        • 协作 组织写操作工单结案回写
    • 9-19: 跨租户命名规范放宽与设备读取视图收口
      • ✅ 跨租户命名与读取视图收口 〔es-center-server-services〕
        • 重构 跨租户命名放宽为双形态并重命名批量关联方法: 单条件按租户、多条件租户条件后置显式命名,存量随任务顺带统一
        • 重构 两个按编号加租户的查询方法按规范补显式租户后缀: 「存量随任务顺带统一」规则首次应用
        • 设计 采集设备读取视图具名合同与整体验收收口: 列表缓存、关联、动态状态与响应合同、点击字段退役窄例外与部署切换结论
    • 9-20(日间): 组织管理员变体 07–12 票交付
      • ✅ 管理员变体导出与竞态排障 〔es-center-server-web-app〕
        • 设计 补登管理员变体查看整页化实施票
        • 实施 组织管理员变体 Excel 导出: 接入共享导出菜单,导出走 v1 列表直查,跨租户 19 行文件内容与接口形态核对一致
        • 协作 Excel 导出工单结案回写并补登列表竞态实施票
        • 排障 组织管理员变体列表陈旧数据合并与竞态修复: 排查确认节流包裹与滚动续载两层根因,快速连切六轮最终态一致实测
        • 协作 列表竞态修复工单结案回写
        • 协作 试点端到端验收票结案归档: 环境与构建标识、关键路径走查证据入票
      • ✅ 管理员变体查看整页化与归属信息 〔es-center-server-web-app〕
        • 实施 组织管理员变体查看改为整页子路由: 详情字段口径承袭抽屉不缩字段,列表行「查看」改为跳转子路由且链接可分享
        • 协作 组织查看整页化工单结案回写
        • 实施 平铺模式开放行级写操作与新增页内置必选租户下拉: 行操作统一为查看、编辑、删除,新增页常驻表单默认带入地址栏租户
        • 协作 平铺模式写操作工单结案回写并补登组织归属信息展示实施票
        • 实施 管理员变体展示数据所有权识别信息: 列表归属组与编辑页只读归属区、查看页成员摘要补充联系方式
        • 协作 组织归属票追记导出表头命名偏差备注: 如实记录事实与「另立票改共享层统一口径」建议
    • 9-20: 包结构规范定稿与整改、设备在线状态富化、缓存租户合同批一/批二收口
      • ✅ 包结构规范与整改执行 〔es-center-server-services〕
        • 设计 交付包结构规范图全套: 地图、10 张票、规范草稿与 26 模块包结构调查底稿,用户复核新增两票
        • 设计 翻译双发布路径合并独立建票: 记录两条职责重叠发布路径的事实与裁决任务
        • 设计 交付设备在线状态富化统一规格及拆票: 连接状态富化单一真源、四个入口收编视图装配
        • 协作 批次 runner 入口切换到设备在线状态富化
        • 重构 固件二进制头解析器与编解码器归位固件域包,解除跨模块分裂
        • 重构 设备状态查询组件迁出功能杂项包归设备域根包,功能杂项包自此清空
        • 重构 清理零引用死代码三类,净删除约 500 行
        • 设计 包结构与配置类归属规范定稿入正本: 语义包纯净、配置类三形态准入、跨模块分裂禁止
        • 协作 设备在线状态富化 01 票回写 done 并记录交付备注
        • 重构 退役设备服务接口冗余缓存直查方法
        • 重构 采集设备四入口富化收编列表视图单一真源并退役冗余缓存对象
      • ✅ 服务缓存租户合同批一/批二收口 〔es-center-server-services〕
        • 排障 8 个用户中心灰色缓存方法归全局作用域桶: 根治设备服务账号富化在无租户线程静默失败的隐患,新增真实租户插件集成测试
        • 协作 服务缓存租户合同规格与 6 张工单入库,01 票记录 8 方法归桶台账
        • 审查 设备线 6 个缓存灰色候选归桶收口: 第三方账号缓存归全局桶、5 方法逐项核实归租户作用域桶
        • 重构 退役 12 处缓存失效注解: 平台缓存一致性统一由短过期时间承载
        • 协作 批二 03 票回写 done 并记录注解退役台账
        • 重构 设备线缓存双态对齐与显式租户条件动态化: 映射层租户特例注解迁服务层受控作用域,全仓 28 处穷尽复查
        • 协作 批二 04 票回写 done 并记录双态对齐台账
    • 9-20(晚间): 远程选择器一键清空全站普及
      • ✅ 一键清空全站普及 〔es-center-server-web-app〕
        • 实施 远程选择控件共享层新增一键清空: 清空能力缺省开启,17 个选择器封装与 136 处消费零改动自动获得、个别场景显式关闭,清除后焦点还给触发器
        • 实施 清除按钮改用组件库既有小尺寸按钮对齐同库清除控件范式: 焦点环由组件基类提供,行为语义与测试零改动

其它工作

  • 目标: 记录日常杂项工作、协作沟通等事务
  • 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
    • 📌 以往已自测工作不再重复,详情请查看上周及上月报告
    • 14 日
      • 实施 es-center-server-services 手动建分支 2.0.1-cn-1-yaoht-20260916,为新版本做切换
      • 协作 git → svn 源代码同步
    • 18 日
      • 实施 将最新版本部署到 192.168.1.53/zxs-cs/zxs-ca/zxs-test 服务器: 编译最新程序 → 制作 Docker 镜像 → 制作升级程序 → 上传服务器 → 升级部署 〔es-center-server-build〕
    • 20 日
      • 实施 在 zxs 服务器手动在数据库中添加几个测试设备
      • 沟通 与王工, 郭工沟通 app 异常问题, web 在直播时, app 无法直播, 已定位到原因: app 使用转发模式有问题(连入 janus 房间的协议有 bug). 因为 p2p 没有问题, 必需是有一个以上客户端看同一个设备直播, 设备才能转入转发模式, 问题才能复现出来
Last updated on