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

2026年06月22日

内容截止日: 2026年06月28日

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

中心服务平台 - 功能完善

  • 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
    • 以往已完成的工作不再重复，详情请查看上周及上月报告
    • 〔工作量〕es-center-server-services 33 次（设计 14 · 代码 19）· 代码 +6.2k/-1.8k ｜ es-center-server-web-app 11 次 · 代码 +21.1k/-0.9k ｜ es-center-server-install-app 15 次 · 代码 +1.2k/-2.0k ｜ es-server-deploy 1 次
    • 〔方法论〕升级集成四线并进（镜像 / 前端 / 安装程序 / Nginx）｜ 对讲群组设计先行·校验复用收敛
    • 6-22 ~ 6-24: Janus 升级与连接验证
      • ✅ Janus Gateway 升级到 1.4.1，前端接入官方页面 〔es-center-server-web-app〕
        • 设计 Janus 是对讲通话的底层实时音视频网关。升级方案按镜像、前端、安装程序、Nginx（反向代理）四条线展开，三端集成各自明确改动。
        • 实施 接入新版官方 demo（示例页面），调整 settings/admin 页面；demo 从 html/ 迁到根路径并挂载到构建路由。
        • 设计 升级任务记录、Agent 指南、隐私政策和使用条款同步维护。
      • ✅ 安装与升级配置接入新网关，端口与密钥可配置 〔es-center-server-install-app〕
        • 实施 最新稳定版镜像与安装程序配套完成；.env 变量、模板、现行配置和升级包同步，Nginx 接入公共 WebSocket、Admin WebSocket 和 Admin HTTP 代理。
        • 排障 多台测试服务器多轮回归中，逐项排查 FATAL/ERR/WARN 日志和 ICE（音视频连接协商）异常；ICE Lite/ICE TCP 临时启用验证后回退，最终继续完整 ICE 模式。
        • 实施 清理未用 sample 和 Streaming 演示流、重复 transport 区块及 nice_debug；统一 pcma 与 Admin Secret 变量，使用带时间戳无颜色日志，关闭 IPv6/link-local 与显式 TURN 转发。发布引用随调试更新，自动上传阶段性限于 CS、CA。
      • ✅ 公网域名增加 Janus 信令与管理代理 〔es-server-deploy〕
        • 实施 Nginx 新增 Janus WebSocket 和 Admin HTTP 反向代理，补齐升级头、长超时和来源请求头。
      • ✅ 集群对讲整体方案 v0.0.7 成为讨论确认版 〔es-center-server-services〕
        • 设计 经多轮讨论确认 v0.0.7，可进入群组查询、创建、编辑和房间生命周期的落地设计。
      • 🟡 v0.0.8 在 v0.0.7 基础上起草，尚未定稿 〔es-center-server-services〕
        • 设计 继续细化 v0.0.8 整体落地方案。
    • 6-25 ~ 6-26: 数据模型与群组接口
      • ✅ 群组、设备关系与 Janus 数据模型及基础接口建立 〔es-center-server-services〕
        • 实施 新增数据库表、群组 PTT（按住讲话）字段、分区触发器和索引，重跑生成器建立 Entity/DTO/Mapper/Service/Controller（数据实体、接口对象、查询映射、业务服务与请求入口）基础；Janus 主键统一为 janusServerId，adminSecret 保留为普通必填字段。
        • 实施 群组关系更新禁止改写绑定两端；MQTT（发布订阅消息协议）旧遥测/获取请求只匹配含 /iot/ 的主题，避免误转其它协议。
      • ✅ 对讲群组分页接入数据权限 〔es-center-server-services〕
        • 设计 使用 Plus Mapper（复杂查询扩展层），明确组织及下级范围与数据权限取交集，不返回房间敏感凭据；组织存在与权限校验从 list 收敛为 org plus query / org count。
        • 实施 扩展分页 DTO、路由和 SQL，返回组织/Janus 信息及设备统计；复杂 SQL 不覆盖生成的基础查询。无数据保持空分页，非从节点停止时不清理同步日志。
        • 审查 核对分页实现、API 和查询字段，修正文档方法拼写。
      • ✅ 对讲群组创建 / 保存接口完成 〔es-center-server-services〕
        • 设计 保存计划先明确群组 ID 字符串规则、默认值、PIN（房间加入码）、组织权限和 room ensure（确保房间就绪）消息；真实 Janus 创建不在本轮范围。
        • 实施 放宽默认字段必填校验，保存时验证 ID/PIN/组织，生成 roomSecret、写默认参数，成功后投递房间确保消息。
        • 重构 群组 ID / PIN 校验复用，默认值下沉 Service；内联 select 整理为 Mapper 片段。
      • ✅ 群组编辑校验完成，未更新字段保持可空 〔es-center-server-services〕
        • 设计 澄清 Janus 编号格式和 DTO 可空边界，细化房间队列需求与 updateById 笔记；编辑保存 janusNo，不触发跨节点房间迁移或配置推送。
        • 实施 保存/更新统一校验 Janus 与组织字段；删除和更新使对应缓存失效。
        • 测试 覆盖默认编号、合法/非法字符、校验顺序、组织不存在/越权及 DTO 可空字段。
        • 重构 跨对讲校验共享 safe-id 字符匹配器，统一允许的 ID 字符。
      • ✅ 群组后续查询与设备动作的设计、评审记录完成 〔es-center-server-services〕
        • 设计 记录 Plus Mapper / DTO / Service 统一诉求，设计 JMS（服务间消息通知）保存/删除事件及 PTT refresh、room ensure/destroy 动作壳；真实 MQTT/Janus 留待后续。
        • 评审 双方案实施评审核对任务覆盖、依赖与生成文件边界。
        • 实施 忽略本地 worktree，调整 Gradle 自动导入设置，更新 clean-build 显示说明；说明文字改变没有改变实际执行命令。
        • 设计 更新 Agent 说明。

其它工作

  • 目标: 记录日常杂项工作、协作沟通等事务
  • 进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
    • 📌 以往已自测工作不再重复，详情请查看上周及上月报告
    • 22 日
      • ✅ 协作 git → svn 源代码同步
      • ✅ 协作 隐私政策补充内容并重排章节序号（含英文版同步）
      • ✅ 协作 制作并部署前端镜像到测试服务器
      • ✅ 协作 沟通开放测试环境服务器端口（供 Janus Gateway WebSocket 使用）
    • 23 日
      • ✅ 协作 SpiritCam 隐私政策补充内容、用户服务协议排版
      • ✅ 协作 制作并部署前端镜像到测试服务器
Last updated on
2026年06月15日2026年06月29日