Forráskód Böngészése

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

Agnes Agent 4 napja
szülő
commit
3c764c72a5

+ 297 - 0
cfc-backend/src/test/java/com/etotem/cfc/unit/CfRewardV2MigrateConfigContractTest.java

@@ -0,0 +1,297 @@
+package com.etotem.cfc.unit;
+
+import com.etotem.cfc.constant.CfConfigKeys;
+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 java.lang.reflect.Modifier;
+import java.nio.charset.StandardCharsets;
+import java.util.Scanner;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.junit.jupiter.api.Assertions.fail;
+
+/**
+ * 契约级单测:CF 分润模型 v2 配置与迁移(能力键 {@code cf.rewardv2.migrateConfig},TDD-RED 阶段)。
+ *
+ * <p><b>契约溯源(T01 配置与迁移,表+键+种子)</b>:</p>
+ * <ul>
+ *   <li>需求:{@code docs/superpowers/plans/2026-11-14-cf-reward-model-v2.md} §4.2/§5 待实现清单 1/4
+ *       (数据库迁移:团队池比例配置 + 配置表/字段 + 流水表)</li>
+ *   <li>设计:{@code docs/superpowers/plans/2026-11-14-cf-reward-model-v2-design.md}
+ *       §6-T01(新建 4 表 + F03c 种子 + 6 键播种)、§2.1-2.5(表结构 + 迁移方式)、
+ *       §3.3(F03c 种子)、§4(配置键)</li>
+ *   <li>任务编排键:T01 对应 {@code cf.rewardv2.config.migrate} / {@code cf.rewardv2.config.seed};
+ *       本测试以任务键 {@code cf.rewardv2.migrateConfig} 覆盖两者。</li>
+ * </ul>
+ *
+ * <p><b>被校验的契约行为(T01 范围)</b>:</p>
+ * <ul>
+ *   <li><b>迁移入口</b>:{@code DatabaseInitializer.migrateCfRewardV2TeamPool()}(§2.5)——
+ *       幂等 {@code CREATE TABLE IF NOT EXISTS} 建 4 张新表 + {@code ensureServiceConfig} 播种 6 个配置键。</li>
+ *   <li><b>4 张新表</b>(§2.1-2.4,迁移建议 462-465,实际续编以合入后为准):</li>
+ *   <li>{@code cf_team_share_config}(T% 配置,作用域 GLOBAL/SYSTEM/MINIAPP,唯一键 {@code uk_scope})</li>
+ *   <li>{@code cf_team_pool_order}(团队池整单,唯一键 {@code uk_order(order_type, order_id)} 幂等)</li>
+ *   <li>{@code cf_team_pool_share}(成员瓜分明细,唯一键 {@code uk_pool_member(pool_id, member_id)} 幂等)</li>
+ *   <li>{@code cf_platform_revenue_log}(平台抽成 R0 流水,唯一键 {@code uk_order} 幂等)</li>
+ *   <li><b>6 个配置键</b>(§4,进 {@code CfConfigKeys} + {@code seedCfServiceConfig}):</li>
+ *   <li>{@code cf.platform.take_rate_bps=1000}、{@code cf.team_pool.enabled=true}、
+ *       {@code cf.team_pool.default_t_bps=3000}、{@code cf.team_pool.on_loss=payout}、
+ *       {@code cf.team_pool.max_depth=8}、{@code cf.team_pool.non_goods_cost_rate=5000}</li>
+ *   <li><b>F03c 种子</b>(§3.3,{@code DatabaseInitializer.seedCfEarnRules} 追加):
+ *       团队分润池规则,幂等 {@code ref_type=F03c}、{@code ref_id=pool_id}。</li>
+ * </ul>
+ *
+ * <p><b>实现现状</b>:本分支 src/main 中 {@code cf_team_share_config} / {@code cf_team_pool_order} /
+ * {@code cf_team_pool_share} / {@code cf_platform_revenue_log} 四表未落地(schema.sql 无建表),
+ * {@code CfConfigKeys} 无 {@code cf.platform.take_rate_bps} / {@code cf.team_pool.*} 六个键,
+ * {@code DatabaseInitializer} 无 {@code migrateCfRewardV2TeamPool()} 方法、{@code CF_EARN_RULE_SEEDS}
+ * 无 F03c。因此本测试以「反射结构契约 + schema.sql 资源读取 + 配置兜底断言」探测实现缺失:
+ * 能编译通过、能运行、断言失败(红),且失败断言原文清晰可贴。</p>
+ *
+ * <p><b>GREEN 升级指引</b>:实现者落地 T01 后(建 4 表并同步 schema.sql、CfConfigKeys 加 6 键并同步
+ * FALLBACKS、DatabaseInitializer 加 {@code migrateCfRewardV2TeamPool()} 并在 {@code runMigrations()}
+ * 接线、{@code seedCfEarnRules} 追加 F03c 种子),本测试自动转绿。</p>
+ *
+ * <p><b>测试范围</b>:纯契约级单测,无 Spring / 无 DB / 无外部服务。权限流不适用(迁移/配置为后端
+ * 内部数据链路,无用户权限维度)。</p>
+ */
+class CfRewardV2MigrateConfigContractTest {
+
+    /** 契约宿主:迁移入口所在类(设计 §2.5)。 */
+    private static final String DATABASE_INITIALIZER = "com.etotem.cfc.config.DatabaseInitializer";
+
+    /** 契约要求新增的迁移方法名(§2.5)。 */
+    private static final String MIGRATE_METHOD = "migrateCfRewardV2TeamPool";
+
+    /** §2.1-2.4 四张新表。 */
+    private static final String[] NEW_TABLES = {
+            "cf_team_share_config", "cf_team_pool_order", "cf_team_pool_share", "cf_platform_revenue_log"
+    };
+
+    /** §2.1-2.4 + §1.5 幂等唯一键。 */
+    private static final String[] UNIQUE_KEYS = {
+            "uk_scope", "uk_order", "uk_pool_member"
+    };
+
+    /** §4 六个配置键(键名 → 兜底默认值)。 */
+    private static final String[][] CONFIG_KEYS = {
+            {"cf.platform.take_rate_bps", "1000"},
+            {"cf.team_pool.enabled", "true"},
+            {"cf.team_pool.default_t_bps", "3000"},
+            {"cf.team_pool.on_loss", "payout"},
+            {"cf.team_pool.max_depth", "8"},
+            {"cf.team_pool.non_goods_cost_rate", "5000"}
+    };
+
+    // ------------------------------------------------------------------
+    // 正常流-1:迁移入口 migrateCfRewardV2TeamPool 应存在(§2.5)
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("正常流-1:DatabaseInitializer 应提供 migrateCfRewardV2TeamPool() 迁移入口")
+    void databaseInitializer_hasMigrateCfRewardV2TeamPoolMethod() {
+        Class<?> clazz = loadClass(DATABASE_INITIALIZER);
+        if (clazz == null) {
+            fail("[cf.rewardv2.migrateConfig] DatabaseInitializer 类不存在(§2.5 迁移入口宿主)。");
+        }
+        Method method = null;
+        for (Method m : clazz.getDeclaredMethods()) {
+            if (m.getName().equals(MIGRATE_METHOD)) {
+                method = m;
+                break;
+            }
+        }
+        assertNotNull(method,
+                "[cf.rewardv2.migrateConfig] DatabaseInitializer 应提供 " + MIGRATE_METHOD + "() "
+                        + "私有方法:幂等 CREATE TABLE IF NOT EXISTS 建 4 张新表 + ensureServiceConfig "
+                        + "播种 6 个配置键(设计 §2.5 / §6-T01)。实现未落地。");
+        assertTrue(Modifier.isPrivate(method.getModifiers()),
+                "[cf.rewardv2.migrateConfig] " + MIGRATE_METHOD + "() 应为私有方法(runMigrations 内部调用)。");
+    }
+
+    // ------------------------------------------------------------------
+    // 正常流-2:schema.sql 应含 4 张新表(§2.1-2.4,项目铁律同步)
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("正常流-2:schema.sql 应含 4 张新表(cf_team_share_config/cf_team_pool_order/cf_team_pool_share/cf_platform_revenue_log)")
+    void schemaSql_containsFourNewTables() {
+        String schema = readSchemaSql();
+        for (String table : NEW_TABLES) {
+            assertTrue(schema.contains(table),
+                    "[cf.rewardv2.migrateConfig] schema.sql 缺少 " + table
+                            + " 建表(设计 §2.1-2.4 / §6-T01:新建 4 表)。实现未落地。");
+        }
+    }
+
+    // ------------------------------------------------------------------
+    // 正常流-3:幂等唯一键应落地(§1.5 / §2.1-2.4)
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("正常流-3:schema.sql 应含幂等唯一键 uk_scope/uk_order/uk_pool_member")
+    void schemaSql_containsIdempotentUniqueKeys() {
+        String schema = readSchemaSql();
+        for (String key : UNIQUE_KEYS) {
+            assertTrue(schema.contains(key),
+                    "[cf.rewardv2.migrateConfig] schema.sql 缺少唯一键 " + key
+                            + "(设计 §1.5 幂等:uk_scope 作用域唯一 / uk_order 整单幂等 / "
+                            + "uk_pool_member 成员幂等)。实现未落地。");
+        }
+    }
+
+    // ------------------------------------------------------------------
+    // 正常流-4:CfConfigKeys 应声明 6 个配置键(§4)
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("正常流-4:CfConfigKeys 应声明 6 个 v2 配置键常量")
+    void cfConfigKeys_declaresSixRewardV2Keys() {
+        for (String[] kv : CONFIG_KEYS) {
+            String key = kv[0];
+            boolean declared = false;
+            for (Field f : CfConfigKeys.class.getDeclaredFields()) {
+                if (Modifier.isStatic(f.getModifiers())
+                        && f.getType() == String.class
+                        && key.equals(staticString(f))) {
+                    declared = true;
+                    break;
+                }
+            }
+            assertTrue(declared,
+                    "[cf.rewardv2.migrateConfig] CfConfigKeys 缺少配置键常量 " + key
+                            + "(设计 §4 / §6-T01:6 键进 CfConfigKeys + seedCfServiceConfig)。实现未落地。");
+        }
+    }
+
+    // ------------------------------------------------------------------
+    // 正常流-5:6 个键的引导期兜底默认值应符合 §4
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("正常流-5:CfConfigKeys.fallbackOf 应返回 6 键的 §4 默认值")
+    void cfConfigKeys_fallbackDefaultsMatchSpec() {
+        for (String[] kv : CONFIG_KEYS) {
+            String key = kv[0];
+            String expected = kv[1];
+            assertEquals(expected, CfConfigKeys.fallbackOf(key),
+                    "[cf.rewardv2.migrateConfig] 配置键 " + key + " 的兜底默认值应为 "
+                            + expected + "(设计 §4)。实现未落地。");
+        }
+    }
+
+    // ------------------------------------------------------------------
+    // 正常流-6:cf_earn_rule 种子应含 F03c 团队分润池(§3.3)
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("正常流-6:DatabaseInitializer.CF_EARN_RULE_SEEDS 应含 F03c 团队分润池规则")
+    void cfEarnRuleSeeds_containsTeamPoolF03c() {
+        String[][] seeds = earnRuleSeeds();
+        if (seeds == null) {
+            fail("[cf.rewardv2.migrateConfig] DatabaseInitializer.CF_EARN_RULE_SEEDS 字段不存在或不可读。");
+        }
+        boolean found = false;
+        for (String[] row : seeds) {
+            if (row != null && row.length > 0 && "F03c".equals(row[0])) {
+                found = true;
+                break;
+            }
+        }
+        assertTrue(found,
+                "[cf.rewardv2.migrateConfig] cf_earn_rule 种子应含 F03c「团队分润池」规则"
+                        + "(设计 §3.3 / §6-T01:seedCfEarnRules 追加,幂等 ref_type=F03c、ref_id=pool_id)。实现未落地。");
+    }
+
+    // ------------------------------------------------------------------
+    // 边界流:4 张新表 + 6 键 + F03c 种子 —— 幂等可重复执行(迁移铁律)
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("边界流-1:迁移须幂等 —— 建表用 CREATE TABLE IF NOT EXISTS(schema.sql 体现)")
+    void schemaSql_newTablesUseIfNotExists() {
+        String schema = readSchemaSql();
+        for (String table : NEW_TABLES) {
+            int idx = schema.indexOf("CREATE TABLE IF NOT EXISTS " + table);
+            assertTrue(idx >= 0,
+                    "[cf.rewardv2.migrateConfig] " + table + " 建表应为 CREATE TABLE IF NOT EXISTS"
+                            + "(迁移铁律:幂等可重复执行,设计 §2.5)。实现未落地。");
+        }
+    }
+
+    // ------------------------------------------------------------------
+    // 权限流(不适用):迁移/配置为后端内部数据链路,无用户权限维度
+    // ------------------------------------------------------------------
+
+    @Test
+    @DisplayName("权限流:本能力为后端内部迁移/配置链路,无用户权限维度,权限流不适用")
+    void permissionFlow_notApplicable() {
+        // 说明性用例:契约 AC 为「数据库迁移 + 配置播种」内部数据链路,无权限校验维度。
+        // 不产生断言失败;仅为三流覆盖标注「不适用」。
+        assertTrue(true, "权限流不适用:cf.rewardv2.migrateConfig 为后端内部迁移/配置链路,无用户权限维度。");
+    }
+
+    // ------------------------------------------------------------------
+    // 反射辅助
+    // ------------------------------------------------------------------
+
+    private Class<?> loadClass(String name) {
+        try {
+            return Class.forName(name, false, Thread.currentThread().getContextClassLoader());
+        } catch (ClassNotFoundException e) {
+            return null;
+        }
+    }
+
+    private String staticString(Field f) {
+        try {
+            f.setAccessible(true);
+            Object v = f.get(null);
+            return v instanceof String ? (String) v : null;
+        } catch (Exception e) {
+            return null;
+        }
+    }
+
+    /** 反射读取 DatabaseInitializer.CF_EARN_RULE_SEEDS(String[][])。 */
+    private String[][] earnRuleSeeds() {
+        Class<?> clazz = loadClass(DATABASE_INITIALIZER);
+        if (clazz == null) {
+            return null;
+        }
+        for (Field f : clazz.getDeclaredFields()) {
+            if ("CF_EARN_RULE_SEEDS".equals(f.getName())) {
+                try {
+                    f.setAccessible(true);
+                    Object v = f.get(null);
+                    if (v instanceof String[][]) {
+                        return (String[][]) v;
+                    }
+                } catch (Exception e) {
+                    return null;
+                }
+            }
+        }
+        return null;
+    }
+
+    private String readSchemaSql() {
+        try (InputStream is = getClass().getClassLoader().getResourceAsStream("schema.sql")) {
+            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 "";
+        }
+    }
+}

