Procházet zdrojové kódy

merge: sync origin/cfclub 漂移后推 T01 数据层底座

Agnes Agent před 1 dnem
rodič
revize
a5e3a8eece

+ 228 - 0
cfc-backend/src/test/java/com/etotem/cfc/unit/ContactCardManageContractTest.java

@@ -0,0 +1,228 @@
+package com.etotem.cfc.unit;
+
+import com.etotem.cfc.common.Result;
+import com.etotem.cfc.dto.ContactDTO;
+import com.etotem.cfc.entity.Contact;
+import com.etotem.cfc.mapper.ContactMapper;
+import com.etotem.cfc.service.ContactService;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import org.mockito.InjectMocks;
+import org.mockito.Mock;
+import org.mockito.MockitoAnnotations;
+
+import java.lang.reflect.Field;
+import java.lang.reflect.Method;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.junit.jupiter.api.Assertions.fail;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.Mockito.lenient;
+import static org.mockito.Mockito.never;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+/**
+ * 契约级单测:联系人卡片管理(能力键 {@code contact.card.manage},单元 contact,S-cfc-283)。
+ *
+ * <p><b>契约溯源</b></p>
+ * <ul>
+ *   <li>需求:{@code tests/user-scenarios/应用场景总览.md} SC-P-61(联系人添加:姓名/电话/关系,
+ *       重复号码去重)与 SC-P-63(联系人详情/权限:设可见权限,越权查看被拒);业务域 G 联系人与社交;
+ *       用例 {@code tests/test-cases/parent.md} TC-P-61/-E/-P 与 TC-P-63/-E/-P。</li>
+ *   <li>设计:{@code docs/superpowers/api/API_REFERENCE.md} §4.3 前 Controller 清单
+ *       {@code ContactController /api/contact}(联系人 CRUD/互动/邀请入家庭)、
+ *       {@code ContactMatchController /api/contact/match}(send/accept/reject/列表);
+ *       模块:{@code ContactCard} / {@code contact-detail}。</li>
+ * </ul>
+ *
+ * <p><b>宿主现状(src/main 核实,2026-11-14)</b></p>
+ * <ul>
+ *   <li>{@link ContactService#create}: 无同用户重复号码去重 —— 直接 {@code insert} 返回成功;</li>
+ *   <li>{@link Contact} 实体:无可见权限字段;{@link ContactService} 无设置可见权限方法;</li>
+ *   <li>{@link ContactService#detail}: 越权(非本人)返回 500「联系人不存在」,非契约要求统一 403。</li>
+ * </ul>
+ *
+ * <p><b>契约行为(RED → GREEN 升级指引)</b></p>
+ * <ul>
+ *   <li>SC-P-61 重复号码去重:{@code create} 前按 {@code userId+phone} 查重,已存在 → 拒绝且不落库
+ *       (去重提示,TC-P-61-E);</li>
+ *   <li>SC-P-63 设可见权限:{@code Contact} 实体承载可见权限字段(如 {@code visibility},默认最小权限
+ *       {@code private});{@code ContactService} 提供 {@code updateVisibility(contactId, userId, visibility)}
+ *       设置并校验归属;</li>
+ *   <li>SC-P-63 越权查看被拒:{@code detail} 对非本人/未授权联系人统一返回 403(越权统一 403/401,
+ *       SC-X-03),不泄露他人联系人数据。</li>
+ * </ul>
+ *
+ * <p><b>测试范围</b>:纯契约级单测,仅 JUnit 5 + Mockito(无 Spring / 无 DB / 无外部服务)。</p>
+ *
+ * <p><b>RED 预期</b>:正常流 2 条(SC-P-61 三要素结构 + 新号码成功)为现状已具备(预计绿);
+ * 异常流/权限流 5 条锚定未落地行为(重复号码去重、去重查重、可见权限字段、{@code updateVisibility}
+ * 方法、越权 403)——在实现补齐前应失败(红)。</p>
+ */
+class ContactCardManageContractTest {
+
+    /** 归属用户(联系人属主)。 */
+    private static final Long OWNER_USER_ID = 100L;
+
+    /** 非归属用户(越权查看方)。 */
+    private static final Long FOREIGN_USER_ID = 999L;
+
+    /** 重复号码(去重契约锚点)。 */
+    private static final String DUP_PHONE = "13800138000";
+
+    @Mock
+    private ContactMapper contactMapper;
+
+    @InjectMocks
+    private ContactService contactService;
+
+    @BeforeEach
+    void setUp() {
+        MockitoAnnotations.openMocks(this);
+    }
+
+    // ==================== 正常流:SC-P-61 联系人添加(姓名/电话/关系) ====================
+
+    @Test
+    @DisplayName("正常流-1:Contact 实体承载姓名/电话/关系三要素")
+    void contact_entityCarriesScp61Fields() {
+        assertTrue(hasField(Contact.class, "name"),
+                "SC-P-61 添加联系人需 Contact 实体含 name(联系人姓名)");
+        assertTrue(hasField(Contact.class, "phone"),
+                "SC-P-61 添加联系人需 Contact 实体含 phone(联系人电话)");
+        assertTrue(hasField(Contact.class, "relationshipType"),
+                "SC-P-61 添加联系人需 Contact 实体含 relationshipType(联系人关系)");
+    }
+
+    @Test
+    @DisplayName("正常流-2:新号码(无重复)create 应成功")
+    void create_uniquePhone_success() {
+        // 新号码无重复 → 查重返回 null(唯一号码,放行创建)
+        lenient().when(contactMapper.selectOne(any())).thenReturn(null);
+
+        Contact c = new Contact();
+        c.setName("张三");
+        c.setPhone("13900139000");
+        c.setRelationshipType("family");
+
+        Result<ContactDTO> result = contactService.create(c, OWNER_USER_ID);
+
+        assertEquals(200, result.getCode(),
+                "SC-P-61 新号码 create 应返回成功(code=200),实际=" + result.getCode()
+                        + " msg=" + result.getMessage());
+        assertNotNull(result.getData(), "SC-P-61 create 成功应返回联系人数据");
+        assertEquals("张三", result.getData().getName());
+    }
+
+    // ==================== 异常流:SC-P-61 重复号码去重(TC-P-61-E) ====================
+
+    @Test
+    @DisplayName("异常流-3:同用户重复号码 create 应被拒(去重提示,不返回成功)")
+    void create_duplicatePhone_rejected() {
+        // 查重命中:同用户下该手机号已存在 → 契约要求拒绝(去重)
+        lenient().when(contactMapper.selectOne(any())).thenReturn(existingContact(DUP_PHONE));
+
+        Contact c = new Contact();
+        c.setName("李四");
+        c.setPhone(DUP_PHONE);
+        c.setRelationshipType("friend");
+
+        Result<ContactDTO> result = contactService.create(c, OWNER_USER_ID);
+
+        assertNotEquals(200, result.getCode(),
+                "RED[contact.card.manage] SC-P-61 重复号码去重未实现:同用户手机号 " + DUP_PHONE
+                        + " 已存在时 create 应拒重并提示(TC-P-61-E 重复号码去重提示),"
+                        + "当前直接返回成功 code=" + result.getCode());
+    }
+
+    @Test
+    @DisplayName("异常流-4:create 应执行 userId+phone 查重且重复时不落库")
+    void create_duplicatePhone_doesNotWrite() {
+        // 查重命中:同用户下该手机号已存在 → 契约要求不落库(去重)
+        lenient().when(contactMapper.selectOne(any())).thenReturn(existingContact(DUP_PHONE));
+
+        Contact c = new Contact();
+        c.setName("李四");
+        c.setPhone(DUP_PHONE);
+        c.setRelationshipType("friend");
+
+        contactService.create(c, OWNER_USER_ID);
+
+        // 契约:create 必须先按 userId+phone 查重(去重查询)
+        verify(contactMapper).selectOne(any());
+        // 契约:重复号码不得落库(不重复插入,TC-P-61-E「不重复」)
+        verify(contactMapper, never()).insert(any(Contact.class));
+    }
+
+    // ==================== 权限流:SC-P-63 设可见权限 / 越权查看被拒 ====================
+
+    @Test
+    @DisplayName("权限流-5:Contact 实体应承载可见权限字段(设可见权限)")
+    void contact_entityCarriesVisibilityField() {
+        assertTrue(hasField(Contact.class, "visibility"),
+                "RED[contact.card.manage] SC-P-63 设可见权限未实现:Contact 实体缺少可见权限字段"
+                        + "(如 visibility),联系人详情无权限承载,无法实现『设可见权限 / 越权查看被拒』。");
+    }
+
+    @Test
+    @DisplayName("权限流-6:ContactService 应提供 updateVisibility 设置可见权限方法")
+    void contactService_hasUpdateVisibilityMethod() {
+        assertMethodExists(ContactService.class, "updateVisibility",
+                "SC-P-63 设可见权限:updateVisibility(contactId, userId, visibility) 应设置联系人"
+                        + "可见权限并校验归属(越权设置被拒,最小权限保底)。");
+    }
+
+    @Test
+    @DisplayName("权限流-7:detail 非本人联系人应统一 403(越权查看被拒)")
+    void detail_foreignContact_forbidden403() {
+        Contact foreign = existingContact("13700137000");
+        foreign.setId(5L);
+        foreign.setUserId(FOREIGN_USER_ID);
+        when(contactMapper.selectById(5L)).thenReturn(foreign);
+
+        // OWNER 用户查看 FOREIGN 用户(非本人)的联系人 → 契约要求越权统一 403(SC-X-03)
+        Result<ContactDTO> result = contactService.detail(5L, OWNER_USER_ID);
+
+        assertEquals(403, result.getCode(),
+                "RED[contact.card.manage] SC-P-63 越权查看被拒未按契约实现:非本人查看他人联系人应统一"
+                        + "返回 403(越权统一 403/401,SC-X-03),当前返回 " + result.getCode()
+                        + "(msg=" + result.getMessage() + ")。");
+    }
+
+    // ==================== 辅助构造 ====================
+
+    private Contact existingContact(String phone) {
+        Contact c = new Contact();
+        c.setId(1L);
+        c.setUserId(OWNER_USER_ID);
+        c.setName("张三");
+        c.setPhone(phone);
+        c.setRelationshipType("friend");
+        return c;
+    }
+
+    private boolean hasField(Class<?> clazz, String field) {
+        try {
+            clazz.getDeclaredField(field);
+            return true;
+        } catch (NoSuchFieldException e) {
+            return false;
+        }
+    }
+
+    /** 断言契约方法存在(按方法名匹配,含继承),缺失即断言失败(红)。 */
+    private void assertMethodExists(Class<?> clazz, String method, String purpose) {
+        for (Method m : clazz.getDeclaredMethods()) {
+            if (m.getName().equals(method)) {
+                return;
+            }
+        }
+        fail("RED[contact.card.manage] 契约方法 " + clazz.getSimpleName() + "#" + method
+                + " 未实现:" + purpose);
+    }
+}

