yumoqing
da32159ad9
- 7个数据库表: suppliers, supply_contracts, supply_contract_items, sub_distributors, distribution_agreements, distribution_agreement_items, supplychain_accounting - CRUD JSON配置 (7个列表 + editable段) - API端点: create/update/delete (21个) + calculate_accounting + query_discount (2个) - 前端页面: index.ui + 5个功能页 + menu.ui - 记账计算: 自动查找有效合同/协议折扣，计算进货金额、分销金额、利润 - 折扣查找优先级: 精确产品 > 产品分类 > 默认折扣 - productid/prodtypeid引用product模块（即将开发）
2.1 KiB
2.1 KiB
| name | version | description | trigger_conditions | ||||
|---|---|---|---|---|---|---|---|
| supplychain-module | 1.0.0 | 供应商和分销商管理模块 — 供销合同、分销协议、产品折扣及供销记账 |
|
supplychain 模块技能文档
模块概述
supplychain 模块为分销商提供供应链管理功能，包括供应商管理、供销合同管理、二级分销商管理、分销协议管理，以及产品销售时的供销记账金额计算。
数据表结构
实体表
- suppliers — 供应商（基本信息、联系方式、财务信息）
- supply_contracts — 供销合同（运营创建，关联供应商，设置有效期）
- sub_distributors — 二级分销商（销售创建，基本信息）
- distribution_agreements — 分销协议（销售创建，关联二级分销商）
关系表
- supply_contract_items — 供销合同产品折扣明细（合同下的产品级折扣）
- distribution_agreement_items — 分销协议产品折扣明细（协议下的产品级折扣）
- supplychain_accounting — 供销记账记录（销售时自动计算）
折扣查找优先级
无论是进货折扣还是分销折扣，查找优先级均为：
- 精确匹配 productid
- 匹配 prodtypeid（产品分类级折扣）
- 使用合同/协议的 default_discount
API 调用
记账计算
POST /supplychain/api/calculate_accounting.dspy
Body: {productid, prodtypeid?, quantity, unit_price, sub_distributor_id?, sale_date?, ...}
Python 函数调用
# 在 .dspy 文件中
record = await calculate_sale_accounting(sor, resellerid, productid, quantity, unit_price,
sub_distributor_id, prodtypeid, sale_date, ...)
注意事项
- productid 和 prodtypeid 引用 product 模块（即将开发）
- 所有数据通过 resellerid 隔离（机构级多租户）
- 合同/协议编号自动生成
- 折扣值范围 0-1（1.0 表示无折扣）