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% 缩放下截图确认。

2026-10-20 蓝白样式接入

保留上方六菜单、11 路由和逐操作矩阵。五个主体页面显式接入蓝白主题，两个应收/应付路由封装继续复用同一主体；列表、流水、充值申请和对账单明细通过外层 workbench-table 接入，独立结算/对账单详情使用 workbench-panel is-flush，表单与凭证弹框分别声明主题作用域。保留行密度、宽表横向滚动、原有权限、幂等、金额和危险状态；未恢复没有当前路由消费者的 CustomerStatementsPanel。

应收款统计打印继续隐藏查询、工具栏与分页，并在打印媒体中取消新增页面内边距、卡片阴影，沿用原打印尺寸。直接 el-table 的主题支持由总控公共样式统一集成，不在财务模块复制配色规则。财务相关定向回归通过；本组共同 SFC/绑定核对及 61 文件 611 项定向结果见客户管理核对记录的同日结果。全量门禁由总控统一完成；11 路由及弹框仍待 1920×1080、100% 人工截图确认，未发布。

2026-10-20 用户追加修正：整页主列表与详情外壳使用 is-page-surface 取消外围整圈边框、圆角与阴影，页面保持连续白底；本组共 22 处主列表和 6 处详情容器，内部子表、指标/图表卡片、独立并列面板及弹框保持原边界。布局、内边距和脚本不因本修正改变；公共规则与全量门禁由总控统一收口。财务相关三文件 41 项定向复验通过，视觉仍待人工截图确认。

2026-10-21 浮层回归抽查：实际挂载检查客户账户充扣/授信/充值审核与凭证、费用来源和对账单生成/调整、应收应付创建与部分核销。沿用当前表单、宽表、错误和草稿逻辑，本批未发现需改写财务展示文件的新问题。相关选定行为回归通过；公共浮层修复合并后，普通/全屏、错误长文、凭证二级预览和正文/底部操作仍待人工截图确认。