refactor(margin): 删除未接线的保证金死代码预留抽象
- 删除 MarginAccount 整类、IMarginResolver 子树(MarginForm/CashMargin/CreditMargin/GuaranteeMargin)、MarginBalance 只读 struct：全仓零生产实例化，结构上无法适配 CalcMarginInterest 的盘中差分模型。 - 删除仅覆盖上述死代码的 MarginLegTest（不损失活代码覆盖率）。 - 保留被 CalcMarginInterest 实际使用的 MarginCalc/MarginModes 活代码。 - 同步修剪 ARCHITECTURE.md 树图与对账表，清理 AccrualContext.cs 过期注释。
This commit is contained in:
hjhan
@@ -52,11 +52,7 @@ SwapModule/
|
||||
│
|
||||
├── Margin/ 保证金（mode 5/6）
|
||||
│ ├── MarginModes mode 判断（含 ForLinq for EF Core）
|
||||
│ ├── MarginBalance 保证金余额（值对象）
|
||||
│ ├── MarginAccount 余额管理 + AccrueInterest 计息入口
|
||||
│ ├── MarginCalc 纯函数（PreviousBalance/FlipDirection/AccumulateSettlement）
|
||||
│ ├── IMarginResolver 保证金形态接口
|
||||
│ └── Cash/Credit/Guarantee 三种形态实现
|
||||
│ └── MarginCalc 纯函数（PreviousBalance/FlipDirection/AccumulateSettlement）
|
||||
│
|
||||
├── ReturnLegs/ 标的端
|
||||
│ ├── ReturnLegSummary 标的端汇总值
|
||||
@@ -132,7 +128,7 @@ Unknown = 0
|
||||
|---|---|---|
|
||||
| 公司行为（送股/拆股） | QtyRollforward.corpActionDeltaQty | ✅ |
|
||||
| 公司行为（登记日快照） | DividendCalc + BondPayment | 见 corp-action-refactor-proposal.md |
|
||||
| 保证金配置/规则/占用 | MarginAccount + MarginCalc | ✅ |
|
||||
| 保证金配置/规则/占用 | MarginCalc | ✅ |
|
||||
| RecordMarginCashFlow 迁入 Margin | AddClientCash 加 virtual | 待做 |
|
||||
| EOD 编排拆分 | SwapPositionCompose | 待业务需求驱动 |
|
||||
```
|
||||
|
||||
@@ -1,10 +0,0 @@
|
||||
namespace YLErp.Modules.SwapModule.Margin;
|
||||
|
||||
/// <summary>现金保证金：余额 = 现金余额。</summary>
|
||||
public sealed class CashMargin : IMarginResolver
|
||||
{
|
||||
public MarginForm Form => MarginForm.Cash;
|
||||
|
||||
public MarginBalance Resolve(decimal postedAmount)
|
||||
=> new(postedAmount);
|
||||
}
|
||||
@@ -1,10 +0,0 @@
|
||||
namespace YLErp.Modules.SwapModule.Margin;
|
||||
|
||||
/// <summary>授信保证：余额 = 已用授信额度。</summary>
|
||||
public sealed class CreditMargin : IMarginResolver
|
||||
{
|
||||
public MarginForm Form => MarginForm.Credit;
|
||||
|
||||
public MarginBalance Resolve(decimal postedAmount)
|
||||
=> new(postedAmount);
|
||||
}
|
||||
@@ -1,10 +0,0 @@
|
||||
namespace YLErp.Modules.SwapModule.Margin;
|
||||
|
||||
/// <summary>担保品：余额 = 担保品市值。</summary>
|
||||
public sealed class GuaranteeMargin : IMarginResolver
|
||||
{
|
||||
public MarginForm Form => MarginForm.Guarantee;
|
||||
|
||||
public MarginBalance Resolve(decimal postedAmount)
|
||||
=> new(postedAmount);
|
||||
}
|
||||
@@ -1,24 +0,0 @@
|
||||
namespace YLErp.Modules.SwapModule.Margin;
|
||||
|
||||
/// <summary>保证金形态：现金 / 授信 / 担保。预留扩展。</summary>
|
||||
public enum MarginForm
|
||||
{
|
||||
/// <summary>现金保证金：余额 = 现金余额。</summary>
|
||||
Cash,
|
||||
/// <summary>授信保证：余额 = 已用授信额度。</summary>
|
||||
Credit,
|
||||
/// <summary>担保品：余额 = 担保品市值。</summary>
|
||||
Guarantee,
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 按保证金形态解析余额。三种形态可互换地产出一个 MarginBalance（满足 LSP），
|
||||
/// 这是保证金领域唯一合理的多态点（差异仅在"余额如何取得"）。
|
||||
/// 具体余额来源（资金流水 / 授信占用 / 担保估值）后续按形态填充。
|
||||
/// </summary>
|
||||
public interface IMarginResolver
|
||||
{
|
||||
MarginForm Form { get; }
|
||||
|
||||
MarginBalance Resolve(decimal postedAmount);
|
||||
}
|
||||
@@ -1,42 +0,0 @@
|
||||
using YLErp.Core.Interest;
|
||||
using YLErp.Derivatives.Interest;
|
||||
|
||||
namespace YLErp.Modules.SwapModule.Margin;
|
||||
|
||||
/// <summary>
|
||||
/// 保证金账户。管理保证金余额的变动（追加/释放/返还），并提供计息入口（预留抽象，尚未接线）。
|
||||
///
|
||||
/// 保证金是独立的资金管理概念（初始保证金/维持保证金/保证金余额/追保），与融资腿(funding leg)无关。
|
||||
/// 生产保证金计息入口为 SwapDealService.CalcMarginInterest（仍以 InterestMode 5/6 标识）：
|
||||
/// EOD 用昨日终本金 preEod.TdInterestPrincipal（无差分）；盘中用 accrualBasis 差分（orginPv 经 PreviousBalance）。
|
||||
/// 本类尚未被生产代码实例化——其扁平"余额×利率×天数"模型无法表达盘中差分与多行分段，留作未来简化抽象。
|
||||
/// </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。
|
||||
/// 注意：当前未被生产代码调用——生产保证金计息入口为 SwapDealService.CalcMarginInterest
|
||||
/// （处理 EOD 昨日终本金与盘中差分；本方法的扁平余额模型不覆盖盘中差分口径）。
|
||||
/// </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);
|
||||
}
|
||||
@@ -1,16 +0,0 @@
|
||||
namespace YLErp.Modules.SwapModule.Margin;
|
||||
|
||||
/// <summary>
|
||||
/// 保证金余额。现金、授信、担保等多种保证金形态的统一表达。
|
||||
///
|
||||
/// 保证金就是保证金——有余额、有利率、有利息，不存在"计息基数/Notional"概念。
|
||||
/// 余额随追加/释放/盈亏变动，利息由计息层（SwapDealService.CalcMarginInterest）按 EOD 昨日终本金 / 盘中差分口径计算。
|
||||
/// </summary>
|
||||
public readonly struct MarginBalance
|
||||
{
|
||||
/// <summary>保证金余额：现金余额 / 授信占用 / 担保品市值。</summary>
|
||||
public decimal Balance { get; }
|
||||
|
||||
public MarginBalance(decimal balance)
|
||||
=> Balance = balance;
|
||||
}
|
||||
Reference in New Issue
Block a user