docs(memory): 2026-11-04 工作日志 + 反馈矩阵/按钮文案/搜索防抖/死列白名单入 MEMORY
parent
2e4d0b76d9
commit
7a7b83a271
|
|
@ -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,按历史留档不修。
|
||||
|
|
@ -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 更新)
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue