借款材料区按需显示并前置缺项提示（09-17-company-loan-principal-repayment）

- 材料区只为仍缺的材料提供上传：原件已存显示可查看，在线确认后收起协议框，历史还款依据仅在登记期初小于原本金时出现
- 余额材料改中性文案（公司银行流水或代账明细账），确认字段改为“余额依据说明”，按钮改为“确认借款余额”并前置列出缺项
- 确认弹窗跟随最新列表状态：刷新中、刷新失败、版本变化、已确认或缺项时禁用按钮与提交
- 浏览器测试覆盖显隐、缺项、材料失效、在线确认失效、刷新与弹窗打开后状态变化；同步操作手册
- 只读复核 P2 已修复关闭；不改后端、接口与数据库

Co-Authored-By: Claude Opus 5.5 <[email protected]>

.trellis/tasks/09-17-company-loan-principal-repayment/implement.md

@@ -1,3 +1,33 @@
+## 2026-10-12 G：只读复核 P2 修复（确认弹窗跟随最新列表状态；复核关闭、回归通过；未提交）
+
+另一会话只读复核（`review-20261012-codex.json`）：材料规则 1,536 组前后端对照一致；P2 R1——确认弹窗打开后列表刷新中、刷新失败或在线确认失效时，弹窗“确认”仍可点击并以打开时快照保存（服务端仍会拒绝，非绕过）。
+
+- 修复：确认模式按 `selectedLoan.id` 从当前列表取最新记录，按钮禁用与 `submit` 共用 `confirmBlocker`：列表刷新中、刷新失败或找不到该借款、版本变化或已确认（要求关闭后重新核对，不静默替换快照）、材料缺项；弹窗内 `role=status` 显示原因。
+- 测试：原“上传后刷新失败”改为等待页面错误提示出现后再断言（失败时列表整体隐藏，按钮消失亦视为不可确认）；新增电脑/手机“弹窗已打开”检查——等待 5 秒过期后派发 offline/online 触发真实 React Query 重连刷新，依次覆盖刷新挂起、最终失败、在线确认失效，断言按钮禁用、回车零保存请求，恢复后可保存。
+- 结果：修复后完整回归 `full-regression-r3/r4.log` 各退出 0、84 迁移、12 阶段、去重 251 项（249 + 电脑/手机弹窗跟随最新状态 2 项），清理 PASS；前端 typecheck/build 通过。另一会话补充复核 `review-followup-20261012-codex.json`：电脑/手机 12 组场景通过，P2 关闭，无新阻断项（复核时回归尚未结束，结果以本节日志为准）。
+- 反证：去掉按钮与提交两处判断（保留提示）后专项失败于“弹窗确认应禁用实际可用”（`ack-browser-negative-without-fix.log`）；恢复修复后 `ack-browser-fix-r5.log` 通过。过程失败保留：`ack-browser-fix-r1`（失败刷新后卡片整体隐藏，断言过窄）、`-r2`（挂起请求放行前即撤销拦截致重复处理）、`-r3`（错误态重挂载使材料区折叠）、`ack-browser-negative-invalid-build-failed.log`（反证改动未过类型检查、构建未生效，作废）、`ack-browser-negative-masked-by-route.log`（失败原因被拦截重复处理掩盖）。
+
+## 2026-10-11 G：材料区域精简实施（用户已批准；本地验证完成；复核 P2 已于 10-12 修复，见上节）
+
+- 页面 `client/src/pages/CompanyLoansPage.tsx`：页内 `usableEvidence`（未归档且 `governanceStatus=approved`）、`needsAdjustment`（按登记期初未还 `openingOutstandingPrincipal` 与原本金以分比较，不用 `outstanding`）、`missingEvidence`（镜像服务端材料规则）与 `evidenceSlots`。原件已满足显示“已保存，可查看”；有效在线确认时协议框改为“借款确认 · 出借人已在线确认”，否则注明二选一，关联员工的出借人给出“去出借人确认查看或办理”跳转；余额材料始终为“上传余额核对材料”并注明“公司银行流水或代账明细账，覆盖从借入到截至日”；历史还款依据仅在登记期初小于原本金或已有文件时出现。未通过检查的文件标注“（未通过检查，不计入）”。
+- 按钮“确认借款余额”；上方 `还缺：…` 与禁用共用 `missingEvidence`，另在列表刷新中、刷新失败或上传处理中禁用。确认弹窗字段改为“余额依据说明”，下方给示例、不预填；API 仍提交 `accountingConfirmationRef`。余额已确认且出借人为已核实的关联员工时显示“查看或办理公司代表授权”。不改后端、接口、数据库与权限。
+- 测试：三个浏览器脚本改用新文案；出借人确认场景中原“缺余额材料点击确认得 409”改为前置断言按钮禁用与缺项（服务端 409 仍由 HTTP 夹具覆盖）。新增电脑/手机各一项边界检查：仅改写列表响应中目标借款字段，验证当前未还下降不出历史还款依据、登记期初下降出现并列为缺项、材料被隔离不计入、在线确认失效后协议框与跳转重现、上传后刷新失败禁用确认；真实上传与确认仍走后端。
+- 操作手册 `docs/试运行与自动化验证手册.md` 同步：余额材料可为银行流水或代账明细（银行流水仅作附件由财务核对），正常 OA 还款不再要求历史还款依据，缺项前置与“余额依据说明”。
+- 验证：前端 typecheck/build 通过；出借人确认专项（含浏览器）`ack-browser-r1.log` 通过；完整回归 `full-regression-r1/r2.log` 各退出 0、84 迁移、12 阶段、去重 249 项（247 + 电脑/手机材料显示边界 2 项），清理 PASS。证据 `artifacts/qa-flow/loan-material-slots-20261011/`。待另一会话只读复核；提交与发布另行授权。
+
+## 2026-10-11 G：材料区域精简规划（已批准）
+
+用户认可只显示当前所需事项，并明确本次余额依据采用公司银行流水。已核对页面、借款 DTO、后端材料要求和确认/授权入口，选择最小页面方案，需求与验收见 PRD G / AC60–64，技术边界见 design G；本轮不改产品代码。
+
+- [x] 规划收敛：复用已有确认栏目；材料按有效性与期初余额显隐；使用中性余额文案；缺项前置提示；授权使用查看/办理链接。确认中/退回及授权未办不能从现有借款 DTO 推断，已改为中性跳转文案。
+- [x] 本轮仅三个任务文档新增规划，任务校验、流程基线、治理（含敏感内容扫描）与文档登记检查通过；文档仍有既有 22 文件未登记告警。修正新增段落的位置与末尾空行后 `git diff --check` 通过；未执行产品测试。
+- [ ] 具体方案取得实施批准后，修改 `client/src/pages/CompanyLoansPage.tsx`，必要时仅提取页内展示判断以便验证；不改 API、数据库或权限/状态规则。
+- [ ] 针对性覆盖：有/无有效在线确认、纸质依据替代、原件缺失、被隔离/归档材料、历史已还/正常系统还款、上传刷新与失败、返回后声明失效、确认说明和栏目跳转。采用合成资料，不访问生产。
+- [ ] 前端 typecheck/build、电脑/手机受影响浏览器场景及 `trellis-check`；若现有浏览器脚本绑定旧文案，更新其准确定位与断言，保留业务守卫，按实际影响决定相关回归范围。
+- [ ] 同步 `docs/试运行与自动化验证手册.md` 的借款材料说明，补验证证据并运行任务/流程/文档/敏感信息检查。无新增通用规则时不扩写 spec；本轮沿用现有样式，不新增视觉方案。
+
+实施与本地验收获批后连续完成；提交和最终候选发布门禁、推送部署仍按原授权边界办理。本规划不包含此前“未还本金默认全额、日期默认当日”的待办。
+
 ## 2026-10-11 `36b949ec` 已发布（含迁移 84；未做快照）
 
 用户授权提交、推送并部署，明确不做快照。部署前生产只读核对：重复组合仍为 0 组（出借人 1 条），13 项部署前检查通过；发布来源检查要求候选已推送且工作区干净，故先暂存本记录、以 HEAD=`36b949ec` 推送（`4a5cd8f2..36b949ec`）和部署，部署后再提交记录（提交记录会改变 HEAD、使门禁回执不再匹配）。