feat: 章鱼图感恩记录增强 - 关键人新字段/手机号匹配/能量奖励/自动感恩记录

1. 关键人新增字段：
   - first_meet_time 相识具体时间（date picker）
   - referrer_id 介绍人（从现有关键人下拉选择，可为空仅可选）
   - system_user_id 匹配到的系统用户ID（持久化匹配状态）

2. 手机号匹配系统用户：
   - 新增 POST /api/octopus/key-person/match-by-phone
   - 新增 POST /api/octopus/key-person/bind-system-user（持久化绑定）
   - 前端 octopus-add-effect.vue 增加手机号匹配输入框 + KP 匹配按钮 + '✓ 系统用户'徽标
   - 章鱼图弹窗关键人列表显示系统用户徽标

3. 行维度能量奖励：
   - 每填一条感恩记录 +1 点行维度能量，逢5条再+1（KeyPersonService.addEffect）

4. 自动感恩记录（CF 触发）：
   - CfCommissionService 推荐人分润成功后自动创建 OctopusEffectRecord
   - 将买家自动建为邀请人关键人，CF金额作为成效金额

5. 数据库迁移342：octopus_key_person 添加 first_meet_time/referrer_id/system_user_id 列（schema.sql 同步）

验证：后端编译通过（仅剩既有 McpController 缺失 McpAuthService 的预存错误）；前端语法 OK；API 去重审计 0 error

cfc-backend/src/main/java/com/etotem/cfc/config/DatabaseInitializer.java

@@ -11487,6 +11487,14 @@ log.info("迁移298: 已为无 openid 的 child 账号补齐 family_members 记
         }
 
         ensureColumn("article_reading_records", "reading_completed", "TINYINT DEFAULT 0 COMMENT '是否已阅读达标（达到最低时长阈值）'");
+
+        // 迁移342: octopus_key_person 添加 first_meet_time / referrer_id / system_user_id 列（感恩记录新增字段）
+        ensureColumn("octopus_key_person", "first_meet_time", "DATETIME COMMENT '相识具体时间'");
+        log.info("迁移342: octopus_key_person.first_meet_time 列已添加");
+        ensureColumn("octopus_key_person", "referrer_id", "BIGINT DEFAULT NULL COMMENT '介绍人关键人ID（指向同用户另一条关键人）'");
+        log.info("迁移342: octopus_key_person.referrer_id 列已添加");
+        ensureColumn("octopus_key_person", "system_user_id", "BIGINT DEFAULT NULL COMMENT '匹配到的系统用户ID（如有）'");
+        log.info("迁移342: octopus_key_person.system_user_id 列已添加");
     }
 
     /**

cfc-backend/src/main/java/com/etotem/cfc/controller/KeyPersonController.java

@@ -1,6 +1,7 @@
 package com.etotem.cfc.controller;
 
 import com.etotem.cfc.common.Result;
+import com.etotem.cfc.entity.OctopusKeyPerson;
 import com.etotem.cfc.service.KeyPersonService;
 import org.springframework.web.bind.annotation.*;
 
@@ -74,16 +75,19 @@ public class KeyPersonController {
     // ===== 2. 找关键人 =====
     @PostMapping("/key-person/add")
     public Result<com.etotem.cfc.entity.OctopusKeyPerson> addKeyPerson(@RequestBody Map<String, Object> params,
-                                                                       @RequestAttribute("userId") Long userId) {
+                                                                        @RequestAttribute("userId") Long userId) {
         String name = (String) params.get("name");
         String organization = (String) params.get("organization");
         String department = (String) params.get("department");
         String title = (String) params.get("title");
         String firstMeetScene = (String) params.get("firstMeetScene");
+        String firstMeetTime = (String) params.get("firstMeetTime");
         String knowWay = (String) params.get("knowWay");
         String contactInfo = (String) params.get("contactInfo");
+        Long referrerId = params.get("referrerId") != null
+                ? Long.valueOf(params.get("referrerId").toString()) : null;
         return keyPersonService.addKeyPerson(userId, name, organization, department, title,
-                firstMeetScene, knowWay, contactInfo);
+                firstMeetScene, firstMeetTime, knowWay, contactInfo, referrerId);
     }
 
     @PostMapping("/key-person/update")
@@ -123,4 +127,23 @@ public class KeyPersonController {
     public Result<List<Map<String, Object>>> expansionSuggest(@RequestAttribute("userId") Long userId) {
         return keyPersonService.expansionSuggest(userId);
     }
+
+    /** 通过手机号匹配系统内用户（用于关键人绑定真实用户） */
+    @PostMapping("/key-person/match-by-phone")
+    public Result<Map<String, Object>> matchKeyPersonByPhone(@RequestBody Map<String, Object> params,
+                                                              @RequestAttribute("userId") Long userId) {
+        String phone = params.get("phone") != null ? params.get("phone").toString().trim() : null;
+        return keyPersonService.matchKeyPersonByPhone(userId, phone);
+    }
+
+    /** 将关键人与系统用户绑定（持久化匹配状态） */
+    @PostMapping("/key-person/bind-system-user")
+    public Result<OctopusKeyPerson> bindSystemUser(@RequestBody Map<String, Object> params,
+                                                    @RequestAttribute("userId") Long userId) {
+        Long keyPersonId = params.get("keyPersonId") != null
+                ? Long.valueOf(params.get("keyPersonId").toString()) : null;
+        Long systemUserId = params.get("systemUserId") != null
+                ? Long.valueOf(params.get("systemUserId").toString()) : null;
+        return keyPersonService.bindSystemUser(userId, keyPersonId, systemUserId);
+    }
 }

