ソースを参照

Merge remote-tracking branch 'origin/cfclub' into task/S-cfc-379

Agnes Agent 3 日 前
親
コミット
7cf8fed4a8

+ 10 - 0
cfc-backend/src/main/java/com/etotem/cfc/service/FamilyMemberService.java

@@ -534,6 +534,11 @@ vo.setIsSelf(viewerMember != null && viewerMember.getId().equals(fm.getId()));
             if ("child".equals(user.getRole()) && "parent".equals(effectiveRole)) {
                 throw new AccessDeniedException("家庭成员账号不能切换到本人视角");
             }
+            // SC-P-73 仅本家庭孩子可选:目标必须处于孩子上下文(child),
+            // 本家庭成年成员/长辈(effectiveRole=parent)不得被当作孩子上下文选中
+            if (!"child".equals(effectiveRole)) {
+                throw new IllegalArgumentException("仅本家庭孩子可作为切换目标");
+            }
 
             SwitchMemberVO vo = new SwitchMemberVO();
             vo.setMemberId(member.getId());
@@ -1456,6 +1461,11 @@ vo.setIsSelf(viewerMember != null && viewerMember.getId().equals(fm.getId()));
         if (member.getGeneration() != null) {
             return member.getGeneration() >= 0 ? "parent" : "child";
         }
+        // 无 birthday 无 generation:不可登录成员(userId=null,家庭代管的"孩子")默认归为孩子上下文,
+        // 保证 SC-P-73「选孩子 → 任务/报告/方案按孩子上下文隔离」;可登录成员无基础数据按 parent 兜底
+        if (member.getUserId() == null) {
+            return "child";
+        }
         return "parent";
     }
 

+ 345 - 0
cfc-backend/src/test/java/com/etotem/cfc/unit/OrderReceiptTimeoutContractTest.java

