wangsli/hyb-oa
1
0
派生 0
代码 工单 合并请求 工作流 5 软件包 项目 发布 百科 活动

补齐借款对账界面验收并记录 S0 只读核实（09-17-company-loan-principal-repayment）

浏览代码 
电脑和手机覆盖提交清单、失败归属、晚到补记、部分及全额追回和有依据的误报关闭；不修改应用业务代码。最终隔离验证 81 迁移、HTTP 95、浏览器 19、数据库约束 9 组通过，脚本和治理检查通过。

获准只读核实：生产 OA 借款模块当前无记录，已应用 73 个迁移与本地校验值一致，待执行 8 个；不证明银行或线下没有付款。记录迁移差集、发布步骤和回退边界。

人员、银行材料、真实样本及业务独立验收待完成；正式发布门禁尚未运行。本次仅本地提交，不推送、不部署。
这个提交包含在：
wangsli
2026-10-07 22:25:05 +08:00
父节点 431c36eae3
当前提交 7a48a1e76f
共修改 6 个文件，包含 199 行新增和 7 行删除
下载 Patch 文件 下载 Diff 文件 展开所有文件 折叠所有文件
.trellis/tasks/09-17-company-loan-principal-repayment/design.md
+1 -1
查看文件
@@ -11,7 +11,7 @@
- 已用于误报解冻的更正证据属于已消费的复核依据，服务及数据库均禁止再作废。更正记录、原始银行事件及关闭依据保留，不回写原结论。
- 终态界面支持一次关联多份同指令处理中回单。复核卡明确展示所选提交、终态类型、证据、了结回单；Q6 展示逐份导出及三类证据的准确绑定，失败归属展示覆盖指令及核验附件。历史作废回单仅可通过实际事实绑定、必填用途的对账读取查看；权限、隔离策略、物理摘要、审计及 no-store 保留，普通作废回单下载仍被拒绝，不恢复其付款效力。
- S8 沿用既有 React 对话框和样式，未引入新视觉方案。页面集中展示导出、提交、证据、人工声明、补证轮次、银行事件和冻结原因；原制单不得再次导入网银的提示不是技术保证。
- S0（存量、合格复核人数、银行编号关系及官方材料）、真实回单验收仍未完成；本轮资金与界面代理已完成修复后只读静态复核，运行时结果见 implement。该复核不替代异模型或业务人员验收。本地实现/合成验证不代表可以部署或真实还款。
- S0 存量已于 2026-10-07 获准只读核实：OA 借款记录为 0，发布前需重核。合格复核人数、银行编号关系及官方材料、真实回单验收仍未完成；本轮资金与界面代理已完成修复后只读静态复核，运行时结果见 implement。该复核不替代异模型或业务人员验收。本地实现/合成验证不代表可以部署或真实还款。
## 2026-10-07 补证后恢复方案（SR，第 1 版，用户已批准本地实施）
.trellis/tasks/09-17-company-loan-principal-repayment/implement.md
+37 -5
查看文件
@@ -1,11 +1,43 @@
## 2026-10-07 后续收口执行（用户同意执行）
按后续工作清单，先将已验证的 S4–S8 共 32 项改动本地提交，提交保留“真实回单待验、整体业务验收未通过”。随后补齐提交登记、清单复核、失败归属、晚到补记和追回的浏览器闭环，并准备发布前存量/迁移/回退检查材料。当前 inline 主会话直接实现和检查，不另派代理；此前两名代理的复核仅覆盖其当时差异。生产查询单独确认，人员与银行材料待外部答复；推送、部署和远端备份切换不在本次默认执行内。以下“32 项未提交”属于提交前验证时点。
按后续工作清单，先将已验证的 S4–S8 共 32 项改动本地提交，提交保留“真实回单待验、整体业务验收未通过”。随后补齐提交登记、清单复核、失败归属、晚到补记和追回的浏览器闭环，并准备发布前存量/迁移/回退检查材料。当前 inline 主会话直接实现和检查，不另派代理；此前两名代理的复核仅覆盖其当时差异。用户本轮已明确授权生产借款存量的只读汇总查询；人员与银行材料答复“不清楚”，保持待核实；推送、部署和远端备份切换不在本次默认执行内。以下“32 项未提交”属于提交前验证时点。
- [ ] 本地提交已验证 S4–S8。
- [ ] 补齐其余银行对账表单的电脑/手机闭环并修复发现的问题。
- [ ] 在现有任务/恢复手册整理具体发布准备与未满足条件。
- [ ] S0 生产只读核实及外部人员、银行材料确认（分别记录）。
- [x] 本地提交已验证 S4–S8：`431c36ea`，32 项，未推送。
- [x] 补齐其余银行对账表单的电脑/手机闭环；最终固定副本通过，在本次本地提交授权内将新增测试及 S0/发布准备记录单独提交。
- [x] 在本任务记录具体迁移差集、发布顺序、回退限制和未满足条件。
- [x] S0 生产存量只读核实完成；人员与银行材料仍待外部核实。
### 剩余界面验收补测
新增 `company-loan-reconciliation-browser.cjs`，由既有隔离浏览器入口调用。合成种子通过正式接口准备，实际待验动作由页面完成：电脑/手机各走提交登记→清单确认/独立复核→失败归属/独立复核→失败回单终态→取消；以及晚到成功原件上传/登记→用途审计查看输入→独立复核→补记→部分与全额追回→凭更正材料独立关闭重复误报。断言经办人无自审按钮、原占用释放、待追回变化、部分追回仍冻结、全部追回后关闭对应冻结、不创建新付款批次及手机无横向溢出。
未修改应用业务代码或新增资金规则。首轮用例把归一化后的大写指令号与小写测试预期比较而失败，已修正测试预期；后一轮通过。最新副本补明确选择新上传的更正证据，再验证最终用例。首轮失败不计通过；不新增变异测试或重复整套服务端单测，因为本轮仅补浏览器覆盖与文档。
复现：在隔离源码/构建副本内执行 `RUN_ISOLATED_LOAN_DB_TEST=1 RUN_ISOLATED_LOAN_BROWSER=1 node scripts/qa/test-company-loan-db.cjs`，BIFF8 使用已准备的受控 Python 环境。最终固定副本通过 81 迁移、HTTP 95、浏览器 19、数据库约束 9 组，自有副本/容器清理 PASS。脚本语法、任务、治理、流程合同、敏感扫描与 git diff --check 通过。应用代码与依赖未变，复用先前通过的构建、类型及单元测试证据。主会话遵循 inline 直接检查，没有新增代理复核，也不替代财务/银行事实验收。
### S0 只读核实及发布准备（2026-10-07）
用户明确授权本轮生产借款存量只读汇总；通过既有生产连接，在 `REPEATABLE READ READ ONLY` 事务中查询并 `ROLLBACK`，设置查询/锁等待超时，未输出账户、原件或业务正文，未运行部署/迁移。核实时点 2026-10-07 22:08–22:09（北京时间）。
- OA 中出借人、借款、还款批次、占用分配和借款回单均为 0；已确认失败未取消也是 0。当前没有系统内借款存量需要回填；这不证明银行或线下没有付款。发布前必须再次核对，不能把本次空库结论永久复用。
- 已应用迁移 73 个，未完成迁移 0；与本地同名迁移的 SHA-256 全部一致，没有生产多出的迁移。本地 81 个，差集为以下 8 个（不是仅本轮新增的 3 个）：
1. `20261006010000_loan_receipt_attribution`
2. `20261007010000_loan_bank_submissions`
3. `20261007020000_loan_failure_attribution`
4. `20261008010000_loan_bank_terminal_facts`
5. `20261008020000_loan_release_recoveries`
6. `20261008030000_loan_not_submitted`
7. `20261008040000_loan_freeze_reasons`
8. `20261008050000_loan_bank_result_events`
- 人员、官方无结果 PDF、回单与指令编号关系：用户答复“不清楚”，均保留待核实；Q6 不能宣称具备实际使用条件。脱敏只读结果保存在本轮 S0 本地证据目录的 summary.json。
发布准备顺序（本轮只准备，不执行发布）：
1. 完成剩余浏览器闭环及业务/真实样本验收，固定最终已提交候选；不得把本轮合成回归当作正式 release-gate 回执。
2. 对固定干净候选运行 `bash scripts/qa/run-release-gate.sh verify-candidate`，绑定当次回执；当前仍有待验证/未提交的补测，不提前运行大范围门禁或写“可部署”。不能用 `all`/`ci-release` 代替本地验证，因为它们会进入生产发布链。
3. 经单独批准后做发布前只读核实，将实际差集作为 `EXPECTED_PENDING_MIGRATIONS`。若生产出现新增借款/批次、迁移差异或未完成项，重新评估，不自动套用本次 8 项或空存量结论。
4. 按既定部署前手动快照方案确认快照完成与恢复证据。备份脚本切换属于另一项远端授权，仅安装指定 refresh 脚本及执行既定停用顺序，不借此部署应用。
5. 推送、部署各自批准后才执行迁移/应用发布；部署后核对应用版本、81 项预期迁移、readiness、权限和借款只读页面。真实借款录入/付款仍需业务明确批准，不能制造付款验收。
6. 回退保留新增表和历史事实，不删迁移或重置数据库。一旦生成补记/追回等新事实，旧代码未计算新台账，不能直接降级；停止新付款并按获批兼容修复或恢复方案处理。确认此前没有新资金事实，也仍需具体回退审批，不能默认恢复覆盖期间其他业务。
## 2026-10-07 后续执行接续（用户要求已确定工作直接执行）
.trellis/tasks/09-17-company-loan-principal-repayment/prd.md
+1 -1
查看文件
@@ -2,7 +2,7 @@
## 2026-10-07 本地阶段状态
S4–S8 与 SR 界面已完成本地实现及合成回归：81 迁移、HTTP 95、浏览器 13、数据库约束 9 组通过，修复后的资金与界面只读静态复核通过（同模型）。S0、真实建行材料和业务独立验收仍未完成；不据此勾选整体真实还款验收或声明已部署。完整证据与限制见 implement.md 顶部。
S4–S8 已本地提交 `431c36ea`；补齐剩余界面后合成回归为 81 迁移、HTTP 95、浏览器 19、数据库约束 9 组通过。应用代码沿用修复后的同模型只读静态复核，本轮只补测试与记录。S0 生产只读查询确认 OA 借款模块当前记录为 0，73 个已应用迁移校验值一致，待执行 8 个；不代表银行或线下没有付款。人员、真实建行材料和业务独立验收仍未完成，正式发布门禁尚待执行；不据此勾选整体真实还款验收或声明已部署。完整证据与限制见 implement.md 顶部。
## 2026-09-17 实施接续
scripts/qa/company-loan-browser.cjs
+3
查看文件
@@ -297,6 +297,9 @@ module.exports = async function runBrowser({ app, finance, manager, ordinary, pa
await view.context.close(); checks.push(`${mobile ? 'mobile' : 'desktop'}_${recovery ? 'recovery_start_evidence_review_round_release' : 'terminal_multiple_pending_receipts_independent_review_release'}`);
}
}
if (reconciliationUi) checks.push(...await require('./company-loan-reconciliation-browser.cjs')({
browser, origin, output, finance, manager, password, prisma, fixtures: reconciliationUi,
}));
const context = await browser.newContext({ serviceWorkers: 'block' });
await context.route('**/*', route => route.request().url().startsWith(`${origin}/`) ? route.continue() : route.abort());
const page = await context.newPage();
scripts/qa/company-loan-http-fixture.cjs
+27
查看文件
@@ -1301,6 +1301,33 @@ module.exports = async function runLoanHttpFixture(pool, scratch) {
}
(recovery ? reconciliationUi.recoveryBatches : reconciliationUi.terminalBatches).push({ id: batch.id, instruction: ref });
}
reconciliationUi.failures = []; reconciliationUi.late = [];
for (const mode of ['desktop', 'mobile']) {
const failLender = await verifiedLender(`合成失败界面-${mode}`, null, '7');
const failLoan = await confirmedLoan(failLender.id, '100.00', `合成失败归属-${mode}`);
const target = await repay(failLender.id, failLoan.id, '7.00');
const competitor = await repay(failLender.id, failLoan.id, '7.00');
for (const b of [target, competitor]) { await call(manager, 'POST', `/payment-batches/${b.id}/review`, {}); await exportOrder(b.id); }
const reference = `UI-FAIL-${mode}`.toUpperCase();
await receipt(target.id, '700', reference, { payeeAccount: failLender.bankAccount, transactionStatus: 'failed' });
reconciliationUi.failures.push({ id: target.id, repaymentId: target.loanRepaymentId, reference });
const lateLender = await verifiedLender(`合成追回界面-${mode}`, null, '8');
const lateLoan = await confirmedLoan(lateLender.id, '100.00', `合成晚到追回-${mode}`);
const original = await repay(lateLender.id, lateLoan.id, '80.00');
await call(manager, 'POST', `/payment-batches/${original.id}/review`, {}); await exportOrder(original.id);
const exp = await prisma.paymentOrderExport.findFirstOrThrow({ where: { payment_batch_id: original.id } });
const sub = await register(original.id, `UI-ORIGINAL-${mode}`, exp.id); await attest(original.id);
const fact = await proposeFact(original.id, { submissionId: sub.id, kind: 'termination_evidence', terminalStatus: 'failed', evidenceId: await uploadEvidence(original.id) });
await reviewFact(original.id, fact.id); await confirmNotPaid(original.id); await cancelBatch(original.id);
const paid = await repay(lateLender.id, lateLoan.id, '60.00');
await call(manager, 'POST', `/payment-batches/${paid.id}/review`, {}); await exportOrder(paid.id);
await receipt(paid.id, '6000', `UI-PAID-${mode}`, { payeeAccount: lateLender.bankAccount });
await call(finance, 'POST', `/payment-batches/${paid.id}/execute`, {});
const saved = await prisma.paymentBatch.findUniqueOrThrow({ where: { id: original.id } });
reconciliationUi.late.push({ id: original.id, lenderId: lateLender.id, reference: `UI-LATE-${mode}`,
payer: decryptStringOrThrow(config, saved.payment_account_snapshot_json.accountNumberEncrypted), payee: lateLender.bankAccount });
}
await require('./company-loan-browser.cjs')({ app, finance, manager, ordinary, password, company, bank, lender, loan, config, prisma, attributionUi, reconciliationUi });
}
console.log(JSON.stringify({ stage: 'loan_ledger_http', status: 'PASS', checks }));
scripts/qa/company-loan-reconciliation-browser.cjs
+130
查看文件
@@ -0,0 +1,130 @@
const assert = require('node:assert/strict');
const path = require('node:path');
const { createRequire } = require('node:module');
const req = createRequire(path.resolve(__dirname, '../../client/package.json'));
const { expect } = req('@playwright/test');
// Synthetic fixtures only; every tested action below goes through the actual UI.
module.exports = async function reconciliationBrowser({ browser, origin, output, finance, manager, password, prisma, fixtures }) {
const checks = [];
for (const mobile of [false, true]) {
const mode = mobile ? 'mobile' : 'desktop';
let view;
async function login(who, batch) {
if (view) await view.context.close();
const context = await browser.newContext({ viewport: mobile ? { width: 390, height: 844 } : { width: 1440, height: 1000 }, serviceWorkers: 'block' });
await context.route('**/*', route => route.request().url().startsWith(`${origin}/`) ? route.continue() : route.abort());
const page = await context.newPage();
await page.goto(`${origin}/login?redirect=${encodeURIComponent(`${mobile ? '/mobile' : ''}/payment-batches?id=${batch.id}`)}`);
await page.getByTestId('login-identifier').fill(who.email);
await page.getByTestId('login-password').fill(password); await page.getByTestId('login-submit').click();
await page.waitForURL(/\/payment-batches\?id=/);
const panel = page.getByRole('region', { name: '银行结果对账', exact: true });
await expect(panel).toBeVisible({ timeout: 20000 });
view = { context, page, panel };
}
async function action(name, fill, scope) {
await (scope ?? view.panel).getByRole('button', { name, exact: true }).click();
const dialog = view.page.getByRole('dialog');
if (fill) await fill(dialog);
if (await dialog.getByLabel('依据与说明').count()) await dialog.getByLabel('依据与说明').fill('合成银行材料唯一定位本批次并独立核对全部指令');
await dialog.getByRole('button', { name: '确认', exact: true }).click();
try { await expect(dialog).not.toBeVisible(); }
catch { throw new Error(`synthetic UI ${name}: ${await dialog.getByRole('alert').allTextContents()}`); }
}
async function review(name = '独立复核银行事实') {
await action(name, d => d.getByLabel('复核结论').selectOption('approve'));
}
async function upload(kind) {
await action('上传银行证据', async d => {
await d.getByLabel('证据类别').selectOption(kind);
await d.getByLabel('证据文件').setInputFiles({ name: `${kind}.pdf`, mimeType: 'application/pdf', buffer: await fixtures.bankLetterPdf() });
});
}
async function bankFields(d, s, amount, reference, incoming = false) {
const options = d.getByLabel('对应的成功银行回单').locator('option');
await d.getByLabel('对应的成功银行回单').selectOption({ index: (await options.count()) - 1 });
await d.getByLabel('回单付款账号').fill(incoming ? s.payee : s.payer);
await d.getByLabel('回单收款账号').fill(incoming ? s.payer : s.payee);
await d.getByLabel('回单人民币金额').fill(amount);
await d.getByLabel('回单流水号').fill(reference);
await d.getByLabel('为什么不属于其他候选批次或交易').fill('合成官方查询逐一排除其他同金额付款和退款交易');
}
try {
const failed = fixtures.failures[Number(mobile)];
await login(finance, failed);
await action('登记银行提交', async d => {
await d.getByLabel('使用的导出文件（手工录入可不选）').selectOption({ index: 1 });
await d.getByLabel('银行指令号').fill(failed.reference);
await d.getByLabel('实际提交时间').fill(new Date().toISOString().slice(0, 16));
});
await action('确认提交清单完整');
await expect(view.panel.getByRole('button', { name: '独立复核提交清单', exact: true })).toHaveCount(0);
await login(manager, failed); await review('独立复核提交清单');
await login(finance, failed);
await action('登记失败回单归属', async d => {
await d.getByLabel('对应银行提交').selectOption({ index: 1 });
await d.getByLabel('失败回单（终态书面证据可不选）').selectOption({ index: 1 });
await d.getByLabel('排除其他候选批次的依据').fill('合成银行指令唯一定位本批，其他同额批次对应另一指令');
});
await expect(view.panel.getByRole('button', { name: '复核失败归属', exact: true })).toHaveCount(0);
await login(manager, failed); await expect(view.panel).toContainText(failed.reference); await review('复核失败归属');
await login(finance, failed);
await action('登记银行终态事实', async d => {
await d.getByLabel('对应银行提交').selectOption({ index: 1 });
await d.getByLabel('失败回单（终态书面证据可不选）').selectOption({ index: 1 });
});
await login(manager, failed); await review('独立复核终态事实'); await action('确认银行未付款');
await login(finance, failed); await action('重验依据并取消释放');
const original = await prisma.loanRepayment.findUniqueOrThrow({ where: { id: failed.repaymentId }, include: { allocations: true } });
assert.equal(original.bank_result_state, 'confirmed_not_paid');
assert.ok(original.allocations.every(a => a.reservation_state === 'released'));
await view.page.screenshot({ path: path.join(output, `${mode}-submission-failure-attribution.png`), fullPage: true });
checks.push(`${mode}_submission_inventory_failure_attribution_terminal_and_release_via_ui`);
const late = fixtures.late[Number(mobile)];
const batchCount = await prisma.paymentBatch.count();
await login(finance, late); await upload('late_success');
await action('登记晚到成功', d => bankFields(d, late, '80.00', late.reference));
await expect(view.panel).toContainText('该出借人暂停新还款');
await expect(view.panel.getByRole('button', { name: '独立复核银行事实', exact: true })).toHaveCount(0);
await login(manager, late);
await view.panel.getByRole('button', { name: '查看录入的银行事实', exact: true }).click();
let dialog = view.page.getByRole('dialog');
await dialog.getByLabel('依据与说明').fill('合成独立复核原件与人工输入的对应关系');
await dialog.getByRole('button', { name: '确认', exact: true }).click();
await expect(dialog.getByLabel('已授权查看的银行事实')).toContainText(late.reference);
await view.page.keyboard.press('Escape'); await expect(dialog).not.toBeVisible();
await review(); await login(finance, late); await action('登记补记或追回');
await expect(view.panel).toContainText('待追回 ¥40.00');
for (const [amount, remaining] of [['15.00', '25.00'], ['25.00', '0.00']]) {
await upload('incoming_return');
await action('登记追回到账', d => bankFields(d, late, amount, `${late.reference}-RETURN-${amount}`, true));
await login(manager, late); await review(); await login(finance, late); await action('登记补记或追回');
await expect(view.panel).toContainText(`待追回 ¥${remaining}`);
assert.equal(await prisma.loanFreezeReason.count({ where: { lender_id: late.lenderId, status: 'active' } }), remaining === '0.00' ? 0 : 1);
}
assert.equal(await prisma.paymentBatch.count(), batchCount, 'factual entries never create payment batches');
await expect(view.panel.getByRole('button', { name: '登记追回到账', exact: true })).toHaveCount(0);
checks.push(`${mode}_late_success_details_independent_review_partial_and_full_return_via_ui`);
// Registering a duplicate remains an auditable false alarm; correction
// needs a bank document and independent decision, not a bare dismissal.
await upload('late_success'); await action('登记晚到成功', d => bankFields(d, late, '80.00', late.reference));
await upload('bank_terminal');
await login(manager, late);
await action('独立复核银行事实', async d => {
await d.getByLabel('复核结论').selectOption('reject');
const correction = d.getByLabel('误关联或重复登记的更正证据（晚到成功必填）');
await correction.selectOption({ index: (await correction.locator('option').count()) - 1 });
await d.getByLabel('关闭原因').selectOption('duplicate');
});
assert.equal(await prisma.loanFreezeReason.count({ where: { lender_id: late.lenderId, status: 'active' } }), 0);
await expect(view.panel).toContainText('已确认误报');
assert.equal(await view.page.evaluate(() => document.documentElement.scrollWidth > innerWidth + 1), false);
await view.page.screenshot({ path: path.join(output, `${mode}-late-return-and-dismissal.png`), fullPage: true });
checks.push(`${mode}_evidenced_duplicate_false_alarm_closed_by_independent_reviewer_via_ui`);
} finally { if (view) await view.context.close(); }
}
return checks;
};