Skip to Content
工作周报2026 年度总结2026年06月29日

2026年06月29日

内容截止日: 2026年07月05日

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

中心服务平台 - 功能完善

  • 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
    • 以往已完成的工作不再重复，详情请查看上周及上月报告
    • 〔工作量〕es-center-server-services 80 次（设计 22 · 代码 58）· 代码 +8.7k/-4.7k ｜ es-center-server-web-app 33 次（设计 13 · 代码 20）· 代码 +12.4k/-7.2k
    • 〔方法论〕契约锁定先行 · 图标与导航集中化简化
    • 6-29 ~ 6-30: 房间动作与 Janus 管理
      • ✅ 群组事件和设备动作消息链路建立，真实房间操作仍待后续 〔es-center-server-services〕
        • 设计 约定 Service（业务服务层）保存/删除事件、JMS（服务间消息通知）命名和设备动作；手动操作与实施计划成文，区分群组事实与 PTT（按住讲话）refresh、room ensure/destroy 动作。
        • 实施 群组保存事件、主服务监听与设备动作壳接通，手动端点投递刷新/房间确保消息；配置构造、真实 MQTT（发布订阅消息协议）与 Janus 调用不在本阶段。
        • 实施 PTT refresh 按在线状态过滤并去重设备号，缓存失败或全离线时跳过；删除刷新误用记录仪 ID 的待办留痕，7-01 修正为 deviceNo。
        • 重构 room ensure（确保房间就绪）/destroy 壳内联到 PttV1 监听；分页上限 clamp（超界截断）统一。
        • 实施 操作摘要先统一英文，随后移除自定义 summary、统一真实路由 tag。
        • 审查 核对仓库惯例，决定不保留自定义操作摘要。
        • 测试 先用反射测试固定英文摘要，随后改为断言 summary 为空、tag 正确，记录两阶段元数据变化。
      • ✅ Janus（对讲底层音视频网关）服务器增改查管理链路补齐 〔es-center-server-services〕
        • 审查 两轮复审核对并调整事务、必填字段、租户隔离、删除消息与共享编号校验。
        • 设计 按复审结论修订方案，按 DTO（接口数据结构）→Service→SQL→API 安排实施。
        • 实施 Plus（复杂查询扩展层）合同、Service、SQL 和 API 接通；编号/名称/重复性校验、租户与在线状态组装完成，单删复用设备删除消息。
        • 重构 Janus 编号校验共享，按 ID 和列表查询改为短期缓存，删除路由调用实际单删入口。
        • 测试 覆盖校验器、Service、Controller、单删消息和缓存调用路径。
      • ✅ 分区表保存成功的误报修复，采集服务器日志标题纠正 〔es-center-server-services〕
        • 排障 分区触发器重定向写入后返回 0 affected rows，原实现把成功报为 false；保存/保存更新改为执行无异常即 true。
        • 实施 采集服务器删除日志恢复正确领域标题，历史 Service 格式随整理统一，删除已失去对应实现的旧测试。
    • 7-01 ~ 7-03: 群组缓存、成员关系与审查
      • 🟡 整体落地方案继续完善 〔es-center-server-services〕
        • 设计 修订 v0.0.7，更新 v0.0.8（07-02），随本周实施补充细节。
      • ✅ 群组列表缓存与统一写操作日志建立 〔es-center-server-services〕
        • 设计 列表缓存先约定权限、凭据不回显、默认上限和缓存时间；删除无消费方的更新消息。
        • 实施 列表缓存合同与端点接通，TalkGroup/Janus 写日志再推广到全服务；记录谁在何时改了什么。
        • 重构 列表上限集中到共用 helper，保持默认值与范围。
      • ✅ 设备成员关系接口及字符串标志迁移完成 〔es-center-server-services〕
        • 设计 先定单条/批量关系 API、事务、默认群组唯一性、组织权限、不可换绑和提交后刷新规则，安排实施步骤。
        • 实施 关系 API 与服务规则接通，canSpeak/isDefault 改为字符串 1/0，刷新目标使用设备号；重复迁移脚本撤回，保留单一基线。
        • 测试 覆盖批量去重、默认唯一性、事务与消息边界。
      • 📌 周度质量审查完成，敏感日志与审计缺口留下明确发现 〔es-center-server-services〕
        • 审查 2026-07-01 核对 JMS、Janus Plus、查询上限、写日志和分区保存；发现敏感入参明文记录风险与只记成功返回的审计缺口，保留执行证据与复跑脚本。
      • ✅ 关系 Plus 查询、群组删除与列表扩展完成 〔es-center-server-services〕
        • 设计 7-02 先记录关系 Plus/删除、list overload（同名接口扩展版本）、安全响应和设备关键词过滤设计。
        • 实施 关系 Plus 返回设备号，支持按群组批量软删并接入删除监听；列表 overload 迁移，采集设备可按关键词过滤，凭据只返回已配置状态。
        • 重构 简化关系/群组 ID 与字符串流归一化；Janus online 字段改为 onlineStatus。
        • 测试 核对关系 HTTP 租户/权限、范围和 SQL 边界；清理过时测试并更新快速构建说明。
    • 7-03: 关系职责与设备视图
      • ✅ 关系服务完成瘦身，群组删除不再触发 PTT 刷新 〔es-center-server-services〕
        • 设计 规划服务精简、方法命名和逻辑删除字段修正，划分 HTTP 校验与持久化职责。
        • 重构 关系校验上移 Controller，Service 保留持久化；群组删除只保留关系清理和房间销毁，PTT 刷新交由后续组合接口处理。
        • 测试 以公开行为核对软删除、批量关系和返回结果。
      • ✅ 设备与群组双视角列表、分页端点建立 〔es-center-server-services〕
        • 设计 先确定设备→群组、群组→设备的 DTO、权限、查询、批量装配与实施计划。
        • 实施 合同和抽象方法先行，再实现 Mapper SQL、结果装配与四个端点；主记录与关联明细分段批量查询。
        • 测试 强化视图 Mapper 合同和 HTTP 边界，覆盖租户、权限、逻辑删除与分页。
        • 重构 防止 Janus join（连表）放大行数；内联 Mapper 调用、请求体与范围约束，简化在线状态与设备关系处理，删除一次性报告。
    • 6-29 ~ 7-03: 运维页、导航与对讲工作台
      • ✅ Janus 运维页接入导航，表单和列表完成调整 〔es-center-server-web-app〕
        • 设计 先确定 UI 与实施计划。
        • 实施 Janus API、路由骨架、列表、表单、选择器与导航接通；编号校验先对齐后端，再移除前端冗余校验，列表修复备注过滤。
      • ✅ 图标集中管理，导航按租户拆分 〔es-center-server-web-app〕
        • 重构 图标先整理为动态/静态/其它三张图标表，再将剩余其它图标迁入静态表。
        • 设计 多轮澄清导航缓存粒度、前缀复用、team 默认源和分支，完成计划与评审。
        • 重构 导航 mock（模拟数据）按 default/pcm/scm 拆分并建立映射，删除租户黑名单过滤、简化加载；新构建使旧缓存失效。
      • ✅ 集群对讲模块建立，工作台和编辑器按体验发现调整 〔es-center-server-web-app〕
        • 设计 先记录集群对讲 UI 与体验优化方案，实测问题清单涵盖设备列表、批删、密码切换与搜索按钮。
        • 实施 新增工作台/群组/设备/房间路由族、关系状态模型与 API；调整控件，把设备切换移至工具栏，精炼群组编辑表单。
        • 设计 提示词编排随实现同步。
        • 实施 生成引用与导航 mock 随实现同步。

其它工作

  • 目标: 记录日常杂项工作、协作沟通等事务
  • 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
    • 📌 以往已自测工作不再重复，详情请查看上周及上月报告
    • 29 日
      • ✅ 协作 git → svn 源代码同步
      • ✅ 排障 排查测试服务器无法登录: 根因为数据库内存不足宕机
Last updated on
2026年06月22日2026年07月06日