2.1 KiB
2.1 KiB
Admin 费用项目模块指引
路径基准与读取顺序
- 本文件适用于
src/modules/fee-items/,代码路径相对本目录;应用公共规则见../../../AGENTS.md。 - 只有一个页面
pages/FeeItemsView.vue(路由master-data/fee-items,挂在系统主数据下)和一个接口文件api/platformFeeItems.ts;弹框实现与页面同目录。 - 后端只查
firstleg/controller/PlatformFeeItemController.java与openapi/fee-item-v1.yaml;客户专属价格簿归../fba-pricing/,两者不是同一概念。
页面与入口
| 目标 | 页面/入口 | API 与后端 |
|---|---|---|
| 费用项目列表、启停与排序 | pages/FeeItemsView.vue;master-data/fee-items |
api/platformFeeItems.ts;firstleg/controller/PlatformFeeItemController.java |
| 新增/编辑费用项目弹框 | pages/FeeItemsView.vue 内弹框 |
api/platformFeeItems.ts 的 SavePlatformFeeItemRequest;当前表单不提交 feeCode |
| 默认价格(CNY,可空)与类别/贸易范围 | 列表与新增/编辑弹框 | api/platformFeeItems.ts;带价与校验规则见详细索引 |
关键边界
- 服务端支持修改
feeCode,省略时保留原编码;当前 Admin 表单未暴露该字段,不因本指引扩展界面。编码格式、长度与唯一性以服务端契约和校验为准。 defaultPrice只是带入初值:仅当用户主动选择该项目时带入(入库同时带单价与金额、柜次带金额),均允许人工修改;为空表示不自动带价,0表示明确的零元。修改或清空默认价不追改已有费用;打开已有费用、切换供应商或保存业务费用时不重新套用默认价,也不改变审核、发布与结算流程。- 停用费用项目不回溯已出账费用;历史账单继续显示原项目名称快照。
- 供应商类别仅对需要供应商的费用类型有效,留空表示任意启用供应商,不由前端补默认值。
验证
- 定向:
pnpm test src/modules/fee-items/<目标测试>;字段或权限变化同时运行pnpm typecheck。 - 本文件或索引变更后,从后端根运行
./scripts/agents-index-contract.ps1。