2026年05月25日

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

中心服务平台 - 功能完善

进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
- 以往已完成的工作不再重复，详情请查看上周及上月报告
- 〔工作量〕web-app 39 次（设计 6 · 代码 33）· 代码 +8.1k/-6.3k
- 〔方法论〕PDCA 多轮审查收敛｜逐模块统一抽取（分页·类型·命名）｜生产就绪评审驱动修复｜任务编排先行
- ✅ 报表首页及子页面前端与 mock API 复核，推演 API 实用性，为后续后端 API 开发进行前置验证，避免开发多余或不实用的 API。
- 5-25: 报表（dashboard）查询与通知基础演进
  - ✅ 数据查询与通知基础演进〔web-app〕
    - 重构（AI 辅助） useRequest 由 cacheKey 改为 throttleWait 节流，避免缓存键膨胀
    - 重构（AI 辅助）通知统一为 toast.success/toast.error，区分成功与错误类型
    - 实施（AI 辅助）引入 timeRange 驱动 KPI 刷新，清理冗余图表逻辑
- 5-26: 分页统一迁移与首轮代码审查
  - ✅ 分页统一迁移到 ahooks usePagination 〔web-app〕
    - 重构（AI 辅助）七个页面手动分页统一迁移到 usePagination（设备、存储、电池、上传、告警详情、告警排名、在线服务器）
    - 重构（AI 辅助） timeRange 贯穿各查询；server KPI 接口加 timeRange 参数
    - 重构（AI 辅助） alert-ranking 重命名为 warning-ranking 并补显式 GET 方法；同步重命名 mock 数据文件与路由组件
  - ✅ 首轮代码审查修复〔web-app〕
    - 实施（AI 辅助） target=0 守卫、边界检查、“Page Average” 标签修正
  - ✅ AI 工具链维护〔web-app〕
    - 实施（AI 辅助）更新 ahooks、pencil-design 等 agent skills 文档与提示词
- 5-27: PDCA 多轮收敛与共享层抽取
  - ✅ PDCA 审查多轮收敛〔web-app〕
    - 实施（AI 辅助）第 3 轮: device buildKpiProps 补 target=0 守卫；warning detail 补 gps 兜底与 SummaryRow 长度校验
    - 实施（AI 辅助）第 4 轮: cards.length 守卫、零除防护（total||1）、sparklineData 空数组检查
  - ✅ 共享层抽取与常量整合〔web-app〕
    - 重构（AI 辅助）抽取汇总计算到 _shared summary-utils，ranking 页脚统一为 SummaryRow
    - 重构（AI 辅助）整合 RATE_THRESHOLDS，移除散落的 USAGE_RATE/POWER_RATE 常量
    - 设计 拆分 dashboard 共享类型整合任务编排（13 步: shared types / kpi-utils / 各路由）
  - ✅ AI 工具链维护〔web-app〕
    - 实施（AI 辅助）批量更新 pen2code、ui-ux-pro-max 等 skills 文档与历史提示词 README
- 5-28: 字段命名规范对齐与组件库升级
  - ✅ 字段命名与类型规范对齐〔web-app〕
    - 重构（AI 辅助） dashboard 路由迁移到 _shared types/kpi-utils
    - 重构（AI 辅助） server 字段语义重命名（id→dataAcquisitionServerId/deviceNo，标签 “Server SN”→“Server No”）
    - 重构（AI 辅助）字段命名规范化（Location→InstalledLocation、InstallTime→InstalledTime）
    - 设计 确立 Sentence Case 命名规则，补 Step 02/05 PDCA 复验日志
  - ✅ 组件库升级与规范应用〔web-app〕
    - 实施（AI 辅助） shadcn/ui 组件库升级
    - 实施（AI 辅助） UI 文本与 mock 数据统一应用 Sentence Case；import 迁移到 ~/ 别名
    - 实施（AI 辅助）已绑定设备禁用行选择，简化未绑定计数
- 5-29: 生产就绪评审与构建优化
  - ✅ 生产就绪评审与修复计划〔web-app〕
    - 设计 编写 dashboard 生产就绪评审规格与生产修复实施计划
    - 设计 记录 cacheKey 决策: token 已含租户 ID，移除 I1 cacheKey（计划与规格同步标注）
  - ✅ 类型安全加固与构建优化〔web-app〕
    - 实施（AI 辅助）类型安全加固（ColumnDef 去 any、API 响应类型验证）与错误处理改善；mock 数据统一
    - 实施（AI 辅助） dashboard 验证收口与 lint baseline 清理
    - 实施（AI 辅助）生产构建优化: 路由重构、计算 memoize、精简 mock 数据
- 🔘 报表首页及子页面数据对接: 大部分源于设备，小部分源于采集服务器。
- 🔘 报表首页及子页面所需 API 的开发。

其它工作

目标: 记录日常杂项工作、协作沟通等事务
进度: 🔘 未开始 -> 🟡 进行中 -> ⚠️ 部分完成 -> ✅ 已完成 -> 📌 已自测
- 📌 以往已自测工作不再重复，详情请查看上周及上月报告
- 25 日
  - ✅ git → svn 源代码同步
  - ✅ 制作最新版本更新程序，部署到 zxs-cs 进行测试
  - ✅ 修正测试出的问题:
    - ✅ 部分 mock 加载方式与 nginx 配置冲突
  - app/routes 中有大量 toast 过时的写法，应统一改为 app/routes/($lng)/client-init.tsx 有语义的写法，需要注意 i18n 的写法要统一（比如: 其中的变量名）
  - ✅ AI 提效:
    - ✅ 研究: /goal 及 superpowers 融入到 raw/模板/提示词生成模板 的可行性
    - ✅ 改进: raw/模板/提示词生成模板、raw/模板/提示词模板、raw/模板/步骤模板、raw/模板/闭环触发语
- ✅ 在 Mac 和手机上安装 PonyCam app，进行测试，并将测试结果反馈给郭工。
- 26 日
  - ✅ git → svn 源代码同步

备忘

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