hjhan
be3be877ec
1. 新增 AccrualContext 只读值对象，把 annualDays/precision/trace 三个"与金额利率无关" 的横向参数打包为上下文成员。计息纯函数只吃一个 ctx，签名去噪、可读性提升； ctx 为只读值对象（非类的实例/静态字段），不破坏纯函数（线程安全、可重入、可测）。 trace 因此成为"传入上下文的成员"而非散落参数，满足"默认成员而非参数"的诉求。 2. AccrueCompound → AccrueCompoundInArrears：精确表达 OIS/SOFR/FR007 的 compounded-in-arrears 语义（每子区间取定盘、段末滚入本金），与 InterestRate.Compounding.Compounded 闭式分支（TRS 下死路径）一刀两断、不再混淆。 纯增量、数值逻辑不变；YLErpDAL + UnitTestProject 编译 0 错 0 警；FR007 两段切换场景 实跑 trace 与旧版数值完全一致。
44 lines
2.1 KiB
C#
44 lines
2.1 KiB
C#
using YLErp.Core.Interest;
|
|
using YLErp.Derivatives.Interest;
|
|
|
|
namespace YLErp.Modules.SwapModule.Margin;
|
|
|
|
/// <summary>
|
|
/// 保证金账户。管理保证金余额的变动（追加/释放/返还），并提供计息入口。
|
|
///
|
|
/// 保证金是独立的资金管理概念（初始保证金/维持保证金/保证金余额/追保），
|
|
/// 与融资腿(funding leg)完全无关。现有代码把保证金塞进 InterestMode==5/6
|
|
/// 当计息腿处理是错误的，本类是正确建模的起点。
|
|
///
|
|
/// 利息计算委托 SwapInterest 纯函数（余额×利率×天数/年化），
|
|
/// 保证金账户只提供余额和计息入口，不自己实现计息算法。
|
|
/// </summary>
|
|
public sealed class MarginAccount
|
|
{
|
|
/// <summary>当前保证金余额。</summary>
|
|
public MarginBalance Balance { get; private set; }
|
|
|
|
public MarginAccount(MarginBalance openingBalance)
|
|
=> Balance = openingBalance;
|
|
|
|
/// <summary>追加保证金（余额增加）。</summary>
|
|
public void Deposit(decimal amount)
|
|
=> Balance = new MarginBalance(Balance.Balance + amount);
|
|
|
|
/// <summary>释放/返还保证金（余额减少，不低于 0）。</summary>
|
|
public void Withdraw(decimal amount)
|
|
=> Balance = new MarginBalance(Math.Max(0m, Balance.Balance - amount));
|
|
|
|
/// <summary>
|
|
/// 按当前余额计算保证金利息。委托 SwapInterest.AccrueSimple。
|
|
/// 保证金利息是券商对客户保证金存款付息（方向与融资腿相反）。
|
|
/// </summary>
|
|
/// <param name="rate">保证金利率（年化，如 0.03 = 3%）。</param>
|
|
/// <param name="startDate">计息开始日。</param>
|
|
/// <param name="endDate">计息结束日。</param>
|
|
/// <param name="boundary">算头算尾规则。</param>
|
|
/// <param name="annualDays">年化天数（365 或 360）。</param>
|
|
public InterestResult AccrueInterest(decimal rate, System.DateTime startDate, System.DateTime endDate, AccrualBoundary boundary, int annualDays)
|
|
=> SwapInterest.AccrueSimple(new AccrualContext(annualDays), Balance.Balance, rate, startDate, endDate, boundary);
|
|
}
|