docs/Admin财务管理样式核对记录.md

Admin 财务管理样式核对记录

范围为当前财务导航 6 个菜单、11 个正式路由及其实际可达操作。入口为 apps/admin-web/src/modules/finance/routes.ts，5 个主体页面与应收/应付两个路由封装。依据本轮全模块统一样式要求、国内订单样板和财务最近指引；历史原型的旧钱包/台账边界不覆盖当前已接入业务。

修改前逐操作矩阵

原型目录为 docs/悦/货代SAAS平台后台/prototype-src/；页面在 modules/08-finance.html，浮层在 overlays.html。尺寸列记录当前实现；本轮保留业务弹框宽度及版本、权限、幂等和金额口径。

页面/操作	原型或当前事实	当前承载/本轮调整
客户账户列表、详情、账期	page-customer-account 637 行、详情 645 行；FinanceCustomerAccountsView	列表/独立详情/详情内账期编辑；返回与客户同行，账户实际余额、冻结、授信等全部口径保留为紧凑摘要
手工充值、手工扣款	当前 adjustmentOpen，与最近 Finance 指引一致	720px 弹框；保留类型、金额、付款方式、流水号、原因、账户版本及幂等键
授信维护	当前 creditLimitOpen	560px 弹框；保留到期日、额度下限与校验
充值申请审核/驳回	modal-customer-recharge-review 1807 行，当前 reviewOpen	620px 弹框；保留申请描述表、凭证和审核原因
充值凭证预览	当前 voucherPreviewOpen	920px 图片预览，保留图片尺寸和清理，不压成普通表单
账户流水查询/导出	当前详情 ledger-query 和 exportLedger	独立筛选与服务端流水表保留，统一行高和工具栏
客户应收应付列表/费用详情	page-customer-arap 661 行、详情 798 行；FinanceCustomerArapView	独立详情、来源金额摘要、单据与结算信息；统一标题、描述表和日志
来源编辑、提交、审核/驳回、调整、作废	当前 mutationOpen 与 reviewOpen	默认居中框；上游来源只读、整组分摊、状态及权限条件不变，按实际可见操作数量折叠
应收款统计查询/打印/导出	page-finance-ar-detail-report 761 行；FinanceReceivableStatisticsView	真实按月 CNY 汇总；摘要压缩，打印保持既有规则和异步 Excel 导出
对账单列表/详情	page-customer-recon-stmt 822 行；FinanceCustomerStatementsView	独立详情；去重复页头，保留客户/期间与 20 项概要、两个页签及全部版本记录
生成对账单	当前 createOpen	680px 弹框，保留费用候选、已选总额与账期
提交、通过、驳回、出账、作废、重开	当前 performAction	保留权限/状态条件和原因确认，操作不超过 3 个全部直显；超过 3 个才显示省略号
对账单调整	当前 adjustOpen	900px 弹框，保留来源明细及金额计算
应收/应付列表与详情	page-settlement-ar 940 行、page-settlement-ap 995 行、详情 1073 行；FinanceFormalSettlementPage 两模式	返回、结算单号和状态同行，删除路由 ID 文案回退；四项金额/日期摘要与描述表保留全部字段
生成应收/应付结算单	当前 createOpen	600px 弹框，保留各自候选和方向约束
部分收款、部分付款	当前 receiptOpen/paymentOpen	各 760px 弹框；保留部分核销摘要、凭证上传、剩余金额预览及保存限制
结算单作废/重开、导出	当前 performAction/exportDetail	原因确认与导出沿用原流程，接入公共确认框样式

CustomerStatementsPanel 虽作为 Finance 公开组件存在，但当前六菜单路由没有引用；不能凭文件存在恢复旧抽屉入口。若后续模块沿实际引用命中，另行纳入其操作范围。

检查

本轮代码核对覆盖上述 6 菜单 / 11 路由。5 个主体页面显式接入公共密度样式，财务局部布局位于 src/modules/finance/financeDensity.css；应收/应付两个路由封装移除旧的 tbody 网格覆盖，由共享详情描述表统一排版。

• 客户账户、费用来源、对账单、应收/应付详情统一返回、业务标题与状态；金额摘要使用公共紧凑布局，对账单保留 20 个概要字段与两个页签。
• 11 处弹框声明及各自版本、权限、金额、凭证处理保留；操作原因框和导出提示框显式接入样式。导出公共辅助函数增加可选 dense 参数，未接入消费者保持原样。
• 账户仅有详情/账期时直接显示两个按钮；有充扣及授信权限时才折叠。费用来源草稿有 4 个动作时折叠作废，3 个及以下全部显示；通过真实组件测试验证省略号无文字且菜单里的作废仍能打开原确认流程。
• 收款/付款由结算方向与权限互斥，最多 3 个行内操作；应收款统计打印/导出归入表格工具栏，打印时隐藏工具栏。
• 清除页面内重复密度外观及空 CSS 选择器；公共维护合同纳入财务 5 个页面和模块 CSS，并增加空选择器检查。

2026-09-14 检查结果：财务、公共密度和导出提示定向测试 183 项通过；全量 pnpm test --maxWorkers=4 为 251 个文件、1950 项通过；pnpm typecheck、pnpm build、git diff --check 通过。新增/编辑、审核、上传、部分核销、金额守恒及导出行为沿用原有财务测试，未删除这些业务断言。

代码检查与财务行为测试不等同于视觉验收；所有本轮修改后的页面和弹框仍待人工在 1920×1080、100% 缩放下截图确认。