diff --git a/UnitTestProject/Modules/SwapModule/Margin/MarginLegTest.cs b/UnitTestProject/Modules/SwapModule/Margin/MarginLegTest.cs
index 69677e2b..80f2330e 100644
--- a/UnitTestProject/Modules/SwapModule/Margin/MarginLegTest.cs
+++ b/UnitTestProject/Modules/SwapModule/Margin/MarginLegTest.cs
@@ -4,40 +4,53 @@ using YLErp.Modules.SwapModule.Margin;
namespace UnitTestProject.Modules.SwapModule.Margin
{
///
- /// 保证金利息计提(MarginLeg)单测。验证计息余额计算,以及三种形态解析器可互换产余额。
- /// 替换原 InterestLegStrategyTest 里的预付金(PrepayLeg)用例——预付金已迁出利息腿限界上下文。
+ /// 保证金账户(MarginAccount)单测。验证余额变动(追加/释放/返还)。
+ /// 保证金就是保证金——有余额、有利率、有利息,不存在"计息基数/Notional"概念。
///
[TestClass]
public class MarginLegTest
{
- private const decimal Balance = 2_000_000m;
+ private const decimal Opening = 2_000_000m;
+
+ #region MarginAccount 余额变动
[TestMethod]
- public void 计息余额_默认不缩放_等于保证金全额()
+ public void 账户_初始余额等于期初保证金()
{
- var leg = new MarginLeg();
- var r = leg.CalcBalance(Balance);
- Assert.AreEqual(Balance, r.Balance, "默认不缩放,余额=保证金全额");
+ var account = new MarginAccount(new MarginBalance(Opening));
+ Assert.AreEqual(Opening, account.Balance.Balance);
}
[TestMethod]
- public void 计息余额_部分释放_按适用比例缩放()
+ public void 账户_追加保证金_余额增加()
{
- var leg = new MarginLeg();
- var r = leg.CalcBalance(Balance, 0.5m);
- Assert.AreEqual(1_000_000m, r.Balance, "部分释放:余额×适用比例");
+ var account = new MarginAccount(new MarginBalance(Opening));
+ account.Deposit(500_000m);
+ Assert.AreEqual(2_500_000m, account.Balance.Balance);
}
[TestMethod]
- public void 计息余额_零适用比例_为零()
+ public void 账户_释放保证金_余额减少()
{
- var leg = new MarginLeg();
- var r = leg.CalcBalance(Balance, 0m);
- Assert.AreEqual(0m, r.Balance);
+ var account = new MarginAccount(new MarginBalance(Opening));
+ account.Withdraw(800_000m);
+ Assert.AreEqual(1_200_000m, account.Balance.Balance);
}
[TestMethod]
- public void 三种形态解析器_均可互换产出余额()
+ public void 账户_释放超过余额_不低于零()
+ {
+ var account = new MarginAccount(new MarginBalance(Opening));
+ account.Withdraw(3_000_000m);
+ Assert.AreEqual(0m, account.Balance.Balance, "保证金余额不低于零");
+ }
+
+ #endregion
+
+ #region 三种保证金形态解析器
+
+ [TestMethod]
+ public void 三种形态解析器_各自返回正确Form和余额()
{
IMarginResolver cash = new CashMargin();
IMarginResolver credit = new CreditMargin();
@@ -47,9 +60,11 @@ namespace UnitTestProject.Modules.SwapModule.Margin
Assert.AreEqual(MarginForm.Credit, credit.Form);
Assert.AreEqual(MarginForm.Guarantee, guarantee.Form);
- Assert.AreEqual(1_000_000m, cash.Resolve(Balance, 0.5m).Balance);
- Assert.AreEqual(1_000_000m, credit.Resolve(Balance, 0.5m).Balance);
- Assert.AreEqual(1_000_000m, guarantee.Resolve(Balance, 0.5m).Balance);
+ Assert.AreEqual(Opening, cash.Resolve(Opening).Balance);
+ Assert.AreEqual(Opening, credit.Resolve(Opening).Balance);
+ Assert.AreEqual(Opening, guarantee.Resolve(Opening).Balance);
}
+
+ #endregion
}
}
diff --git a/YLErpDAL/Modules/SwapModule/Margin/CashMargin.cs b/YLErpDAL/Modules/SwapModule/Margin/CashMargin.cs
index cdb86677..128f34ba 100644
--- a/YLErpDAL/Modules/SwapModule/Margin/CashMargin.cs
+++ b/YLErpDAL/Modules/SwapModule/Margin/CashMargin.cs
@@ -1,10 +1,10 @@
namespace YLErp.Modules.SwapModule.Margin;
-/// 现金保证金:计息余额 = 现金余额。
+/// 现金保证金:余额 = 现金余额。
public sealed class CashMargin : IMarginResolver
{
public MarginForm Form => MarginForm.Cash;
- public MarginBalance Resolve(decimal postedAmount, decimal accrualFactor = 1m)
- => new(postedAmount * accrualFactor);
+ public MarginBalance Resolve(decimal postedAmount)
+ => new(postedAmount);
}
diff --git a/YLErpDAL/Modules/SwapModule/Margin/CreditMargin.cs b/YLErpDAL/Modules/SwapModule/Margin/CreditMargin.cs
index 5524bb81..dd3c0032 100644
--- a/YLErpDAL/Modules/SwapModule/Margin/CreditMargin.cs
+++ b/YLErpDAL/Modules/SwapModule/Margin/CreditMargin.cs
@@ -1,10 +1,10 @@
namespace YLErp.Modules.SwapModule.Margin;
-/// 授信保证:计息余额 = 已用授信额度。
+/// 授信保证:余额 = 已用授信额度。
public sealed class CreditMargin : IMarginResolver
{
public MarginForm Form => MarginForm.Credit;
- public MarginBalance Resolve(decimal postedAmount, decimal accrualFactor = 1m)
- => new(postedAmount * accrualFactor);
+ public MarginBalance Resolve(decimal postedAmount)
+ => new(postedAmount);
}
diff --git a/YLErpDAL/Modules/SwapModule/Margin/GuaranteeMargin.cs b/YLErpDAL/Modules/SwapModule/Margin/GuaranteeMargin.cs
index 41cf30f6..8506a687 100644
--- a/YLErpDAL/Modules/SwapModule/Margin/GuaranteeMargin.cs
+++ b/YLErpDAL/Modules/SwapModule/Margin/GuaranteeMargin.cs
@@ -1,10 +1,10 @@
namespace YLErp.Modules.SwapModule.Margin;
-/// 担保品:计息余额 = 担保品市值。
+/// 担保品:余额 = 担保品市值。
public sealed class GuaranteeMargin : IMarginResolver
{
public MarginForm Form => MarginForm.Guarantee;
- public MarginBalance Resolve(decimal postedAmount, decimal accrualFactor = 1m)
- => new(postedAmount * accrualFactor);
+ public MarginBalance Resolve(decimal postedAmount)
+ => new(postedAmount);
}
diff --git a/YLErpDAL/Modules/SwapModule/Margin/IMarginResolver.cs b/YLErpDAL/Modules/SwapModule/Margin/IMarginResolver.cs
index b542de8a..1e24f876 100644
--- a/YLErpDAL/Modules/SwapModule/Margin/IMarginResolver.cs
+++ b/YLErpDAL/Modules/SwapModule/Margin/IMarginResolver.cs
@@ -3,22 +3,22 @@ namespace YLErp.Modules.SwapModule.Margin;
/// 保证金形态:现金 / 授信 / 担保。预留扩展。
public enum MarginForm
{
- /// 现金保证金:计息余额 = 现金余额。
+ /// 现金保证金:余额 = 现金余额。
Cash,
- /// 授信保证:计息余额 = 已用授信额度。
+ /// 授信保证:余额 = 已用授信额度。
Credit,
- /// 担保品:计息余额 = 担保品市值。
+ /// 担保品:余额 = 担保品市值。
Guarantee,
}
///
-/// 按保证金形态解析计息余额。三种形态可互换地产出一个 MarginBalance(满足 LSP),
-/// 这是保证金领域唯一合理的多态点(差异仅在"余额如何取得"),不同于错误地套用利息腿接口。
-/// 当前为铺设骨架,具体余额来源(资金流水 / 授信占用 / 担保估值)后续按形态填充。
+/// 按保证金形态解析余额。三种形态可互换地产出一个 MarginBalance(满足 LSP),
+/// 这是保证金领域唯一合理的多态点(差异仅在"余额如何取得")。
+/// 具体余额来源(资金流水 / 授信占用 / 担保估值)后续按形态填充。
///
public interface IMarginResolver
{
MarginForm Form { get; }
- MarginBalance Resolve(decimal postedAmount, decimal accrualFactor = 1m);
+ MarginBalance Resolve(decimal postedAmount);
}
diff --git a/YLErpDAL/Modules/SwapModule/Margin/MarginAccount.cs b/YLErpDAL/Modules/SwapModule/Margin/MarginAccount.cs
new file mode 100644
index 00000000..504bead1
--- /dev/null
+++ b/YLErpDAL/Modules/SwapModule/Margin/MarginAccount.cs
@@ -0,0 +1,26 @@
+namespace YLErp.Modules.SwapModule.Margin;
+
+///
+/// 保证金账户。管理保证金余额的变动(追加/释放/返还),不涉及利息计算——
+/// 利息由 SwapInterest 纯函数按 余额×利率×天数/年化 计算,保证金账户只提供余额。
+///
+/// 保证金是独立的资金管理概念(初始保证金/维持保证金/保证金余额/追保),
+/// 与融资腿(funding leg)完全无关。现有代码把保证金塞进 InterestMode==5/6
+/// 当计息腿处理是错误的,本类是正确建模的起点。
+///
+public sealed class MarginAccount
+{
+ /// 当前保证金余额。
+ public MarginBalance Balance { get; private set; }
+
+ public MarginAccount(MarginBalance openingBalance)
+ => Balance = openingBalance;
+
+ /// 追加保证金(余额增加)。
+ public void Deposit(decimal amount)
+ => Balance = new MarginBalance(Balance.Balance + amount);
+
+ /// 释放/返还保证金(余额减少,不低于 0)。
+ public void Withdraw(decimal amount)
+ => Balance = new MarginBalance(Math.Max(0m, Balance.Balance - amount));
+}
diff --git a/YLErpDAL/Modules/SwapModule/Margin/MarginBalance.cs b/YLErpDAL/Modules/SwapModule/Margin/MarginBalance.cs
index 46791c6f..491de03c 100644
--- a/YLErpDAL/Modules/SwapModule/Margin/MarginBalance.cs
+++ b/YLErpDAL/Modules/SwapModule/Margin/MarginBalance.cs
@@ -1,12 +1,14 @@
namespace YLErp.Modules.SwapModule.Margin;
///
-/// 保证金计息余额。兼容现金、授信、担保等多种保证金形态,不承载 swap 平仓语义。
-/// 仅表达"本期计息的余额"这一计息基数,与利息腿的 NotionalResult(平仓/持仓本金拆分)无关。
+/// 保证金余额。现金、授信、担保等多种保证金形态的统一表达。
+///
+/// 保证金就是保证金——有余额、有利率、有利息,不存在"计息基数/Notional"概念。
+/// 余额随追加/释放/盈亏变动,利息由 SwapInterest 纯函数按 余额×利率×天数/年化 计算。
///
public readonly struct MarginBalance
{
- /// 计息余额:现金余额 / 授信占用 / 担保品市值。
+ /// 保证金余额:现金余额 / 授信占用 / 担保品市值。
public decimal Balance { get; }
public MarginBalance(decimal balance)
diff --git a/YLErpDAL/Modules/SwapModule/Margin/MarginLeg.cs b/YLErpDAL/Modules/SwapModule/Margin/MarginLeg.cs
deleted file mode 100644
index d9b43fbd..00000000
--- a/YLErpDAL/Modules/SwapModule/Margin/MarginLeg.cs
+++ /dev/null
@@ -1,22 +0,0 @@
-namespace YLErp.Modules.SwapModule.Margin;
-
-///
-/// 保证金(预付金)利息计提。独立限界上下文,不继承也不关联任何利息腿
-/// (IInterestLegStrategy / FixedNotionalLeg 等)——保证金是客户存款/担保,并非互换腿,
-/// 套用利息腿抽象是此前的类别错误(category error)。
-///
-/// 本类只负责把"保证金余额"这一计息基数正确建模与计算。方向翻转、orginPv 维度纠正、
-/// 持仓对齐等预付金独有逻辑不在本类(原散落在 SwapDealService / SwapEodPositionService),
-/// 后续按各自独立方法迁移,保持本类最小、可单测。
-///
-public sealed class MarginLeg
-{
- ///
- /// 计算计息余额。
- ///
- /// 保证金余额(现金余额 / 授信占用 / 担保品市值)。
- /// 本期计息适用比例,默认 1(不缩放)。仅部分释放等场景小于 1。
- /// 计息基数,不含利率与日计数。
- public MarginBalance CalcBalance(decimal marginBalance, decimal accrualFactor = 1m)
- => new(marginBalance * accrualFactor);
-}