Files
admin-web/src/modules/fee-items/AGENTS.md
T
2026-10-20 14:25:01 +08:00

2.1 KiB
Raw Blame History

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。