@@ -0,0 +1,345 @@
+package com.etotem.cfc.unit;
+
+import com.etotem.cfc.entity.ProductOrder;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import org.springframework.scheduling.annotation.Scheduled;
+import org.springframework.stereotype.Component;
+import org.springframework.transaction.annotation.Transactional;
+
+import java.io.InputStream;
+import java.lang.reflect.Field;
+import java.lang.reflect.Method;
+import java.lang.reflect.Modifier;
+import java.nio.charset.StandardCharsets;
+import java.util.Scanner;
+
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.junit.jupiter.api.Assertions.fail;
+
+/**
+ * 契约级单测:商品订单待收货超时自动确认/完成(能力键 {@code shop.order.receiptTimeout})。
+ *
+ * <p>契约来源(PRD §3 P0-B + 架构设计 §2.2/§2.4/§3.3/§6 T03):
+ * <blockquote>
+ *   P0-B 待收货超时自动确认/完成(依赖 G4):新增定时任务(仿 {@code OrderTimeoutCancelTask} 模式,
+ *   {@code task/OrderReceiptTimeoutTask.java})扫描 {@code pending_receipt} 且距发货时间超过设定阈值
+ *   的订单,自动转 {@code completed},写入操作日志/系统通知用户;阈值走可配置而非硬编码。
+ *   验收:① 发货后超过阈值未确认的订单被自动置 {@code completed},并产生可追溯记录;
+ *   ② 阈值可在管理端/配置表调整;任务重复执行不重复完成(幂等)。
+ * </blockquote></p>
+ *
+ * <p><b>设计契约锚点</b>(架构设计 §6 类图 + §3.3):
+ * <ul>
+ *   <li>{@code OrderReceiptTimeoutTask} 类:{@code @Component} + {@code @Scheduled(fixedRate=60000)} +
+ *       {@code DatabaseInitializer.isMigrationsComplete()} 守卫 + {@code @Transactional}。</li>
+ *   <li>类图方法签名:{@code processTimeoutOrders()}(公共入口,对应 {@code OrderTimeoutCancelTask.cancelTimeoutOrders()})、
+ *       {@code autoComplete()}(自动完成)、{@code sendRemind()}(第9天提醒)、
+ *       {@code resolveShipTimeBase(ProductOrder)}(COALESCE(shipped_at, updated_at) 基准时间兜底)。</li>
+ *   <li>自动完成逻辑:{@code status=pending_receipt AND COALESCE(shipped_at, updated_at) < now - receipt-timeout-days}
+ *       → {@code status=completed}、{@code confirmTime=now}、{@code updatedAt=now}、
+ *       写 {@code user_operation_logs}(type=product_order_auto_complete);幂等(completed 不再被扫中)。</li>
+ *   <li>第9天提醒:{@code status=pending_receipt AND shipped_at IS NOT NULL AND shipped_at < now - receipt-remind-days
+ *       AND receipt_remind_at IS NULL} → {@code WechatService.sendTemplateMessage(buyerOpenid, templateId, ...)} 推送,
+ *       成功后写 {@code receipt_remind_at=now}(失败仅日志,不重试风暴,下一轮再试)。</li>
+ *   <li>总开关:{@code receipt-auto-complete-enabled=false} 时仅提醒不自动完成(灰度开关)。</li>
+ *   <li>数据契约:{@code product_orders} 加 {@code shipped_at}(发货时间,ship() 成功落库时写)、
+ *       {@code receipt_remind_at}(提醒推送时间,幂等防重复);{@code application.yml} 4 个配置键
+ *       {@code receipt-timeout-days / receipt-remind-days / receipt-auto-complete-enabled / receipt-remind-template-id}。</li>
+ * </ul></p>
+ *
+ * <p><b>实现现状</b>:本分支 src/main 中 {@code task/OrderReceiptTimeoutTask.java} 类<b>未落地</b>
+ * (task 目录全量 grep 无 {@code OrderReceiptTimeoutTask} 引用);{@code ProductOrderService.ship()} 也
+ * 未写 {@code shippedAt}(无 setShippedAt 调用)。因此本测试以「反射结构契约 + 数据契约」探测实现缺失:
+ * 能编译通过、能运行、断言失败(红),且失败断言原文清晰可贴。</p>
+ *
+ * <p><b>GREEN 升级指引</b>:实现者创建 {@code task/OrderReceiptTimeoutTask.java}(含上述方法签名与注解、
+ * 自动完成 + 第9天提醒 + COALESCE 基准 + 总开关逻辑),并让 {@code ProductOrderService.ship()} 成功落库时写
+ * {@code shipped_at=now} 后,本测试自动转绿;届时可将结构探测升级为行为级 mock 验证
+ * ({@code verify(orderMapper).updateById(...)} 断言 completed / 断言 sendTemplateMessage 调用与 receipt_remind_at 写入)。</p>
+ *
+ * <p><b>权限流说明</b>:本能力为后端内部定时任务(无用户请求上下文),无用户权限维度,
+ * 「权限(适用时)」三流中的权限流不适用,以说明性用例标注。</p>
+ */
+class OrderReceiptTimeoutContractTest {
+
+    /** 契约要求的待收货超时任务类(架构设计 §3.3 / §6 T03) */
+    private static final String RECEIPT_TIMEOUT_TASK =
+            "com.etotem.cfc.task.OrderReceiptTimeoutTask";
+
+    /** 契约要求的自动完成触发状态(PRD §3 P0-B) */
+    private static final String STATUS_PENDING_RECEIPT = "pending_receipt";
+
+    /** 自动完成可追溯日志类型(架构设计 §3.3) */
+    private static final String AUTO_COMPLETE_LOG_TYPE = "product_order_auto_complete";
+
+    // ------------------------------------------------------------------
+    // 正常流:OrderReceiptTimeoutTask 类应存在并注册为 Spring 组件
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("正常流-1:OrderReceiptTimeoutTask 类应存在")
+    void receiptTimeoutTask_classExists() {
+        assertNotNull(loadClass(RECEIPT_TIMEOUT_TASK),
+                "[shop.order.receiptTimeout] OrderReceiptTimeoutTask 类不存在:"
+                        + "契约要求新增定时任务扫描 pending_receipt 且超时未确认的订单自动转 completed(PRD §3 P0-B)。"
+                        + "实现未落地。");
+    }
+
+    @Test
+    @DisplayName("正常流-2:OrderReceiptTimeoutTask 应注册为 @Component(Spring 单机任务)")
+    void receiptTimeoutTask_isSpringComponent() {
+        Class<?> clazz = loadClass(RECEIPT_TIMEOUT_TASK);
+        if (clazz == null) {
+            fail("[shop.order.receiptTimeout] OrderReceiptTimeoutTask 类不存在,无法验证 @Component(架构设计 §3.3)。");
+        }
+        boolean hasComponent = false;
+        for (java.lang.annotation.Annotation a : clazz.getAnnotations()) {
+            if (a.annotationType().equals(Component.class)) {
+                hasComponent = true;
+                break;
+            }
+        }
+        assertTrue(hasComponent,
+                "[shop.order.receiptTimeout] OrderReceiptTimeoutTask 应标注 @Component"
+                        + "(复用 Spring @Scheduled 单机任务框架,架构设计 §3.3)。");
+    }
+
+    // ------------------------------------------------------------------
+    // 正常流:公共入口 processTimeoutOrders(@Scheduled + @Transactional + 迁移守卫)
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("正常流-3:应提供 processTimeoutOrders 公共入口(@Scheduled fixedRate=60000)")
+    void receiptTimeoutTask_hasScheduledEntry() {
+        Class<?> clazz = loadClass(RECEIPT_TIMEOUT_TASK);
+        if (clazz == null) {
+            fail("[shop.order.receiptTimeout] OrderReceiptTimeoutTask 类不存在,无法验证 processTimeoutOrders 入口(架构设计 §6 类图)。");
+        }
+        Method entry = findDeclaredMethod(clazz, "processTimeoutOrders");
+        if (entry == null) {
+            fail("[shop.order.receiptTimeout] OrderReceiptTimeoutTask 应提供 processTimeoutOrders() 公共入口"
+                    + "(对应 OrderTimeoutCancelTask.cancelTimeoutOrders,架构设计 §6 类图)。");
+        }
+        if (!Modifier.isPublic(entry.getModifiers())) {
+            fail("[shop.order.receiptTimeout] processTimeoutOrders() 应为 public(定时任务框架调用入口)。");
+        }
+        boolean hasScheduled = false;
+        for (java.lang.annotation.Annotation a : entry.getAnnotations()) {
+            if (a.annotationType().equals(Scheduled.class)) {
+                hasScheduled = true;
+                break;
+            }
+        }
+        assertTrue(hasScheduled,
+                "[shop.order.receiptTimeout] processTimeoutOrders() 应标注 @Scheduled(fixedRate=60000)"
+                        + "(每分钟扫描,架构设计 §3.3)。");
+    }
+
+    @Test
+    @DisplayName("正常流-4:processTimeoutOrders 应标注 @Transactional(批量置态原子性)")
+    void receiptTimeoutTask_entryIsTransactional() {
+        Class<?> clazz = loadClass(RECEIPT_TIMEOUT_TASK);
+        if (clazz == null) {
+            fail("[shop.order.receiptTimeout] OrderReceiptTimeoutTask 类不存在,无法验证 @Transactional(架构设计 §3.3)。");
+        }
+        Method entry = findDeclaredMethod(clazz, "processTimeoutOrders");
+        if (entry == null) {
+            fail("[shop.order.receiptTimeout] processTimeoutOrders() 入口缺失,无法验证 @Transactional(架构设计 §6 类图)。");
+        }
+        boolean hasTx = false;
+        for (java.lang.annotation.Annotation a : entry.getAnnotations()) {
+            if (a.annotationType().equals(Transactional.class)) {
+                hasTx = true;
+                break;
+            }
+        }
+        assertTrue(hasTx,
+                "[shop.order.receiptTimeout] processTimeoutOrders() 应标注 @Transactional"
+                        + "(仿 OrderTimeoutCancelTask,批量置 completed 需原子性,架构设计 §3.3)。");
+    }
+
+    // ------------------------------------------------------------------
+    // 正常流:设计契约方法签名(类图)
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("正常流-5:应含 autoComplete / sendRemind / resolveShipTimeBase 方法(架构设计 §6 类图)")
+    void receiptTimeoutTask_hasDesignMethods() {
+        Class<?> clazz = loadClass(RECEIPT_TIMEOUT_TASK);
+        if (clazz == null) {
+            fail("[shop.order.receiptTimeout] OrderReceiptTimeoutTask 类不存在,无法验证类图方法签名(架构设计 §6)。");
+        }
+        assertNotNull(findDeclaredMethod(clazz, "autoComplete"),
+                "[shop.order.receiptTimeout] OrderReceiptTimeoutTask 应含 autoComplete():"
+                        + "扫描 pending_receipt 且超阈值订单自动置 completed(架构设计 §3.3/§6 类图)。");
+        assertNotNull(findDeclaredMethod(clazz, "sendRemind"),
+                "[shop.order.receiptTimeout] OrderReceiptTimeoutTask 应含 sendRemind():"
+                        + "第9天对 shipped_at 非空且 receipt_remind_at 为空的订单推送订阅消息(架构设计 §3.3/§6 类图)。");
+        assertNotNull(findDeclaredMethod(clazz, "resolveShipTimeBase", ProductOrder.class),
+                "[shop.order.receiptTimeout] OrderReceiptTimeoutTask 应含 resolveShipTimeBase(ProductOrder):"
+                        + "以 COALESCE(shipped_at, updated_at) 作为发货时间基准兜底(架构设计 §2.2/§6 类图)。");
+    }
+
+    // ------------------------------------------------------------------
+    // 边界流:自动完成可追溯日志(PRD 验收①)
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("边界流-1:自动完成应产生可追溯记录(user_operation_logs type=product_order_auto_complete)")
+    void receiptTimeoutTask_autoCompleteWritesTraceableLog() {
+        // 结构探测:任务类必须存在(日志写入位于自动完成分支)。
+        // 行为级(mock orderMapper / operationLogMapper 断言写库)在 GREEN 阶段升级。
+        Class<?> clazz = loadClass(RECEIPT_TIMEOUT_TASK);
+        assertNotNull(clazz,
+                "[shop.order.receiptTimeout] OrderReceiptTimeoutTask 类不存在,"
+                        + "无法验证自动完成可追溯日志(PRD §3 P0-B 验收①)。");
+        Method autoComplete = findDeclaredMethod(clazz, "autoComplete");
+        assertNotNull(autoComplete,
+                "[shop.order.receiptTimeout] autoComplete() 缺失:自动完成应写 user_operation_logs"
+                        + "(type=" + AUTO_COMPLETE_LOG_TYPE + ",含 orderNo/原因)并置 confirmTime=now(架构设计 §3.3)。");
+    }
+
+    // ------------------------------------------------------------------
+    // 边界流:幂等(PRD 验收② —— 重复执行不重复完成)
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("边界流-2:自动完成应幂等(completed 不再被扫中,重复执行不重复完成)")
+    void receiptTimeoutTask_autoCompleteIsIdempotent() {
+        Class<?> clazz = loadClass(RECEIPT_TIMEOUT_TASK);
+        assertNotNull(clazz,
+                "[shop.order.receiptTimeout] OrderReceiptTimeoutTask 类不存在,"
+                        + "无法验证幂等性(PRD §3 P0-B 验收②)。");
+        // 幂等实现载体:自动完成扫描条件仅命中 pending_receipt(completed 被排除)。
+        // 结构探测确认任务类具备 pending_receipt 触发状态语义 —— 通过 autoComplete 方法存在 + 类含订单 mapper 引用间接验证。
+        assertNotNull(findDeclaredMethod(clazz, "autoComplete"),
+                "[shop.order.receiptTimeout] autoComplete() 缺失:"
+                        + "幂等要求扫描条件仅命中 status=pending_receipt(" + STATUS_PENDING_RECEIPT
+                        + "),completed 订单不再被扫中(架构设计 §3.3 状态幂等)。");
+    }
+
+    // ------------------------------------------------------------------
+    // 边界流:第9天提醒幂等 + 总开关(架构设计 §3.3 / §2.4)
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("边界流-3:第9天提醒应幂等(receipt_remind_at 非空不再推送,失败仅日志下一轮再试)")
+    void receiptTimeoutTask_remindIsIdempotent() {
+        Class<?> clazz = loadClass(RECEIPT_TIMEOUT_TASK);
+        assertNotNull(clazz,
+                "[shop.order.receiptTimeout] OrderReceiptTimeoutTask 类不存在,"
+                        + "无法验证第9天提醒幂等(架构设计 §3.3)。");
+        Method sendRemind = findDeclaredMethod(clazz, "sendRemind");
+        assertNotNull(sendRemind,
+                "[shop.order.receiptTimeout] sendRemind() 缺失:"
+                        + "第9天提醒应仅对 shipped_at IS NOT NULL 且 receipt_remind_at IS NULL 的订单推送,"
+                        + "成功后写 receipt_remind_at=now(幂等防重复推送,架构设计 §3.3/§2.2)。");
+    }
+
+    @Test
+    @DisplayName("边界流-4:总开关应支持灰度(receipt-auto-complete-enabled=false 仅提醒不自动完成)")
+    void receiptTimeoutTask_supportsMasterSwitch() {
+        // 总开关数据契约:application.yml 必须含 receipt-auto-complete-enabled 配置键。
+        String yml = readResource("application.yml");
+        assertTrue(yml.contains("receipt-auto-complete-enabled"),
+                "[shop.order.receiptTimeout] application.yml 缺少 receipt-auto-complete-enabled:"
+                        + "总开关(灰度/回滚用),false 时仅提醒不自动完成(架构设计 §2.4)。");
+    }
+
+    // ------------------------------------------------------------------
+    // 数据契约:配置键 / 实体字段 / schema 列(架构设计 §2.2/§2.4)
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("数据契约-1:application.yml 应含 4 个超时/提醒配置键(§2.4)")
+    void applicationYml_hasReceiptTimeoutConfigKeys() {
+        String yml = readResource("application.yml");
+        assertTrue(yml.contains("receipt-timeout-days"),
+                "[shop.order.receiptTimeout] application.yml 缺少 receipt-timeout-days(默认10天,§2.4)。");
+        assertTrue(yml.contains("receipt-remind-days"),
+                "[shop.order.receiptTimeout] application.yml 缺少 receipt-remind-days(默认第9天提醒,§2.4)。");
+        assertTrue(yml.contains("receipt-remind-template-id"),
+                "[shop.order.receiptTimeout] application.yml 缺少 receipt-remind-template-id(模板ID,空=跳过推送 fail-open,§2.4)。");
+    }
+
+    @Test
+    @DisplayName("数据契约-2:ProductOrder 实体应含 shippedAt / receiptRemindAt 字段(§2.2)")
+    void productOrder_hasShippedAndRemindFields() {
+        Class<?> entity = loadClass("com.etotem.cfc.entity.ProductOrder");
+        assertNotNull(entity,
+                "[shop.order.receiptTimeout] ProductOrder 实体不存在(数据底座 §2.2)。");
+        assertTrue(hasField(entity, "shippedAt"),
+                "[shop.order.receiptTimeout] ProductOrder 应含 shippedAt 字段:"
+                        + "发货时间(超时自动完成/收货提醒的基准时间,§2.2)。");
+        assertTrue(hasField(entity, "receiptRemindAt"),
+                "[shop.order.receiptTimeout] ProductOrder 应含 receiptRemindAt 字段:"
+                        + "收货提醒推送时间(第9天推送成功后写,幂等防重复,§2.2)。");
+    }
+
+    @Test
+    @DisplayName("数据契约-3:schema.sql 应含 shipped_at / receipt_remind_at 列(§2.2 迁移465)")
+    void schemaSql_hasShippedAndRemindColumns() {
+        String schema = readResource("schema.sql");
+        assertTrue(schema.contains("shipped_at"),
+                "[shop.order.receiptTimeout] schema.sql 缺少 product_orders.shipped_at 列(§2.2 迁移465)。");
+        assertTrue(schema.contains("receipt_remind_at"),
+                "[shop.order.receiptTimeout] schema.sql 缺少 product_orders.receipt_remind_at 列(§2.2 迁移465)。");
+    }
+
+    // ------------------------------------------------------------------
+    // 权限流(不适用):后端内部定时任务,无用户权限维度
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("权限流:本能力为后端内部定时任务,无用户权限维度,权限流不适用")
+    void permissionFlow_notApplicable() {
+        // 说明性用例:契约 AC 为「定时任务扫描 pending_receipt → 自动 completed + 提醒」内部链路,
+        // 无用户请求上下文与权限校验维度。不产生断言失败;仅为三流覆盖标注「不适用」。
+        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 Method findDeclaredMethod(Class<?> clazz, String name, Class<?>... paramTypes) {
+        try {
+            return clazz.getDeclaredMethod(name, paramTypes);
+        } catch (NoSuchMethodException e) {
+            return null;
+        }
+    }
+
+    private boolean hasField(Class<?> clazz, String fieldName) {
+        for (Field f : clazz.getDeclaredFields()) {
+            if (f.getName().equals(fieldName)) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    private String readResource(String resource) {
+        try (InputStream is = getClass().getClassLoader().getResourceAsStream(resource)) {
+            if (is == null) {
+                return "";
+            }
+            try (Scanner scanner = new Scanner(is, StandardCharsets.UTF_8.name())) {
+                scanner.useDelimiter("\\A");
+                return scanner.hasNext() ? scanner.next() : "";
+            }
+        } catch (Exception e) {
+            return "";
+        }
+    }
+}

+ 180 - 0
docs/tdd/orchestration/report-dev-2026-11-15-1558.md

@@ -0,0 +1,180 @@
+# 研发负责人工作汇报
+
+> **说明**:研发负责人逐轮工作汇报(无人值守收割轮)。数据来源:`--status` / `--inspect` / `--clean-check` / `--changes` / `--resume` / `--auto` / `git origin/cfclub`。
+
+---
+
+## 基本信息
+
+| 项目 | 内容 |
+|------|------|
+| 汇报人 | 研发负责人(无人值守收割轮 · 编排侧) |
+| 汇报周期 | 2026年11月15日(第 184 轮,15:39 档) |
+| 负责模块/单元范围 | 全量(CFC · cfclub 主线;S1–S11 通用收割骨架) |
+
+---
+
+## 一、本轮工作数据汇总
+
+### 1.0 场景覆盖矩阵(硬职责增列)
+
+> **用途**:能力键 DONE ≠ 场景(SC)跑通。「跑通」三判据:① 三类流(RED/YELLOW/GREEN)执行证据齐备;② 实现与用例已 push `origin/cfclub`;③ 该场景提交级 clean-check 干净。**单一计数源**:`docs/tdd/orchestration/sc-key-map.md`(241 个 SC);实时口径以测试侧 R212 三层归集为准(`docs/tdd/test/scenario-coverage-R212.md`)。本矩阵双口径并陈(沿用 183 轮口径)。
+
+| 指标 | 值(冻结列口径) | 值(R212 三层归集口径) | 说明 |
+|------|------|------|------|
+| 场景总数 | `241` | 241(目录)/ 247(ledger 基线) | `sc-key-map.md` 主表 241 行为唯一计数源 |
+| 累计已跑通 | `15`(冻结) | 机器归集下界 **≈9/247** | 15 为冻结手工值;R212 ledger L3 机器归集 pass=9(SC-A-01/06、SC-C-09、SC-G-01~05、SC-S-02),executed=47/247、unknown 150(G14) |
+| 本轮新增跑通 | `0` | 0 | 无 SC 转正(转正须测试侧三类流证据 + mark-green,dev 不代越) |
+| 失败 | `0` | 0 | 无已实现但未过 clean-check/部署验证的场景 |
+| 阻塞 | `0` | 0 | `--blockers` 无已登记阻塞 |
+| 未跟踪 | `226`(冻结口径差值) | **150/247 unknown**(G14) | 冻结口径 = 241−15;实时口径以 R212 ledger 为准 |
+
+> **铁律**:能力键状态 DONE ≠ 场景已跑通;严禁用「任务已分派」冒充「场景已跑通」。G14(SC↔TC 链接补全 + 执行台账联动刷新)属测试侧治本项(R212 §4),研发侧不代越。
+
+---
+
+### 1.1 问题接收与处置
+
+| 指标 | 数量 | 填写说明 |
+|------|------|----------|
+| **收到的测试反馈问题数*** | `0` 个 | 本轮无新登记阻塞(blockers.md 无新增行) |
+| **已解决问题数*** | `0` 个 | 本轮无研发侧闭环登记 |
+| **待解决研发问题数** | `0` 个 | 无 |
+
+---
+
+### 1.2 任务分发与会话管理
+
+| 指标 | 数量 | 填写说明 |
+|------|------|----------|
+| **分派任务数*** | `10` 个 | S7 `--auto --role 研发负责人 --limit 2`:**成功 10 / 失败 0 / 超限跳过 23**(5 节点各派 2 达节点上限,S-cfc-393~404 留待下轮);无 backfill 前置(本轮盘点时账本已含 183 轮 backfill 成果);S5 心跳 enabled=false 跳过、S6 填充按提示词 CFC 未启用跳过(注:config fill_capacity.enabled=true 与提示词口径不一致,延续 183 轮风险标注) |
+| **恢复智能体会话数*** | `0` 个 | `--resume --dry-run` 0 候选(prod-etotem 生产实例默认跳过;其余节点无 interrupted/mid-work) |
+| **当前在用会话数** | `1` 个 | busy:mes-local-45278=1;其余节点 0(lan-189 空 4/4、lan-204 空 10/10、local-lan-4090 空 6/6、pub-iwintrue 空 6/6) |
+| **会话平均利用率** | `低` | 总配额占用 1/32;S7 派发 10 条已填满各节点本轮 limit |
+
+### 1.2b 各会话当前工作状态列表
+
+| 会话标签 | 会话 ID | 当前状态 | 当前任务 | 静默/空闲时长 | 工作目录 | 备注 |
+|----------|---------|----------|----------|---------------|----------|------|
+| `lan-189` | — | idle | — | — | 不干净 | 空 4/上限 4(本轮已派 2) |
+| `lan-204` | — | idle | — | — | 不干净 | 空 10/上限 10(本轮已派 2) |
+| `local-lan-4090` | — | idle | — | — | 不干净 | 空 6/上限 6(本轮已派 2) |
+| `mes-local-45278` | — | running | 在途 | — | 不干净 | busy=1(配额占用 1/上限 6,剩余 5;本轮已派 2) |
+| `pub-iwintrue` | — | idle | — | — | 不干净 | 空 6/上限 6(本轮已派 2) |
+| `prod-etotem` | — | 跳过 | — | — | — | 生产实例,默认跳过(`--allow-prod` 才恢复) |
+
+> **主工作树状态**:`--clean-check` 未通过(1102 处未提交,`M .gitignore` + `.tdd/_r189_*` 删除态等,他人 WIP 迹象,只报不动;O-3 判据③零交集,不阻塞本 SC 级收口)。
+
+---
+
+### 1.3 变更感知与新任务建立
+
+| 指标 | 数量 | 填写说明 |
+|------|------|----------|
+| **感知需求/设计变更数*** | `0` 个 | `--changes --days 7`:检出变更文档,**无新增能力键**(三类均 0→0,变化集中在既有键,`--status` 复核即可) |
+| **新增入池任务数*** | `0` 个 | 池非空(pending 31)+ 无新增能力键 → 无需 `--add-task`;S8 判定:不为此轮虚构溯源(O-7/O-25 防假红) |
+| **既有键状态流转数** | `0` 次 | 状态机 RED31/YELLOW171/GREEN9/DONE15 与盘点时点持平(本轮无 mark-* 手工登记) |
+
+---
+
+### 1.4 本轮 git 提交与推送证据(真理证据)
+
+| 提交 sha | 关联任务/能力键 | 阶段 | 触及文件类型 | 目标分支 | 已推送远端 | 备注 |
+|----------|-----------------|------|--------------|----------|------------|------|
+| 727dc95d0 | auto bump | — | chore | cfclub | 是 | 主线最新 tip(fetch 后核验,`git merge-base --is-ancestor` 通过) |
+| af23389aa | R218 自动化闭环报告 | — | 文档 | cfclub | 是 | 后端 503 类/4393 例实跑 89.96%(剔契约红 99.54%)+ 浏览器 33 过 2 跳 + lg@251 40/43 + 新增 P0 Bean 撞名/P1 支付开关(测试侧产出,本轮仅核验) |
+| 51851831a | R218 覆盖台账刷新 | — | 文档 | cfclub | 是 | discover 373 控制器/2026 handler/覆盖 557;inventory 5943 例 |
+| 2c66c9302 | S-cfc-302 growth.leaderboard.view | RED | test | cfclub | 是 | 修正 RED 契约测试异常流断言 |
+| 6b38cc4e2 | S-cfc-372 assessment.result.view | 实现 | main | cfclub | 是 | 使红单测全部转绿(量纲/八类中文标签/越界拒显/全量拦截) |
+| 4dbf17808 | 上轮汇报(R183) | — | 文档 | cfclub | 是 | docs(tdd) 第183轮闭环汇报 1401 |
+
+> 本轮自身无阶段推进证据提交(纯调度 + 汇报轮);上表为主线 13:49~15:36 窗口他会话产出(窗口约 11 笔提交,抽样核验均在远端)。
+
+---
+
+### 1.5 状态机阶段分布与部署状态
+
+| 阶段 | 键数 | 备注 |
+|------|------|------|
+| UNTRACKED | `0` | 已发现未入池(目标池 ⏳ 键 0) |
+| RED | `31` | 待开发实现(于 183 轮持平) |
+| YELLOW | `171` | 待测试校验(于 183 轮持平) |
+| GREEN | `9` | 待部署验证(持平) |
+| DONE | `15` | 闭环归档(持平) |
+
+| 部署项 | 值 | 说明 |
+|--------|-----|------|
+| 本轮部署次数 | `0` 次 | 本轮无 `--deploy` 动作 |
+| deploy_state | confirmed 77 / pending 63 | O-24 延续,部署回执收口待部署会话产出 |
+| GREEN 部署链验证 | 部分通过 | pending 63 未收口(O-24) |
+
+**任务账本(`.workbuddy/tasks.json`,411 条)**:盘点到 = dispatched 32 / done 324 / failed 24 / pending 31;S7 派发 10、requeue 2(无 git 证据 done 回池,T8 机制)后 = **dispatched 42 / done 322 / failed 24 / pending 23**。
+
+---
+
+### 1.6 数据源健康度
+
+| 数据源 | 读取键数 | 是否正常 | 备注 |
+|--------|----------|----------|------|
+| 需求侧(⏳ wish) | `0` | 正常 | CFC 用例驱动口径:未实现键 0,目标池空(稳态) |
+| 契约常量(contract) | `0` | 正常 | 实现侧契约已全落地,无待契约化键 |
+| 测试用例引用(test_case_map) | `0` | 正常 | 未实现键∩用例引用 = 0 |
+| 执行结果回填(case_results) | `0` | 正常 | 无新增 FAIL 回填 |
+
+> 四类全 0 是 CFC 已知稳态(TDD 池空);场景层事实源以 `sc-key-map.md`(241)+ R212 三层归集为准。
+
+---
+
+## 二、下一步需要研发处理的事项
+
+| 序号 | 事项描述 | 依赖/前置条件 | 预估完成时间 | 优先级 | 状态 |
+|------|----------|---------------|--------------|--------|------|
+| 1 | S7 派发 10 条 RED 产出回收 + backfill 后证据再核(在途 42 执行证据:red_sha/yellow_sha 认领) | 在途会话产出 + push origin/cfclub | 2026-11-15 下一错峰档 | P1 | 待启动 |
+| 2 | pending 23 续派(S-cfc-393~404 等,S8 优先级链) | 节点配额释放 | 2026-11-15 当日 | P1 | 待启动 |
+| 3 | deploy pending 63 回执收口(O-24) | 部署会话回执 | 2026-11-15 当日 | P1 | 待启动 |
+| 4 | 池空稳态延续(0 `--add-task`,O-7/O-25 防假红) | 无实际工作溯源 | 持续 | P2 | 进行中 |
+| 5 | 场景口径双轨对齐(冻结 15/241 vs R212 三层归集 9/247) | 测试侧 G14 修复链路 | 2026-11-15 观察 | P2 | 待观察 |
+
+---
+
+## 三、阻塞与风险
+
+| 阻塞项 | 影响范围 | 阻塞类型 | 处置进展 | 需要协调 |
+|--------|----------|----------|----------|----------|
+| 主工作树不干净 1102 处(`M .gitignore` + `.tdd/_r189_*` 等) | 派发前 clean-check 门禁提示 | 其他 | 只报不动(他人 WIP 迹象,O-3 判据③零交集) | 主理人确认归属(他人 WIP 则不动) |
+| 场景口径冻结 15/241 与真实执行证据脱节 | 场景覆盖可视性 | 测试 | R212 ledger 已落地(L3 机器归集 pass=9/247、executed=47/247、G14 unknown 150);研发侧不代越 | 测试侧按 R212 §4 治本(补 SC↔TC 链接 + 台账联动刷新) |
+| 部署 pending 63 历史挂账(O-24) | GREEN→DONE 收口 | 研发 | 长期延续,需部署会话回执 | 主理人关注部署链路健康度 |
+| config `fill_capacity.enabled=true` 与提示词口径「CFC S6 未启用」不一致 | S6 执行判定歧义 | 流程 | 本轮按提示词跳过并注明;提示词(廖总裁定口径)优先于 config | 主理人统一口径(config 或提示词二选一) |
+
+---
+
+## 四、下轮工作规划
+
+| 计划项 | 预计完成时间 | 前置依赖 | 涉及会话标签 | 备注 |
+|--------|--------------|----------|--------------|------|
+| 在途 42 证据回收(先 backfill) + 23 pending 续派 | 2026-11-15 下一错峰档 | 会话产出/配额释放 | 全节点 | 每 10 分钟一档天然推进器 |
+| webhook 18:00 整档发送 | 2026-11-15 18:00 | — | — | 14:00 档已由 183 轮发;下一发送点 18:00 |
+| deploy pending 63 收口 | 2026-11-15 当日 | 部署会话回执 | testing | O-24 延续 |
+
+---
+
+## 附录
+
+### 附录 A:收到的测试反馈问题明细
+
+| 问题 ID | 能力键/任务号 | 问题类型 | 来源 | 接收时间 | 处置状态 | 关联 sha |
+|---------|---------------|----------|------|----------|----------|----------|
+| — | — | — | — | — | — | — |
+
+### 附录 B:任务分派与会话恢复明细
+
+| 任务号 | 目标会话标签 | 任务类型 | 分派时间 | 当前状态 | 恢复会话标签 | 恢复原因 | 恢复时间 |
+|--------|--------------|----------|----------|----------|--------------|----------|----------|
+| S7 派发 10 条(5 节点各 2 上限) | lan-189/lan-204/local-lan-4090/mes-local-45278/pub-iwintrue | RED | 2026-11-15 15:5x | dispatched | — | — | — |
+| S-cfc-393~404(23 条) | — | — | — | 留待下轮 | — | 节点本轮 limit 用尽 | — |
+
+### 附录 C:新增入池任务明细
+
+| 任务号 | 能力键 | 需求溯源 | 设计溯源 | 创建时间 | 状态 |
+|--------|--------|----------|----------|----------|------|
+| — | — | — | — | — | 0 新增(S8 无合法溯源,O-7/O-25 防假红) |