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>
73 lines
2.6 KiB
Python
73 lines
2.6 KiB
Python
"""计提公式模板注册表（代码内有限集合）。
|
||
|
||
一期不引入规则引擎的落地方式：公式骨架固定（本表枚举），变化的是参数值
|
||
（系统设置维护）。岗位角色（business_roles.calc_template）绑定模板编码，
|
||
新增岗位 = 选模板 + 配参数，无需改代码（需求 #28）。
|
||
新增公式形态（如未来「按产品数量计提」）需要新增模板 —— 一期接受，
|
||
岗位表单中模板为带说明的受控下拉，避免误以为可自由写公式。
|
||
"""
|
||
|
||
from dataclasses import dataclass
|
||
|
||
|
||
@dataclass(frozen=True, slots=True)
|
||
class TemplateSpec:
|
||
"""公式模板元数据。"""
|
||
|
||
code: str
|
||
name: str
|
||
params: tuple[str, ...]
|
||
description: str
|
||
|
||
|
||
TEMPLATES: dict[str, TemplateSpec] = {
|
||
"TPL_SALESPERSON_DECAY": TemplateSpec(
|
||
code="TPL_SALESPERSON_DECAY",
|
||
name="业务员个人户·天数线性递减",
|
||
params=(
|
||
"salesperson.rate.start",
|
||
"salesperson.rate.slope",
|
||
"salesperson.rate.floor",
|
||
"salesperson.days.boundary",
|
||
),
|
||
description="分段：≤分界天数 = 起始 − 天数×斜率；>分界天数 = 下限",
|
||
),
|
||
"TPL_MANAGER_SHARE": TemplateSpec(
|
||
code="TPL_MANAGER_SHARE",
|
||
name="营销经理·团队与全公司分成",
|
||
params=("manager.share.team", "manager.share.company"),
|
||
description="聚合：∑本团队业务员绩效×12.5% + ∑全公司业务员绩效×5%",
|
||
),
|
||
"TPL_ENTERPRISE_FIXED": TemplateSpec(
|
||
code="TPL_ENTERPRISE_FIXED",
|
||
name="企业户·固定计提",
|
||
params=("enterprise.rate",),
|
||
description="乘法：折算毛利润额 × 计提比例",
|
||
),
|
||
"TPL_INFO_SALES_FIXED": TemplateSpec(
|
||
code="TPL_INFO_SALES_FIXED",
|
||
name="信息员·销售额固定比例",
|
||
params=("info.rate",),
|
||
description="乘法：本人销售额 × 计提比例",
|
||
),
|
||
"TPL_PREPAY_FIXED": TemplateSpec(
|
||
code="TPL_PREPAY_FIXED",
|
||
name="预付款·固定计提",
|
||
params=("prepay.rate",),
|
||
description="乘法：回款额 × 计提比例",
|
||
),
|
||
}
|
||
|
||
|
||
def get_template(code: str) -> TemplateSpec:
|
||
"""取模板元数据。未注册编码属代码缺陷（500），不是用户错误。"""
|
||
tpl = TEMPLATES.get(code)
|
||
if tpl is None:
|
||
raise ValueError(f"公式模板编码未注册：{code}")
|
||
return tpl
|
||
|
||
|
||
def required_params(code: str) -> tuple[str, ...]:
|
||
"""模板声明的参数编码列表（岗位表单展示与校验用）。"""
|
||
return get_template(code).params
|