3、多项目分摊规则：按比例分摊、按权重分摊、按自定义公式分摊的业务逻辑与算法

多项目分摊是成本台账系统的核心能力，决定了间接成本能否准确、公平地分配到各受益项目。本章深入剖析三种主流分摊规则的业务逻辑、算法实现及测试验证要点。

3.1 分摊规则概述与适用场景

不同分摊规则适用于不同的成本类型与业务场景。下表对比了三种规则的核心差异：

3.2 按比例分摊：业务逻辑与算法

按比例分摊是最基础的分摊方式，适用于成本与项目数量或固定份额直接相关的场景。

3.2.1 业务逻辑

• 系统维护一个分摊比例表，记录每个项目在特定成本类型下的分摊百分比。
• 所有项目的比例之和必须等于 100%（或 1.0）。
• 分摊金额 = 成本总额 × 项目分摊比例。

3.2.2 算法实现

// 按比例分摊算法（伪代码）
function allocateByRatio(totalCost, projectRatios) {
    // projectRatios: [{ projectId, ratio }]
    let sumRatio = 0;
    for (let item of projectRatios) {
        sumRatio += item.ratio;
    }
    // 校验比例总和是否为 1.0（允许浮点误差）
    if (Math.abs(sumRatio - 1.0) > 0.0001) {
        throw new Error("分摊比例之和不为 100%");
    }
    // 计算每个项目的分摊金额
    let results = [];
    for (let item of projectRatios) {
        let amount = totalCost * item.ratio;
        results.push({ projectId: item.projectId, amount: amount });
    }
    return results;
}

3.3 按权重分摊：业务逻辑与算法

按权重分摊适用于各项目对成本消耗程度不同的场景，如按项目人数、工时、设备台班等权重系数进行分摊。

3.3.1 业务逻辑

• 每个项目有一个或多个权重因子（如工时、产量、面积）。
• 分摊比例 = 项目权重 / 所有项目权重之和。
• 分摊金额 = 成本总额 × (项目权重 / 总权重)。

3.3.2 算法实现

// 按权重分摊算法（伪代码）
function allocateByWeight(totalCost, projectWeights) {
    // projectWeights: [{ projectId, weight }]
    let totalWeight = 0;
    for (let item of projectWeights) {
        totalWeight += item.weight;
    }
    if (totalWeight === 0) {
        throw new Error("所有项目权重之和为零，无法分摊");
    }
    let results = [];
    for (let item of projectWeights) {
        let ratio = item.weight / totalWeight;
        let amount = totalCost * ratio;
        results.push({ projectId: item.projectId, weight: item.weight, ratio: ratio, amount: amount });
    }
    return results;
}

3.4 按自定义公式分摊：业务逻辑与算法

自定义公式分摊提供了最大的灵活性，允许用户通过数学表达式定义分摊逻辑，适用于复杂业务规则。

3.4.1 业务逻辑

• 用户编写公式，公式中可引用系统变量（如成本总额、项目属性、外部数据）。
• 公式引擎解析并计算每个项目的分摊金额。
• 支持条件判断、循环、函数调用等高级特性。

3.4.2 算法实现

// 自定义公式分摊算法（伪代码）
function allocateByFormula(totalCost, projects, formulaExpression) {
    // formulaExpression: 用户定义的公式字符串，如 "baseAmount * (1 + difficultyFactor)"
    // projects: [{ projectId, baseAmount, difficultyFactor }]
    let results = [];
    for (let project of projects) {
        // 构建公式执行上下文
        let context = {
            totalCost: totalCost,
            baseAmount: project.baseAmount,
            difficultyFactor: project.difficultyFactor
        };
        // 调用公式引擎执行计算
        let amount = evaluateFormula(formulaExpression, context);
        results.push({ projectId: project.projectId, amount: amount });
    }
    return results;
}

3.5 三种分摊规则的对比与选择

以下 SVG 图展示了三种分摊规则在业务决策中的选择路径：

3.6 分摊规则测试验证矩阵

以下表格总结了三种分摊规则的测试验证要点：

3.7 分摊规则与财务报表合并的接口交互

分摊结果需要传递给财务报表合并模块，接口设计需保证数据一致性。以下 SVG 图展示了分摊规则模块与合并模块的交互流程：

3.8 分摊规则测试用例设计要点

1. 正向用例： 标准比例（30%、30%、40%）、标准权重（工时 100、200、300）、标准公式（totalCost * 0.3 + fixedFee）。
2. 负向用例： 比例总和≠100%、权重总和=0、公式语法错误、公式引用未定义变量。
3. 边界用例： 单项目独占（比例=100%）、所有项目权重相等、公式返回负数金额、公式结果极小（0.0001元）。
4. 并发用例： 同一成本同时被多个用户触发分摊、分摊过程中权重表被修改、公式依赖数据被删除。
5. 集成用例： 分摊结果传入合并模块后，验证合并报表中项目成本明细与分摊明细一致。