cfc-backend/src/main/java/com/etotem/cfc/entity/OctopusKeyPerson.java

@@ -31,6 +31,12 @@ public class OctopusKeyPerson implements Serializable {
 
     private String contactInfo;
 
+    private Date firstMeetTime;
+
+    private Long referrerId;
+
+    private Long systemUserId; // 匹配到的系统用户ID（如有）
+
     private Date createdAt;
 
     // 非持久化：角色名

cfc-backend/src/main/java/com/etotem/cfc/service/CfCommissionService.java

@@ -3,10 +3,16 @@ package com.etotem.cfc.service;
 import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
 import com.etotem.cfc.entity.CfRateTier;
 import com.etotem.cfc.entity.CfTransferRecord;
+import com.etotem.cfc.entity.OctopusEffectKeyPerson;
+import com.etotem.cfc.entity.OctopusEffectRecord;
+import com.etotem.cfc.entity.OctopusKeyPerson;
 import com.etotem.cfc.entity.Product;
 import com.etotem.cfc.entity.ReferralTree;
 import com.etotem.cfc.entity.User;
 import com.etotem.cfc.mapper.CfTransferRecordMapper;
+import com.etotem.cfc.mapper.OctopusEffectKeyPersonMapper;
+import com.etotem.cfc.mapper.OctopusEffectRecordMapper;
+import com.etotem.cfc.mapper.OctopusKeyPersonMapper;
 import com.etotem.cfc.mapper.ProductMapper;
 import com.etotem.cfc.mapper.ReferralTreeMapper;
 import com.etotem.cfc.mapper.UserMapper;
@@ -49,6 +55,12 @@ public class CfCommissionService {
     private SysConfigService sysConfigService;
     @Resource
     private ProductMapper productMapper;
+    @Resource
+    private OctopusKeyPersonMapper octopusKeyPersonMapper;
+    @Resource
+    private OctopusEffectRecordMapper octopusEffectRecordMapper;
+    @Resource
+    private OctopusEffectKeyPersonMapper octopusEffectKeyPersonMapper;
 
     /**
      * 通用分佣（双返）：当前人 + 推荐人
@@ -148,6 +160,8 @@ public class CfCommissionService {
                 platformPointsService.earn(referrerId, share, "referral_dist", orderId,
                         "推荐分润:" + orderType);
                 record(referrerId, null, referrer.getFamilyId(), share, "allocate", "referral_dist", orderId, "推荐分润");
+                // 自动创建感恩记录：邀请人的被邀请人购买后，记录为关键人关系
+                autoCreateGratitudeEffect(referrerId, buyerUserId, share, orderId);
             } catch (Exception e) {
                 log.error("推荐人分润失败: referrer={}, orderId={}, err={}", referrerId, orderId, e.getMessage());
             }
@@ -199,4 +213,68 @@ public class CfCommissionService {
             log.warn("写流转记录失败: {}", e.getMessage());
         }
     }
+
+    /**
+     * 当邀请人的被邀请人（系统用户）消费产生 CF 时，自动在邀请人侧创建感恩记录。
+     * 将买家作为关键人，CF 金额作为成效金额，角色固定为"其他"。
+     */
+    private void autoCreateGratitudeEffect(Long referrerId, Long buyerUserId, int cfAmount, Long orderId) {
+        try {
+            // 1. 查找或创建买家为关键人
+            Long buyerKeyPersonId = findOrCreateBuyerKeyPerson(referrerId, buyerUserId);
+            if (buyerKeyPersonId == null) return;
+
+            // 2. 创建 OctopusEffectRecord
+            OctopusEffectRecord effect = new OctopusEffectRecord();
+            effect.setUserId(referrerId);
+            effect.setMemberOrderId(orderId);
+            effect.setEffectType(4); // 新成交
+            effect.setEffectAmount(java.math.BigDecimal.valueOf(cfAmount));
+            effect.setEffectDesc("邀请人消费返CF:" + cfAmount + "分");
+            effect.setStatus(1);
+            effect.setCreatedAt(new Date());
+            octopusEffectRecordMapper.insert(effect);
+
+            // 3. 关联关键人
+            OctopusEffectKeyPerson rel = new OctopusEffectKeyPerson();
+            rel.setEffectId(effect.getId());
+            rel.setKeyPersonId(buyerKeyPersonId);
+            rel.setRole(3); // 其他
+            rel.setCreatedAt(new Date());
+            octopusEffectKeyPersonMapper.insert(rel);
+        } catch (Exception e) {
+            log.warn("自动创建感恩记录失败: referrerId={}, orderId={}, err={}", referrerId, orderId, e.getMessage());
+        }
+    }
+
+    private Long findOrCreateBuyerKeyPerson(Long referrerId, Long buyerUserId) {
+        // 查找是否已有关键人关联到该 buyerUserId
+        List<OctopusKeyPerson> existing = octopusKeyPersonMapper.selectList(
+                new LambdaQueryWrapper<OctopusKeyPerson>()
+                        .eq(OctopusKeyPerson::getUserId, referrerId)
+                        .eq(OctopusKeyPerson::getContactInfo, resolveBuyerPhone(buyerUserId)));
+        if (!existing.isEmpty()) return existing.get(0).getId();
+
+        // 查找用户信息
+        User buyer = userMapper.selectById(buyerUserId);
+        if (buyer == null) return null;
+
+        // 创建关键人
+        OctopusKeyPerson kp = new OctopusKeyPerson();
+        kp.setUserId(referrerId);
+        kp.setName(buyer.getNickname() != null ? buyer.getNickname() : "用户" + buyerUserId);
+        kp.setContactInfo(buyer.getPhone());
+        kp.setCreatedAt(new Date());
+        octopusKeyPersonMapper.insert(kp);
+        return kp.getId();
+    }
+
+    private String resolveBuyerPhone(Long buyerUserId) {
+        try {
+            User u = userMapper.selectById(buyerUserId);
+            return u != null ? u.getPhone() : null;
+        } catch (Exception e) {
+            return null;
+        }
+    }
 }

cfc-backend/src/main/java/com/etotem/cfc/service/KeyPersonService.java

@@ -3,12 +3,16 @@ package com.etotem.cfc.service;
 import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
 import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
 import com.etotem.cfc.common.Result;
+import com.etotem.cfc.entity.FamilyMember;
 import com.etotem.cfc.entity.OctopusEffectKeyPerson;
 import com.etotem.cfc.entity.OctopusEffectRecord;
 import com.etotem.cfc.entity.OctopusKeyPerson;
+import com.etotem.cfc.entity.User;
+import com.etotem.cfc.mapper.FamilyMemberMapper;
 import com.etotem.cfc.mapper.OctopusEffectKeyPersonMapper;
 import com.etotem.cfc.mapper.OctopusEffectRecordMapper;
 import com.etotem.cfc.mapper.OctopusKeyPersonMapper;
+import com.etotem.cfc.mapper.UserMapper;
 import org.springframework.stereotype.Service;
 
 import javax.annotation.Resource;
@@ -25,6 +29,12 @@ public class KeyPersonService {
     private OctopusKeyPersonMapper keyPersonMapper;
     @Resource
     private OctopusEffectKeyPersonMapper ekpMapper;
+    @Resource
+    private UserMapper userMapper;
+    @Resource
+    private FamilyMemberMapper familyMemberMapper;
+    @Resource
+    private EnergyService energyService;
 
     // ========== 1. 盘点项目 ==========
 
@@ -174,6 +184,21 @@ public class KeyPersonService {
                 ekpMapper.insert(rel);
             }
         }
+        // 行维度能量奖励：每填一条感恩记录 +1，逢5条再额外+1
+        try {
+            Long newCount = effectRecordMapper.selectCount(
+                    new LambdaQueryWrapper<OctopusEffectRecord>().eq(OctopusEffectRecord::getUserId, userId));
+            int bonus = 1;
+            if (newCount != null && newCount % 5 == 0) bonus++;
+            // 查找当前用户的 family_member 记录作为 memberId
+            List<FamilyMember> members = familyMemberMapper.selectList(
+                    new LambdaQueryWrapper<FamilyMember>().eq(FamilyMember::getUserId, userId).last("LIMIT 1"));
+            if (!members.isEmpty()) {
+                energyService.awardEnergyByCode(members.get(0).getId(), "action", bonus, "填写感恩记录奖励");
+            }
+        } catch (Exception e) {
+            log.warn("发放感恩记录能量奖励失败 userId={}: {}", userId, e.getMessage());
+        }
         return Result.success(r);
     }
 