+ 20 - 1
docs/tdd/impl-2026-11-14-S-cfc-330-child-badge-view.md

@@ -45,4 +45,23 @@ Tests run: 11, Failures: 0, Errors: 0, Skipped: 0 - in com.etotem.cfc.unit.Child
 Tests run: 9,  Failures: 0, Errors: 0, Skipped: 0 - in com.etotem.cfc.controller.BadgeControllerGetMemberBadgesTest
 Tests run: 11, Failures: 0, Errors: 0, Skipped: 0 - in com.etotem.cfc.unit.AdminBadgeManageContractTest
 Tests run: 6,  Failures: 0, Errors: 0, Skipped: 0 - in com.etotem.cfc.unit.BadgeServiceUnlockNoticeTest
-```
+```
+
+---
+
+## 当前 HEAD 复核(2026-11-14 晚,派发会话 · 任务 S-cfc-330 重派发 #1 复核)
+
+**复核基准**: `origin/cfclub` @ `0875a19e3`(worktree `.worktrees/task_S-cfc-330`,分支 `task/S-cfc-330`,ff 至 origin/cfclub HEAD,无工作区改动)
+
+**复核过程与结论**:
+
+1. **目标测试类在基线即全绿**:`ChildBadgeViewContractTest` 在 `6f782fab5`(上一验证提交)实测 **11/11 Green**(surefire `Tests run: 11, Failures: 0, Errors: 0, Skipped: 0`,BUILD SUCCESS)。
+2. **实现未回退**:`git diff 6f782fab5..0875a19e3 -- cfc-backend/src/main/java/com/etotem/cfc/service/BadgeService.java` 为空,且窗口内无任何 badge src/main 变更 → `BadgeService` 全 7 方法 + `NotificationDispatchService.sendByTemplate` + `MemberBadgeMapper` 统计/排行实现与已验证全绿基线**字节一致**,11/11 结论对当前 HEAD 实现成立。
+3. **测试断言未漂移**:`git diff 6f782fab5..0875a19e3 -- cfc-backend/src/test/java/com/etotem/cfc/unit/ChildBadgeViewContractTest.java` 为空 → 测试类与已验证全绿基线**字节一致**。
+4. **未触碰 src/main、未改测试断言/删用例**:本轮 0 代码变更,符合测试 javadoc「若实测意外全绿,交编排侧核实能力键状态(转测试登记),不私改 src/main 实现」与任务「禁止改测试」纪律。
+
+**发现(无关缺陷,非本键引入,交编排侧)—— B-203-5 测试编译 P0 阻断**:
+
+当前 `origin/cfclub` HEAD(`0875a19e3`)后端 `mvn test-compile` **BUILD FAILURE**:5 个**商品可见性**契约测试类(`ProductRecommendationFilterTest` / `ProductServiceListByDimensionVisibilityTest` / `ContentRecommendProductVisibilityTest` / `ProductVisibilitySupportTest` / `RecommendationSearchProductVisibilityTest`,源自 `df401ba65 fix(security): 统一商品可见性过滤`)使用 **Java 9+ `List.of`**,而工程 `java.version=1.8` → **全后端测试源码不可编译 → 当前 HEAD 任何后端测试类均无法实跑**。该阻断与 `child.badge.view` 无任何关联(本键目标测试类未使用 `List.of`,用 `Arrays.asList`;实现/测试类均已在上文证明与全绿基线一致),由测试侧 R203 已登记(`docs/tdd/orchestration/report-test-2026-11-14-R203.md` B-203-5/B-203-6,建议 pre-push 闸门改跑 test-compile 拦截)。**本任务不扩散修复**,仅记录待商品可见性链路归口处理。
+
+**结论**:`child.badge.view` 契约测试在基线即全绿(实现已在链 `36b671565`,O-22 豁免,同 S-cfc-309 / S-cfc-328 先例)。**无需任何 src/main 改动**,红单测已全部转绿(11/11)。本提交为 docs-only 复核证据补充(补齐当前 HEAD 复核 + B-203-5 发现),交编排侧转测试侧 mark-green 收尾。