+ 378 - 0
cfc-backend/src/test/java/com/etotem/cfc/unit/PlanTaskListContractTest.java

@@ -0,0 +1,378 @@
+package com.etotem.cfc.unit;
+
+import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
+import com.baomidou.mybatisplus.core.MybatisConfiguration;
+import com.baomidou.mybatisplus.core.metadata.TableInfoHelper;
+import com.etotem.cfc.common.Result;
+import com.etotem.cfc.controller.growth.GrowthPlanController;
+import com.etotem.cfc.entity.GrowthPlan;
+import com.etotem.cfc.entity.Task;
+import com.etotem.cfc.mapper.GrowthPlanMapper;
+import com.etotem.cfc.mapper.TaskMapper;
+import com.etotem.cfc.service.GrowthPlanService;
+import org.apache.ibatis.builder.MapperBuilderAssistant;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import org.mockito.ArgumentCaptor;
+import org.mockito.InjectMocks;
+import org.mockito.Mock;
+import org.mockito.MockitoAnnotations;
+
+import java.lang.reflect.Field;
+import java.lang.reflect.Method;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.Date;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+import static org.junit.jupiter.api.Assertions.*;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.Mockito.*;
+import static org.mockito.ArgumentMatchers.isNull;
+
+/**
+ * 契约级单测:能力键 {@code plan.task.list} (SC-P-47 查看方案下任务列表)。
+ *
+ * <p>需求溯源:tests/user-scenarios/应用场景总览.md SC-P-47(方案关联任务列表(状态/进度),
+ * 任务增删与方案同步);设计溯源:docs/superpowers/api/API_REFERENCE.md §4.3 任务。
+ * 模块:{@code GrowthPlanController} + {@code TaskController}。</p>
+ *
+ * <p>与 task.parent.createTask/task.parent.review (S-cfc-12/13) 区分:
+ * task.* 是通用任务视图(锚点 memberId:/api/tasks/history、/today-parent、/my-pending);
+ * plan.task.list 是<b>方案维度</b>的任务清单视图(锚点 planId,按 source_type='plan' AND source_id=planId 过滤)。</p>
+ *
+ * <p>参考先例(同库同形态,已落地):{@code HealthPlanController.planTasks}(POST /api/health/plan/tasks,
+ * body {planId},familyId guard,错误文案「planId不能为空」/「方案不存在」/「无权查看该方案任务」)。
+ * 本能力在<b>成长方案</b>(GrowthPlan)侧缺失同形态端点,需补齐。</p>
+ *
+ * <p><b>契约宿主</b>(TDD-RED 锚点):
+ * <ul>
+ *   <li>{@code GrowthPlanService#planTaskList(Long planId)} —— 方案维度任务清单,返回 {@code List<Task>}
+ *       (source_type='plan' AND source_id=planId,逐项携带 status,进度载体由 Task.progress/todayDone 回填)</li>
+ *   <li>{@code GrowthPlanController#planTasks(Map<String, Object> params)} —— POST /api/growth/plan/tasks,
+ *       body {planId};planId 缺失 → Result.error("planId不能为空");方案不存在 → Result.error("方案不存在");
+ *       成功 → Result.success(growthPlanService.planTaskList(planId))</li>
+ * </ul></p>
+ *
+ * <p><b>实现现状</b>(本分支 src/main 核实):{@code GrowthPlanService} 仅有 {@code getProgress(Long, Long)}
+ * 返回聚合 VO(completedTasks/totalTasks/progressPercent,无任务明细列表);
+ * {@code GrowthPlanController} 无 tasks 端点。契约方法/端点均未落地,故本测试以「反射探测宿主契约方法」
+ * 断言缺失:能编译、能运行、断言失败(红),失败断言原文清晰可贴。</p>
+ *
+ * <p><b>GREEN 升级指引</b>:实现 {@code GrowthPlanService.planTaskList(Long planId)}
+ * (LambdaQueryWrapper: eq(sourceType,"plan").eq(sourceId, planId),任务增删同步=实时查询不缓存)
+ * 与 {@code GrowthPlanController.planTasks(Map)}(委托 Service)后,本测试自动转绿。</p>
+ *
+ * <p><b>权限流说明</b>:/api/growth/plan/* 由 JwtInterceptor 统一拦截(非公开路径),端点继承登录态鉴权;
+ * 本类权限流聚焦「方案维度视图 vs 通用任务视图」的口径区分,并对现状(聚合 VO 不含明细)做观测钉住。</p>
+ *
+ * <p><b>测试范围</b>:纯 Mockito/反射,无 Spring / 无 DB / 无真实微信 / 无外部服务。</p>
+ */
+class PlanTaskListContractTest {
+
+    private static final String HOST_SERVICE = "com.etotem.cfc.service.GrowthPlanService";
+    private static final String HOST_CONTROLLER = "com.etotem.cfc.controller.growth.GrowthPlanController";
+    private static final Long PLAN_ID = 282L;
+
+    @Mock
+    private GrowthPlanMapper growthPlanMapper;
+
+    @Mock
+    private TaskMapper taskMapper;
+
+    @InjectMocks
+    private GrowthPlanService service;
+
+    @BeforeEach
+    void setUp() throws Exception {
+        MockitoAnnotations.openMocks(this);
+        inject(service, "growthPlanMapper", growthPlanMapper);
+        inject(service, "taskMapper", taskMapper);
+        // 初始化 Task 的 lambda 缓存,使 LambdaQueryWrapper.getParamNameValuePairs() 能填充参数值
+        TableInfoHelper.initTableInfo(new MapperBuilderAssistant(new MybatisConfiguration(), ""), Task.class);
+    }
+
+    // ==================== 反射辅助(锚定宿主契约,避免编译期依赖不存在的方法) ====================
+
+    private void inject(Object target, String field, Object value) throws Exception {
+        Field f = target.getClass().getDeclaredField(field);
+        f.setAccessible(true);
+        f.set(target, value);
+    }
+
+    /** 按方法名 + 参数个数匹配;契约方法缺失即断言失败(RED)。 */
+    private Object invoke(Object host, String method, Object... args) {
+        for (Method m : host.getClass().getMethods()) {
+            if (m.getName().equals(method) && m.getParameterCount() == args.length) {
+                try {
+                    m.setAccessible(true);
+                    return m.invoke(host, args);
+                } catch (Exception e) {
+                    fail("契约方法 " + host.getClass().getSimpleName() + "#" + method + " 调用失败:" + e.getMessage());
+                    return null;
+                }
+            }
+        }
+        fail("RED[plan.task.list] 契约宿主 " + HOST_SERVICE + "/" + HOST_CONTROLLER
+                + "#" + method + " 未实现(实现未落地):" + method + " 方法不存在。");
+        return null;
+    }
+
+    /** 按方法名匹配(忽略参数个数),返回匹配的第一个方法或 null。 */
+    private Method methodOf(Object host, String name) {
+        for (Method m : host.getClass().getMethods()) {
+            if (m.getName().equals(name)) {
+                return m;
+            }
+        }
+        for (Method m : host.getClass().getDeclaredMethods()) {
+            if (m.getName().equals(name)) {
+                return m;
+            }
+        }
+        return null;
+    }
+
+    @SuppressWarnings("unchecked")
+    private List<Task> invokeList(Object host, String method, Object... args) {
+        Object r = invoke(host, method, args);
+        if (r instanceof List) {
+            return (List<Task>) r;
+        }
+        fail("契约方法 " + method + " 应返回 List<Task>,实际 " + r);
+        return Collections.emptyList();
+    }
+
+    private GrowthPlan plan(Long id, String status) {
+        GrowthPlan p = new GrowthPlan();
+        p.setId(id);
+        p.setStatus(status);
+        p.setPlanTitle("契约测试方案");
+        p.setCreatedAt(new Date());
+        p.setUpdatedAt(new Date());
+        return p;
+    }
+
+    private Task planTask(Long id, String status, Long sourceId) {
+        Task t = new Task();
+        t.setId(id);
+        t.setSourceType("plan");
+        t.setSourceId(sourceId);
+        t.setStatus(status);
+        t.setTitle("方案任务-" + id);
+        return t;
+    }
+
+    private GrowthPlanController controllerWithService() throws Exception {
+        GrowthPlanController c = new GrowthPlanController();
+        inject(c, "growthPlanService", service);
+        inject(c, "userMapper", mock(com.etotem.cfc.mapper.UserMapper.class));
+        inject(c, "growthPlanMapper", growthPlanMapper);
+        return c;
+    }
+
+    private Map<String, Object> body(Object planId) {
+        Map<String, Object> m = new HashMap<>();
+        if (planId != null) {
+            m.put("planId", planId);
+        }
+        return m;
+    }
+
+    // ==================== 正常流 ====================
+
+    @Test
+    @DisplayName("正常流-1:GrowthPlanService 应提供 planTaskList(Long planId) 契约方法(方案维度任务清单)")
+    void service_planTaskList_methodExists() {
+        GrowthPlanService svc = new GrowthPlanService();
+        Method m = methodOf(svc, "planTaskList");
+        assertNotNull(m,
+                "RED[plan.task.list] GrowthPlanService 应提供 planTaskList(Long planId) 契约方法"
+                        + "(方案维度任务清单),实现未落地:当前仅有 getProgress 聚合统计,无任务明细视图。");
+        assertEquals(1, m.getParameterCount(),
+                "planTaskList 应以 planId 为唯一过滤锚点(方案维度,区别于按 memberId 的通用任务视图)。");
+        assertEquals(Long.class, m.getParameterTypes()[0], "planId 参数类型应为 Long。");
+    }
+
+    @Test
+    @DisplayName("正常流-2:planTaskList 应返回方案下任务明细列表(source_type='plan' & source_id=planId)")
+    void planTaskList_returnsPlanTaskDetailList() {
+        when(growthPlanMapper.selectById(PLAN_ID)).thenReturn(plan(PLAN_ID, "active"));
+        List<Task> seeded = new ArrayList<>();
+        seeded.add(planTask(1L, "pending", PLAN_ID));
+        seeded.add(planTask(2L, "completed", PLAN_ID));
+        when(taskMapper.selectList(any())).thenReturn(seeded);
+
+        List<Task> result = invokeList(service, "planTaskList", PLAN_ID);
+
+        assertNotNull(result, "应返回方案任务明细列表(非聚合 VO)");
+        assertEquals(2, result.size(), "应返回方案下全部任务明细");
+        assertEquals(1L, result.get(0).getId().longValue(), "明细项应保留任务 ID");
+    }
+
+    @Test
+    @DisplayName("正常流-3:planTaskList 每项应携带状态;进度载体由 Task.progress/todayDone 回填(实体契约观察)")
+    void planTaskList_eachTaskCarriesStatus() {
+        when(growthPlanMapper.selectById(PLAN_ID)).thenReturn(plan(PLAN_ID, "active"));
+        Task t1 = planTask(1L, "pending", PLAN_ID);
+        t1.setProgress(50);
+        t1.setTodayDone(1);
+        Task t2 = planTask(2L, "completed", PLAN_ID);
+        when(taskMapper.selectList(any())).thenReturn(new ArrayList<>(Arrays.asList(t1, t2)));
+
+        List<Task> result = invokeList(service, "planTaskList", PLAN_ID);
+
+        assertNotNull(result.get(0).getStatus(), "列表每项应携带 status(状态);RED[plan.task.list] 宿主未实现。");
+        assertEquals("completed", result.get(1).getStatus());
+        // 进度载体观察:Task 实体已提供 progress/todayDone 非持久化字段(@TableField(exist=false)),
+        // 方案任务清单视图可据此回填进度型任务(is_daily_progress=1)的进度。
+        boolean hasProgressCarrier = false;
+        for (java.lang.reflect.Field f : Task.class.getDeclaredFields()) {
+            if ("progress".equals(f.getName()) || "todayDone".equals(f.getName())) {
+                hasProgressCarrier = true;
+                break;
+            }
+        }
+        assertTrue(hasProgressCarrier, "Task 实体应暴露 progress/todayDone 进度载体字段(方案任务清单视图可回填)。");
+    }
+
+    @Test
+    @DisplayName("正常流-4:GrowthPlanController 应暴露 planTasks(POST /api/growth/plan/tasks)端点")
+    void controller_planTasks_methodExists() throws Exception {
+        GrowthPlanController c = controllerWithService();
+        Method m = methodOf(c, "planTasks");
+        assertNotNull(m,
+                "RED[plan.task.list] GrowthPlanController 应暴露 planTasks(POST /api/growth/plan/tasks)端点"
+                        + "(方案维度任务清单),实现未落地。参考先例:HealthPlanController.planTasks。");
+    }
+
+    @Test
+    @DisplayName("正常流-5:planTasks 端点应委托 growthPlanService 查询方案任务(端到端到 taskMapper)")
+    void controller_planTasks_delegatesToService() throws Exception {
+        GrowthPlanController c = controllerWithService();
+        // 真实注入的 service(@InjectMocks)+ growthPlanMapper/taskMapper mock:
+        // 契约兑现后 端点→service→taskMapper 全链路贯通,此处可红可绿按宿主现状断言。
+        when(growthPlanMapper.selectById(PLAN_ID)).thenReturn(plan(PLAN_ID, "active"));
+        List<Task> seeded = new ArrayList<>();
+        seeded.add(planTask(1L, "pending", PLAN_ID));
+        when(taskMapper.selectList(any())).thenReturn(seeded);
+
+        Result<List<Task>> r = (Result<List<Task>>) invoke(c, "planTasks", body(PLAN_ID));
+
+        assertEquals(200, r.getCode(), "正常流应 200");
+        assertNotNull(r.getData(), "应返回方案任务列表");
+        assertEquals(1, r.getData().size());
+        // 端到端:Controller 委托 service → service 走 taskMapper 查询(非 controller 直接操作 mapper,分层合规)
+        verify(taskMapper).selectList(any());
+    }
+
+    // ==================== 边界流 ====================
+
+    @Test
+    @DisplayName("边界流-1:planId 缺失 → 端点返回业务错误提示「planId不能为空」")
+    void controller_planTasks_planIdMissing_returnsError() throws Exception {
+        GrowthPlanController c = controllerWithService();
+
+        Result<?> r = (Result<?>) invoke(c, "planTasks", body(null));
+
+        assertEquals(500, r.getCode(), "planId 缺失应业务错误(Result.error → 500,非 200)");
+        assertEquals("planId不能为空", r.getMessage());
+    }
+
+    @Test
+    @DisplayName("边界流-2:方案不存在 → 端点返回业务错误提示「方案不存在」")
+    void controller_planTasks_planNotExists_returnsError() throws Exception {
+        GrowthPlanController c = controllerWithService();
+        when(growthPlanMapper.selectById(PLAN_ID)).thenReturn(null);
+
+        Result<?> r = (Result<?>) invoke(c, "planTasks", body(PLAN_ID));
+
+        assertEquals(500, r.getCode(), "方案不存在应业务错误(Result.error → 500,非 200)");
+        assertEquals("方案不存在", r.getMessage());
+    }
+
+    @Test
+    @DisplayName("边界流-3:任务增删与方案同步——列表实时反映最新任务集(两次调用无缓存)")
+    void planTaskList_taskAddDelete_syncsWithPlan() {
+        when(growthPlanMapper.selectById(PLAN_ID)).thenReturn(plan(PLAN_ID, "active"));
+        Task t1 = planTask(1L, "pending", PLAN_ID);
+        Task t2 = planTask(2L, "completed", PLAN_ID);
+        // 模拟任务增删同步:第一次 2 条,删除后第二次 1 条
+        when(taskMapper.selectList(any()))
+                .thenReturn(new ArrayList<>(Arrays.asList(t1, t2)))
+                .thenReturn(new ArrayList<>(Collections.singletonList(t2)));
+
+        List<Task> first = invokeList(service, "planTaskList", PLAN_ID);
+        List<Task> second = invokeList(service, "planTaskList", PLAN_ID);
+
+        assertEquals(2, first.size(), "任务增删前应返回 2 条");
+        assertEquals(1, second.size(), "任务删除后应实时反映为 1 条(无缓存,同步方案任务集)");
+        verify(taskMapper, times(2)).selectList(any());
+    }
+
+    @Test
+    @DisplayName("边界流-4:planId 为 null 安全默认(不 NPE,返回空列表)")
+    void planTaskList_planIdNull_returnsEmptySafeDefault() {
+        // 不 stub 任何 mapper(若实现误查询非 null 条件会触发未 stub 返回 null/空)
+        when(growthPlanMapper.selectById(isNull())).thenReturn(null);
+
+        List<Task> result = invokeList(service, "planTaskList", new Object[]{null});
+
+        assertNotNull(result, "planId 为 null 应返回空列表而非 null(安全默认)");
+        assertTrue(result.isEmpty(), "planId 为 null 应返回空列表(无方案锚点无明细)");
+    }
+
+    @Test
+    @DisplayName("边界流-5:方案任务清单查询应以 source_type='plan' AND source_id=planId 过滤(方案维度隔离)")
+    void planTaskList_queryScoped_planSourceTypeAndPlanId() {
+        when(growthPlanMapper.selectById(PLAN_ID)).thenReturn(plan(PLAN_ID, "active"));
+        when(taskMapper.selectList(any()))
+                .thenReturn(new ArrayList<>(Collections.singletonList(planTask(1L, "pending", PLAN_ID))));
+
+        invokeList(service, "planTaskList", PLAN_ID);
+
+        ArgumentCaptor<LambdaQueryWrapper<Task>> captor = ArgumentCaptor.forClass(LambdaQueryWrapper.class);
+        verify(taskMapper).selectList(captor.capture());
+        LambdaQueryWrapper<Task> wrapper = captor.getValue();
+        wrapper.getSqlSegment(); // 触发参数绑定到 paramNameValuePairs
+        Map<String, Object> params = wrapper.getParamNameValuePairs();
+        assertTrue(params.containsValue("plan"),
+                "查询应以 source_type='plan' 过滤(方案维度),实际参数:" + params);
+        assertTrue(params.containsValue(PLAN_ID),
+                "查询应以 source_id=planId 过滤(区别于按 memberId 的通用任务视图),实际参数:" + params);
+    }
+
+    // ==================== 权限流 ====================
+
+    @Test
+    @DisplayName("权限流-1:plan.task.list 为方案维度清单,区别于 task.* 通用视图;现有 getProgress 仅聚合(观测钉住)")
+    void permissionFlow_distinctFromGenericTaskViews() throws Exception {
+        GrowthPlanService svc = new GrowthPlanService();
+        // ① 契约口径:方案维度任务「清单」需 planTaskList 明细视图承载(按 planId 锚定)→ 主契约方法缺失(RED)
+        Method detail = methodOf(svc, "planTaskList");
+        assertNotNull(detail,
+                "RED[plan.task.list] 方案维度任务清单视图 planTaskList 未落地:应挂 GrowthPlanService"
+                        + "(按 planId 锚定),区别于按 memberId 的通用任务视图(/api/tasks/history、/today-parent、/my-pending)。");
+
+        // ② 现状观测钉住:getProgress(现有)仅返回聚合 VO(completedTasks/totalTasks/progressPercent),
+        //    不含任务明细列表字段 —— 聚合≠清单,明细需 planTaskList 独立承载,二者分工:聚合=进度卡,明细=清单视图。
+        Method agg = svc.getClass().getDeclaredMethod("getProgress", Long.class, Long.class);
+        assertEquals("GrowthPlanProgressVO", agg.getReturnType().getSimpleName(),
+                "观测钉住:现有 getProgress 返回聚合 VO,不承载任务明细(契约缺口,明细需 planTaskList 独立提供)。");
+        Class<?> voClass = Class.forName("com.etotem.cfc.dto.GrowthPlanProgressVO");
+        boolean hasListField = false;
+        for (java.lang.reflect.Field f : voClass.getDeclaredFields()) {
+            if (List.class.isAssignableFrom(f.getType())) {
+                hasListField = true;
+                break;
+            }
+        }
+        assertFalse(hasListField,
+                "观测钉住:getProgress 聚合 VO 不含 List<Task> 明细字段(聚合≠清单,契约缺口);"
+                        + "方案任务清单视图需 planTaskList 独立承载。");
+    }
+}

