docs(readme): 固化「删除=危险确认 / 归档=直切+toast,定制项目归档因影响财务口径为唯一 warn 例外」的确认分级

main
mula.liu 2026-11-04 01:53:22 +08:00
parent d5d607db70
commit 8504ef6e45
1 changed files with 1 additions and 0 deletions

View File

@ -414,6 +414,7 @@ python scripts/legacy/add_entry_date.py --force # 全部重算
- **报错一律中文**:Pydantic 422 与未捕获 500 在 `app/main.py` 的 exception handler 统一换成中文 `detail`(「提交的数据有误:…」/「服务器内部错误…」),前端 `api()` 原样 toast,界面不中英夹杂。新增 `/export/*` 必须登记 `security.EXPORT_MENU` 权限归属,未登记一律 403(fail-closed,防「忘挂权限 = 登录即可下载」)。
- **反馈矩阵(只有这三条通道)**:弹窗内报错 → `modalError()`(`#mErr` 行内提示);抽屉表单报错 → `formError("fdErr|cdErr|dwErr", msg)`(行内提示,传空串清除);其余一律 `toast()`;破坏性动作只走 `confirmDialog()`。异步写处理器先本地 try/catch 提示并**中断后续刷新/重开**,全局 `unhandledrejection` 兜底只兜漏网之鱼。
- **弹窗主按钮文案**:新建=`创建`、编辑=`保存`、动作确认=`确认+动词`(确认下线 / 确认清空);提交即 `disabled` 防重复提交,失败恢复。危险动作的触发按钮用 `.btn.danger` / `.icon-btn.danger`,配套 `confirmDialog({danger:true})`。
- **删除 vs 归档的确认分级**:删除 / 清空 / 强制下线 = 破坏性 → `confirmDialog({danger:true})` + 红色触发钮;归档 / 恢复 = 可逆 → **直接切换 + toast**(自研项目、每周工作、人员花名册均如此)。唯一例外:**定制项目归档要确认**(warn 级,不带 danger)——归档会把它从财务统计与下单/验收口径里摘除,影响数字,值得一次停留。
- **关键字搜索全应用一个行为**:页内搜索框(`bindKeyword`)与顶栏全局搜索同为 **320ms 防抖实时查询**,共用 `state.keyword`,不再区分回车/实时两套。列表卡头「共 N 条」一律取**过滤后**条数,与分页器一致。
- **归档过滤统一**:自研产品 / 重点工作 / 定制项目用「含归档」`switch` 开关(`state.showArchived` / `focusArchived` / `customArchived`=`false|all`),人员花名册用三态下拉(在用 / 已归档 / 全部,导出跟随同一状态)。