ouyangxq
1e26ddad4b
新增 11 个模块级 AGENTS.md，覆盖企业工作台全部业务模块，入口表统一指向模块指引。 - 统一四段式：路径基准 / 页面与入口表 / 关键边界 / 验证入口 - 补明“页面 -> store -> API”的调用链路，避免只给目录 - 仅索引文档，未改动业务代码
30 lines
1.9 KiB
Markdown
30 lines
1.9 KiB
Markdown
# Client 财务模块指引
|
||
|
||
## 路径基准与读取顺序
|
||
|
||
- 本文件适用于 `src/modules/finance/`，代码路径相对本目录；应用公共规则见 `../../../AGENTS.md`，账单与资金细则见 `../../../docs/business-index.md`。
|
||
- 本模块只做客户可见的账单查询、客户确认与资金账户；费用来源、核销与账期归 `backend finance/`，不在前端重算。
|
||
- 后端只查 `finance/`（账单、收款、账户与授信）；文件下载归 `file/`。
|
||
|
||
## 页面与入口
|
||
|
||
| 目标 | 页面/路由 | API 与后端 |
|
||
|---|---|---|
|
||
| 客户财务账单列表、筛选与未收余额 | `views/FinanceBillsView.vue`；`finance/bills` | `api/finance.ts`；`finance/` 账单 |
|
||
| 账单详情、入仓码联查与客户确认 | `views/FinanceBillDetailView.vue`；`finance/bills/:billNo/detail` | `api/finance.ts`、`adapters.ts`；`finance/` |
|
||
| 客户资金账户、授信与充值申请 | `views/FinanceAccountView.vue`；`finance/account` | `api/account.ts`；`finance/` 资金账户 |
|
||
| 跨页契约与稳定类型 | `contracts.ts` | 服务端 DTO |
|
||
|
||
## 关键边界
|
||
|
||
- 账单行只显示服务端返回的 `inboundCode`；缺失时显示“—”，不用内部 ID 或本地拼接回退。
|
||
- 实际、冻结、可用余额、授信与流水只消费 Finance 权威结果，前端不自行汇总或推算。
|
||
- 客户确认按服务端允许动作开放，提交金额与状态以服务端返回为准；已确认账单不得在前端改回。
|
||
- 充值申请与账户操作携带幂等键与提交中状态，失败保留原输入。
|
||
- 费用明细与柜级分摊只展示服务端结果；前端不参与分摊计算，也不把退税额或汇率写死。
|
||
|
||
## 验证
|
||
|
||
- 定向：`pnpm test src/modules/finance/<目标测试>`；接口或金额字段变化同时运行 `pnpm typecheck`。
|
||
- 本文件或索引变更后，从后端根运行 `./scripts/agents-index-contract.ps1`。
|