21 lines
1.7 KiB
Markdown
21 lines
1.7 KiB
Markdown
|
# 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 下载中心异步导出。
|
||
|
|
|
||
|
|
## 权限与验证
|
||
|
|
|
||
|
|
- 列表和详情只读遵守 `*:list` 统一语义；确认、审核、导出、上传等写入或产出文件的动作继续使用独立权限。
|
||
|
|
- 修改筛选、DTO 或请求参数时同步检查页面、API 类型、Mock/Fixture、测试、Finance OpenAPI 和实际消费者。
|
||
|
|
- 至少运行 Finance 模块受影响测试和 `pnpm typecheck`；交付前按项目指引运行 `pnpm test` 与 `pnpm build`。
|