+ 69 - 0
docs/tdd/orchestration/report-deploy-2026-11-14-4c0ff6729.md

@@ -0,0 +1,69 @@
+# 部署回执:4c0ff6729 → testing(2026-11-14 22:30)
+
+## 结论
+
+**目标提交 `4c0ff672994a3f7f5081604dc7968b01a4afe13c`(S-cfc-369 测评预约创建前校验所选规划师 ∈ 家庭已绑定 T 列表)部署 FAILED —— 目标提交自身含启动阻断缺陷(与 d363df8056 同源:`butlerResourceMatchService` bean 名冲突),部署链自动回滚,目标改动**未**真实运行在 testing 环境。**
+
+testing 当前线上版本为 **`c2180785a3e186bbff59798a594beb8e5a0cef7e`**(构建于 2026-11-14 14:31,md5 `2e116d30e16cc6d4b215f99999c3892f`,最后一次成功启动版)。目标提交 `4c0ff6729` **不是** `c2180785` 的祖先:
+`git merge-base --is-ancestor 4c0ff6729 c2180785` → **不成立**,目标改动未打进线上 JAR。
+
+## 根因(目标提交自身代码缺陷,非部署链问题)
+
+目标提交 `4c0ff6729` 含 `d363df8056`(`feat(butler): 实现资源匹配服务 SC-H-05`)引入的启动阻断缺陷:
+
+```java
+// cfc-backend/.../service/ButlerResourceMatchService.java:46(目标提交内,与 origin/cfclub HEAD 3afa2ef28 字节一致)
+@Resource
+private ButlerResourceFollowUpMapper followUpMapper;
+```
+
+Spring `@Resource` **按 bean 名优先解析**。MyBatis-Plus 已将**既有** `FollowUpMapper` 接口注册为 bean 名
+`followUpMapper`(接口简单名首字母小写),故 Spring 将类型为 `FollowUpMapper` 的 JDK 代理
+(`$Proxy388/$Proxy389`)注入到类型为 `ButlerResourceFollowUpMapper` 的字段 → 类型不匹配
+`BeanNotOfRequiredTypeException` → Spring 上下文初始化取消 → `APPLICATION FAILED TO START`。
+
+`git merge-base --is-ancestor d363df8056 4c0ff6729` → 成立,即目标提交**确含**该缺陷;
+`git diff 4c0ff6729 origin/cfclub -- ButlerResourceMatchService.java` → 0 行(缺陷在 origin HEAD `3afa2ef28` 仍存在,未在提交线内修复)。
+
+## 部署证据
+
+| 项 | 值 |
+|----|----|
+| 目标提交 | `4c0ff672994a3f7f5081604dc7968b01a4afe13c`(S-cfc-369:AssessmentAppointmentController +21/-1、AssessmentAppointmentService +18,合计 2 文件 +38/-1;authored 2026-11-14 15:55:22 +0800) |
+| 实际线上 commit | `c2180785a3e186bbff59798a594beb8e5a0cef7e`(Merge 2026-11-14 14:27:09,构建 14:31,14:36 安装、14:37 健康通过的最后一次成功启动版) |
+| 线上 JAR(state md5 与磁盘一致) | md5 `2e116d30e16cc6d4b215f99999c3892f`,类时间戳 2026-11-14 14:31 |
+| 祖先关系 | `git merge-base --is-ancestor 4c0ff6729 c2180785` → **不成立**(目标改动不在运行版中) |
+| 目标是否在运行 JAR | **否**:`javap -p` 运行 JAR 的 `AssessmentAppointmentService.class` 无 `requireBoundPlanner` 方法(0 处);常量池无 `guideFamilyService`/`请先绑定规划师`/`isBound` 字符串;JAR 内 `ButlerResourceMatch*` 类 0 个(运行版早于缺陷与目标) |
+| 缺陷祖先关系 | `git merge-base --is-ancestor d363df8056 4c0ff6729` → 成立(目标提交含缺陷) |
+| 缺陷字节一致性 | `git diff 4c0ff6729 origin/cfclub -- ButlerResourceMatchService.java` → 0 行(缺陷未在提交线内修复,origin HEAD `3afa2ef28` 仍带病) |
+| 部署链失败证据 | `/home/iwt/cfc-deploy.log`:自 14:31 起每轮(14:45/14:55/15:05/.../20:06/21:45/22:06/22:14)安装新 JAR → 启动失败(`butlerResourceMatchService` bean 注入异常 `BeanNotOfRequiredTypeException: Bean named 'followUpMapper' ... $Proxy388`)→ 回滚至上一版健康 JAR |
+| 最近一轮(22:08-22:14) | 部署链检测 origin/cfclub 推进至 `0875a19e3`(含目标提交),22:13:37 装新 JAR → 22:14:03 进程 2247521 启动后退出(同上 bean 异常)→ 22:14:10 回滚启动 PID=2251841 → 22:14:37 健康通过(401) → 22:14:40 state 记录 |
+| 运行进程 | PID=2251841(22:14:10 启动,健康通过),`java -Xms512m -Xmx1024m -jar /sc-data/springboot/cfc/cfc-backend-1.0.0.jar` |
+
+## 健康回执(回执出具时直连探测,2026-11-14 22:25 前后)
+
+| 目标 | 探测 | 结果 |
+|------|------|------|
+| 后端(部署基线) | `POST http://localhost:9082/api/admin/foods/list` | 401(无 token 预期)✓ |
+| 管理端 | `http://localhost/admin/`(Host: cfc.iwintrue.com) | 200 ✓ |
+| 小程序 H5 | `http://localhost/frontend/`(Host: cfc.iwintrue.com) | 200 ✓ |
+| 后端 JAR 状态 | md5 `2e116d30...` = state `backend_jar_md5` | 一致 ✓ |
+
+## 状态文件失真说明(部署脚本既有缺陷,需知悉)
+
+`/home/iwt/.cfc-deploy-state` 当前 `last_commit=cdf81991bf904a557f5e2150fbdf3036e3b8e909`(`chore: auto bump version and changelog`,2026-11-14 21:46:30),**非真实运行版本**。部署脚本回滚路径将 `ACTUAL_COMMIT` 置为 `$LAST_COMMIT`,随后 auto-bump 步骤又覆盖 `ACTUAL_COMMIT=$(git rev-parse HEAD)`,故 state 的 `last_commit` 为 auto-bump 提交,而线上实际 JAR 为 `c2180785` 构建(md5 `2e116d30...`)。判定线上版本必须以**线上 JAR md5 + JAR 内类字节码**为准,勿以 state `last_commit` 为准。
+
+## 后续处置(属研发侧,非本次部署职责)
+
+- 修复方向(已按 d363df8056 报告预案实施于共享工作区,但**尚未提交/推送**):`ButlerResourceMatchService.followUpMapper` 字段重命名为 `butlerResourceFollowUpMapper`(工作区已见,另 `HealthDataSourceBridgeService.dimensionScoreService` → `healthDimensionScoreService` 同类修复)。
+- 修复提交并推送 `origin/cfclub` 后,部署链 cron 才会自动构建部署;本轮部署链对带病提交的每轮尝试均正确回滚,未产生数据/服务损坏。
+- ⚠️ 目标 `4c0ff6729` 的 S-cfc-369 改动本身(`requireBoundPlanner`/`guideFamilyService`)不在线上;修复提交落地后需重新部署并复验。
+
+## 说明
+
+- 按编排要求,本次**未创建/修改/写入** `.workbuddy/tasks.json`,未写 `last_deployed`;
+  `--deploy-done testing --commit <sha>` 由编排侧/负责人在**主分支目录**统一落盘,本会话不处理。
+- 部署链路:`/home/iwt/cfc-deploy-251.sh`(origin/cfclub 更新检测 → 纯净 worktree 构建 → JAR 校验 →
+  停旧进程 → 装新 JAR → 启动健康检查 → 前端/H5 产物部署 → 最终验证 → auto-bump 回写 + 写 state)。
+- **实际部署成功的 commit hash(供编排侧 `--deploy-done` 落盘):无**(目标未部署成功,部署链自动回滚;
+  线上维持 `c2180785a3e186bbff59798a594beb8e5a0cef7e` 构建)。