Browse Source

test(contract): S-cfc-306 energy.dailyLimit.guard TDD-RED 契约单测

SC-P-90 五维每日获取上限 DailyLimit(业务域 C-2),与 energy.ruleEngine.apply (S-cfc-304) 同链:
ruleEngine 写入前经 daily limit 守卫校验。

RED(实测 Tests run: 10, Failures: 5,均含 RED[energy.dailyLimit.guard]):
- EnergyService 缺 public 每日上限守卫入口(isDailyLimitExceeded 为 private)
- EnergyRuleEngine 缺 daily-limit 守卫钩子
- EnergyService 未注入 DimensionDailyLimitMapper(仍用硬编码 DAILY_LIMIT_MAP)
- awardEnergyByCode(challenge 来源)绕过日上限(多来源共享缺口)
- 缺 dailyLimit=0/负安全(配置驱动未落地,按 0 处理不发)

GREEN 锚点(如实记录,非 RED):硬编码单维度上限生效、手动 grant 计入口径、
次日重置(服务端今日 00:00-23:59:59.999 窗口)、跨时区以服务端日期为准、权限流不适用。

未改 src/main 实现;如实测全绿需交编排侧登记,此处保持 RED 供 GREEN 阶段落地实现。
zxyj-langgraph 1 day ago
parent
commit
fb39ca07a1

+ 74 - 2
cfc-backend/src/test/java/com/etotem/cfc/unit/EnergyDailyLimitGuardContractTest.java

@@ -23,10 +23,12 @@ import java.lang.reflect.Field;
 import java.lang.reflect.Method;
 import java.lang.reflect.Method;
 import java.lang.reflect.Modifier;
 import java.lang.reflect.Modifier;
 import java.util.Arrays;
 import java.util.Arrays;
+import java.util.Calendar;
 import java.util.Collections;
 import java.util.Collections;
 import java.util.Date;
 import java.util.Date;
 import java.util.Map;
 import java.util.Map;
 
 
+import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertThrows;
 import static org.junit.jupiter.api.Assertions.assertThrows;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 import static org.junit.jupiter.api.Assertions.fail;
 import static org.junit.jupiter.api.Assertions.fail;
@@ -70,15 +72,25 @@ import static org.mockito.Mockito.when;
  * <ul>
  * <ul>
  *   <li>硬编码单维度上限({@code body=50})当日累计触顶后 {@code grantEnergy} 再发 → 抛
  *   <li>硬编码单维度上限({@code body=50})当日累计触顶后 {@code grantEnergy} 再发 → 抛
  *       {@link IllegalStateException}(超限拦截已生效);</li>
  *       {@link IllegalStateException}(超限拦截已生效);</li>
- *   <li>手动 grant 口径 = 计入日上限({@code grantEnergy} 调用 {@code isDailyLimitExceeded})。</li>
+ *   <li>手动 grant 口径 = 计入日上限({@code grantEnergy} 调用 {@code isDailyLimitExceeded});</li>
+ *   <li><b>次日重置(SC-P-90 主流程 3)</b>:守卫按服务端「今日 00:00:00–23:59:59.999」窗口过滤
+ *       ({@code getTodayStart/getTodayEnd} 由服务端 {@link java.util.Calendar} 计算)——窗口随
+ *       服务端日期前移,次日累计自动归零,昨日流水不计入今日;</li>
+ *   <li><b>跨时区以服务端日期为准(SC-P-90 异常/边界)</b>:守卫时间边界不接收任何客户端日期/时区
+ *       入参,唯一时间来源为服务端时钟。</li>
  * </ul>
  * </ul>
  *
  *
+ * <p><b>派发说明(重复派发登记滞后)</b>:本测试 v1 已由 commit {@code bf1c4fc8f} 合入主链
+ * (8 用例:5 RED + 2 正常流锚点 + 1 权限流标注),但编排侧 {@code sc-key-map.md} 仍登记
+ * 「未跑通」。本增补版本在隔离 worktree 补 2 个 GREEN 锚点(次日重置 / 跨时区服务端日期),
+ * 完整覆盖 SC-P-90 全部契约点;5 个 RED 缺口断言保持不变。</p>
+ *
  * <p><b>权限流(TC-P-90-P)</b>:本能力为内部服务守卫(ruleEngine→award 写入前的校验钩子),
  * <p><b>权限流(TC-P-90-P)</b>:本能力为内部服务守卫(ruleEngine→award 写入前的校验钩子),
  * 无用户权限维度;「查 F9 成员日上限累计 403 / 越权改配置 403」由
  * 无用户权限维度;「查 F9 成员日上限累计 403 / 越权改配置 403」由
  * {@link EnergyIsolationContractTest} 与 {@link EnergyConfigAdminContractTest}(admin 守卫)覆盖,
  * {@link EnergyIsolationContractTest} 与 {@link EnergyConfigAdminContractTest}(admin 守卫)覆盖,
  * 本类标注「不适用」。</p>
  * 本类标注「不适用」。</p>
  *
  *
- * <p><b>RED 预期</b>:5 条契约缺口断言失败(红)、2 条正常流锚点通过(绿)、1 条权限流标注(通过);
+ * <p><b>RED 预期</b>:5 条契约缺口断言失败(红)、4 条正常流锚点通过(绿)、1 条权限流标注(通过);
  * 失败原文含 {@code RED[energy.dailyLimit.guard] …}。GREEN 阶段按 SC-P-90 设计落地
  * 失败原文含 {@code RED[energy.dailyLimit.guard] …}。GREEN 阶段按 SC-P-90 设计落地
  * (public 守卫 + {@code DimensionDailyLimitMapper} 配置驱动 + 多来源一致 + 0/负安全)后自动转绿。</p>
  * (public 守卫 + {@code DimensionDailyLimitMapper} 配置驱动 + 多来源一致 + 0/负安全)后自动转绿。</p>
  *
  *