@@ -198,6 +223,13 @@ public class KeyPersonService {
                         .orderByDesc(OctopusKeyPerson::getCreatedAt)
         );
         List<Map<String, Object>> list = new ArrayList<>();
+        Map<Long, String> refNameMap = new HashMap<>();
+        for (OctopusKeyPerson kp : kps) {
+            if (kp.getReferrerId() != null) {
+                OctopusKeyPerson ref = keyPersonMapper.selectById(kp.getReferrerId());
+                if (ref != null) refNameMap.put(kp.getReferrerId(), ref.getName());
+            }
+        }
         for (OctopusKeyPerson kp : kps) {
             Map<String, Object> m = new LinkedHashMap<>();
             m.put("id", kp.getId());
@@ -206,18 +238,73 @@ public class KeyPersonService {
             m.put("department", kp.getDepartment());
             m.put("title", kp.getTitle());
             m.put("firstMeetScene", kp.getFirstMeetScene());
+            m.put("firstMeetTime", kp.getFirstMeetTime() != null ? kp.getFirstMeetTime().toString() : "");
             m.put("knowWay", kp.getKnowWay());
             m.put("contactInfo", kp.getContactInfo());
+            m.put("referrerId", kp.getReferrerId());
+            m.put("referrerName", kp.getReferrerId() != null ? refNameMap.get(kp.getReferrerId()) : "");
+            m.put("systemUserId", kp.getSystemUserId());
+            m.put("matched", kp.getSystemUserId() != null);
             m.put("createdAt", kp.getCreatedAt() != null ? kp.getCreatedAt().toString() : "");
             list.add(m);
         }
         return Result.success(list);
     }
 
