|
|
@@ -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 "";
|
|
|
+ }
|
|
|
+ }
|
|
|
+}
|