Admin Finance Module Instructions

范围与入口

本文件适用于 src/modules/finance/。产品范围和状态读取 ../../../../../docs/财务管理/ 的产品确认与验收契约，后端读取 ../../../../../baiyue-firstleg/finance/AGENTS.md。
页面从 pages/ 进入，统一 API 从 api/finance.ts 进入；费用来源和柜次成本快照联查 firstleg/，凭证与异步导出联查 file/。
正式范围包括客户账户、客户应收应付、应收款统计、客户对账单、应收结算单和应付结算单；不要从历史原型自动扩大财务功能。

六个正式列表页统一加载全部 ACTIVE 客户并使用可筛选下拉框；用户可见选项只显示 tenantName，以 customerId 作为接口筛选值。
不恢复自由输入客户关键词，不把客户编码、联系人或手机号拼入下拉标签；业务单号和费用项目继续使用独立筛选字段。
应收款统计从 pages/FinanceReceivableStatisticsView.vue、api/finance.ts 进入，只汇总指定生成月份的 CNY 正式应收结算单。
统计月份使用 yyyy-MM；当前页打印留在页面，Excel 通过 FINANCE_RECEIVABLE_STATISTICS 进入 File 下载中心异步导出。

入库费用的应付/直接已付表单在 ../unified-orders/components/InboundFeeDetailManager.vue，柜次费用在 ../loading-lists/components/ContainerFeesPanel.vue；柜级公共费用在同一面板按真实客户与订单分摊，入仓码按事实选填；对应 API 分别为 ../unified-orders/api/inboundFeeDetails.ts、../loading-lists/api/containerFees.ts。
DIRECT_PAID 必须提交已付时间、付款方式，以及付款流水号或至少一个付款凭证；凭证由费用 API 调用 /platform/finance/v1/vouchers 上传为 FINANCE_VOUCHER，并绑定当前客户。
后端事实入口为 Firstleg FeePaymentSnapshotValidator、入库/柜次费用服务，文件元数据归 File；Finance 只消费已发布的费用来源快照，不在前端或 Finance 中重建付款事实。