docs(memory): 2026-10-30 工作日志 + 界面约定新增三条(导出一一对应 / 写反馈兜底 / 删样式先查模板)

main
mula.liu 2026-10-30 18:25:54 +08:00
parent b54cb19523
commit 4a0a1faa2b
2 changed files with 51 additions and 0 deletions

View File

@ -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` 前端零调用、仅测试引用——
待后端审计交叉确认后删或留。
- 浏览器实机点击看板新工具栏(负责人切换 + 两个导出)——接口已冒烟,界面回归需人工。

View File

@ -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 更新)