2026年05月18日

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

中心服务平台 - 功能完善

进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
- 以往已完成的工作不再重复，详情请查看上周及上月报告
- 〔工作量〕services 26 次（设计 6 · 代码 20）· 代码 +1.0k/-0.7k ｜ web-app 19 次 · 代码 +5.9k/-3.4k ｜ install-app 3 次
- 〔方法论〕设计先行（头像设计文档驱动实现）｜配置驱动重构（undeletableTenants → init-tenant-map）｜热路径性能护航（O(1) 查找）｜按租户拆分管理界面
- ✅ 报表（dashboard）首页及子页面原型持续转换为前端代码（追求 100% 还原度），并新增报表菜单入口以便演示与测试。
- 5-18: 报表（dashboard）在线页收尾
  - ✅ 在线页状态筛选与数据格式统一〔web-app〕
    - 实施（AI 辅助）在线页新增状态筛选；存储与上传量统一为字节并用 formatFileSize 格式化
    - 重构（AI 辅助）清理 dashboard 页 COLUMNS 数组与死代码；SummaryRow 子项改用模板字符串
    - 实施（AI 辅助）新增报表菜单图标与 mock 数据
- 5-18 ~ 5-21: 用户头像上传链路（PonyCam 需求）
  - ✅ 用户头像上传: 设计先行与前后端落地〔services / web-app〕
    - 设计 编写用户头像上传功能设计文档；明确头像路径以复用现有 Nginx 配置；编写实现计划，设备分享头像改为 Java 层缓存填充
    - 实施（AI 辅助）用户头像上传功能（后端）
    - 设计 补用户头像上传 API 接口文档
    - 实施（AI 辅助）用户头像显示与上传（前端）
- 5-19: init-tenant-map 租户初始化配置统一
  - ✅ 租户初始化配置统一与查询优化〔services〕
    - 设计 init-tenant-map 租户初始化配置统一设计与实施计划
    - 重构（AI 辅助） undeletableTenants 替换为 initTenantMap；配置迁移为列表；TenantController.checkUndeletable 与 TenantMessagesPlusListener 改为配置驱动初始化
    - 实施（AI 辅助） checkUndeletable 热路径恢复 O(1) Set.contains 查找
    - 实施（AI 辅助）租户列表查询改用缓存；JWT token 过期时间延长至 3 天
- 5-20: scm / pcm 多租户划分与专属导航
  - ✅ 多租户管理界面拆分: spirit-cam-manage / pcm 租户初始化〔services / web-app〕
    - 实施（AI 辅助） spirit-cam-manage 租户 ID 缩短为 scm、新增 pcm 租户（PonyCam manage）
    - 实施（AI 辅助）支持按租户加载专属导航数据
- 5-21 ~ 5-24: SpiritCam 固件管理链路
  - ✅ SpiritCam 固件包管理: 查询与上传重构、公网接口迁移〔services / web-app〕
    - 实施（AI 辅助）固件包新增 updateById 接口、上传重构为流式处理
    - 实施（AI 辅助）固件包查询重构为版本前缀匹配、公网（免登录）接口迁移至 main-api
    - 重构（AI 辅助）固件包改用 deviceModelId 精确匹配、支持部分更新
    - 实施（AI 辅助）前端固件包页面拆分为 SCM/Original 共享组件；未上传文件禁用提交；按固件头显示 deviceModelId；上传 UX 改进与文件校验
- 5-18 ~ 5-23: 工程配置与 AI 工具链维护
  - ✅ 工程配置与 AI 工具链维护〔services / web-app〕
    - 重构（AI 辅助）统一 .ai/prompt 目录结构为 YYYY/MMDD/HHMM/README.md
    - 实施（AI 辅助） tasks.json 新增 clean-build 任务与 kill-debug 前置任务
    - 实施（AI 辅助）更新 apple-app-site-association 路径；更新 agent skills（新增 pencil-design、playwright-dev、web-design-guidelines）
    - 实施（AI 辅助）从 Git 跟踪移除 .claude 与 .agents 目录
    - 实施（AI 辅助） Evolver hooks / Evolution Memory / GEP 资产短暂引入后移除
