1. 课程导入

在信贷核心系统中，放款计息与还款计划引擎是连接资金端与资产端的关键计算中枢。它决定了每一笔贷款从放款那一刻起，如何按日计息、如何分摊本金与利息、如何生成每一期还款金额，以及提前还款、逾期、展期等异常场景下如何重新计算。很多团队在业务初期用简单公式应付，一旦产品线扩展到等额本息、等额本金、先息后本、随借随还、按日计息等多种模式，代码就会迅速腐化。本课程的目标，是帮助你把这块“看起来只是算数”的逻辑，建设成可配置、可验证、可审计的引擎。

一、学习目标：从会算到会设计

本课程不是单纯讲解利息公式，而是围绕“引擎化”展开。学完之后，你应当能够独立完成以下任务：

• 准确区分计息基础、计息周期、还款周期与账单周期，避免概念混用导致的对账差异。
• 掌握等额本息、等额本金、先息后本、按日计息到期还本等主流还款方式的推导与实现。
• 设计一套可配置的还款计划生成流程，支持利率调整、提前还款、逾期罚息与尾差处理。
• 建立金额精度、舍入规则与尾差归集机制，保证借贷双方账目平衡。
• 能够为引擎编写单元测试与对账用例，用真实场景验证计算结果的正确性。

二、核心概念：先把术语钉死

在进入公式之前，必须先统一语言。以下概念贯穿全课程：

其中，利率换算与计息天数是争议最多的两个点。例如年利率12%，按月计息时，月利率可能是1%，也可能是12%/12=1%，但按日计息时，日利率可能是12%/360或12%/365，不同规则会产生可观的金额差异。引擎必须把“计息规则”作为显式配置，而不是隐藏在代码常量里。

三、整体框架：引擎由哪些部件组成

一个完整的放款计息与还款计划引擎，通常包含五个层次：输入层、规则层、计算层、计划层与输出层。输入层接收贷款金额、利率、期限、还款方式、放款日、首期还款日等参数；规则层负责利率换算、计息天数、舍入策略与尾差处理；计算层执行每期利息、本金、剩余本金的推导；计划层把计算结果组织成带期次、应还日期、应还金额的明细表；输出层则提供给账务、催收、对账与报表系统使用。

这个框架的价值在于：当业务方提出“把等额本息改成等额本金”或“支持提前还款后重算”时，你只需要调整规则层与计算层的策略，而不必重写整个系统。引擎化的本质，是把变化点收敛到配置与策略中。

四、方法流程：一笔贷款的计划生成过程

以最常见的等额本息为例，计划生成通常遵循以下流程：

1. 校验输入参数：金额大于0、利率非负、期限为正整数、放款日不晚于首期还款日。
2. 确定计息规则：年利率换算为月利率或日利率，明确计息天数采用实际天数还是30/360。
3. 计算每期还款额：等额本息使用年金公式，等额本金则先算每期本金再算利息。
4. 逐期推导：每期利息=剩余本金×期利率，每期本金=每期还款额-每期利息，更新剩余本金。
5. 处理尾差：将因舍入产生的差额归集到最后一期，确保剩余本金归零。
6. 输出计划表：包含期次、应还日期、应还本金、应还利息、应还总额、剩余本金。

等额本息每期还款额公式：
M = P × r × (1 + r)^n / ((1 + r)^n - 1)

其中：
P = 贷款本金
r = 每期利率（月利率或日利率）
n = 还款期数
M = 每期应还金额

每期利息 = 剩余本金 × r
每期本金 = M - 每期利息
下一期剩余本金 = 当前剩余本金 - 每期本金

实际工程中，不能直接用浮点数累加，而应使用高精度小数类型，并在每一步明确舍入位数。否则，经过几十期迭代后，误差会被放大，导致最后一期出现几元甚至几十元的偏差。

五、案例与场景：为什么需要引擎而不是公式

假设一笔10万元、年利率12%、12期的贷款，采用等额本息。如果只写一个公式函数，看似足够。但当出现以下场景时，问题就会暴露：

• 放款日为1月31日，首期还款日为2月28日，计息天数不足一个月，首期利息如何计算？
• 客户在第6期提前还款5万元，剩余期数如何重算？是缩短期限还是减少月供？
• 利率在放款后第4期发生调整，后续期次的利息如何分段计算？
• 逾期后罚息按日计收，罚息是否计入剩余本金？是否影响后续利息基数？

六、误区与复盘：新手最容易踩的坑

在过往项目中，以下误区反复出现，值得提前警惕：

• 用浮点数直接计算金额。 浮点误差在多次累加后不可控，必须使用Decimal或整数分。
• 把年利率简单除以12当作月利率。 在按日计息场景下，这会与合同约定产生偏差。
• 尾差随意丢弃。 尾差必须归集到最后一期，否则借贷双方账目无法平衡。
• 提前还款后仍按原计划表执行。 提前还款必须触发重算，生成新的还款计划。
• 没有对账用例。 引擎上线前，必须用真实合同数据做逐期对账，而不是只看最后一期总额。