Merge remote-tracking branch 'origin/glms/feature/1.4.2' into glms/feature/1.4.2

YLErpDAL/Modules/SwapModule/SwapDealService.cs

@@ -352,7 +352,13 @@ namespace YLErp.Modules.SwapModule
                     floatEvent.EventReason = "交易";
                     // 方案C：分红收益改由上一收盘日 EOD PosiDividendSum 提供（单一可信源），
                     // 前端 getDivindIn 不再覆盖；消除"期初持仓×totalInterest"对已平仓部分的重复计入。
-                    floatEvent.DividendIn = GetPreEodDividendSum(tradeId, position.PositionId, dealDate);
+                    // 同一 EOD 值取一次喂两栏：
+                    //   DividendIn     = "浮动端平仓盈亏·分红"（本次动作要落袋的，落库后被前端按需展示）
+                    //   DividendPending = "待结算分红收益"（仍挂在账上、未来才结的存量 = PosiDividendSum 全量口径，
+                    //                    见 GetPreEodDividendSum 注释的口径论证；切勿改回硬0或分摊，会落库回归）
+                    decimal preEodDividendSum = GetPreEodDividendSum(tradeId, position.PositionId, dealDate);
+                    floatEvent.DividendIn = preEodDividendSum;
+                    floatEvent.DividendPending = preEodDividendSum;
                     floatEvent.UnderlyingCode = position.UnderlyingCode;
                     floatEvent.UnderlyingInstrumentType = position.UnderlyingInstrumentType;
                     floatEvent.CloseFee = 0;
@@ -962,7 +968,7 @@ namespace YLErp.Modules.SwapModule
 
         /// <summary>
         /// 读取"上一收盘日"浮动腿的待实现分红（eod_swap_position.PosiDividendSum），
-        /// 用于平仓/互换预览页展示"浮动端平仓盈亏·分红(DividendIn)"。
+        /// 用于平仓/互换预览页展示"浮动端平仓盈亏·分红(DividendIn)" 与 "待结算分红收益(DividendPending)"。
         /// <para>方案C：替代前端 totalInterest × 期初持仓 的重算——后者会把登记日前已平仓、
         /// 不享有该笔分红的部分重复计入（GLMS-20260105-0004 误显 -36,160）。
         /// EOD 的 PosiDividendSum 已按"实际持仓递推 + 当日实现扣除"算出待实现分红，
@@ -973,10 +979,22 @@ namespace YLErp.Modules.SwapModule
         /// <para>抽为 protected virtual：与 GetMaxIncomeValueDate 一致，便于测试替身覆写、
         /// 也兼容无 EOD 的边界（返回 0，与历史 DividendIn=0 行为一致）。</para>
         /// </summary>
-        /// <param name="tradeId">互换交易ID</param>
-        /// <param name="positionId">浮动腿持仓ID（swap_position.PositionId）</param>
-        /// <param name="dealDate">预览/平仓业务日期</param>
         /// <returns>上一收盘日该浮动腿的待实现分红；无 EOD 记录返回 0</returns>
+        /// <remarks>
+        /// 【口径论证·勿改】为什么 DividendPending 也用本方法的全量值（非分摊、非硬0）：
+        /// <para>1. 字段语义直接对应：EOD PosiDividendSum 的 DisplayName="浮动端平仓盈亏·分红未实现"
+        ///   (EodSwapPosition.cs:186)，递推式 PosiDividendSum=前日+当日新计-当日实现
+        ///   (SwapEodPositionService.cs:1825)，即"扣过当日实现后、还挂在账上未来才结的存量"。
+        ///   前端列"待结算分红收益"(SwapflowList.js:561) 字面就是同一回事 → 直接取 PosiDividendSum。</para>
+        /// <para>2. 是"存量"非"流量"：DividendPending 描述的是"账上还欠多少"（与本次平仓比例无关的总额），
+        ///   而 DividendIn 才是"本次动作落袋多少"。两者口径本就不同，各自正确。若把 DividendPending 改成
+        ///   按本次平仓比例分摊，会把"存量"误当"流量"，与列名"待结算"矛盾。</para>
+        /// <para>3. 历史教训：方案C 初版曾把前端 DividendPending 硬编码 0（commit e3c473ba），因测试交易
+        ///   PosiDividendSum 恰好=0（3/2 已全额互换）而测试通过、掩盖问题。但对 PosiDividendSum≠0 的部分
+        ///   平仓交易，硬0 会落库（SwapFlowEventService.cs:588 冲账取负写入 swap_flow_event.DividendPending）
+        ///   并在事件列表"待结算分红收益"列显示错误的 0 —— 这是确定的回归。故本方法返回值同时喂两栏，
+        ///   前端不得再覆盖。例外：互换页 DividendPending 保持 0（互换语义=全量结清，结清后待结算归0）。</para>
+        /// </remarks>
         protected virtual decimal GetPreEodDividendSum(int tradeId, long positionId, DateTime dealDate)
         {
             var lastEod = DbContext.eod_swap