2026年11月16日
内容截止日: 2026年11月22日 本周进行中,以下记录本周已经推进的工作。
本周工作计划与执行完成进度
中心服务平台 - 功能完善
- 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
以往已完成的工作不再重复,详情请查看上周及上月报告- 〔工作量〕es-center-server-services 41 次(设计 7 · 代码 34)· 代码 +3.9k/-1.8k | es-center-server-web-app 23 次(设计 10 · 代码 13)· 代码 +3.8k/-0.5k
- 11-16: Org/Role/租户主框 keyword 与编号/编码独立条件交集接入;按动作收敛评审与工具文档入口;候选 keyword 批次 03–05 票补验收口(厂家/值集类型、用户/员工、设备/服务器缓存候选);闲置过程文档 382 文件退役并收窄审查读取范围
- ✅ Org/Role/租户主框 keyword 与独立条件交集接入 〔es-center-server-web-app〕
实施组织普通与管理员列表主框接入 keyword 与组织编号交集:管理员 keyword 纳入既有唯一查询解析出口(面板保留独立组织编号/父组织/创建人与日期,旧 name 键原样发送),补查询身份代次使导出在 keyword 变化或 A→B→A 后失权;普通变体本地状态加导出上下文身份并补主框无障碍名称;组织树与候选读取未接 keyword;五文件合跑 81 项通过,真实 UI 双变体采集与窄屏键盘提交通过,下载落盘保留缺口。实施角色两变体主框接入 keyword 与角色编码交集(既有查询身份代次自动纳入 keyword,预设/内置角色业务边界未改)六文件合跑 74 项通过;租户主列表主框接入 keyword 与租户编号/电话/邮箱/类型独立筛选交集(仍走本地查询体与同一提交路径天然求交集,导出补查询上下文身份,工作簿字节与列集已核对;tenantType 非空出站因 default 租户字典为空保留为登记在案的缺口)受影响四文件 122 项通过,真实 UI 采集含 390px 键盘提交。
- ✅ 按动作收敛评审与工具文档入口 〔es-center-server-web-app〕
设计工具预检、读取、保存与命令捕获直达必要章节并共享授权和结果判读边界;分开实施验证、评审和交付收尾,保留既有失败处置与实施采样的条件入口;按 diff 定位适用规范、分离状态报告判读与检测机制并记录读取量;145 个本地链接与锚点、格式、类型与 lint 检查通过,纯文档未跑单测,双轴复评无未闭合项;提交钩子故障处置(.agents 目录忽略规则阻断提交窗口,仅在提交窗口精确放行已审查路径并在结束后恢复)如实登记。
- ✅ 候选 keyword 批次 03–05 票补验收口:五族候选入口 keyword 验证 〔es-center-server-services〕
测试票 03 厂家与值集类型候选补验:沿用既有 keyword 接线只补候选覆盖与合同(仅编号命中、软删与他租户排除、目标省略、无权拒绝、回填与目标链边界、筛选先于限量),厂家合同补「候选读取」节、新建值集类型候选合同;22+30 例定向回归全绿。测试票 04 用户与员工候选验证(现有 keyword 接线即为候选能力,未改业务源码):完整安全链用例(有读权限可访问、无权限 403)、五字段关键词排序限量、按用户名/员工号回填并断言旧 name 字段不参与过滤;审查修正补强——前导零双向(000123↔123)、软删身份证/手机号命中、跨租户真实行断言、账号摘要仅管理链返回;共享夹具全部 10 个消费者 144 例回归零失败零跳过。测试票 05 设备与服务器缓存候选入口验证:Janus 与采集设备按名称/设备号、采集服务器按名称/设备号/安装位置独立命中,覆盖无命中、前导零、字面通配符、先过滤再限量与旧设备号错误交集反例;新增真实缓存代理测试验证关键词、租户与独立条件的缓存键隔离及源码 TTL;本票无业务源码改动——现有参数绑定与查询条件已支持 keyword;定向真实 PG 三批 80/306/13 例加缓存代理 5/3 例、同轮只读 1 例全部零失败零跳过。
- ✅ 闲置过程文档清理 382 文件退役并收窄审查读取范围 〔es-center-server-services〕
设计删除无人使用的 Zread 快照与旧提示词共 382 个文件(历史证据可经固定 Git 提交找回),配套新立 ADR 记录快照退役并同步八份既有 ADR 的退役关系、历史来源与实施记录;调查、提问、结票与 Spec 等入口改为指向必要章节(保留消费者、调用链与复用成本约束),普通任务只承接当前工单点名的回访、历史搜索留给显式复盘,减少无依据的历史扩查;检查脚本与删除清单、Git 来源核对通过。
- ✅ Org/Role/租户主框 keyword 与独立条件交集接入 〔es-center-server-web-app〕
- 11-16: keyword 前端批次 01–16 票全链推进(用户/员工、配置类型与三类字典条目主框接入,采集箱导出失效守卫,导出失效签名提炼共享原子件,终票集成验收与部署后专项复测);候选 keyword 搜索批次起步(厂家候选远程搜索、设备编号保持本地);过程材料存量三波清退(docs/superpowers、.zread、2026 年 prompt 会话材料)与工具辅助检查评审合同落档;候选 keyword 后端收尾(租户树剪枝缺陷修复与五个树入口候选验证、前端交接回执、终审判断项清理);单实现查询接口收敛(全仓 216 个接口排查、唯一整改对象内联、判据修订与两轮澄清);工具类判据与命名规范收敛七票(规范落文、仓库级约定扫描器、分页/安全/常量/其余四族重构、基线白名单退场);质量工具口径沉淀(仓库根 README、Lizard/jscpd/PIT 调查证据)
- ⚠️ keyword 前端批次 01–16 票推进到部署后复测:主框接入、导出失效守卫与共享原子件提炼、终票集成验收 〔es-center-server-web-app〕
实施用户与员工主列表主框接入 keyword 联合检索:用户按姓名/称呼/用户名/身份证号、员工按姓名/称呼/编号/手机/电话多字段联合搜索,对齐后端已交付的独立 keyword 合同;面板独立筛选保留并走同一提交路径求交集,两页导出补查询上下文身份,keyword 变化、排序/重置与 A→B→A 后旧任务失权;新增套件 12 项与受影响四文件合跑 116 项全绿,真实 UI 采集覆盖出站、交集、清空、重置、导出与窄屏键盘提交;员工仅 1 条记录,UI 翻页与组织节点选择保留明确登记的缺口。实施两类配置类型与三类字典条目主框接入 keyword:值集类型与数据字典类型支持名称或自身编码联合检索(新增套件 14 项、受影响四文件合跑 132 项全绿),普通、映射、表格三类字典条目支持主体名称或主体编码联合检索(新增套件 24 项、受影响三文件合跑 101 项全绿);导出同补查询上下文身份,数据字典工作簿行数与列集逐份核对,default 租户 0 条的资源仅核对表头并保留缺口。评审工单 14 三类字典条目接线双轴评审:Standards 无硬违规、无功能错误,判断项为导出代次块同形复制(留待集成票提炼)与词条按实体分散沿用存量形态;Spec 的导出上限与值/排序字段覆盖缺口已在前序提交补测闭合,结论落盘评审报告。实施采集箱普通页导出补查询上下文失效守卫:普通页已有导出此前未绑定查询上下文,keyword 变化、A→B→A、排队与卸载重入后的旧任务仍可能写盘;补「已提交查询体 + 单调查询代次」身份,分页与导出继续共用同一业务条件与上限;新增 box-keyword 套件 11 项覆盖空值/纯空白/前导零/字面通配符与管理员迟到读取等边界,受影响集合 113 项全绿,真实 UI 采集与工作簿字节核对。重构01–14 票逐页内联的导出失效代次块提炼为两个共享原子 hook(本地查询与 URL 查询各一),固定「身份 + 单调代次」键形状与各自推进时机,替换 18 个本地查询页与 3 个 URL 查询管理页的同形实现,不引入行为开关;新增机制合同测试 4 项锁定同身份不推进代次、回同值也换签名,21 文件定向复跑全绿,长套件既有候选用例时序抖动经 6 用例单跑与稳定环境连续 4 次全绿归因留存。测试终票集成验收与两份后端问卷回执:逐票核对 19 类资源、28 个列表实现的唯一主交付票与父规格通用合同(旧字段/URL、计数、导出上限、语言、键盘与窄屏),记录共享原子件等价性验证与抖动归因;15 票收尾六项验收全勾、实施清单 01–15 全部完成、16 票待后端构建身份确认,证据文档一处执行顺序表述同批澄清。测试16 票部署后前端专项复测:逐项复测 02–14 资源 keyword 端到端行为,新增请求/响应与工作簿文本取证,补充大小写、trim、纯空白、字面 _ 与 \ 文本边界及 keyword×编号交集探针;部署指纹未取得与单云节点无法构造子串反例两条缺口如实保留、票转 needs-info——前 15 票闭合,复测待后端部署信息后继续。
- ✅ 过程材料存量三波清退与工具辅助检查评审合同落档 〔es-center-server-web-app〕
设计过程材料存放合同修订:除名 docs/superpowers 路径并清退存量 121 个文件(plans 66、specs 55),过程材料统一收口到 .scratch 与 .ai,历史正文由版本历史承担考古;活跃规范入口检索无残留引用,历史材料按合同保留时点路径、不批量改写。实施清退外部工具生成物与历史会话材料:.zread wiki 快照 28 个文件删除并同步移除 lint 忽略清单对应项;.ai/prompt/2026/**0310 至 0812 期间积累的 AI 会话过程材料 744 个文件一次性全删、无一行新增,考古需求改由版本历史承担。设计「工具辅助检查与评审」合同落档并新增仓库根 README:落定复用已有 Oxc 工具链、主动取得机械检查证据、先概览后展开、按覆盖分工四条约定,动作索引同步扩展为「选择或执行静态检查、格式化、代码评审」;README 承接新环境安装(Node.js/pnpm)、本地检查与格式化命令表。实施归置质量工具选型调研过程材料 87 个文件:逐一评估复杂度插件、重复检测、变异测试与阿里 F2ELint、字节 Rslint、腾讯 TCA 候选,结论收敛为复用现有 Oxc 工具链、不引入新工具;过程中实跑复杂度扫描 1044 文件、69 项诊断、53 文件受影响;批次执行器注释示例同步改为实际工单目录。
- ✅ 厂家候选接入远程 keyword 搜索,设备编号保持本地搜索 〔es-center-server-web-app〕
实施共享 RemoteCombobox 新增判别式搜索模式:remote 关键词进入查询身份与候选缓存键,输入停顿 300ms 查询、清空立即恢复、输入法组合期不提交中间词;远程候选不再本地复筛,已选回显、核验与精确回填按不含关键词的业务范围隔离;厂家两租户分支改发 keyword(对应后端名称/编号合同)、回填仍只按厂家 ID,设备编号显式声明本地模式不触发关键词请求;补齐查询切换、等待态、同查询缓存、异词拒绝、A→B→A 旧请求隔离与回填测试,受影响单测 6 文件 284 项全绿。实施候选 keyword 搜索 01 票收尾:12 项验收全勾,Comments 记录实现提交、单测、双轴评审两轴闭合与真实 UI 两分支核对(关键词出站、编号命中仍显示、清空恢复、窄屏键盘、设备编号零请求);输入法组合输入无真实驱动、有缓存模式缺真实入口等缺口如实保留。
- ✅ 候选 keyword 后端收尾:租户树剪枝缺陷修复、五个树入口候选验证与前端交接回执 〔es-center-server-services〕
排障修复租户树搜索剪枝缺陷:缺父查询不再继承 keyword,避免关键词与租户类型条件组合时把父节点排除、导致整支后代漏剪(关键词仍只作用于主查询行级筛选);同批完成租户、组织普通/目标缓存、设备类型普通/目标五个树入口候选关键词验证,补真实 HTTP、PostgreSQL 与真实 JetCache 代理用例,覆盖仅编号命中、双命中去重、先过滤再限量、租户与准入隔离;API 合同与 06 票回执同步更新并如实记录未部署,定向批 195 项零失败零跳过。协作完成 07 票前端交接回执:汇总 22 个 method/path 的合同、实现提交、测试证据与可复现样例,单列字典管理主体列表与三类本地选择器边界,纠正 DeviceList2 多直播链与通用型号目标回填使用 list 两处事实偏差;如实注明运行时未部署、前端接线与浏览器验收未完成。实施终审裁定三处清理与建批收尾:删除已不可达的 pageTree 测试分支及随之无引用的常量、补 5 个新增文件末尾换行、合并 user-center 文档相邻两个兼容章节(文本逐字未改);批次建批、入口切换与结票留痕,无生产源码与断言语义变化。
- ✅ 单实现查询接口收敛:全仓 216 个接口排查、唯一整改对象内联与判据修订 〔es-center-server-services〕
设计立项排查全仓 216 个主源码接口:97 生成 Mapper、95 生成服务契约、15 函数式、3 真多态、2 跨模块 SPI 等,确认唯一待整改对象为对讲群组数据采集设备查询服务并定位为 2026-07-13 迁移残留——消除横向依赖靠实现类进入宿主,接口拆分并非必要条件;拆内联与判据修订两票,95 个生成契约与真多态接口等均不动。重构单实现接口内联落地:删除接口、实现类改为同名 @Service 类,移除 implements 子句与 6 个 @Override,行为、HTTP 合同、SQL 与 Mapper 不变;一个 Web 测试的 mock 注册方式随具体类调整(改走单例注册避免注解注入二次加工 mock 实例),定向 6 类 206 项与数据权限 53 项零失败零跳过。设计编码原则判据修订与两轮评审澄清:「以后可能有第二个实现」不构成保留接口的理由,须点名现存替换点、跨模块边界或行为注解;应用读取组装默认内联为 *QueryService 命名的普通类,历史正例改为带日期的反例记录;评审发现的两处表述缺陷(限定句缺失、「实现」字面与内联决定相反)最小编辑澄清、判据不变。实施批次入口切换与逐票收尾:两张工单翻 done、验收全勾,评审结论与证据边界回写(锚点与外链未检查的边界如实注明),七份测试报告留存。
- ✅ 工具类判据与命名规范收敛七票:规范落文、仓库级扫描器、四族重构与基线白名单退场 〔es-center-server-services〕
设计立项与规范落文:全仓排查出 68 个 @UtilityClass 之外另有 12 个同类性质纯静态类手写私有构造或可被 new,类名混有 *Utils/*Constants/*Helper/*Support 四种抽屉后缀、还有一个装三件不相干事情的 utils 包;规范落地静态工具类判据、五条命名规则与机检边界(判据从 Guava API 表面与 JDK 惯例归纳,非自创体系),GLOSSARY 拆开工具类四种被混用的含义,两篇 ADR 分别记录抽屉后缀取舍与认证主体全局静态状态(登记为带触发条件的已知架构债)。测试仓库级约定扫描器:把「纯静态类必须标 @UtilityClass」「类名不得以抽屉后缀结尾」两条规则落地为构建期可断言的约定测试(复用已验证的 AST 遍历路线、不新增依赖),存量违规 25 条(12 缺注解 + 13 抽屉后缀)显式基线登记、集合相等断言让新增违规立即失败;扫描器测试 8 例零失败零跳过,清点结果与票面预估 26 条的差异为 5 个类同时命中两条规则。重构四族收敛:分页族 PageMetadata 改名 Pages 并新增统一入口、125 处引用机械替换、仪表盘日期工具按职责拆为日期区间与 KPI 卡片两类(127 文件,定向 15 类 116 项含真实 PG 全绿);安全族解散 security.utils 包,权限码与解析规则同处一类、IP 工具改 ClientIps、SecurityUtils 机械拆为主体读写与密钥解析两类(99 文件、其中 84 文件纯引用替换,三模块定向 45/301/39 项全绿);常量族五个抽屉类按内容改名、实际含 8 类内容的 DataSyncConstants 拆为 7 个主题类(票面预估 3 类、维护者裁决补齐 4 类,75 文件、四模块定向 53/2/64/154 项零失败零跳过);其余族清除最后三个抽屉后缀、6 个纯静态类补注解删手写私有构造(33 文件,扫描器 8、main 88、device 15 项全绿)。测试基线白名单退场:四族收敛后基线清空,删除白名单机制,扫描器从「只对新代码生效」变为全仓无条件强制、断言改为「违规集合为空」,规范机检段同步为无豁免表述;红验证(临时违规类触发失败、删除后复绿)证明闸门未退化为静默豁免,测试由 8 例调整为 7 例零失败,全仓构建全绿。实施改名族验证策略裁决与逐票收尾:03–06 票验收统一改为按改动面选类执行、不跑全量 testAll(单模块无筛选测试被判无收益),根构建 testAll 能力保留为发布级全量回归出口而非批次义务;批次入口两次切换、决策图 7 票全部完成、最终绿跑证据与各票结票留痕。
- ✅ 质量工具口径沉淀:仓库根 README 与三工具调查证据 〔es-center-server-services〕
设计新增仓库根 README:沉淀新环境工具清单(JDK 21、Gradle wrapper、Python 3.10+ venv)与核验命令,wrapper 版本以配置文件为准;固定 Lizard 1.26.0 与 jscpd 5.4.3 的安装与手动辅助 AI 审查用法,标明未接入 Gradle、提交钩子或 CI、PIT 尚未接入;7 个 Bash 代码块经语法检查全绿。设计Lizard、jscpd 与 Gradle PIT 三工具调查证据留存:记录版本口径、语义边界、jscpd 基线/增量选项与 PIT 兼容性四层核验,含本轮工具事件与读取失败恢复续记;结论为选型建议而非接线验证——优先 Lizard 定位复杂函数、jscpd 原生基线定位新增克隆、PIT 仅限有快速行为测试的关键逻辑,未接线、未新增任何门禁。
- ⚠️ keyword 前端批次 01–16 票推进到部署后复测:主框接入、导出失效守卫与共享原子件提炼、终票集成验收 〔es-center-server-web-app〕
其它工作
- 目标: 记录日常杂项工作、协作沟通等事务
- 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
- 📌 以往已自测工作不再重复,详情请查看上周及上月报告
- 16 日
- ✅
协作git → svn 源代码同步 - ✅
实施将最新版本部署到192.168.1.53/zxs-cs/zxs-ca服务器: 编译最新程序 → 制作 Docker 镜像 → 制作升级程序 → 上传服务器 → 升级部署 〔es-center-server-build, es-center-server-install-app〕
- ✅
Last updated on