知华银企智能对账

本次新增：唯一候选双向对账（2026-10-23）

以参考号、精确金额和日期容差构建双向候选，仅在两侧都唯一时匹配，重复候选保留异常，不贪心随意核销。

从工作台进入“专项业务工具”（/practical.html）。本次功能执行真实后端计算、支持错误提示、表格预览和完整结果导出；不把旧演示结果冒充成新功能实现。

沿用现有工作台数据库会话，后端通过Auth.current验证账号启用状态及会话有效期；不接受请求自报角色，不绕过停用/注销。请求时从原sessionStorage读取当前会话，不保存额外账号密码。

接口：POST /api/practical/unique-reference-reconciliation。算法、样例、校验及测试命令见专项升级说明。不调用外部模型、不自动写业务单据。

简体中文 | English

上海如静知华信息科技有限公司 · 官网

这是一套公开源码的银企流水对账工作台。它遵循一个原则：系统可以提出有分数和证据的匹配候选，但不能未经独立复核就确认入账。

对账的三道保险

来源去重：银行流水和账务凭证各有唯一来源号；金额必须为正、最多两位小数，日期不能来自未来。
候选排序：本地规则比较收付方向、金额、参考号、交易对方和日期。低于阈值或出现同分候选时拒绝自动选择，交由人工登记差异。
复核确认：另一位审核人员确认后，银行与账务双方状态同步变为 MATCHED，生成不可手工编辑的匹配流水；驳回保留依据。无候选可登记差异并独立关闭。

例如，两笔账务流水都与同一银行流水同分时，propose 返回业务冲突，不能随机挑一笔。本场景和正常匹配、重复来源号、越权确认、差异关闭均纳入 HTTP 自动化测试。

业务 H5 包含银行流水、账务流水、候选、已确认匹配和差异台账；管理员可管账号与查看审计。服务端支持租户隔离、幂等、并发版本、附件及 CSV 导出。

可替换的分析接口

cn.zhuatech.reconcileai.InsightProvider 定义候选生成契约；默认 LocalInsightProvider 只使用本地确定性规则，不调用任何真实模型或银行接口。如果接入国内模型，模型只能提供候选或解释，金额一致性、唯一性、二次复核和入账必须继续在服务端硬校验。真实银行接口、网银授权和 ERP 过账不在本公开版本范围内。

开发与验证

Java 21 / Spring Boot 4 / MySQL 8.4，Vue 3 / Vite。复制 .env.example 到 .env 配置强密码，执行 docker compose up -d --build。通过 sh scripts/test.sh 运行后端业务验收（本机 H2/MySQL 兼容）、前端单测及构建；CI 配置 MySQL 复测。默认 H5 地址 http://127.0.0.1:8088，管理端为 /admin，API 健康检查为 http://127.0.0.1:18080/api/health。

GET /api/catalog 提供模块和动作定义；POST /api/records/{id}/actions/propose 提出候选，confirm 独立确认。每次写入需携带 Idempotency-Key。

许可与联系

源码仅限个人非商业学习交流；LICENSE 明确企业生产、客户交付、SaaS、收费服务及其他商用需要上海如静知华信息科技有限公司书面授权，因此不是 OSI 定义的开源许可。实际资金对账必须另做银行账单真实性、权限与灾备验收。

知华科技提供中小企业信息化、AI 转型、OPC 支持、软件外包、项目实施、FDE 外包及深度开发定制。访问官网或扫码咨询：

微信一	微信二