-    public Result<OctopusKeyPerson> addKeyPerson(Long userId, String name, String organization,
+    /** 通过手机号匹配系统内用户（用于关键人绑定真实用户） */
+    public Result<Map<String, Object>> matchKeyPersonByPhone(Long userId, String phone) {
+        if (phone == null || phone.trim().isEmpty()) {
+            return Result.error("手机号不能为空");
+        }
+        phone = phone.trim();
+        // 1. 查 users 表
+        List<User> users = userMapper.selectList(
+                new LambdaQueryWrapper<User>().eq(User::getPhone, phone).last("LIMIT 1")
+        );
+        User matchedUser = (users != null && !users.isEmpty()) ? users.get(0) : null;
+        Map<String, Object> data = new LinkedHashMap<>();
+        if (matchedUser != null) {
+            data.put("userId", matchedUser.getId());
+            data.put("nickname", matchedUser.getNickname());
+            data.put("realName", matchedUser.getRealName());
+            data.put("avatar", matchedUser.getAvatar());
+            data.put("familyId", matchedUser.getFamilyId());
+            data.put("phone", matchedUser.getPhone());
+            // 尝试通过家庭成员表找到 memberId（能力图/能量发放需要）
+            if (matchedUser.getFamilyId() != null) {
+                List<FamilyMember> members = familyMemberMapper.selectList(
+                        new LambdaQueryWrapper<FamilyMember>()
+                                .eq(FamilyMember::getFamilyId, matchedUser.getFamilyId())
+                                .eq(FamilyMember::getUserId, matchedUser.getId())
+                                .last("LIMIT 1")
+                );
+                if (members != null && !members.isEmpty()) {
+                    data.put("memberId", members.get(0).getId());
+                    data.put("memberName", members.get(0).getNickname());
+                }
+            }
+            data.put("systemUserId", matchedUser.getId());
+        }
+        data.put("matched", matchedUser != null);
+        return Result.success(data);
+    }
+
+    /** 将关键人与系统用户绑定（持久化匹配状态） */
+    public Result<OctopusKeyPerson> bindSystemUser(Long userId, Long keyPersonId, Long systemUserId) {
+        OctopusKeyPerson kp = keyPersonMapper.selectById(keyPersonId);
+        if (kp == null || !kp.getUserId().equals(userId)) {
+            return Result.error("关键人不存在或无权操作");
+        }
+        kp.setSystemUserId(systemUserId);
+        keyPersonMapper.updateById(kp);
+        return Result.success(kp);
+    }
+
+public Result<OctopusKeyPerson> addKeyPerson(Long userId, String name, String organization,
                                                  String department, String title,
-                                                 String firstMeetScene, String knowWay,
-                                                 String contactInfo) {
+                                                 String firstMeetScene, String firstMeetTime,
+                                                 String knowWay, String contactInfo,
+                                                 Long referrerId) {
         if (name == null || name.trim().isEmpty()) {
             return Result.error("关键人姓名不能为空");
         }
@@ -228,8 +315,10 @@ public class KeyPersonService {
         kp.setDepartment(department != null ? department.trim() : null);
         kp.setTitle(title != null ? title.trim() : null);
         kp.setFirstMeetScene(firstMeetScene != null ? firstMeetScene.trim() : null);
+        kp.setFirstMeetTime(firstMeetTime != null ? java.sql.Timestamp.valueOf(firstMeetTime) : null);
         kp.setKnowWay(knowWay != null ? knowWay.trim() : null);
         kp.setContactInfo(contactInfo != null ? contactInfo.trim() : null);
+        kp.setReferrerId(referrerId);
         kp.setCreatedAt(new Date());
         keyPersonMapper.insert(kp);
         return Result.success(kp);
@@ -292,6 +381,8 @@ public class KeyPersonService {
             m.put("contactInfo", kp.getContactInfo());
             m.put("role", roleMap.get(kpId));
             m.put("roleName", roleName(roleMap.get(kpId)));
+            m.put("systemUserId", kp.getSystemUserId());
+            m.put("matched", kp.getSystemUserId() != null);
             m.put("createdAt", kp.getCreatedAt() != null ? kp.getCreatedAt().toString() : "");
             list.add(m);
         }

cfc-backend/src/main/resources/schema.sql

@@ -5382,6 +5382,9 @@ CREATE TABLE IF NOT EXISTS octopus_key_person (
     first_meet_scene VARCHAR(128) COMMENT '初识场合',
     know_way VARCHAR(255) COMMENT '如何认识（认识路径）',
     contact_info VARCHAR(255) COMMENT '联系方式（可选）',
+    first_meet_time DATETIME DEFAULT NULL COMMENT '相识具体时间',
+    referrer_id BIGINT DEFAULT NULL COMMENT '介绍人关键人ID（指向同用户另一条关键人）',
+    system_user_id BIGINT DEFAULT NULL COMMENT '匹配到的系统用户ID（如有）',
     created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
     INDEX idx_okp_user (user_id),
     INDEX idx_okp_org (organization)

cfc-frontend/pages/action-detail/components/OctopusDiagram.vue

@@ -21,9 +21,10 @@
         </view>
         <view class="popup-keypersons" v-if="keyPersons[selectedEffect.id] && keyPersons[selectedEffect.id].length > 0">
           <text class="popup-title">关键人</text>
-          <text class="kp-item" v-for="kp in keyPersons[selectedEffect.id]" :key="kp.id">
-            {{ kp.name }} · {{ kp.title || kp.organization || '' }}
-          </text>
+          <view class="kp-item-row" v-for="kp in keyPersons[selectedEffect.id]" :key="kp.id">
+            <text class="kp-item">{{ kp.name }} · {{ kp.title || kp.organization || '' }}</text>
+            <text class="kp-sys-badge" v-if="kp.matched">✓ 系统用户</text>
+          </view>
         </view>
         <view class="popup-empty" v-else>
           <text class="empty-text">暂无关键人，点击添加</text>
@@ -663,6 +664,19 @@ export default {
   display: block;
   margin-bottom: 4rpx;
 }
+.kp-item-row {
+  display: flex;
+  align-items: center;
+  gap: 8rpx;
+}
+.kp-sys-badge {
+  font-size: 18rpx;
+  color: #10B981;
+  background: #ECFDF5;
+  padding: 2rpx 10rpx;
+  border-radius: 6rpx;
+  flex-shrink: 0;
+}
 .popup-empty {
   padding: 8rpx 0;
 }

cfc-frontend/pages/action-detail/octopus-add-effect.vue

@@ -44,6 +44,9 @@
             <text class="kp-name">{{ kp.name }}</text>
             <text class="kp-org">{{ kp.organization || kp.title || '' }}</text>
           </view>
+          <!-- 已有联系方式 → 可匹配系统用户 -->
+          <text class="kp-match-btn" v-if="kp.contactInfo" @click.stop="onMatchByPhone(kp)">匹配用户</text>
+          <text class="kp-sys-badge" v-if="kp.matched">✓ 系统用户</text>
           <!-- 角色选择（选中时显示） -->
           <view class="kp-role" v-if="selectedMap[kp.id]" @click.stop>
             <text class="role-tag" :class="{active: roleMap[kp.id] === 1}" @click="setRole(kp.id, 1)">引荐</text>
@@ -55,6 +58,16 @@
       <text class="empty-hint" v-else>暂无关键人，点击「+ 新建」添加</text>
     </view>
 
+    <!-- 按手机号快速建关键人 -->
+    <view class="form-section">
+      <text class="section-label">手机号匹配（选填）</text>
+      <view class="phone-match-row">
+        <input class="phone-input" v-model="matchPhone" placeholder="输入手机号自动匹配" maxlength="11" type="number" />
+        <text class="phone-match-btn" @tap="doPhoneMatch">匹配</text>
+      </view>
+      <text class="phone-match-result" v-if="matchResult">{{ matchResult }}</text>
+    </view>
+
     <!-- 提交按钮 -->
     <view class="submit-bar">
       <button class="btn-submit" @click="onSubmit" :disabled="!canSubmit">保存感恩记录</button>
@@ -63,7 +76,7 @@
 </template>
 
 <script>
-import { addOctopusEffect, getOctopusKeyPersons } from '../../utils/api.js'
+import { addOctopusEffect, getOctopusKeyPersons, matchOctopusKeyPersonByPhone, bindOctopusKeyPersonSystemUser } from '../../utils/api.js'
 
 export default {
   data() {
@@ -81,7 +94,9 @@ export default {
       keyPersons: [],
       selectedMap: {},   // kpId -> true
       roleMap: {},        // kpId -> role (1引荐/2决策/3其他)
-      _onLoadFired: false
+      _onLoadFired: false,
+      matchPhone: '',
+      matchResult: ''
     }
   },
   computed: {
@@ -109,6 +124,43 @@ export default {
         }
       } catch (e) { /* 静默 */ }
     },
+    /** 按关键人联系方式匹配系统用户 */
+    onMatchByPhone: function(kp) {
+      if (!kp.contactInfo) return
+      this.doPhoneMatchInternal(kp.contactInfo, kp.id)
+    },
+    /** 手机号匹配输入框触发 */
+    doPhoneMatch: function() {
+      var phone = this.matchPhone.trim()
+      if (!phone) {
+        this.matchResult = '请输入手机号'
+        return
+      }
+      this.matchResult = '匹配中...'
+      this.doPhoneMatchInternal(phone, null)
+    },
+    async doPhoneMatchInternal(phone, kpId) {
+      try {
+        var res = await matchOctopusKeyPersonByPhone({ phone: phone })
+        if (res.code === 200 && res.data && res.data.matched) {
+          var matchedName = res.data.nickname || res.data.realName || res.data.memberName || ''
+          var extra = res.data.memberId ? ' (memberId:' + res.data.memberId + ')' : ''
+          this.matchResult = '已匹配: ' + matchedName + extra
+          if (kpId && res.data.systemUserId) {
+            // 持久化：将关键人与系统用户绑定
+            var bindRes = await bindOctopusKeyPersonSystemUser({ keyPersonId: kpId, systemUserId: res.data.systemUserId })
+            if (bindRes.code === 200) {
+              this.$set(this.keyPersons[this.keyPersons.findIndex(function(k) { return k.id === kpId })], 'matched', true)
+              this.matchResult = '已匹配并保存: ' + matchedName + extra
+            }
+          }
+        } else {
+          this.matchResult = res.message || '未找到该手机号对应的用户'
+        }
+      } catch (e) {
+        this.matchResult = '匹配失败，请稍后重试'
+      }
+    },
     goAddKeyPerson() {
       uni.navigateTo({ url: '/pages/action-detail/octopus-add-key-person' })
     },
@@ -249,6 +301,23 @@ export default {
   font-size: 22rpx;
   color: #999;
 }
+.kp-match-btn {
+  font-size: 22rpx;
+  color: #0EA5E9;
+  padding: 4rpx 12rpx;
+  border: 1rpx solid #0EA5E9;
+  border-radius: 8rpx;
+  background: #F0F9FF;
+  flex-shrink: 0;
+}
+.kp-sys-badge {
+  font-size: 20rpx;
+  color: #10B981;
+  background: #ECFDF5;
+  padding: 2rpx 12rpx;
+  border-radius: 6rpx;
+  margin-left: 8rpx;
+}
 .kp-role {
   display: flex;
   margin-top: 12rpx;
@@ -306,4 +375,35 @@ export default {
   font-size: 28rpx;
   color: #ccc;
 }
+/* 手机号匹配 */
+.phone-match-row {
+  display: flex;
+  align-items: center;
+  gap: 16rpx;
+}
+.phone-input {
+  flex: 1;
+  height: 88rpx;
+  background: #fafafa;
+  border-radius: 12rpx;
+  padding: 0 20rpx;
+  font-size: 28rpx;
+  box-sizing: border-box;
+}
+.phone-match-btn {
+  padding: 0 28rpx;
+  height: 88rpx;
+  line-height: 88rpx;
+  background: #0EA5E9;
+  color: #fff;
+  border-radius: 12rpx;
+  font-size: 28rpx;
+  flex-shrink: 0;
+}
+.phone-match-result {
+  font-size: 24rpx;
+  color: #0EA5E9;
+  margin-top: 12rpx;
+  display: block;
+}
 </style>

cfc-frontend/pages/action-detail/octopus-add-key-person.vue

@@ -29,11 +29,28 @@
       <input class="name-input" v-model="firstMeetScene" placeholder="如：家长会、行业峰会、朋友介绍" maxlength="50" />
     </view>
 
+    <view class="form-section">
+      <text class="section-label">相识时间（选填）</text>
+      <picker mode="date" :value="firstMeetTime" @change="onDateChange">
+        <view class="form-picker">{{ firstMeetTime || '选择日期' }}</view>
+      </picker>
+    </view>
+
     <view class="form-section">
       <text class="section-label">如何认识</text>
       <textarea class="desc-input" v-model="knowWay" placeholder="如：孩子班主任介绍认识、同事推荐" maxlength="200"></textarea>
     </view>
 
+    <view class="form-section">
+      <text class="section-label">介绍人（选填，从现有关键人中选择）</text>
+      <view class="referrer-select" v-if="existingKeyPersons.length > 0" @tap="showReferrerPicker = true">
+        <text class="referrer-selected" v-if="referrerId">{{ getReferrerName(referrerId) }}</text>
+        <text class="referrer-placeholder" v-else>选择介绍人...</text>
+        <text class="picker-arrow">›</text>
+      </view>
+      <text class="empty-referrer" v-else>暂无其他关键人可作为介绍人</text>
+    </view>
+
     <view class="form-section">
       <text class="section-label">联系方式（选填）</text>
       <input class="name-input" v-model="contactInfo" placeholder="电话/微信/邮箱" maxlength="50" />
@@ -42,11 +59,28 @@
     <view class="submit-bar">
       <button class="btn-submit" @click="onSubmit" :disabled="!name.trim()">保存关键人</button>
     </view>
+
+    <!-- 介绍人选择弹窗 -->
+    <view class="referrer-modal-mask" v-if="showReferrerPicker" @tap="showReferrerPicker = false">
+      <view class="referrer-modal" @tap.stop>
+        <view class="referrer-modal-header">
+          <text class="referrer-modal-title">选择介绍人</text>
+          <text class="referrer-modal-close" @tap="showReferrerPicker = false">✕</text>
+        </view>
+        <view class="referrer-option" @tap="selectReferrer(null)">
+          <text>不选择</text>
+        </view>
+        <view class="referrer-option" v-for="kp in existingKeyPersons" :key="kp.id" @tap="selectReferrer(kp.id)">
+          <text class="referrer-option-name">{{ kp.name }}</text>
+          <text class="referrer-option-org">{{ kp.organization || kp.title || '' }}</text>
+        </view>
+      </view>
+    </view>
   </view>
 </template>
 
 <script>
-import { addOctopusKeyPerson } from '../../utils/api.js'
+import { addOctopusKeyPerson, getOctopusKeyPersons } from '../../utils/api.js'
 
 export default {
   data() {
@@ -56,8 +90,12 @@ export default {
       department: '',
       title: '',
       firstMeetScene: '',
+      firstMeetTime: '',
       knowWay: '',
-      contactInfo: ''
+      contactInfo: '',
+      referrerId: null,
+      existingKeyPersons: [],
+      showReferrerPicker: false
     }
   },
   onLoad(options) {
@@ -67,8 +105,30 @@ export default {
         Object.assign(this.$data, prefill)
       } catch (e) { /* 忽略 */ }
     }
+    this.loadExistingKeyPersons()
   },
   methods: {
+    async loadExistingKeyPersons() {
+      try {
+        var res = await getOctopusKeyPersons()
+        if (res.code === 200 && Array.isArray(res.data)) {
+          this.existingKeyPersons = res.data
+        }
+      } catch (e) { /* 静默 */ }
+    },
+    getReferrerName(id) {
+      for (var i = 0; i < this.existingKeyPersons.length; i++) {
+        if (this.existingKeyPersons[i].id === id) return this.existingKeyPersons[i].name
+      }
+      return ''
+    },
+    selectReferrer(id) {
+      this.referrerId = id
+      this.showReferrerPicker = false
+    },
+    onDateChange(e) {
+      this.firstMeetTime = e.detail.value
+    },
     async onSubmit() {
       if (!this.name.trim()) {
         uni.showToast({ title: '请填写姓名', icon: 'none' })
@@ -80,8 +140,10 @@ export default {
         department: this.department.trim(),
         title: this.title.trim(),
         firstMeetScene: this.firstMeetScene.trim(),
+        firstMeetTime: this.firstMeetTime,
         knowWay: this.knowWay.trim(),
-        contactInfo: this.contactInfo.trim()
+        contactInfo: this.contactInfo.trim(),
+        referrerId: this.referrerId || null
       }
       try {
         var res = await addOctopusKeyPerson(data)
@@ -147,6 +209,100 @@ export default {
   font-size: 28rpx;
   box-sizing: border-box;
 }
+.form-picker {
+  width: 100%;
+  height: 88rpx;
+  background: #fafafa;
+  border-radius: 12rpx;
+  padding: 0 20rpx;
+  font-size: 28rpx;
+  color: #333;
+  display: flex;
+  align-items: center;
+  box-sizing: border-box;
+}
+/* 介绍人选择器 */
+.referrer-select {
+  height: 88rpx;
+  background: #fafafa;
+  border-radius: 12rpx;
+  padding: 0 20rpx;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  box-sizing: border-box;
+}
+.referrer-selected {
+  font-size: 28rpx;
+  color: #F97316;
+}
+.referrer-placeholder {
+  font-size: 28rpx;
+  color: #ccc;
+}
+.picker-arrow {
+  font-size: 32rpx;
+  color: #999;
+}
+.empty-referrer {
+  font-size: 26rpx;
+  color: #999;
+}
+/* 介绍人弹窗 */
+.referrer-modal-mask {
+  position: fixed;
+  top: 0;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  background: rgba(0,0,0,0.4);
+  display: flex;
+  align-items: flex-end;
+  z-index: 100;
+}
+.referrer-modal {
+  background: #fff;
+  border-radius: 24rpx 24rpx 0 0;
+  width: 100%;
+  max-height: 60vh;
+  overflow-y: auto;
+  padding-bottom: env(safe-area-inset-bottom);
+}
+.referrer-modal-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  padding: 24rpx 28rpx;
+  border-bottom: 1rpx solid #E5E7EB;
+  position: sticky;
+  top: 0;
+  background: #fff;
+}
+.referrer-modal-title {
+  font-size: 30rpx;
+  font-weight: bold;
+  color: #333;
+}
+.referrer-modal-close {
+  font-size: 32rpx;
+  color: #999;
+}
+.referrer-option {
+  padding: 24rpx 28rpx;
+  border-bottom: 1rpx solid #F3F4F6;
+}
+.referrer-option-name {
+  font-size: 28rpx;
+  color: #333;
+  font-weight: 500;
+  display: block;
+}
+.referrer-option-org {
+  font-size: 24rpx;
+  color: #999;
+  margin-top: 4rpx;
+  display: block;
+}
 .submit-bar {
   margin-top: 40rpx;
 }
@@ -162,4 +318,4 @@ export default {
 .btn-submit[disabled] {
   background: #ccc;
 }
-</style>
+</style>

cfc-frontend/utils/api.js

@@ -2483,6 +2483,8 @@ export const deleteOctopusEffect = (data) => request('/api/octopus/effect/delete
 
 export const addOctopusKeyPerson = (data) => request('/api/octopus/key-person/add', 'POST', data)
 export const getOctopusKeyPersons = (data) => request('/api/octopus/key-person/list', 'POST', data)
+export const matchOctopusKeyPersonByPhone = (data) => request('/api/octopus/key-person/match-by-phone', 'POST', data)
+export const bindOctopusKeyPersonSystemUser = (data) => request('/api/octopus/key-person/bind-system-user', 'POST', data)
 export const updateOctopusKeyPerson = (data) => request('/api/octopus/key-person/update', 'POST', data)
 export const deleteOctopusKeyPerson = (data) => request('/api/octopus/key-person/delete', 'POST', data)
 export const getOctopusEffectKeyPersons = (data) => request('/api/octopus/effect/key-persons', 'POST', data)