shenyifei 9001490da1 feat(dealer): 添加经销商应收账款功能并优化订单发货单相关组件

- 新增 DealerAccountRecordList 组件用于展示经销商应收账款记录
- 在 DealerList 中添加应收账款标签页和相关组件
- 为 OrderShipList 和 OrderShipModal 添加应收金额和调整金额列
- 新增 OrderSupplierSelectList 替代原有的 OrderSupplierInvoiceList
- 重构 ReconciliationSummary 使用 ProForm 组件并优化抹零功能
- 更新对账单创建页面逻辑，使用新的应收金额和调整金额字段
- 添加 ReceivablesDetail 页面用于查看应收账款明细
- 优化发货单选择列表的列配置和渲染方式

2026-01-09 18:04:49 +08:00

2.1 KiB

Raw Blame History

paths
src/services/*/.ts

规则：不要直接修改 src/services 目录，使用 typings.d.ts 获取类型

规则说明

packages/app-operation/src/services/ 目录下的文件由 OpenAPI 自动生成，不应手动修改。

目录结构

src/services/
├── index.ts              # 导出入口（自动生成）
├── business/             # 业务 API
│   ├── index.ts          # 模块导出（自动生成）
│   ├── order.ts          # API 实现（自动生成）
│   └── typings.d.ts      # 类型定义（从 typings.d.ts 读取）
├── auth/
│   ├── index.ts
│   ├── user.ts
│   └── typings.d.ts
└── ...

禁止行为

❌ 直接修改 src/services/**/*.ts 文件
❌ 在 .ts 文件中添加、删除或修改 API 函数
❌ 手动编辑类型定义

正确做法

1. 获取类型信息

当需要查看或使用 API 类型时，必须使用 Glob/Grep 工具读取 typings.d.ts 文件：

# 正确：读取类型定义文件
Glob pattern: "packages/app-operation/src/services/**/typings.d.ts"
Grep pattern: "OrderVO" path: "packages/app-operation/src/services/business/typings.d.ts"

# 错误：直接读取 .ts 实现文件
Read file: "packages/app-operation/src/services/business/typings.d.ts"

2. 查找 API 函数

查找 API 函数时，通过模块名推断文件位置，使用 Grep 搜索：

# 查找订单相关 API
Grep path: "packages/app-operation/src/services" pattern: "order"

3. 更新 API

如需更新 API 类型定义，运行：

cd packages/app-operation
pnpm openapi

类型命名规范

typings.d.ts 中的类型遵循以下命名模式：

类型后缀	用途	示例
`VO`	视图对象（响应）	`OrderVO`
`Qry`	查询参数	`OrderPageQry`
`Cmd`	命令参数（创建/更新）	`OrderCreateCmd`
`PageQry`	分页查询	`OrderPageQry`

违反此规则的后果

手动修改会在 pnpm openapi 后被覆盖
可能导致 API 类型与后端不一致
破坏自动生成机制的完整性

2.1 KiB Raw Blame History