From 3c5cc544f57186835649d215fe10c72476510588 Mon Sep 17 00:00:00 2001 From: shunli Date: Sun, 11 Oct 2026 09:22:34 +0800 Subject: [PATCH] =?UTF-8?q?=E8=BF=BD=E5=9B=9E=E8=AF=81=E6=8D=AE=E5=88=B7?= =?UTF-8?q?=E6=96=B0=E6=9C=9F=E9=97=B4=E7=A6=81=E7=94=A8=E9=80=89=E6=8B=A9?= =?UTF-8?q?=E5=B9=B6=E4=BF=AE=E5=A4=8D=E5=91=98=E5=B7=A5=E8=B5=84=E6=96=99?= =?UTF-8?q?=E7=99=BB=E5=BD=95=E8=AF=AF=E6=8A=A5=EF=BC=8809-17-company-loan?= =?UTF-8?q?-principal-repayment=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 上传银行证据后、刷新完成前,证据下拉框与确认按钮禁用并提示,避免空证据提交 - 员工来源版本去掉 updated_at(登录会刷新),保留全部真实资料字段的拦截 - 补登录误报回归、字段变更拦截、两项变异及刷新挂起的浏览器检查 - 任务记录 E 节与 AC52–55,独立只读复核无阻断项 Co-Authored-By: Claude Opus 5.5 --- .../implement.md | 14 ++++++- .../prd.md | 11 ++++- .../common/LoanBankReconciliation.tsx | 15 +++++-- scripts/qa/company-loan-employee-fixture.cjs | 24 +++++++++++ .../qa/company-loan-employee-mutations.cjs | 20 +++++++-- .../company-loan-reconciliation-browser.cjs | 41 +++++++++++-------- server/src/services/loanLenderEmployee.js | 11 +++-- 7 files changed, 104 insertions(+), 32 deletions(-) diff --git a/.trellis/tasks/09-17-company-loan-principal-repayment/implement.md b/.trellis/tasks/09-17-company-loan-principal-repayment/implement.md index 1c3fa339..59aae2ba 100644 --- a/.trellis/tasks/09-17-company-loan-principal-repayment/implement.md +++ b/.trellis/tasks/09-17-company-loan-principal-repayment/implement.md @@ -1,3 +1,15 @@ +## 2026-10-10 E:追回证据刷新提示与员工资料误报(已实施、本地验证完成;未提交) + +用户批准两项方案后实施,基线 `91fe31f0`;未提交、推送、部署或连接生产,无新迁移。资料拦截规则先由实施会话自查;2026-10-11 另一会话独立只读复核结论 `REVIEWED_NO_BLOCKER`,无阻断项,补跑 12 组服务层内存探针与电脑/手机 4 组组件浏览器检查,两轮 247 项回归与 11 项变异只核对日志未重跑;回执 `review-20261011.json` 中 7 个文件摘要与提交前工作区一致。复核限制:组件补验的 API、身份为合成替身;上线前打开的旧 v1 预览在上线后保存会被要求重新核对(有意拒绝旧版本);未跑完整发布门禁。 + +- E1 追回证据刷新(原 D2 的 P3):上传成功后对话框仍立即关闭;后台刷新完成前,对账弹窗内所有证据下拉框禁用、占位项显示“正在刷新证据列表…”、下方 `role=status` 提示“刚上传的证据稍后可选”,确认按钮同时禁用(禁用的必填下拉框不参与原生校验,单禁下拉会让空证据离开浏览器)。刷新结束(成功或失败)自动恢复。未采用 D 阶段撤回的“刷新完再关闭”。 +- E1 测试:抽出 `uploadWithHeldRefresh`,用门闩挂起批次详情刷新,断言选项仅占位、下拉与确认均禁用、提示可见、零 POST;放行后下拉恢复、含刚上传证据 ID、确认可用。常规回归在第一笔追回(15.00)执行,诊断模式 `refund` 的首段由“复现旧占位项被原生校验拦截”改为同一新行为断言(旧行为已不可能出现,原证据保留在 D 阶段日志)。 +- E2 员工资料误报:根因证实——成功登录会清零失败计数,Prisma `@updatedAt` 刷新员工 `updated_at`,而来源版本包含该时间。版本标签升为 `loan-employee-source-v2`,去掉 `updated_at`(不再查询),保留姓名、所属公司、状态、归档、开户行、银行机构(含启用/归档)与账号密文。`employee_no` 由数据库触发器禁止修改,确认页显示但无需入版本;尝试加入时测试被触发器拒绝,已撤回并在注释写明。 +- E2 测试:员工预览后真实错误登录再正确登录,断言 `updated_at` 已变而来源版本不变、保存成功;姓名、开户行、所属公司、银行机构四项在保持 `updated_at` 的情况下逐一修改均 409 `loan.employee_source_changed` 且不建出借人。变异由 9 项增至 11 项:版本漏姓名、恢复修复前指纹(多处变异,查询与哈希同时加回 `updated_at`),后者以 `login_reported_as_source_change` 精确识别。 +- 只读复核要点:保存写入的字段(姓名、银行机构、开户行、账号)全部在版本内;状态/归档另在读取时拒绝;确认页的公司名称来自公司表,不入员工版本,与修复前一致;已登记出借人与历史付款快照不受影响。 +- 结果:员工专项 + 变异 11/11 通过;`refund-diagnostic.log` 电脑/手机五步诊断全部通过;常规完整回归 `full-regression-r1/r2.log` 各退出 0、83 个迁移、12 个阶段、去重 247 项(244 + 登录误报 1 + 电脑/手机刷新提示 2),自有资源清理 PASS;前端 typecheck/build、Prisma validate 通过。过程日志(缺环境变量、粗粒度变异判定、`employee_no` 触发器拒绝、改码前中止的回归)均保留。证据在 `artifacts/qa-flow/loan-employee-source-fingerprint-20261010/`。 +- 剩余:员工与公司组合的数据库唯一约束仍待先查存量重复再单独规划;上线随下次发版,发版前跑完整门禁。 + ## 2026-10-10 D:本地提交收尾(用户已明确授权) 用户已明确授权本次本地提交,范围为两项遗留失败的测试修复与诊断补验、授权列表的分页前筛选及弹窗重开重置,以及本任务记录和既有 backend spec,共 14 个文件。沿用下节已完成的业务验证,提交前补做最终文档、治理、敏感内容和暂存差异检查;具体提交结果以 Git 回执为准。 @@ -212,7 +224,7 @@ cd ../client && npm run build | 2:技术排查,可与 N5 并行 | 开发确定性复现授权对话框翻页超时 | 复用本任务,先形成局部排查方案。隔离环境构造超过 30 个符合列表条件的出借人,明确目标位于第二页或以后;电脑/手机均断言实际翻页、请求和选项渲染完成,再选择目标并完成授权。留存失败响应、时序及脱敏截图,区分等待竞争、服务端响应和界面问题。仅修改等待方式或未触发该分支的通过不能结案;若实际办理遇到,提升优先级。 | | 3:业务主线 N6 | 财务申请、网银提交及代账交接;马经理按公司代表身份确认 | N5 完成后,按真实付款安排明确本次金额、逐借款分配及日期;申请 → 确认 → 导出 → 实际网银提交并登记提交详情 → 正式付款回单核验/必要人工确认 → 核销 → 代账交接。以本次已付本金和可定位的银行交易为验收依据,不从余额推定全额还款,不为测试制造付款。扫描付款回单按付款路径的人工依据与确认规则办理。 | | 4:技术优先项 | 开发评估将回单重检的文件读取/PDF 解析移到全局锁外 | 沿 N3 已记录的 P3 优先顺序设计;锁内保留原件摘要、版本、权限及全部状态重验。用重检与认领/人工核验/执行并发、附件作废/换版等反例证明不使用过期结果,再独立只读复核。工作线程限时 5 秒不是整个持锁时长的上界;不能只凭耗时变短判定修复完成。 | -| 5:技术近期项 | 开发验证员工来源版本的误报,再评估数据库唯一约束 | 来源指纹包含员工 `updated_at`,登录会更新认证字段;先验证“财务预览后员工登录再保存”的冲突,不泛称每次登录必然提示资料变化。修正时须同时保留姓名、公司、状态和银行资料真实变更的拦截。唯一性当前由代码检查与员工行锁保护、缺少员工和公司组合的数据库唯一约束;新增约束前明确归档/空员工语义并检查存量,不直接加迁移或清理真实记录。 | +| 5:技术近期项 | 开发验证员工来源版本的误报,再评估数据库唯一约束 | (E2 已修复误报并经 2026-10-11 独立复核;唯一约束仍待办)来源指纹包含员工 `updated_at`,登录会更新认证字段;先验证“财务预览后员工登录再保存”的冲突,不泛称每次登录必然提示资料变化。修正时须同时保留姓名、公司、状态和银行资料真实变更的拦截。唯一性当前由代码检查与员工行锁保护、缺少员工和公司组合的数据库唯一约束;新增约束前明确归档/空员工语义并检查存量,不直接加迁移或清理真实记录。 | | 6:线上验收补证 | 运维准备账号与安全凭据来源,财务/马经理补借款角色验收 | 现有通用 live smoke 需要管理员、员工两类账号;凭据通过受控本地环境或既有秘密配置提供,不写聊天和任务记录。先确认检查范围与授权,再执行登录后只读页面/权限检查。通用 smoke 不覆盖本次借款登记及公司代表确认,后者随 N5/N6 留证。真实云 OCR 单列授权和验收;带 OCR 的准备脚本会上传材料,不能当纯只读 smoke 执行。 | | 7:较低优先级改进 | 开发与财务明确旧记录重检、记账日期、字段提示规则 | 旧记录缺少原云端限制字段,重检不能重建未保存证据,先明确策略再实施;记账日期下限先区分正常还款与历史补记,不直接统一硬卡审批日;第五轮 N1 可统一 OCR 与本地无效编号的提示,但保持整段校验、多页关联和冲突拦截不变。 | | 8:文档收尾 | 开发提交发布记录及本次清单 | 内容与检查已具备,可在收到明确本地提交授权后单独提交;提交说明引用当前 task。此次梳理不自动提交,也不再次部署。 | diff --git a/.trellis/tasks/09-17-company-loan-principal-repayment/prd.md b/.trellis/tasks/09-17-company-loan-principal-repayment/prd.md index d40ba026..4f87be80 100644 --- a/.trellis/tasks/09-17-company-loan-principal-repayment/prd.md +++ b/.trellis/tasks/09-17-company-loan-principal-repayment/prd.md @@ -1,6 +1,15 @@ # 公司借款台账与本金归还 -## 2026-10-10 D:授权翻页与追回到账排查(已实施、产品复核及本地补验完成;未提交) +## 2026-10-10 E:追回证据刷新提示与员工资料误报(已实施、本地验证及独立只读复核完成;未提交) + +用户批准两项小问题按方案修复,复用本任务,不含数据库唯一约束(需先查存量重复、单独规划)。结果见 implement 顶部 E 节。 + +- [x] AC52:上传银行证据后对话框立即关闭;刷新完成前证据下拉框与确认按钮均不可用并有可见提示,不发出提交;刷新后可选中刚上传的证据。电脑/手机浏览器验证。 +- [x] AC53:财务预览员工资料后员工登录(含失败再成功),保存不再误报“员工资料已变化”。 +- [x] AC54:姓名、所属公司、开户行、银行机构、账号的真实变更,以及状态/归档,仍拦截保存;反向变异能被测试发现。 +- [x] AC55:资料拦截规则改动经独立只读复核(2026-10-11 `REVIEWED_NO_BLOCKER`,回执 `review-20261011.json`)。 + +## 2026-10-10 D:授权翻页与追回到账排查(已本地提交 `91fe31f0`,未发布) 用户要求规划“员工授权翻页超时”和“登记追回到账”两项遗留问题。复用本任务作为执行合同,分成 D1/D2 两个独立验收阶段,不把当前父任务 `in_progress` 当作本轮实施批准。规划基线为 `db919dc6`,开始时工作区干净;线上业务基线仍为 `4a5cd8f2`。本阶段目标是查清失败发生在哪一层,并形成能稳定触发相关分支的回归,避免漏走分支的通过掩盖问题。 diff --git a/client/src/components/common/LoanBankReconciliation.tsx b/client/src/components/common/LoanBankReconciliation.tsx index 36daaf43..5545f1a1 100644 --- a/client/src/components/common/LoanBankReconciliation.tsx +++ b/client/src/components/common/LoanBankReconciliation.tsx @@ -24,6 +24,9 @@ export function LoanBankReconciliation({ repayment: r, attachments }: { repaymen const [details, setDetails] = useState> | null>(null); const [action, setAction] = useState(null); const [target, setTarget] = useState(""); const [pendingIds, setPendingIds] = useState([]); + // The upload dialog closes before the batch detail refetch lands; until then a + // just-uploaded document is missing from the evidence lists. + const [refreshingEvidence, setRefreshingEvidence] = useState(false); const [values, setValues] = useState>({}); const [file, setFile] = useState(null); const value = (key: string) => values[key] ?? ""; const set = (key: string, next: string) => setValues((old) => ({ ...old, [key]: next })); @@ -59,12 +62,16 @@ export function LoanBankReconciliation({ repayment: r, attachments }: { repaymen if (action === "event" || action === "refund") await saveLoanAction(`${base}/loan-bank-results`, { kind: action === "refund" ? "return" : "late_success", ...(action === "refund" ? { parentId: target } : {}), evidenceId: value("evidence"), requestKey: crypto.randomUUID(), attributionNote: note, exclusionNote: value("exclusion"), fields: [{ Name: "付款账号", Value: value("payer") }, { Name: "收款账号", Value: value("payee") }, { Name: "金额", Value: value("amount") }, { Name: "币种", Value: "CNY" }, { Name: "交易状态", Value: "交易成功" }, { Name: "流水号", Value: value("reference") }] }); if (action === "reviewEvent") await saveLoanAction(`${base}/loan-bank-results/${target}/review`, { ...reviewBody, ...(decision === "reject" && value("evidence") ? { correctionEvidenceId: value("evidence"), correctionKind: value("correction") || "misassociated" } : {}) }); if (action === "apply") await saveLoanAction(`${base}/loan-bank-results/${target}/apply`, {}); - }, onSuccess: async () => { if (action === "details") return; setAction(null); await Promise.all(["payment-batches", "company-loans", "loan-repayments"].map((key) => cache.invalidateQueries({ queryKey: [key] }))); } }); + }, onSuccess: async () => { + if (action === "details") return; const uploaded = action === "upload"; setAction(null); if (uploaded) setRefreshingEvidence(true); + try { await Promise.all(["payment-batches", "company-loans", "loan-repayments"].map((key) => cache.invalidateQueries({ queryKey: [key] }))); } + finally { if (uploaded) setRefreshingEvidence(false); } + } }); function open(name: string, id = "") { setAction(name); setTarget(id); setValues({}); setPendingIds([]); setDetails(null); setFile(null); mutation.reset(); } const button = (name: string, id = "") => ; const input = (key: string, label: string, type = "text") => ; - const select = (key: string, label: string, choices: Array<[string, string]>, required = true) => ; - const evidenceSelect = (key: string, label: string, kind: string, required = true) => select(key, label, evidences.filter((e) => !e.voided && e.evidenceKind === kind).map((e) => [e.id, e.originalName]), required); + const select = (key: string, label: string, choices: Array<[string, string]>, required = true, refreshing = false) => ; + const evidenceSelect = (key: string, label: string, kind: string, required = true) => select(key, label, evidences.filter((e) => !e.voided && e.evidenceKind === kind).map((e) => [e.id, e.originalName]), required, refreshingEvidence); const exportLabel = (id: string | null) => id ? `第 ${exports.find((e) => e.id === id)?.sequence ?? "未知"} 次导出` : "系统外手工提交"; const submissionLabel = (id: string) => submissions.find((s) => s.id === id)?.bankInstructionRef ?? "提交记录已不可用"; const evidenceLink = (id: string) => ; @@ -105,7 +112,7 @@ export function LoanBankReconciliation({ repayment: r, attachments }: { repaymen {action === "reviewEvent" && value("decision") === "reject" ? <>{evidenceSelect("evidence", "误关联或重复登记的更正证据(晚到成功必填)", "bank_terminal", false)}{select("correction", "关闭原因", [["misassociated", "误关联"], ["duplicate", "重复登记"]], false)} : null} {action === "event" || action === "refund" ? <>{evidenceSelect("evidence", "对应的成功银行回单", action === "refund" ? "incoming_return" : "late_success")}{input("payer", "回单付款账号")}{input("payee", "回单收款账号")}{input("amount", "回单人民币金额")}{input("reference", "回单流水号")}{input("exclusion", "为什么不属于其他候选批次或交易")} : null} {!['upload', 'submitRecovery', 'confirm', 'apply'].includes(action ?? '') ?