2026年04月27日

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

中心服务平台 - 功能完善

进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
- 以往已完成的工作不再重复，详情请查看上周及上月报告
- 〔工作量〕services 4 次（设计 1 · 代码 3）· 代码 +0.2k/-0.2k ｜ web-app 154 次（设计 30 · 代码 124）· 代码 +21.0k/-4.6k ｜ install-app 0 次
- 〔方法论〕原型设计驱动（.pen 设计稿先于代码落地）｜ dashboard 优化 skill 与提示词持续沉淀｜业务聚焦四准则: 同屏统览 · 因果并呈 · 结论速达 · 快捷处置
- 4-27 ~ 4-30: 报表首页及子页面原型设计下钻 · 首批 .pen 品质优化 · 设备详情查询接口
  - 🟡 报表首页及子页面原型设计下钻〔web-app〕
    - 设计 围绕「同屏统览、因果并呈、结论速达、快捷处置」业务聚焦，下钻报表首页及在线 / 资源 / 告警子页面原型设计
    - 设计 改进 AI 提示词；持续沉淀 dashboard 优化 skill 文档与设计规则
    - 实施（AI 辅助）优化 dashboard-1-online-2.pen: UI / 数据 / 规范品质提升
  - ✅ 设备详情查询接口设计与实现〔services〕
    - 设计 编写设备详情查询接口设计文档（先于代码落地）
    - 实施（AI 辅助）新增数据采集设备按 ID 查询详情 GET 接口，Mapper 补查询字段并同步设计文档
    - 实施（AI 辅助） retail list 接口添加 firmwarePackage 固件包数据查询（默认 default 租户）
  - ✅ 工程与工具链清理〔services〕
    - 实施 移除 .claude/ 下 OpenSpec 技能与 opsx 命令模板（删约 1100 行），精简 .vscode 配置与依赖锁，新增 nacos 配置片段
- 5-01: dashboard 系列子页面 .pen 集中优化与表格体验修复
  - ✅ 在线 / 资源 / 告警子页面 .pen 品质打磨〔web-app〕
    - 实施（AI 辅助）优化 dashboard-1-online-1/2、resource-1/3、warning-2 系列 .pen: 图标统一、变量清理、字体修正、排名徽章、颜色阈值、洞察栏、危险指示、迷你图可读性
    - 实施（AI 辅助） dashboard-1-warning-2 四轮迭代: UI / 商业 / 数据 / 规范品质提升
  - ✅ 表格体验修复与辅助脚本〔web-app〕
    - 实施（AI 辅助）修复表格列换行: 加宽数据列（120→140 等）、紧凑数据格式
    - 实施（AI 辅助）名次列表头去图标改纯文本，修复表头换行
    - 实施（AI 辅助）新增表格列校验辅助脚本；补 resource 第二轮脚本与 dashboard 截图归档
- 5-02 ~ 5-03: dashboard 设计迭代收尾与优化 skill 沉淀
  - 🟡 dashboard 设计迭代与 skill 收尾〔web-app〕
    - 设计 持续 dashboard 设计稿迭代并清理临时截图
    - 设计 收口 dashboard 优化 skill 文档与设计规范

其它工作

目标: 记录日常杂项工作、协作沟通等事务
进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
- 📌 以往已自测工作不再重复，详情请查看上周及上月报告
- 27 日
  - ✅ 协作 git → svn 源代码同步
- 29 日
  - ✅ 协作 业务讨论会: 会前准备、参会及会后总结

备忘

郭工反馈的:
- 获取某些设备最新固件信息时，系统返回 “No firmware package is maintained”。经沟通确认，原因是部分设备编号在多个租户下同时存在，导致数据查询路径出现异常。后续需核查代码或进行优化以解决此问题。
- 需要开发一个获取单个设备详细信息的 http 接口, 包含设备的共享数据
- 用户头像上传接口开发, 头像地址应包含在当前用户信息和被分享者信息中
- 分享限制暂定 10 个（非固定值，可配置化），API 分享接口需增加校验逻辑。
- 排查分享失败的问题: 18173039499 guodi1991, 我设备共享的时候 13265528013 提示用户不存在，但用户名 aednzw又可以，看下什么情况呢
- 获取单个设备详细信息的 http 接口中, 还需要包含最新固件信息