diff --git a/.workbuddy/memory/2026-10-30.md b/.workbuddy/memory/2026-10-30.md new file mode 100644 index 0000000..23d9f7e --- /dev/null +++ b/.workbuddy/memory/2026-10-30.md @@ -0,0 +1,48 @@ +# 2026-10-30 + +本轮目标(goal 第 1 轮):**全站重新整理**——统一 UI/交互、统一功能入口、删过时逻辑。按「先审计、后动刀、逐项验证」推进。 + +## 已完成(4 个提交) + +1. `01a9521` 补提交:上午 scripts/ 整理的未提交改动(run.sh/deploy.sh 迁移 + legacy/ 归档)。 +2. `e1fbb89` **死代码清理(web)**: + - `regionOptions` / `stackBar` / `barList`:全库 grep 只有定义无调用,删。 + - `state.idle` / `state.projects` / `state.customStage`:定义后再无读写、不在 UI_FIELDS,删。 + - styles.css:`.board-grid` `.pcard*` `.svg-chart` `.legend` `.risk-item` 零引用整块删; + `.b-name .star` 选择器删。`bar-row/b-track/b-val` **保留**(人员归属卡手写模板在用, + 一开始误删后按 `grep -c 'bar-row' app.js` 复活——教训:删 CSS 前连类名一起查模板字符串)。 + - 过时注释纠偏(定制 tab 早已是 3 个、分类筛选器位置)+ README「.pcard 只做记录未删除」备注兑现。 +3. `b1ba391` **交互一致性补最后几处洞**: + - 全局 `unhandledrejection` → toast 兜底:行内按钮(归档/星标/人员归档等) + fire-and-forget 的失败不再静默。局部已有 catch 的不受影响(rejection 被消费)。 + - 项目/定制抽屉「标记重点/取消重点」补成功 toast(全站惯例「写操作必提示」的最后两处漏网)。 + - 设置页保存配置失败改 toast「保存失败:原因」;数据库卡片非 sqlite 不再显示 data/board.db。 +4. `b54cb19` **功能入口一致性:6 个导出端点 ↔ 6 个 UI 入口一一对应**: + - 发现:10-01 精简看板时删了工具栏(`bcb3feb`),但 README 看板章节、导出表、 + `.board-toolbar` 样式、`/api/export/updates`(看板)与 `/api/export/custom-updates` + (从未有过 UI)全留着 → 文档承诺 vs 实际按钮不一致。 + - 恢复:看板工具栏 = 负责人筛选(花名册下拉、进 UI_FIELDS、只过滤两栏清单)+「导出 Excel」 + (按顶栏周期,`/api/export/updates`);定制「项目总览」加「导出周期记录」→ `custom-updates`。 + - README 看板工具栏行 + 导出表两行改为与实现逐字一致。 + +## 机制核实(不改,属长期基础设施) + +- `schema_patch.ensure_columns`:项目约定的「加字段免迁移」机制,永久保留。 +- `security.migrate_legacy_rbac`:幂等(目标表非空即跳过),服务老库升级,保留。 +- `guard` + `SEGMENT_MENU/EXPORT_MENU` 单点鉴权、`finance.py` 财务口径唯一入口:设计良好,未动。 +- constants.py 37 个常量全部有引用;index.html 34 个 id 全部被 JS 引用;无重复 id; + 原生 alert/confirm/prompt 零残留;无 TODO/FIXME/调试残留。 + +## 验证 + +- `node --check web/app.js` 每步通过;pytest 84 passed(后端零改动)。 +- 起临时实例 :8799 冒烟:login 200 → `/api/weekly?owner=` 200 → + `/api/export/updates` 与 `/api/export/custom-updates` 均 200 且为合法 xlsx;测毕下线。 +- 用户本机 dev 实例 :5173(--reload)全程未受影响,前端刷新即见新版。 + +## 未做/遗留(下轮候选) + +- 两个后台审计子代理尚未回稿(前端深度审计 + 后端死端点审计),回收后可能有增量清单。 +- `/api/tags`(GET/POST/DELETE)与 `POST /api/tasks` 前端零调用、仅测试引用—— + 待后端审计交叉确认后删或留。 +- 浏览器实机点击看板新工具栏(负责人切换 + 两个导出)——接口已冒烟,界面回归需人工。 diff --git a/.workbuddy/memory/MEMORY.md b/.workbuddy/memory/MEMORY.md index 4ec6221..90e57ed 100644 --- a/.workbuddy/memory/MEMORY.md +++ b/.workbuddy/memory/MEMORY.md @@ -74,6 +74,9 @@ - **宽台账横向滚动是设计如此**:`.tbl-wrap{overflow-x:auto}`,「操作」列 sticky 在右。项目总览 17 列 / 本周进展 16 列都靠横向滚动,滚到最右时末列与操作列紧邻(gap=0),**不算遮挡**,别为了“消除溢出”去砍列。 - **文案**:界面不放解释性长句;只保留删除确认里的「请改用归档」一行、直接写入/AI 整理的 radio 短注、登录页品牌语。 - **表格紧凑**:列多时加 `tbl-tight`(左右内边距 8px)。 +- **导出入口一一对应(2026-10-30)**:`app/routers/export.py` 的 6 个 xlsx 端点各有唯一 UI 入口:custom/custom-updates → 定制「项目总览」工具条(导出 Excel / 导出周期记录,后者按顶栏周期);projects → 自研产品;updates → 工作看板工具栏「导出 Excel」(按顶栏周期,不受负责人筛选影响);focus / staff → 各自列表。新增导出端点必须同时给按钮并登记 README 导出表。 +- **写操作必有 toast 反馈 + 全局兜底(2026-10-30)**:所有写成功都提示(含星标切换这类小动作);失败提示在局部 catch,另有全局 `unhandledrejection → toast("操作失败:…")` 兜底(`toast()` 定义后紧跟注册)。fire-and-forget 的行内按钮因此不会静默失败。 +- **删样式前查模板字符串**:类名可能由 JS 模板手写引用(`bar-row` 曾被误判死代码——`barList()` 函数死了但人员归属卡仍在手写该结构),按「类名在 app.js/index.html 出现次数」判定,不按「函数是否有调用」。 ## 术语(2026-10-01 更新)