Explorar o código

test(S-be-5): add RED contract test for shop.order.receiptTimeout (OrderReceiptTimeoutTask)

Capability key: shop.order.receiptTimeout
Contract source: docs/superpowers/specs/2026-11-14-product-order-gap-prd.md §3 P0-B + arch-design §3.3/§6 T03

Added test file:
  cfc-backend/src/test/java/com/etotem/cfc/unit/OrderReceiptTimeoutTaskContractTest.java

14 contract tests covering:
  - Normal flow: OrderReceiptTimeoutTask class/method/dependency existence (7 tests, expected RED)
  - Config flow: application.yml receipt-timeout-days/receipt-remind-days/receipt-auto-complete-enabled/receipt-remind-template-id (4 tests, PASS - already in place)
  - Entity flow: ProductOrder.shippedAt/receiptRemindAt fields (2 tests, PASS - already in place)
  - Permission flow: not applicable (1 test, PASS - informational)

RED result: 7 failures / 7 passes (all failures due to OrderReceiptTimeoutTask not yet implemented)
Agnes Agent hai 3 días
pai
achega
eb900f6a86

+ 321 - 0
cfc-backend/src/test/java/com/etotem/cfc/unit/OrderReceiptTimeoutTaskContractTest.java

@@ -0,0 +1,321 @@
+package com.etotem.cfc.unit;
+
+import com.etotem.cfc.mapper.ProductOrderMapper;
+import com.etotem.cfc.mapper.UserMapper;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+
+import java.io.InputStream;
+import java.lang.reflect.Field;
+import java.lang.reflect.Method;
+
+import static org.junit.jupiter.api.Assertions.*;
+
+/**
+ * 契约级单测:能力键 {@code shop.order.receiptTimeout}(P0-B 待收货超时自动确认/完成 + 第9天提醒)。
+ *
+ * <p>契约来源:</p>
+ * <ul>
+ *   <li>PRD:{@code docs/superpowers/specs/2026-11-14-product-order-gap-prd.md} §3 P0-B(G4)</li>
+ *   <li>设计:{@code docs/superpowers/specs/2026-11-14-product-order-gap-arch-design.md} §3.3 + §6 T03</li>
+ * </ul>
+ *
+ * <p><b>契约行为(AC)</b></p>
+ * <ol>
+ *   <li>发货后超过 {@code shop.order.receipt-timeout-days}(默认 10 天)未确认收货的订单
+ *       由 {@code OrderReceiptTimeoutTask} 自动置 {@code completed},并写 {@code user_operation_logs} 留痕;</li>
+ *   <li>发货后第 {@code shop.order.receipt-remind-days}(默认 9 天)通过微信订阅消息提醒买家,
+ *       提醒推送成功后写 {@code receipt_remind_at}(幂等,不重复推送);</li>
+ *   <li>阈值 / 提醒天数 / 开关 / 模板 ID 全部走 {@code application.yml} 配置,不硬编码;</li>
+ *   <li>任务重复执行幂等({@code completed} 订单不再被扫中,提醒有 {@code receipt_remind_at} 标记)。</li>
+ * </ol>
+ *
+ * <p><b>实现现状(RED 阶段)</b>:{@code task/OrderReceiptTimeoutTask.java} 尚未落地(全库 0 引用)。
+ * 本测试以「反射结构契约」探测实现缺失:测试可编译运行({@code Class.forName} 在运行时探测,不依赖编译期引用),
+ * 但断言失败(红)。GREEN 阶段实现者按设计 §3.3 创建 {@code OrderReceiptTimeoutTask}
+ * (含 {@code processTimeoutOrders} 入口 + {@code autoComplete} + {@code sendRemind} 方法,
+ * 注入 {@code ProductOrderMapper}、{@code UserMapper}、{@code WechatService}),
+ * 本测试自动转绿。</p>
+ *
+ * <p>测试风格:纯 Mockito/反射,无 Spring 上下文、无 DB、无外部服务。
+ * 与同批 {@code TeamProfitHookContractTest} / {@code TeamProfitPipelineContractTest} 风格一致。</p>
+ */
+class OrderReceiptTimeoutTaskContractTest {
+
+    /** 契约要求的定时任务类(设计 §3.3 T03) */
+    private static final String TASK_CLASS = "com.etotem.cfc.task.OrderReceiptTimeoutTask";
+
+    /** application.yml 中的 YAML 叶键(嵌套结构:shop: order: receipt-timeout-days: 10) */
+    private static final String CONFIG_TIMEOUT_DAYS = "receipt-timeout-days";
+    private static final String CONFIG_REMIND_DAYS  = "receipt-remind-days";
+    private static final String CONFIG_ENABLED      = "receipt-auto-complete-enabled";
+    private static final String CONFIG_TEMPLATE_ID  = "receipt-remind-template-id";
+
+    /** 配置默认值(Q3 拍板口径) */
+    private static final int DEFAULT_TIMEOUT_DAYS = 10;
+    private static final int DEFAULT_REMIND_DAYS  = 9;
+
+    // ------------------------------------------------------------------
+    // 正常流:OrderReceiptTimeoutTask 类应存在
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("正常流-1:OrderReceiptTimeoutTask 类应存在(设计 §3.3 T03)")
+    void orderReceiptTimeoutTask_classExists() {
+        Class<?> clazz = loadClass(TASK_CLASS);
+        assertNotNull(clazz,
+                "[shop.order.receiptTimeout] OrderReceiptTimeoutTask 类不存在:"
+                        + "设计 §3.3 要求新建 task/OrderReceiptTimeoutTask.java,仿 OrderTimeoutCancelTask 模式,"
+                        + "每分钟扫描 pending_receipt 且超时订单,自动 completed 并留痕。实现未落地。");
+    }
+
+    @Test
+    @DisplayName("正常流-2:OrderReceiptTimeoutTask 应提供 processTimeoutOrders 入口(设计 §3.3)")
+    void orderReceiptTimeoutTask_hasProcessMethod() {
+        Class<?> clazz = loadClass(TASK_CLASS);
+        if (clazz == null) {
+            fail("[shop.order.receiptTimeout] OrderReceiptTimeoutTask 类不存在,无法验证 processTimeoutOrders 入口。");
+        }
+        boolean hasProcess = false;
+        for (Method m : clazz.getDeclaredMethods()) {
+            if (m.getName().equals("processTimeoutOrders") || m.getName().equals("cancelTimeoutOrders")
+                    || m.getName().equals("autoComplete") || m.getName().equals("run")) {
+                hasProcess = true;
+                break;
+            }
+        }
+        assertTrue(hasProcess,
+                "[shop.order.receiptTimeout] OrderReceiptTimeoutTask 应提供 @Scheduled 定时入口方法"
+                        + "(设计 §3.3:@Scheduled(fixedRate=60000) + processTimeoutOrders/autoComplete)。");
+    }
+
+    @Test
+    @DisplayName("正常流-3:OrderReceiptTimeoutTask 应注入 ProductOrderMapper(扫描/更新订单)")
+    void orderReceiptTimeoutTask_injectsProductOrderMapper() {
+        Class<?> clazz = loadClass(TASK_CLASS);
+        if (clazz == null) {
+            fail("[shop.order.receiptTimeout] OrderReceiptTimeoutTask 类不存在,无法验证 ProductOrderMapper 注入。");
+        }
+        boolean hasMapper = false;
+        for (Field f : clazz.getDeclaredFields()) {
+            if (ProductOrderMapper.class.getName().equals(f.getType().getName())
+                    || "com.etotem.cfc.mapper.ProductOrderMapper".equals(f.getType().getName())) {
+                hasMapper = true;
+                break;
+            }
+        }
+        assertTrue(hasMapper,
+                "[shop.order.receiptTimeout] OrderReceiptTimeoutTask 应注入 ProductOrderMapper"
+                        + "(设计 §3.3:扫描 status=pending_receipt 且 COALESCE(shipped_at,updated_at)<now-10d 的订单,"
+                        + " 自动置 completed)。实现未落地。");
+    }
+
+    @Test
+    @DisplayName("正常流-4:OrderReceiptTimeoutTask 应注入 UserMapper(查买家 openid,用于订阅消息)")
+    void orderReceiptTimeoutTask_injectsUserMapper() {
+        Class<?> clazz = loadClass(TASK_CLASS);
+        if (clazz == null) {
+            fail("[shop.order.receiptTimeout] OrderReceiptTimeoutTask 类不存在,无法验证 UserMapper 注入。");
+        }
+        boolean hasUserMapper = false;
+        for (Field f : clazz.getDeclaredFields()) {
+            if ("com.etotem.cfc.mapper.UserMapper".equals(f.getType().getName())) {
+                hasUserMapper = true;
+                break;
+            }
+        }
+        assertTrue(hasUserMapper,
+                "[shop.order.receiptTimeout] OrderReceiptTimeoutTask 应注入 UserMapper"
+                        + "(设计 §3.3:第9天提醒需查买家 openid 才能推送 WechatService.sendTemplateMessage)。实现未落地。");
+    }
+
+    @Test
+    @DisplayName("正常流-5:OrderReceiptTimeoutTask 应注入 WechatService(第9天订阅消息推送)")
+    void orderReceiptTimeoutTask_injectsWechatService() {
+        Class<?> clazz = loadClass(TASK_CLASS);
+        if (clazz == null) {
+            fail("[shop.order.receiptTimeout] OrderReceiptTimeoutTask 类不存在,无法验证 WechatService 注入。");
+        }
+        boolean hasWechat = false;
+        for (Field f : clazz.getDeclaredFields()) {
+            if ("com.etotem.cfc.service.WechatService".equals(f.getType().getName())
+                    || "com.etotem.cfc.service.api.WechatServiceInterface".equals(f.getType().getName())) {
+                hasWechat = true;
+                break;
+            }
+        }
+        assertTrue(hasWechat,
+                "[shop.order.receiptTimeout] OrderReceiptTimeoutTask 应注入 WechatService"
+                        + "(设计 §3.3:第9天经 WechatService.sendTemplateMessage 推送收货提醒,成功后写 receipt_remind_at)。实现未落地。");
+    }
+
+    // ------------------------------------------------------------------
+    // 正常流:ProductOrder 实体应含 shippedAt / receiptRemindAt 字段
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("正常流-6:ProductOrder 实体应含 shippedAt 字段(超时基准时间,设计 §2.2 迁移465)")
+    void productOrder_entityHasShippedAt() {
+        Class<?> orderClass = loadClass("com.etotem.cfc.entity.ProductOrder");
+        assertNotNull(orderClass, "[shop.order.receiptTimeout] ProductOrder 实体不存在。");
+        boolean hasShippedAt = false;
+        for (Field f : orderClass.getDeclaredFields()) {
+            if (f.getName().equals("shippedAt")) {
+                hasShippedAt = true;
+                break;
+            }
+        }
+        assertTrue(hasShippedAt,
+                "[shop.order.receiptTimeout] ProductOrder 实体应含 shippedAt 字段"
+                        + "(设计 §2.2 迁移465:shipped_at DATETIME,发货时间,超时任务的基准时间)。");
+    }
+
+    @Test
+    @DisplayName("正常流-7:ProductOrder 实体应含 receiptRemindAt 字段(提醒幂等标记,设计 §2.2 迁移465)")
+    void productOrder_entityHasReceiptRemindAt() {
+        Class<?> orderClass = loadClass("com.etotem.cfc.entity.ProductOrder");
+        assertNotNull(orderClass, "[shop.order.receiptTimeout] ProductOrder 实体不存在。");
+        boolean hasRemindAt = false;
+        for (Field f : orderClass.getDeclaredFields()) {
+            if (f.getName().equals("receiptRemindAt")) {
+                hasRemindAt = true;
+                break;
+            }
+        }
+        assertTrue(hasRemindAt,
+                "[shop.order.receiptTimeout] ProductOrder 实体应含 receiptRemindAt 字段"
+                        + "(设计 §2.2 迁移465:receipt_remind_at DATETIME,收货提醒推送时间,幂等防重复推送)。");
+    }
+
+    // ------------------------------------------------------------------
+    // 配置流:application.yml 应含 4 个 P0-B 配置键(设计 §2.4)
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("配置流-1:application.yml 应含 shop.order.receipt-timeout-days(超时自动完成天数)")
+    void applicationYml_containsReceiptTimeoutDays() {
+        String yml = readResource("application.yml");
+        assertTrue(yml.contains(CONFIG_TIMEOUT_DAYS),
+                "[shop.order.receiptTimeout] application.yml 缺少 YAML 键 " + CONFIG_TIMEOUT_DAYS
+                        + "(设计 §2.4:shop.order.receipt-timeout-days,Q3 默认 10 天)。配置未落地。");
+    }
+
+    @Test
+    @DisplayName("配置流-2:application.yml 应含 shop.order.receipt-remind-days(第N天提醒)")
+    void applicationYml_containsReceiptRemindDays() {
+        String yml = readResource("application.yml");
+        assertTrue(yml.contains(CONFIG_REMIND_DAYS),
+                "[shop.order.receiptTimeout] application.yml 缺少 YAML 键 " + CONFIG_REMIND_DAYS
+                        + "(设计 §2.4:shop.order.receipt-remind-days,Q3 默认 9 天)。配置未落地。");
+    }
+
+    @Test
+    @DisplayName("配置流-3:application.yml 应含 shop.order.receipt-auto-complete-enabled(总开关,灰度用)")
+    void applicationYml_containsAutoCompleteEnabled() {
+        String yml = readResource("application.yml");
+        assertTrue(yml.contains(CONFIG_ENABLED),
+                "[shop.order.receiptTimeout] application.yml 缺少 YAML 键 " + CONFIG_ENABLED
+                        + "(设计 §2.4:shop.order.receipt-auto-complete-enabled,灰度/回滚用总开关)。配置未落地。");
+    }
+
+    @Test
+    @DisplayName("配置流-4:application.yml 应含 shop.order.receipt-remind-template-id(订阅消息模板ID,fail-open)")
+    void applicationYml_containsRemindTemplateId() {
+        String yml = readResource("application.yml");
+        assertTrue(yml.contains(CONFIG_TEMPLATE_ID),
+                "[shop.order.receiptTimeout] application.yml 缺少 YAML 键 " + CONFIG_TEMPLATE_ID
+                        + "(设计 §2.4 / Q7 拍板:微信订阅消息模板ID走配置项,不硬编码;空=跳过推送,fail-open)。配置未落地。");
+    }
+
+    // ------------------------------------------------------------------
+    // 幂等流:提醒推送成功后写 receipt_remind_at(防重复)
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("幂等流-1:OrderReceiptTimeoutTask 应含 sendRemind 或类似提醒方法(幂等设计 §3.3)")
+    void orderReceiptTimeoutTask_hasRemindMethod() {
+        Class<?> clazz = loadClass(TASK_CLASS);
+        if (clazz == null) {
+            fail("[shop.order.receiptTimeout] OrderReceiptTimeoutTask 类不存在,无法验证 sendRemind 方法。");
+        }
+        boolean hasRemindMethod = false;
+        for (Method m : clazz.getDeclaredMethods()) {
+            String name = m.getName();
+            if (name.contains("remind") || name.contains("Remind")
+                    || name.contains("notify") || name.contains("Notify")) {
+                hasRemindMethod = true;
+                break;
+            }
+        }
+        assertTrue(hasRemindMethod,
+                "[shop.order.receiptTimeout] OrderReceiptTimeoutTask 应含第9天订阅消息提醒方法"
+                        + "(设计 §3.3:status=pending_receipt AND shipped_at<now-9d AND receipt_remind_at IS NULL"
+                        + " → WechatService.sendTemplateMessage,成功后写 receipt_remind_at=now,幂等防重复推送)。实现未落地。");
+    }
+
+    @Test
+    @DisplayName("幂等流-2:OrderReceiptTimeoutTask 应含 autoComplete 或类似自动完成方法")
+    void orderReceiptTimeoutTask_hasAutoCompleteMethod() {
+        Class<?> clazz = loadClass(TASK_CLASS);
+        if (clazz == null) {
+            fail("[shop.order.receiptTimeout] OrderReceiptTimeoutTask 类不存在,无法验证 autoComplete 方法。");
+        }
+        boolean hasAutoComplete = false;
+        for (Method m : clazz.getDeclaredMethods()) {
+            String name = m.getName();
+            if (name.contains("complete") || name.contains("Complete")
+                    || name.contains("finish") || name.contains("confirm")) {
+                hasAutoComplete = true;
+                break;
+            }
+        }
+        assertTrue(hasAutoComplete,
+                "[shop.order.receiptTimeout] OrderReceiptTimeoutTask 应含自动完成方法"
+                        + "(设计 §3.3:status=pending_receipt AND COALESCE(shipped_at,updated_at)<now-10d"
+                        + " → status=completed + confirmTime=now + user_operation_logs 留痕,幂等可重复执行)。实现未落地。");
+    }
+
+    // ------------------------------------------------------------------
+    // 权限流(不适用):本能力为定时任务内部链路,无用户权限维度
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("权限流:本能力为后端定时任务,无用户权限维度,权限流不适用")
+    void permissionFlow_notApplicable() {
+        // 说明性用例:P0-B 为系统定时任务(自动完成 + 订阅消息提醒),无用户调用入口,
+        // 「权限流」三流中的权限校验维度不适用,以说明性断言标注。
+        assertTrue(true, "权限流不适用:shop.order.receiptTimeout 为定时任务内部链路,无用户权限维度。");
+    }
+
+    // ------------------------------------------------------------------
+    // 反射辅助
+    // ------------------------------------------------------------------
+
+    private Class<?> loadClass(String name) {
+        try {
+            return Class.forName(name, false, Thread.currentThread().getContextClassLoader());
+        } catch (ClassNotFoundException e) {
+            return null;
+        }
+    }
+
+    private String readResource(String resourceName) {
+        try {
+            InputStream is = getClass().getClassLoader().getResourceAsStream(resourceName);
+            if (is == null) {
+                return "";
+            }
+            // Read all bytes, decode as UTF-8 — robust against platform encoding issues
+            java.io.ByteArrayOutputStream baos = new java.io.ByteArrayOutputStream();
+            byte[] buf = new byte[8192];
+            int n;
+            while ((n = is.read(buf)) != -1) {
+                baos.write(buf, 0, n);
+            }
+            is.close();
+            return new String(baos.toByteArray(), "UTF-8");
+        } catch (Exception e) {
+            return "";
+        }
+    }
+}