From 7a7b83a271676368678ec7b466bb59d3fd382cb3 Mon Sep 17 00:00:00 2001 From: "mula.liu" Date: Wed, 4 Nov 2026 01:38:21 +0800 Subject: [PATCH] =?UTF-8?q?docs(memory):=202026-11-04=20=E5=B7=A5=E4=BD=9C?= =?UTF-8?q?=E6=97=A5=E5=BF=97=20+=20=E5=8F=8D=E9=A6=88=E7=9F=A9=E9=98=B5/?= =?UTF-8?q?=E6=8C=89=E9=92=AE=E6=96=87=E6=A1=88/=E6=90=9C=E7=B4=A2?= =?UTF-8?q?=E9=98=B2=E6=8A=96/=E6=AD=BB=E5=88=97=E7=99=BD=E5=90=8D?= =?UTF-8?q?=E5=8D=95=E5=85=A5=20MEMORY?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .workbuddy/memory/2026-11-04.md | 27 +++++++++++++++++++++++++++ .workbuddy/memory/MEMORY.md | 5 +++++ 2 files changed, 32 insertions(+) create mode 100644 .workbuddy/memory/2026-11-04.md diff --git a/.workbuddy/memory/2026-11-04.md b/.workbuddy/memory/2026-11-04.md new file mode 100644 index 0000000..20fac6f --- /dev/null +++ b/.workbuddy/memory/2026-11-04.md @@ -0,0 +1,27 @@ +# 2026-11-04 工作日志 + +全站整理改造第二轮:死代码大扫除(前端+模型层)、录入页权限闭环、交互统一收口、导出/参数一致性。 + +## 提交(按序) + +1. `2026040` backend 死代码大扫除:security(menus_json/level_of/require_level/migrate_legacy_rbac 整体下线,MENUS/LEVEL_RANK/json/inspect 再导出清理)、audit(TRACKED_GETS、/purge 分支)、schemas(PeriodIn/TaskIn/SettingsIn)、constants(NEGATIVE_STATUS/PRIORITY_MAP/CUSTOM_STAGE_ORDER/CUSTOM_STEP_ORDER/custom_current_step)。token_hint 经查为活契约,保留。 +2. `7ff0242` **录入页跨菜单依赖**:guard 新增 assist 分支——GET custom/meta、GET custom/projects、POST custom/updates 按 custom/intake 较高级别放行;只有「更新录入 rw」的账号也能录定制项目(此前直接 403 白屏)。回归测试锁定四种越界组合。 +3. `5601950` web 死代码:intakeParsed/drawerProject/drawerCustom/孤立注释/restoreUI later 分支(UI_KEY→v2);styles.css 删 side-*/kanban(留 kcard-remark)/funnel/ab-foot/af-foot/ic-sm;icons.js 删 6 个零引用图标 + .kcol-title 选择器 + names 导出,剩 48 个全在用(脚本核验)。 +4. `cf0f3a1` 交互统一 A:弹窗按钮文案(保存修改/添加/新建/新增→保存/创建)、danger 对齐(强制下线、清空日志)、5 个 fire-and-forget 写处理器本地 catch、角色/重置密码防重复提交 + 密码 ≥6 前置校验、afterWrite 刷新失败不吞调用方流程、focus/projects 卡头 count 改过滤后条数。 +5. `2711046` 交互统一 B:定制三 tab 卡头补齐(周/年卡头 + 删无人用的 hdr 形参)、项目总览加「含归档」开关(customArchived)、**bindKeyword 删 enter 分支**——页内搜索与顶栏统一 320ms 防抖;抽屉报错收敛成 formError() 助手,顺带修 fdSave 缺完成时间时按钮卡死的 bug;README 设计语言补 4 条规范。 +6. `dd01827` 后端一致性:/export/projects 默认 all→false(跟随页面口径,搜归档要显式 archived=all,既有导出测试改写)、custom/projects 删零引用 key_only、补 4 个契约测试(meta 全集键 / 定制删除连带 / 导出默认 / ensure_columns 幂等)→ 93 passed。 +7. `0f201b8` 模型层:Period.start/end_date、Task.sort_order、CustomProject.currency、ImportLog.to_dict、**LedgerItem 整表下线**(连带 import_excel《项目明细表》段与 LEDGER_CATEGORIES)。Project/Category/Staff 的 sort_order 与 other_owners/accept_date_real 在用未动。 +8. `18f97cd` 卡头统一:7 处手写 .card-head 改 cardHead();录入页「新增定制项目」按钮补 canW(custom) 门槛 + 空引用保护。 +9. `2e4d0b7` **冒烟抓出的真 bug**:删 NOT NULL+default 列后存量库 INSERT 撞约束(新库测试全绿测不出)。schema_patch 新增 STALE_COLUMNS 白名单 + drop_stale_columns()(启动定点 DROP COLUMN,SQLite ≥3.35),main.py 接线;README 补「列级对齐」小节。 + +## 验证 + +- pytest 93 passed(本轮新增 9 个测试全绿);node --check app.js/icons.js。 +- :8799 存量库冒烟:启动自动清理 4 死列(PRAGMA 复核消失)、定制创建 200;intake-only 账号 meta/清单/交付记录 200、定制详情 403、管理员 200;日志服务端分页 total/items 正常;导出 200。 +- 用户 :5173 dev 服务器全程未动。 + +## 遗留(下一步) + +- 「添加记录」入口三种走法(看板弹窗 / 项目抽屉跳录入页 / 定制抽屉两者都有)要不要统一成弹窗——待产品拍板。 +- 其余 6 个 dict 白名单 PATCH 端点保持 dict 语义(已写进 README 前言),暂不改 Pydantic。 +- legacy/ 归档脚本仍引用 LedgerItem,按历史留档不修。 diff --git a/.workbuddy/memory/MEMORY.md b/.workbuddy/memory/MEMORY.md index 329326a..ad7b4dd 100644 --- a/.workbuddy/memory/MEMORY.md +++ b/.workbuddy/memory/MEMORY.md @@ -22,6 +22,7 @@ - `scripts/legacy/`:历史一次性脚本(`migrate_custom.py`、`shift_year.py`、`fix_period_split.py`、`merge_project.py`、`add_entry_date.py`),不参与启动、不进镜像。 - `.workbuddy/memory/` 存每日工作日志(随仓库提交,2026-09-12 起)。 - `schema_patch.ensure_columns` 会在启动时自动给已有表补上模型里**新增的可空列**(`ALTER TABLE ... ADD COLUMN`),所以加字段只需改 `models.py`,不用写迁移脚本。 +- **删字段同样要动老库**:删掉 `NOT NULL + Python default` 的列后,存量库的残留列会让 INSERT 直接撞 NOT NULL(新库测试全绿也发现不了,2026-11-04 冒烟踩实)。规矩:删列必须同步登记 `schema_patch.STALE_COLUMNS` 白名单,启动时定点 `DROP COLUMN`(SQLite ≥3.35);只删白名单,不做「模型没有就删」的全量对账。`LedgerItem` 台账快照表已同日下线(只有 import_excel 写、零读取方),老库 `ledger_items` 表原地保留。 ## 业务模型 @@ -77,6 +78,10 @@ - **导出入口一一对应(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-11-04 定稿)**:弹窗报错只走 `modalError()`(#mErr)、抽屉表单报错只走 `formError(id,msg)`(fdErr/cdErr/dwErr)、其余一律 `toast()`、破坏性动作只走 `confirmDialog()`;fire-and-forget 写处理器先本地 try/catch 并中断后续(刷新/重开),不靠全局兜底。 +- **按钮文案(2026-11-04 定稿)**:新建=「创建」、编辑=「保存」、确认=「确认+动词」;主按钮提交即 disabled 防重复;危险动作触发钮 `.danger` + `confirmDialog({danger:true})`。 +- **搜索只有一个行为(2026-11-04)**:`bindKeyword` 与顶栏全局搜索都是 320ms 防抖实时,enter 选项已删,别再加回去。卡头「共 N 条」= 过滤后条数(shown.length),列表卡头一律 `cardHead()`,不许再手写 `.card-head`。 +- **归档过滤**:projects/focus/custom 用「含归档」switch(custom 走 `customArchived=false|all`),staff 用三态下拉;导出默认一律 `archived=false`(含 /export/projects,2026-11-04 起,搜归档项目需显式 all)。 ## 术语(2026-10-01 更新)