---
name: supplychain-module
version: 1.0.0
description: 供应商和分销商管理模块 — 供销合同、分销协议、产品折扣及供销记账
trigger_conditions:
  - 需要管理供应商信息
  - 需要创建供销合同或分销协议
  - 需要为产品设置进货或分销折扣
  - 需要计算产品销售时的供销记账金额
---

# supplychain 模块技能文档

## 模块概述

supplychain 模块为分销商提供供应链管理功能，包括供应商管理、供销合同管理、二级分销商管理、分销协议管理，以及产品销售时的供销记账金额计算。

## 数据表结构

### 实体表
- **suppliers** — 供应商（基本信息、联系方式、财务信息）
- **supply_contracts** — 供销合同（运营创建，关联供应商，设置有效期）
- **sub_distributors** — 二级分销商（销售创建，基本信息）
- **distribution_agreements** — 分销协议（销售创建，关联二级分销商）

### 关系表
- **supply_contract_items** — 供销合同产品折扣明细（合同下的产品级折扣）
- **distribution_agreement_items** — 分销协议产品折扣明细（协议下的产品级折扣）
- **supplychain_accounting** — 供销记账记录（销售时自动计算）

## 折扣查找优先级

无论是进货折扣还是分销折扣，查找优先级均为：
1. 精确匹配 productid
2. 匹配 prodtypeid（产品分类级折扣）
3. 使用合同/协议的 default_discount

## API 调用

### 记账计算

```
POST /supplychain/api/calculate_accounting.dspy
Body: {productid, prodtypeid?, quantity, unit_price, sub_distributor_id?, sale_date?, ...}
```

### Python 函数调用

```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 表示无折扣）