Skip to Content
工作周报2026 年度总结2026年09月28日

2026年09月28日

内容截止日: 2026年10月04日

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

中心服务平台 - 功能完善

  • 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
    • 以往已完成的工作不再重复，详情请查看上周及上月报告
    • 〔工作量〕es-center-server-services 32 次（设计 8 · 代码 24）· 代码 +1.1k/-1.0k ｜ es-center-server-web-app 12 次（设计 2 · 代码 10） ｜ es-center-server-install-app 2 次 · 代码 +1.5k/-0.5k ｜ es-center-server-build 1 次 ｜ es-center-server-agent 1 次
    • 〔方法论〕显式选测 ｜ 读取准入收口 ｜ 审计驱动收口 ｜ 具名统一
    • 9-28: Org 术语入册、跨租户管理路线图、显式选测与测试执行入口、旧个人空间退役与发布制品推进
      • ✅ Org 组织术语入册与跨租户管理路线图发布 〔es-center-server-web-app〕
        • 设计 入册 Org（组织）词条: 租户内按父子关系组成层级的组织单元，组织管理语境中的「部门」同指该实体，Avoid 独立 Department/Dept 用法
        • 设计 发布管理员跨租户业务管理路线图与后端交接: 规划主文（模块盘点、依赖顺序、交付节奏裁决）与后端开发交接文档入库，后续各模块分别走 to-spec → to-tickets → implement，节奏为先全部后端接口、再统一前端
      • ✅ 显式选测票实施与批次接线 〔es-center-server-web-app〕
        • 实施 单测入口要求显式选测: 定向和全量单测独立命令入口，拒绝空选择与掩盖零测试的参数并传递 Vitest 失败状态，verify 收敛为类型、lint、格式三项静态检查
        • 实施 拒绝不执行测试的 Vitest 选项: 拦截帮助、版本和维护类选项，避免未执行测试却返回成功
        • 实施 失败于部分选测与零执行: 用 Vitest reporter 检查实际执行数与逐个选择范围的文件命中，避免部分拼错仍返回成功
        • 实施 拒绝 runner 选项后的尾随选测范围: 保留常用 reporter 与并发参数的空格取值写法，与 Vitest 不区分大小写的文件匹配语义对齐
        • 实施 接受 Vitest 带值选项与规范化路径: 对齐本仓 Vitest run 的带值选项，防止有效空格取值被当作尾随范围而拒绝
        • 实施 从 Vitest 帮助解析空格取值选项: 仅在遇到空格取值时读取已安装 Vitest 的扩展帮助，拦截扩展帮助本身这类不执行测试的选项
        • 排障 修复全量串行运行下帮助输出捕获偶发为空: 动态选项帮助输出写入临时文件后解析，避免 worker 子进程管道偶发为空而误拒合法选项
        • 协作 显式选测票 16 项验收收口回写
        • 协作 run-item.sh 接入 explicit-unit-test-selection 票目录
      • ✅ 组织读取与旧新增请求合同对齐 〔es-center-server-web-app〕
        • 实施 对齐组织读取与旧新增请求合同: v1 根组织读取类型接受服务端省略父字段的投影，旧业务新增的三个表单字段直接进入原 HTTP API，生产改动限于两处前端文件
      • ✅ 旧个人空间列表退役与管理清理批次发布 〔es-center-server-services〕
        • 重构 删除已淘汰的旧个人空间采集设备列表入口: 按维护者裁决注销路由与 OpenAPI operation、已认证请求返回 404，现存个人空间设备列表为 v1 retail list 且合同不变
        • 设计 发布既有管理能力清理建图与两张决策票: wayfinder 建图 map、评审记录与旧个人空间列表退役验证证据，租户查询边界、清理范围与验证两张 grilling 决策票入库
        • 设计 固定管理清理规格与租户边界裁决输入: 维护者已确认的租户读取裁决、清理证据、统一规格和四张实施票纳入当前分支，不把决策完成当作代码交付
        • 协作 批次入口切换至 management-cleanup-implementation，注释收敛已完成批次入口行
      • ✅ 租户读取合同收口与认证定位边界 〔es-center-server-services〕
        • 重构 收口租户读取与认证定位合同: 新增 ADR-0095 并精确标注五份旧 ADR 的部分取代范围，统一插件作用域和显式 SQL 缓存的适用前提，移除三处无作用的 SneakyThrows
        • 设计 校准认证空参例外与存量调用边界: 三条认证 TODO 移到 token 比对后的实际范围选择处，本次只批准三条认证调用、其它旧空参调用待逐入口裁决
        • 协作 租户读取规则与认证定位工单收尾回写
      • ✅ Gradle 测试执行入口两票 〔es-center-server-services〕
        • 实施 显式启用 Gradle 测试与慢测: 根项目及 26 个子模块 Test 任务加严格布尔总开关、slow 标签隔离慢测，默认跳过以缩短日常构建
        • 协作 显式测试执行票按双轴审查补齐 PTT 手册验证日期与范围后收口
        • 实施 按测试类显式选择 Gradle 验证: 以 Gradle 原生 —tests 作为类/方法选择入口，移除首版布尔属性与慢测标签，ADR-0096 精确部分取代 ADR-0025
        • 实施 隔离混合任务并收紧免测范围: 定向 —tests 放行绑定到唯一模块 Test 任务路径，仅 .md/.sh diff 不启动 Java 单测
        • 协作 按测试类选择验证工单收尾回写，02 票验收措辞同步 ADR-0096 测试类选择
      • ✅ PTT 可选键修正 〔es-center-server-services〕
        • 排障 PTT 选择不适用时省略 defaultTalkGroupId 键: 未指定、指定不适用或无有效群组时省略整个键、不再发送空串占位，设备端按可选字段消费（ADR-0069 决策 3）
      • ✅ TODO/IMPORTANT 注释语义拆分与跨租户约束改标 〔es-center-server-services〕
        • 设计 拆分 TODO 与 IMPORTANT 注释标记语义: TODO 只标记未完成动作、已实现但须持续遵守的关键约束统一用 IMPORTANT，两种语义不得混用
        • 重构 跨租户关键约束注释统一改标 IMPORTANT: 8 个文件 15 处已实现跨租户约束的 TODO 注释改为 IMPORTANT，纯注释改动不改运行时行为
      • ✅ 组织 Plus 查询 SQL 复用 〔es-center-server-services〕
        • 重构 组织 Plus 查询共用同义 SQL 片段: 12 个普通字段条件、主排序和组织父资料列集中在手写 Plus Mapper，管理详情与列表共用资料关联
        • 测试 区分父资料排序并锁定双租户旧读: 父编号与名称排序产生不同实际顺序并分别断言，补旧 Plus 在 A/B 同组织 ID 下的非空结果
        • 协作 组织 Plus SQL 复用工单收尾回写
      • ✅ 20260923 发布制品机械推进与构建链路重构 〔es-center-server-install-app〕
        • 实施 制品引用与部署验收记录推进 20260923: 8 份部署脚本包引用 202609211708 → 202609231715，镜像标签 20260921 → 20260923，promgt 构建日志示例推进至 202609231530
        • 重构 构建链路按检查结论重构: build.sh 默认只本地生成安装/升级/Coturn/Janus 四种包，—backup 与 —upload 显式开启备份和上传，凭据外置并新增构建链合同测试
      • ✅ 20260928 发布版本推进与上传通道调整 〔es-center-server-build〕
        • 实施 dev.sh 发布版本推进 20260928: flow、build、deploy 三段版本引用推进，47.121.142.93 通道改为上传 main-service 镜像，107.174.255.35 通道收窄为仅 main-service
      • ✅ 构建与联调路径适配 /mnt/wsl 工作区 〔es-center-server-agent〕
        • 实施 cargo target-dir 由 /tmp 迁至 /mnt/wsl 持久工作区，dev-1.sh 的本机复制与 scp 源路径同步，内网服务地址切为 192.168.1.53 随本机联调环境
    • 9-28（晚间）: 组织重生成验证、Web 读写合同收口、设备号 Function 边界与平台租户 ID 统一
      • ✅ 组织重生成验证与 Web 读写合同收口 〔es-center-server-services〕
        • 测试 固定组织最终手写副本重生成证据: 独立输出根记录 1,915 个 fresh 文件、800 个 true 文件恢复和 1,115 个 false 文件保留的逐文件摘要，归档真实 PG 元数据与生成编译验证
        • 协作 缓存模板与再生成保护工单收尾回写
        • 协作 完成组织 Web 读写合同票: 记录测试租户两条旧业务新增的真实请求、Boolean 响应与服务端 ID 回读，留存浏览器结果与证据边界
        • 测试 记录组织 Web 测试后端部署日期: 明确该日期与源码基线均不能代替未提供的部署 Git SHA 或镜像 tag
        • 测试 组织浏览器证据与后端测试对齐: 对照后端新旧组织新增的字段白名单、缺省角色、服务端 ID 与 Boolean 响应断言，补旧入口空串父字段组合
        • 测试 用旧入口复验前端三字段新增请求: 覆盖空父根组织及使用服务端父 ID 的子组织，独立连接核对服务端生成的组织身份、租户归属和父关系
      • ✅ 设备号 Function 边界裁决与平台租户 ID 统一 〔es-center-server-services〕
        • 实施 守住设备号 Function 的精确定位边界: 三个设备号 Function 保留同号投影选择并分别记录准入、隔离前提与缓存 miss 成本，固件与 ICE 两处拦截 null/空串设备号
        • 重构 统一平台预置租户 ID: es-center-server-core 集中定义 default、pcm、scm 三个领域租户 ID，勘误 ADR-0058 事实来源并在触及的跨租户范围选择点记录 IMPORTANT 准入
    • 9-29（凌晨）: 缓存合规审计归档与 ADR-0095 挂账核对批次发布
      • ✅ 全仓缓存合规审计与免租户名单闭合 〔es-center-server-services〕
        • 审查 归档全仓 Service 缓存方法合规审计: 扫描全仓 Service 层 131 个缓存查询方法——真违例 0、名实不符瑕疵 2、挂账存量 11 处，作为挂账拆票与免租户表名单闭合的共同依据
        • 重构 ValueSet 读缓存改双态租户键并纠正死参数名: tenantId 经 JetCache 默认参数序列化进缓存 key，纠正审计点名的名实不符死参数，全仓零调用方故无消费者迁移
        • 实施 免租户表名单按审计结论两服务对齐: 共同新增 user_center_user_tag，device-service 补齐三张表与 main-service 一致，双方均达 6 张免租户表全覆盖
        • 协作 批次入口切换至 adr0095-pending-entries-adjudication
        • 设计 发布 ADR-0095 挂账入口核对 spec 与 02–05 票: 承载决策 4 的逐入口核对义务（8 处待裁决 + 3 处已批准对照清单），新增三张裁决票与 ADR 具名批准回写票

其它工作

  • 目标: 记录日常杂项工作、协作沟通等事务
  • 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
    • 📌 以往已自测工作不再重复，详情请查看上周及上月报告
Last updated on
2026年09月21日开发文档