5ed5665a54
- formula.py 八个纯函数：回款天数（首日计1）、业务员分段递减（360=6‰/361=4‰）、折算毛利润额化简式（防除零）、乘法方向绩效、以物抵顶/R×R/起付 - param_registry.py：16 项参数元数据（与迁移种子同源）+ Fraction 精确解析（4/360 禁截断）+ 类型/取值域/枚举校验 - calc_templates.py：5 个公式模板注册表（岗位绑定的受控集合） - 新增 43 项单元用例：精确分数断言（899/90000、27 天、9/25），畸形值拒绝 Co-Authored-By: Claude Code <noreply@anthropic.com>
89 lines
3.6 KiB
Python
89 lines
3.6 KiB
Python
"""计提公式纯函数（无 IO、无会话）。
|
||
|
||
契约（与 M3 核算、计算预览共用，口径见 2026-10-12 业务裁决）：
|
||
- 参数值按**存储口径**传入（含单位：比例参数为 ‰ 数如 10、百分比参数为 % 数如 60）
|
||
- 计算出的中间比率（如毛利润率）为**纯比例**（Fraction，如 9/20）
|
||
- 金额用 Decimal、比率用 Fraction，全程禁 float；Fraction→Decimal 转换在
|
||
分母仅含 2/5 因子时精确，否则按 Decimal 上下文精度（28 位）
|
||
- 绩效 = 折算毛利润额 × 计提比例（乘法方向，对照表 #3，禁按"互为倒数"实现）
|
||
"""
|
||
|
||
from datetime import date
|
||
from decimal import Decimal
|
||
from fractions import Fraction
|
||
|
||
|
||
def _to_decimal(value: Fraction) -> Decimal:
|
||
"""Fraction → Decimal。有限小数精确；循环小数按 Decimal 上下文精度（28 位）。"""
|
||
return Decimal(value.numerator) / Decimal(value.denominator)
|
||
|
||
|
||
def payment_days(ship_date: date, receipt_date: date) -> int:
|
||
"""回款天数：发货日首日计第 1 天（对照表 #1；需规「26 天」示例作废）。"""
|
||
return (receipt_date - ship_date).days + 1
|
||
|
||
|
||
def salesperson_rate(
|
||
days: int,
|
||
*,
|
||
start: Fraction,
|
||
slope: Fraction,
|
||
floor: Fraction,
|
||
boundary_days: int,
|
||
) -> Fraction:
|
||
"""业务员计提比例（纯比例）。
|
||
|
||
start/floor 为 ‰ 数、slope 为 ‰/天（存储口径，slope 为精确分数 4/360）。
|
||
≤分界天数按「起始 − 天数×斜率」线性递减；超过分界天数固定取下限
|
||
（对照表 #4：360 天=6‰，361 天起固定 4‰）。
|
||
"""
|
||
if days > boundary_days:
|
||
return floor / 1000
|
||
return (start - days * slope) / 1000
|
||
|
||
|
||
def profit_rate(profit: Decimal, revenue: Decimal) -> Fraction:
|
||
"""毛利润率（纯比例）：毛利润额 / 销售额（**不含运费**口径，对照表 #2）。
|
||
|
||
销售额为 0 时返回 0（防除零；折算额随之为 0）。
|
||
"""
|
||
if revenue == 0:
|
||
return Fraction(0)
|
||
return Fraction(profit) / Fraction(revenue)
|
||
|
||
|
||
def converted_profit(revenue: Decimal, rate: Fraction, threshold: Fraction) -> Decimal:
|
||
"""折算毛利润额（化简式）：销售额 × (毛利润率 − 阈值)。
|
||
|
||
rate 为纯比例（profit_rate 的输出）；threshold 为 % 数（存储口径，如 30）。
|
||
化简式等价于定义式「毛利润额 / 毛利润率 × (毛利润率 − 阈值)」，且避免
|
||
毛利润率为 0 时除零（对照表 #12/#13）。毛利润率低于阈值时结果为负 ——
|
||
业务确认负值正常计算、不归零。
|
||
"""
|
||
return _to_decimal(Fraction(revenue) * (rate - threshold / 100))
|
||
|
||
|
||
def performance_amount(base: Decimal, rate: Fraction) -> Decimal:
|
||
"""绩效金额 = 折算毛利润额 × 计提比例（乘法方向，对照表 #3）。"""
|
||
return _to_decimal(Fraction(base) * rate)
|
||
|
||
|
||
def apply_barter(amount: Decimal, discount: Fraction) -> Decimal:
|
||
"""以物抵顶折算：应发绩效 × 折算比例（discount 为 % 数，默认 80，对照表 #24）。"""
|
||
return _to_decimal(Fraction(amount) * discount / 100)
|
||
|
||
|
||
def payment_weight(r: int) -> Fraction:
|
||
"""支付权重 R×R（纯比例）：R 为回款占销售额百分比向下取整（对照表 #22）。
|
||
|
||
60 → 36/100；100 → 1（全额）。
|
||
"""
|
||
return Fraction(r, 100) * Fraction(r, 100)
|
||
|
||
|
||
def start_payment_ok(received: Decimal, revenue: Decimal, ratio: Fraction) -> bool:
|
||
"""起付判定：单项业务回款额达到销售额（不含运费）的 ratio%（对照表 #21）。"""
|
||
if revenue == 0:
|
||
return False
|
||
return Fraction(received) / Fraction(revenue) >= ratio / 100
|