- 🔘 报表首页及子页面数据对接: 大部分源于设备，小部分源于采集服务器。
- 🔘 报表首页及子页面所需 API 的开发。
- 🔘 报表首页及子页面前后端联调。

其它工作

目标: 记录日常杂项工作、协作沟通等事务
进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
- 📌 以往已自测工作不再重复，详情请查看上周及上月报告
- 18 日
  - ✅ git → svn 源代码同步
  - 郭工反馈的:
    - 🟡 SpiritCam api 需求: 开发专属免登录 HTTP 接口，用于获取单个设备的详细信息，接口返回内容需包含设备最新固件信息。本接口关联固件维护类需求，例如前端上传界面开发、上传功能开发等。
      - ✅ 后端已完成
      - 🟡 前端进行中 10%
    - 🟡 PonyCam api 需求: 用户头像上传接口开发，头像地址应包含在当前用户信息和被分享者信息中
      - ✅ 后端已完成
      - 🔘 前端未开始
- 19 日
  - AI 提效:
    - 提炼后续可复用的 skill 到 Obsidian 中
    - claude code 配置 mcp 与 Obsidian 联动，并提炼提示词文件及 spec 中的内容为 skill 及提示词模板到 Obsidian 中
    - 注册 evomap 帐号，配置接入多个 agent node
  - 郭工反馈的:
    - 🟡 SpiritCam api 需求: 开发专属免登录 HTTP 接口，用于获取单个设备的详细信息，接口返回内容需包含设备最新固件信息。本接口关联固件维护类需求，例如前端上传界面开发、上传功能开发等。
      - ✅ 后端已完成
      - 🟡 前端 40%
    - 🟡 PonyCam api 需求: 用户头像上传接口开发，头像地址应包含在当前用户信息和被分享者信息中
      - ✅ 后端已完成
      - 🟡 前端未开始
- 20 日
  - AI 提效: 调研使用 CodeGraph 的实际效果
  - ✅ 系统架构调整，应初始化 PonyCam manage、SpiritCam manage 等，并按各自的业务需求定制界面
    - ✅ 后端已完成
    - ✅ 前端未开始
  - 郭工反馈的:
    - 紧急处理: curl -i https://zxs.netbodycamera.com/.well-known/apple-app-site-association 需要 Content-Type: application/json
      - 排查发现: 是升级脚本中还有一套 nginx 配置没有改，导致部署后未生效
- 21 日
  - 郭工反馈的:
    - ✅ PonyCam api 需求: 用户头像上传接口开发，头像地址应包含在当前用户信息和被分享者信息中
      - ✅ 后端已完成
      - ✅ 前端已完成
    - 🟡 SpiritCam api 需求: 开发专属免登录 HTTP 接口，用于获取单个设备的详细信息，接口返回内容需包含设备最新固件信息。本接口关联固件维护类需求，例如前端上传界面开发、上传功能开发等。
      - ✅ 后端已完成
      - 🟡 前端已完成，测试中: 比较费劲，需对齐设备端取头信息的方式
  - 客户需求讨论沟通: 欧阳剑、绍华及我
- 22 日
  - 郭工反馈的:
    - ✅ SpiritCam api 需求: 开发专属免登录 HTTP 接口，用于获取单个设备的详细信息，接口返回内容需包含设备最新固件信息。本接口关联固件维护类需求，例如前端上传界面开发、上传功能开发等。
      - ✅ 后端已完成: 根据多个测试结果，改进接口的处理逻辑
      - ✅ 前端已完成: 根据多个测试结果，改进界面的操作细节

备忘

郭工反馈的:
- PonyCam api 需求: 微信登录，接入微信官方接口，提供授权信息标识
- PonyCam 需求: 整理 api error 清单并翻译好。给他确认后导入系统