+ 17 - 0
cfc-frontend/__tests__/api/api.test.js

@@ -978,6 +978,23 @@ describe('articles API', () => {
     expect(lastRequest().url).toMatch(/\/api\/articles\/list$/)
   })
 
+  test('getArticleList carries keyword payload (C4 search contract)', async () => {
+    mockSuccess({ code: 200 })
+    await api.getArticleList({ page: 1, size: 10, keyword: '睡眠' })
+    const req = lastRequest()
+    expect(req.url).toMatch(/\/api\/articles\/list$/)
+    expect(req.method).toBe('POST')
+    expect(req.data.keyword).toBe('睡眠')
+    expect(req.data.page).toBe(1)
+    expect(req.data.size).toBe(10)
+  })
+
+  test('getArticleList passes keyword through raw (trim/cancel semantics live in the page)', async () => {
+    mockSuccess({ code: 200 })
+    await api.getArticleList({ page: 1, size: 10, keyword: '  ' })
+    expect(lastRequest().data.keyword).toBe('  ')
+  })
+
   test('getArticleDetail sends POST', async () => {
     mockSuccess({ code: 200 })
     await api.getArticleDetail({ id: 42 })

+ 368 - 0
cfc-frontend/__tests__/pages/article-center/articleSearch.contract.test.js

@@ -0,0 +1,368 @@
+/**
+ * 契约级单测(TDD-RED→GREEN)——能力键 content.article.search(前端部分 C4-C6)
+ *
+ * 溯源:
+ *   requirement: docs/需求分析/2026-11-14-小程序知识分享页搜索功能需求变更.md
+ *                (ARTICLE-SEARCH-2026-11-14-V1,契约 C4 触发语义 / C5 空态区分 / C6 标签互斥重置)
+ *   design:      docs/design/2026-11-14-article-center-search-design.md
+ *                (D3 前端交互完善 + D3a 输入防抖与搜索历史,交互参考 pages/shop/search/search.vue)
+ *   契约布局:___tests__/api/api.test.js(C4 请求体 keyword 透传断言)+ 本文件(页面方法/空态/互斥)
+ *
+ * 说明(既有 Jest 体系约束):
+ *   cfc-frontend 无 vue-jest/jsdom 组件环境 —— 沿用「读取真实 SFC 源码 → 桩化 import → 求值
+ *   <script> 拿真实 export default → 驱动 data()/methods/computed 做行为断言,模板做结构断言」,
+ *   参考 __tests__/pages/article-center/articleTagFilter.contract.test.js。
+ *   本文件不修改 pages/、utils/ 任何业务代码。
+ *
+ * 小程序约束(AGENTS.md):禁可选链 ?.、禁 CSS Grid、禁 :key 表达式、禁 new Date(string)。
+ */
+
+import fs from 'fs'
+import path from 'path'
+import { BrandColors } from '@/utils/brand-colors.js'
+
+const PAGE_PATH = path.join(__dirname, '../../../pages/article-center/index.vue')
+
+/** 把 ES import 语句替换为从 globalThis.__articleCenterSearchStubs 取桩的声明(不解析模块,避免污染业务实现) */
+function stubImports(script, stubMap) {
+  return script.replace(/import\s+([^;]+?)\s+from\s+['"]([^'"]+)['"];?/g, function (m, clause, id) {
+    var names = []
+    var c = clause.trim()
+    var braceIdx = c.indexOf('{')
+    if (braceIdx >= 0) {
+      var def = c.slice(0, braceIdx).replace(/,\s*$/, '').trim()
+      if (def) names.push(def)
+      var named = c.slice(braceIdx + 1, c.lastIndexOf('}'))
+      named.split(',').forEach(function (part) {
+        var p = part.trim()
+        if (!p) return
+        var parts = p.split(/\s+as\s+/)
+        var local = parts.length > 1 ? parts[1].trim() : parts[0].trim()
+        if (local) names.push(local)
+      })
+    } else if (c.indexOf('*') === 0) {
+      var nsMatch = c.match(/\*\s+as\s+(\w+)/)
+      if (nsMatch) names.push(nsMatch[1])
+    } else {
+      names.push(c)
+    }
+    return names.map(function (n) {
+      return 'var ' + n + ' = ((globalThis.__articleCenterSearchStubs || {})[' + JSON.stringify(id) + '] || {})[' + JSON.stringify(n) + '];'
+    }).join('\n')
+  })
+}
+
+/** 加载真实 SFC:返回 { component, template }(component = 真实 <script> 的 export default 对象) */
+function loadPage() {
+  var src = fs.readFileSync(PAGE_PATH, 'utf8')
+  var tmplMatch = src.match(/<template>([\s\S]*?)<\/template>/)
+  var scriptMatch = src.match(/<script>([\s\S]*?)<\/script>/)
+  if (!scriptMatch) throw new Error('无法在 article-center/index.vue 中定位 <script> 块')
+  var script = stubImports(scriptMatch[1], globalThis.__articleCenterSearchStubs || {})
+  script = script.replace(/export default\s*\{/, 'module.exports = {')
+  var mod = { exports: {} }
+  // eslint-disable-next-line no-new-func
+  var fn = new Function('module', 'exports', script)
+  fn(mod, mod.exports)
+  return { component: mod.exports, template: tmplMatch ? tmplMatch[1] : '' }
+}
+
+/** 依据真实组件的 data()/methods/computed 构造可驱动上下文(模拟 Vue 合并实例) */
+function instantiate(component) {
+  var vm = {}
+  var data = typeof component.data === 'function' ? component.data.call(vm) : (component.data || {})
+  Object.keys(data).forEach(function (k) { vm[k] = data[k] })
+  var methods = component.methods || {}
+  Object.keys(methods).forEach(function (k) { vm[k] = methods[k] })
+  var computed = component.computed || {}
+  Object.keys(computed).forEach(function (k) {
+    Object.defineProperty(vm, k, { get: computed[k], enumerable: true, configurable: true })
+  })
+  return vm
+}
+
+/** 每次调用时重新加载真实 SFC(读取当时的 __articleCenterSearchStubs),避免闭包捕获旧桩 */
+function getComponent() {
+  return loadPage().component
+}
+
+/** 刷新微任务队列:让 fire-and-forget 的 async 方法(loadArticles 等)结算完成 */
+function flushPromises() {
+  return new Promise(function (resolve) { setTimeout(resolve, 0) })
+}
+
+// ---------------------------------------------------------------------------
+// 测试夹具
+// ---------------------------------------------------------------------------
+
+var stubs
+
+beforeEach(function () {
+  global.uni._storage = {}
+  global.uni.showToast.mockReset()
+  global.uni.navigateTo.mockReset()
+  global.uni.request.mockReset()
+  stubs = {
+    getArticleList: jest.fn(function () { return Promise.resolve({ code: 200, message: 'ok', data: { records: [], total: 0 } }) }),
+    getArticleTags: jest.fn(function () { return Promise.resolve({ code: 200, message: 'ok', data: [] }) }),
+    getFeaturedArticles: jest.fn(function () { return Promise.resolve({ code: 200, message: 'ok', data: [] }) })
+  }
+  globalThis.__articleCenterSearchStubs = {
+    '../../utils/brand-colors.js': { BrandColors: BrandColors },
+    '@/utils/api.js': {
+      getArticleList: stubs.getArticleList,
+      getArticleTags: stubs.getArticleTags,
+      getFeaturedArticles: stubs.getFeaturedArticles
+    },
+    '@/config.js': { config: { API_BASE_URL: 'http://127.0.0.1:9082' } },
+    '@/mixins/font-scale.js': { fontScaleMixin: { data: function () { return {} } } }
+  }
+})
+
+afterEach(function () {
+  delete globalThis.__articleCenterSearchStubs
+})
+
+// ---------------------------------------------------------------------------
+// 契约 C4:触发语义 —— onSearch 重置分页/清列表/noMore=false,请求体携带 trim keyword;
+// 空 keyword(取消)还原全量;400ms 防抖即时搜索;搜索历史本地存储(上限 10、去重、可清空)
+// ---------------------------------------------------------------------------
+
+describe('契约C4 index.vue:onSearch 触发语义 + 防抖 + 搜索历史', function () {
+  test('onSearch 同步重置 page=1/articles=[]/noMore=false,请求体携带 trim 后的 keyword', async function () {
+    stubs.getArticleList.mockResolvedValue({ code: 200, message: 'ok', data: { records: [{ id: 1, title: '睡眠指南' }], total: 1 } })
+    var vm = instantiate(getComponent())
+    vm.currentChildId = null
+    vm.page = 5
+    vm.articles = [{ id: 999 }]
+    vm.noMore = true
+    vm.searchKeyword = '  睡眠  '
+    vm.onSearch()
+    // 提交瞬间即重置(契约 C4:page=1、列表清空、noMore=false)
+    expect(vm.page).toBe(1)
+    expect(vm.articles).toEqual([])
+    expect(vm.noMore).toBe(false)
+    await flushPromises()
+    var params = stubs.getArticleList.mock.calls[0][0]
+    expect(params.keyword).toBe('睡眠')
+    expect(vm.articles).toEqual([{ id: 1, title: '睡眠指南' }])
+  })
+
+  test('onSearch 空 keyword(取消语义)→ 还原全量,请求体不带 keyword 且历史不落盘', async function () {
+    stubs.getArticleList.mockResolvedValue({ code: 200, message: 'ok', data: { records: [{ id: 2, title: 'x' }], total: 1 } })
+    var vm = instantiate(getComponent())
+    vm.currentChildId = null
+    vm.searchKeyword = '   '
+    vm.onSearch()
+    await flushPromises()
+    var params = stubs.getArticleList.mock.calls[0][0]
+    expect(params.keyword).toBeUndefined()
+    expect(params.tag).toBeUndefined()
+    expect(vm.articles).toEqual([{ id: 2, title: 'x' }])
+    expect(global.uni._storage['article_search_history']).toBeUndefined()
+  })
+
+  test('模板:搜索框保留 v-model/@confirm 并接入 @input="onSearchInput" 防抖', function () {
+    var template = loadPage().template
+    expect(template).toMatch(/v-model="searchKeyword"/)
+    expect(template).toMatch(/@confirm="onSearch"/)
+    expect(template).toMatch(/@input="onSearchInput"/)
+  })
+
+  test('onSearchInput 400ms 防抖即时搜索:只发一次且携带当前 keyword', function () {
+    jest.useFakeTimers()
+    try {
+      stubs.getArticleList.mockResolvedValue({ code: 200, message: 'ok', data: { records: [], total: 0 } })
+      var vm = instantiate(getComponent())
+      vm.currentChildId = null
+      vm.searchKeyword = '睡眠'
+      vm.onSearchInput({ detail: { value: '睡眠' } })
+      expect(stubs.getArticleList).not.toHaveBeenCalled()
+      jest.advanceTimersByTime(399)
+      expect(stubs.getArticleList).not.toHaveBeenCalled()
+      jest.advanceTimersByTime(1)
+      expect(stubs.getArticleList).toHaveBeenCalledTimes(1)
+      expect(stubs.getArticleList.mock.calls[0][0].keyword).toBe('睡眠')
+    } finally {
+      jest.useRealTimers()
+    }
+  })
+
+  test('onSearchInput 连续输入只在防抖窗口结束后请求一次并取最新词', function () {
+    jest.useFakeTimers()
+    try {
+      var vm = instantiate(getComponent())
+      vm.currentChildId = null
+      vm.onSearchInput({ detail: { value: '睡' } })
+      vm.onSearchInput({ detail: { value: '睡眠' } })
+      vm.onSearchInput({ detail: { value: ' 睡眠法 ' } })
+      expect(stubs.getArticleList).not.toHaveBeenCalled()
+      jest.advanceTimersByTime(400)
+      expect(stubs.getArticleList).toHaveBeenCalledTimes(1)
+      expect(stubs.getArticleList.mock.calls[0][0].keyword).toBe('睡眠法')
+    } finally {
+      jest.useRealTimers()
+    }
+  })
+
+  test('onSearch 保存 trim 关键词到本地历史(article_search_history):去重、提到最前', function () {
+    var vm = instantiate(getComponent())
+    vm.searchKeyword = '睡眠'
+    vm.onSearch()
+    expect(vm.searchHistory).toEqual(['睡眠'])
+    expect(JSON.parse(global.uni._storage['article_search_history'])).toEqual(['睡眠'])
+
+    vm.searchKeyword = '成长'
+    vm.onSearch()
+    expect(vm.searchHistory).toEqual(['成长', '睡眠'])
+
+    // 去重:再次搜索相同关键词提到最前
+    vm.searchKeyword = '睡眠'
+    vm.onSearch()
+    expect(vm.searchHistory).toEqual(['睡眠', '成长'])
+    expect(vm.searchHistory.length).toBe(2)
+  })
+
+  test('搜索历史上限 10 条,超出丢弃最旧', function () {
+    var vm = instantiate(getComponent())
+    var seed = []
+    for (var i = 1; i <= 10; i++) seed.push('k' + i)
+    vm.searchHistory = seed.slice()
+    vm.searchKeyword = 'new'
+    vm.onSearch()
+    expect(vm.searchHistory.length).toBe(10)
+    expect(vm.searchHistory[0]).toBe('new')
+    expect(vm.searchHistory[9]).toBe('k9')
+    expect(vm.searchHistory.indexOf('k10')).toBe(-1)
+  })
+
+  test('onLoad 读取历史;非法 JSON 容错为空数组', async function () {
+    global.uni._storage['article_search_history'] = JSON.stringify(['睡眠', '成长'])
+    var vm = instantiate(getComponent())
+    var opts = getComponent()
+    await opts.onLoad.call(vm, {})
+    await flushPromises()
+    expect(vm.searchHistory).toEqual(['睡眠', '成长'])
+
+    global.uni._storage['article_search_history'] = '{bad json'
+    var vm2 = instantiate(getComponent())
+    await opts.onLoad.call(vm2, {})
+    expect(vm2.searchHistory).toEqual([])
+  })
+
+  test('clearSearchHistory 清空列表并删除本地存储', function () {
+    var vm = instantiate(getComponent())
+    vm.searchHistory = ['睡眠']
+    global.uni._storage['article_search_history'] = JSON.stringify(['睡眠'])
+    vm.clearSearchHistory()
+    expect(vm.searchHistory).toEqual([])
+    expect(global.uni._storage['article_search_history']).toBeUndefined()
+  })
+
+  test('模板:搜索历史条 v-for 渲染 searchHistory,点击历史项回填关键词', function () {
+    var template = loadPage().template
+    expect(template).toMatch(/v-for="\(item, idx\) in searchHistory"/)
+    expect(template).toMatch(/searchHistory.length/)
+    expect(template).toMatch(/clickSearchHistory\(item\)/)
+    expect(template).toMatch(/clearSearchHistory/)
+  })
+})
+
+// ---------------------------------------------------------------------------
+// 契约 C5:空态区分 —— noMore && articles.length === 0 时,
+// searchKeyword 非空 →「未找到相关文章」,否则 →「暂无文章」
+// ---------------------------------------------------------------------------
+
+describe('契约C5 index.vue:搜索空态与「暂无文章」区分', function () {
+  test('模板:空态门禁 noMore && articles.length === 0,文案按 isSearchEmpty 区分', function () {
+    var template = loadPage().template
+    expect(template).toMatch(/v-else-if="noMore && articles\.length === 0"/)
+    expect(template).toMatch(/未找到相关文章/)
+    expect(template).toMatch(/暂无文章/)
+    expect(template).toMatch(/isSearchEmpty/)
+  })
+
+  test('搜索无命中(records=[] total=0)→ articles=[] 且 noMore=true,isSearchEmpty=true', async function () {
+    stubs.getArticleList.mockResolvedValue({ code: 200, message: 'ok', data: { records: [], total: 0 } })
+    var vm = instantiate(getComponent())
+    vm.currentChildId = null
+    vm.searchKeyword = '睡眠'
+    vm.onSearch()
+    await flushPromises()
+    expect(vm.articles).toEqual([])
+    expect(vm.noMore).toBe(true)
+    expect(vm.isSearchEmpty).toBe(true)
+  })
+
+  test('非搜索态空列表(无 keyword)→ isSearchEmpty=false(走「暂无文章」)', async function () {
+    stubs.getArticleList.mockResolvedValue({ code: 200, message: 'ok', data: { records: [], total: 0 } })
+    var vm = instantiate(getComponent())
+    vm.currentChildId = null
+    vm.searchKeyword = ''
+    vm.onSearch()
+    await flushPromises()
+    expect(vm.articles).toEqual([])
+    expect(vm.noMore).toBe(true)
+    expect(vm.isSearchEmpty).toBe(false)
+  })
+})
+
+// ---------------------------------------------------------------------------
+// 契约 C6:互斥重置 —— 进入搜索态清当前 Tab 回全量;切换 Tab 清搜索关键词与焦点
+// ---------------------------------------------------------------------------
+
+describe('契约C6 index.vue:搜索与标签筛选互斥重置', function () {
+  test('onTabChange 清空 searchKeyword/searchFocused,请求体带 tag 且不带 keyword', async function () {
+    var vm = instantiate(getComponent())
+    vm.currentChildId = null
+    vm.searchKeyword = '睡眠'
+    vm.searchFocused = true
+    vm.onTabChange('减脂')
+    expect(vm.currentTab).toBe('减脂')
+    expect(vm.searchKeyword).toBe('')
+    expect(vm.searchFocused).toBe(false)
+    await flushPromises()
+    var params = stubs.getArticleList.mock.calls[0][0]
+    expect(params.tag).toBe('减脂')
+    expect(params.keyword).toBeUndefined()
+  })
+
+  test('focusSearch 进入搜索态:清当前 Tab 回全量并重拉全量列表(无 tag)', async function () {
+    var vm = instantiate(getComponent())
+    vm.currentChildId = null
+    vm.currentTab = '减脂'
+    vm.focusSearch()
+    expect(vm.searchFocused).toBe(true)
+    expect(vm.currentTab).toBe('')
+    expect(vm.page).toBe(1)
+    expect(vm.articles).toEqual([])
+    await flushPromises()
+    var params = stubs.getArticleList.mock.calls[0][0]
+    expect(params.tag).toBeUndefined()
+  })
+
+  test('focusSearch 已在全量时不重复重拉列表', function () {
+    var vm = instantiate(getComponent())
+    vm.currentChildId = null
+    vm.currentTab = ''
+    stubs.getArticleList.mockClear()
+    vm.focusSearch()
+    expect(vm.searchFocused).toBe(true)
+    expect(vm.currentTab).toBe('')
+    expect(stubs.getArticleList).not.toHaveBeenCalled()
+  })
+
+  test('标签态发起搜索(onSearch)→ currentTab 清空回全量,请求体无 tag 只带 keyword', async function () {
+    stubs.getArticleList.mockResolvedValue({ code: 200, message: 'ok', data: { records: [{ id: 7, title: '睡眠' }], total: 1 } })
+    var vm = instantiate(getComponent())
+    vm.currentChildId = null
+    vm.currentTab = '减脂'
+    vm.searchKeyword = '睡眠'
+    vm.onSearch()
+    expect(vm.currentTab).toBe('')
+    await flushPromises()
+    var params = stubs.getArticleList.mock.calls[0][0]
+    expect(params.keyword).toBe('睡眠')
+    expect(params.tag).toBeUndefined()
+  })
+})

+ 145 - 10
cfc-frontend/pages/article-center/index.vue

@@ -22,11 +22,28 @@
         placeholder="搜索文章..."
         confirm-type="search"
         @confirm="onSearch"
+        @input="onSearchInput"
         @blur="onSearchBlur"
       />
       <text class="ac-search-cancel" @click="searchKeyword = ''; searchFocused = false; onSearch()">取消</text>
     </view>
 
+    <!-- 搜索历史(聚焦且未输入时展示,上限 10 条可清空) -->
+    <view v-if="searchFocused && !searchKeyword && searchHistory.length" class="ac-search-history">
+      <view class="ac-history-header">
+        <text class="ac-history-title">搜索历史</text>
+        <text class="ac-history-clear" @click="clearSearchHistory">清除</text>
+      </view>
+      <view class="ac-history-tags">
+        <text
+          v-for="(item, idx) in searchHistory"
+          :key="idx"
+          class="ac-history-tag"
+          @click="clickSearchHistory(item)"
+        >{{ item }}</text>
+      </view>
+    </view>
+
     <!-- Tab 导航(药丸式) -->
     <view class="ac-tabs">
       <scroll-view scroll-x show-scrollbar="false" class="ac-tab-scroll">
@@ -67,10 +84,10 @@
         </view>
       </view>
 
-      <!-- 空状态 -->
-      <view v-else-if="articles.length === 0" class="ac-empty">
+      <!-- 空状态(搜索态无命中 → 未找到相关文章;非搜索态 → 暂无文章) -->
+      <view v-else-if="noMore && articles.length === 0" class="ac-empty">
         <image class="ac-empty-img" src="/static/empty-article.png" mode="aspectFit" lazy-load></image>
-        <text class="ac-empty-text">暂无文章</text>
+        <text class="ac-empty-text">{{ isSearchEmpty ? '未找到相关文章' : '暂无文章' }}</text>
       </view>
 
       <!-- 文章列表 -->
@@ -158,11 +175,18 @@ export default {
       noMore: false,
       searchKeyword: '',
       searchFocused: false,
+      searchHistory: [],
       isLoggedIn: false,
       recommendedArticles: [],
       recommendLoading: false
     }
   },
+  computed: {
+    // 搜索态判定:供空态文案区分「未找到相关文章 / 暂无文章」(契约 C5)
+    isSearchEmpty() {
+      return !!(this.searchKeyword && this.searchKeyword.trim())
+    }
+  },
   components: {
     ArticleBookshelf: () => require('@/pages/home-pages/components/ArticleBookshelf.vue')
   },
@@ -178,10 +202,17 @@ onLoad(options) {
     this.loadTags()
     this.loadArticles()
     this.loadRecommendedArticles()
+    this.loadSearchHistory()
 },
   onShow() {
     this.isLoggedIn = !!uni.getStorageSync('token')
   },
+  onUnload() {
+    if (this._searchTimer) {
+      clearTimeout(this._searchTimer)
+      this._searchTimer = null
+    }
+  },
   methods: {
     async loadTags() {
       try {
@@ -207,6 +238,8 @@ onLoad(options) {
         if (this.loadingMore || this.noMore) return
         this.loadingMore = true
       }
+      // 请求序号:新的搜索/刷新会使仍在途的旧响应作废,避免过期数据覆盖新结果
+      var seq = (this._seq = (this._seq || 0) + 1)
       try {
         var params = { page: this.page, size: this.size }
         if (this.currentChildId) {
@@ -219,6 +252,7 @@ onLoad(options) {
           params.keyword = this.searchKeyword.trim()
         }
         var res = await getArticleList(params)
+        if (seq !== this._seq) return
         if (res.code === 200 && res.data) {
           var list = res.data.records || []
           if (this.page === 1) {
@@ -230,10 +264,14 @@ onLoad(options) {
           this.noMore = this.articles.length >= this.total
         }
       } catch (e) {
-        uni.showToast({ title: '加载失败', icon: 'none' })
+        if (seq === this._seq) {
+          uni.showToast({ title: '加载失败', icon: 'none' })
+        }
       } finally {
-        this.loading = false
-        this.loadingMore = false
+        if (seq === this._seq) {
+          this.loading = false
+          this.loadingMore = false
+        }
       }
     },
     onTabChange(code) {
@@ -241,9 +279,7 @@ onLoad(options) {
       this.currentTab = code
       this.searchKeyword = ''
       this.searchFocused = false
-      this.page = 1
-      this.articles = []
-      this.noMore = false
+      this.resetList()
       this.loadArticles()
     },
     async loadRecommendedArticles() {
@@ -316,12 +352,78 @@ onLoad(options) {
     },
     focusSearch() {
       this.searchFocused = true
+      // 进入搜索态:清当前 Tab 回全量(搜索与标签筛选互斥,契约 C6)
+      if (this.currentTab !== '') {
+        this.currentTab = ''
+        this.resetList()
+        this.loadArticles()
+      }
     },
     onSearch() {
+      this.doSearch(true)
+    },
+    doSearch(saveHistory) {
+      var keyword = (this.searchKeyword || '').trim()
+      // 进入搜索态:清当前 Tab 回全量(互斥重置,契约 C6)
+      if (this.currentTab !== '') {
+        this.currentTab = ''
+      }
+      this.resetList()
+      if (saveHistory && keyword) {
+        this.saveSearchHistory(keyword)
+      }
+      this.loadArticles()
+    },
+    onSearchInput(e) {
+      var value = e && e.detail ? e.detail.value : this.searchKeyword
+      this.searchKeyword = value
+      var self = this
+      if (this._searchTimer) clearTimeout(this._searchTimer)
+      // 400ms 防抖即时搜索(避免逐字请求,契约 D3a)
+      this._searchTimer = setTimeout(function () {
+        self._searchTimer = null
+        self.doSearch(false)
+      }, 400)
+    },
+    loadSearchHistory() {
+      var raw = uni.getStorageSync('article_search_history')
+      if (!raw) {
+        this.searchHistory = []
+        return
+      }
+      try {
+        var arr = JSON.parse(raw)
+        this.searchHistory = Array.isArray(arr) ? arr : []
+      } catch (e) {
+        this.searchHistory = []
+      }
+    },
+    saveSearchHistory(keyword) {
+      if (!keyword) return
+      var list = this.searchHistory.filter(function (h) { return h !== keyword })
+      list.unshift(keyword)
+      if (list.length > 10) {
+        list = list.slice(0, 10)
+      }
+      this.searchHistory = list
+      uni.setStorageSync('article_search_history', JSON.stringify(list))
+    },
+    clearSearchHistory() {
+      this.searchHistory = []
+      uni.removeStorageSync('article_search_history')
+    },
+    clickSearchHistory(keyword) {
+      this.searchKeyword = keyword
+      this.onSearch()
+    },
+    resetList() {
       this.page = 1
       this.articles = []
       this.noMore = false
-      this.loadArticles()
+      // 作废旧请求:让新搜索/刷新取代仍在途的响应,避免旧数据覆盖新结果
+      this._seq = (this._seq || 0) + 1
+      this.loading = false
+      this.loadingMore = false
     },
     onSearchBlur() {
       if (!this.searchKeyword) {
@@ -426,6 +528,39 @@ onLoad(options) {
   flex-shrink: 0;
 }
 
+/* ---- 搜索历史 ---- */
+.ac-search-history {
+  padding: 16rpx 28rpx;
+  background: $app-surface;
+  border-bottom: 1rpx solid $facade-fill;
+}
+.ac-history-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  margin-bottom: 12rpx;
+}
+.ac-history-title {
+  font-size: calc(24rpx * var(--font-scale, 1));
+  color: $facade-text-muted;
+}
+.ac-history-clear {
+  font-size: calc(22rpx * var(--font-scale, 1));
+  color: $facade-text-ghost;
+}
+.ac-history-tags {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 12rpx;
+}
+.ac-history-tag {
+  padding: 6rpx 20rpx;
+  border-radius: 20rpx;
+  background: $facade-fill;
+  font-size: calc(22rpx * var(--font-scale, 1));
+  color: $facade-text-strong;
+}
+
 /* ---- Tab 药丸导航 ---- */
 .ac-tabs {
   padding: 16rpx 28rpx;

+ 1 - 1
cfc-web/.last_build_commit

@@ -1 +1 @@
-ff6f48932de8bc08d57e4497b6770479d49ae423
+c4ca0e9eacadfeb623d72088a5df42fc84619aae

+ 2 - 2
cfc-web/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "cfc-web",
-  "version": "1.0.2508",
+  "version": "1.0.2512",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "cfc-web",
-      "version": "1.0.2508",
+      "version": "1.0.2512",
       "dependencies": {
         "@wangeditor/editor": "^5.1.23",
         "@wangeditor/editor-for-vue": "^1.0.2",

+ 1 - 1
cfc-web/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cfc-web",
-  "version": "1.0.2509",
+  "version": "1.0.2513",
   "private": true,
   "scripts": {
     "dev": "vue-cli-service serve",

+ 56 - 0
cfc-web/public/CHANGELOG-v1.0.md

@@ -4,6 +4,62 @@
 
 ---
 
+## v1.0.2513 (2026-11-14)
+
+### 文档
+- 研发负责人第177轮闭环汇报 2026-11-15 0244
+
+
+## v1.0.2512 (2026-11-14)
+
+### 文档
+- S-cfc-392 知识分享页搜索 TDD 闭环合入记录回填(RED 12eb99779 / YELLOW 3779dc800 / GREEN 163+5)
+
+
+## v1.0.2511 (2026-11-14)
+
+### 测试
+- RED contract test for plan.task.list (SC-P-47 GrowthPlanService#planTaskList / GrowthPlanController#planTasks)
+
+### 新功能
+- S-cfc-392 content.article.search 知识分享页搜索交互完善 + C4-C6 前端契约测试
+
+### 其他
+- - pages/article-center/index.vue:空态区分/搜索Tab互斥重置/onSearch重置/400ms防抖+搜索历史
+- - __tests__/api/api.test.js:getArticleList keyword 断言扩展
+- - __tests__/pages/article-center/articleSearch.contract.test.js:C4/C5/C6 前端契约测试
+- 
+
+
+## v1.0.2510 (2026-11-14)
+
+### 测试
+- RED 契约测试 cf.rewardv2.migrateConfig(S-cfc-393,T01 配置与迁移)
+- RED 契约测试 assessment.result.view 测评历史/八维量纲展示 (S-cfc-278)
+
+### 其他
+- - DatabaseInitializer 应提供 migrateCfRewardV2TeamPool() 迁移入口(§2.5)
+- - schema.sql 应含 4 张新表(cf_team_share_config/cf_team_pool_order/
+-   cf_team_pool_share/cf_platform_revenue_log,§2.1-2.4)+ 幂等唯一键 uk_scope/
+-   uk_order/uk_pool_member(§1.5)
+- - CfConfigKeys 应声明 6 个 v2 配置键并返回 §4 兜底默认值
+- - CF_EARN_RULE_SEEDS 应含 F03c 团队分润池规则(§3.3)
+- 纯 JUnit5 + 反射 + schema.sql 资源读取,无 Spring/DB/外部服务。
+- 溯源:docs/superpowers/plans/2026-11-14-cf-reward-model-v2-design.md §6-T01
+- 实测 RED:Tests run 8, Failures 7(实现未落地),权限流说明用例通过。
+- 
+- - 历史端点 /api/assessment/history:空历史对照、DTO 量纲标注(scaleMin/scaleMax/scale)、
+-   中文标签 overallLabel、越界分数拒显(不透传脏数据)
+- - 最新结果量纲拦截覆盖八类全部维度(任一越界整体拒显)
+- - 量纲口径锚定共享常量 DimensionCodeConstants.SCORE_MIN/SCORE_MAX(0–100)
+- 溯源:tests/user-scenarios/应用场景总览.md SC-P-39;API_REFERENCE.md §4.10 (2911 行);
+- 实测 6 run / 4 fail(红)。
+- 
+
+### 文档
+- /superpowers/specs/2026-11-05-dimension-scoring-convention.md §1。纯 Mockito+反射,无 Spring/DB。
+
+
 ## v1.0.2509 (2026-11-14)
 
 ### 测试

+ 57 - 1
cfc-web/public/CHANGELOG.md

@@ -1,6 +1,6 @@
 # 更新日志
 
-> 当前版本: v1.0.2509
+> 当前版本: v1.0.2513
 
 ## 历史版本
 
@@ -8,6 +8,62 @@
 
 ---
 
+## v1.0.2513 (2026-11-14)
+
+### 文档
+- 研发负责人第177轮闭环汇报 2026-11-15 0244
+
+
+## v1.0.2512 (2026-11-14)
+
+### 文档
+- S-cfc-392 知识分享页搜索 TDD 闭环合入记录回填(RED 12eb99779 / YELLOW 3779dc800 / GREEN 163+5)
+
+
+## v1.0.2511 (2026-11-14)
+
+### 测试
+- RED contract test for plan.task.list (SC-P-47 GrowthPlanService#planTaskList / GrowthPlanController#planTasks)
+
+### 新功能
+- S-cfc-392 content.article.search 知识分享页搜索交互完善 + C4-C6 前端契约测试
+
+### 其他
+- - pages/article-center/index.vue:空态区分/搜索Tab互斥重置/onSearch重置/400ms防抖+搜索历史
+- - __tests__/api/api.test.js:getArticleList keyword 断言扩展
+- - __tests__/pages/article-center/articleSearch.contract.test.js:C4/C5/C6 前端契约测试
+- 
+
+
+## v1.0.2510 (2026-11-14)
+
+### 测试
+- RED 契约测试 cf.rewardv2.migrateConfig(S-cfc-393,T01 配置与迁移)
+- RED 契约测试 assessment.result.view 测评历史/八维量纲展示 (S-cfc-278)
+
+### 其他
+- - DatabaseInitializer 应提供 migrateCfRewardV2TeamPool() 迁移入口(§2.5)
+- - schema.sql 应含 4 张新表(cf_team_share_config/cf_team_pool_order/
+-   cf_team_pool_share/cf_platform_revenue_log,§2.1-2.4)+ 幂等唯一键 uk_scope/
+-   uk_order/uk_pool_member(§1.5)
+- - CfConfigKeys 应声明 6 个 v2 配置键并返回 §4 兜底默认值
+- - CF_EARN_RULE_SEEDS 应含 F03c 团队分润池规则(§3.3)
+- 纯 JUnit5 + 反射 + schema.sql 资源读取,无 Spring/DB/外部服务。
+- 溯源:docs/superpowers/plans/2026-11-14-cf-reward-model-v2-design.md §6-T01
+- 实测 RED:Tests run 8, Failures 7(实现未落地),权限流说明用例通过。
+- 
+- - 历史端点 /api/assessment/history:空历史对照、DTO 量纲标注(scaleMin/scaleMax/scale)、
+-   中文标签 overallLabel、越界分数拒显(不透传脏数据)
+- - 最新结果量纲拦截覆盖八类全部维度(任一越界整体拒显)
+- - 量纲口径锚定共享常量 DimensionCodeConstants.SCORE_MIN/SCORE_MAX(0–100)
+- 溯源:tests/user-scenarios/应用场景总览.md SC-P-39;API_REFERENCE.md §4.10 (2911 行);
+- 实测 6 run / 4 fail(红)。
+- 
+
+### 文档
+- /superpowers/specs/2026-11-05-dimension-scoring-convention.md §1。纯 Mockito+反射,无 Spring/DB。
+
+
 ## v1.0.2509 (2026-11-14)
 
 ### 测试

+ 4 - 4
docs/design/2026-11-14-article-center-search-design.md

@@ -57,7 +57,7 @@
 
 ## 合入记录
 
-- RED 契约测试提交:__(闭环回填)
-- YELLOW 实现提交:__(闭环回填)
-- GREEN 校验:__(闭环回填)
-- DONE 收口:__(闭环回填)
+- RED 契约测试提交:`12eb99779`(S-cfc-389,`ArticleSearchContractTest`,C1-C3 共 5 测试,JDK8 实测全绿)。
+- YELLOW 实现提交:`3779dc800`(S-cfc-392,前端交互完善 + C4-C6 契约测试;内容源自分支 `7145eb7c0` 摘取——分支祖先链夹带他人 `fix/mig-no-unique` 提交,规避整分支合入,三重校验后干净摘取)。
+- GREEN 校验(独立核验,本机 worktree):cfc-frontend jest **163/163**(api.test.js + articleSearch.contract.test.js,含 C4/C5/C6);cfc-backend `ArticleSearchContractTest` **5/5**(31 独立复验)。RED 会话侧另报 verify-vue-compile PASS / audit-mp-antipatterns ERROR 0。
+- DONE 收口:状态机 YELLOW→GREEN→(部署待下轮),证据见 `.tdd/state.json`。

+ 204 - 0
docs/tdd/orchestration/report-dev-2026-11-15-0244.md

@@ -0,0 +1,204 @@
+# 研发负责人工作汇报 · 2026-11-15 02:44(定时自动化轮 · 第 177 轮)
+
+> 本轮为 CF 定时自动化(`5c32f42a-f237-4946-bedf-97dd1e2e0f66`)研发负责人标准闭环收割轮,无人值守执行。按 SKILL.md「负责人通用收割骨架」S1–S11 顺序,参数读取 `E:/cfc/.tdd/config.json#harvest`(mutex_minutes=5 / report_stale_hours=2 / status_top=12 / session_concurrency=2 / agent_session_limit=3 / auto_limit=2 / heartbeat.enabled=false / fill_capacity.enabled=true* / sc_priority 优先级链)。
+
+> \* 提示词与 config 不一致已注明:提示词称「S6 填充 CFC 未启用(config enabled=false)」,实测 `config#harvest.fill_capacity.enabled=true`;本轮按提示词显式指令跳过 S6,供下轮复核是否开启。S5 心跳 `heartbeat.enabled=false` 一致,跳过。
+
+---
+
+## 基本信息
+
+| 项目 | 内容 |
+|------|------|
+| 汇报人 | 研发负责人(定时自动化编排侧) |
+| 汇报周期 | 2026-11-15 02:44 ~ 2026-11-15 03:16(第 177 轮) |
+| 负责模块/单元范围 | E:/cfc 全量(主线 `origin/cfclub`) |
+
+---
+
+## 一、本轮工作数据汇总
+
+### 1.0 场景覆盖矩阵(硬职责增列)
+
+> 唯一计数源:`docs/tdd/orchestration/sc-key-map.md`(241 SC 全量台账)。「跑通」三判据:① 三类流执行证据;② 实现/用例已 push `origin/cfclub`;③ `--clean-check` 退出码 0。
+
+| 指标 | 值 | 说明 |
+|------|-----|------|
+| 场景总数 | `241` | sc-key-map.md 全量台账 |
+| 累计已跑通 | `15` | O-3 收口 5(G-02/G-06/P-03/P-10/P-11)+ 游客域补证 10(G-01/03/04/05/07/08/09/10/11/12),证据 sha 见 sc-key-map 主表 |
+| 本轮新增跑通 | `0` | 本轮无 SC 满足三判据(16 键自动置 YELLOW 仅实现证据,三类流执行证据与 mark-green 待测试侧;--clean-check 判据受主工作树他人 WIP 影响不达标) |
+| 失败 | `0` | — |
+| 阻塞 | `0` | --inspect「当前无已登记阻塞」 |
+| 未跟踪 | `226` | = 241 − 15 − 0 − 0 |
+
+> ⚠️ 本轮 16 键自动置 YELLOW + RED→YELLOW 1 + GREEN 1,属「任务推进」而非「场景已跑通」,不冲抵 1.0 计数。
+
+---
+
+### 1.1 问题接收与处置
+
+| 指标 | 数量 | 填写说明 |
+|------|------|----------|
+| **收到的测试反馈问题数*** | `0` 个 | 本轮 `docs/tdd/test/blockers.md` 无新增研发类阻塞登记;--inspect 显示无已登记阻塞 |
+| **已解决问题数*** | `0` 个 | 本轮无显式 BLOCKED 解除;RED→YELLOW 推进属阶段流转,计入 1.3 |
+| **待解决研发问题数** | `6` 个 | REQUEUE-EXHAUSTED 待人工核对(S-cfc-328/330/278/281/282/283,requeue 3 次仍无 git 证据),详见「三、阻塞与风险」 |
+
+---
+
+### 1.2 任务分发与会话管理
+
+| 指标 | 数量 | 填写说明 |
+|------|------|----------|
+| **分派任务数*** | `1` 个(开发类) + `≥16` 键(部署验证自动派发) | S7 `--auto --role 开发 --limit 2`:开发任务成功派发 1(S-cfc-225 → lan-189,ses_e248bbca9ffeWcy4NngJL9NHBJ)/ 失败 0 / 跳过(超限)0;单轮派发预算 300s 耗尽,**剩余 51 个 pending 留待下轮**;16 键自动置 YELLOW 后自动派发 testing 部署验证(每轮 `_MAX_DEPLOY_PER_RUN=10` 限流) |
+| **恢复智能体会话数*** | `0` 个 | --resume --dry-run 仅 1 个候选(lan-204「cmd输入法失灵复发」ses_e266d49c2ff,mid-work),非 TDD 命名会话、非本编排派发,按「他人 WIP 只报不动」不恢复 |
+| **当前在用会话数** | `5` 节点 | lan-189 / lan-204 / local-lan-4090 / mes-local-45278 / pub-iwintrue(CFC 白名单节点) |
+| **会话平均利用率** | — | 未精确统计;本轮派发 1 个后各节点负载 +1(lan-189) |
+
+**派发明细(1 个成功)**:
+- S-cfc-225(energy.ledger.guard 键,RED→YELLOW 后 requeue 置回 pending 再派发)→ lan-189(分支 task/S-cfc-225,目录 .worktrees/task_S-cfc-225)
+
+**跳过(预算耗尽)51 个**:S-cfc-304/347 及其余 pending 任务,300s 派发预算耗尽留待下轮(本轮 auto 输出「== 自动派发 52 个 pending TDD 任务…单轮派发预算(300s)已耗尽,剩余 51 个 pending 留待下轮派发」)。
+
+**模型冷却**:`mes-local-45278@deepseek@axonhub` 冷却至 2026-11-15 08:00:00(429 规则命中),本轮派发自动绕行 lan-189(实例级 model_chain 优选)。
+
+### 1.2b 各会话当前工作状态列表
+
+> 快照来源:S3 `--inspect`(02:47,测试角色只读)。--auto 派发后 lan-189 负载 +1。
+
+| 会话节点 | inspect 时配额 | inspect 时状态 | --auto 派发后 | 工作目录 | 备注 |
+|----------|---------------|---------------|--------------|---------|------|
+| lan-189 | 0/4(剩 4) | 50 idle | +1 负载(S-cfc-225) | 远端 c:/code/cfc | — |
+| lan-204 | 0/10(剩 10) | 50 idle | 0 | 远端 D:/cfc | 「cmd输入法失灵复发」会话非本编排派发,未恢复 |
+| local-lan-4090 | 0/6(剩 6) | 50 idle | 0 | 远端 /sc-data/cfc | — |
+| mes-local-45278 | 3/6(剩 3) | 3 busy + 47 idle | 0 | 本机 E:/cfc | 模型 @axonhub 冷却至 08:00,派发绕行 |
+| pub-iwintrue | 0/6(剩 6) | 50 idle | 0 | 远端 /sc-data/cfc | 部署验证目标节点 |
+
+> 部署专用会话:production=`ses_f719c9326ffeMp0i4xZi6oNFFt`(cfc-prod)、testing=`ses_e4804838affeBHv6uKhYS4x7o7`(cfc-test);family.member.update 部署任务本轮已向 testing 会话(pub-iwintrue,ses_e24946252ffeG3UbpOlzt3hURp)派发。
+
+---
+
+### 1.3 变更感知与新任务建立
+
+| 指标 | 数量 | 填写说明 |
+|------|------|----------|
+| **感知需求/设计变更数*** | `0` 新增能力键 | --changes --days 7:多文件提交但**0 新增能力键**(全为既有键状态/内容变化);`origin/cfclub` 近 20 条含测试侧 RED 契约测试合入(S-cfc-393 cf.rewardv2.migrateConfig / S-cfc-278 assessment.result.view / S-cfc-225 energy.ledger.guard / S-cfc-282 plan.task.list / S-cfc-301 auth.session.mutex)+ content.article.search 前端契约测试(3779dc800) |
+| **新增入池任务数*** | `0` 个 | S8:池非空(--auto 报 pending 52、剩余 51),不触发「池空」续建;0 新增能力键、无实际工作溯源 → 按防假红纪律不 `--add-task`(与 O-7/O-25 一致) |
+| **既有键状态流转数** | `17` 键 | 16 键自动置 YELLOW✓(git 证据经 `pushed_to_remote` 校验)+ cf.rewardv2.migrateConfig RED→YELLOW + content.article.search YELLOW→GREEN |
+
+**YELLOW✓ 16 键明细**:child.growth.archive(fdd6bb8fda)/ ai.coach.reportAnalyze(f851092436)/ ai.coach.handoffPlanner(8496aafdfd)/ butler.escalation.handle(34613f181b)/ butler.resource.match(d363df8056)/ butler.quality.qa(aebf211c77)/ family.family.createWithInvite(a1c8a758fd)/ family.family.relationGraph(825f73305b)/ family.member.update(76759de54c)/ energy.fiveDim.view(677e6153d1)/ energy.ledger.view(e08d8af26f)/ report.archive.manage(5ac443f51a)/ diet.mealPlan.adjust(9c8647200f)/ growth.milestone.mark(8003360aac)/ assessment.planner.select(4c0ff67299)/ assessment.appointment.create(4411c85cf6)——全部「待测试校验确认」(mark-green 归测试侧)。
+
+**REQUEUE 处置**:
+- 置回 pending(requeue):S-cfc-225(#3)/ 248(#3)/ 270(#3)/ 284(#3)/ 304(#1)/ 347(#1)——done 但无 git 证据,自动回池下轮续派;
+- REQUEUE-EXHAUSTED(requeue 3 次仍无 git 证据 → 待人工):S-cfc-328(child.wish.manage)/ 330(child.badge.view)/ 278(assessment.result.view)/ 281(plan.confirm.submit)/ 282(plan.task.list)/ 283(contact.card.manage,RED 域);
+- REQUEUE-SKIP-O22(键级已实现定论,保持 done 不重派):S-cfc-213/215/218~224/239~245/357/359/360/363/368/370 等。
+
+---
+
+### 1.4 本轮 git 提交与推送证据(真理证据)
+
+> 本轮 17 键登记全部经 `git_evidence()` + `pushed_to_remote()` 双校验(`commit_kind()` 内置 `merge-base --is-ancestor <sha> <data_ref>`)。代表证据 sha(全部在 origin/cfclub):
+
+| 提交 sha | 关联能力键 | 阶段 | 触及文件类型 | 目标分支 | 已推送远端 | 备注 |
+|----------|-----------|------|--------------|----------|------------|------|
+| `fdd6bb8fda` | child.growth.archive | YELLOW | 实现 | task/* → origin/cfclub | 是 | 2 文件,--auto 自动登记 |
+| `f851092436` | ai.coach.reportAnalyze | YELLOW | 实现 | task/* | 是 | 3 文件 |
+| `8496aafdfd` | ai.coach.handoffPlanner | YELLOW | 实现 | task/* | 是 | 2 文件 |
+| `34613f181b` | butler.escalation.handle | YELLOW | 实现 | task/* | 是 | 8 文件 |
+| `d363df8056` | butler.resource.match | YELLOW | 实现 | task/* | 是 | 10 文件 |
+| `aebf211c77` | butler.quality.qa | YELLOW | 实现 | task/* | 是 | 11 文件 |
+| `76759de54c` | family.member.update | YELLOW | 实现 | task/* | 是 | 5 文件;部署任务已派发 testing(ses_e24946252f) |
+| `4411c85cf6` | assessment.appointment.create | YELLOW | 实现 | task/* | 是 | 19 文件 |
+| `7ab29f085` | cf.rewardv2.migrateConfig | RED→YELLOW | 测试 | feat/reward-v2 → origin/cfclub | 是 | S-cfc-393 契约测试合入,自动转 YELLOW 待开发实现 |
+| `3779dc800` | content.article.search | GREEN | 测试+前端 | task/* | 是 | 已实现但**部署未验证**(deploy_verify=true),保持 GREEN |
+| `dceeaaeaf` 等 | 15 个已跑通 SC 证据 | 已收口 | — | origin/cfclub | 是 | 历史证据复核无漂移 |
+
+> 汇报文件本身:本轮单文件提交 push(见下「收口」)。
+
+---
+
+### 1.5 状态机阶段分布与部署状态
+
+| 阶段 | 键数 | 备注 |
+|------|------|------|
+| UNTRACKED | `0`(⏳ 目标池 0) | — |
+| RED | `34` | -1(cf.rewardv2.migrateConfig 转 YELLOW);多个 RED 契约测试在途 |
+| YELLOW | `168` | 本轮 +17 登记(16 YELLOW✓ + migrateConfig 转入),REQUEUE 回池 6 抵消部分 |
+| GREEN | `9` | +1(content.article.search,部署未验证保持 GREEN) |
+| DONE | `15` | REQUEUE-SKIP-O22 保持 done |
+
+| 部署项 | 值 | 说明 |
+|--------|-----|------|
+| 本轮部署次数 | `≥16` 次(自动) | --auto 对新置 YELLOW 16 键自动派发 testing 部署验证,`_MAX_DEPLOY_PER_RUN=10` 限流;family.member.update 部署指令明确送达(ses_e24946252f) |
+| 部署在途 | `pending 57 / confirmed 77` | auto 前 56 → auto 追加后 57;待编排侧 `--deploy-done <env> --commit <sha>` 收口(O-24 持续推进) |
+| 最新 `last_deployed` | 未变 | 本轮未手动 --deploy-done |
+| GREEN 部署链验证 | 1 键待验证 | content.article.search:实现已 push,部署未验证 → 保持 GREEN 不转 DONE |
+
+---
+
+### 1.6 数据源健康度
+
+| 数据源 | 读取键数 | 是否正常 | 备注 |
+|--------|----------|----------|------|
+| 需求侧(⏳ wish) | `0` | 正常(口径为 0) | CFC 当前为「发现/跟踪」模式,需求侧 ⏳ 表未配置匹配项 → 0,非静默失效(已多轮确认) |
+| 契约常量(contract) | `0` | 正常(口径为 0) | 同上;SC→能力键映射走 sc-key-map.md 而非 ops_file 常量 |
+| 测试用例引用(test_case_map) | `0` | 正常(口径为 0) | 用例引用∩⏳=0(⏳ 为空所致);测试用例台账由测试侧 automation-status.md 维护 |
+| 执行结果回填(case_results) | `0` | 正常(口径为 0) | 未配置执行结果回填路径 |
+
+---
+
+## 二、下一步需要研发处理的事项
+
+| 序号 | 事项描述 | 依赖/前置条件 | 预估完成时间 | 优先级 | 状态 |
+|------|----------|---------------|--------------|--------|------|
+| 1 | 下轮 `--auto --limit 2` 续派 51 个 pending(300s 预算耗尽留待;含 S-cfc-304/347 及上轮 25 超限项) | 各节点配额释放 + 300s 派发预算 | 下轮 03:xx 档 | P1 | 待启动 |
+| 2 | 部署 pending 57 回执收口(O-24) | 测试侧部署会话回执 → 编排侧 `--deploy-done` | 下轮 | P1 | 进行中 |
+| 3 | REQUEUE-EXHAUSTED 6 任务(S-cfc-328/330/278/281/282/283)人工核对 git 证据(3 次 requeue 无证) | 人工核对原始提交/或确认键实现现状后 mark-* | 人工 | P1 | needs_human |
+| 4 | content.article.search GREEN 部署验证补收(3779dc800 testing 部署) | 部署会话回执 | 下轮 | P1 | 待启动 |
+| 5 | cf.rewardv2.migrateConfig(S-cfc-393)RED→YELLOW 后实现承接 | 实现会话 | 下轮 | P1 | 待启动 |
+
+---
+
+## 三、阻塞与风险
+
+| 阻塞项 | 影响范围 | 阻塞类型 | 处置进展 | 需要协调 |
+|--------|----------|----------|----------|----------|
+| 主工作树他人 WIP `1094` 处(M .gitignore + D .tdd/_r189_* 等测试侧日志删除) | `--clean-check` 退出码 1,但与 SC 跑通判据③「该场景工作区干净」零交集(O-3 判据③) | 测试(他人会话未提交改动) | 只报不动(纪律:不强制提交/不丢弃/不 stash 他人改动) | 无(不阻塞本轮 SC 判定) |
+| REQUEUE-EXHAUSTED 6 任务(S-cfc-328/330/278/281/282/283) | 单任务 | 测试 | --auto requeue 上限 3 次仍无 git 证据 → `needs_human` 待人工核对 | 需人工核对原始提交或键实现现状 |
+| `mes-local-45278@deepseek@axonhub` 冷却至 08:00(429 规则) | 该节点派发暂时绕行 | 模型配额 | 冷却至 08:00 自动解禁;本轮已绕行 lan-189 | 无 |
+| 0 新增能力键 + 池空无溯源 → 防假红收敛 | 长期挂起项(O-7/O-25) | 需求 | 下轮若池空按四类实际工作溯源(未跑通 SC / TR / B / CF-CR / CI 缺口)建任务,无则收敛 | 无 |
+
+---
+
+## 四、下轮工作规划
+
+| 计划项 | 预计完成时间 | 前置依赖 | 涉及会话标签 | 备注 |
+|--------|--------------|----------|--------------|------|
+| 续派 51 个 pending | 下轮 03:xx 档 | 节点配额释放 + 300s 派发预算 | lan-189/lan-204/local-lan-4090/mes-local/pub-iwintrue | --auto --limit 2 每节点 |
+| 跟进部署 pending 57 回执 | 下轮 | 部署会话回执 | cfc-test | O-24 |
+| content.article.search 部署验证补收 | 下轮 | 部署会话回执 | cfc-test | 收 GREEN→DONE |
+| REQUEUE-EXHAUSTED 人工核对 | 人工 | 证据核对 | — | S-cfc-328/330/278/281/282/283 |
+| 观察 mes-local 冷却 08:00 解禁 | 下轮 | — | mes-local-45278 | 解禁后恢复该节点派发 |
+
+---
+
+## 收口记录(本汇报)
+
+- **S1 互斥门**:PASS(state.json mtime 距今 55.8 分钟 >5 分钟;worklog.active=null;无锁)。判定轮首固化,全程未重判。
+- **S2 失败补跑**:不触发(最新已推汇报 report-dev-2026-11-15-0145.md mtime 距今 <2h,两条件未同时满足)。
+- **S3 盘点**:--status / --inspect(测试角色) / --resume --dry-run / --changes / --clean-check / git log origin/cfclub 近 20 条全部完成;SC 台账 241 总数 / 15 已跑通核对无漂移。
+- **S4 恢复**:0 恢复(候选 1 个非 TDD 会话,他人 WIP 不动)。
+- **S5 心跳 tick**:**跳过**(config#harvest.heartbeat.enabled=false)。
+- **S6 会话填充 fill_capacity**:**跳过**(提示词显式指令;提示词称 config enabled=false,实测 config#harvest.fill_capacity.enabled=true——以提示词为准跳过,如实注明供下轮复核)。
+- **S7 派发**:`--auto --role 开发 --limit 2` 成功 1 / 失败 0 / 跳过(超限)0;300s 派发预算耗尽剩余 51 pending 下轮;16 键自动置 YELLOW + 部署验证自动派发;cf.rewardv2.migrateConfig RED→YELLOW;content.article.search 转 GREEN(部署未验证)。
+- **S8 池空续建**:不适用(池非空,pending 51 留待下轮)。
+- **S9 收口纪律**:未 git add -A、未 checkout/stash、未碰他人 WIP;状态推进仅本地 state.json(.gitignore 排除,不入库不推送)。
+- **S10 汇报**:本文件单文件精确提交 push 至 origin/cfclub,随后 --clean-check 复核。
+- **S11 铁律**:不伪造证据(全部 sha 经 merge-base 校验);互斥命中轮零副作用(本轮 S1 PASS,正常收割);他人 WIP 只报不动;无人值守不提问。
+- **webhook**:本轮不在发送窗口(档位 {6,10,14,18,22} 整档;当前 02:44)→ 未发,如实记录。
+- **派发模型链**:--auto 内置各节点实例级 model_chain(lan-189=axon/deepseek、lan-204=axonhub/deepseek、local-lan-4090=axonhub/deepseek、mes-local=axonhub/deepseek、pub-iwintrue=etotem/deepseek),按节点真实可用模型适配;mes-local@axonhub 本轮按 429 规则冷却至 08:00,自动绕行 lan-189。
+
+---
+
+**汇报人**:研发负责人(定时自动化编排侧)  
+**汇报时间**:2026-11-15 03:16  
+**模板版本**:v1.2(2026-11-14)

+ 3 - 2
docs/需求分析/2026-11-14-小程序知识分享页搜索功能需求变更.md

@@ -51,5 +51,6 @@
 
 ## 合入记录
 
-- **TDD 闭环**:RED 契约测试(`--requirement` 本文件)→ YELLOW 实现(前端交互完善 + 契约测试转绿)→ GREEN 测试校验 → DONE。
-- 实现提交/合入 commit:见设计文档「合入记录」段。
+- **TDD 闭环**:RED 契约测试(S-cfc-389,commit `12eb99779`,后端 C1-C3)→ YELLOW 实现(S-cfc-392,commit `3779dc800`,前端 D3 交互完善 + C4-C6 契约测试)→ GREEN 校验(jest 163/163 + 后端 ArticleSearchContractTest 5/5)→ DONE。
+- 契约 C1-C6 全部落地:C1/C2/C3 由后端 `ArticleSearchContractTest`(cfc-backend/src/test/java/com/etotem/cfc/unit/)锁定;C4/C5/C6 由 `cfc-frontend/__tests__/pages/article-center/articleSearch.contract.test.js` 锁定。
+- 设计正本回填见 `docs/design/2026-11-14-article-center-search-design.md`「合入记录」段。