@@ -267,6 +279,66 @@ class EnergyDailyLimitGuardContractTest extends EnergyContractTestBase {
                 "GREEN anchor:手动 grant 计入日上限(grantEnergy 调用 isDailyLimitExceeded)。");
                 "GREEN anchor:手动 grant 计入日上限(grantEnergy 调用 isDailyLimitExceeded)。");
     }
     }
 
 
+    @Test
+    @DisplayName("GREEN anchor:次日重置 — 守卫按服务端今日窗口过滤,跨日累计自然归零")
+    void GREEN_次日重置_服务端今日窗口() throws Exception {
+        // SC-P-90 主流程 3:跨日 00:00 后累计清零可重新获取。守卫按服务端「今日 00:00:00-23:59:59.999」
+        // 窗口查询 energy_log(between createdAt),窗口随服务端日期前移 → 昨日流水不计入今日累计。
+        // 与跨时区边界共享同一依据:窗口边界由服务端 Calendar 计算,与客户端时钟/时区无关。
+        Method todayStart = EnergyService.class.getDeclaredMethod("getTodayStart");
+        todayStart.setAccessible(true);
+        Method todayEnd = EnergyService.class.getDeclaredMethod("getTodayEnd");
+        todayEnd.setAccessible(true);
+
+        Date start = (Date) todayStart.invoke(service);
+        Date end = (Date) todayEnd.invoke(service);
+        Calendar cal = Calendar.getInstance();
+
+        Calendar startCal = Calendar.getInstance();
+        startCal.setTime(start);
+        assertEquals(cal.get(Calendar.YEAR), startCal.get(Calendar.YEAR),
+                "GREEN anchor:getTodayStart 应为服务端今日 00:00:00(次年重置窗口前移)。");
+        assertEquals(cal.get(Calendar.DAY_OF_YEAR), startCal.get(Calendar.DAY_OF_YEAR),
+                "GREEN anchor:getTodayStart 应为服务端今日 00:00:00(窗口随服务端日期前移)。");
+        assertEquals(0, startCal.get(Calendar.HOUR_OF_DAY), "GREEN anchor:getTodayStart 应为 00:00:00。");
+
+        Calendar endCal = Calendar.getInstance();
+        endCal.setTime(end);
+        assertEquals(cal.get(Calendar.YEAR), endCal.get(Calendar.YEAR),
+                "GREEN anchor:getTodayEnd 应为服务端今日 23:59:59(次日重置边界)。");
+        assertEquals(cal.get(Calendar.DAY_OF_YEAR), endCal.get(Calendar.DAY_OF_YEAR),
+                "GREEN anchor:getTodayEnd 应为服务端今日 23:59:59(窗口次日归零)。");
+        assertEquals(23, endCal.get(Calendar.HOUR_OF_DAY), "GREEN anchor:getTodayEnd 应为 23:59:59。");
+        assertEquals(59, endCal.get(Calendar.MINUTE), "GREEN anchor:getTodayEnd 应为 23:59:59。");
+        assertEquals(59, endCal.get(Calendar.SECOND), "GREEN anchor:getTodayEnd 应为 23:59:59。");
+    }
+
+    @Test
+    @DisplayName("GREEN anchor:跨时区以服务端日期为准 — 守卫日期边界由服务端时钟计算")
+    void GREEN_跨时区_服务端日期为准() throws Exception {
+        // SC-P-90 异常/边界:时钟/跨时区以服务端日期为准,不因客户端时间绕过。守卫的今日窗口
+        // (getTodayStart/getTodayEnd)使用 Calendar.getInstance()(JVM 服务器时区)计算,而非
+        // 接收客户端日期参数 — 客户端篡改本地时间不影响服务端按当日窗口过滤。
+        Method todayStart = EnergyService.class.getDeclaredMethod("getTodayStart");
+        todayStart.setAccessible(true);
+        Method todayEnd = EnergyService.class.getDeclaredMethod("getTodayEnd");
+        todayEnd.setAccessible(true);
+
+        // 两窗口必须覆盖同一服务端自然日(start < end 且同一天),跨时区偏差不会产生跨日窗口
+        Date start = (Date) todayStart.invoke(service);
+        Date end = (Date) todayEnd.invoke(service);
+        assertTrue(start.before(end), "GREEN anchor:今日窗口 start 应早于 end(服务端日期区间)。");
+
+        Calendar startCal = Calendar.getInstance();
+        startCal.setTime(start);
+        Calendar endCal = Calendar.getInstance();
+        endCal.setTime(end);
+        assertEquals(startCal.get(Calendar.YEAR), endCal.get(Calendar.YEAR),
+                "GREEN anchor:跨时区边界窗口应落在同一服务端自然日(年)。");
+        assertEquals(startCal.get(Calendar.DAY_OF_YEAR), endCal.get(Calendar.DAY_OF_YEAR),
+                "GREEN anchor:跨时区边界窗口应落在同一服务端自然日(日)。");
+    }
+
     // ==================== 权限流(不适用,说明性用例) ====================
     // ==================== 权限流(不适用,说明性用例) ====================
 
 
     @Test
     @Test