Преглед изворни кода

feat: 确定性差距修复 - P0全部 + P1部分 + P2/P3核心完成

已完成 (8/18):
P0: G7(FamilyAccessInterceptor), G1(五维能量分数持久化), G18(测评对比)
P1: G8(视角切换+密码校验), G9(邀请码过期/次数/吊销), G2(results_ready联动)
     新增: G10(规划师绑定家庭审批), G13(地址SFMS导入骨架), G14(Dify会话本地镜像)

P2: G23(schema_versions迁移表), G25(schema.sql新表补齐),
     G3(测评报告结构化 structured_analysis), G26(test-mode启动断言)

P3: G4(死字段标记deprecated), G27(sfms只读强制)

新增文件: TeacherFamilyBindingController/Service/Mapper/Entity,
          ChatConversation, ChatMessage, ChatMirrorService,
          SchemaVersion, PendingRefund服务(提现退款处理)

预留未完成(工作量过大): G15(饮食推荐规则层), G21(PDF多供应商), G22(前端mock)
Xiaogang Liao пре 4 месеци
родитељ
комит
f9a42fc956
27 измењених фајлова са 5270 додато и 2598 уклоњено
  1. 77 0
      cfc-backend/src/main/java/com/etotem/cfc/config/DatabaseInitializer.java
  2. 2 0
      cfc-backend/src/main/java/com/etotem/cfc/config/SfmsDataSourceConfig.java
  3. 19 0
      cfc-backend/src/main/java/com/etotem/cfc/controller/DanAssessmentController.java
  4. 46 4
      cfc-backend/src/main/java/com/etotem/cfc/controller/ai/AIChatController.java
  5. 19 30
      cfc-backend/src/main/java/com/etotem/cfc/controller/family/FamilyController.java
  6. 113 0
      cfc-backend/src/main/java/com/etotem/cfc/controller/family/TeacherFamilyBindingController.java
  7. 29 0
      cfc-backend/src/main/java/com/etotem/cfc/entity/ChatConversation.java
  8. 31 0
      cfc-backend/src/main/java/com/etotem/cfc/entity/ChatMessage.java
  9. 4 0
      cfc-backend/src/main/java/com/etotem/cfc/entity/DanAssessmentResult.java
  10. 60 0
      cfc-backend/src/main/java/com/etotem/cfc/entity/PendingRefund.java
  11. 37 0
      cfc-backend/src/main/java/com/etotem/cfc/entity/SchemaVersion.java
  12. 54 0
      cfc-backend/src/main/java/com/etotem/cfc/entity/TeacherFamilyBindingRequest.java
  13. 9 0
      cfc-backend/src/main/java/com/etotem/cfc/mapper/ChatConversationMapper.java
  14. 9 0
      cfc-backend/src/main/java/com/etotem/cfc/mapper/ChatMessageMapper.java
  15. 9 0
      cfc-backend/src/main/java/com/etotem/cfc/mapper/PendingRefundMapper.java
  16. 9 0
      cfc-backend/src/main/java/com/etotem/cfc/mapper/SchemaVersionMapper.java
  17. 9 0
      cfc-backend/src/main/java/com/etotem/cfc/mapper/TeacherFamilyBindingRequestMapper.java
  18. 28 0
      cfc-backend/src/main/java/com/etotem/cfc/service/AIService.java
  19. 119 0
      cfc-backend/src/main/java/com/etotem/cfc/service/ChatMirrorService.java
  20. 165 0
      cfc-backend/src/main/java/com/etotem/cfc/service/PendingRefundService.java
  21. 197 0
      cfc-backend/src/main/java/com/etotem/cfc/service/TeacherFamilyBindingRequestService.java
  22. 15 0
      cfc-backend/src/main/java/com/etotem/cfc/service/WechatService.java
  23. 64 1
      cfc-backend/src/main/java/com/etotem/cfc/service/WithdrawalService.java
  24. 158 0
      cfc-backend/src/main/java/com/etotem/cfc/task/RefundScheduledTasks.java
  25. 2619 2563
      cfc-backend/src/main/resources/schema.sql
  26. 1337 0
      docs/系统设计/家庭天盘设计方案.md
  27. 32 0
      tools/check-test-mode.ps1

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

@@ -5004,5 +5004,82 @@ try {
         // 迁移71: family_invitations表添加max_use_count和used_count列(G9 邀请次数控制)
         ensureColumn("family_invitations", "max_use_count", "INT DEFAULT 1 COMMENT '最大使用次数'");
         ensureColumn("family_invitations", "used_count", "INT DEFAULT 0 COMMENT '已使用次数'");
+
+        // 迁移72: 创建teacher_family_binding_requests表(G10 规划师绑定家庭审批)
+        try {
+            jdbcTemplate.execute("CREATE TABLE IF NOT EXISTS teacher_family_binding_requests (" +
+                    "id BIGINT AUTO_INCREMENT PRIMARY KEY, " +
+                    "teacher_id BIGINT NOT NULL COMMENT '规划师用户ID', " +
+                    "family_id BIGINT NOT NULL COMMENT '家庭ID', " +
+                    "invitation_token VARCHAR(128) COMMENT '关联邀请码/令牌', " +
+                    "status VARCHAR(20) NOT NULL DEFAULT 'pending' COMMENT 'pending/approved/rejected/cancelled', " +
+                    "requested_at DATETIME COMMENT '申请时间', " +
+                    "decided_by BIGINT COMMENT '审批人用户ID', " +
+                    "decided_at DATETIME COMMENT '审批时间', " +
+                    "reject_reason VARCHAR(200) COMMENT '拒绝原因', " +
+                    "message VARCHAR(500) COMMENT '申请留言', " +
+                    "created_at DATETIME DEFAULT CURRENT_TIMESTAMP, " +
+                    "updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, " +
+                    "UNIQUE KEY uk_teacher_family (teacher_id, family_id), " +
+                    "INDEX idx_family_status (family_id, status) " +
+                    ") ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='规划师绑定家庭申请表'");
+            log.info("已创建teacher_family_binding_requests表");
+        } catch (Exception e) {
+            log.warn("创建teacher_family_binding_requests表失败: {}", e.getMessage());
+        }
+
+        // 迁移73: 创建chat_conversations表(G14 Dify会话本地镜像)
+        try {
+            jdbcTemplate.execute("CREATE TABLE IF NOT EXISTS chat_conversations (" +
+                    "id BIGINT AUTO_INCREMENT PRIMARY KEY, " +
+                    "user_id BIGINT NOT NULL, " +
+                    "dify_conversation_id VARCHAR(64), " +
+                    "assistant_type VARCHAR(32) COMMENT 'family/nutrition/tongue', " +
+                    "title VARCHAR(200), " +
+                    "last_message_at DATETIME, " +
+                    "created_at DATETIME DEFAULT CURRENT_TIMESTAMP, " +
+                    "UNIQUE KEY uk_dify_conv (dify_conversation_id), " +
+                    "INDEX idx_user (user_id) " +
+                    ") ENGINE=InnoDB DEFAULT CHARSET=utf8mb4");
+            log.info("已创建chat_conversations表");
+        } catch (Exception e) {
+            log.warn("创建chat_conversations表失败: {}", e.getMessage());
+        }
+
+        // 迁移74: 创建chat_messages表(G14 Dify会话本地镜像)
+        try {
+            jdbcTemplate.execute("CREATE TABLE IF NOT EXISTS chat_messages (" +
+                    "id BIGINT AUTO_INCREMENT PRIMARY KEY, " +
+                    "conversation_id BIGINT NOT NULL, " +
+                    "dify_message_id VARCHAR(64), " +
+                    "role VARCHAR(20) NOT NULL COMMENT 'user/assistant', " +
+                    "content TEXT NOT NULL, " +
+                    "inputs_json TEXT, " +
+                    "metadata TEXT, " +
+                    "created_at DATETIME DEFAULT CURRENT_TIMESTAMP, " +
+                    "INDEX idx_conv (conversation_id) " +
+                    ") ENGINE=InnoDB DEFAULT CHARSET=utf8mb4");
+            log.info("已创建chat_messages表");
+        } catch (Exception e) {
+            log.warn("创建chat_messages表失败: {}", e.getMessage());
+        }
+
+        // 迁移75: 创建schema_versions表(G23 迁移版本追踪)
+        try {
+            jdbcTemplate.execute("CREATE TABLE IF NOT EXISTS schema_versions (" +
+                    "id BIGINT AUTO_INCREMENT PRIMARY KEY, " +
+                    "version_code VARCHAR(64) NOT NULL UNIQUE, " +
+                    "description VARCHAR(500), " +
+                    "checksum VARCHAR(64), " +
+                    "applied_at DATETIME DEFAULT CURRENT_TIMESTAMP, " +
+                    "applied_by VARCHAR(100) " +
+                    ") ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='迁移版本追踪表'");
+            log.info("已创建schema_versions表");
+        } catch (Exception e) {
+            log.warn("创建schema_versions表失败: {}", e.getMessage());
+        }
+
+        // 迁移76: DanAssessmentResult添加structured_analysis字段(G3)
+        ensureColumn("dan_assessment_results", "structured_analysis", "TEXT COMMENT '结构化分析JSON'");
         }
 }

+ 2 - 0
cfc-backend/src/main/java/com/etotem/cfc/config/SfmsDataSourceConfig.java

@@ -80,6 +80,8 @@ public class SfmsDataSourceConfig {
         config.setDriverClassName(sfmsDriverClassName);
         config.setMaximumPoolSize(5);
         config.setPoolName("SfmsHikariPool");
+        config.setReadOnly(true);
+        config.setConnectionInitSql("SET SESSION TRANSACTION READ ONLY");
         return new HikariDataSource(config);
     }
 

+ 19 - 0
cfc-backend/src/main/java/com/etotem/cfc/controller/DanAssessmentController.java

@@ -27,6 +27,8 @@ public class DanAssessmentController {
 
     @Resource
     private AssessmentPermissionService permissionService;
+    @Resource
+    private com.etotem.cfc.mapper.DanAssessmentResultMapper danAssessmentResultMapper;
 
     // ===== 测评材料 =====
 
@@ -251,4 +253,21 @@ public class DanAssessmentController {
     public Result<List<AssessmentOrder>> getFamilyOrders(@RequestParam Long familyId) {
         return Result.success(orderService.getFamilyOrders(familyId));
     }
+
+    // ===== 结构化报告 =====
+
+    @Operation(summary = "获取测评结果结构化分析")
+    @PostMapping("/results/{id}/structured")
+    public Result<Map<String, Object>> getStructuredResult(@PathVariable Long id) {
+        DanAssessmentResult result = danAssessmentResultMapper.selectById(id);
+        if (result == null) {
+            return Result.error("测评结果不存在");
+        }
+        Map<String, Object> data = new java.util.LinkedHashMap<>();
+        data.put("resultId", result.getId());
+        data.put("childName", result.getChildName());
+        data.put("assessmentDate", result.getAssessmentDate());
+        data.put("structuredAnalysis", result.getStructuredAnalysis());
+        return Result.success(data);
+    }
 }

+ 46 - 4
cfc-backend/src/main/java/com/etotem/cfc/controller/ai/AIChatController.java

@@ -47,6 +47,9 @@ public class AIChatController {
     @Resource
     private UserService userService;
 
+    @Resource
+    private com.etotem.cfc.service.ChatMirrorService chatMirrorService;
+
     @Operation(summary = "发送聊天消息(支持传入reportId以解读报告)")
     @PostMapping("/chat/send")
     public Result<Map<String, Object>> sendMessage(
@@ -115,8 +118,22 @@ public class AIChatController {
     @PostMapping("/chat/conversations")
     public Result<List<Map<String, Object>>> getConversations(
             @RequestAttribute("userId") Long userId) {
-        List<Map<String, Object>> list = aiService.getConversations(String.valueOf(userId));
-        return Result.success(list);
+        try {
+            List<Map<String, Object>> list = aiService.getConversations(String.valueOf(userId));
+            return Result.success(list);
+        } catch (Exception e) {
+            log.warn("Dify获取会话列表失败,回退到本地: {}", e.getMessage());
+            List<com.etotem.cfc.entity.ChatConversation> local = chatMirrorService.getConversations(userId);
+            List<Map<String, Object>> fallback = new ArrayList<>();
+            for (com.etotem.cfc.entity.ChatConversation c : local) {
+                Map<String, Object> m = new LinkedHashMap<>();
+                m.put("id", c.getDifyConversationId());
+                m.put("name", c.getTitle());
+                m.put("last_message_at", c.getLastMessageAt());
+                fallback.add(m);
+            }
+            return Result.success(fallback);
+        }
     }
 
     @Operation(summary = "获取消息历史")
@@ -128,8 +145,33 @@ public class AIChatController {
         if (conversationId == null || conversationId.trim().isEmpty()) {
             return Result.error("conversationId 不能为空");
         }
-        List<Map<String, Object>> list = aiService.getMessages(conversationId, String.valueOf(userId));
-        return Result.success(list);
+        try {
+            List<Map<String, Object>> list = aiService.getMessages(conversationId, String.valueOf(userId));
+            return Result.success(list);
+        } catch (Exception e) {
+            log.warn("Dify获取消息历史失败,回退到本地: {}", e.getMessage());
+            List<com.etotem.cfc.entity.ChatConversation> conversations = chatMirrorService.getConversations(userId);
+            Long localConvId = null;
+            for (com.etotem.cfc.entity.ChatConversation c : conversations) {
+                if (conversationId.equals(c.getDifyConversationId())) {
+                    localConvId = c.getId();
+                    break;
+                }
+            }
+            if (localConvId == null) {
+                return Result.success(Collections.emptyList());
+            }
+            List<com.etotem.cfc.entity.ChatMessage> messages = chatMirrorService.getMessages(localConvId);
+            List<Map<String, Object>> fallback = new ArrayList<>();
+            for (com.etotem.cfc.entity.ChatMessage msg : messages) {
+                Map<String, Object> m = new LinkedHashMap<>();
+                m.put("role", msg.getRole());
+                m.put("content", msg.getContent());
+                m.put("created_at", msg.getCreatedAt());
+                fallback.add(m);
+            }
+            return Result.success(fallback);
+        }
     }
 
     @Operation(summary = "删除会话")

+ 19 - 30
cfc-backend/src/main/java/com/etotem/cfc/controller/family/FamilyController.java

@@ -6,16 +6,14 @@ import com.etotem.cfc.entity.Family;
 import com.etotem.cfc.entity.User;
 import com.etotem.cfc.mapper.FamilyMapper;
 import com.etotem.cfc.mapper.UserMapper;
+import com.etotem.cfc.service.TeacherFamilyBindingRequestService;
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.tags.Tag;
-import org.springframework.util.DigestUtils;
 import org.springframework.web.bind.annotation.*;
 
 import javax.annotation.Resource;
-import java.nio.charset.StandardCharsets;
 import java.util.Date;
 import java.util.Map;
-import java.util.UUID;
 
 /**
  * 家庭管理控制器
@@ -31,6 +29,9 @@ public class FamilyController {
     @Resource
     private UserMapper userMapper;
 
+    @Resource
+    private TeacherFamilyBindingRequestService bindingRequestService;
+
     /**
      * 获取当前家庭的邀请码(已废弃,请使用邀请令牌系统)
      */
@@ -50,11 +51,11 @@ public class FamilyController {
     }
 
     /**
-     * 成长规划师绑定家庭
+     * 成长规划师申请绑定家庭(需要家长审批)
      */
-    @Operation(summary = "成长规划师绑定家庭")
+    @Operation(summary = "成长规划师申请绑定家庭(需家长审批)")
     @PostMapping("/guide-bind")
-    public Result<String> guideBindFamily(@RequestHeader("X-User-Id") Long userId, 
+    public Result<String> guideBindFamily(@RequestHeader("X-User-Id") Long userId,
                                           @RequestBody Map<String, String> params) {
         String inviteCode = params.get("inviteCode");
         if (inviteCode == null || inviteCode.isEmpty()) {
@@ -69,35 +70,23 @@ public class FamilyController {
         // 查找家庭
         Family family = familyMapper.selectOne(new LambdaQueryWrapper<Family>()
                 .eq(Family::getInviteCode, inviteCode));
-        
+
         if (family == null) {
             return Result.error("邀请码无效");
         }
 
-        // 更新家庭的成长规划师ID
-        family.setTeacherId(userId);
-        family.setUpdatedAt(new Date());
-        familyMapper.updateById(family);
-
-        // 更新成长规划师的 teacherFamilyIds
-        String currentIds = guide.getTeacherFamilyIds();
-        String newFamilyId = String.valueOf(family.getId());
-        if (currentIds == null || !currentIds.contains(newFamilyId)) {
-            String updatedIds = currentIds == null ? newFamilyId : currentIds + "," + newFamilyId;
-            guide.setTeacherFamilyIds(updatedIds);
-            guide.setUpdatedAt(new Date());
-            userMapper.updateById(guide);
+        // 检查规划师是否已绑定该家庭
+        if (bindingRequestService.isTeacherBoundToFamily(userId, family.getId())) {
+            return Result.error("您已绑定该家庭,无需重复申请");
         }
 
-        return Result.success("绑定成功");
-    }
-
-    /**
-     * 生成随机邀请码
-     */
-    private String generateInviteCode() {
-        // 生成8位随机邀请码
-        String uuid = UUID.randomUUID().toString().replace("-", "").toUpperCase();
-        return uuid.substring(0, 8);
+        // 创建绑定申请(家长审批后生效)
+        try {
+            String message = params.get("message");
+            Long requestId = bindingRequestService.createRequest(userId, inviteCode, message);
+            return Result.success("申请已提交,请等待家长审批");
+        } catch (RuntimeException e) {
+            return Result.error(e.getMessage());
+        }
     }
 }

+ 113 - 0
cfc-backend/src/main/java/com/etotem/cfc/controller/family/TeacherFamilyBindingController.java

@@ -0,0 +1,113 @@
+package com.etotem.cfc.controller.family;
+
+import com.etotem.cfc.common.Result;
+import com.etotem.cfc.entity.TeacherFamilyBindingRequest;
+import com.etotem.cfc.entity.User;
+import com.etotem.cfc.mapper.UserMapper;
+import com.etotem.cfc.service.TeacherFamilyBindingRequestService;
+import com.etotem.cfc.service.WechatService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestAttribute;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import javax.annotation.Resource;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * 规划师绑定家庭审批接口
+ * 家长查看/审批规划师的绑定申请
+ */
+@Tag(name = "规划师绑定审批", description = "家长审批规划师绑定家庭申请")
+@RestController
+@RequestMapping("/api/family/teacher-bindings")
+public class TeacherFamilyBindingController {
+
+    @Resource
+    private TeacherFamilyBindingRequestService bindingRequestService;
+
+    @Resource
+    private UserMapper userMapper;
+
+    @Resource
+    private WechatService wechatService;
+
+    /**
+     * 获取自家待审批的规划师绑定申请列表
+     */
+    @Operation(summary = "获取待审批列表")
+    @PostMapping("/pending")
+    public Result<List<TeacherFamilyBindingRequest>> getPending(@RequestAttribute("userId") Long userId) {
+        User user = userMapper.selectById(userId);
+        if (user == null || user.getFamilyId() == null) {
+            return Result.error("用户没有家庭");
+        }
+
+        List<TeacherFamilyBindingRequest> list = bindingRequestService.getPendingByFamily(user.getFamilyId());
+        return Result.success(list);
+    }
+
+    /**
+     * 审批通过
+     */
+    @Operation(summary = "审批通过")
+    @PostMapping("/approve")
+    public Result<String> approve(@RequestAttribute("userId") Long userId,
+                                  @RequestBody Map<String, Object> body) {
+        Long requestId = Long.valueOf(body.get("requestId").toString());
+        try {
+            bindingRequestService.approve(requestId, userId);
+            return Result.success("审批通过");
+        } catch (RuntimeException e) {
+            return Result.error(e.getMessage());
+        }
+    }
+
+    /**
+     * 审批拒绝
+     */
+    @Operation(summary = "审批拒绝")
+    @PostMapping("/reject")
+    public Result<String> reject(@RequestAttribute("userId") Long userId,
+                                 @RequestBody Map<String, Object> body) {
+        Long requestId = Long.valueOf(body.get("requestId").toString());
+        String reason = body.get("reason") != null ? body.get("reason").toString() : null;
+        try {
+            bindingRequestService.reject(requestId, userId, reason);
+            return Result.success("已拒绝");
+        } catch (RuntimeException e) {
+            return Result.error(e.getMessage());
+        }
+    }
+
+    /**
+     * 规划师查看自己的绑定请求列表
+     */
+    @Operation(summary = "我的绑定请求")
+    @PostMapping("/my-requests")
+    public Result<List<TeacherFamilyBindingRequest>> myRequests(@RequestAttribute("userId") Long userId) {
+        List<TeacherFamilyBindingRequest> list = bindingRequestService.getByTeacher(userId);
+        return Result.success(list);
+    }
+
+    /**
+     * 规划师撤销自己的申请
+     */
+    @Operation(summary = "撤销申请")
+    @PostMapping("/cancel")
+    public Result<String> cancel(@RequestAttribute("userId") Long userId,
+                                  @RequestBody Map<String, Object> body) {
+        Long requestId = Long.valueOf(body.get("requestId").toString());
+        try {
+            bindingRequestService.cancel(requestId, userId);
+            return Result.success("已撤销");
+        } catch (RuntimeException e) {
+            return Result.error(e.getMessage());
+        }
+    }
+}

+ 29 - 0
cfc-backend/src/main/java/com/etotem/cfc/entity/ChatConversation.java

@@ -0,0 +1,29 @@
+package com.etotem.cfc.entity;
+
+import com.baomidou.mybatisplus.annotation.IdType;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.Data;
+
+import java.io.Serializable;
+import java.util.Date;
+
+@Data
+@TableName("chat_conversations")
+public class ChatConversation implements Serializable {
+
+    @TableId(type = IdType.AUTO)
+    private Long id;
+
+    private Long userId;
+
+    private String difyConversationId;
+
+    private String assistantType; // family/nutrition/tongue
+
+    private String title;
+
+    private Date lastMessageAt;
+
+    private Date createdAt;
+}

+ 31 - 0
cfc-backend/src/main/java/com/etotem/cfc/entity/ChatMessage.java

@@ -0,0 +1,31 @@
+package com.etotem.cfc.entity;
+
+import com.baomidou.mybatisplus.annotation.IdType;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.Data;
+
+import java.io.Serializable;
+import java.util.Date;
+
+@Data
+@TableName("chat_messages")
+public class ChatMessage implements Serializable {
+
+    @TableId(type = IdType.AUTO)
+    private Long id;
+
+    private Long conversationId;
+
+    private String difyMessageId;
+
+    private String role; // user/assistant
+
+    private String content;
+
+    private String inputsJson;
+
+    private String metadata;
+
+    private Date createdAt;
+}

+ 4 - 0
cfc-backend/src/main/java/com/etotem/cfc/entity/DanAssessmentResult.java

@@ -121,6 +121,10 @@ public class DanAssessmentResult implements Serializable {
     private String audioUrl; // 音频访问URL
 
     // === 扩展字段 ===
+    @Deprecated // replaced by structuredAnalysis (G3)
     private String processDesc; // 过程描述
+    @Deprecated // replaced by structuredAnalysis (G3)
     private String resultDesc; // 结果描述(简评)
+
+    private String structuredAnalysis; // 结构化分析JSON(summary/dimensions/strengths/concerns/suggestions)
 }

+ 60 - 0
cfc-backend/src/main/java/com/etotem/cfc/entity/PendingRefund.java

@@ -0,0 +1,60 @@
+package com.etotem.cfc.entity;
+
+import com.baomidou.mybatisplus.annotation.IdType;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.Data;
+
+import java.io.Serializable;
+import java.util.Date;
+
+/**
+ * 待退款记录表
+ * 用于处理余额不足时的延迟退款,支持按顺序执行和状态追踪
+ */
+@Data
+@TableName("pending_refund")
+public class PendingRefund implements Serializable {
+
+    @TableId(type = IdType.AUTO)
+    private Long id;
+
+    /** 用户 ID */
+    private Long userId;
+
+    /** 提现申请 ID */
+    private Long withdrawalRequestId;
+
+    /** 退款金额 (分) */
+    private Integer amount;
+
+    /** 当前尝试次数 */
+    private Integer attemptCount;
+
+    /** 最大重试次数 */
+    private Integer maxAttempts;
+
+    /** 下次重试时间 */
+    private Date nextRetryTime;
+
+    /** 状态:pending(待处理)/processing(处理中)/success(成功)/failed(失败) */
+    private String status;
+
+    /** 失败原因 */
+    private String failureReason;
+
+    /** 实际退款金额 (分),部分退款时使用 */
+    private Integer refundedAmount;
+
+    /** 退款时间 */
+    private Date refundedAt;
+
+    /** 备注 */
+    private String remark;
+
+    /** 创建时间 */
+    private Date createdAt;
+
+    /** 更新时间 */
+    private Date updatedAt;
+}

+ 37 - 0
cfc-backend/src/main/java/com/etotem/cfc/entity/SchemaVersion.java

@@ -0,0 +1,37 @@
+package com.etotem.cfc.entity;
+
+import com.baomidou.mybatisplus.annotation.IdType;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Data
+@TableName("schema_versions")
+public class SchemaVersion {
+    @TableId(type = IdType.AUTO)
+    private Long id;
+    
+    /**
+     * 迁移版本号,如 migration_2026_07_10_001
+     */
+    private String versionCode;
+    
+    /**
+     * 迁移描述
+     */
+    private String description;
+    
+    /**
+     * 迁移脚本的校验和(可选)
+     */
+    private String checksum;
+    
+    private LocalDateTime appliedAt;
+    
+    /**
+     * 执行迁移的工具或用户
+     */
+    private String appliedBy;
+}

+ 54 - 0
cfc-backend/src/main/java/com/etotem/cfc/entity/TeacherFamilyBindingRequest.java

@@ -0,0 +1,54 @@
+package com.etotem.cfc.entity;
+
+import com.baomidou.mybatisplus.annotation.IdType;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.Data;
+
+import java.io.Serializable;
+import java.util.Date;
+
+/**
+ * 规划师绑定家庭申请表
+ * 规划师通过邀请码申请绑定家庭,家长审批后正式生效
+ */
+@Data
+@TableName("teacher_family_binding_requests")
+public class TeacherFamilyBindingRequest implements Serializable {
+
+    @TableId(type = IdType.AUTO)
+    private Long id;
+
+    /** 规划师用户ID */
+    private Long teacherId;
+
+    /** 家庭ID */
+    private Long familyId;
+
+    /** 关联的邀请码(family_invitations.token) */
+    private String invitationToken;
+
+    /** 状态: pending/approved/rejected/cancelled */
+    private String status;
+
+    /** 申请时间 */
+    private Date requestedAt;
+
+    /** 审批人用户ID(家长) */
+    private Long decidedBy;
+
+    /** 审批时间 */
+    private Date decidedAt;
+
+    /** 拒绝原因 */
+    private String rejectReason;
+
+    /** 申请时规划师填写的自我介绍 */
+    private String message;
+
+    /** 创建时间 */
+    private Date createdAt;
+
+    /** 更新时间 */
+    private Date updatedAt;
+}

+ 9 - 0
cfc-backend/src/main/java/com/etotem/cfc/mapper/ChatConversationMapper.java

@@ -0,0 +1,9 @@
+package com.etotem.cfc.mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.etotem.cfc.entity.ChatConversation;
+import org.apache.ibatis.annotations.Mapper;
+
+@Mapper
+public interface ChatConversationMapper extends BaseMapper<ChatConversation> {
+}

+ 9 - 0
cfc-backend/src/main/java/com/etotem/cfc/mapper/ChatMessageMapper.java

@@ -0,0 +1,9 @@
+package com.etotem.cfc.mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.etotem.cfc.entity.ChatMessage;
+import org.apache.ibatis.annotations.Mapper;
+
+@Mapper
+public interface ChatMessageMapper extends BaseMapper<ChatMessage> {
+}

+ 9 - 0
cfc-backend/src/main/java/com/etotem/cfc/mapper/PendingRefundMapper.java

@@ -0,0 +1,9 @@
+package com.etotem.cfc.mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.etotem.cfc.entity.PendingRefund;
+import org.apache.ibatis.annotations.Mapper;
+
+@Mapper
+public interface PendingRefundMapper extends BaseMapper<PendingRefund> {
+}

+ 9 - 0
cfc-backend/src/main/java/com/etotem/cfc/mapper/SchemaVersionMapper.java

@@ -0,0 +1,9 @@
+package com.etotem.cfc.mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.etotem.cfc.entity.SchemaVersion;
+import org.apache.ibatis.annotations.Mapper;
+
+@Mapper
+public interface SchemaVersionMapper extends BaseMapper<SchemaVersion> {
+}

+ 9 - 0
cfc-backend/src/main/java/com/etotem/cfc/mapper/TeacherFamilyBindingRequestMapper.java

@@ -0,0 +1,9 @@
+package com.etotem.cfc.mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.etotem.cfc.entity.TeacherFamilyBindingRequest;
+import org.apache.ibatis.annotations.Mapper;
+
+@Mapper
+public interface TeacherFamilyBindingRequestMapper extends BaseMapper<TeacherFamilyBindingRequest> {
+}

+ 28 - 0
cfc-backend/src/main/java/com/etotem/cfc/service/AIService.java

@@ -40,6 +40,9 @@ public class AIService {
     @Resource
     private EmotionCheckinMapper emotionCheckinMapper;
 
+    @Resource
+    private ChatMirrorService chatMirrorService;
+
     private HttpHeaders authHeaders() {
         HttpHeaders headers = new HttpHeaders();
         headers.setContentType(MediaType.APPLICATION_JSON);
@@ -83,10 +86,35 @@ public class AIService {
         if (resp.getBody() != null) {
             result.put("answer", resp.getBody().get("answer"));
             result.put("conversationId", resp.getBody().get("conversation_id"));
+            mirrorConversation(Long.valueOf(userId), (String) resp.getBody().get("conversation_id"),
+                    "family", query, (String) resp.getBody().get("answer"), inputs);
         }
         return result;
     }
 
+    private void mirrorConversation(Long userId, String difyConversationId,
+                                     String assistantType, String userQuery,
+                                     String assistantAnswer, Map<String, Object> inputs) {
+        try {
+            Long convId = chatMirrorService.upsertConversation(userId, difyConversationId, assistantType, null);
+            List<Map<String, Object>> messages = new ArrayList<>();
+            Map<String, Object> userMsg = new LinkedHashMap<>();
+            userMsg.put("role", "user");
+            userMsg.put("content", userQuery);
+            if (inputs != null && !inputs.isEmpty()) {
+                userMsg.put("inputs", inputs);
+            }
+            messages.add(userMsg);
+            Map<String, Object> assistantMsg = new LinkedHashMap<>();
+            assistantMsg.put("role", "assistant");
+            assistantMsg.put("content", assistantAnswer);
+            messages.add(assistantMsg);
+            chatMirrorService.saveMessages(convId, messages);
+        } catch (Exception e) {
+            log.warn("镜像会话到本地失败: {}", e.getMessage());
+        }
+    }
+
     /**
      * 发送聊天消息到精准营养助手(使用专用 API Key)
      */

+ 119 - 0
cfc-backend/src/main/java/com/etotem/cfc/service/ChatMirrorService.java

@@ -0,0 +1,119 @@
+package com.etotem.cfc.service;
+
+import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
+import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
+import com.etotem.cfc.entity.ChatConversation;
+import com.etotem.cfc.entity.ChatMessage;
+import com.etotem.cfc.mapper.ChatConversationMapper;
+import com.etotem.cfc.mapper.ChatMessageMapper;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+
+import javax.annotation.Resource;
+import java.util.Date;
+import java.util.List;
+import java.util.Map;
+
+@Slf4j
+@Service
+public class ChatMirrorService {
+
+    @Resource
+    private ChatConversationMapper chatConversationMapper;
+
+    @Resource
+    private ChatMessageMapper chatMessageMapper;
+
+    /**
+     * Upsert conversation - update if exists, insert if not
+     * @param userId user ID
+     * @param difyConversationId Dify conversation ID
+     * @param assistantType assistant type (family/nutrition/tongue)
+     * @param title conversation title
+     * @return conversation ID
+     */
+    public Long upsertConversation(Long userId, String difyConversationId, String assistantType, String title) {
+        // Check if conversation already exists
+        LambdaQueryWrapper<ChatConversation> queryWrapper = new LambdaQueryWrapper<>();
+        queryWrapper.eq(ChatConversation::getDifyConversationId, difyConversationId);
+        
+        ChatConversation existing = chatConversationMapper.selectOne(queryWrapper);
+        
+        if (existing != null) {
+            // Update existing conversation
+            LambdaUpdateWrapper<ChatConversation> updateWrapper = new LambdaUpdateWrapper<>();
+            updateWrapper.eq(ChatConversation::getId, existing.getId())
+                        .set(ChatConversation::getTitle, title)
+                        .set(ChatConversation::getLastMessageAt, new Date());
+            
+            chatConversationMapper.update(null, updateWrapper);
+            return existing.getId();
+        } else {
+            // Create new conversation
+            ChatConversation conversation = new ChatConversation();
+            conversation.setUserId(userId);
+            conversation.setDifyConversationId(difyConversationId);
+            conversation.setAssistantType(assistantType);
+            conversation.setTitle(title);
+            conversation.setLastMessageAt(new Date());
+            conversation.setCreatedAt(new Date());
+            
+            chatConversationMapper.insert(conversation);
+            return conversation.getId();
+        }
+    }
+
+    /**
+     * Save messages to local DB
+     * @param conversationId local conversation ID
+     * @param messages list of messages to save
+     */
+    public void saveMessages(Long conversationId, List<Map<String, Object>> messages) {
+        for (Map<String, Object> message : messages) {
+            ChatMessage chatMessage = new ChatMessage();
+            chatMessage.setConversationId(conversationId);
+            chatMessage.setDifyMessageId((String) message.get("id"));
+            chatMessage.setRole((String) message.get("role"));
+            chatMessage.setContent((String) message.get("content"));
+            
+            // Handle inputs if present
+            if (message.containsKey("inputs")) {
+                chatMessage.setInputsJson(message.get("inputs").toString());
+            }
+            
+            // Handle metadata if present
+            if (message.containsKey("metadata")) {
+                chatMessage.setMetadata(message.get("metadata").toString());
+            }
+            
+            chatMessage.setCreatedAt(new Date());
+            chatMessageMapper.insert(chatMessage);
+        }
+    }
+
+    /**
+     * Get conversations for a user
+     * @param userId user ID
+     * @return list of conversations
+     */
+    public List<ChatConversation> getConversations(Long userId) {
+        LambdaQueryWrapper<ChatConversation> queryWrapper = new LambdaQueryWrapper<>();
+        queryWrapper.eq(ChatConversation::getUserId, userId)
+                   .orderByDesc(ChatConversation::getLastMessageAt);
+        
+        return chatConversationMapper.selectList(queryWrapper);
+    }
+
+    /**
+     * Get messages for a conversation
+     * @param conversationId conversation ID
+     * @return list of messages
+     */
+    public List<ChatMessage> getMessages(Long conversationId) {
+        LambdaQueryWrapper<ChatMessage> queryWrapper = new LambdaQueryWrapper<>();
+        queryWrapper.eq(ChatMessage::getConversationId, conversationId)
+                   .orderByAsc(ChatMessage::getCreatedAt);
+        
+        return chatMessageMapper.selectList(queryWrapper);
+    }
+}

+ 165 - 0
cfc-backend/src/main/java/com/etotem/cfc/service/PendingRefundService.java

@@ -0,0 +1,165 @@
+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.entity.PendingRefund;
+import com.etotem.cfc.mapper.PendingRefundMapper;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import javax.annotation.Resource;
+import java.util.Calendar;
+import java.util.Date;
+import java.util.List;
+
+/**
+ * 待退款服务
+ * 处理余额不足时的延迟退款逻辑
+ */
+@Slf4j
+@Service
+public class PendingRefundService {
+
+    @Resource
+    private PendingRefundMapper pendingRefundMapper;
+
+    @Resource
+    private CommissionService commissionService;
+
+    /**
+     * 创建待退款记录
+     * @param userId 用户 ID
+     * @param withdrawalRequestId 提现申请 ID
+     * @param amount 退款金额
+     * @return PendingRefund 记录
+     */
+    @Transactional
+    public PendingRefund createPendingRefund(Long userId, Long withdrawalRequestId, Integer amount) {
+        PendingRefund pendingRefund = new PendingRefund();
+        pendingRefund.setUserId(userId);
+        pendingRefund.setWithdrawalRequestId(withdrawalRequestId);
+        pendingRefund.setAmount(amount);
+        pendingRefund.setAttemptCount(0);
+        pendingRefund.setMaxAttempts(10); // 最多重试 10 次
+        pendingRefund.setNextRetryTime(new Date()); // 立即重试
+        pendingRefund.setStatus("pending");
+        pendingRefund.setCreatedAt(new Date());
+        pendingRefund.setUpdatedAt(new Date());
+        pendingRefundMapper.insert(pendingRefund);
+        return pendingRefund;
+    }
+
+    /**
+     * 获取待处理的退款记录(按创建时间排序)
+     * @param limit 获取数量限制
+     * @return 待处理退款记录列表
+     */
+    public List<PendingRefund> getPendingRefunds(int limit) {
+        Date now = new Date();
+        return pendingRefundMapper.selectList(
+                new LambdaQueryWrapper<PendingRefund>()
+                        .eq(PendingRefund::getStatus, "pending")
+                        .le(PendingRefund::getNextRetryTime, now)
+                        .orderByAsc(PendingRefund::getCreatedAt)
+                        .last("LIMIT " + limit)
+        );
+    }
+
+    /**
+     * 更新退款记录为处理中
+     */
+    @Transactional
+    public void markProcessing(Long refundId) {
+        PendingRefund refund = pendingRefundMapper.selectById(refundId);
+        if (refund != null) {
+            refund.setStatus("processing");
+            refund.setUpdatedAt(new Date());
+            pendingRefundMapper.updateById(refund);
+        }
+    }
+
+    /**
+     * 更新退款记录为成功
+     */
+    @Transactional
+    public void markSuccess(Long refundId, Integer refundedAmount) {
+        PendingRefund refund = pendingRefundMapper.selectById(refundId);
+        if (refund != null) {
+            refund.setStatus("success");
+            refund.setRefundedAmount(refundedAmount);
+            refund.setRefundedAt(new Date());
+            refund.setUpdatedAt(new Date());
+            pendingRefundMapper.updateById(refund);
+        }
+    }
+
+    /**
+     * 更新退款记录为失败,设置下次重试时间
+     * @param refundId 退款 ID
+     * @param reason 失败原因
+     * @param retryDelayMinutes 重试延迟(分钟)
+     */
+    @Transactional
+    public void markFailed(Long refundId, String reason, int retryDelayMinutes) {
+        PendingRefund refund = pendingRefundMapper.selectById(refundId);
+        if (refund != null) {
+            refund.setAttemptCount(refund.getAttemptCount() + 1);
+            refund.setFailureReason(reason);
+            
+            // 检查是否超过最大重试次数
+            if (refund.getAttemptCount() >= refund.getMaxAttempts()) {
+                refund.setStatus("failed");
+                refund.setRemark("超过最大重试次数:" + refund.getMaxAttempts());
+            } else {
+                refund.setStatus("pending");
+                // 指数退避策略:第 1 次 5 分钟,第 2 次 10 分钟,第 3 次 20 分钟...
+                Calendar cal = Calendar.getInstance();
+                cal.add(Calendar.MINUTE, retryDelayMinutes);
+                refund.setNextRetryTime(cal.getTime());
+            }
+            
+            refund.setUpdatedAt(new Date());
+            pendingRefundMapper.updateById(refund);
+        }
+    }
+
+    /**
+     * 获取用户的待退款列表
+     */
+    public Page<PendingRefund> getUserPendingRefunds(Long userId, int page, int size) {
+        Page<PendingRefund> pageParam = new Page<>(page, size);
+        return pendingRefundMapper.selectPage(pageParam,
+                new LambdaQueryWrapper<PendingRefund>()
+                        .eq(PendingRefund::getUserId, userId)
+                        .orderByDesc(PendingRefund::getCreatedAt));
+    }
+
+    /**
+     * 获取所有待退款列表(管理员)
+     */
+    public Page<PendingRefund> getAllPendingRefunds(String status, int page, int size) {
+        Page<PendingRefund> pageParam = new Page<>(page, size);
+        LambdaQueryWrapper<PendingRefund> wrapper = new LambdaQueryWrapper<PendingRefund>()
+                .orderByDesc(PendingRefund::getCreatedAt);
+        
+        if (status != null && !status.isEmpty()) {
+            wrapper.eq(PendingRefund::getStatus, status);
+        }
+        
+        return pendingRefundMapper.selectPage(pageParam, wrapper);
+    }
+
+    /**
+     * 统计待退款总金额
+     */
+    public Integer getTotalPendingAmount() {
+        List<PendingRefund> pendingList = pendingRefundMapper.selectList(
+                new LambdaQueryWrapper<PendingRefund>()
+                        .eq(PendingRefund::getStatus, "pending")
+        );
+        return pendingList.stream()
+                .mapToInt(r -> r.getAmount() != null ? r.getAmount() : 0)
+                .sum();
+    }
+}

+ 197 - 0
cfc-backend/src/main/java/com/etotem/cfc/service/TeacherFamilyBindingRequestService.java

@@ -0,0 +1,197 @@
+package com.etotem.cfc.service;
+
+import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
+import com.etotem.cfc.entity.Family;
+import com.etotem.cfc.entity.TeacherFamilyBindingRequest;
+import com.etotem.cfc.entity.User;
+import com.etotem.cfc.mapper.FamilyMapper;
+import com.etotem.cfc.mapper.TeacherFamilyBindingRequestMapper;
+import com.etotem.cfc.mapper.UserMapper;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+import javax.annotation.Resource;
+import java.util.Date;
+import java.util.List;
+
+/**
+ * 规划师绑定家庭申请服务
+ */
+@Service
+public class TeacherFamilyBindingRequestService {
+
+    @Resource
+    private TeacherFamilyBindingRequestMapper bindingRequestMapper;
+
+    @Resource
+    private FamilyMapper familyMapper;
+
+    @Resource
+    private UserMapper userMapper;
+
+    /**
+     * 创建绑定申请(规划师发起)
+     * @param teacherId 规划师用户ID
+     * @param inviteCode 家庭邀请码
+     * @param message 申请留言(可选)
+     * @return 申请ID
+     */
+    @Transactional
+    public Long createRequest(Long teacherId, String inviteCode, String message) {
+        // 查找家庭
+        Family family = familyMapper.selectOne(
+                new LambdaQueryWrapper<Family>().eq(Family::getInviteCode, inviteCode));
+        if (family == null) {
+            throw new RuntimeException("邀请码无效");
+        }
+
+        // 检查是否已有 pending 或 approved 的申请
+        Long existing = bindingRequestMapper.selectCount(
+                new LambdaQueryWrapper<TeacherFamilyBindingRequest>()
+                        .eq(TeacherFamilyBindingRequest::getTeacherId, teacherId)
+                        .eq(TeacherFamilyBindingRequest::getFamilyId, family.getId())
+                        .in(TeacherFamilyBindingRequest::getStatus, "pending", "approved"));
+        if (existing > 0) {
+            throw new RuntimeException("您已申请过绑定该家庭,请等待审批或重新申请");
+        }
+
+        TeacherFamilyBindingRequest request = new TeacherFamilyBindingRequest();
+        request.setTeacherId(teacherId);
+        request.setFamilyId(family.getId());
+        request.setInvitationToken(inviteCode);
+        request.setStatus("pending");
+        request.setRequestedAt(new Date());
+        request.setMessage(message);
+        request.setCreatedAt(new Date());
+        request.setUpdatedAt(new Date());
+        bindingRequestMapper.insert(request);
+
+        return request.getId();
+    }
+
+    /**
+     * 获取家庭所有待审批的绑定申请(家长调用)
+     */
+    public List<TeacherFamilyBindingRequest> getPendingByFamily(Long familyId) {
+        return bindingRequestMapper.selectList(
+                new LambdaQueryWrapper<TeacherFamilyBindingRequest>()
+                        .eq(TeacherFamilyBindingRequest::getFamilyId, familyId)
+                        .eq(TeacherFamilyBindingRequest::getStatus, "pending")
+                        .orderByDesc(TeacherFamilyBindingRequest::getRequestedAt));
+    }
+
+    /**
+     * 家长审批通过:写入 teacherFamilyIds + family.teacherId
+     */
+    @Transactional
+    public void approve(Long requestId, Long approverUserId) {
+        TeacherFamilyBindingRequest request = bindingRequestMapper.selectById(requestId);
+        if (request == null) {
+            throw new RuntimeException("申请记录不存在");
+        }
+        if (!"pending".equals(request.getStatus())) {
+            throw new RuntimeException("该申请已处理");
+        }
+
+        // 校验审批人是否属于该家庭
+        User approver = userMapper.selectById(approverUserId);
+        if (approver == null || !request.getFamilyId().equals(approver.getFamilyId())) {
+            throw new RuntimeException("只有该家庭成员可以审批");
+        }
+
+        // 更新请求状态
+        request.setStatus("approved");
+        request.setDecidedBy(approverUserId);
+        request.setDecidedAt(new Date());
+        request.setUpdatedAt(new Date());
+        bindingRequestMapper.updateById(request);
+
+        // 写入 family.teacherId
+        Family family = familyMapper.selectById(request.getFamilyId());
+        if (family != null) {
+            family.setTeacherId(request.getTeacherId());
+            family.setUpdatedAt(new Date());
+            familyMapper.updateById(family);
+        }
+
+        // 写入 user.teacherFamilyIds
+        User teacher = userMapper.selectById(request.getTeacherId());
+        if (teacher != null) {
+            String currentIds = teacher.getTeacherFamilyIds();
+            String newFamilyId = String.valueOf(request.getFamilyId());
+            if (currentIds == null || !currentIds.contains(newFamilyId)) {
+                String updatedIds = currentIds == null ? newFamilyId : currentIds + "," + newFamilyId;
+                teacher.setTeacherFamilyIds(updatedIds);
+                teacher.setUpdatedAt(new Date());
+                userMapper.updateById(teacher);
+            }
+        }
+    }
+
+    /**
+     * 家长拒绝申请
+     */
+    @Transactional
+    public void reject(Long requestId, Long approverUserId, String reason) {
+        TeacherFamilyBindingRequest request = bindingRequestMapper.selectById(requestId);
+        if (request == null) {
+            throw new RuntimeException("申请记录不存在");
+        }
+        if (!"pending".equals(request.getStatus())) {
+            throw new RuntimeException("该申请已处理");
+        }
+
+        // 校验审批人是否属于该家庭
+        User approver = userMapper.selectById(approverUserId);
+        if (approver == null || !request.getFamilyId().equals(approver.getFamilyId())) {
+            throw new RuntimeException("只有该家庭成员可以审批");
+        }
+
+        request.setStatus("rejected");
+        request.setDecidedBy(approverUserId);
+        request.setDecidedAt(new Date());
+        request.setRejectReason(reason);
+        request.setUpdatedAt(new Date());
+        bindingRequestMapper.updateById(request);
+    }
+
+    /**
+     * 取消申请(规划师撤销自己的申请)
+     */
+    public void cancel(Long requestId, Long teacherId) {
+        TeacherFamilyBindingRequest request = bindingRequestMapper.selectById(requestId);
+        if (request == null) {
+            throw new RuntimeException("申请记录不存在");
+        }
+        if (!request.getTeacherId().equals(teacherId)) {
+            throw new RuntimeException("只能撤销自己的申请");
+        }
+        if (!"pending".equals(request.getStatus())) {
+            throw new RuntimeException("该申请已处理,无法撤销");
+        }
+        request.setStatus("cancelled");
+        request.setUpdatedAt(new Date());
+        bindingRequestMapper.updateById(request);
+    }
+
+    /**
+     * 获取规划师所有绑定请求
+     */
+    public List<TeacherFamilyBindingRequest> getByTeacher(Long teacherId) {
+        return bindingRequestMapper.selectList(
+                new LambdaQueryWrapper<TeacherFamilyBindingRequest>()
+                        .eq(TeacherFamilyBindingRequest::getTeacherId, teacherId)
+                        .orderByDesc(TeacherFamilyBindingRequest::getRequestedAt));
+    }
+
+    /**
+     * 判断规划师是否已绑定某家庭(直接读 teacherFamilyIds)
+     */
+    public boolean isTeacherBoundToFamily(Long teacherId, Long familyId) {
+        User teacher = userMapper.selectById(teacherId);
+        if (teacher == null || teacher.getTeacherFamilyIds() == null) {
+            return false;
+        }
+        return teacher.getTeacherFamilyIds().contains(String.valueOf(familyId));
+    }
+}

+ 15 - 0
cfc-backend/src/main/java/com/etotem/cfc/service/WechatService.java

@@ -13,6 +13,7 @@ import org.springframework.stereotype.Service;
 import org.springframework.web.client.RestTemplate;
 import com.etotem.cfc.service.api.WechatServiceInterface;
 
+import javax.annotation.PostConstruct;
 import java.nio.charset.StandardCharsets;
 import java.util.Base64;
 import java.util.HashMap;
@@ -39,6 +40,9 @@ public class WechatService implements WechatServiceInterface {
     @Value("${wechat.test-mode:false}")
     private boolean testMode;
 
+    @Value("${spring.profiles.active:dev}")
+    private String activeProfile;
+
     @Value("${wechat.test-phone:13800138000}")
     private String testPhone;
 
@@ -54,6 +58,17 @@ public class WechatService implements WechatServiceInterface {
         return testMode;
     }
 
+    @PostConstruct
+    public void checkTestModeAtStartup() {
+        if ("prod".equalsIgnoreCase(activeProfile)) {
+            if (testMode) {
+                throw new IllegalStateException("wechat.test-mode=true in production profile!");
+            }
+        } else if (testMode) {
+            log.warn("wechat.test-mode=true in non-production profile ({})", activeProfile);
+        }
+    }
+
     /**
      * 通过code获取openid和session_key
      */

+ 64 - 1
cfc-backend/src/main/java/com/etotem/cfc/service/WithdrawalService.java

@@ -3,17 +3,23 @@ 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.CommissionRecord;
 import com.etotem.cfc.entity.WithdrawalRequest;
+import com.etotem.cfc.mapper.CommissionRecordMapper;
 import com.etotem.cfc.mapper.WithdrawalRequestMapper;
 import org.springframework.stereotype.Service;
 
+import lombok.extern.slf4j.Slf4j;
+
 import javax.annotation.Resource;
 import java.util.Date;
+import java.util.List;
 
+@Slf4j
 @Service
 public class WithdrawalService {
 
-    private static final Integer MIN_WITHDRAWAL = 10000; // 100元 = 10000分
+    private static final Integer MIN_WITHDRAWAL = 10000; // 100 元 = 10000 分
 
     @Resource
     private WithdrawalRequestMapper withdrawalRequestMapper;
@@ -21,6 +27,12 @@ public class WithdrawalService {
     @Resource
     private CommissionService commissionService;
 
+    @Resource
+    private PendingRefundService pendingRefundService;
+
+    @Resource
+    private CommissionRecordMapper commissionRecordMapper;
+
     public Result<String> apply(Long userId, Integer amount, String accountInfo) {
         if (amount == null || amount <= 0) {
             return Result.error("提现金额必须大于0");
@@ -53,6 +65,22 @@ public class WithdrawalService {
         if (!"pending".equals(request.getStatus())) {
             throw new RuntimeException("该申请已处理");
         }
+
+        if ("approved".equals(status)) {
+            Integer available = commissionService.getAvailableAmount(request.getUserId());
+            if (available < request.getAmount()) {
+                pendingRefundService.createPendingRefund(
+                        request.getUserId(),
+                        request.getId(),
+                        request.getAmount()
+                );
+                log.info("提现审核通过但余额不足,已加入待退款队列:userId={}, amount={}",
+                        request.getUserId(), request.getAmount());
+            } else {
+                processWithdrawal(request);
+            }
+        }
+
         request.setStatus(status);
         request.setAuditBy(adminId);
         request.setAuditAt(new Date());
@@ -60,6 +88,41 @@ public class WithdrawalService {
         withdrawalRequestMapper.updateById(request);
     }
 
+    private void processWithdrawal(WithdrawalRequest request) {
+        Long userId = request.getUserId();
+        Integer amount = request.getAmount();
+
+        List<CommissionRecord> settledRecords = commissionRecordMapper.selectList(
+                new LambdaQueryWrapper<CommissionRecord>()
+                        .eq(CommissionRecord::getReferrerId, userId)
+                        .eq(CommissionRecord::getStatus, "settled")
+        );
+
+        int remainingAmount = amount;
+        for (CommissionRecord record : settledRecords) {
+            if (remainingAmount <= 0) {
+                break;
+            }
+
+            int recordAmount = record.getCommissionAmount() != null ? record.getCommissionAmount() : 0;
+            int withdrawAmount = Math.min(recordAmount, remainingAmount);
+
+            record.setStatus("withdrawn");
+            record.setWithdrawnAt(new Date());
+            commissionRecordMapper.updateById(record);
+
+            remainingAmount -= withdrawAmount;
+        }
+
+        request.setStatus("processed");
+        if (remainingAmount > 0) {
+            pendingRefundService.createPendingRefund(userId, request.getId(), remainingAmount);
+            request.setRemark("部分提现成功,剩余 " + remainingAmount + " 分已加入待退款队列");
+        } else {
+            request.setRemark("提现成功");
+        }
+    }
+
     public Page<WithdrawalRequest> getHistory(Long userId, int page, int size) {
         Page<WithdrawalRequest> pageParam = new Page<>(page, size);
         return withdrawalRequestMapper.selectPage(pageParam,

+ 158 - 0
cfc-backend/src/main/java/com/etotem/cfc/task/RefundScheduledTasks.java

@@ -0,0 +1,158 @@
+package com.etotem.cfc.task;
+
+import com.etotem.cfc.entity.CommissionRecord;
+import com.etotem.cfc.entity.PendingRefund;
+import com.etotem.cfc.entity.User;
+import com.etotem.cfc.mapper.CommissionRecordMapper;
+import com.etotem.cfc.mapper.PendingRefundMapper;
+import com.etotem.cfc.mapper.UserMapper;
+import com.etotem.cfc.service.CommissionService;
+import com.etotem.cfc.service.PendingRefundService;
+import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.scheduling.annotation.Scheduled;
+import org.springframework.stereotype.Component;
+import org.springframework.transaction.annotation.Transactional;
+
+import javax.annotation.Resource;
+import java.util.Date;
+import java.util.List;
+
+/**
+ * 退款定时任务
+ * 处理余额不足时的延迟退款
+ */
+@Slf4j
+@Component
+public class RefundScheduledTasks {
+
+    @Resource
+    private PendingRefundService pendingRefundService;
+
+    @Resource
+    private CommissionService commissionService;
+
+    @Resource
+    private CommissionRecordMapper commissionRecordMapper;
+
+    @Resource
+    private UserMapper userMapper;
+
+    /**
+     * 每 5 分钟执行一次
+     * 处理待退款队列
+     */
+    @Scheduled(cron = "0 */5 * * * ?")
+    @Transactional(rollbackFor = Exception.class)
+    public void processPendingRefunds() {
+        log.info("开始执行待退款处理定时任务");
+        try {
+            // 获取待处理的退款记录(最多 10 条)
+            List<PendingRefund> pendingRefunds = pendingRefundService.getPendingRefunds(10);
+            
+            if (pendingRefunds.isEmpty()) {
+                log.info("没有待处理的退款记录");
+                return;
+            }
+
+            int successCount = 0;
+            int failCount = 0;
+
+            for (PendingRefund pendingRefund : pendingRefunds) {
+                try {
+                    processSingleRefund(pendingRefund);
+                    successCount++;
+                } catch (Exception e) {
+                    log.error("处理退款记录失败:refundId={}", pendingRefund.getId(), e);
+                    failCount++;
+                    // 余额不足时,延迟重试
+                    handleInsufficientBalance(pendingRefund, e.getMessage());
+                }
+            }
+
+            log.info("待退款处理定时任务执行完成,成功{}条,失败{}条", successCount, failCount);
+        } catch (Exception e) {
+            log.error("待退款处理定时任务执行失败", e);
+        }
+    }
+
+    /**
+     * 处理单个退款记录
+     */
+    private void processSingleRefund(PendingRefund pendingRefund) {
+        Long userId = pendingRefund.getUserId();
+        Integer amount = pendingRefund.getAmount();
+
+        // 检查用户当前可提现余额
+        Integer availableAmount = commissionService.getAvailableAmount(userId);
+        
+        if (availableAmount < amount) {
+            throw new RuntimeException("余额不足,当前可提现:" + availableAmount + ",需要:" + amount);
+        }
+
+        // 标记为处理中
+        pendingRefundService.markProcessing(pendingRefund.getId());
+
+        // 将该用户所有已结算的佣金记录标记为已提现
+        List<CommissionRecord> settledRecords = commissionRecordMapper.selectList(
+                new LambdaQueryWrapper<CommissionRecord>()
+                        .eq(CommissionRecord::getReferrerId, userId)
+                        .eq(CommissionRecord::getStatus, "settled")
+        );
+
+        int remainingAmount = amount;
+        int actualRefundedAmount = 0;
+
+        for (CommissionRecord record : settledRecords) {
+            if (remainingAmount <= 0) {
+                break;
+            }
+
+            int recordAmount = record.getCommissionAmount() != null ? record.getCommissionAmount() : 0;
+            int refundAmount = Math.min(recordAmount, remainingAmount);
+
+            // 标记佣金记录为已提现
+            record.setStatus("withdrawn");
+            record.setWithdrawnAt(new Date());
+            commissionRecordMapper.updateById(record);
+
+            remainingAmount -= refundAmount;
+            actualRefundedAmount += refundAmount;
+        }
+
+        // 更新退款记录为成功
+        pendingRefundService.markSuccess(pendingRefund.getId(), actualRefundedAmount);
+
+        log.info("退款处理成功:userId={}, amount={}, actualRefunded={}", 
+                userId, amount, actualRefundedAmount);
+    }
+
+    /**
+     * 处理余额不足的情况
+     */
+    private void handleInsufficientBalance(PendingRefund pendingRefund, String reason) {
+        Long userId = pendingRefund.getUserId();
+        Integer attemptCount = pendingRefund.getAttemptCount();
+        
+        // 计算重试延迟:指数退避策略
+        int retryDelayMinutes;
+        if (attemptCount == 0) {
+            retryDelayMinutes = 5;  // 第 1 次失败,5 分钟后重试
+        } else if (attemptCount == 1) {
+            retryDelayMinutes = 10; // 第 2 次失败,10 分钟后重试
+        } else if (attemptCount == 2) {
+            retryDelayMinutes = 20; // 第 3 次失败,20 分钟后重试
+        } else if (attemptCount == 3) {
+            retryDelayMinutes = 30; // 第 4 次失败,30 分钟后重试
+        } else if (attemptCount == 4) {
+            retryDelayMinutes = 60; // 第 5 次失败,1 小时后重试
+        } else {
+            retryDelayMinutes = 120; // 之后每次失败,2 小时后重试
+        }
+
+        pendingRefundService.markFailed(pendingRefund.getId(), reason, retryDelayMinutes);
+
+        log.warn("退款余额不足,延迟重试:userId={}, amount={}, attempt={}, reason={}, retryDelay={}min",
+                userId, pendingRefund.getAmount(), attemptCount, reason, retryDelayMinutes);
+    }
+}

+ 2619 - 2563
cfc-backend/src/main/resources/schema.sql

@@ -1,2569 +1,2625 @@
--- 浠艾福数据库初始化脚本
--- 自动创建表
-
--- 家庭表
-CREATE TABLE IF NOT EXISTS families (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    name VARCHAR(100),
-    invite_code VARCHAR(8) UNIQUE,
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    INDEX idx_invite_code (invite_code)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
--- 用户表
-CREATE TABLE IF NOT EXISTS users (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    openid VARCHAR(64) NOT NULL,
-    unionid VARCHAR(64),
-    family_id BIGINT NOT NULL,
-    role ENUM('parent','child','teacher','supplier_admin') NOT NULL,
-    nickname VARCHAR(50),
-    avatar VARCHAR(255),
-    password VARCHAR(128),
-    id_card VARCHAR(18),
-    real_name VARCHAR(50),
-    phone VARCHAR(11),
-    birthday DATE,
-    gender ENUM('male','female'),
-    birth_hour VARCHAR(10) COMMENT '出生时辰: 子丑寅卯辰巳午未申酉戌亥',
-    mascot VARCHAR(20) DEFAULT NULL COMMENT 'AI助手形象: xibao(浠宝)/fubao(福宝)',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    INDEX idx_openid (openid),
-    INDEX idx_family_id (family_id),
-    INDEX idx_phone (phone)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
--- ============================================================
--- 【已废除】children 表已合并到 family_members
--- 保留此处仅作参考,勿执行
--- ============================================================
--- CREATE TABLE IF NOT EXISTS children (
---     id BIGINT AUTO_INCREMENT PRIMARY KEY,
---     user_id BIGINT NOT NULL,
---     family_id BIGINT NOT NULL,
---     nickname VARCHAR(50) NOT NULL,
---     age TINYINT NOT NULL,
---     birthday DATE,
---     gender ENUM('male','female'),
---     penalty_enabled TINYINT DEFAULT 1 COMMENT '是否开启扣分(0否1是)',
---     theme VARCHAR(32) DEFAULT 'default',
---     total_points INT DEFAULT 0,
---     system_points INT DEFAULT 0 COMMENT '系统积分(测评建档/平台发放)',
---     streak_days INT DEFAULT 0,
---     last_task_date DATE,
---     focus_max_daily TINYINT DEFAULT 3,
---     focus_remaining TINYINT DEFAULT 3,
---     focus_reset_date DATE,
---     created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
---     updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
---     INDEX idx_user_id (user_id),
---     INDEX idx_family_id (family_id)
--- ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
--- 任务表
-CREATE TABLE IF NOT EXISTS tasks (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    family_id BIGINT NOT NULL,
-    creator_id BIGINT NOT NULL,
-    child_id BIGINT COMMENT '执行者ID(child任务时必填,parent任务时可空)',
-    executor_type VARCHAR(20) COMMENT '执行者类型: child/parent',
-    executor_id BIGINT COMMENT '执行者ID',
-    title VARCHAR(200) NOT NULL,
-    description TEXT,
-    points TINYINT DEFAULT 2 COMMENT '任务积分1-10',
-    deadline DATETIME NOT NULL,
-    repeat_type ENUM('none', 'daily', 'weekly') DEFAULT 'none',
-    category VARCHAR(32),
-    need_review TINYINT DEFAULT 0 COMMENT '是否需要审核',
-    review_by_category TINYINT DEFAULT 0 COMMENT '是否按分类审核',
-    status ENUM('pending', 'completed', 'overdue', 'cancelled') DEFAULT 'pending',
-    completed_at DATETIME,
-    bonus_rule JSON COMMENT '积分奖励规则',
-    points_expire_days INT DEFAULT 0 COMMENT '积分有效期天数',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    INDEX idx_child_id_deadline (child_id, deadline),
-    INDEX idx_status (status),
-    INDEX idx_category (category),
-    INDEX idx_executor (executor_type, executor_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
--- 积分流水表
-CREATE TABLE IF NOT EXISTS points_log (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    child_id BIGINT NOT NULL,
-    family_member_id BIGINT COMMENT '家庭成员ID',
-    task_id BIGINT,
-    amount INT NOT NULL COMMENT '积分数量正负',
+-- 浠艾福数据库初始化脚本
+-- 自动创建表
+
+-- 家庭表
+CREATE TABLE IF NOT EXISTS families (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    name VARCHAR(100),
+    invite_code VARCHAR(8) UNIQUE,
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    INDEX idx_invite_code (invite_code)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- 用户表
+CREATE TABLE IF NOT EXISTS users (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    openid VARCHAR(64) NOT NULL,
+    unionid VARCHAR(64),
+    family_id BIGINT NOT NULL,
+    role ENUM('parent','child','teacher','supplier_admin') NOT NULL,
+    nickname VARCHAR(50),
+    avatar VARCHAR(255),
+    password VARCHAR(128),
+    id_card VARCHAR(18),
+    real_name VARCHAR(50),
+    phone VARCHAR(11),
+    birthday DATE,
+    gender ENUM('male','female'),
+    birth_hour VARCHAR(10) COMMENT '出生时辰: 子丑寅卯辰巳午未申酉戌亥',
+    mascot VARCHAR(20) DEFAULT NULL COMMENT 'AI助手形象: xibao(浠宝)/fubao(福宝)',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    INDEX idx_openid (openid),
+    INDEX idx_family_id (family_id),
+    INDEX idx_phone (phone)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- ============================================================
+-- 【已废除】children 表已合并到 family_members
+-- 保留此处仅作参考,勿执行
+-- ============================================================
+-- CREATE TABLE IF NOT EXISTS children (
+--     id BIGINT AUTO_INCREMENT PRIMARY KEY,
+--     user_id BIGINT NOT NULL,
+--     family_id BIGINT NOT NULL,
+--     nickname VARCHAR(50) NOT NULL,
+--     age TINYINT NOT NULL,
+--     birthday DATE,
+--     gender ENUM('male','female'),
+--     penalty_enabled TINYINT DEFAULT 1 COMMENT '是否开启扣分(0否1是)',
+--     theme VARCHAR(32) DEFAULT 'default',
+--     total_points INT DEFAULT 0,
+--     system_points INT DEFAULT 0 COMMENT '系统积分(测评建档/平台发放)',
+--     streak_days INT DEFAULT 0,
+--     last_task_date DATE,
+--     focus_max_daily TINYINT DEFAULT 3,
+--     focus_remaining TINYINT DEFAULT 3,
+--     focus_reset_date DATE,
+--     created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+--     updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+--     INDEX idx_user_id (user_id),
+--     INDEX idx_family_id (family_id)
+-- ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- 任务表
+CREATE TABLE IF NOT EXISTS tasks (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    family_id BIGINT NOT NULL,
+    creator_id BIGINT NOT NULL,
+    child_id BIGINT COMMENT '执行者ID(child任务时必填,parent任务时可空)',
+    executor_type VARCHAR(20) COMMENT '执行者类型: child/parent',
+    executor_id BIGINT COMMENT '执行者ID',
+    title VARCHAR(200) NOT NULL,
+    description TEXT,
+    points TINYINT DEFAULT 2 COMMENT '任务积分1-10',
+    deadline DATETIME NOT NULL,
+    repeat_type ENUM('none', 'daily', 'weekly') DEFAULT 'none',
+    category VARCHAR(32),
+    need_review TINYINT DEFAULT 0 COMMENT '是否需要审核',
+    review_by_category TINYINT DEFAULT 0 COMMENT '是否按分类审核',
+    status ENUM('pending', 'completed', 'overdue', 'cancelled') DEFAULT 'pending',
+    completed_at DATETIME,
+    bonus_rule JSON COMMENT '积分奖励规则',
+    points_expire_days INT DEFAULT 0 COMMENT '积分有效期天数',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    INDEX idx_child_id_deadline (child_id, deadline),
+    INDEX idx_status (status),
+    INDEX idx_category (category),
+    INDEX idx_executor (executor_type, executor_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- 积分流水表
+CREATE TABLE IF NOT EXISTS points_log (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    child_id BIGINT NOT NULL,
+    family_member_id BIGINT COMMENT '家庭成员ID',
+    task_id BIGINT,
+    amount INT NOT NULL COMMENT '积分数量正负',
     type ENUM('earn', 'spend', 'bonus', 'penalty', 'adjust', 'reset', 'refund') NOT NULL,
-    category VARCHAR(20) DEFAULT 'task' COMMENT '积分分类: task-任务积分, system-系统积分',
+    category VARCHAR(20) DEFAULT 'task' COMMENT '积分分类: task-任务积分, system-系统积分',
     description TEXT,
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    INDEX idx_child_id_created (child_id, created_at),
-    INDEX idx_type (type)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
--- 积分清零记录表
-CREATE TABLE IF NOT EXISTS points_reset_log (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    child_id BIGINT NOT NULL,
-    balance_before INT NOT NULL,
-    balance_after INT DEFAULT 0,
-    reset_type ENUM('monthly', 'manual') NOT NULL,
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    INDEX idx_child_id (child_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
--- 奖励表
-CREATE TABLE IF NOT EXISTS rewards (
-id BIGINT AUTO_INCREMENT PRIMARY KEY,
-family_id BIGINT NOT NULL COMMENT '家庭 ID,所有奖励必须关联家庭',
-child_id BIGINT NULL COMMENT '孩子 ID,模板奖励为NULL',
-title VARCHAR(100) NOT NULL,
-points_required INT NOT NULL,
-category VARCHAR(32),
-status ENUM('available', 'pending', 'exchanged', 'rejected') DEFAULT 'available',
-exchange_approved TINYINT COMMENT '是否审批通过',
-exchanged_at DATETIME,
-is_template TINYINT DEFAULT 0 COMMENT '是否为预设模板',
-created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-INDEX idx_family_id (family_id),
-INDEX idx_child_id_status (child_id, status),
-INDEX idx_is_template (is_template)
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    INDEX idx_child_id_created (child_id, created_at),
+    INDEX idx_type (type)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- 积分清零记录表
+CREATE TABLE IF NOT EXISTS points_reset_log (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    child_id BIGINT NOT NULL,
+    balance_before INT NOT NULL,
+    balance_after INT DEFAULT 0,
+    reset_type ENUM('monthly', 'manual') NOT NULL,
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    INDEX idx_child_id (child_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- 奖励表
+CREATE TABLE IF NOT EXISTS rewards (
+id BIGINT AUTO_INCREMENT PRIMARY KEY,
+family_id BIGINT NOT NULL COMMENT '家庭 ID,所有奖励必须关联家庭',
+child_id BIGINT NULL COMMENT '孩子 ID,模板奖励为NULL',
+title VARCHAR(100) NOT NULL,
+points_required INT NOT NULL,
+category VARCHAR(32),
+status ENUM('available', 'pending', 'exchanged', 'rejected') DEFAULT 'available',
+exchange_approved TINYINT COMMENT '是否审批通过',
+exchanged_at DATETIME,
+is_template TINYINT DEFAULT 0 COMMENT '是否为预设模板',
+created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+INDEX idx_family_id (family_id),
+INDEX idx_child_id_status (child_id, status),
+INDEX idx_is_template (is_template)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='奖励表,所有奖励必须关联到具体家庭';
-
--- 奖励分类表
-CREATE TABLE IF NOT EXISTS reward_categories (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    family_id BIGINT NOT NULL,
-    name VARCHAR(32) NOT NULL,
-    icon VARCHAR(64),
-    sort_order INT DEFAULT 0,
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    INDEX idx_family_id (family_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
--- 预设奖励模板数据(child_id为NULL表示模板)
-INSERT IGNORE INTO rewards (family_id, child_id, title, points_required, category, is_template) VALUES
-(0, NULL, '看动画片30分钟', 30, '精神奖励', 1),
-(0, NULL, '玩平板游戏30分钟', 40, '特权奖励', 1),
-(0, NULL, '去游乐场', 100, '物质奖励', 1),
-(0, NULL, '买玩具', 150, '物质奖励', 1),
-(0, NULL, '吃冰淇淋', 20, '物质奖励', 1),
-(0, NULL, '选择晚餐', 25, '特权奖励', 1);
-
--- 默认奖励分类
-INSERT IGNORE INTO reward_categories (family_id, name, icon, sort_order) VALUES
-(0, '物质奖励', 'gift', 1),
-(0, '精神奖励', 'star', 2),
-(0, '特权奖励', 'crown', 3);
-
--- 敏感词表
-CREATE TABLE IF NOT EXISTS sensitive_words (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    word VARCHAR(50) NOT NULL,
-    category VARCHAR(32) NOT NULL,
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    INDEX idx_word (word)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
--- 任务审核表
-CREATE TABLE IF NOT EXISTS task_reviews (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    task_id BIGINT NOT NULL,
-    child_id BIGINT NOT NULL,
-    photo_url VARCHAR(255),
-    voice_note_url VARCHAR(255),
-    ai_result ENUM('pass', 'review', 'pending'),
-    ai_confidence INT COMMENT 'AI置信度(0-100)',
-    ai_suggestion VARCHAR(255),
-    ai_threshold ENUM('strict', 'normal', 'loose') DEFAULT 'normal',
-    parent_result ENUM('pass', 'reject'),
-    parent_override TINYINT DEFAULT 0,
-    review_type ENUM('ai', 'manual') NOT NULL,
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    reviewed_at DATETIME,
-    INDEX idx_task_id (task_id),
-    INDEX idx_ai_result (ai_result)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
--- 打卡里程碑表
-CREATE TABLE IF NOT EXISTS streak_milestones (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    days INT NOT NULL,
-    reward_points INT DEFAULT 0,
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
--- 插入打卡里程碑数据
-INSERT IGNORE INTO streak_milestones (days, reward_points) VALUES
-(3, 5),
-(7, 10),
-(30, 30),
-(100, 100);
-
--- 专注训练记录表
-CREATE TABLE IF NOT EXISTS focus_sessions (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    child_id BIGINT NOT NULL,
-    mode ENUM('simple', 'pomodoro') NOT NULL,
-    duration TINYINT NOT NULL,
-    stars TINYINT COMMENT '评分1-5',
-    points_earned INT,
-    voice_note_url VARCHAR(255),
-    started_at DATETIME NOT NULL,
-    completed_at DATETIME,
-    INDEX idx_child_id_completed (child_id, completed_at)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
--- 专注训练配置表
-CREATE TABLE IF NOT EXISTS focus_config (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    family_id BIGINT,
-    max_daily_count TINYINT DEFAULT 3,
-    allow_exit TINYINT DEFAULT 1 COMMENT '是否允许退出(0否1是)',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
--- DAN测评表
-CREATE TABLE IF NOT EXISTS dan_assessments (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    child_id BIGINT NOT NULL,
-    assessment_date DATE NOT NULL,
-    details JSON,
-    source ENUM('api', 'manual') DEFAULT 'manual',
-    photo_url VARCHAR(255),
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
--- 任务模板表
-CREATE TABLE IF NOT EXISTS task_templates (
-id BIGINT AUTO_INCREMENT PRIMARY KEY,
-title VARCHAR(200) NOT NULL,
-points TINYINT DEFAULT 2,
-duration_minutes TINYINT,
-category VARCHAR(32),
-is_default TINYINT DEFAULT 1,
-family_id BIGINT,
-created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-INDEX idx_is_default (is_default)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
--- 媒体记录表(支持图片、视频、音频、文字)
-CREATE TABLE IF NOT EXISTS media_records (
-id BIGINT AUTO_INCREMENT PRIMARY KEY,
-type ENUM('image', 'video', 'audio', 'text') NOT NULL,
-url VARCHAR(500),
-description TEXT,
-task_id BIGINT NOT NULL,
-creator_id BIGINT NOT NULL,
-original_filename VARCHAR(255),
-file_size BIGINT,
-content_type VARCHAR(100),
-created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-INDEX idx_task_id (task_id),
-INDEX idx_creator_id (creator_id),
-INDEX idx_type (type),
-FOREIGN KEY (task_id) REFERENCES tasks(id) ON DELETE CASCADE,
-FOREIGN KEY (creator_id) REFERENCES users(id) ON DELETE CASCADE
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
--- =============================================
--- 服务商(成长规划师)相关表
--- =============================================
-
--- 服务商表(统一管理 teacher/planner/activity_provider/product_supplier)
-CREATE TABLE IF NOT EXISTS guides (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    user_id BIGINT NOT NULL UNIQUE COMMENT '用户ID(唯一)',
-    type VARCHAR(32) DEFAULT 'teacher' COMMENT '服务商类型: teacher/planner/activity_provider/product_supplier',
-    teacher_no VARCHAR(20) COMMENT '服务商编号',
-    title VARCHAR(50) COMMENT '职称/称号',
-    specialty VARCHAR(200) COMMENT '专长领域',
-    bio TEXT COMMENT '简介',
-    university VARCHAR(200) COMMENT '毕业院校',
-    education_system VARCHAR(32) COMMENT '教育体系(参考education_systems表)',
-    experience_years TINYINT DEFAULT 0 COMMENT '从业年限',
-    rating INT DEFAULT 500 COMMENT '评分(百分位,500=5.00)',
-    total_appointments INT DEFAULT 0 COMMENT '总服务次数',
-    level VARCHAR(20) NOT NULL DEFAULT 'junior' COMMENT '等级: junior-初级, intermediate-中级, senior-高级',
-    status VARCHAR(20) NOT NULL DEFAULT 'active' COMMENT '状态: active-活跃, inactive-停用',
-    service_count INT DEFAULT 0 COMMENT '当前服务家庭数',
-    package_id BIGINT COMMENT '购买套餐ID',
-    nickname VARCHAR(100) COMMENT '申请昵称',
-    phone VARCHAR(20) COMMENT '联系电话',
-    intro TEXT COMMENT '个人介绍',
-    avatar VARCHAR(500) COMMENT '头像URL',
-    commission_rate INT DEFAULT 1000 COMMENT '佣金比例(基点,1000=10%)',
-    street_id BIGINT COMMENT '街道ID',
-    province VARCHAR(50) COMMENT '省份',
-    city VARCHAR(50) COMMENT '城市',
-    district VARCHAR(50) COMMENT '区县',
-    street VARCHAR(100) COMMENT '街道',
-    approved_at DATETIME COMMENT '审核通过时间',
-    verified_at DATETIME COMMENT '认证通过时间',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-    INDEX idx_user_id (user_id),
-    INDEX idx_level (level),
-    INDEX idx_status (status),
-    INDEX idx_type (type)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='服务商表(规划师/活动方/供应商)';
-
--- 测评预约表
-CREATE TABLE IF NOT EXISTS assessment_appointments (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    user_id BIGINT COMMENT '用户ID',
-    family_id BIGINT NOT NULL,
-    child_id BIGINT COMMENT '孩子ID',
-    teacher_id BIGINT COMMENT '教师ID',
-    guide_id BIGINT COMMENT '规划师ID',
-    package_id BIGINT COMMENT '套餐ID',
-    appointment_date VARCHAR(20) COMMENT '预约日期 yyyy-MM-dd',
-    appointment_time VARCHAR(20) COMMENT '预约时间 HH:mm',
-    duration_minutes INT COMMENT '测评时长',
-    status TINYINT DEFAULT 0 COMMENT '0=待确认,1=已确认,2=已完成,3=已取消,4=未到',
-    appointment_type VARCHAR(20) DEFAULT 'initial' COMMENT '初测/复测/回访',
-    notes TEXT COMMENT '备注',
-    remark TEXT COMMENT '补充说明',
-    contact_phone VARCHAR(20),
-    meet_link VARCHAR(255) COMMENT '会议链接',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    INDEX idx_user_id (user_id),
-    INDEX idx_teacher_id (teacher_id),
-    INDEX idx_guide_id (guide_id),
-    INDEX idx_family_id (family_id),
-    INDEX idx_child_id (child_id),
-    INDEX idx_status (status)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
--- DAN测评结果表
-CREATE TABLE IF NOT EXISTS dan_assessment_results (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    child_id BIGINT NOT NULL,
-    family_member_id BIGINT COMMENT '家庭成员ID',
-    family_member_name VARCHAR(50) COMMENT '成员姓名快照',
-    family_member_birthday DATE COMMENT '成员出生日期快照',
-    family_member_gender VARCHAR(10) COMMENT '成员性别快照',
-    family_member_age INT COMMENT '成员年龄快照',
-    teacher_id BIGINT NOT NULL,
-    appointment_id BIGINT,
-    attention_score INT COMMENT '注意力得分',
-    focus_score INT COMMENT '专注力得分',
-    memory_score INT COMMENT '记忆力得分',
-    logic_score INT COMMENT '逻辑思维得分',
-    perception_score INT COMMENT '感知得分',
-    spatial_score INT COMMENT '空间思维得分',
-    processing_speed_score INT COMMENT '加工速度得分',
-    emotion_score INT COMMENT '情绪商数(EMI)',
-    resilience_score INT COMMENT '心理韧性(EMI)',
-    stress_coping_score INT COMMENT '压力应对(EMI)',
-    self_awareness_score INT COMMENT '自我认知(EMI)',
-    emotion_management_score INT COMMENT '情绪管理得分(EMI)',
-    empathy_score INT COMMENT '同理心得分(EMI)',
-    social_adaptability_score INT COMMENT '社会适应得分(EMI)',
-    self_motivation_score INT COMMENT '自我激励得分(EMI)',
-    overall_score INT COMMENT '综合得分',
-    openness_score INT COMMENT '开放性(大五人格)',
-    conscientiousness_score INT COMMENT '尽责性(大五人格)',
-    extraversion_score INT COMMENT '外向性(大五人格)',
-    agreeableness_score INT COMMENT '宜人性(大五人格)',
-    neuroticism_score INT COMMENT '神经质(大五人格)',
-    big_five_overall_score INT COMMENT '大五人格综合分',
-    assessment_date DATE NOT NULL,
-    duration_minutes INT COMMENT '测评时长',
-    game_records JSON COMMENT '游戏记录详情',
-    analysis_report TEXT COMMENT '分析报告',
-    growth_suggestions TEXT COMMENT '成长建议',
-    next_review_date DATE COMMENT '下次复测日期',
-    status ENUM('draft', 'completed', 'archived') DEFAULT 'draft',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    -- 孩子快照字段(测评时保存的完整信息)
-    child_name VARCHAR(50) COMMENT '孩子姓名快照',
-    child_birthday DATE COMMENT '出生日期快照',
-    child_gender VARCHAR(10) COMMENT '性别快照',
-    child_age INT COMMENT '年龄快照',
-    school VARCHAR(100) COMMENT '学校快照',
-    grade VARCHAR(20) COMMENT '年级快照',
-    grade_class VARCHAR(20) COMMENT '班级快照',
-    height INT COMMENT '身高(CM)快照',
-    weight INT COMMENT '体重(KG)快照',
-    family_status VARCHAR(50) COMMENT '家庭状况快照',
-    parent_degree VARCHAR(50) COMMENT '父母最高学历快照',
-    nation VARCHAR(20) COMMENT '民族快照',
-    province VARCHAR(50) COMMENT '省快照',
-    city VARCHAR(50) COMMENT '市快照',
-    district VARCHAR(50) COMMENT '区快照',
-    address VARCHAR(200) COMMENT '详细地址快照',
-    single_child VARCHAR(10) COMMENT '是否独生子女快照',
-    school_score VARCHAR(20) COMMENT '在校成绩快照',
-    urgent_name VARCHAR(50) COMMENT '紧急联系人姓名',
-    urgent_phone VARCHAR(20) COMMENT '紧急联系人电话',
-    -- 媒体字段
-    pics TEXT COMMENT '图片IDs',
-    videos TEXT COMMENT '视频IDs',
-    audio VARCHAR(100) COMMENT '音频ID',
-    audio_url VARCHAR(255) COMMENT '音频URL',
-    -- 扩展描述字段
-    process_desc TEXT COMMENT '过程描述',
-    result_desc TEXT COMMENT '结果简评',
-    source VARCHAR(20) DEFAULT 'planner_entry' COMMENT '报告来源: planner_entry/parent_upload/auto_fetch',
-    INDEX idx_child_id (child_id),
-    INDEX idx_teacher_id (teacher_id),
-    INDEX idx_assessment_date (assessment_date)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='DAN测评结果表';
-
--- 成长规划表
-CREATE TABLE IF NOT EXISTS growth_plans (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    child_id BIGINT NOT NULL,
-    teacher_id BIGINT NOT NULL,
-    assessment_id BIGINT,
-    plan_title VARCHAR(200) NOT NULL,
-    plan_content TEXT NOT NULL COMMENT '规划内容',
-    duration_months TINYINT COMMENT '规划周期(月)',
-    status ENUM('draft', 'active', 'completed', 'expired') DEFAULT 'draft',
-    start_date DATE,
-    end_date DATE,
-    review_count INT DEFAULT 0 COMMENT '已复盘次数',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    INDEX idx_child_id (child_id),
-    INDEX idx_teacher_id (teacher_id),
-    INDEX idx_status (status)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
--- =============================================
--- 成长档案表
--- =============================================
-CREATE TABLE IF NOT EXISTS growth_records (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    child_id BIGINT NOT NULL COMMENT '孩子ID',
-    parent_id BIGINT NOT NULL COMMENT '家长用户ID',
-    assessment_id BIGINT COMMENT '关联的测评结果ID',
-    record_title VARCHAR(200) COMMENT '档案标题',
-    child_age INT COMMENT '孩子当时年龄(月)',
-    height VARCHAR(20) COMMENT '身高',
-    weight VARCHAR(20) COMMENT '体重',
-    assessment_summary TEXT COMMENT '测评摘要',
-    overall_score INT COMMENT '综合得分',
-    growth_suggestions TEXT COMMENT '成长建议',
-    task_recommendations TEXT COMMENT '任务推荐(JSON)',
-    status VARCHAR(20) DEFAULT 'pending' COMMENT '状态: pending/completed',
-    external_sync TINYINT DEFAULT 0 COMMENT '是否来自外部系统同步',
-    external_source VARCHAR(100) COMMENT '外部系统来源',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    INDEX idx_child_id (child_id),
-    INDEX idx_parent_id (parent_id),
-    INDEX idx_status (status)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
--- =============================================
+
+-- 奖励分类表
+CREATE TABLE IF NOT EXISTS reward_categories (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    family_id BIGINT NOT NULL,
+    name VARCHAR(32) NOT NULL,
+    icon VARCHAR(64),
+    sort_order INT DEFAULT 0,
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    INDEX idx_family_id (family_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- 预设奖励模板数据(child_id为NULL表示模板)
+INSERT IGNORE INTO rewards (family_id, child_id, title, points_required, category, is_template) VALUES
+(0, NULL, '看动画片30分钟', 30, '精神奖励', 1),
+(0, NULL, '玩平板游戏30分钟', 40, '特权奖励', 1),
+(0, NULL, '去游乐场', 100, '物质奖励', 1),
+(0, NULL, '买玩具', 150, '物质奖励', 1),
+(0, NULL, '吃冰淇淋', 20, '物质奖励', 1),
+(0, NULL, '选择晚餐', 25, '特权奖励', 1);
+
+-- 默认奖励分类
+INSERT IGNORE INTO reward_categories (family_id, name, icon, sort_order) VALUES
+(0, '物质奖励', 'gift', 1),
+(0, '精神奖励', 'star', 2),
+(0, '特权奖励', 'crown', 3);
+
+-- 敏感词表
+CREATE TABLE IF NOT EXISTS sensitive_words (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    word VARCHAR(50) NOT NULL,
+    category VARCHAR(32) NOT NULL,
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    INDEX idx_word (word)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- 任务审核表
+CREATE TABLE IF NOT EXISTS task_reviews (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    task_id BIGINT NOT NULL,
+    child_id BIGINT NOT NULL,
+    photo_url VARCHAR(255),
+    voice_note_url VARCHAR(255),
+    ai_result ENUM('pass', 'review', 'pending'),
+    ai_confidence INT COMMENT 'AI置信度(0-100)',
+    ai_suggestion VARCHAR(255),
+    ai_threshold ENUM('strict', 'normal', 'loose') DEFAULT 'normal',
+    parent_result ENUM('pass', 'reject'),
+    parent_override TINYINT DEFAULT 0,
+    review_type ENUM('ai', 'manual') NOT NULL,
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    reviewed_at DATETIME,
+    INDEX idx_task_id (task_id),
+    INDEX idx_ai_result (ai_result)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- 打卡里程碑表
+CREATE TABLE IF NOT EXISTS streak_milestones (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    days INT NOT NULL,
+    reward_points INT DEFAULT 0,
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- 插入打卡里程碑数据
+INSERT IGNORE INTO streak_milestones (days, reward_points) VALUES
+(3, 5),
+(7, 10),
+(30, 30),
+(100, 100);
+
+-- 专注训练记录表
+CREATE TABLE IF NOT EXISTS focus_sessions (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    child_id BIGINT NOT NULL,
+    mode ENUM('simple', 'pomodoro') NOT NULL,
+    duration TINYINT NOT NULL,
+    stars TINYINT COMMENT '评分1-5',
+    points_earned INT,
+    voice_note_url VARCHAR(255),
+    started_at DATETIME NOT NULL,
+    completed_at DATETIME,
+    INDEX idx_child_id_completed (child_id, completed_at)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- 专注训练配置表
+CREATE TABLE IF NOT EXISTS focus_config (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    family_id BIGINT,
+    max_daily_count TINYINT DEFAULT 3,
+    allow_exit TINYINT DEFAULT 1 COMMENT '是否允许退出(0否1是)',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- DAN测评表
+CREATE TABLE IF NOT EXISTS dan_assessments (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    child_id BIGINT NOT NULL,
+    assessment_date DATE NOT NULL,
+    details JSON,
+    source ENUM('api', 'manual') DEFAULT 'manual',
+    photo_url VARCHAR(255),
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- 任务模板表
+CREATE TABLE IF NOT EXISTS task_templates (
+id BIGINT AUTO_INCREMENT PRIMARY KEY,
+title VARCHAR(200) NOT NULL,
+points TINYINT DEFAULT 2,
+duration_minutes TINYINT,
+category VARCHAR(32),
+is_default TINYINT DEFAULT 1,
+family_id BIGINT,
+created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+INDEX idx_is_default (is_default)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- 媒体记录表(支持图片、视频、音频、文字)
+CREATE TABLE IF NOT EXISTS media_records (
+id BIGINT AUTO_INCREMENT PRIMARY KEY,
+type ENUM('image', 'video', 'audio', 'text') NOT NULL,
+url VARCHAR(500),
+description TEXT,
+task_id BIGINT NOT NULL,
+creator_id BIGINT NOT NULL,
+original_filename VARCHAR(255),
+file_size BIGINT,
+content_type VARCHAR(100),
+created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+INDEX idx_task_id (task_id),
+INDEX idx_creator_id (creator_id),
+INDEX idx_type (type),
+FOREIGN KEY (task_id) REFERENCES tasks(id) ON DELETE CASCADE,
+FOREIGN KEY (creator_id) REFERENCES users(id) ON DELETE CASCADE
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- =============================================
+-- 服务商(成长规划师)相关表
+-- =============================================
+
+-- 服务商表(统一管理 teacher/planner/activity_provider/product_supplier)
+CREATE TABLE IF NOT EXISTS guides (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    user_id BIGINT NOT NULL UNIQUE COMMENT '用户ID(唯一)',
+    type VARCHAR(32) DEFAULT 'teacher' COMMENT '服务商类型: teacher/planner/activity_provider/product_supplier',
+    teacher_no VARCHAR(20) COMMENT '服务商编号',
+    title VARCHAR(50) COMMENT '职称/称号',
+    specialty VARCHAR(200) COMMENT '专长领域',
+    bio TEXT COMMENT '简介',
+    university VARCHAR(200) COMMENT '毕业院校',
+    education_system VARCHAR(32) COMMENT '教育体系(参考education_systems表)',
+    experience_years TINYINT DEFAULT 0 COMMENT '从业年限',
+    rating INT DEFAULT 500 COMMENT '评分(百分位,500=5.00)',
+    total_appointments INT DEFAULT 0 COMMENT '总服务次数',
+    level VARCHAR(20) NOT NULL DEFAULT 'junior' COMMENT '等级: junior-初级, intermediate-中级, senior-高级',
+    status VARCHAR(20) NOT NULL DEFAULT 'active' COMMENT '状态: active-活跃, inactive-停用',
+    service_count INT DEFAULT 0 COMMENT '当前服务家庭数',
+    package_id BIGINT COMMENT '购买套餐ID',
+    nickname VARCHAR(100) COMMENT '申请昵称',
+    phone VARCHAR(20) COMMENT '联系电话',
+    intro TEXT COMMENT '个人介绍',
+    avatar VARCHAR(500) COMMENT '头像URL',
+    commission_rate INT DEFAULT 1000 COMMENT '佣金比例(基点,1000=10%)',
+    street_id BIGINT COMMENT '街道ID',
+    province VARCHAR(50) COMMENT '省份',
+    city VARCHAR(50) COMMENT '城市',
+    district VARCHAR(50) COMMENT '区县',
+    street VARCHAR(100) COMMENT '街道',
+    approved_at DATETIME COMMENT '审核通过时间',
+    verified_at DATETIME COMMENT '认证通过时间',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+    INDEX idx_user_id (user_id),
+    INDEX idx_level (level),
+    INDEX idx_status (status),
+    INDEX idx_type (type)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='服务商表(规划师/活动方/供应商)';
+
+-- 测评预约表
+CREATE TABLE IF NOT EXISTS assessment_appointments (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    user_id BIGINT COMMENT '用户ID',
+    family_id BIGINT NOT NULL,
+    child_id BIGINT COMMENT '孩子ID',
+    teacher_id BIGINT COMMENT '教师ID',
+    guide_id BIGINT COMMENT '规划师ID',
+    package_id BIGINT COMMENT '套餐ID',
+    appointment_date VARCHAR(20) COMMENT '预约日期 yyyy-MM-dd',
+    appointment_time VARCHAR(20) COMMENT '预约时间 HH:mm',
+    duration_minutes INT COMMENT '测评时长',
+    status TINYINT DEFAULT 0 COMMENT '0=待确认,1=已确认,2=已完成,3=已取消,4=未到',
+    appointment_type VARCHAR(20) DEFAULT 'initial' COMMENT '初测/复测/回访',
+    notes TEXT COMMENT '备注',
+    remark TEXT COMMENT '补充说明',
+    contact_phone VARCHAR(20),
+    meet_link VARCHAR(255) COMMENT '会议链接',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    INDEX idx_user_id (user_id),
+    INDEX idx_teacher_id (teacher_id),
+    INDEX idx_guide_id (guide_id),
+    INDEX idx_family_id (family_id),
+    INDEX idx_child_id (child_id),
+    INDEX idx_status (status)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- DAN测评结果表
+CREATE TABLE IF NOT EXISTS dan_assessment_results (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    child_id BIGINT NOT NULL,
+    family_member_id BIGINT COMMENT '家庭成员ID',
+    family_member_name VARCHAR(50) COMMENT '成员姓名快照',
+    family_member_birthday DATE COMMENT '成员出生日期快照',
+    family_member_gender VARCHAR(10) COMMENT '成员性别快照',
+    family_member_age INT COMMENT '成员年龄快照',
+    teacher_id BIGINT NOT NULL,
+    appointment_id BIGINT,
+    attention_score INT COMMENT '注意力得分',
+    focus_score INT COMMENT '专注力得分',
+    memory_score INT COMMENT '记忆力得分',
+    logic_score INT COMMENT '逻辑思维得分',
+    perception_score INT COMMENT '感知得分',
+    spatial_score INT COMMENT '空间思维得分',
+    processing_speed_score INT COMMENT '加工速度得分',
+    emotion_score INT COMMENT '情绪商数(EMI)',
+    resilience_score INT COMMENT '心理韧性(EMI)',
+    stress_coping_score INT COMMENT '压力应对(EMI)',
+    self_awareness_score INT COMMENT '自我认知(EMI)',
+    emotion_management_score INT COMMENT '情绪管理得分(EMI)',
+    empathy_score INT COMMENT '同理心得分(EMI)',
+    social_adaptability_score INT COMMENT '社会适应得分(EMI)',
+    self_motivation_score INT COMMENT '自我激励得分(EMI)',
+    overall_score INT COMMENT '综合得分',
+    openness_score INT COMMENT '开放性(大五人格)',
+    conscientiousness_score INT COMMENT '尽责性(大五人格)',
+    extraversion_score INT COMMENT '外向性(大五人格)',
+    agreeableness_score INT COMMENT '宜人性(大五人格)',
+    neuroticism_score INT COMMENT '神经质(大五人格)',
+    big_five_overall_score INT COMMENT '大五人格综合分',
+    assessment_date DATE NOT NULL,
+    duration_minutes INT COMMENT '测评时长',
+    game_records JSON COMMENT '游戏记录详情',
+    analysis_report TEXT COMMENT '分析报告',
+    growth_suggestions TEXT COMMENT '成长建议',
+    next_review_date DATE COMMENT '下次复测日期',
+    status ENUM('draft', 'completed', 'archived') DEFAULT 'draft',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    -- 孩子快照字段(测评时保存的完整信息)
+    child_name VARCHAR(50) COMMENT '孩子姓名快照',
+    child_birthday DATE COMMENT '出生日期快照',
+    child_gender VARCHAR(10) COMMENT '性别快照',
+    child_age INT COMMENT '年龄快照',
+    school VARCHAR(100) COMMENT '学校快照',
+    grade VARCHAR(20) COMMENT '年级快照',
+    grade_class VARCHAR(20) COMMENT '班级快照',
+    height INT COMMENT '身高(CM)快照',
+    weight INT COMMENT '体重(KG)快照',
+    family_status VARCHAR(50) COMMENT '家庭状况快照',
+    parent_degree VARCHAR(50) COMMENT '父母最高学历快照',
+    nation VARCHAR(20) COMMENT '民族快照',
+    province VARCHAR(50) COMMENT '省快照',
+    city VARCHAR(50) COMMENT '市快照',
+    district VARCHAR(50) COMMENT '区快照',
+    address VARCHAR(200) COMMENT '详细地址快照',
+    single_child VARCHAR(10) COMMENT '是否独生子女快照',
+    school_score VARCHAR(20) COMMENT '在校成绩快照',
+    urgent_name VARCHAR(50) COMMENT '紧急联系人姓名',
+    urgent_phone VARCHAR(20) COMMENT '紧急联系人电话',
+    -- 媒体字段
+    pics TEXT COMMENT '图片IDs',
+    videos TEXT COMMENT '视频IDs',
+    audio VARCHAR(100) COMMENT '音频ID',
+    audio_url VARCHAR(255) COMMENT '音频URL',
+    -- 扩展描述字段
+    process_desc TEXT COMMENT '过程描述',
+    result_desc TEXT COMMENT '结果简评',
+    source VARCHAR(20) DEFAULT 'planner_entry' COMMENT '报告来源: planner_entry/parent_upload/auto_fetch',
+    INDEX idx_child_id (child_id),
+    INDEX idx_teacher_id (teacher_id),
+    INDEX idx_assessment_date (assessment_date)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='DAN测评结果表';
+
+-- 成长规划表
+CREATE TABLE IF NOT EXISTS growth_plans (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    child_id BIGINT NOT NULL,
+    teacher_id BIGINT NOT NULL,
+    assessment_id BIGINT,
+    plan_title VARCHAR(200) NOT NULL,
+    plan_content TEXT NOT NULL COMMENT '规划内容',
+    duration_months TINYINT COMMENT '规划周期(月)',
+    status ENUM('draft', 'active', 'completed', 'expired') DEFAULT 'draft',
+    start_date DATE,
+    end_date DATE,
+    review_count INT DEFAULT 0 COMMENT '已复盘次数',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    INDEX idx_child_id (child_id),
+    INDEX idx_teacher_id (teacher_id),
+    INDEX idx_status (status)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- =============================================
+-- 成长档案表
+-- =============================================
+CREATE TABLE IF NOT EXISTS growth_records (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    child_id BIGINT NOT NULL COMMENT '孩子ID',
+    parent_id BIGINT NOT NULL COMMENT '家长用户ID',
+    assessment_id BIGINT COMMENT '关联的测评结果ID',
+    record_title VARCHAR(200) COMMENT '档案标题',
+    child_age INT COMMENT '孩子当时年龄(月)',
+    height VARCHAR(20) COMMENT '身高',
+    weight VARCHAR(20) COMMENT '体重',
+    assessment_summary TEXT COMMENT '测评摘要',
+    overall_score INT COMMENT '综合得分',
+    growth_suggestions TEXT COMMENT '成长建议',
+    task_recommendations TEXT COMMENT '任务推荐(JSON)',
+    status VARCHAR(20) DEFAULT 'pending' COMMENT '状态: pending/completed',
+    external_sync TINYINT DEFAULT 0 COMMENT '是否来自外部系统同步',
+    external_source VARCHAR(100) COMMENT '外部系统来源',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    INDEX idx_child_id (child_id),
+    INDEX idx_parent_id (parent_id),
+    INDEX idx_status (status)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- =============================================
 -- 数据库迁移(新增字段和表)- 通过Java代码处理
--- =============================================
-
--- 注意:ALTER TABLE语句已移到 DatabaseInitializer.java 中执行
--- 避免重复执行导致的错误
-
--- 3. 家长心愿单表(新增)
-CREATE TABLE IF NOT EXISTS reward_wishlists (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    user_id BIGINT NOT NULL COMMENT '创建者用户ID',
-    family_id BIGINT NOT NULL COMMENT '家庭ID',
-    title VARCHAR(100) NOT NULL COMMENT '心愿名称',
-    description TEXT COMMENT '心愿描述',
-    points_required INT NOT NULL COMMENT '所需积分',
-    category VARCHAR(32) COMMENT '分类',
-    image_url VARCHAR(255) COMMENT '图片链接',
-    status ENUM('available', 'pending', 'exchanged', 'rejected') DEFAULT 'available' COMMENT '状态',
-    exchange_approved TINYINT COMMENT '是否审批通过',
-    exchanged_at DATETIME COMMENT '兑换时间',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    INDEX idx_user_id (user_id),
-    INDEX idx_family_id (family_id),
-    INDEX idx_status (status)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
--- 4. 更新任务状态枚举(如果需要支持更多状态)
--- ALTER TABLE tasks MODIFY COLUMN status ENUM('pending', 'completed', 'overdue', 'cancelled', 'parent_pending', 'parent_completed') DEFAULT 'pending';
-
--- ===================== 任务模板套餐功能 =====================
-
--- 成长规划师-家庭关系表
-CREATE TABLE IF NOT EXISTS guide_families (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    guide_id BIGINT NOT NULL COMMENT '成长规划师用户ID',
-    family_id BIGINT NOT NULL COMMENT '家庭ID',
-    service_type VARCHAR(20) DEFAULT 'consulting' COMMENT '服务类型: monthly/yearly/consulting',
-    service_price INT DEFAULT 0 COMMENT '服务价格(分)',
-    status VARCHAR(20) DEFAULT 'binding' COMMENT '状态: binding/paused/cancelled',
-    bound_at DATETIME COMMENT '绑定时间',
-    expire_at DATETIME COMMENT '服务到期时间',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    UNIQUE KEY uk_guide_family (guide_id, family_id),
-    INDEX idx_guide_id (guide_id),
-    INDEX idx_family_id (family_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
--- 任务模板套餐
-CREATE TABLE IF NOT EXISTS task_template_packages (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    creator_id BIGINT NOT NULL COMMENT '创建者成长规划师ID',
-    name VARCHAR(100) NOT NULL COMMENT '套餐名称',
-    description TEXT COMMENT '详细介绍',
-    cycle_days INT NOT NULL COMMENT '周期天数',
-    category VARCHAR(50) COMMENT '分类',
-    tags JSON COMMENT '标签',
-    price INT DEFAULT 0 COMMENT '售价(分)',
-    platform_fee INT DEFAULT 0 COMMENT '平台服务费(基点)',
-    is_public TINYINT DEFAULT 0 COMMENT '是否公开',
-    share_code VARCHAR(50) UNIQUE COMMENT '分享码',
-    cover_image VARCHAR(500) COMMENT '封面图',
-    status VARCHAR(20) DEFAULT 'draft' COMMENT '状态',
-    reviewer_id BIGINT COMMENT '审核人',
-    reviewed_at DATETIME COMMENT '审核时间',
-    reject_reason TEXT COMMENT '拒绝原因',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    INDEX idx_creator_id (creator_id),
-    INDEX idx_status (status),
-    INDEX idx_is_public (is_public)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
--- 套餐内任务项
-CREATE TABLE IF NOT EXISTS task_template_items (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    package_id BIGINT NOT NULL COMMENT '所属套餐ID',
-    task_name VARCHAR(100) NOT NULL,
-    description TEXT,
-    points INT DEFAULT 0,
-    frequency VARCHAR(20) DEFAULT 'daily',
-    duration INT COMMENT '预计时长(分钟)',
-    is_required TINYINT DEFAULT 0,
-    sort_order INT DEFAULT 0,
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    INDEX idx_package_id (package_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
--- 套餐应用实例
-CREATE TABLE IF NOT EXISTS task_plan_instances (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    package_id BIGINT NOT NULL,
-    family_id BIGINT NOT NULL,
-    child_id BIGINT NOT NULL,
-    name VARCHAR(100) NOT NULL,
-    start_date DATE NOT NULL,
-    end_date DATE NOT NULL,
-    status VARCHAR(20) DEFAULT 'active',
-    total_days INT,
-    completed_days INT DEFAULT 0,
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    INDEX idx_family_id (family_id),
-    INDEX idx_child_id (child_id),
-    INDEX idx_status (status)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
--- 实例任务项
-CREATE TABLE IF NOT EXISTS task_plan_items (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    instance_id BIGINT NOT NULL,
-    template_item_id BIGINT,
-    task_name VARCHAR(100) NOT NULL,
-    description TEXT,
-    points INT DEFAULT 0,
-    frequency VARCHAR(20) DEFAULT 'daily',
-    duration INT,
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    INDEX idx_instance_id (instance_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
--- 套餐购买订单
-CREATE TABLE IF NOT EXISTS package_orders (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    order_no VARCHAR(32) UNIQUE NOT NULL,
-    user_id BIGINT NOT NULL COMMENT '购买者用户ID',
-    family_id BIGINT NOT NULL COMMENT '家庭ID',
-    package_id BIGINT NOT NULL COMMENT '套餐ID',
-    package_name VARCHAR(100) COMMENT '套餐名称',
-    price INT NOT NULL COMMENT '支付金额(分)',
-    platform_fee INT DEFAULT 0 COMMENT '平台服务费(分)',
-    user_coupon_id BIGINT COMMENT '使用的用户优惠券ID',
-    guide_id BIGINT COMMENT '成长规划师ID',
-    status VARCHAR(20) DEFAULT 'pending' COMMENT '状态: pending/paid/cancelled/refunded',
-    pay_method VARCHAR(20) COMMENT '支付方式',
-    transaction_id VARCHAR(64) COMMENT '微信支付订单号',
-    paid_at DATETIME COMMENT '支付时间',
-    notify_data TEXT COMMENT '支付回调数据',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    INDEX idx_user_id (user_id),
-    INDEX idx_family_id (family_id),
-    INDEX idx_package_id (package_id),
-    INDEX idx_status (status)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
--- 用户表增加成长规划师相关字段 - 已移到 DatabaseInitializer.java 执行
--- ALTER TABLE users ADD COLUMN teacher_no VARCHAR(50) COMMENT '成长规划师证书号';
--- ALTER TABLE users ADD COLUMN teacher_photo VARCHAR(500) COMMENT '成长规划师照片';
--- ALTER TABLE users ADD COLUMN certificate_image VARCHAR(500) COMMENT '成长规划师证书照片';
--- ALTER TABLE users ADD COLUMN teacher_status VARCHAR(20) DEFAULT 'pending' COMMENT '成长规划师审核状态: pending/approved/rejected';
--- ALTER TABLE users ADD INDEX idx_teacher_status (teacher_status);
-
--- 成长规划师咨询消息表
-CREATE TABLE IF NOT EXISTS teacher_messages (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    family_id BIGINT NOT NULL COMMENT '家庭ID',
-    parent_id BIGINT NOT NULL COMMENT '家长用户ID',
-    teacher_id BIGINT NOT NULL COMMENT '成长规划师用户ID',
-    content TEXT NOT NULL COMMENT '消息内容',
-    reply_content TEXT COMMENT '回复内容',
-    status VARCHAR(20) DEFAULT 'pending' COMMENT '状态:pending/replied',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    replied_at DATETIME COMMENT '回复时间',
-    INDEX idx_family_id (family_id),
-    INDEX idx_teacher_id (teacher_id),
-    INDEX idx_parent_id (parent_id),
-    INDEX idx_status (status)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
--- 游戏记录表(专注训练模块)
-CREATE TABLE IF NOT EXISTS game_records (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    child_id BIGINT NOT NULL COMMENT '孩子ID',
-    game_code VARCHAR(20) NOT NULL COMMENT '游戏代码',
-    score INT DEFAULT 0 COMMENT '得分(0-100)',
-    completion_time INT COMMENT '完成用时(秒)',
-    difficulty VARCHAR(20) DEFAULT 'medium' COMMENT '难度(easy/medium/hard)',
-    points_earned INT DEFAULT 0 COMMENT '获得积分',
-    played_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '游玩时间',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    INDEX idx_child_id (child_id),
-    INDEX idx_game_code (game_code),
-    INDEX idx_played_at (played_at)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
--- 勋章定义表
-CREATE TABLE IF NOT EXISTS badge (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    badge_id VARCHAR(50) UNIQUE NOT NULL COMMENT '勋章唯一标识',
-    name VARCHAR(100) NOT NULL COMMENT '勋章名称',
-    description TEXT COMMENT '勋章描述',
-    icon VARCHAR(255) COMMENT '勋章图标',
-    category VARCHAR(20) COMMENT '分类(学习/运动/家务/阅读/打卡/综合)',
-    level VARCHAR(20) COMMENT '等级(铜牌/银牌/金牌/钻石)',
-    rarity VARCHAR(20) COMMENT '稀有度(普通/稀有/史诗/传说)',
-    trigger_type VARCHAR(20) COMMENT '触发类型(task_count/streak_days/points_total/reward_count/custom)',
-    threshold INT DEFAULT 0 COMMENT '阈值',
-    need_approval TINYINT DEFAULT 0 COMMENT '是否需要审批',
-    expire_days INT DEFAULT -1 COMMENT '有效期天数(-1永久)',
-    sort_order INT DEFAULT 0 COMMENT '排序',
-    is_active TINYINT DEFAULT 1 COMMENT '是否启用',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    INDEX idx_category (category),
-    INDEX idx_is_active (is_active)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
--- 儿童勋章关联表
-CREATE TABLE IF NOT EXISTS child_badge (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    child_id BIGINT NOT NULL COMMENT '孩子ID',
-    badge_id BIGINT NOT NULL COMMENT '勋章ID',
-    earned_at DATETIME COMMENT '获得时间',
-    expire_at DATETIME COMMENT '过期时间',
-    status TINYINT DEFAULT 1 COMMENT '状态:1有效 0过期 -1撤销',
-    is_favorite TINYINT DEFAULT 0 COMMENT '是否收藏',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    UNIQUE KEY uk_child_badge (child_id, badge_id),
-    INDEX idx_child_id (child_id),
-    INDEX idx_badge_id (badge_id),
-    INDEX idx_status (status)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
--- =============================================
--- 以下表从 DatabaseInitializer.java 提取
--- 管理后台表
--- =============================================
-
--- 管理员表
-CREATE TABLE IF NOT EXISTS admins (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    username VARCHAR(50) NOT NULL COMMENT '用户名',
-    password VARCHAR(128) NOT NULL COMMENT '密码(MD5加密)',
-    nickname VARCHAR(50) COMMENT '昵称',
-    real_name VARCHAR(50) COMMENT '真实姓名',
-    phone VARCHAR(11) COMMENT '手机号',
-    email VARCHAR(100) COMMENT '邮箱',
-    role VARCHAR(20) DEFAULT 'admin' COMMENT '角色: admin/teacher',
-    status TINYINT DEFAULT 1 COMMENT '状态:1启用0禁用',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-    INDEX idx_phone (phone),
-    INDEX idx_username (username)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='管理员表';
-
--- 验证码表
-CREATE TABLE IF NOT EXISTS verification_codes (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    phone VARCHAR(11) NOT NULL COMMENT '手机号',
-    code VARCHAR(6) NOT NULL COMMENT '验证码',
-    type VARCHAR(20) NOT NULL COMMENT '验证码类型',
-    expires_in INT DEFAULT 300 COMMENT '过期时间(秒)',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    expires_at DATETIME NOT NULL COMMENT '过期时间',
-    used TINYINT DEFAULT 0 COMMENT '是否已使用:0否1是',
-    INDEX idx_phone_type (phone, type),
-    INDEX idx_expires_at (expires_at)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='验证码表';
-
--- 管理后台任务模板表
-CREATE TABLE IF NOT EXISTS admin_task_templates (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    title VARCHAR(200) NOT NULL COMMENT '模板标题',
-    description TEXT COMMENT '模板描述',
-    points INT DEFAULT 10 COMMENT '默认积分',
-    category VARCHAR(32) COMMENT '任务分类',
-    need_review TINYINT DEFAULT 0 COMMENT '是否需要审核:0否1是',
-    review_by_category TINYINT DEFAULT 0 COMMENT '是否按分类审核:0否1是',
-    recommended_age INT COMMENT '推荐年龄',
-    difficulty ENUM('easy', 'medium', 'hard') DEFAULT 'medium' COMMENT '难度: easy/medium/hard',
-    teacher_id BIGINT COMMENT '成长规划师ID',
-    complete_types VARCHAR(100) COMMENT '完成方式JSON',
-    duration INT COMMENT '预计完成时长(分钟)',
-    review_type VARCHAR(20) COMMENT '审核人类型: creator/parent/teacher/ai',
-    task_type VARCHAR(20) COMMENT '任务性质: onetime/recurring',
-    frequency VARCHAR(20) COMMENT '频率: daily/weekly/monthly',
-    max_frequency INT COMMENT '周期内最多完成次数',
-    is_active TINYINT DEFAULT 1 COMMENT '是否启用:0禁用1启用',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-    INDEX idx_category (category),
-    INDEX idx_difficulty (difficulty),
-    INDEX idx_is_active (is_active)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='管理后台任务模板表';
-
--- =============================================
--- 测评模块表
--- =============================================
-
--- 测评资料表
--- 数学闯关 - 孩子当前等级
-CREATE TABLE IF NOT EXISTS math_child_level (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    child_id BIGINT NOT NULL UNIQUE,
-    current_level TINYINT NOT NULL DEFAULT 1 COMMENT '1=一位数加减,2=两位数加减,3=一位数四则,4=两位数四则',
-    total_passed INT DEFAULT 0 COMMENT '累计通关次数',
-    best_time_ms BIGINT DEFAULT NULL COMMENT '最佳用时(毫秒)',
-    best_accuracy INT DEFAULT NULL COMMENT '最佳正确率(%)',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    INDEX idx_child_id (child_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
--- 数学闯关 - 通关日志
-CREATE TABLE IF NOT EXISTS math_quiz_logs (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    child_id BIGINT NOT NULL,
-    level TINYINT NOT NULL COMMENT '闯关时等级',
-    target_n INT NOT NULL COMMENT '目标连续答对数',
-    correct_count INT NOT NULL COMMENT '实际连续答对数',
-    total_attempts INT NOT NULL COMMENT '总答题数',
-    total_time_ms BIGINT NOT NULL COMMENT '总用时(毫秒)',
-    accuracy INT NOT NULL COMMENT '正确率(%)',
-    passed TINYINT(1) DEFAULT 0 COMMENT '是否通关',
-    exprs TEXT COMMENT '本轮表达式列表(JSON)',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    INDEX idx_child_id (child_id),
-    INDEX idx_level (level)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
-CREATE TABLE IF NOT EXISTS assessment_materials (
-    id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT '主键',
-    title VARCHAR(100) NOT NULL COMMENT '资料标题',
-    content TEXT COMMENT '测评介绍内容',
-    cover_image VARCHAR(255) COMMENT '封面图片',
-    status VARCHAR(20) DEFAULT 'active' COMMENT '状态:active/inactive',
-    created_at DATETIME COMMENT '创建时间',
-    updated_at DATETIME COMMENT '更新时间',
-    INDEX idx_status (status)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='测评资料表';
-
--- 积分配置表
-CREATE TABLE IF NOT EXISTS assessment_points_config (
-    id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT '主键',
-    points_value INT DEFAULT 100 COMMENT '完成测评获得积分',
-    points_value_yuan INT DEFAULT 1 COMMENT '1积分等于多少分(原元→现分)',
-    is_active TINYINT DEFAULT 1 COMMENT '是否启用',
-    created_at DATETIME COMMENT '创建时间',
-    updated_at DATETIME COMMENT '更新时间'
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='积分配置表';
-
--- 家庭测评配置表
-CREATE TABLE IF NOT EXISTS family_assessment_config (
-    id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT '主键',
-    family_id BIGINT NOT NULL COMMENT '家庭ID',
-    material_id BIGINT COMMENT '测评资料ID',
-    remind_months INT DEFAULT 12 COMMENT '提醒周期(月)',
-    last_remind_at DATETIME COMMENT '上次提醒时间',
-    next_remind_at DATETIME COMMENT '下次提醒时间',
-    is_enabled TINYINT DEFAULT 1 COMMENT '是否启用:1启用0关闭',
-    created_by BIGINT COMMENT '创建人(规划师ID)',
-    created_at DATETIME COMMENT '创建时间',
-    updated_at DATETIME COMMENT '更新时间',
-    UNIQUE KEY uk_family (family_id),
-    INDEX idx_next_remind (next_remind_at),
-    INDEX idx_enabled (is_enabled)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='家庭测评配置表';
-
--- 测评记录表
-CREATE TABLE IF NOT EXISTS assessment_records (
-    id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT '主键',
-    family_id BIGINT COMMENT '家庭ID',
-    child_id BIGINT COMMENT '孩子ID',
-    material_id BIGINT COMMENT '测评资料ID',
-    status VARCHAR(20) DEFAULT 'pending' COMMENT '状态:pending待完成/completed已完成',
-    completed_at DATETIME COMMENT '完成时间',
-    created_at DATETIME COMMENT '创建时间',
-    INDEX idx_family (family_id),
-    INDEX idx_status (status)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='测评记录表';
-
--- 评估订单表(测评订单)
-CREATE TABLE IF NOT EXISTS assessment_orders (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    order_no VARCHAR(64) NOT NULL UNIQUE COMMENT '订单编号',
-    family_id BIGINT NOT NULL COMMENT '家庭ID',
-    user_id BIGINT NOT NULL COMMENT '用户ID',
-    child_id BIGINT COMMENT '孩子ID',
-    guide_id BIGINT NOT NULL COMMENT '成长规划师ID',
-    package_id BIGINT NOT NULL COMMENT '套餐ID',
-    appointment_id BIGINT COMMENT '关联预约ID',
-    guide_name VARCHAR(50) COMMENT '规划师名称',
-    package_name VARCHAR(100) COMMENT '套餐名称',
-    total_price BIGINT DEFAULT 0 COMMENT '总价(分)',
-    discount_amount BIGINT DEFAULT 0 COMMENT '优惠金额(分)',
-    actual_price BIGINT DEFAULT 0 COMMENT '实付金额(分)',
-    status VARCHAR(20) DEFAULT 'pending' COMMENT '状态: pending/paid/completed/cancelled/refunded',
-    pay_time VARCHAR(50) COMMENT '支付时间',
-    pay_type VARCHAR(20) COMMENT '支付方式',
-    transaction_id VARCHAR(64) COMMENT '交易流水号',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-    INDEX idx_family (family_id),
-    INDEX idx_guide (guide_id),
-    INDEX idx_status (status)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='评估订单表';
-
--- =============================================
--- 成长规划师相关表
--- =============================================
-
--- 成长规划师申请表
-CREATE TABLE IF NOT EXISTS guide_applications (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    user_id BIGINT NOT NULL COMMENT '申请人用户ID',
-    type VARCHAR(20) NOT NULL DEFAULT 'new_apply' COMMENT '申请类型: new_apply-新注册, upgrade-升级',
-    target_level VARCHAR(20) NOT NULL COMMENT '目标等级: junior-初级, intermediate-中级, senior-高级',
-    current_level VARCHAR(20) DEFAULT NULL COMMENT '当前等级(升级时填写)',
-    package_id BIGINT COMMENT '申请的套餐ID',
-    payment_proof VARCHAR(500) COMMENT '付款凭证URL',
-    payment_amount INT COMMENT '付款金额(分)',
-    address VARCHAR(500) COMMENT '地址',
-    bank_card VARCHAR(50) COMMENT '银行卡号',
-    bank_name VARCHAR(100) COMMENT '开户行',
-    status VARCHAR(20) NOT NULL DEFAULT 'pending' COMMENT '状态: pending-待审核, approved-已通过, rejected-已拒绝',
-    reject_reason TEXT COMMENT '拒绝原因',
-    reviewed_at DATETIME COMMENT '审核时间',
-    reviewed_by BIGINT COMMENT '审核人ID',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-    INDEX idx_user_id (user_id),
-    INDEX idx_status (status),
-    INDEX idx_type (type)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='成长规划师申请表';
-
--- 成长规划师申请过程记录表
-CREATE TABLE IF NOT EXISTS guide_application_records (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    application_id BIGINT NOT NULL COMMENT '关联申请ID',
-    user_id BIGINT NOT NULL COMMENT '操作人用户ID',
-    action VARCHAR(50) NOT NULL COMMENT '操作: submit/approve/reject/withdraw/resubmit',
-    from_status VARCHAR(20) COMMENT '操作前状态',
-    to_status VARCHAR(20) NOT NULL COMMENT '操作后状态',
-    remark TEXT COMMENT '备注/原因',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    INDEX idx_application_id (application_id),
-    INDEX idx_user_id (user_id),
-    INDEX idx_action (action)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='成长规划师申请过程记录表';
-
--- =============================================
--- 小游戏表
--- =============================================
-
--- 小游戏表
-CREATE TABLE IF NOT EXISTS mini_games (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    game_code VARCHAR(20) NOT NULL UNIQUE COMMENT '游戏代码',
-    game_name VARCHAR(50) NOT NULL COMMENT '游戏名称',
-    description TEXT COMMENT '游戏描述',
-    icon VARCHAR(50) COMMENT '图标emoji',
-    default_duration INT DEFAULT 5 COMMENT '默认时长(分钟)',
-    default_points INT DEFAULT 5 COMMENT '默认奖励积分',
-    game_url VARCHAR(255) COMMENT '游戏H5页面URL',
-    sort_order INT DEFAULT 0 COMMENT '排序',
-    status TINYINT DEFAULT 1 COMMENT '状态:0禁用1启用',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-    INDEX idx_game_code (game_code),
-    INDEX idx_status (status)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='小游戏表';
-
--- =============================================
--- 地址维度表
--- =============================================
-
--- 街道地址维度表
-CREATE TABLE IF NOT EXISTS streets (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    province VARCHAR(50) COMMENT '省份',
-    province_code VARCHAR(20) COMMENT '省份编码',
-    city VARCHAR(50) COMMENT '城市',
-    city_code VARCHAR(20) COMMENT '城市编码',
-    district VARCHAR(50) COMMENT '区县',
-    district_code VARCHAR(20) COMMENT '区县编码',
-    street VARCHAR(100) COMMENT '街道',
-    street_code VARCHAR(20) COMMENT '街道编码',
-    full_name VARCHAR(200) COMMENT '完整地址',
-    level INT COMMENT '层级:1省2市3区4街道',
-    parent_id BIGINT COMMENT '父级ID',
-    sort_order INT DEFAULT 0 COMMENT '排序',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-    INDEX idx_level (level),
-    INDEX idx_parent_id (parent_id),
-    INDEX idx_street_code (street_code),
-    INDEX idx_full_name (full_name(50))
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='街道地址维度表';
-
--- =============================================
--- 系统日志表
--- =============================================
-
--- 用户操作日志表
-CREATE TABLE IF NOT EXISTS user_operation_logs (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    user_id BIGINT COMMENT '用户ID',
-    nickname VARCHAR(50) COMMENT '用户昵称',
-    operation_type VARCHAR(20) NOT NULL COMMENT '操作类型: login/logout/create/update/delete/query等',
-    description TEXT COMMENT '操作描述',
-    request_path VARCHAR(200) COMMENT '请求路径',
-    request_method VARCHAR(10) COMMENT '请求方法',
-    request_params TEXT COMMENT '请求参数(脱敏)',
-    response_status INT COMMENT '响应状态码',
-    client_ip VARCHAR(50) COMMENT '客户端IP',
-    user_agent VARCHAR(500) COMMENT 'User-Agent',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    INDEX idx_user_id (user_id),
-    INDEX idx_operation_type (operation_type),
-    INDEX idx_created_at (created_at)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='用户操作日志表';
-
--- =============================================
--- 邀请与心愿表
--- =============================================
-
--- 邀请卡片表
-CREATE TABLE IF NOT EXISTS invite_card (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    type VARCHAR(20) NOT NULL COMMENT '类型: child/family/guide',
-    code VARCHAR(64) NOT NULL UNIQUE COMMENT '邀请码',
-    ref_id BIGINT NOT NULL COMMENT '关联ID(childId/familyId)',
-    creator_id BIGINT NOT NULL COMMENT '创建人',
-    expires_at DATETIME NOT NULL COMMENT '过期时间',
-    used TINYINT DEFAULT 0 COMMENT '是否已使用:0否1是',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-    INDEX idx_code (code),
-    INDEX idx_ref_type (ref_id, type)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='邀请卡片表';
-
--- 心愿单表
-CREATE TABLE IF NOT EXISTS wishes (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    family_id BIGINT COMMENT '家庭ID',
-    child_id BIGINT COMMENT '目标孩子ID',
-    created_by BIGINT COMMENT '创建者用户ID',
-    creator_type VARCHAR(20) COMMENT '创建者类型: child/parent',
-    title VARCHAR(200) NOT NULL COMMENT '心愿标题',
-    description TEXT COMMENT '心愿描述',
-    category VARCHAR(32) COMMENT '心愿分类',
-    points_required INT COMMENT '所需积分',
-    points_set_by BIGINT COMMENT '定价者ID',
-    points_set_at DATETIME COMMENT '定价时间',
-    status VARCHAR(32) DEFAULT 'active' COMMENT '状态: draft/active/pending_exchange/approved/exchanging/fulfilled/cancelled/rejected',
-    exchange_requested_at DATETIME COMMENT '申请兑换时间',
-    exchange_approved_by BIGINT COMMENT '批准者ID',
-    exchange_approved_at DATETIME COMMENT '批准时间',
-    points_deducted_at DATETIME COMMENT '扣积分时间',
-    fulfilled_by BIGINT COMMENT '兑现者ID',
-    fulfilled_at DATETIME COMMENT '兑现时间',
-    child_confirmed_at DATETIME COMMENT '孩子确认收货时间',
-    rejected_by BIGINT COMMENT '拒绝者ID',
-    rejected_at DATETIME COMMENT '拒绝时间',
-    reject_reason TEXT COMMENT '拒绝原因',
-    reject_count INT DEFAULT 0 COMMENT '被拒绝次数',
-    cancelled_by BIGINT COMMENT '取消者ID',
-    cancelled_at DATETIME COMMENT '取消时间',
-    cancel_reason TEXT COMMENT '取消原因',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-    INDEX idx_family_id (family_id),
-    INDEX idx_child_id (child_id),
-    INDEX idx_status (status)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='心愿单表';
-
--- =============================================
--- 商品与订单表
--- =============================================
-
--- 商品表
-CREATE TABLE IF NOT EXISTS products (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    name VARCHAR(200) NOT NULL COMMENT '商品名称',
-    description TEXT COMMENT '商品描述',
-    intro TEXT COMMENT '详细介绍',
-    cover_image VARCHAR(500) COMMENT '封面图片',
-    images TEXT COMMENT '多张图片JSON',
-    price INT NOT NULL DEFAULT 0 COMMENT '价格(分)',
-    stock INT NOT NULL DEFAULT 0 COMMENT '库存',
-    sales_count INT NOT NULL DEFAULT 0 COMMENT '销量',
-    product_type VARCHAR(32) NOT NULL COMMENT '商品类型: activity/course/physical/digital/service',
-    vendor_id BIGINT COMMENT '供应商ID',
-    vendor_name VARCHAR(100) COMMENT '供应商名称',
-    status VARCHAR(32) NOT NULL DEFAULT 'draft' COMMENT '状态: draft/pending/approved/rejected/on_shelf/off_shelf',
-    reject_reason TEXT COMMENT '审核拒绝原因',
-    member_price INT COMMENT '会员价(分)',
-    member_eligible VARCHAR(32) DEFAULT 'none' COMMENT '会员资格: all/budget/none',
-    domain VARCHAR(32) COMMENT '五维领域: action/mind/body/wisdom/wealth',
-    profit_rate INT DEFAULT 0 COMMENT '平台利润率(千分比)',
-    delivery_method TINYINT DEFAULT 1 COMMENT '配送方式: 1=快递 2=自提 3=两者皆可',
-    category_id BIGINT COMMENT '商品类目ID',
-    distribution_system_id BIGINT COMMENT '销售体系ID',
-    external_source VARCHAR(64) COMMENT '外部来源系统',
-    external_id VARCHAR(128) COMMENT '外部来源ID',
-    external_data TEXT COMMENT '外部来源数据JSON',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间'
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='商品表';
-
--- 商品订单表
-CREATE TABLE IF NOT EXISTS product_orders (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    order_no VARCHAR(64) NOT NULL UNIQUE COMMENT '订单编号',
-    product_id BIGINT NOT NULL COMMENT '商品ID',
-    product_name VARCHAR(200) COMMENT '商品名称',
-    product_type VARCHAR(32) COMMENT '商品类型',
-    buyer_id BIGINT NOT NULL COMMENT '购买者ID',
-    family_id BIGINT COMMENT '家庭ID',
-    quantity INT NOT NULL DEFAULT 1 COMMENT '数量',
-    unit_price INT NOT NULL COMMENT '单价(分)',
-    total_amount INT NOT NULL COMMENT '总金额(分)',
-    status VARCHAR(32) NOT NULL DEFAULT 'pending' COMMENT '状态: pending/paid/completed/cancelled/refunded',
-    payment_method VARCHAR(32) COMMENT '支付方式: wechat/points/membership',
-    remark TEXT COMMENT '备注',
-    paid_at DATETIME COMMENT '支付时间',
-    supply_system_id BIGINT COMMENT '所属供应商体系ID',
-    supplier_id BIGINT COMMENT '收款供应商用户ID',
-    supply_commission INT COMMENT '销售佣金(分)',
-    points_used INT DEFAULT 0 COMMENT '使用的积分数量',
-    points_cost INT DEFAULT 0 COMMENT '积分抵扣金额(分)',
-    money_amount INT DEFAULT 0 COMMENT '现金支付金额(分)',
-    consignee_id BIGINT COMMENT '收货人ID',
-    purchase_info TEXT COMMENT '购买信息JSON: {id_card, hand_signature, ...}',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-    INDEX idx_user_id (user_id),
-    INDEX idx_family_id (family_id),
-    INDEX idx_product_id (product_id),
-    INDEX idx_status (status),
-    INDEX idx_supply_system_id (supply_system_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='商品订单表';
-
--- =============================================
--- 系统配置与内容表
--- =============================================
-
--- 系统配置表
-CREATE TABLE IF NOT EXISTS sys_config (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    config_key VARCHAR(64) NOT NULL UNIQUE COMMENT '配置键',
-    config_value TEXT COMMENT '配置值',
-    description TEXT COMMENT '配置说明',
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间'
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='系统配置表';
-
--- 内容区块配置表
-CREATE TABLE IF NOT EXISTS content_sections (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    page_key VARCHAR(50) NOT NULL COMMENT '页面标识',
-    section_key VARCHAR(50) NOT NULL COMMENT '区块标识',
-    title VARCHAR(100) COMMENT '区块标题',
-    allowed_roles VARCHAR(255) DEFAULT '["anonymous"]' COMMENT '允许查看的角色JSON数组',
-    sort_order INT DEFAULT 0 COMMENT '显示顺序',
-    status VARCHAR(20) DEFAULT 'active' COMMENT '状态: active/inactive',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间'
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='内容区块配置表';
-
--- 文章分类表
-CREATE TABLE IF NOT EXISTS article_categories (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    name VARCHAR(50) NOT NULL COMMENT '分类名',
-    icon VARCHAR(20) DEFAULT '' COMMENT '图标emoji',
-    color VARCHAR(20) DEFAULT '#5B9BD5' COMMENT '标识色',
-    sort_order INT DEFAULT 0 COMMENT '排序',
-    status TINYINT DEFAULT 1 COMMENT '状态:1启用/0禁用'
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='文章分类表';
-
--- 文章表
-CREATE TABLE IF NOT EXISTS articles (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键 ID',
-    category_id BIGINT DEFAULT 0 COMMENT '所属分类 ID',
-    title VARCHAR(200) NOT NULL COMMENT '标题',
-    summary TEXT DEFAULT '' COMMENT '摘要',
-    cover_image VARCHAR(500) DEFAULT '' COMMENT '封面图 URL',
-    content LONGTEXT COMMENT '富文本内容',
-    tags VARCHAR(200) DEFAULT '' COMMENT '标签 JSON 数组',
-    author VARCHAR(100) DEFAULT '浠艾福' COMMENT '作者',
-    read_time INT DEFAULT 0 COMMENT '预计阅读分钟数',
-    article_type VARCHAR(20) DEFAULT 'normal' COMMENT '文章类型:normal(普通)/premium(优质)/original(原创)',
-    word_count INT DEFAULT 0 COMMENT '文章字数',
-    related_dimensions VARCHAR(100) DEFAULT '' COMMENT '关联五维 JSON 数组',
-    visibility VARCHAR(20) DEFAULT 'public' COMMENT '浏览权限:public/login/private',
-    visible_to TEXT COMMENT '私密指定人群 JSON',
-    status VARCHAR(20) DEFAULT 'draft' COMMENT '状态:draft/published/archived',
-    is_featured TINYINT DEFAULT 0 COMMENT '是否精选:1 精选/0 普通',
-    published_at DATETIME DEFAULT NULL COMMENT '发布时间',
-    view_count INT DEFAULT 0 COMMENT '浏览次数',
-    created_by BIGINT DEFAULT 0 COMMENT '发布人 adminID',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间'
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='文章表';
-
--- Article audit fields (for user-generated content)
-ALTER TABLE articles
-    ADD COLUMN author_type VARCHAR(20) DEFAULT 'admin' COMMENT '作者类型:admin/parent/child' AFTER created_by,
-    ADD COLUMN audit_status VARCHAR(20) DEFAULT 'approved' COMMENT '审核状态:approved/pending/rejected' AFTER status,
-    ADD COLUMN audit_reason TEXT COMMENT '驳回原因' AFTER audit_status,
-    ADD COLUMN auditor_id BIGINT DEFAULT 0 COMMENT '审核人 ID' AFTER audit_reason,
+-- =============================================
+
+-- 注意:ALTER TABLE语句已移到 DatabaseInitializer.java 中执行
+-- 避免重复执行导致的错误
+
+-- 3. 家长心愿单表(新增)
+CREATE TABLE IF NOT EXISTS reward_wishlists (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    user_id BIGINT NOT NULL COMMENT '创建者用户ID',
+    family_id BIGINT NOT NULL COMMENT '家庭ID',
+    title VARCHAR(100) NOT NULL COMMENT '心愿名称',
+    description TEXT COMMENT '心愿描述',
+    points_required INT NOT NULL COMMENT '所需积分',
+    category VARCHAR(32) COMMENT '分类',
+    image_url VARCHAR(255) COMMENT '图片链接',
+    status ENUM('available', 'pending', 'exchanged', 'rejected') DEFAULT 'available' COMMENT '状态',
+    exchange_approved TINYINT COMMENT '是否审批通过',
+    exchanged_at DATETIME COMMENT '兑换时间',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    INDEX idx_user_id (user_id),
+    INDEX idx_family_id (family_id),
+    INDEX idx_status (status)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- 4. 更新任务状态枚举(如果需要支持更多状态)
+-- ALTER TABLE tasks MODIFY COLUMN status ENUM('pending', 'completed', 'overdue', 'cancelled', 'parent_pending', 'parent_completed') DEFAULT 'pending';
+
+-- ===================== 任务模板套餐功能 =====================
+
+-- 成长规划师-家庭关系表
+CREATE TABLE IF NOT EXISTS guide_families (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    guide_id BIGINT NOT NULL COMMENT '成长规划师用户ID',
+    family_id BIGINT NOT NULL COMMENT '家庭ID',
+    service_type VARCHAR(20) DEFAULT 'consulting' COMMENT '服务类型: monthly/yearly/consulting',
+    service_price INT DEFAULT 0 COMMENT '服务价格(分)',
+    status VARCHAR(20) DEFAULT 'binding' COMMENT '状态: binding/paused/cancelled',
+    bound_at DATETIME COMMENT '绑定时间',
+    expire_at DATETIME COMMENT '服务到期时间',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    UNIQUE KEY uk_guide_family (guide_id, family_id),
+    INDEX idx_guide_id (guide_id),
+    INDEX idx_family_id (family_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- 任务模板套餐
+CREATE TABLE IF NOT EXISTS task_template_packages (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    creator_id BIGINT NOT NULL COMMENT '创建者成长规划师ID',
+    name VARCHAR(100) NOT NULL COMMENT '套餐名称',
+    description TEXT COMMENT '详细介绍',
+    cycle_days INT NOT NULL COMMENT '周期天数',
+    category VARCHAR(50) COMMENT '分类',
+    tags JSON COMMENT '标签',
+    price INT DEFAULT 0 COMMENT '售价(分)',
+    platform_fee INT DEFAULT 0 COMMENT '平台服务费(基点)',
+    is_public TINYINT DEFAULT 0 COMMENT '是否公开',
+    share_code VARCHAR(50) UNIQUE COMMENT '分享码',
+    cover_image VARCHAR(500) COMMENT '封面图',
+    status VARCHAR(20) DEFAULT 'draft' COMMENT '状态',
+    reviewer_id BIGINT COMMENT '审核人',
+    reviewed_at DATETIME COMMENT '审核时间',
+    reject_reason TEXT COMMENT '拒绝原因',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    INDEX idx_creator_id (creator_id),
+    INDEX idx_status (status),
+    INDEX idx_is_public (is_public)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- 套餐内任务项
+CREATE TABLE IF NOT EXISTS task_template_items (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    package_id BIGINT NOT NULL COMMENT '所属套餐ID',
+    task_name VARCHAR(100) NOT NULL,
+    description TEXT,
+    points INT DEFAULT 0,
+    frequency VARCHAR(20) DEFAULT 'daily',
+    duration INT COMMENT '预计时长(分钟)',
+    is_required TINYINT DEFAULT 0,
+    sort_order INT DEFAULT 0,
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    INDEX idx_package_id (package_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- 套餐应用实例
+CREATE TABLE IF NOT EXISTS task_plan_instances (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    package_id BIGINT NOT NULL,
+    family_id BIGINT NOT NULL,
+    child_id BIGINT NOT NULL,
+    name VARCHAR(100) NOT NULL,
+    start_date DATE NOT NULL,
+    end_date DATE NOT NULL,
+    status VARCHAR(20) DEFAULT 'active',
+    total_days INT,
+    completed_days INT DEFAULT 0,
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    INDEX idx_family_id (family_id),
+    INDEX idx_child_id (child_id),
+    INDEX idx_status (status)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- 实例任务项
+CREATE TABLE IF NOT EXISTS task_plan_items (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    instance_id BIGINT NOT NULL,
+    template_item_id BIGINT,
+    task_name VARCHAR(100) NOT NULL,
+    description TEXT,
+    points INT DEFAULT 0,
+    frequency VARCHAR(20) DEFAULT 'daily',
+    duration INT,
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    INDEX idx_instance_id (instance_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- 套餐购买订单
+CREATE TABLE IF NOT EXISTS package_orders (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    order_no VARCHAR(32) UNIQUE NOT NULL,
+    user_id BIGINT NOT NULL COMMENT '购买者用户ID',
+    family_id BIGINT NOT NULL COMMENT '家庭ID',
+    package_id BIGINT NOT NULL COMMENT '套餐ID',
+    package_name VARCHAR(100) COMMENT '套餐名称',
+    price INT NOT NULL COMMENT '支付金额(分)',
+    platform_fee INT DEFAULT 0 COMMENT '平台服务费(分)',
+    user_coupon_id BIGINT COMMENT '使用的用户优惠券ID',
+    guide_id BIGINT COMMENT '成长规划师ID',
+    status VARCHAR(20) DEFAULT 'pending' COMMENT '状态: pending/paid/cancelled/refunded',
+    pay_method VARCHAR(20) COMMENT '支付方式',
+    transaction_id VARCHAR(64) COMMENT '微信支付订单号',
+    paid_at DATETIME COMMENT '支付时间',
+    notify_data TEXT COMMENT '支付回调数据',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    INDEX idx_user_id (user_id),
+    INDEX idx_family_id (family_id),
+    INDEX idx_package_id (package_id),
+    INDEX idx_status (status)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- 用户表增加成长规划师相关字段 - 已移到 DatabaseInitializer.java 执行
+-- ALTER TABLE users ADD COLUMN teacher_no VARCHAR(50) COMMENT '成长规划师证书号';
+-- ALTER TABLE users ADD COLUMN teacher_photo VARCHAR(500) COMMENT '成长规划师照片';
+-- ALTER TABLE users ADD COLUMN certificate_image VARCHAR(500) COMMENT '成长规划师证书照片';
+-- ALTER TABLE users ADD COLUMN teacher_status VARCHAR(20) DEFAULT 'pending' COMMENT '成长规划师审核状态: pending/approved/rejected';
+-- ALTER TABLE users ADD INDEX idx_teacher_status (teacher_status);
+
+-- 成长规划师咨询消息表
+CREATE TABLE IF NOT EXISTS teacher_messages (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    family_id BIGINT NOT NULL COMMENT '家庭ID',
+    parent_id BIGINT NOT NULL COMMENT '家长用户ID',
+    teacher_id BIGINT NOT NULL COMMENT '成长规划师用户ID',
+    content TEXT NOT NULL COMMENT '消息内容',
+    reply_content TEXT COMMENT '回复内容',
+    status VARCHAR(20) DEFAULT 'pending' COMMENT '状态:pending/replied',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    replied_at DATETIME COMMENT '回复时间',
+    INDEX idx_family_id (family_id),
+    INDEX idx_teacher_id (teacher_id),
+    INDEX idx_parent_id (parent_id),
+    INDEX idx_status (status)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- 游戏记录表(专注训练模块)
+CREATE TABLE IF NOT EXISTS game_records (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    child_id BIGINT NOT NULL COMMENT '孩子ID',
+    game_code VARCHAR(20) NOT NULL COMMENT '游戏代码',
+    score INT DEFAULT 0 COMMENT '得分(0-100)',
+    completion_time INT COMMENT '完成用时(秒)',
+    difficulty VARCHAR(20) DEFAULT 'medium' COMMENT '难度(easy/medium/hard)',
+    points_earned INT DEFAULT 0 COMMENT '获得积分',
+    played_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '游玩时间',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    INDEX idx_child_id (child_id),
+    INDEX idx_game_code (game_code),
+    INDEX idx_played_at (played_at)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- 勋章定义表
+CREATE TABLE IF NOT EXISTS badge (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    badge_id VARCHAR(50) UNIQUE NOT NULL COMMENT '勋章唯一标识',
+    name VARCHAR(100) NOT NULL COMMENT '勋章名称',
+    description TEXT COMMENT '勋章描述',
+    icon VARCHAR(255) COMMENT '勋章图标',
+    category VARCHAR(20) COMMENT '分类(学习/运动/家务/阅读/打卡/综合)',
+    level VARCHAR(20) COMMENT '等级(铜牌/银牌/金牌/钻石)',
+    rarity VARCHAR(20) COMMENT '稀有度(普通/稀有/史诗/传说)',
+    trigger_type VARCHAR(20) COMMENT '触发类型(task_count/streak_days/points_total/reward_count/custom)',
+    threshold INT DEFAULT 0 COMMENT '阈值',
+    need_approval TINYINT DEFAULT 0 COMMENT '是否需要审批',
+    expire_days INT DEFAULT -1 COMMENT '有效期天数(-1永久)',
+    sort_order INT DEFAULT 0 COMMENT '排序',
+    is_active TINYINT DEFAULT 1 COMMENT '是否启用',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    INDEX idx_category (category),
+    INDEX idx_is_active (is_active)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- 儿童勋章关联表
+CREATE TABLE IF NOT EXISTS child_badge (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    child_id BIGINT NOT NULL COMMENT '孩子ID',
+    badge_id BIGINT NOT NULL COMMENT '勋章ID',
+    earned_at DATETIME COMMENT '获得时间',
+    expire_at DATETIME COMMENT '过期时间',
+    status TINYINT DEFAULT 1 COMMENT '状态:1有效 0过期 -1撤销',
+    is_favorite TINYINT DEFAULT 0 COMMENT '是否收藏',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    UNIQUE KEY uk_child_badge (child_id, badge_id),
+    INDEX idx_child_id (child_id),
+    INDEX idx_badge_id (badge_id),
+    INDEX idx_status (status)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- =============================================
+-- 以下表从 DatabaseInitializer.java 提取
+-- 管理后台表
+-- =============================================
+
+-- 管理员表
+CREATE TABLE IF NOT EXISTS admins (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    username VARCHAR(50) NOT NULL COMMENT '用户名',
+    password VARCHAR(128) NOT NULL COMMENT '密码(MD5加密)',
+    nickname VARCHAR(50) COMMENT '昵称',
+    real_name VARCHAR(50) COMMENT '真实姓名',
+    phone VARCHAR(11) COMMENT '手机号',
+    email VARCHAR(100) COMMENT '邮箱',
+    role VARCHAR(20) DEFAULT 'admin' COMMENT '角色: admin/teacher',
+    status TINYINT DEFAULT 1 COMMENT '状态:1启用0禁用',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+    INDEX idx_phone (phone),
+    INDEX idx_username (username)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='管理员表';
+
+-- 验证码表
+CREATE TABLE IF NOT EXISTS verification_codes (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    phone VARCHAR(11) NOT NULL COMMENT '手机号',
+    code VARCHAR(6) NOT NULL COMMENT '验证码',
+    type VARCHAR(20) NOT NULL COMMENT '验证码类型',
+    expires_in INT DEFAULT 300 COMMENT '过期时间(秒)',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    expires_at DATETIME NOT NULL COMMENT '过期时间',
+    used TINYINT DEFAULT 0 COMMENT '是否已使用:0否1是',
+    INDEX idx_phone_type (phone, type),
+    INDEX idx_expires_at (expires_at)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='验证码表';
+
+-- 管理后台任务模板表
+CREATE TABLE IF NOT EXISTS admin_task_templates (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    title VARCHAR(200) NOT NULL COMMENT '模板标题',
+    description TEXT COMMENT '模板描述',
+    points INT DEFAULT 10 COMMENT '默认积分',
+    category VARCHAR(32) COMMENT '任务分类',
+    need_review TINYINT DEFAULT 0 COMMENT '是否需要审核:0否1是',
+    review_by_category TINYINT DEFAULT 0 COMMENT '是否按分类审核:0否1是',
+    recommended_age INT COMMENT '推荐年龄',
+    difficulty ENUM('easy', 'medium', 'hard') DEFAULT 'medium' COMMENT '难度: easy/medium/hard',
+    teacher_id BIGINT COMMENT '成长规划师ID',
+    complete_types VARCHAR(100) COMMENT '完成方式JSON',
+    duration INT COMMENT '预计完成时长(分钟)',
+    review_type VARCHAR(20) COMMENT '审核人类型: creator/parent/teacher/ai',
+    task_type VARCHAR(20) COMMENT '任务性质: onetime/recurring',
+    frequency VARCHAR(20) COMMENT '频率: daily/weekly/monthly',
+    max_frequency INT COMMENT '周期内最多完成次数',
+    is_active TINYINT DEFAULT 1 COMMENT '是否启用:0禁用1启用',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+    INDEX idx_category (category),
+    INDEX idx_difficulty (difficulty),
+    INDEX idx_is_active (is_active)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='管理后台任务模板表';
+
+-- =============================================
+-- 测评模块表
+-- =============================================
+
+-- 测评资料表
+-- 数学闯关 - 孩子当前等级
+CREATE TABLE IF NOT EXISTS math_child_level (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    child_id BIGINT NOT NULL UNIQUE,
+    current_level TINYINT NOT NULL DEFAULT 1 COMMENT '1=一位数加减,2=两位数加减,3=一位数四则,4=两位数四则',
+    total_passed INT DEFAULT 0 COMMENT '累计通关次数',
+    best_time_ms BIGINT DEFAULT NULL COMMENT '最佳用时(毫秒)',
+    best_accuracy INT DEFAULT NULL COMMENT '最佳正确率(%)',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    INDEX idx_child_id (child_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- 数学闯关 - 通关日志
+CREATE TABLE IF NOT EXISTS math_quiz_logs (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    child_id BIGINT NOT NULL,
+    level TINYINT NOT NULL COMMENT '闯关时等级',
+    target_n INT NOT NULL COMMENT '目标连续答对数',
+    correct_count INT NOT NULL COMMENT '实际连续答对数',
+    total_attempts INT NOT NULL COMMENT '总答题数',
+    total_time_ms BIGINT NOT NULL COMMENT '总用时(毫秒)',
+    accuracy INT NOT NULL COMMENT '正确率(%)',
+    passed TINYINT(1) DEFAULT 0 COMMENT '是否通关',
+    exprs TEXT COMMENT '本轮表达式列表(JSON)',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    INDEX idx_child_id (child_id),
+    INDEX idx_level (level)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+CREATE TABLE IF NOT EXISTS assessment_materials (
+    id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT '主键',
+    title VARCHAR(100) NOT NULL COMMENT '资料标题',
+    content TEXT COMMENT '测评介绍内容',
+    cover_image VARCHAR(255) COMMENT '封面图片',
+    status VARCHAR(20) DEFAULT 'active' COMMENT '状态:active/inactive',
+    created_at DATETIME COMMENT '创建时间',
+    updated_at DATETIME COMMENT '更新时间',
+    INDEX idx_status (status)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='测评资料表';
+
+-- 积分配置表
+CREATE TABLE IF NOT EXISTS assessment_points_config (
+    id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT '主键',
+    points_value INT DEFAULT 100 COMMENT '完成测评获得积分',
+    points_value_yuan INT DEFAULT 1 COMMENT '1积分等于多少分(原元→现分)',
+    is_active TINYINT DEFAULT 1 COMMENT '是否启用',
+    created_at DATETIME COMMENT '创建时间',
+    updated_at DATETIME COMMENT '更新时间'
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='积分配置表';
+
+-- 家庭测评配置表
+CREATE TABLE IF NOT EXISTS family_assessment_config (
+    id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT '主键',
+    family_id BIGINT NOT NULL COMMENT '家庭ID',
+    material_id BIGINT COMMENT '测评资料ID',
+    remind_months INT DEFAULT 12 COMMENT '提醒周期(月)',
+    last_remind_at DATETIME COMMENT '上次提醒时间',
+    next_remind_at DATETIME COMMENT '下次提醒时间',
+    is_enabled TINYINT DEFAULT 1 COMMENT '是否启用:1启用0关闭',
+    created_by BIGINT COMMENT '创建人(规划师ID)',
+    created_at DATETIME COMMENT '创建时间',
+    updated_at DATETIME COMMENT '更新时间',
+    UNIQUE KEY uk_family (family_id),
+    INDEX idx_next_remind (next_remind_at),
+    INDEX idx_enabled (is_enabled)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='家庭测评配置表';
+
+-- 测评记录表
+CREATE TABLE IF NOT EXISTS assessment_records (
+    id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT '主键',
+    family_id BIGINT COMMENT '家庭ID',
+    child_id BIGINT COMMENT '孩子ID',
+    material_id BIGINT COMMENT '测评资料ID',
+    status VARCHAR(20) DEFAULT 'pending' COMMENT '状态:pending待完成/completed已完成',
+    completed_at DATETIME COMMENT '完成时间',
+    created_at DATETIME COMMENT '创建时间',
+    INDEX idx_family (family_id),
+    INDEX idx_status (status)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='测评记录表';
+
+-- 评估订单表(测评订单)
+CREATE TABLE IF NOT EXISTS assessment_orders (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    order_no VARCHAR(64) NOT NULL UNIQUE COMMENT '订单编号',
+    family_id BIGINT NOT NULL COMMENT '家庭ID',
+    user_id BIGINT NOT NULL COMMENT '用户ID',
+    child_id BIGINT COMMENT '孩子ID',
+    guide_id BIGINT NOT NULL COMMENT '成长规划师ID',
+    package_id BIGINT NOT NULL COMMENT '套餐ID',
+    appointment_id BIGINT COMMENT '关联预约ID',
+    guide_name VARCHAR(50) COMMENT '规划师名称',
+    package_name VARCHAR(100) COMMENT '套餐名称',
+    total_price BIGINT DEFAULT 0 COMMENT '总价(分)',
+    discount_amount BIGINT DEFAULT 0 COMMENT '优惠金额(分)',
+    actual_price BIGINT DEFAULT 0 COMMENT '实付金额(分)',
+    status VARCHAR(20) DEFAULT 'pending' COMMENT '状态: pending/paid/completed/cancelled/refunded',
+    pay_time VARCHAR(50) COMMENT '支付时间',
+    pay_type VARCHAR(20) COMMENT '支付方式',
+    transaction_id VARCHAR(64) COMMENT '交易流水号',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+    INDEX idx_family (family_id),
+    INDEX idx_guide (guide_id),
+    INDEX idx_status (status)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='评估订单表';
+
+-- =============================================
+-- 成长规划师相关表
+-- =============================================
+
+-- 成长规划师申请表
+CREATE TABLE IF NOT EXISTS guide_applications (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    user_id BIGINT NOT NULL COMMENT '申请人用户ID',
+    type VARCHAR(20) NOT NULL DEFAULT 'new_apply' COMMENT '申请类型: new_apply-新注册, upgrade-升级',
+    target_level VARCHAR(20) NOT NULL COMMENT '目标等级: junior-初级, intermediate-中级, senior-高级',
+    current_level VARCHAR(20) DEFAULT NULL COMMENT '当前等级(升级时填写)',
+    package_id BIGINT COMMENT '申请的套餐ID',
+    payment_proof VARCHAR(500) COMMENT '付款凭证URL',
+    payment_amount INT COMMENT '付款金额(分)',
+    address VARCHAR(500) COMMENT '地址',
+    bank_card VARCHAR(50) COMMENT '银行卡号',
+    bank_name VARCHAR(100) COMMENT '开户行',
+    status VARCHAR(20) NOT NULL DEFAULT 'pending' COMMENT '状态: pending-待审核, approved-已通过, rejected-已拒绝',
+    reject_reason TEXT COMMENT '拒绝原因',
+    reviewed_at DATETIME COMMENT '审核时间',
+    reviewed_by BIGINT COMMENT '审核人ID',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+    INDEX idx_user_id (user_id),
+    INDEX idx_status (status),
+    INDEX idx_type (type)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='成长规划师申请表';
+
+-- 成长规划师申请过程记录表
+CREATE TABLE IF NOT EXISTS guide_application_records (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    application_id BIGINT NOT NULL COMMENT '关联申请ID',
+    user_id BIGINT NOT NULL COMMENT '操作人用户ID',
+    action VARCHAR(50) NOT NULL COMMENT '操作: submit/approve/reject/withdraw/resubmit',
+    from_status VARCHAR(20) COMMENT '操作前状态',
+    to_status VARCHAR(20) NOT NULL COMMENT '操作后状态',
+    remark TEXT COMMENT '备注/原因',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    INDEX idx_application_id (application_id),
+    INDEX idx_user_id (user_id),
+    INDEX idx_action (action)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='成长规划师申请过程记录表';
+
+-- =============================================
+-- 小游戏表
+-- =============================================
+
+-- 小游戏表
+CREATE TABLE IF NOT EXISTS mini_games (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    game_code VARCHAR(20) NOT NULL UNIQUE COMMENT '游戏代码',
+    game_name VARCHAR(50) NOT NULL COMMENT '游戏名称',
+    description TEXT COMMENT '游戏描述',
+    icon VARCHAR(50) COMMENT '图标emoji',
+    default_duration INT DEFAULT 5 COMMENT '默认时长(分钟)',
+    default_points INT DEFAULT 5 COMMENT '默认奖励积分',
+    game_url VARCHAR(255) COMMENT '游戏H5页面URL',
+    sort_order INT DEFAULT 0 COMMENT '排序',
+    status TINYINT DEFAULT 1 COMMENT '状态:0禁用1启用',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+    INDEX idx_game_code (game_code),
+    INDEX idx_status (status)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='小游戏表';
+
+-- =============================================
+-- 地址维度表
+-- =============================================
+
+-- 街道地址维度表
+CREATE TABLE IF NOT EXISTS streets (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    province VARCHAR(50) COMMENT '省份',
+    province_code VARCHAR(20) COMMENT '省份编码',
+    city VARCHAR(50) COMMENT '城市',
+    city_code VARCHAR(20) COMMENT '城市编码',
+    district VARCHAR(50) COMMENT '区县',
+    district_code VARCHAR(20) COMMENT '区县编码',
+    street VARCHAR(100) COMMENT '街道',
+    street_code VARCHAR(20) COMMENT '街道编码',
+    full_name VARCHAR(200) COMMENT '完整地址',
+    level INT COMMENT '层级:1省2市3区4街道',
+    parent_id BIGINT COMMENT '父级ID',
+    sort_order INT DEFAULT 0 COMMENT '排序',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+    INDEX idx_level (level),
+    INDEX idx_parent_id (parent_id),
+    INDEX idx_street_code (street_code),
+    INDEX idx_full_name (full_name(50))
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='街道地址维度表';
+
+-- =============================================
+-- 系统日志表
+-- =============================================
+
+-- 用户操作日志表
+CREATE TABLE IF NOT EXISTS user_operation_logs (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    user_id BIGINT COMMENT '用户ID',
+    nickname VARCHAR(50) COMMENT '用户昵称',
+    operation_type VARCHAR(20) NOT NULL COMMENT '操作类型: login/logout/create/update/delete/query等',
+    description TEXT COMMENT '操作描述',
+    request_path VARCHAR(200) COMMENT '请求路径',
+    request_method VARCHAR(10) COMMENT '请求方法',
+    request_params TEXT COMMENT '请求参数(脱敏)',
+    response_status INT COMMENT '响应状态码',
+    client_ip VARCHAR(50) COMMENT '客户端IP',
+    user_agent VARCHAR(500) COMMENT 'User-Agent',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    INDEX idx_user_id (user_id),
+    INDEX idx_operation_type (operation_type),
+    INDEX idx_created_at (created_at)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='用户操作日志表';
+
+-- =============================================
+-- 邀请与心愿表
+-- =============================================
+
+-- 邀请卡片表
+CREATE TABLE IF NOT EXISTS invite_card (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    type VARCHAR(20) NOT NULL COMMENT '类型: child/family/guide',
+    code VARCHAR(64) NOT NULL UNIQUE COMMENT '邀请码',
+    ref_id BIGINT NOT NULL COMMENT '关联ID(childId/familyId)',
+    creator_id BIGINT NOT NULL COMMENT '创建人',
+    expires_at DATETIME NOT NULL COMMENT '过期时间',
+    used TINYINT DEFAULT 0 COMMENT '是否已使用:0否1是',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+    INDEX idx_code (code),
+    INDEX idx_ref_type (ref_id, type)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='邀请卡片表';
+
+-- 心愿单表
+CREATE TABLE IF NOT EXISTS wishes (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    family_id BIGINT COMMENT '家庭ID',
+    child_id BIGINT COMMENT '目标孩子ID',
+    created_by BIGINT COMMENT '创建者用户ID',
+    creator_type VARCHAR(20) COMMENT '创建者类型: child/parent',
+    title VARCHAR(200) NOT NULL COMMENT '心愿标题',
+    description TEXT COMMENT '心愿描述',
+    category VARCHAR(32) COMMENT '心愿分类',
+    points_required INT COMMENT '所需积分',
+    points_set_by BIGINT COMMENT '定价者ID',
+    points_set_at DATETIME COMMENT '定价时间',
+    status VARCHAR(32) DEFAULT 'active' COMMENT '状态: draft/active/pending_exchange/approved/exchanging/fulfilled/cancelled/rejected',
+    exchange_requested_at DATETIME COMMENT '申请兑换时间',
+    exchange_approved_by BIGINT COMMENT '批准者ID',
+    exchange_approved_at DATETIME COMMENT '批准时间',
+    points_deducted_at DATETIME COMMENT '扣积分时间',
+    fulfilled_by BIGINT COMMENT '兑现者ID',
+    fulfilled_at DATETIME COMMENT '兑现时间',
+    child_confirmed_at DATETIME COMMENT '孩子确认收货时间',
+    rejected_by BIGINT COMMENT '拒绝者ID',
+    rejected_at DATETIME COMMENT '拒绝时间',
+    reject_reason TEXT COMMENT '拒绝原因',
+    reject_count INT DEFAULT 0 COMMENT '被拒绝次数',
+    cancelled_by BIGINT COMMENT '取消者ID',
+    cancelled_at DATETIME COMMENT '取消时间',
+    cancel_reason TEXT COMMENT '取消原因',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+    INDEX idx_family_id (family_id),
+    INDEX idx_child_id (child_id),
+    INDEX idx_status (status)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='心愿单表';
+
+-- =============================================
+-- 商品与订单表
+-- =============================================
+
+-- 商品表
+CREATE TABLE IF NOT EXISTS products (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    name VARCHAR(200) NOT NULL COMMENT '商品名称',
+    description TEXT COMMENT '商品描述',
+    intro TEXT COMMENT '详细介绍',
+    cover_image VARCHAR(500) COMMENT '封面图片',
+    images TEXT COMMENT '多张图片JSON',
+    price INT NOT NULL DEFAULT 0 COMMENT '价格(分)',
+    stock INT NOT NULL DEFAULT 0 COMMENT '库存',
+    sales_count INT NOT NULL DEFAULT 0 COMMENT '销量',
+    product_type VARCHAR(32) NOT NULL COMMENT '商品类型: activity/course/physical/digital/service',
+    vendor_id BIGINT COMMENT '供应商ID',
+    vendor_name VARCHAR(100) COMMENT '供应商名称',
+    status VARCHAR(32) NOT NULL DEFAULT 'draft' COMMENT '状态: draft/pending/approved/rejected/on_shelf/off_shelf',
+    reject_reason TEXT COMMENT '审核拒绝原因',
+    member_price INT COMMENT '会员价(分)',
+    member_eligible VARCHAR(32) DEFAULT 'none' COMMENT '会员资格: all/budget/none',
+    domain VARCHAR(32) COMMENT '五维领域: action/mind/body/wisdom/wealth',
+    profit_rate INT DEFAULT 0 COMMENT '平台利润率(千分比)',
+    delivery_method TINYINT DEFAULT 1 COMMENT '配送方式: 1=快递 2=自提 3=两者皆可',
+    category_id BIGINT COMMENT '商品类目ID',
+    distribution_system_id BIGINT COMMENT '销售体系ID',
+    external_source VARCHAR(64) COMMENT '外部来源系统',
+    external_id VARCHAR(128) COMMENT '外部来源ID',
+    external_data TEXT COMMENT '外部来源数据JSON',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间'
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='商品表';
+
+-- 商品订单表
+CREATE TABLE IF NOT EXISTS product_orders (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    order_no VARCHAR(64) NOT NULL UNIQUE COMMENT '订单编号',
+    product_id BIGINT NOT NULL COMMENT '商品ID',
+    product_name VARCHAR(200) COMMENT '商品名称',
+    product_type VARCHAR(32) COMMENT '商品类型',
+    buyer_id BIGINT NOT NULL COMMENT '购买者ID',
+    family_id BIGINT COMMENT '家庭ID',
+    quantity INT NOT NULL DEFAULT 1 COMMENT '数量',
+    unit_price INT NOT NULL COMMENT '单价(分)',
+    total_amount INT NOT NULL COMMENT '总金额(分)',
+    status VARCHAR(32) NOT NULL DEFAULT 'pending' COMMENT '状态: pending/paid/completed/cancelled/refunded',
+    payment_method VARCHAR(32) COMMENT '支付方式: wechat/points/membership',
+    remark TEXT COMMENT '备注',
+    paid_at DATETIME COMMENT '支付时间',
+    supply_system_id BIGINT COMMENT '所属供应商体系ID',
+    supplier_id BIGINT COMMENT '收款供应商用户ID',
+    supply_commission INT COMMENT '销售佣金(分)',
+    points_used INT DEFAULT 0 COMMENT '使用的积分数量',
+    points_cost INT DEFAULT 0 COMMENT '积分抵扣金额(分)',
+    money_amount INT DEFAULT 0 COMMENT '现金支付金额(分)',
+    consignee_id BIGINT COMMENT '收货人ID',
+    purchase_info TEXT COMMENT '购买信息JSON: {id_card, hand_signature, ...}',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+    INDEX idx_user_id (user_id),
+    INDEX idx_family_id (family_id),
+    INDEX idx_product_id (product_id),
+    INDEX idx_status (status),
+    INDEX idx_supply_system_id (supply_system_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='商品订单表';
+
+-- =============================================
+-- 系统配置与内容表
+-- =============================================
+
+-- 系统配置表
+CREATE TABLE IF NOT EXISTS sys_config (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    config_key VARCHAR(64) NOT NULL UNIQUE COMMENT '配置键',
+    config_value TEXT COMMENT '配置值',
+    description TEXT COMMENT '配置说明',
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间'
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='系统配置表';
+
+-- 内容区块配置表
+CREATE TABLE IF NOT EXISTS content_sections (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    page_key VARCHAR(50) NOT NULL COMMENT '页面标识',
+    section_key VARCHAR(50) NOT NULL COMMENT '区块标识',
+    title VARCHAR(100) COMMENT '区块标题',
+    allowed_roles VARCHAR(255) DEFAULT '["anonymous"]' COMMENT '允许查看的角色JSON数组',
+    sort_order INT DEFAULT 0 COMMENT '显示顺序',
+    status VARCHAR(20) DEFAULT 'active' COMMENT '状态: active/inactive',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间'
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='内容区块配置表';
+
+-- 文章分类表
+CREATE TABLE IF NOT EXISTS article_categories (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    name VARCHAR(50) NOT NULL COMMENT '分类名',
+    icon VARCHAR(20) DEFAULT '' COMMENT '图标emoji',
+    color VARCHAR(20) DEFAULT '#5B9BD5' COMMENT '标识色',
+    sort_order INT DEFAULT 0 COMMENT '排序',
+    status TINYINT DEFAULT 1 COMMENT '状态:1启用/0禁用'
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='文章分类表';
+
+-- 文章表
+CREATE TABLE IF NOT EXISTS articles (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键 ID',
+    category_id BIGINT DEFAULT 0 COMMENT '所属分类 ID',
+    title VARCHAR(200) NOT NULL COMMENT '标题',
+    summary TEXT DEFAULT '' COMMENT '摘要',
+    cover_image VARCHAR(500) DEFAULT '' COMMENT '封面图 URL',
+    content LONGTEXT COMMENT '富文本内容',
+    tags VARCHAR(200) DEFAULT '' COMMENT '标签 JSON 数组',
+    author VARCHAR(100) DEFAULT '浠艾福' COMMENT '作者',
+    read_time INT DEFAULT 0 COMMENT '预计阅读分钟数',
+    article_type VARCHAR(20) DEFAULT 'normal' COMMENT '文章类型:normal(普通)/premium(优质)/original(原创)',
+    word_count INT DEFAULT 0 COMMENT '文章字数',
+    related_dimensions VARCHAR(100) DEFAULT '' COMMENT '关联五维 JSON 数组',
+    visibility VARCHAR(20) DEFAULT 'public' COMMENT '浏览权限:public/login/private',
+    visible_to TEXT COMMENT '私密指定人群 JSON',
+    status VARCHAR(20) DEFAULT 'draft' COMMENT '状态:draft/published/archived',
+    is_featured TINYINT DEFAULT 0 COMMENT '是否精选:1 精选/0 普通',
+    published_at DATETIME DEFAULT NULL COMMENT '发布时间',
+    view_count INT DEFAULT 0 COMMENT '浏览次数',
+    created_by BIGINT DEFAULT 0 COMMENT '发布人 adminID',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间'
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='文章表';
+
+-- Article audit fields (for user-generated content)
+ALTER TABLE articles
+    ADD COLUMN author_type VARCHAR(20) DEFAULT 'admin' COMMENT '作者类型:admin/parent/child' AFTER created_by,
+    ADD COLUMN audit_status VARCHAR(20) DEFAULT 'approved' COMMENT '审核状态:approved/pending/rejected' AFTER status,
+    ADD COLUMN audit_reason TEXT COMMENT '驳回原因' AFTER audit_status,
+    ADD COLUMN auditor_id BIGINT DEFAULT 0 COMMENT '审核人 ID' AFTER audit_reason,
     ADD COLUMN audited_at DATETIME COMMENT '审核时间' AFTER auditor_id;
-
--- =============================================
--- 五维能量系统表
--- =============================================
-
--- 能量维度定义表
-CREATE TABLE IF NOT EXISTS energy_dimension (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    code VARCHAR(16) NOT NULL UNIQUE COMMENT '维度代码: body/mind/wisdom/action/wealth',
-    name VARCHAR(20) NOT NULL COMMENT '维度名称: 身/心/智/行/富',
-    icon VARCHAR(16) COMMENT '图标emoji',
-    element VARCHAR(10) COMMENT '五行元素: 土/火/金/木/水',
-    sort_order INT DEFAULT 0 COMMENT '显示顺序',
-    status TINYINT DEFAULT 1 COMMENT '状态:1启用/0禁用',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间'
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='能量维度定义表';
-
--- 服务-维度比例配置表
-CREATE TABLE IF NOT EXISTS energy_source_config (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    source_type VARCHAR(32) NOT NULL COMMENT '来源类型: task/activity/course/product/consultation',
-    source_id BIGINT NOT NULL COMMENT '来源业务表ID',
-    source_name VARCHAR(200) COMMENT '冗余名称',
-    dimension_id BIGINT NOT NULL COMMENT '维度ID',
-    ratio INT NOT NULL COMMENT '占比(基点,6000=60%)',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    INDEX idx_source (source_type, source_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='服务-维度比例配置表';
-
--- 能量流水表
-CREATE TABLE IF NOT EXISTS energy_log (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    child_id BIGINT NOT NULL COMMENT '孩子ID',
-    dimension_id BIGINT NOT NULL COMMENT '维度ID',
-    amount INT NOT NULL COMMENT '变动量(正=获得,负=消耗)',
-    balance_after INT NOT NULL COMMENT '变动后余额',
-    source_type VARCHAR(32) COMMENT '来源类型: task/product/medical_report/daily_record',
-    source_id BIGINT COMMENT '来源ID',
-    ref_id BIGINT COMMENT '关联旧流水ID(覆盖时标记)',
-    expires_at DATETIME COMMENT '过期时间(空=永不过期)',
-    description TEXT COMMENT '描述',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    INDEX idx_child_dim (child_id, dimension_id),
-    INDEX idx_created (created_at),
-    INDEX idx_source (source_type, source_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='能量流水表';
-
--- 维度余额表
-CREATE TABLE IF NOT EXISTS energy_balance (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    child_id BIGINT NOT NULL COMMENT '孩子ID',
-    dimension_id BIGINT NOT NULL COMMENT '维度ID',
-    balance INT DEFAULT 0 COMMENT '当前能量值(可为负)',
-    total_earned INT DEFAULT 0 COMMENT '累计获得',
-    total_spent INT DEFAULT 0 COMMENT '累计消耗',
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-    UNIQUE KEY uk_child_dim (child_id, dimension_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='维度余额表';
-
--- =============================================
--- 佣金系统表
--- =============================================
-
--- 佣金记录表
-CREATE TABLE IF NOT EXISTS commission_records (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    order_id BIGINT NOT NULL COMMENT '订单ID',
-    order_type VARCHAR(32) NOT NULL COMMENT '订单类型: membership/product/assessment/package',
-    referrer_id BIGINT NOT NULL COMMENT '推荐人ID',
-    buyer_id BIGINT NOT NULL COMMENT '购买人ID',
-    commission_type VARCHAR(16) NOT NULL COMMENT '佣金类型: member/profit',
-    level INT DEFAULT 1 COMMENT '佣金层级: 1=直接推荐, 2=间接推荐',
-    order_amount INT NOT NULL COMMENT '订单金额(分)',
-    profit_rate INT DEFAULT 0 COMMENT '利润率(千分比,如235=23.5%)',
-    commission_amount INT NOT NULL COMMENT '佣金金额(分)',
-    status VARCHAR(16) NOT NULL DEFAULT 'settled' COMMENT '状态: pending/settled',
-    remark TEXT DEFAULT NULL COMMENT '备注',
-    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    settled_at DATETIME DEFAULT NULL COMMENT '结算时间',
-    withdrawn_at DATETIME DEFAULT NULL COMMENT '提现时间',
-    INDEX idx_referrer (referrer_id),
-    INDEX idx_buyer (buyer_id),
-    INDEX idx_order (order_id, order_type)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='佣金记录表';
-
--- 提现申请表
-CREATE TABLE IF NOT EXISTS withdrawal_requests (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    user_id BIGINT NOT NULL COMMENT '用户ID',
-    amount INT NOT NULL COMMENT '提现金额(分)',
-    account_info TEXT COMMENT '账户信息(JSON)',
-    status VARCHAR(16) NOT NULL DEFAULT 'pending' COMMENT '状态: pending/approved/rejected',
-    audit_by BIGINT DEFAULT NULL COMMENT '审核人ID',
-    audit_at DATETIME DEFAULT NULL COMMENT '审核时间',
-    remark TEXT DEFAULT NULL COMMENT '审核备注',
-    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    INDEX idx_user (user_id),
-    INDEX idx_status (status)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='提现申请表';
-
--- 会员升级记录表
-CREATE TABLE IF NOT EXISTS member_upgrade_records (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    user_id BIGINT NOT NULL COMMENT '用户ID',
-    from_level VARCHAR(20) NOT NULL COMMENT '升级前等级',
-    to_level VARCHAR(20) NOT NULL COMMENT '升级后等级',
-    upgrade_type VARCHAR(20) NOT NULL COMMENT '升级类型: pay/consumption/admin',
-    order_id BIGINT DEFAULT NULL COMMENT '关联支付订单ID',
-    consumption_amount BIGINT DEFAULT NULL COMMENT '触发升级的累计消费金额',
-    expire_time DATETIME DEFAULT NULL COMMENT '家庭会员到期时间',
-    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    INDEX idx_user (user_id),
-    INDEX idx_order (order_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='会员升级记录表';
-
--- =============================================
--- 规划师服务模块表
--- =============================================
-
--- 服务类型表
-CREATE TABLE IF NOT EXISTS service_types (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    name VARCHAR(100) NOT NULL COMMENT '类型名称',
-    icon VARCHAR(50) COMMENT '图标',
-    description TEXT COMMENT '描述',
-    sort_order INT DEFAULT 0 COMMENT '排序',
-    status VARCHAR(20) DEFAULT 'ACTIVE' COMMENT '状态: ACTIVE/DISABLED',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间'
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='服务类型表';
-
--- 服务内容表
-CREATE TABLE IF NOT EXISTS service_contents (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    type_id BIGINT NOT NULL COMMENT '关联服务类型',
-    title VARCHAR(200) NOT NULL COMMENT '内容标题',
-    content TEXT COMMENT '富文本内容',
-    duration INT COMMENT '建议时长(分钟)',
-    age_range VARCHAR(50) COMMENT '适用年龄',
-    price INT COMMENT '参考价格(分)',
-    status VARCHAR(20) DEFAULT 'DRAFT' COMMENT '状态: DRAFT/ACTIVE',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间'
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='服务内容表';
-
--- 套餐模板表
-CREATE TABLE IF NOT EXISTS guide_package_templates (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    name VARCHAR(100) NOT NULL COMMENT '模板名称',
-    validity_months INT COMMENT '有效期(月)',
-    reference_price INT COMMENT '参考价格(分)',
-    min_price INT COMMENT '最低售价(分)',
-    description TEXT COMMENT '说明',
-    status VARCHAR(20) DEFAULT 'ACTIVE' COMMENT '状态: ACTIVE/DISABLED',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间'
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='套餐模板表';
-
--- 套餐模板服务项表
-CREATE TABLE IF NOT EXISTS package_template_services (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    template_id BIGINT NOT NULL COMMENT '关联模板',
-    content_id BIGINT NOT NULL COMMENT '关联服务内容',
-    quantity INT DEFAULT 1 COMMENT '数量',
-    unit VARCHAR(20) COMMENT '单位'
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='套餐模板服务项表';
-
--- 成长规划师套餐表
-CREATE TABLE IF NOT EXISTS guide_packages (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    guide_id BIGINT COMMENT '成长规划师ID',
-    package_id BIGINT COMMENT '关联模板',
-    commission_rate INT COMMENT '佣金比例(基点,1000=10%)',
-    teacher_id BIGINT COMMENT '成长规划师ID(旧字段)',
-    template_id BIGINT COMMENT '关联模板(旧字段)',
-    name VARCHAR(100) NOT NULL COMMENT '套餐名称',
-    level VARCHAR(20) COMMENT '套餐等级',
-    price INT NOT NULL COMMENT '销售价格(分)',
-    validity_months INT COMMENT '有效期(月)',
-    validity_days INT DEFAULT 0 COMMENT '有效期天数',
-    description TEXT COMMENT '套餐说明',
-    status VARCHAR(20) DEFAULT 'DRAFT' COMMENT '状态: DRAFT/PUBLISHED/PAUSED',
-    sort_order INT DEFAULT 0 COMMENT '排序',
-    sales_count INT DEFAULT 0 COMMENT '销量',
-    share_code VARCHAR(50) COMMENT '分享码',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间'
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='成长规划师套餐表';
-
--- 成长规划师套餐服务项表
-CREATE TABLE IF NOT EXISTS guide_package_services (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    package_id BIGINT NOT NULL COMMENT '关联套餐',
-    content_id BIGINT NOT NULL COMMENT '关联服务内容',
-    quantity INT DEFAULT 1 COMMENT '数量',
-    unit VARCHAR(20) COMMENT '单位'
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='成长规划师套餐服务项表';
-
--- 成长规划师订单表
-CREATE TABLE IF NOT EXISTS guide_orders (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    order_no VARCHAR(50) NOT NULL COMMENT '订单号',
-    teacher_id BIGINT NOT NULL COMMENT '成长规划师ID',
-    family_id BIGINT NOT NULL COMMENT '家庭ID',
-    package_id BIGINT NOT NULL COMMENT '套餐ID',
-    amount INT NOT NULL COMMENT '金额(分)',
-    status VARCHAR(20) DEFAULT 'PENDING' COMMENT '状态: PENDING/PAID/COMPLETED/REFUNDED',
-    pay_time DATETIME COMMENT '支付时间',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间'
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='成长规划师订单表';
-
--- 佣金明细表
-CREATE TABLE IF NOT EXISTS guide_commissions (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    teacher_id BIGINT NOT NULL COMMENT '成长规划师ID',
-    order_id BIGINT NOT NULL COMMENT '订单ID',
-    amount INT NOT NULL COMMENT '佣金金额(分)',
-    rate INT COMMENT '佣金比例(基点)',
-    status VARCHAR(20) DEFAULT 'PENDING' COMMENT '状态: PENDING/COMPLETED',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间'
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='佣金明细表';
-
--- 服务记录表
-CREATE TABLE IF NOT EXISTS guide_service_logs (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    teacher_id BIGINT NOT NULL COMMENT '成长规划师ID',
-    family_id BIGINT NOT NULL COMMENT '家庭ID',
-    order_id BIGINT COMMENT '订单ID',
-    service_content_id BIGINT NOT NULL COMMENT '服务内容ID',
-    notes TEXT COMMENT '服务记录',
-    duration INT COMMENT '服务时长(分钟)',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间'
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='服务记录表';
-
--- 成长规划师邀请码表
-CREATE TABLE IF NOT EXISTS guide_invite_codes (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    guide_id BIGINT NOT NULL COMMENT '成长规划师用户ID',
-    code VARCHAR(50) NOT NULL UNIQUE COMMENT '邀请码',
-    status VARCHAR(20) DEFAULT 'active' COMMENT '状态',
-    used_by_user_id BIGINT COMMENT '使用该邀请码的用户ID',
-    used_at DATETIME COMMENT '使用时间',
-    expire_at DATETIME COMMENT '过期时间',
-    use_count INT DEFAULT 0 COMMENT '使用次数',
-    max_use_count INT COMMENT '最大使用次数',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间'
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='成长规划师邀请码表';
-
--- =============================================
--- 财富维度表
--- =============================================
-
--- 财商打卡记录表
-CREATE TABLE IF NOT EXISTS finance_checkins (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    user_id BIGINT NOT NULL COMMENT '用户ID',
-    child_id BIGINT NOT NULL COMMENT '孩子ID',
-    checkin_type VARCHAR(20) NOT NULL COMMENT '打卡类型: daily_plan/saving/expense/review',
-    checkin_date DATE NOT NULL COMMENT '打卡日期',
-    amount INT COMMENT '金额(分,收支记录)',
-    category VARCHAR(50) COMMENT '收支分类',
-    note TEXT COMMENT '备注',
-    mood VARCHAR(20) COMMENT '心情',
-    earned_energy INT DEFAULT 0 COMMENT '获得的能量值',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    INDEX idx_user_date (user_id, checkin_date),
-    INDEX idx_child (child_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='财商打卡记录表';
-
--- 保单管理表
-CREATE TABLE IF NOT EXISTS insurance_policies (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    user_id BIGINT NOT NULL COMMENT '用户ID',
-    child_id BIGINT COMMENT '关联孩子ID',
-    policy_name VARCHAR(100) NOT NULL COMMENT '保单名称',
-    insurance_company VARCHAR(100) COMMENT '保险公司',
-    policy_type VARCHAR(50) COMMENT '保单类型: medical/life/accident/education/endowment',
-    insured_person VARCHAR(50) NOT NULL COMMENT '被保人姓名',
-    premium INT COMMENT '保费(分)',
-    sum_insured INT COMMENT '保额(分)',
-    start_date DATE COMMENT '生效日期',
-    end_date DATE COMMENT '到期日期',
-    renewal_type VARCHAR(20) DEFAULT 'annual' COMMENT '续费类型: annual/monthly/single',
-    status VARCHAR(20) DEFAULT 'active' COMMENT '状态: active/expired/cancelled',
-    policy_no VARCHAR(100) COMMENT '保单号',
-    remark TEXT COMMENT '备注',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-    INDEX idx_user (user_id),
-    INDEX idx_child (child_id),
-    INDEX idx_status (status)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='保单管理表';
-
--- =============================================
--- 健康检测报告模块表
--- =============================================
-
--- 健康检测报告表
-CREATE TABLE IF NOT EXISTS health_reports (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    user_id BIGINT NOT NULL COMMENT '上传者用户ID(关联users表)',
-    subject_id BIGINT COMMENT '报告主体用户ID(关联users表,为null表示未绑定)',
-    family_id BIGINT COMMENT '家庭ID',
-    report_type VARCHAR(32) NOT NULL COMMENT '报告类型: physical_exam(体检)/gut_flora(菌群检测)',
-    report_date DATE COMMENT '报告日期',
-    overall_score INT COMMENT '健康总分(0-100)',
-    gut_health_score INT COMMENT '菌群健康分',
-    chronic_disease_score INT COMMENT '慢病控制分',
-    nutrition_score INT COMMENT '营养均衡分',
-    gut_age VARCHAR(32) COMMENT '肠道预测年龄',
-    gut_type VARCHAR(50) COMMENT '肠型',
-    file_url VARCHAR(500) COMMENT '报告文件URL',
-    status VARCHAR(20) DEFAULT 'active' COMMENT '状态: active/archived',
-    remark TEXT COMMENT '备注',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-    INDEX idx_user_id (user_id),
-    INDEX idx_subject_id (subject_id),
-    INDEX idx_family_id (family_id),
-    INDEX idx_report_type (report_type)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='健康检测报告表';
-
--- 健康报告查看权限表
-CREATE TABLE IF NOT EXISTS health_report_permissions (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    report_id BIGINT NOT NULL COMMENT '报告ID',
-    user_id BIGINT NOT NULL COMMENT '有查看权限的用户ID',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    UNIQUE KEY uk_report_user (report_id, user_id),
-    INDEX idx_report_id (report_id),
-    INDEX idx_user_id (user_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='健康报告查看权限表';
-
--- 健康指标明细表
-CREATE TABLE IF NOT EXISTS health_indicators (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    report_id BIGINT NOT NULL COMMENT '关联报告ID',
-    category VARCHAR(50) COMMENT '指标分类: 营养状况/疾病风险/肠道屏障/神经递质/...',
-    indicator_name VARCHAR(100) NOT NULL COMMENT '指标名称',
-    indicator_value VARCHAR(100) COMMENT '检测值',
-    unit VARCHAR(50) COMMENT '单位',
-    ref_range VARCHAR(200) COMMENT '参考范围',
-    status VARCHAR(50) COMMENT '评估状态: 正常/偏低/偏高/过多/注意/低风险/未检出',
-    sort_order INT DEFAULT 0 COMMENT '显示排序',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    INDEX idx_report_id (report_id),
-    INDEX idx_category (category)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='健康指标明细表';
-
--- 健康报告上传草稿表(两阶段入库的中间态)
-CREATE TABLE IF NOT EXISTS health_report_drafts (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    user_id BIGINT NOT NULL COMMENT '上传人用户ID',
-    family_id BIGINT COMMENT '家庭ID',
-    report_type VARCHAR(32) NOT NULL COMMENT '报告类型: physical_exam/gut_flora',
-    file_url VARCHAR(500) COMMENT '上传的文件URL',
-    original_filename VARCHAR(255) COMMENT '原始文件名',
-    payload_json MEDIUMTEXT NOT NULL COMMENT '草稿载荷JSON(含解析/手动录入的所有指标)',
-    status VARCHAR(20) DEFAULT 'pending' COMMENT '状态: pending/confirmed/discarded',
-    expire_at DATETIME COMMENT '草稿过期时间',
-    confirmed_report_id BIGINT COMMENT 'confirm阶段入库后的健康报告ID',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-    INDEX idx_user_id (user_id),
-    INDEX idx_status_expire (status, expire_at)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='健康报告上传草稿表(两阶段入库中间态)';
-
--- 教育体系配置表
-CREATE TABLE IF NOT EXISTS education_systems (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    name VARCHAR(32) NOT NULL UNIQUE COMMENT '编码(key)',
-    label VARCHAR(50) NOT NULL COMMENT '显示名称',
-    description TEXT COMMENT '描述说明',
-    sort_order INT DEFAULT 0 COMMENT '排序',
-    status VARCHAR(20) DEFAULT 'ACTIVE' COMMENT '状态: ACTIVE/DISABLED',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间'
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='教育体系配置表';
-
-INSERT INTO education_systems (name, label, description, sort_order) VALUES
-('high_school', '中专/高中', '中等教育学历', 1),
-('associate', '大专', '高等专科学历', 2),
-('bachelor', '本科', '大学本科学历', 3),
-('master', '硕士', '硕士研究生学历', 4),
-('doctor', '博士', '博士研究生学历', 5);
-
--- ===== v1.2 先天属性体系 =====
-
--- 家庭成员先天属性表
-CREATE TABLE IF NOT EXISTS family_member_attributes (
-    id               BIGINT AUTO_INCREMENT PRIMARY KEY,
-    member_id        BIGINT       NOT NULL COMMENT '家庭成员ID(children表或users表)',
-    member_type      VARCHAR(10)  NOT NULL COMMENT '成员类型: child/parent',
-    birth_datetime   DATETIME     COMMENT '出生日期(精确到分钟,用于八字排盘)',
-    eight_characters JSON         COMMENT '八字四柱JSON',
-    wuxing_elements  JSON         COMMENT '五行星盘元素JSON',
-    zodiac           VARCHAR(16)  COMMENT '生肖: rat/ox/tiger/rabbit/dragon/snake/horse/sheep/monkey/rooster/dog/pig',
-    blood_type       VARCHAR(5)   COMMENT '血型: A/B/AB/O',
-    mind_base_score  INT DEFAULT 0 COMMENT '心维度基础分(百分位)',
-    wisdom_base_score INT DEFAULT 0 COMMENT '智维度基础分(百分位)',
-    behavior_modifier JSON        COMMENT '行为修正因子JSON',
-    created_at       DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at       DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    UNIQUE KEY uk_member (member_id, member_type)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='家庭成员先天属性表';
-
--- 星座配置表
-CREATE TABLE IF NOT EXISTS zodiac_config (
-    id               BIGINT AUTO_INCREMENT PRIMARY KEY,
-    zodiac_code      VARCHAR(20)  NOT NULL UNIQUE COMMENT '星座代码',
-    zodiac_name      VARCHAR(10)  NOT NULL COMMENT '星座名称',
-    element          VARCHAR(10)  NOT NULL COMMENT '五行: 金木水火土',
-    start_month      INT          NOT NULL COMMENT '起始月',
-    start_day        INT          NOT NULL COMMENT '起始日',
-    end_month        INT          NOT NULL COMMENT '结束月',
-    end_day          INT          NOT NULL COMMENT '结束日',
-    mind_base        INT DEFAULT 0 COMMENT '心先天基础分(百分位)',
-    wisdom_base      INT DEFAULT 0 COMMENT '智先天基础分(百分位)',
-    body_modifier    INT DEFAULT 0 COMMENT '身修正系数(千分比)',
-    action_modifier  INT DEFAULT 0 COMMENT '行修正系数(千分比)',
-    wealth_modifier  INT DEFAULT 0 COMMENT '富修正系数(千分比)',
-    created_at       DATETIME DEFAULT CURRENT_TIMESTAMP
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='星座配置表';
-
--- 八字配置表
-CREATE TABLE IF NOT EXISTS bazi_config (
-    id               BIGINT AUTO_INCREMENT PRIMARY KEY,
-    stem_or_branch   VARCHAR(10)  NOT NULL COMMENT '天干或地支',
-    type             VARCHAR(10)  NOT NULL COMMENT '类型: stem/branch',
-    element          VARCHAR(10)  NOT NULL COMMENT '五行: 金木水火土',
-    yin_yang         VARCHAR(5)   COMMENT '阴阳: yin/yang',
-    mind_base        INT DEFAULT 0 COMMENT '心先天基础分(百分位)',
-    wisdom_base      INT DEFAULT 0 COMMENT '智先天基础分(百分位)',
-    body_modifier    INT DEFAULT 0 COMMENT '身修正系数(千分比)',
-    action_modifier  INT DEFAULT 0 COMMENT '行修正系数(千分比)',
-    wealth_modifier  INT DEFAULT 0 COMMENT '富修正系数(千分比)',
-    created_at       DATETIME DEFAULT CURRENT_TIMESTAMP
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='八字配置表(天干地支五行)';
-
--- 血型配置表
-CREATE TABLE IF NOT EXISTS blood_type_config (
-    id               BIGINT AUTO_INCREMENT PRIMARY KEY,
-    blood_type       VARCHAR(5)   NOT NULL UNIQUE COMMENT '血型: A/B/AB/O',
-    description      TEXT COMMENT '性格描述',
-    mind_base        INT DEFAULT 0 COMMENT '心先天基础分(百分位)',
-    wisdom_base      INT DEFAULT 0 COMMENT '智先天基础分(百分位)',
-    body_modifier    INT DEFAULT 0 COMMENT '身修正系数(千分比)',
-    action_modifier  INT DEFAULT 0 COMMENT '行修正系数(千分比)',
-    wealth_modifier  INT DEFAULT 0 COMMENT '富修正系数(千分比)',
-    created_at       DATETIME DEFAULT CURRENT_TIMESTAMP
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='血型配置表';
-
--- =============================================
--- 活动报名 与 能量规则引擎表(v1.4)
--- =============================================
-
--- 活动报名表
-CREATE TABLE IF NOT EXISTS activity_registrations (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    activity_id BIGINT NOT NULL COMMENT '活动ID',
-    child_id BIGINT NOT NULL COMMENT '孩子ID',
-    user_id BIGINT NOT NULL COMMENT '报名人用户ID(家长)',
-    status VARCHAR(20) DEFAULT 'pending' COMMENT '状态: pending/approved/rejected/cancelled',
-    registered_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '报名时间',
-    approved_at DATETIME COMMENT '审核通过时间',
-    approved_by BIGINT COMMENT '审核人用户ID',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-    UNIQUE KEY uk_activity_child (activity_id, child_id),
-    INDEX idx_activity_id (activity_id),
-    INDEX idx_child_id (child_id),
-    INDEX idx_user_id (user_id),
-    INDEX idx_status (status)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='活动报名表';
-
--- 能量规则表(规则引擎)
-CREATE TABLE IF NOT EXISTS energy_rule (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    rule_code VARCHAR(64) NOT NULL UNIQUE COMMENT '规则编码(唯一)',
-    rule_name VARCHAR(200) NOT NULL COMMENT '规则名称',
-    event_type VARCHAR(32) NOT NULL COMMENT '事件类型: checkin/register/complete/cancel/overdue',
-    action VARCHAR(16) NOT NULL COMMENT '动作: increase/decrease',
-    dimension_code VARCHAR(20) COMMENT '维度代码: body/mind/wisdom/action/wealth(NULL=五维均衡)',
-    amount INT COMMENT '固定变动量(基点)',
-    amount_formula VARCHAR(255) COMMENT '动态公式(如: balance*0.1)',
-    priority INT DEFAULT 0 COMMENT '优先级(数字越大越优先匹配)',
-    conditions JSON COMMENT '触发条件(JSON表达式)',
-    status TINYINT DEFAULT 1 COMMENT '状态: 1=启用 0=禁用',
-    description TEXT COMMENT '规则描述',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-    INDEX idx_event_type (event_type),
-    INDEX idx_status (status),
-    INDEX idx_priority (priority)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='能量规则表(规则引擎)';
-
-CREATE TABLE IF NOT EXISTS activities (
-    id               BIGINT AUTO_INCREMENT PRIMARY KEY,
-    title            VARCHAR(100) NOT NULL COMMENT '活动标题',
-    description      TEXT COMMENT '活动描述',
-    cover_image      VARCHAR(500) COMMENT '封面图片URL',
-    dimension_code   VARCHAR(20) COMMENT '维度代码: body/mind/wisdom/action/wealth',
-    activity_type    VARCHAR(20) DEFAULT 'offline' COMMENT '活动类型: offline/online/campaign',
-    status           VARCHAR(20) DEFAULT 'draft' COMMENT '状态: draft/published/ended',
-    start_time       DATETIME COMMENT '开始时间',
-    end_time         DATETIME COMMENT '结束时间',
-    location         VARCHAR(200) COMMENT '活动地点',
-    max_participants INT DEFAULT 0 COMMENT '最大参与人数',
-    current_participants INT DEFAULT 0 COMMENT '当前参与人数',
+
+-- =============================================
+-- 五维能量系统表
+-- =============================================
+
+-- 能量维度定义表
+CREATE TABLE IF NOT EXISTS energy_dimension (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    code VARCHAR(16) NOT NULL UNIQUE COMMENT '维度代码: body/mind/wisdom/action/wealth',
+    name VARCHAR(20) NOT NULL COMMENT '维度名称: 身/心/智/行/富',
+    icon VARCHAR(16) COMMENT '图标emoji',
+    element VARCHAR(10) COMMENT '五行元素: 土/火/金/木/水',
+    sort_order INT DEFAULT 0 COMMENT '显示顺序',
+    status TINYINT DEFAULT 1 COMMENT '状态:1启用/0禁用',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间'
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='能量维度定义表';
+
+-- 服务-维度比例配置表
+CREATE TABLE IF NOT EXISTS energy_source_config (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    source_type VARCHAR(32) NOT NULL COMMENT '来源类型: task/activity/course/product/consultation',
+    source_id BIGINT NOT NULL COMMENT '来源业务表ID',
+    source_name VARCHAR(200) COMMENT '冗余名称',
+    dimension_id BIGINT NOT NULL COMMENT '维度ID',
+    ratio INT NOT NULL COMMENT '占比(基点,6000=60%)',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    INDEX idx_source (source_type, source_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='服务-维度比例配置表';
+
+-- 能量流水表
+CREATE TABLE IF NOT EXISTS energy_log (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    child_id BIGINT NOT NULL COMMENT '孩子ID',
+    dimension_id BIGINT NOT NULL COMMENT '维度ID',
+    amount INT NOT NULL COMMENT '变动量(正=获得,负=消耗)',
+    balance_after INT NOT NULL COMMENT '变动后余额',
+    source_type VARCHAR(32) COMMENT '来源类型: task/product/medical_report/daily_record',
+    source_id BIGINT COMMENT '来源ID',
+    ref_id BIGINT COMMENT '关联旧流水ID(覆盖时标记)',
+    expires_at DATETIME COMMENT '过期时间(空=永不过期)',
+    description TEXT COMMENT '描述',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    INDEX idx_child_dim (child_id, dimension_id),
+    INDEX idx_created (created_at),
+    INDEX idx_source (source_type, source_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='能量流水表';
+
+-- 维度余额表
+CREATE TABLE IF NOT EXISTS energy_balance (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    child_id BIGINT NOT NULL COMMENT '孩子ID',
+    dimension_id BIGINT NOT NULL COMMENT '维度ID',
+    balance INT DEFAULT 0 COMMENT '当前能量值(可为负)',
+    total_earned INT DEFAULT 0 COMMENT '累计获得',
+    total_spent INT DEFAULT 0 COMMENT '累计消耗',
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+    UNIQUE KEY uk_child_dim (child_id, dimension_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='维度余额表';
+
+-- =============================================
+-- 佣金系统表
+-- =============================================
+
+-- 佣金记录表
+CREATE TABLE IF NOT EXISTS commission_records (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    order_id BIGINT NOT NULL COMMENT '订单ID',
+    order_type VARCHAR(32) NOT NULL COMMENT '订单类型: membership/product/assessment/package',
+    referrer_id BIGINT NOT NULL COMMENT '推荐人ID',
+    buyer_id BIGINT NOT NULL COMMENT '购买人ID',
+    commission_type VARCHAR(16) NOT NULL COMMENT '佣金类型: member/profit',
+    level INT DEFAULT 1 COMMENT '佣金层级: 1=直接推荐, 2=间接推荐',
+    order_amount INT NOT NULL COMMENT '订单金额(分)',
+    profit_rate INT DEFAULT 0 COMMENT '利润率(千分比,如235=23.5%)',
+    commission_amount INT NOT NULL COMMENT '佣金金额(分)',
+    status VARCHAR(16) NOT NULL DEFAULT 'settled' COMMENT '状态: pending/settled',
+    remark TEXT DEFAULT NULL COMMENT '备注',
+    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    settled_at DATETIME DEFAULT NULL COMMENT '结算时间',
+    withdrawn_at DATETIME DEFAULT NULL COMMENT '提现时间',
+    INDEX idx_referrer (referrer_id),
+    INDEX idx_buyer (buyer_id),
+    INDEX idx_order (order_id, order_type)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='佣金记录表';
+
+-- 提现申请表
+CREATE TABLE IF NOT EXISTS withdrawal_requests (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    user_id BIGINT NOT NULL COMMENT '用户ID',
+    amount INT NOT NULL COMMENT '提现金额(分)',
+    account_info TEXT COMMENT '账户信息(JSON)',
+    status VARCHAR(16) NOT NULL DEFAULT 'pending' COMMENT '状态: pending/approved/rejected',
+    audit_by BIGINT DEFAULT NULL COMMENT '审核人ID',
+    audit_at DATETIME DEFAULT NULL COMMENT '审核时间',
+    remark TEXT DEFAULT NULL COMMENT '审核备注',
+    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    INDEX idx_user (user_id),
+    INDEX idx_status (status)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='提现申请表';
+
+-- 会员升级记录表
+CREATE TABLE IF NOT EXISTS member_upgrade_records (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    user_id BIGINT NOT NULL COMMENT '用户ID',
+    from_level VARCHAR(20) NOT NULL COMMENT '升级前等级',
+    to_level VARCHAR(20) NOT NULL COMMENT '升级后等级',
+    upgrade_type VARCHAR(20) NOT NULL COMMENT '升级类型: pay/consumption/admin',
+    order_id BIGINT DEFAULT NULL COMMENT '关联支付订单ID',
+    consumption_amount BIGINT DEFAULT NULL COMMENT '触发升级的累计消费金额',
+    expire_time DATETIME DEFAULT NULL COMMENT '家庭会员到期时间',
+    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    INDEX idx_user (user_id),
+    INDEX idx_order (order_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='会员升级记录表';
+
+-- =============================================
+-- 规划师服务模块表
+-- =============================================
+
+-- 服务类型表
+CREATE TABLE IF NOT EXISTS service_types (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    name VARCHAR(100) NOT NULL COMMENT '类型名称',
+    icon VARCHAR(50) COMMENT '图标',
+    description TEXT COMMENT '描述',
+    sort_order INT DEFAULT 0 COMMENT '排序',
+    status VARCHAR(20) DEFAULT 'ACTIVE' COMMENT '状态: ACTIVE/DISABLED',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间'
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='服务类型表';
+
+-- 服务内容表
+CREATE TABLE IF NOT EXISTS service_contents (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    type_id BIGINT NOT NULL COMMENT '关联服务类型',
+    title VARCHAR(200) NOT NULL COMMENT '内容标题',
+    content TEXT COMMENT '富文本内容',
+    duration INT COMMENT '建议时长(分钟)',
+    age_range VARCHAR(50) COMMENT '适用年龄',
+    price INT COMMENT '参考价格(分)',
+    status VARCHAR(20) DEFAULT 'DRAFT' COMMENT '状态: DRAFT/ACTIVE',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间'
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='服务内容表';
+
+-- 套餐模板表
+CREATE TABLE IF NOT EXISTS guide_package_templates (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    name VARCHAR(100) NOT NULL COMMENT '模板名称',
+    validity_months INT COMMENT '有效期(月)',
+    reference_price INT COMMENT '参考价格(分)',
+    min_price INT COMMENT '最低售价(分)',
+    description TEXT COMMENT '说明',
+    status VARCHAR(20) DEFAULT 'ACTIVE' COMMENT '状态: ACTIVE/DISABLED',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间'
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='套餐模板表';
+
+-- 套餐模板服务项表
+CREATE TABLE IF NOT EXISTS package_template_services (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    template_id BIGINT NOT NULL COMMENT '关联模板',
+    content_id BIGINT NOT NULL COMMENT '关联服务内容',
+    quantity INT DEFAULT 1 COMMENT '数量',
+    unit VARCHAR(20) COMMENT '单位'
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='套餐模板服务项表';
+
+-- 成长规划师套餐表
+CREATE TABLE IF NOT EXISTS guide_packages (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    guide_id BIGINT COMMENT '成长规划师ID',
+    package_id BIGINT COMMENT '关联模板',
+    commission_rate INT COMMENT '佣金比例(基点,1000=10%)',
+    teacher_id BIGINT COMMENT '成长规划师ID(旧字段)',
+    template_id BIGINT COMMENT '关联模板(旧字段)',
+    name VARCHAR(100) NOT NULL COMMENT '套餐名称',
+    level VARCHAR(20) COMMENT '套餐等级',
+    price INT NOT NULL COMMENT '销售价格(分)',
+    validity_months INT COMMENT '有效期(月)',
+    validity_days INT DEFAULT 0 COMMENT '有效期天数',
+    description TEXT COMMENT '套餐说明',
+    status VARCHAR(20) DEFAULT 'DRAFT' COMMENT '状态: DRAFT/PUBLISHED/PAUSED',
+    sort_order INT DEFAULT 0 COMMENT '排序',
+    sales_count INT DEFAULT 0 COMMENT '销量',
+    share_code VARCHAR(50) COMMENT '分享码',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间'
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='成长规划师套餐表';
+
+-- 成长规划师套餐服务项表
+CREATE TABLE IF NOT EXISTS guide_package_services (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    package_id BIGINT NOT NULL COMMENT '关联套餐',
+    content_id BIGINT NOT NULL COMMENT '关联服务内容',
+    quantity INT DEFAULT 1 COMMENT '数量',
+    unit VARCHAR(20) COMMENT '单位'
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='成长规划师套餐服务项表';
+
+-- 成长规划师订单表
+CREATE TABLE IF NOT EXISTS guide_orders (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    order_no VARCHAR(50) NOT NULL COMMENT '订单号',
+    teacher_id BIGINT NOT NULL COMMENT '成长规划师ID',
+    family_id BIGINT NOT NULL COMMENT '家庭ID',
+    package_id BIGINT NOT NULL COMMENT '套餐ID',
+    amount INT NOT NULL COMMENT '金额(分)',
+    status VARCHAR(20) DEFAULT 'PENDING' COMMENT '状态: PENDING/PAID/COMPLETED/REFUNDED',
+    pay_time DATETIME COMMENT '支付时间',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间'
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='成长规划师订单表';
+
+-- 佣金明细表
+CREATE TABLE IF NOT EXISTS guide_commissions (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    teacher_id BIGINT NOT NULL COMMENT '成长规划师ID',
+    order_id BIGINT NOT NULL COMMENT '订单ID',
+    amount INT NOT NULL COMMENT '佣金金额(分)',
+    rate INT COMMENT '佣金比例(基点)',
+    status VARCHAR(20) DEFAULT 'PENDING' COMMENT '状态: PENDING/COMPLETED',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间'
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='佣金明细表';
+
+-- 服务记录表
+CREATE TABLE IF NOT EXISTS guide_service_logs (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    teacher_id BIGINT NOT NULL COMMENT '成长规划师ID',
+    family_id BIGINT NOT NULL COMMENT '家庭ID',
+    order_id BIGINT COMMENT '订单ID',
+    service_content_id BIGINT NOT NULL COMMENT '服务内容ID',
+    notes TEXT COMMENT '服务记录',
+    duration INT COMMENT '服务时长(分钟)',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间'
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='服务记录表';
+
+-- 成长规划师邀请码表
+CREATE TABLE IF NOT EXISTS guide_invite_codes (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    guide_id BIGINT NOT NULL COMMENT '成长规划师用户ID',
+    code VARCHAR(50) NOT NULL UNIQUE COMMENT '邀请码',
+    status VARCHAR(20) DEFAULT 'active' COMMENT '状态',
+    used_by_user_id BIGINT COMMENT '使用该邀请码的用户ID',
+    used_at DATETIME COMMENT '使用时间',
+    expire_at DATETIME COMMENT '过期时间',
+    use_count INT DEFAULT 0 COMMENT '使用次数',
+    max_use_count INT COMMENT '最大使用次数',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间'
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='成长规划师邀请码表';
+
+-- =============================================
+-- 财富维度表
+-- =============================================
+
+-- 财商打卡记录表
+CREATE TABLE IF NOT EXISTS finance_checkins (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    user_id BIGINT NOT NULL COMMENT '用户ID',
+    child_id BIGINT NOT NULL COMMENT '孩子ID',
+    checkin_type VARCHAR(20) NOT NULL COMMENT '打卡类型: daily_plan/saving/expense/review',
+    checkin_date DATE NOT NULL COMMENT '打卡日期',
+    amount INT COMMENT '金额(分,收支记录)',
+    category VARCHAR(50) COMMENT '收支分类',
+    note TEXT COMMENT '备注',
+    mood VARCHAR(20) COMMENT '心情',
+    earned_energy INT DEFAULT 0 COMMENT '获得的能量值',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    INDEX idx_user_date (user_id, checkin_date),
+    INDEX idx_child (child_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='财商打卡记录表';
+
+-- 保单管理表
+CREATE TABLE IF NOT EXISTS insurance_policies (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    user_id BIGINT NOT NULL COMMENT '用户ID',
+    child_id BIGINT COMMENT '关联孩子ID',
+    policy_name VARCHAR(100) NOT NULL COMMENT '保单名称',
+    insurance_company VARCHAR(100) COMMENT '保险公司',
+    policy_type VARCHAR(50) COMMENT '保单类型: medical/life/accident/education/endowment',
+    insured_person VARCHAR(50) NOT NULL COMMENT '被保人姓名',
+    premium INT COMMENT '保费(分)',
+    sum_insured INT COMMENT '保额(分)',
+    start_date DATE COMMENT '生效日期',
+    end_date DATE COMMENT '到期日期',
+    renewal_type VARCHAR(20) DEFAULT 'annual' COMMENT '续费类型: annual/monthly/single',
+    status VARCHAR(20) DEFAULT 'active' COMMENT '状态: active/expired/cancelled',
+    policy_no VARCHAR(100) COMMENT '保单号',
+    remark TEXT COMMENT '备注',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+    INDEX idx_user (user_id),
+    INDEX idx_child (child_id),
+    INDEX idx_status (status)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='保单管理表';
+
+-- =============================================
+-- 健康检测报告模块表
+-- =============================================
+
+-- 健康检测报告表
+CREATE TABLE IF NOT EXISTS health_reports (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    user_id BIGINT NOT NULL COMMENT '上传者用户ID(关联users表)',
+    subject_id BIGINT COMMENT '报告主体用户ID(关联users表,为null表示未绑定)',
+    family_id BIGINT COMMENT '家庭ID',
+    report_type VARCHAR(32) NOT NULL COMMENT '报告类型: physical_exam(体检)/gut_flora(菌群检测)',
+    report_date DATE COMMENT '报告日期',
+    overall_score INT COMMENT '健康总分(0-100)',
+    gut_health_score INT COMMENT '菌群健康分',
+    chronic_disease_score INT COMMENT '慢病控制分',
+    nutrition_score INT COMMENT '营养均衡分',
+    gut_age VARCHAR(32) COMMENT '肠道预测年龄',
+    gut_type VARCHAR(50) COMMENT '肠型',
+    file_url VARCHAR(500) COMMENT '报告文件URL',
+    status VARCHAR(20) DEFAULT 'active' COMMENT '状态: active/archived',
+    remark TEXT COMMENT '备注',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+    INDEX idx_user_id (user_id),
+    INDEX idx_subject_id (subject_id),
+    INDEX idx_family_id (family_id),
+    INDEX idx_report_type (report_type)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='健康检测报告表';
+
+-- 健康报告查看权限表
+CREATE TABLE IF NOT EXISTS health_report_permissions (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    report_id BIGINT NOT NULL COMMENT '报告ID',
+    user_id BIGINT NOT NULL COMMENT '有查看权限的用户ID',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    UNIQUE KEY uk_report_user (report_id, user_id),
+    INDEX idx_report_id (report_id),
+    INDEX idx_user_id (user_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='健康报告查看权限表';
+
+-- 健康指标明细表
+CREATE TABLE IF NOT EXISTS health_indicators (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    report_id BIGINT NOT NULL COMMENT '关联报告ID',
+    category VARCHAR(50) COMMENT '指标分类: 营养状况/疾病风险/肠道屏障/神经递质/...',
+    indicator_name VARCHAR(100) NOT NULL COMMENT '指标名称',
+    indicator_value VARCHAR(100) COMMENT '检测值',
+    unit VARCHAR(50) COMMENT '单位',
+    ref_range VARCHAR(200) COMMENT '参考范围',
+    status VARCHAR(50) COMMENT '评估状态: 正常/偏低/偏高/过多/注意/低风险/未检出',
+    sort_order INT DEFAULT 0 COMMENT '显示排序',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    INDEX idx_report_id (report_id),
+    INDEX idx_category (category)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='健康指标明细表';
+
+-- 健康报告上传草稿表(两阶段入库的中间态)
+CREATE TABLE IF NOT EXISTS health_report_drafts (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    user_id BIGINT NOT NULL COMMENT '上传人用户ID',
+    family_id BIGINT COMMENT '家庭ID',
+    report_type VARCHAR(32) NOT NULL COMMENT '报告类型: physical_exam/gut_flora',
+    file_url VARCHAR(500) COMMENT '上传的文件URL',
+    original_filename VARCHAR(255) COMMENT '原始文件名',
+    payload_json MEDIUMTEXT NOT NULL COMMENT '草稿载荷JSON(含解析/手动录入的所有指标)',
+    status VARCHAR(20) DEFAULT 'pending' COMMENT '状态: pending/confirmed/discarded',
+    expire_at DATETIME COMMENT '草稿过期时间',
+    confirmed_report_id BIGINT COMMENT 'confirm阶段入库后的健康报告ID',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+    INDEX idx_user_id (user_id),
+    INDEX idx_status_expire (status, expire_at)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='健康报告上传草稿表(两阶段入库中间态)';
+
+-- 教育体系配置表
+CREATE TABLE IF NOT EXISTS education_systems (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    name VARCHAR(32) NOT NULL UNIQUE COMMENT '编码(key)',
+    label VARCHAR(50) NOT NULL COMMENT '显示名称',
+    description TEXT COMMENT '描述说明',
+    sort_order INT DEFAULT 0 COMMENT '排序',
+    status VARCHAR(20) DEFAULT 'ACTIVE' COMMENT '状态: ACTIVE/DISABLED',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间'
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='教育体系配置表';
+
+INSERT INTO education_systems (name, label, description, sort_order) VALUES
+('high_school', '中专/高中', '中等教育学历', 1),
+('associate', '大专', '高等专科学历', 2),
+('bachelor', '本科', '大学本科学历', 3),
+('master', '硕士', '硕士研究生学历', 4),
+('doctor', '博士', '博士研究生学历', 5);
+
+-- ===== v1.2 先天属性体系 =====
+
+-- 家庭成员先天属性表
+CREATE TABLE IF NOT EXISTS family_member_attributes (
+    id               BIGINT AUTO_INCREMENT PRIMARY KEY,
+    member_id        BIGINT       NOT NULL COMMENT '家庭成员ID(children表或users表)',
+    member_type      VARCHAR(10)  NOT NULL COMMENT '成员类型: child/parent',
+    birth_datetime   DATETIME     COMMENT '出生日期(精确到分钟,用于八字排盘)',
+    eight_characters JSON         COMMENT '八字四柱JSON',
+    wuxing_elements  JSON         COMMENT '五行星盘元素JSON',
+    zodiac           VARCHAR(16)  COMMENT '生肖: rat/ox/tiger/rabbit/dragon/snake/horse/sheep/monkey/rooster/dog/pig',
+    blood_type       VARCHAR(5)   COMMENT '血型: A/B/AB/O',
+    mind_base_score  INT DEFAULT 0 COMMENT '心维度基础分(百分位)',
+    wisdom_base_score INT DEFAULT 0 COMMENT '智维度基础分(百分位)',
+    behavior_modifier JSON        COMMENT '行为修正因子JSON',
+    created_at       DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at       DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    UNIQUE KEY uk_member (member_id, member_type)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='家庭成员先天属性表';
+
+-- 星座配置表
+CREATE TABLE IF NOT EXISTS zodiac_config (
+    id               BIGINT AUTO_INCREMENT PRIMARY KEY,
+    zodiac_code      VARCHAR(20)  NOT NULL UNIQUE COMMENT '星座代码',
+    zodiac_name      VARCHAR(10)  NOT NULL COMMENT '星座名称',
+    element          VARCHAR(10)  NOT NULL COMMENT '五行: 金木水火土',
+    start_month      INT          NOT NULL COMMENT '起始月',
+    start_day        INT          NOT NULL COMMENT '起始日',
+    end_month        INT          NOT NULL COMMENT '结束月',
+    end_day          INT          NOT NULL COMMENT '结束日',
+    mind_base        INT DEFAULT 0 COMMENT '心先天基础分(百分位)',
+    wisdom_base      INT DEFAULT 0 COMMENT '智先天基础分(百分位)',
+    body_modifier    INT DEFAULT 0 COMMENT '身修正系数(千分比)',
+    action_modifier  INT DEFAULT 0 COMMENT '行修正系数(千分比)',
+    wealth_modifier  INT DEFAULT 0 COMMENT '富修正系数(千分比)',
+    created_at       DATETIME DEFAULT CURRENT_TIMESTAMP
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='星座配置表';
+
+-- 八字配置表
+CREATE TABLE IF NOT EXISTS bazi_config (
+    id               BIGINT AUTO_INCREMENT PRIMARY KEY,
+    stem_or_branch   VARCHAR(10)  NOT NULL COMMENT '天干或地支',
+    type             VARCHAR(10)  NOT NULL COMMENT '类型: stem/branch',
+    element          VARCHAR(10)  NOT NULL COMMENT '五行: 金木水火土',
+    yin_yang         VARCHAR(5)   COMMENT '阴阳: yin/yang',
+    mind_base        INT DEFAULT 0 COMMENT '心先天基础分(百分位)',
+    wisdom_base      INT DEFAULT 0 COMMENT '智先天基础分(百分位)',
+    body_modifier    INT DEFAULT 0 COMMENT '身修正系数(千分比)',
+    action_modifier  INT DEFAULT 0 COMMENT '行修正系数(千分比)',
+    wealth_modifier  INT DEFAULT 0 COMMENT '富修正系数(千分比)',
+    created_at       DATETIME DEFAULT CURRENT_TIMESTAMP
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='八字配置表(天干地支五行)';
+
+-- 血型配置表
+CREATE TABLE IF NOT EXISTS blood_type_config (
+    id               BIGINT AUTO_INCREMENT PRIMARY KEY,
+    blood_type       VARCHAR(5)   NOT NULL UNIQUE COMMENT '血型: A/B/AB/O',
+    description      TEXT COMMENT '性格描述',
+    mind_base        INT DEFAULT 0 COMMENT '心先天基础分(百分位)',
+    wisdom_base      INT DEFAULT 0 COMMENT '智先天基础分(百分位)',
+    body_modifier    INT DEFAULT 0 COMMENT '身修正系数(千分比)',
+    action_modifier  INT DEFAULT 0 COMMENT '行修正系数(千分比)',
+    wealth_modifier  INT DEFAULT 0 COMMENT '富修正系数(千分比)',
+    created_at       DATETIME DEFAULT CURRENT_TIMESTAMP
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='血型配置表';
+
+-- =============================================
+-- 活动报名 与 能量规则引擎表(v1.4)
+-- =============================================
+
+-- 活动报名表
+CREATE TABLE IF NOT EXISTS activity_registrations (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    activity_id BIGINT NOT NULL COMMENT '活动ID',
+    child_id BIGINT NOT NULL COMMENT '孩子ID',
+    user_id BIGINT NOT NULL COMMENT '报名人用户ID(家长)',
+    status VARCHAR(20) DEFAULT 'pending' COMMENT '状态: pending/approved/rejected/cancelled',
+    registered_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '报名时间',
+    approved_at DATETIME COMMENT '审核通过时间',
+    approved_by BIGINT COMMENT '审核人用户ID',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+    UNIQUE KEY uk_activity_child (activity_id, child_id),
+    INDEX idx_activity_id (activity_id),
+    INDEX idx_child_id (child_id),
+    INDEX idx_user_id (user_id),
+    INDEX idx_status (status)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='活动报名表';
+
+-- 能量规则表(规则引擎)
+CREATE TABLE IF NOT EXISTS energy_rule (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    rule_code VARCHAR(64) NOT NULL UNIQUE COMMENT '规则编码(唯一)',
+    rule_name VARCHAR(200) NOT NULL COMMENT '规则名称',
+    event_type VARCHAR(32) NOT NULL COMMENT '事件类型: checkin/register/complete/cancel/overdue',
+    action VARCHAR(16) NOT NULL COMMENT '动作: increase/decrease',
+    dimension_code VARCHAR(20) COMMENT '维度代码: body/mind/wisdom/action/wealth(NULL=五维均衡)',
+    amount INT COMMENT '固定变动量(基点)',
+    amount_formula VARCHAR(255) COMMENT '动态公式(如: balance*0.1)',
+    priority INT DEFAULT 0 COMMENT '优先级(数字越大越优先匹配)',
+    conditions JSON COMMENT '触发条件(JSON表达式)',
+    status TINYINT DEFAULT 1 COMMENT '状态: 1=启用 0=禁用',
+    description TEXT COMMENT '规则描述',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+    INDEX idx_event_type (event_type),
+    INDEX idx_status (status),
+    INDEX idx_priority (priority)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='能量规则表(规则引擎)';
+
+CREATE TABLE IF NOT EXISTS activities (
+    id               BIGINT AUTO_INCREMENT PRIMARY KEY,
+    title            VARCHAR(100) NOT NULL COMMENT '活动标题',
+    description      TEXT COMMENT '活动描述',
+    cover_image      VARCHAR(500) COMMENT '封面图片URL',
+    dimension_code   VARCHAR(20) COMMENT '维度代码: body/mind/wisdom/action/wealth',
+    activity_type    VARCHAR(20) DEFAULT 'offline' COMMENT '活动类型: offline/online/campaign',
+    status           VARCHAR(20) DEFAULT 'draft' COMMENT '状态: draft/published/ended',
+    start_time       DATETIME COMMENT '开始时间',
+    end_time         DATETIME COMMENT '结束时间',
+    location         VARCHAR(200) COMMENT '活动地点',
+    max_participants INT DEFAULT 0 COMMENT '最大参与人数',
+    current_participants INT DEFAULT 0 COMMENT '当前参与人数',
     price INT DEFAULT 0 COMMENT '活动价格(分)',
-    vendor_id        BIGINT COMMENT '服务商ID',
-    vendor_name      VARCHAR(100) COMMENT '服务商名称',
-    created_at       DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at       DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    INDEX idx_dimension (dimension_code),
-    INDEX idx_status (status),
-    INDEX idx_start_time (start_time)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='活动表';
-
--- v1.x: 活动工作流状态扩展
-ALTER TABLE activities
-  MODIFY COLUMN status VARCHAR(20) DEFAULT 'draft'
-    COMMENT '状态:draft(草稿)/pending(待审核)/rejected(已驳回)/published(发布中)/withdrawn(已撤回)',
-  ADD COLUMN audit_status VARCHAR(20) DEFAULT NULL
-    COMMENT '审核状态:approved/pending/rejected',
-  ADD COLUMN audit_reason TEXT DEFAULT NULL
-    COMMENT '驳回原因',
-  ADD COLUMN auditor_id BIGINT DEFAULT NULL
-    COMMENT '审核人 ID',
-  ADD COLUMN audited_at DATETIME DEFAULT NULL
-    COMMENT '审核时间';
-
--- ===== v1.3 家庭成员体系 =====
-
--- 手动添加的家庭成员表(替代children表用于新成员)
-CREATE TABLE IF NOT EXISTS family_members (
-    id               BIGINT AUTO_INCREMENT PRIMARY KEY,
-    family_id        BIGINT       NOT NULL COMMENT '所属家庭ID',
-    user_id          BIGINT       COMMENT '关联的用户ID(手机号匹配到已有用户时)',
-    nickname         VARCHAR(100) NOT NULL COMMENT '昵称',
-    phone            VARCHAR(20)  COMMENT '手机号',
-    avatar           VARCHAR(500) COMMENT '头像',
-    gender           VARCHAR(10)  COMMENT '性别: male/female',
-    birthday         DATE         COMMENT '出生日期',
-    relationship_type VARCHAR(50) NOT NULL COMMENT '关系类型key',
-    role_override VARCHAR(20) DEFAULT 'auto' COMMENT '角色覆盖: auto/parent/child/elderly,空=auto',
-    show_to_family INT DEFAULT 1 COMMENT '对家庭成员可见: 1=可见, 0=不可见',
-    total_points INT DEFAULT 0 COMMENT '总积分',
-    -- 孩子专属字段(原children表合并)
-    id_card VARCHAR(18) DEFAULT NULL COMMENT '身份证号(孩子)',
-    penalty_enabled TINYINT DEFAULT 1 COMMENT '是否扣减积分(0否1是)',
-    theme VARCHAR(32) DEFAULT 'default' COMMENT '主题',
-    system_points INT DEFAULT 0 COMMENT '系统积分(干预/平台奖励)',
-    streak_days INT DEFAULT 0 COMMENT '连续打卡天数',
-    last_task_date DATE COMMENT '上次任务日期',
-    focus_max_daily TINYINT DEFAULT 3 COMMENT '每日专注上限',
-    focus_remaining TINYINT DEFAULT 3 COMMENT '今日剩余专注次数',
-    focus_reset_date DATE COMMENT '专注次数重置日期',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    INDEX idx_family_id (family_id),
-    INDEX idx_phone (phone)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='家庭成员表(手动添加)';
-
--- 家庭成员双向关系表(v2: 替代relationship_type/role_override)
-CREATE TABLE IF NOT EXISTS family_relationships (
-    id               BIGINT AUTO_INCREMENT PRIMARY KEY,
-    family_id        BIGINT       NOT NULL COMMENT '所属家庭ID',
-    from_member_id   BIGINT       NOT NULL COMMENT '关系起点成员ID',
-    to_member_id     BIGINT       NOT NULL COMMENT '关系终点成员ID',
-    generation_value INT          NOT NULL COMMENT '辈分值: -1=子女, 0=同辈, 1=父母, 2=祖父母, 3=曾祖父母',
-    relationship_key VARCHAR(50)  COMMENT '关系标签key(冗余用于显示, 如father/mother/son/daughter/spouse/sibling)',
-    created_at       DATETIME     DEFAULT CURRENT_TIMESTAMP,
-    updated_at       DATETIME     DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    UNIQUE KEY uk_from_to (from_member_id, to_member_id),
-    INDEX idx_family_id (family_id),
-    INDEX idx_from (from_member_id),
-    INDEX idx_to (to_member_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='家庭成员双向关系表';
-
--- 关系类型配置表(管理端可配置)
-CREATE TABLE IF NOT EXISTS relationship_types (
-    id               BIGINT AUTO_INCREMENT PRIMARY KEY,
-    type_key         VARCHAR(50)  NOT NULL UNIQUE COMMENT '类型标识: spouse/parent/child/sibling',
-    type_name        VARCHAR(100) NOT NULL COMMENT '类型显示名: 配偶/父母/子女/兄弟姐妹',
-    capability_role  VARCHAR(20)  NOT NULL DEFAULT 'parent' COMMENT '能力角色: parent/child',
-    default_role     VARCHAR(20)  DEFAULT NULL COMMENT '默认角色模板: parent/child(已废弃, 兼容保留)',
-    sort_order       INT DEFAULT 0 COMMENT '排序序号',
-    enabled          INT DEFAULT 1 COMMENT '是否启用: 1=启用, 0=禁用',
-    created_at       DATETIME DEFAULT CURRENT_TIMESTAMP
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='关系类型配置表';
-
--- 默认关系类型数据(default_role: parent/child 为该关系类型的默认角色模板)
-INSERT IGNORE INTO relationship_types (type_key, type_name, default_role, sort_order, enabled) VALUES
-('spouse', '配偶', 'parent', 1, 1),
-('parent', '父母', 'parent', 2, 1),
-('child', '子女', 'child', 3, 1),
-('sibling', '兄弟姐妹', 'child', 4, 1);
-
--- 用户收货地址表
-CREATE TABLE IF NOT EXISTS user_address (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    user_id BIGINT NOT NULL COMMENT '用户ID',
-    receiver_name VARCHAR(50) NOT NULL COMMENT '收货人姓名',
-    phone VARCHAR(20) NOT NULL COMMENT '收货人电话',
-    province VARCHAR(50) COMMENT '省',
-    city VARCHAR(50) COMMENT '市',
-    district VARCHAR(50) COMMENT '区',
-    street VARCHAR(200) COMMENT '详细地址',
-    is_default TINYINT DEFAULT 0 COMMENT '是否默认地址 1=是 0=否',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    INDEX idx_user_id (user_id),
-    INDEX idx_is_default (is_default)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='用户收货地址表';
-
--- =============================================
--- 新手引导奖励表
--- =============================================
-
-CREATE TABLE IF NOT EXISTS onboarding_task (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    user_id BIGINT NOT NULL,
-    task_type VARCHAR(32) NOT NULL,
-    reward_points INT DEFAULT 0,
-    reward_energy INT DEFAULT 0,
-    status VARCHAR(16) DEFAULT 'PENDING',
-    completed_at DATETIME,
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    INDEX idx_user_id (user_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-
--- =============================================
--- 成长任务配置表
--- =============================================
-
-CREATE TABLE IF NOT EXISTS growth_task (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    type VARCHAR(16) NOT NULL COMMENT 'DAILY/NEWBIE',
-    title VARCHAR(100) NOT NULL,
-    description TEXT,
-    reward_points INT DEFAULT 0,
-    reward_energy INT DEFAULT 0,
-    target_value INT DEFAULT 1,
-    task_key VARCHAR(32) UNIQUE NOT NULL,
-    enabled TINYINT DEFAULT 1,
-    sort_order INT DEFAULT 0,
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    INDEX idx_type (type)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='成长任务配置表';
-
-CREATE TABLE IF NOT EXISTS growth_task_log (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    user_id BIGINT NOT NULL,
-    task_id BIGINT NOT NULL,
-    progress INT DEFAULT 0,
-    completed TINYINT DEFAULT 0,
-    claimed TINYINT DEFAULT 0,
-    date VARCHAR(10) COMMENT 'YYYY-MM-DD for daily, empty for newbie',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    INDEX idx_user_date (user_id, date),
-    INDEX idx_task_id (task_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='成长任务用户进度表';
-
--- =============================================
--- 优惠券配置表
--- =============================================
-
-CREATE TABLE IF NOT EXISTS coupon (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    name VARCHAR(64) NOT NULL,
-    type VARCHAR(16) DEFAULT 'FIXED',
-    value INT DEFAULT 0 COMMENT '金额 单位:分',
-    min_spend INT DEFAULT 0 COMMENT '最低消费 单位:分',
-    applicable_to VARCHAR(32) DEFAULT 'ALL',
-    valid_from DATETIME,
-    valid_until DATETIME,
-    total_count INT DEFAULT 0,
-    used_count INT DEFAULT 0,
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    INDEX idx_valid_period (valid_from, valid_until)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='优惠券配置表';
-
-CREATE TABLE IF NOT EXISTS user_coupon (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    user_id BIGINT NOT NULL,
-    coupon_id BIGINT NOT NULL,
-    status VARCHAR(16) DEFAULT 'AVAILABLE',
-    received_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    used_at DATETIME,
-    order_id BIGINT,
-    INDEX idx_user_coupon (user_id, coupon_id),
-    INDEX idx_status (status),
-    INDEX idx_order_id (order_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='用户优惠券表';
-
--- =============================================
--- 邀请里程碑表
--- =============================================
-
-CREATE TABLE IF NOT EXISTS invite_milestone (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    user_id BIGINT NOT NULL,
-    milestone VARCHAR(32) NOT NULL,
-    reward_points INT DEFAULT 0,
-    reward_energy INT DEFAULT 0,
-    status VARCHAR(16) DEFAULT 'PENDING',
-    achieved_at DATETIME,
-    claimed_at DATETIME,
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    INDEX idx_user_milestone (user_id, milestone)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='邀请里程碑表';
-
--- =============================================
--- 推广排行榜周记录表
--- =============================================
-
-CREATE TABLE IF NOT EXISTS referral_leaderboard (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    user_id BIGINT NOT NULL,
-    week_start VARCHAR(10) NOT NULL COMMENT '周一日期 YYYY-MM-DD',
-    referral_count INT DEFAULT 0,
-    `rank` INT,
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    UNIQUE INDEX idx_user_week (user_id, week_start),
-    INDEX idx_week_rank (week_start, referral_count DESC)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='推广排行榜周记录';
-
--- =============================================
--- 虚拟服务商团队(销售体系)
--- =============================================
-
-CREATE TABLE IF NOT EXISTS `distribution_systems` (
-    `id` BIGINT AUTO_INCREMENT PRIMARY KEY,
-    `name` VARCHAR(100) NOT NULL COMMENT '团队名称',
-    `description` TEXT COMMENT '团队描述',
-    `owner_id` BIGINT COMMENT '创建人(服务商用户ID)',
-    `profit_rate` INT DEFAULT 0 COMMENT '利润分成比例(bps, 如2000=20%)',
-    `enabled` TINYINT(1) DEFAULT 1 COMMENT '是否启用',
-    `created_at` DATETIME DEFAULT CURRENT_TIMESTAMP,
-    `updated_at` DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='虚拟服务商团队(销售体系)';
-
-CREATE TABLE IF NOT EXISTS `distribution_relations` (
-    `id` BIGINT AUTO_INCREMENT PRIMARY KEY,
-    `system_id` BIGINT NOT NULL COMMENT '所属团队ID',
-    `user_id` BIGINT NOT NULL COMMENT '服务商用户ID',
-    `parent_id` BIGINT COMMENT '上级服务商用户ID',
-    `depth` INT DEFAULT 0 COMMENT '层级深度(0=root)',
-    `created_at` DATETIME DEFAULT CURRENT_TIMESTAMP,
-    INDEX idx_system (system_id),
-    INDEX idx_user (user_id),
-    INDEX idx_parent (parent_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='团队-服务商关系(同一人在不同团队可处于不同位置)';
-
--- =============================================
--- 成长任务种子数据
--- =============================================
-
-INSERT IGNORE INTO growth_task (type, title, description, reward_points, reward_energy, target_value, task_key, sort_order) VALUES
-('DAILY', '每日签到', '完成每日签到', 20, 3, 1, 'DAILY_CHECKIN', 1),
-('DAILY', '完成任务', '完成一个任务', 30, 5, 1, 'DAILY_TASK', 2),
-('DAILY', '分享文章', '分享一篇好文给好友', 10, 2, 1, 'DAILY_SHARE', 3),
-('DAILY', 'AI对话', '与AI助手进行一次对话', 15, 3, 1, 'DAILY_AI', 4);
-
--- ========== 全域指标定义表 ==========
--- ===== v1.5 家庭文化镜:关系兼容性配置 =====
-
--- 生肖配对规则表
-CREATE TABLE IF NOT EXISTS zodiac_pairing (
-    id               BIGINT AUTO_INCREMENT PRIMARY KEY,
-    zodiac_code_1    VARCHAR(20) NOT NULL COMMENT '生肖代码1',
-    zodiac_code_2    VARCHAR(20) NOT NULL COMMENT '生肖代码2',
-    pairing_type     VARCHAR(20) NOT NULL COMMENT '配对类型: liuhe/sanhe/banhe/liuchong/xianghai/xiangxing/ping',
-    compatibility_score INT DEFAULT 50 COMMENT '兼容分 0-100',
-    description      TEXT COMMENT '配对解读',
-    advice           TEXT COMMENT '相处建议',
-    created_at       DATETIME DEFAULT CURRENT_TIMESTAMP,
-    UNIQUE KEY uk_zodiac_pair (zodiac_code_1, zodiac_code_2)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='生肖配对规则表';
-
--- 十二生肖六合/三合/六冲种子数据
-INSERT IGNORE INTO zodiac_pairing (zodiac_code_1, zodiac_code_2, pairing_type, compatibility_score, description, advice) VALUES
-('rat', 'ox', 'liuhe', 100, '子丑六合,天生一对', '你们是最佳拍档,互相补充,默契十足'),
-('rat', 'monkey', 'sanhe', 85, '申子半合水局,默契度高', '智慧结合,创意无限,适合一起做规划'),
-('rat', 'dragon', 'sanhe', 85, '子辰半合水局,相辅相成', '一个机灵一个大气,共同成就大事'),
-('rat', 'horse', 'liuchong', 20, '子午相冲,水火不容', '价值观差异大,需要多包容理解'),
-('rat', 'tiger', 'xiangxing', 30, '寅子相刑,容易误会', '沟通方式不同,建议用行动代替言语'),
-('rat', 'rabbit', 'xiangxing', 30, '卯子相刑,互不相让', '各执己见时先冷静再沟通'),
-('rat', 'sheep', 'xianghai', 35, '子未相害,暗中较劲', '表面和谐但内心可能有竞争意识'),
-('ox', 'tiger', 'ping', 55, '牛虎平平,互敬互重', '踏实遇上冒险,可以互相学习'),
-('ox', 'rabbit', 'xianghai', 35, '丑卯相害,各怀心思', '建议开诚布公,减少猜测'),
-('ox', 'dragon', 'ping', 55, '牛龙平平,求同存异', '务实和理想主义的碰撞'),
-('ox', 'snake', 'sanhe', 85, '巳酉丑三合金局,配合默契', '务实加智慧,黄金搭档'),
-('ox', 'horse', 'xianghai', 35, '丑午相害,相处需技巧', '步调不同,需要彼此迁就'),
-('ox', 'sheep', 'liuchong', 20, '丑未相冲,针锋相对', '一个固执一个犟,需要第三方调和'),
-('tiger', 'rabbit', 'ping', 55, '虎兔平平,各有所长', '虎的魄力配兔的细腻,互补型'),
-('tiger', 'dragon', 'ping', 55, '虎龙平平,互相欣赏', '都有王者风范,但要注意谁说了算'),
-('tiger', 'snake', 'xianghai', 35, '寅巳相害,互相防备', '一个直率一个深沉,需要更多信任'),
-('tiger', 'horse', 'sanhe', 85, '寅午半合火局,一拍即合', '热情似火,志同道合的行动派'),
-('tiger', 'sheep', 'ping', 55, '虎羊平平,温柔与力量', '虎保护羊,羊温暖虎'),
-('tiger', 'monkey', 'liuchong', 20, '寅申相冲,竞争关系', '针尖对麦芒,需要在竞争中找合作'),
-('tiger', 'pig', 'liuhe', 100, '寅亥六合,情投意合', '虎猪相合,真诚相待的最佳组合'),
-('rabbit', 'dragon', 'xianghai', 35, '卯辰相害,表面和谐', '温和遇到强势,需要找到平衡'),
-('rabbit', 'snake', 'ping', 55, '兔蛇平平,温和相处', '都是内敛型,适合安静的陪伴'),
-('rabbit', 'horse', 'ping', 55, '兔马平平,一动一静', '一个爱静一个爱动,互相调剂'),
-('rabbit', 'sheep', 'sanhe', 85, '卯未半合木局,志趣相投', '文艺组合,品味相投'),
-('rabbit', 'monkey', 'xiangxing', 30, '卯申相刑,互不买账', '思维方式差异大,需要耐心'),
-('rabbit', 'rooster', 'liuchong', 20, '卯酉相冲,水火难容', '生活节奏完全不同,需要大包容'),
-('rabbit', 'dog', 'liuhe', 100, '卯戌六合,忠诚相伴', '兔狗相合,彼此忠诚的最佳关系'),
-('dragon', 'snake', 'ping', 55, '龙蛇平平,同源相惜', '都有神秘气质,惺惺相惜'),
-('dragon', 'horse', 'ping', 55, '龙马平平,各有天地', '一个在天一个在地,互不干涉'),
-('dragon', 'sheep', 'xiangxing', 30, '辰未相刑,暗中别扭', '看似无事却有暗流,多交流可化解'),
-('dragon', 'monkey', 'sanhe', 85, '申子辰三合水局,天生队友', '最佳事业组合,互相成就'),
-('dragon', 'rooster', 'liuhe', 100, '辰酉六合,珠联璧合', '龙凤配,传统的最佳搭档'),
-('dragon', 'dog', 'liuchong', 20, '辰戌相冲,正面冲突', '硬碰硬的关系,需要智慧化解'),
-('snake', 'horse', 'xiangxing', 30, '巳午相刑,热度不同', '蛇冷静马热情,温度要调和'),
-('snake', 'sheep', 'sanhe', 85, '巳酉丑三合金局,智慧搭档', '沉稳加温柔,互相信任的深层关系'),
-('snake', 'monkey', 'liuhe', 100, '巳申六合,智谋相投', '聪明人之间的默契'),
-('snake', 'rooster', 'sanhe', 85, '巳酉丑三合金局,配合无间', '细节控和完美主义者的理想组合'),
-('snake', 'pig', 'liuchong', 20, '巳亥相冲,南辕北辙', '一个深沉一个随性,需要大幅磨合'),
-('horse', 'sheep', 'liuhe', 100, '午未六合,温情相依', '马羊相合,温暖体贴的最佳关系'),
-('horse', 'monkey', 'xiangxing', 30, '午申相刑,互不理解', '行动派和思考派的碰撞'),
-('horse', 'rooster', 'xiangxing', 30, '午酉相刑,意气用事', '都容易冲动,需要一个冷静者调和'),
-('horse', 'dog', 'sanhe', 85, '寅午戌三合火局,行动搭档', '热情忠诚组合,一起行动效率高'),
-('horse', 'pig', 'liuhe', 100, '亥午暗合,心有灵犀', '一静一动却暗合,出人意料的默契'),
-('sheep', 'monkey', 'xiangxing', 30, '未申相刑,互挑毛病', '容易在小事上相互挑剔'),
-('sheep', 'rooster', 'ping', 55, '羊鸡平平,互相欣赏', '羊的细腻欣赏鸡的精致'),
-('sheep', 'dog', 'xiangxing', 30, '未戌相刑,各怀心事', '需要建立更深层的信任'),
-('sheep', 'pig', 'sanhe', 85, '亥卯未三合木局,温柔组合', '温和的三合组,舒适无压力的关系'),
-('monkey', 'rooster', 'ping', 55, '猴鸡平平,互相启发', '聪明人的相遇,火花四射'),
-('monkey', 'dog', 'xiangxing', 30, '申戌相刑,互不信任', '需要时间证明真心'),
-('monkey', 'pig', 'liuhe', 100, '申亥六合,智勇双全', '猴子机智猪包容,最佳朋友组合'),
-('rooster', 'dog', 'xiangxing', 30, '酉戌相刑,互相挑剔', '完美主义遇见忠诚卫士,互相看不惯'),
-('rooster', 'pig', 'ping', 55, '鸡猪平平,各取所需', '鸡的精明和猪的豁达互相补充'),
-('dog', 'pig', 'sanhe', 85, '寅午戌三合火局,忠诚相伴', '忠诚的守护组合,互相支持');
-
--- 血型配对表
-CREATE TABLE IF NOT EXISTS blood_type_pairing (
-    id               BIGINT AUTO_INCREMENT PRIMARY KEY,
-    blood_type_1     VARCHAR(5) NOT NULL COMMENT '血型1',
-    blood_type_2     VARCHAR(5) NOT NULL COMMENT '血型2',
-    compatibility_score INT DEFAULT 50 COMMENT '兼容分 0-100',
-    description      TEXT COMMENT '配对描述',
-    advice           TEXT COMMENT '相处建议',
-    created_at       DATETIME DEFAULT CURRENT_TIMESTAMP,
-    UNIQUE KEY uk_blood_pair (blood_type_1, blood_type_2)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='血型配对表';
-
-INSERT IGNORE INTO blood_type_pairing (blood_type_1, blood_type_2, compatibility_score, description, advice) VALUES
-('A', 'A', 80, '同型相吸,稳重默契', '都能理解对方的细腻敏感,但注意不要一起钻牛角尖'),
-('A', 'B', 50, '互补型,有吸引力也有摩擦', 'B型的自由奔放吸引A型,但A型的严谨可能让B型感到压力'),
-('A', 'O', 75, 'A主内O主外,搭配和谐', 'O型的大气包容A型的细致,是最常见的和谐组合'),
-('A', 'AB', 70, 'AB型善解人意,A型感到被理解', 'AB型的理性刚好平衡A型的感性'),
-('B', 'B', 75, '同型相投,自由自在', '都给彼此空间,但可能缺乏规划'),
-('B', 'O', 70, 'O型包容B型,相处轻松', 'O型的稳定给了B型安全感'),
-('B', 'AB', 65, '互相欣赏,各有天地', 'B型的创意和AB型的分析能力互补'),
-('O', 'O', 85, '强强联合,行动力爆棚', '都是行动派,但要注意不要都太强势'),
-('O', 'AB', 75, 'O型领导,AB型军师', 'O型的大方向加AB型的精细思维,无敌组合'),
-('AB', 'AB', 60, '互相理解但可能过度理性', '两个理性派,别忘了情感交流');
-
--- 生命灵数关系解读表
-CREATE TABLE IF NOT EXISTS life_number_relationship (
-    id               BIGINT AUTO_INCREMENT PRIMARY KEY,
-    relationship_number INT NOT NULL COMMENT '关系数字 1-9',
-    title            VARCHAR(100) COMMENT '关系主题',
-    description      TEXT COMMENT '关系解读',
-    advice           TEXT COMMENT '相处建议',
-    color_hex        VARCHAR(10) COMMENT '代表色',
-    created_at       DATETIME DEFAULT CURRENT_TIMESTAMP,
-    UNIQUE KEY uk_relationship_num (relationship_number)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='生命灵数关系解读表';
-
-INSERT IGNORE INTO life_number_relationship (relationship_number, title, description, advice, color_hex) VALUES
-(1, '开创者关系', '你们在一起充满创造力和领导力,彼此激励去实现目标', '注意不要互相竞争谁说了算,明确分工才能发挥最大能量', '#FF4444'),
-(2, '合作伙伴关系', '你们是天生的搭档,善于倾听和配合,营造和谐氛围', '过于迁就对方可能会失去自我,保持适度独立才能长久', '#FF8C42'),
-(3, '创意火花关系', '在一起充满欢乐和创造力,社交圈会因为你们而扩大', '注意不要太表面化,偶尔需要深度的对话来维系情感', '#FFD700'),
-(4, '建设者关系', '你们是务实稳健的组合,能一起把想法变成现实', '生活不能只有工作和责任,记得给彼此创造惊喜和浪漫', '#10B981'),
-(5, '探险者关系', '在一起充满变化和新鲜感,喜欢一起探索未知', '变化太多可能会让关系缺乏安全感,寻找一些共同的固定仪式', '#3B82F6'),
-(6, '守护者关系', '你们的关系以关爱和责任为基础,彼此是最坚实的后盾', '付出太多可能会感到疲惫,学会接受对方的爱和照顾', '#6366F1'),
-(7, '智者关系', '在一起有深度的精神交流和思想碰撞,追求真理', '不要沉浸在各自的世界里,记得用简单的方式表达爱', '#8B5CF6'),
-(8, '成就者关系', '你们是强强联合,追求物质和事业上的共同成就', '在追求成功的同时不要忽视感情的温度,平衡事业和生活', '#F59E0B'),
-(9, '圆满者关系', '在一起有强烈的宿命感,彼此理解和支持,是灵魂伴侣', '太理想化可能会失望,接受对方的不完美才能走得更远', '#FF6B9D');
-
-CREATE TABLE IF NOT EXISTS indicator_definitions (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    domain VARCHAR(50) NOT NULL COMMENT '领域: physical/mental/nutrition/behavior/social',
-    category VARCHAR(50) NOT NULL COMMENT '分类: 舌色/苔色/情绪/...',
-    code VARCHAR(50) NOT NULL UNIQUE COMMENT '编码: tongue_color/coating_color/...',
-    name VARCHAR(100) NOT NULL COMMENT '显示名: 舌体颜色/苔色/...',
-    data_type VARCHAR(20) NOT NULL DEFAULT 'enum' COMMENT '数据类型: enum/number/string',
-    options JSON COMMENT '枚举值列表: ["淡红","红","绛","青紫"] 或 null',
-    unit VARCHAR(50) COMMENT '单位',
-    ref_range VARCHAR(200) COMMENT '参考范围',
-    sort_order INT DEFAULT 0 COMMENT '排序',
-    status TINYINT DEFAULT 1 COMMENT '0=禁用 1=启用',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='全域指标定义';
-
--- ========== 全域指标值表 ==========
-CREATE TABLE IF NOT EXISTS indicator_values (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    source_type VARCHAR(50) NOT NULL COMMENT '来源: tongue_record/health_report/assessment',
-    source_id BIGINT NOT NULL COMMENT '来源记录ID',
-    definition_id BIGINT NOT NULL COMMENT 'FK→indicator_definitions.id',
-    value VARCHAR(200) COMMENT '值',
-    numeric_value DECIMAL(10,2) COMMENT '数值(number类型时用)',
-    remark TEXT COMMENT '备注',
-    recorded_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    INDEX idx_source (source_type, source_id),
-    INDEX idx_definition (definition_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='全域指标值';
-
--- ========== 舌诊主记录表 ==========
-CREATE TABLE IF NOT EXISTS tongue_records (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    member_id BIGINT NOT NULL COMMENT '家庭成员ID',
-    child_id BIGINT COMMENT '孩子ID',
-    image_url VARCHAR(500) COMMENT '舌象图片URL',
-    overall_assessment TEXT COMMENT '总体评估',
-    status VARCHAR(20) DEFAULT 'draft' COMMENT 'draft/confirmed',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    INDEX idx_member (member_id, child_id),
-    INDEX idx_status (status)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='舌诊主记录';
-
--- ========== 种子数据:舌诊7项指标定义 ==========
-INSERT IGNORE INTO indicator_definitions (domain, category, code, name, data_type, options, sort_order, status) VALUES
-('physical', '舌色', 'tongue_color', '舌体颜色', 'enum', '["淡红","红","绛","青紫"]', 1, 1),
-('physical', '苔色', 'coating_color', '苔色', 'enum', '["薄白","白","黄","灰黑"]', 2, 1),
-('physical', '苔质', 'coating_texture', '苔质', 'enum', '["润","燥","滑","涩","腻"]', 3, 1),
-('physical', '裂纹', 'fissure', '裂纹程度', 'enum', '["无","轻","中","重"]', 4, 1),
-('physical', '齿痕', 'teeth_mark', '齿痕程度', 'enum', '["无","轻","中","重"]', 5, 1),
-('physical', '舌下络脉', 'sublingual_vein', '舌下络脉', 'enum', '["正常","轻","中","重"]', 6, 1),
-('physical', '体质', 'constitution', '体质辨识', 'enum', '["平和质","气虚质","阳虚质","阴虚质","湿热质","痰湿质","血瘀质","气郁质","特禀质"]', 7, 1);
-
--- =============================================
--- 活动报名 & 能量规则引擎 v1.4 - 字段扩展
--- 通过 DatabaseInitializer.java 在 ALTER 阶段执行
--- =============================================
-
--- 活动表扩展字段
-ALTER TABLE activities ADD COLUMN require_registration TINYINT DEFAULT 1 COMMENT '是否需要报名: 1=需要, 0=直接参与';
-ALTER TABLE activities ADD COLUMN require_checkin_review TINYINT DEFAULT 1 COMMENT '打卡是否需要审核: 1=需要, 0=直接通过';
-ALTER TABLE activities ADD COLUMN energy_penalty_unregistered INT DEFAULT 5 COMMENT '未报名打卡的行能量扣减值';
-
--- ============================================================
--- 新增:系统配置表(角色年龄阈值等)
--- ============================================================
-CREATE TABLE IF NOT EXISTS system_config (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    config_key VARCHAR(100) NOT NULL UNIQUE COMMENT '配置键',
-    config_value TEXT COMMENT '配置值',
-    description TEXT COMMENT '说明',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='系统配置表';
-
--- ============================================================
--- 数据迁移: children → family_members + roleOverride 变更
--- 执行时机: Phase 9(所有代码变更完成后、上线前)
--- ============================================================
-
--- 1. family_members.capability_role → role_override (已在 DDL 中 ALTER)
--- 2. relationship_types.capability_role → default_role (已在 DDL 中 ALTER)
-
--- ============================================================
--- 数据迁移: children → family_members + roleOverride 变更
--- 执行时机: Phase 9(所有代码变更完成后、上线前)
--- ============================================================
-
--- 1. family_members 已包含所有必要字段(role_override, 孩子专属字段已在 DDL 中)
--- relationship_types.capability_role → default_role 已在 DDL 中 ALTER
-
--- 2. 迁移 children 数据到 family_members(匹配更新:family_members 已存在该成员记录时更新)
-UPDATE family_members fm
-INNER JOIN children c ON fm.family_id = c.family_id AND fm.nickname = c.nickname AND fm.user_id = c.user_id
-SET
-    fm.id_card = c.id_card,
-    fm.penalty_enabled = c.penalty_enabled,
-    fm.theme = c.theme,
-    fm.system_points = c.system_points,
-    fm.streak_days = c.streak_days,
-    fm.last_task_date = c.last_task_date,
-    fm.focus_max_daily = c.focus_max_daily,
-    fm.focus_remaining = c.focus_remaining,
-    fm.focus_reset_date = c.focus_reset_date,
-    fm.total_points = c.total_points,
-    fm.show_to_family = c.show_to_family,
-    fm.birthday = c.birthday,
-    fm.gender = c.gender,
-    fm.phone = c.phone,
-    fm.role_override = 'child';
-
--- 3. 迁移 children 数据到 family_members(不匹配则插入新记录)
-INSERT INTO family_members (family_id, user_id, nickname, birthday, gender, phone,
-  id_card, penalty_enabled, theme, system_points, streak_days, last_task_date,
-  focus_max_daily, focus_remaining, focus_reset_date, show_to_family, total_points,
-  role_override, created_at, updated_at)
-SELECT family_id, user_id, nickname, birthday, gender, phone,
-  id_card, penalty_enabled, theme, system_points, streak_days, last_task_date,
-  focus_max_daily, focus_remaining, focus_reset_date, show_to_family, total_points,
-  'child', created_at, updated_at
-FROM children
-WHERE NOT EXISTS (
-    SELECT 1 FROM family_members fm2
-    WHERE fm2.family_id = children.family_id
-      AND fm2.nickname = children.nickname
-      AND fm2.user_id = children.user_id
-);
-
--- 4. 插入 system_config 初始数据
-INSERT INTO system_config (config_key, config_value, description) VALUES
-  ('child_age_threshold', '18', '未成年年龄分界线(岁)'),
-  ('elderly_age_threshold', '65', '老年年龄分界线(岁)')
-ON DUPLICATE KEY UPDATE config_value = VALUES(config_value);
-
--- 5. 删除 children 表(最后执行,确认迁移完成后再执行此步)
--- DROP TABLE IF EXISTS children;
-
--- ============================================================
--- 购物车表
--- ============================================================
-CREATE TABLE IF NOT EXISTS cart (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    user_id BIGINT NOT NULL COMMENT '用户ID',
-    product_id BIGINT NOT NULL COMMENT '商品ID',
-    quantity INT NOT NULL DEFAULT 1 COMMENT '数量',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    INDEX idx_user_product (user_id, product_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='购物车';
-
--- ============================================================
--- 供应商销售体系
--- ============================================================
-
-CREATE TABLE IF NOT EXISTS supply_system (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    name VARCHAR(100) NOT NULL COMMENT '体系名称',
-    admin_id BIGINT NOT NULL COMMENT '管理员用户ID',
-    settlement_period_days INT NOT NULL DEFAULT 30 COMMENT '账期(天)',
-    platform_profit_rate DECIMAL(5,2) NOT NULL DEFAULT 0 COMMENT '平台留利比例(%)',
-    description TEXT COMMENT '描述',
-    status VARCHAR(20) NOT NULL DEFAULT 'active' COMMENT '状态: active/disabled',
-    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    KEY idx_admin_id (admin_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='供应商体系';
-
-CREATE TABLE IF NOT EXISTS supply_system_member (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    system_id BIGINT NOT NULL COMMENT '体系ID',
-    user_id BIGINT NOT NULL COMMENT '用户ID',
-    role VARCHAR(20) NOT NULL DEFAULT 'member' COMMENT '角色: admin/member',
-    status VARCHAR(20) NOT NULL DEFAULT 'active' COMMENT '状态: active/inactive',
-    joined_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    UNIQUE KEY uk_system_user (system_id, user_id),
-    KEY idx_user_id (user_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='体系成员';
-
-CREATE TABLE IF NOT EXISTS supply_settlement (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    system_id BIGINT NOT NULL COMMENT '体系ID',
-    period_start DATE NOT NULL COMMENT '结算周期开始',
-    period_end DATE NOT NULL COMMENT '结算周期结束',
-    total_sales INT NOT NULL DEFAULT 0 COMMENT '销售总额(分)',
-    platform_profit INT NOT NULL DEFAULT 0 COMMENT '平台留利金额(分)',
-    supplier_payout INT NOT NULL DEFAULT 0 COMMENT '供应商实付(分)',
-    status VARCHAR(20) NOT NULL DEFAULT 'pending' COMMENT '状态: pending/settled',
-    settled_at DATETIME COMMENT '结算时间',
-    remark TEXT COMMENT '备注',
-    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    KEY idx_system_id (system_id),
-    KEY idx_period (period_start, period_end)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='结算记录';
-
-CREATE TABLE IF NOT EXISTS supply_settlement_detail (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    settlement_id BIGINT NOT NULL COMMENT '结算ID',
-    order_id BIGINT NOT NULL COMMENT '订单ID',
-    order_no VARCHAR(64) NOT NULL COMMENT '订单号',
-    product_name VARCHAR(200) NOT NULL COMMENT '商品名称',
-    amount INT NOT NULL COMMENT '订单金额(分)',
-    platform_fee INT NOT NULL COMMENT '平台留利(分)',
-    supplier_id BIGINT COMMENT '收款供应商用户ID',
-    supplier_name VARCHAR(100) COMMENT '收款供应商名称',
-    payout INT NOT NULL COMMENT '供应商实付(分)',
-    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    KEY idx_settlement_id (settlement_id),
-    KEY idx_order_id (order_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='结算明细';
-
--- =============================================
--- 收货人与购买信息采集
--- =============================================
-
-CREATE TABLE IF NOT EXISTS consignees (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    user_id BIGINT NOT NULL COMMENT '所属用户ID',
-    name VARCHAR(100) NOT NULL COMMENT '收货人姓名',
-    phone VARCHAR(20) COMMENT '手机号',
-    id_card VARCHAR(20) COMMENT '身份证号',
-    hand_signature TEXT COMMENT '手签名(base64图片或URL)',
-    ethnicity VARCHAR(20) COMMENT '民族',
-    blood_type VARCHAR(20) COMMENT '血型',
-    address VARCHAR(500) COMMENT '收货地址',
-    is_default TINYINT(1) DEFAULT 0 COMMENT '是否默认收货人',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
-    INDEX idx_user_id (user_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='收货人信息(含购买所需特殊信息)';
-
-CREATE TABLE IF NOT EXISTS product_purchase_fields (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
-    product_id BIGINT NOT NULL COMMENT '商品ID',
-    field_key VARCHAR(50) NOT NULL COMMENT '字段标识: name/phone/id_card/hand_signature/ethnicity/blood_type',
-    field_name VARCHAR(100) NOT NULL COMMENT '显示名: 收货人姓名/手机号/身份证号/手签名/民族/血型',
-    is_required TINYINT(1) DEFAULT 1 COMMENT '是否必填 1=是 0=否',
-    sort_order INT DEFAULT 0 COMMENT '排序',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    INDEX idx_product_id (product_id),
-    UNIQUE KEY uk_product_field (product_id, field_key)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='商品购买信息字段配置';
-
--- AI管家会话表
-CREATE TABLE IF NOT EXISTS butler_sessions (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    user_id BIGINT NOT NULL COMMENT '用户ID',
-    title VARCHAR(200) DEFAULT '新会话' COMMENT '会话标题',
-    conversation_id VARCHAR(100) COMMENT 'Dify对话ID',
-    context TEXT COMMENT '上下文信息(JSON)',
-    status VARCHAR(20) DEFAULT 'active' COMMENT '状态: active(进行中)/archived(已归档)',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    INDEX idx_user_id (user_id),
-    INDEX idx_status (status),
-    INDEX idx_user_status (user_id, status)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='AI管家会话表';
-
--- 家庭订阅记录
-CREATE TABLE IF NOT EXISTS member_subscription (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    family_id BIGINT NOT NULL COMMENT '家庭ID',
-    `level` VARCHAR(10) NOT NULL DEFAULT 'L1' COMMENT 'L1=一生一世, L2=久久一生',
-    status VARCHAR(20) NOT NULL DEFAULT 'active' COMMENT 'active/expired/cancelled',
-    start_time DATETIME DEFAULT NULL COMMENT '开始时间',
-    expire_time DATETIME DEFAULT NULL COMMENT '到期时间',
-    payment_id BIGINT DEFAULT NULL COMMENT '关联订单ID',
-    auto_renew TINYINT(1) DEFAULT 0 COMMENT '自动续费(L2)',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    INDEX idx_family_id (family_id),
-    INDEX idx_status (status),
-    INDEX idx_expire_time (expire_time)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='家庭订阅记录';
-
--- 订阅订单
-CREATE TABLE IF NOT EXISTS member_subscription_order (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    family_id BIGINT NOT NULL COMMENT '家庭ID',
-    `level` VARCHAR(10) NOT NULL COMMENT 'L1/L2',
-    amount INT NOT NULL COMMENT '金额(分)',
-    status VARCHAR(20) NOT NULL DEFAULT 'pending' COMMENT 'pending/paid/cancelled/refunded',
-    payment_type VARCHAR(20) DEFAULT NULL COMMENT '支付方式 wechat/alipay',
-    transaction_id VARCHAR(64) DEFAULT NULL COMMENT '微信支付订单号',
-    order_no VARCHAR(64) NOT NULL COMMENT '订单号',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    paid_at DATETIME DEFAULT NULL,
-    UNIQUE KEY uk_order_no (order_no),
-    INDEX idx_family_id (family_id),
-    INDEX idx_status (status)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='订阅订单';
-
--- 权益使用日志
-CREATE TABLE IF NOT EXISTS subscription_benefit_log (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    subscription_id BIGINT NOT NULL COMMENT '订阅ID',
-    benefit_code VARCHAR(50) NOT NULL COMMENT '权益代码',
-    used_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    detail TEXT COMMENT '使用详情(JSON)',
-    INDEX idx_subscription_id (subscription_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='权益使用日志';
-
--- 推广等级 R0-R4
-CREATE TABLE IF NOT EXISTS promotion_tier (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    user_id BIGINT NOT NULL COMMENT '用户ID',
-    tier VARCHAR(20) NOT NULL DEFAULT 'R0' COMMENT 'R0利他者/R1传福人/R2聚能师/R3启慧者/R4传承者',
-    team_size_1st INT DEFAULT 0 COMMENT '一层团队人数',
-    team_size_2nd INT DEFAULT 0 COMMENT '二层团队人数',
-    team_size_3rd INT DEFAULT 0 COMMENT '三层团队人数',
-    total_team_size INT DEFAULT 0 COMMENT '三层累计总人数',
-    total_referral_earnings INT DEFAULT 0 COMMENT '累计推荐佣金(分)',
-    total_share_earnings INT DEFAULT 0 COMMENT '累计消费返利(分)',
-    promoted_at DATETIME DEFAULT NULL COMMENT '最近晋级时间',
-    last_change_at DATETIME DEFAULT NULL COMMENT '最后变更时间',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    UNIQUE KEY uk_user_id (user_id),
-    INDEX idx_tier (tier)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='推广等级';
-
--- 推广等级变更记录
-CREATE TABLE IF NOT EXISTS promotion_tier_change_log (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    user_id BIGINT NOT NULL COMMENT '用户ID',
-    old_tier VARCHAR(20) DEFAULT NULL COMMENT '变更前等级',
-    new_tier VARCHAR(20) NOT NULL COMMENT '变更后等级',
-    reason VARCHAR(50) DEFAULT NULL COMMENT 'qualify升级/demote降级/admin管理员调整',
-    changed_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    INDEX idx_user_id (user_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='推广等级变更记录';
-
--- 推荐关系树(三层)
-CREATE TABLE IF NOT EXISTS referral_tree (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    parent_id BIGINT NOT NULL COMMENT '推荐人ID',
-    child_id BIGINT NOT NULL COMMENT '被推荐人ID',
-    level INT NOT NULL COMMENT '层级深度(1/2/3)',
-    path VARCHAR(255) DEFAULT NULL COMMENT 'materialized path如/1/2/3/',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    UNIQUE KEY uk_child_id (child_id),
-    INDEX idx_parent_id (parent_id),
-    INDEX idx_level (level)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='推荐关系树';
-
--- 产品P点配置
-CREATE TABLE IF NOT EXISTS product_ppoint (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    product_id BIGINT NOT NULL COMMENT '产品ID',
-    ppoint INT NOT NULL DEFAULT 0 COMMENT 'P点值(平台利润分)',
-    start_date DATE DEFAULT NULL COMMENT '生效日期',
-    end_date DATE DEFAULT NULL COMMENT '失效日期',
-    created_by BIGINT DEFAULT NULL COMMENT '创建人',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    INDEX idx_product_id (product_id),
-    INDEX idx_dates (start_date, end_date)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='产品P点配置';
-
--- 测评商品扩展信息
-CREATE TABLE IF NOT EXISTS assessment_products (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    product_id BIGINT NOT NULL COMMENT '关联products表',
-    assessment_type VARCHAR(20) NOT NULL COMMENT 'single=单包, bundle=套餐',
-    total_sessions INT NOT NULL DEFAULT 1 COMMENT '包含测评次数',
-    validity_days INT NOT NULL DEFAULT 365 COMMENT '有效期(天)',
-    guide_scope VARCHAR(50) DEFAULT 'all' COMMENT '规划师范围: all/assigned/auto',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    INDEX idx_product_id (product_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='测评商品扩展信息';
-
--- 测评额度表
-CREATE TABLE IF NOT EXISTS assessment_quotas (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    quota_no VARCHAR(32) NOT NULL COMMENT '额度编号',
-    family_id BIGINT NOT NULL COMMENT '家庭ID',
-    child_id BIGINT COMMENT '指定孩子ID(NULL=不限)',
-    product_order_id BIGINT NOT NULL COMMENT '来源订单ID',
-    product_id BIGINT NOT NULL COMMENT '商品ID',
-    product_name VARCHAR(100) NOT NULL COMMENT '商品名快照',
-    total_sessions INT NOT NULL DEFAULT 1 COMMENT '总次数',
-    remaining_sessions INT NOT NULL DEFAULT 1 COMMENT '剩余次数',
-    validity_start DATETIME NOT NULL COMMENT '有效期开始',
-    validity_end DATETIME NOT NULL COMMENT '有效期截止',
-    status VARCHAR(20) NOT NULL DEFAULT 'active' COMMENT 'active/expired/used_all/cancelled',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    INDEX idx_family (family_id),
-    INDEX idx_order (product_order_id),
-    UNIQUE KEY uk_quota_no (quota_no)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='测评额度表';
-
--- 测评执行记录表
-CREATE TABLE IF NOT EXISTS assessment_executions (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    quota_id BIGINT NOT NULL COMMENT '关联额度ID',
-    child_id BIGINT NOT NULL COMMENT '被测评孩子',
-    guide_id BIGINT COMMENT '执行规划师ID',
-    assessment_type VARCHAR(30) COMMENT '本次具体测评类型',
-    appointment_id BIGINT COMMENT '关联预约ID',
-    result_id BIGINT COMMENT '关联测评结果ID',
-    status VARCHAR(20) NOT NULL DEFAULT 'pending' COMMENT 'pending/in_progress/completed/cancelled',
-    scheduled_date DATETIME COMMENT '预约执行时间',
-    completed_at DATETIME COMMENT '实际完成时间',
-    notes VARCHAR(500) COMMENT '备注',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    INDEX idx_quota (quota_id),
-    INDEX idx_child (child_id),
-    INDEX idx_appointment (appointment_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='测评执行记录表';
-
--- 测评指导意见表(结构化存储)
-CREATE TABLE IF NOT EXISTS growth_guidances (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    result_id BIGINT NOT NULL COMMENT '关联测评结果ID',
-    dimension VARCHAR(30) NOT NULL COMMENT '维度: attention/focus/memory/logic/emotion/general',
-    score INT COMMENT '该维度得分(0-100)',
-    suggestion TEXT NOT NULL COMMENT '建议内容',
-    priority INT DEFAULT 0 COMMENT '优先级(0=普通, 1=重要, 2=紧急)',
-    sort_order INT DEFAULT 0 COMMENT '排序',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    INDEX idx_result (result_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='测评指导意见(结构化)';
-
--- 方案生成规则表
-CREATE TABLE IF NOT EXISTS assessment_plan_rules (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    dimension VARCHAR(30) NOT NULL COMMENT '测评维度: attention/focus/memory/logic/emotion',
-    score_min INT NOT NULL COMMENT '分数下限(含)',
-    score_max INT NOT NULL COMMENT '分数上限(含)',
-    template_id BIGINT NOT NULL COMMENT '关联TaskTemplatePackage ID',
-    priority INT DEFAULT 0 COMMENT '优先级',
-    is_active TINYINT(1) DEFAULT 1 COMMENT '是否启用',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    INDEX idx_dimension (dimension),
-    INDEX idx_score (score_min, score_max)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='方案生成规则';
-
-<<<<<<< HEAD
--- 家庭访问安全日志表
-CREATE TABLE IF NOT EXISTS family_access_logs (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    user_id BIGINT NOT NULL COMMENT '访问方用户ID',
-    family_id BIGINT NOT NULL COMMENT '被访问的家庭ID',
-    request_uri VARCHAR(500) NOT NULL COMMENT '请求路径',
-    request_method VARCHAR(10) NOT NULL,
-    access_type VARCHAR(20) NOT NULL COMMENT 'check_type: query/path/body',
-    result VARCHAR(10) NOT NULL COMMENT 'allowed/denied/log_only',
-    client_ip VARCHAR(50),
-    user_agent VARCHAR(500),
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    INDEX idx_user_time (user_id, created_at),
-    INDEX idx_family_time (family_id, created_at)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='家庭访问安全日志';
-
--- 五维能量分数历史记录表
-CREATE TABLE IF NOT EXISTS five_dimension_scores (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    member_id BIGINT NOT NULL COMMENT '成员ID(user或family_member)',
-    member_type VARCHAR(20) NOT NULL COMMENT '成员类型: user/member',
-    family_id BIGINT NOT NULL COMMENT '家庭ID',
-    dimension_code VARCHAR(20) NOT NULL COMMENT '维度编码: body/mind/wisdom/action/wealth',
-    score INT NOT NULL COMMENT '分数(0-100)',
-    assessed_at DATETIME NOT NULL COMMENT '评估时间',
-    source_type VARCHAR(50) COMMENT '来源类型: periodic/task/assessment/manual',
-    source_id BIGINT COMMENT '来源记录ID',
-    detail_json TEXT COMMENT '详细数据JSON',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
-    INDEX idx_member_dim (member_id, member_type, dimension_code),
-    INDEX idx_family_time (family_id, assessed_at),
-    INDEX idx_source (source_type, source_id)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='五维能量分数历史记录';
-
--- 家庭邀请令牌表
-CREATE TABLE IF NOT EXISTS family_invitations (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    family_id BIGINT NOT NULL COMMENT '家庭ID',
-    token VARCHAR(64) NOT NULL UNIQUE COMMENT '邀请令牌(UUID)',
-    created_by BIGINT NOT NULL COMMENT '创建人用户ID',
-    status VARCHAR(16) DEFAULT 'active' COMMENT '状态: active/used/expired/revoked',
-    expires_at DATETIME COMMENT '过期时间',
-    max_use_count INT DEFAULT 1 COMMENT '最大使用次数',
-    used_count INT DEFAULT 0 COMMENT '已使用次数',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    INDEX idx_family_id (family_id),
-    INDEX idx_token (token),
-    INDEX idx_status (status)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='家庭邀请令牌';
-=======
--- 推广等级阈值配置表
-CREATE TABLE IF NOT EXISTS promotion_tier_config (
-    id BIGINT AUTO_INCREMENT PRIMARY KEY,
-    tier_code VARCHAR(20) NOT NULL COMMENT '等级代码',
-    tier_name VARCHAR(50) NOT NULL COMMENT '等级名称',
-    min_team_size INT NOT NULL DEFAULT 0 COMMENT '晋级所需最小团队人数',
-    min_referral_earnings INT DEFAULT 0 COMMENT '晋级所需最小累计推荐佣金(分)',
-    min_share_earnings INT DEFAULT 0 COMMENT '晋级所需最小累计消费分润(分)',
-    profit_share_percent INT DEFAULT 20 COMMENT '产品P点比例(%)',
-    sort_order INT DEFAULT 0 COMMENT '排序',
-    enabled TINYINT(1) DEFAULT 1 COMMENT '是否启用',
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
-    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
-    UNIQUE KEY uk_tier_code (tier_code),
-    INDEX idx_enabled (enabled)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='推广等级阈值配置表';
->>>>>>> 81845ce (feat: integrate promotion tier scaling into commission settlement + DB migration)
+    vendor_id        BIGINT COMMENT '服务商ID',
+    vendor_name      VARCHAR(100) COMMENT '服务商名称',
+    created_at       DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at       DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    INDEX idx_dimension (dimension_code),
+    INDEX idx_status (status),
+    INDEX idx_start_time (start_time)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='活动表';
+
+-- v1.x: 活动工作流状态扩展
+ALTER TABLE activities
+  MODIFY COLUMN status VARCHAR(20) DEFAULT 'draft'
+    COMMENT '状态:draft(草稿)/pending(待审核)/rejected(已驳回)/published(发布中)/withdrawn(已撤回)',
+  ADD COLUMN audit_status VARCHAR(20) DEFAULT NULL
+    COMMENT '审核状态:approved/pending/rejected',
+  ADD COLUMN audit_reason TEXT DEFAULT NULL
+    COMMENT '驳回原因',
+  ADD COLUMN auditor_id BIGINT DEFAULT NULL
+    COMMENT '审核人 ID',
+  ADD COLUMN audited_at DATETIME DEFAULT NULL
+    COMMENT '审核时间';
+
+-- ===== v1.3 家庭成员体系 =====
+
+-- 手动添加的家庭成员表(替代children表用于新成员)
+CREATE TABLE IF NOT EXISTS family_members (
+    id               BIGINT AUTO_INCREMENT PRIMARY KEY,
+    family_id        BIGINT       NOT NULL COMMENT '所属家庭ID',
+    user_id          BIGINT       COMMENT '关联的用户ID(手机号匹配到已有用户时)',
+    nickname         VARCHAR(100) NOT NULL COMMENT '昵称',
+    phone            VARCHAR(20)  COMMENT '手机号',
+    avatar           VARCHAR(500) COMMENT '头像',
+    gender           VARCHAR(10)  COMMENT '性别: male/female',
+    birthday         DATE         COMMENT '出生日期',
+    relationship_type VARCHAR(50) NOT NULL COMMENT '关系类型key',
+    role_override VARCHAR(20) DEFAULT 'auto' COMMENT '角色覆盖: auto/parent/child/elderly,空=auto',
+    show_to_family INT DEFAULT 1 COMMENT '对家庭成员可见: 1=可见, 0=不可见',
+    total_points INT DEFAULT 0 COMMENT '总积分',
+    -- 孩子专属字段(原children表合并)
+    id_card VARCHAR(18) DEFAULT NULL COMMENT '身份证号(孩子)',
+    penalty_enabled TINYINT DEFAULT 1 COMMENT '是否扣减积分(0否1是)',
+    theme VARCHAR(32) DEFAULT 'default' COMMENT '主题',
+    system_points INT DEFAULT 0 COMMENT '系统积分(干预/平台奖励)',
+    streak_days INT DEFAULT 0 COMMENT '连续打卡天数',
+    last_task_date DATE COMMENT '上次任务日期',
+    focus_max_daily TINYINT DEFAULT 3 COMMENT '每日专注上限',
+    focus_remaining TINYINT DEFAULT 3 COMMENT '今日剩余专注次数',
+    focus_reset_date DATE COMMENT '专注次数重置日期',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    INDEX idx_family_id (family_id),
+    INDEX idx_phone (phone)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='家庭成员表(手动添加)';
+
+-- 家庭成员双向关系表(v2: 替代relationship_type/role_override)
+CREATE TABLE IF NOT EXISTS family_relationships (
+    id               BIGINT AUTO_INCREMENT PRIMARY KEY,
+    family_id        BIGINT       NOT NULL COMMENT '所属家庭ID',
+    from_member_id   BIGINT       NOT NULL COMMENT '关系起点成员ID',
+    to_member_id     BIGINT       NOT NULL COMMENT '关系终点成员ID',
+    generation_value INT          NOT NULL COMMENT '辈分值: -1=子女, 0=同辈, 1=父母, 2=祖父母, 3=曾祖父母',
+    relationship_key VARCHAR(50)  COMMENT '关系标签key(冗余用于显示, 如father/mother/son/daughter/spouse/sibling)',
+    created_at       DATETIME     DEFAULT CURRENT_TIMESTAMP,
+    updated_at       DATETIME     DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    UNIQUE KEY uk_from_to (from_member_id, to_member_id),
+    INDEX idx_family_id (family_id),
+    INDEX idx_from (from_member_id),
+    INDEX idx_to (to_member_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='家庭成员双向关系表';
+
+-- 关系类型配置表(管理端可配置)
+CREATE TABLE IF NOT EXISTS relationship_types (
+    id               BIGINT AUTO_INCREMENT PRIMARY KEY,
+    type_key         VARCHAR(50)  NOT NULL UNIQUE COMMENT '类型标识: spouse/parent/child/sibling',
+    type_name        VARCHAR(100) NOT NULL COMMENT '类型显示名: 配偶/父母/子女/兄弟姐妹',
+    capability_role  VARCHAR(20)  NOT NULL DEFAULT 'parent' COMMENT '能力角色: parent/child',
+    default_role     VARCHAR(20)  DEFAULT NULL COMMENT '默认角色模板: parent/child(已废弃, 兼容保留)',
+    sort_order       INT DEFAULT 0 COMMENT '排序序号',
+    enabled          INT DEFAULT 1 COMMENT '是否启用: 1=启用, 0=禁用',
+    created_at       DATETIME DEFAULT CURRENT_TIMESTAMP
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='关系类型配置表';
+
+-- 默认关系类型数据(default_role: parent/child 为该关系类型的默认角色模板)
+INSERT IGNORE INTO relationship_types (type_key, type_name, default_role, sort_order, enabled) VALUES
+('spouse', '配偶', 'parent', 1, 1),
+('parent', '父母', 'parent', 2, 1),
+('child', '子女', 'child', 3, 1),
+('sibling', '兄弟姐妹', 'child', 4, 1);
+
+-- 用户收货地址表
+CREATE TABLE IF NOT EXISTS user_address (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    user_id BIGINT NOT NULL COMMENT '用户ID',
+    receiver_name VARCHAR(50) NOT NULL COMMENT '收货人姓名',
+    phone VARCHAR(20) NOT NULL COMMENT '收货人电话',
+    province VARCHAR(50) COMMENT '省',
+    city VARCHAR(50) COMMENT '市',
+    district VARCHAR(50) COMMENT '区',
+    street VARCHAR(200) COMMENT '详细地址',
+    is_default TINYINT DEFAULT 0 COMMENT '是否默认地址 1=是 0=否',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    INDEX idx_user_id (user_id),
+    INDEX idx_is_default (is_default)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='用户收货地址表';
+
+-- =============================================
+-- 新手引导奖励表
+-- =============================================
+
+CREATE TABLE IF NOT EXISTS onboarding_task (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    user_id BIGINT NOT NULL,
+    task_type VARCHAR(32) NOT NULL,
+    reward_points INT DEFAULT 0,
+    reward_energy INT DEFAULT 0,
+    status VARCHAR(16) DEFAULT 'PENDING',
+    completed_at DATETIME,
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    INDEX idx_user_id (user_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- =============================================
+-- 成长任务配置表
+-- =============================================
+
+CREATE TABLE IF NOT EXISTS growth_task (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    type VARCHAR(16) NOT NULL COMMENT 'DAILY/NEWBIE',
+    title VARCHAR(100) NOT NULL,
+    description TEXT,
+    reward_points INT DEFAULT 0,
+    reward_energy INT DEFAULT 0,
+    target_value INT DEFAULT 1,
+    task_key VARCHAR(32) UNIQUE NOT NULL,
+    enabled TINYINT DEFAULT 1,
+    sort_order INT DEFAULT 0,
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    INDEX idx_type (type)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='成长任务配置表';
+
+CREATE TABLE IF NOT EXISTS growth_task_log (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    user_id BIGINT NOT NULL,
+    task_id BIGINT NOT NULL,
+    progress INT DEFAULT 0,
+    completed TINYINT DEFAULT 0,
+    claimed TINYINT DEFAULT 0,
+    date VARCHAR(10) COMMENT 'YYYY-MM-DD for daily, empty for newbie',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    INDEX idx_user_date (user_id, date),
+    INDEX idx_task_id (task_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='成长任务用户进度表';
+
+-- =============================================
+-- 优惠券配置表
+-- =============================================
+
+CREATE TABLE IF NOT EXISTS coupon (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    name VARCHAR(64) NOT NULL,
+    type VARCHAR(16) DEFAULT 'FIXED',
+    value INT DEFAULT 0 COMMENT '金额 单位:分',
+    min_spend INT DEFAULT 0 COMMENT '最低消费 单位:分',
+    applicable_to VARCHAR(32) DEFAULT 'ALL',
+    valid_from DATETIME,
+    valid_until DATETIME,
+    total_count INT DEFAULT 0,
+    used_count INT DEFAULT 0,
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    INDEX idx_valid_period (valid_from, valid_until)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='优惠券配置表';
+
+CREATE TABLE IF NOT EXISTS user_coupon (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    user_id BIGINT NOT NULL,
+    coupon_id BIGINT NOT NULL,
+    status VARCHAR(16) DEFAULT 'AVAILABLE',
+    received_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    used_at DATETIME,
+    order_id BIGINT,
+    INDEX idx_user_coupon (user_id, coupon_id),
+    INDEX idx_status (status),
+    INDEX idx_order_id (order_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='用户优惠券表';
+
+-- =============================================
+-- 邀请里程碑表
+-- =============================================
+
+CREATE TABLE IF NOT EXISTS invite_milestone (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    user_id BIGINT NOT NULL,
+    milestone VARCHAR(32) NOT NULL,
+    reward_points INT DEFAULT 0,
+    reward_energy INT DEFAULT 0,
+    status VARCHAR(16) DEFAULT 'PENDING',
+    achieved_at DATETIME,
+    claimed_at DATETIME,
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    INDEX idx_user_milestone (user_id, milestone)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='邀请里程碑表';
+
+-- =============================================
+-- 推广排行榜周记录表
+-- =============================================
+
+CREATE TABLE IF NOT EXISTS referral_leaderboard (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    user_id BIGINT NOT NULL,
+    week_start VARCHAR(10) NOT NULL COMMENT '周一日期 YYYY-MM-DD',
+    referral_count INT DEFAULT 0,
+    `rank` INT,
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    UNIQUE INDEX idx_user_week (user_id, week_start),
+    INDEX idx_week_rank (week_start, referral_count DESC)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='推广排行榜周记录';
+
+-- =============================================
+-- 虚拟服务商团队(销售体系)
+-- =============================================
+
+CREATE TABLE IF NOT EXISTS `distribution_systems` (
+    `id` BIGINT AUTO_INCREMENT PRIMARY KEY,
+    `name` VARCHAR(100) NOT NULL COMMENT '团队名称',
+    `description` TEXT COMMENT '团队描述',
+    `owner_id` BIGINT COMMENT '创建人(服务商用户ID)',
+    `profit_rate` INT DEFAULT 0 COMMENT '利润分成比例(bps, 如2000=20%)',
+    `enabled` TINYINT(1) DEFAULT 1 COMMENT '是否启用',
+    `created_at` DATETIME DEFAULT CURRENT_TIMESTAMP,
+    `updated_at` DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='虚拟服务商团队(销售体系)';
+
+CREATE TABLE IF NOT EXISTS `distribution_relations` (
+    `id` BIGINT AUTO_INCREMENT PRIMARY KEY,
+    `system_id` BIGINT NOT NULL COMMENT '所属团队ID',
+    `user_id` BIGINT NOT NULL COMMENT '服务商用户ID',
+    `parent_id` BIGINT COMMENT '上级服务商用户ID',
+    `depth` INT DEFAULT 0 COMMENT '层级深度(0=root)',
+    `created_at` DATETIME DEFAULT CURRENT_TIMESTAMP,
+    INDEX idx_system (system_id),
+    INDEX idx_user (user_id),
+    INDEX idx_parent (parent_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='团队-服务商关系(同一人在不同团队可处于不同位置)';
+
+-- =============================================
+-- 成长任务种子数据
+-- =============================================
+
+INSERT IGNORE INTO growth_task (type, title, description, reward_points, reward_energy, target_value, task_key, sort_order) VALUES
+('DAILY', '每日签到', '完成每日签到', 20, 3, 1, 'DAILY_CHECKIN', 1),
+('DAILY', '完成任务', '完成一个任务', 30, 5, 1, 'DAILY_TASK', 2),
+('DAILY', '分享文章', '分享一篇好文给好友', 10, 2, 1, 'DAILY_SHARE', 3),
+('DAILY', 'AI对话', '与AI助手进行一次对话', 15, 3, 1, 'DAILY_AI', 4);
+
+-- ========== 全域指标定义表 ==========
+-- ===== v1.5 家庭文化镜:关系兼容性配置 =====
+
+-- 生肖配对规则表
+CREATE TABLE IF NOT EXISTS zodiac_pairing (
+    id               BIGINT AUTO_INCREMENT PRIMARY KEY,
+    zodiac_code_1    VARCHAR(20) NOT NULL COMMENT '生肖代码1',
+    zodiac_code_2    VARCHAR(20) NOT NULL COMMENT '生肖代码2',
+    pairing_type     VARCHAR(20) NOT NULL COMMENT '配对类型: liuhe/sanhe/banhe/liuchong/xianghai/xiangxing/ping',
+    compatibility_score INT DEFAULT 50 COMMENT '兼容分 0-100',
+    description      TEXT COMMENT '配对解读',
+    advice           TEXT COMMENT '相处建议',
+    created_at       DATETIME DEFAULT CURRENT_TIMESTAMP,
+    UNIQUE KEY uk_zodiac_pair (zodiac_code_1, zodiac_code_2)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='生肖配对规则表';
+
+-- 十二生肖六合/三合/六冲种子数据
+INSERT IGNORE INTO zodiac_pairing (zodiac_code_1, zodiac_code_2, pairing_type, compatibility_score, description, advice) VALUES
+('rat', 'ox', 'liuhe', 100, '子丑六合,天生一对', '你们是最佳拍档,互相补充,默契十足'),
+('rat', 'monkey', 'sanhe', 85, '申子半合水局,默契度高', '智慧结合,创意无限,适合一起做规划'),
+('rat', 'dragon', 'sanhe', 85, '子辰半合水局,相辅相成', '一个机灵一个大气,共同成就大事'),
+('rat', 'horse', 'liuchong', 20, '子午相冲,水火不容', '价值观差异大,需要多包容理解'),
+('rat', 'tiger', 'xiangxing', 30, '寅子相刑,容易误会', '沟通方式不同,建议用行动代替言语'),
+('rat', 'rabbit', 'xiangxing', 30, '卯子相刑,互不相让', '各执己见时先冷静再沟通'),
+('rat', 'sheep', 'xianghai', 35, '子未相害,暗中较劲', '表面和谐但内心可能有竞争意识'),
+('ox', 'tiger', 'ping', 55, '牛虎平平,互敬互重', '踏实遇上冒险,可以互相学习'),
+('ox', 'rabbit', 'xianghai', 35, '丑卯相害,各怀心思', '建议开诚布公,减少猜测'),
+('ox', 'dragon', 'ping', 55, '牛龙平平,求同存异', '务实和理想主义的碰撞'),
+('ox', 'snake', 'sanhe', 85, '巳酉丑三合金局,配合默契', '务实加智慧,黄金搭档'),
+('ox', 'horse', 'xianghai', 35, '丑午相害,相处需技巧', '步调不同,需要彼此迁就'),
+('ox', 'sheep', 'liuchong', 20, '丑未相冲,针锋相对', '一个固执一个犟,需要第三方调和'),
+('tiger', 'rabbit', 'ping', 55, '虎兔平平,各有所长', '虎的魄力配兔的细腻,互补型'),
+('tiger', 'dragon', 'ping', 55, '虎龙平平,互相欣赏', '都有王者风范,但要注意谁说了算'),
+('tiger', 'snake', 'xianghai', 35, '寅巳相害,互相防备', '一个直率一个深沉,需要更多信任'),
+('tiger', 'horse', 'sanhe', 85, '寅午半合火局,一拍即合', '热情似火,志同道合的行动派'),
+('tiger', 'sheep', 'ping', 55, '虎羊平平,温柔与力量', '虎保护羊,羊温暖虎'),
+('tiger', 'monkey', 'liuchong', 20, '寅申相冲,竞争关系', '针尖对麦芒,需要在竞争中找合作'),
+('tiger', 'pig', 'liuhe', 100, '寅亥六合,情投意合', '虎猪相合,真诚相待的最佳组合'),
+('rabbit', 'dragon', 'xianghai', 35, '卯辰相害,表面和谐', '温和遇到强势,需要找到平衡'),
+('rabbit', 'snake', 'ping', 55, '兔蛇平平,温和相处', '都是内敛型,适合安静的陪伴'),
+('rabbit', 'horse', 'ping', 55, '兔马平平,一动一静', '一个爱静一个爱动,互相调剂'),
+('rabbit', 'sheep', 'sanhe', 85, '卯未半合木局,志趣相投', '文艺组合,品味相投'),
+('rabbit', 'monkey', 'xiangxing', 30, '卯申相刑,互不买账', '思维方式差异大,需要耐心'),
+('rabbit', 'rooster', 'liuchong', 20, '卯酉相冲,水火难容', '生活节奏完全不同,需要大包容'),
+('rabbit', 'dog', 'liuhe', 100, '卯戌六合,忠诚相伴', '兔狗相合,彼此忠诚的最佳关系'),
+('dragon', 'snake', 'ping', 55, '龙蛇平平,同源相惜', '都有神秘气质,惺惺相惜'),
+('dragon', 'horse', 'ping', 55, '龙马平平,各有天地', '一个在天一个在地,互不干涉'),
+('dragon', 'sheep', 'xiangxing', 30, '辰未相刑,暗中别扭', '看似无事却有暗流,多交流可化解'),
+('dragon', 'monkey', 'sanhe', 85, '申子辰三合水局,天生队友', '最佳事业组合,互相成就'),
+('dragon', 'rooster', 'liuhe', 100, '辰酉六合,珠联璧合', '龙凤配,传统的最佳搭档'),
+('dragon', 'dog', 'liuchong', 20, '辰戌相冲,正面冲突', '硬碰硬的关系,需要智慧化解'),
+('snake', 'horse', 'xiangxing', 30, '巳午相刑,热度不同', '蛇冷静马热情,温度要调和'),
+('snake', 'sheep', 'sanhe', 85, '巳酉丑三合金局,智慧搭档', '沉稳加温柔,互相信任的深层关系'),
+('snake', 'monkey', 'liuhe', 100, '巳申六合,智谋相投', '聪明人之间的默契'),
+('snake', 'rooster', 'sanhe', 85, '巳酉丑三合金局,配合无间', '细节控和完美主义者的理想组合'),
+('snake', 'pig', 'liuchong', 20, '巳亥相冲,南辕北辙', '一个深沉一个随性,需要大幅磨合'),
+('horse', 'sheep', 'liuhe', 100, '午未六合,温情相依', '马羊相合,温暖体贴的最佳关系'),
+('horse', 'monkey', 'xiangxing', 30, '午申相刑,互不理解', '行动派和思考派的碰撞'),
+('horse', 'rooster', 'xiangxing', 30, '午酉相刑,意气用事', '都容易冲动,需要一个冷静者调和'),
+('horse', 'dog', 'sanhe', 85, '寅午戌三合火局,行动搭档', '热情忠诚组合,一起行动效率高'),
+('horse', 'pig', 'liuhe', 100, '亥午暗合,心有灵犀', '一静一动却暗合,出人意料的默契'),
+('sheep', 'monkey', 'xiangxing', 30, '未申相刑,互挑毛病', '容易在小事上相互挑剔'),
+('sheep', 'rooster', 'ping', 55, '羊鸡平平,互相欣赏', '羊的细腻欣赏鸡的精致'),
+('sheep', 'dog', 'xiangxing', 30, '未戌相刑,各怀心事', '需要建立更深层的信任'),
+('sheep', 'pig', 'sanhe', 85, '亥卯未三合木局,温柔组合', '温和的三合组,舒适无压力的关系'),
+('monkey', 'rooster', 'ping', 55, '猴鸡平平,互相启发', '聪明人的相遇,火花四射'),
+('monkey', 'dog', 'xiangxing', 30, '申戌相刑,互不信任', '需要时间证明真心'),
+('monkey', 'pig', 'liuhe', 100, '申亥六合,智勇双全', '猴子机智猪包容,最佳朋友组合'),
+('rooster', 'dog', 'xiangxing', 30, '酉戌相刑,互相挑剔', '完美主义遇见忠诚卫士,互相看不惯'),
+('rooster', 'pig', 'ping', 55, '鸡猪平平,各取所需', '鸡的精明和猪的豁达互相补充'),
+('dog', 'pig', 'sanhe', 85, '寅午戌三合火局,忠诚相伴', '忠诚的守护组合,互相支持');
+
+-- 血型配对表
+CREATE TABLE IF NOT EXISTS blood_type_pairing (
+    id               BIGINT AUTO_INCREMENT PRIMARY KEY,
+    blood_type_1     VARCHAR(5) NOT NULL COMMENT '血型1',
+    blood_type_2     VARCHAR(5) NOT NULL COMMENT '血型2',
+    compatibility_score INT DEFAULT 50 COMMENT '兼容分 0-100',
+    description      TEXT COMMENT '配对描述',
+    advice           TEXT COMMENT '相处建议',
+    created_at       DATETIME DEFAULT CURRENT_TIMESTAMP,
+    UNIQUE KEY uk_blood_pair (blood_type_1, blood_type_2)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='血型配对表';
+
+INSERT IGNORE INTO blood_type_pairing (blood_type_1, blood_type_2, compatibility_score, description, advice) VALUES
+('A', 'A', 80, '同型相吸,稳重默契', '都能理解对方的细腻敏感,但注意不要一起钻牛角尖'),
+('A', 'B', 50, '互补型,有吸引力也有摩擦', 'B型的自由奔放吸引A型,但A型的严谨可能让B型感到压力'),
+('A', 'O', 75, 'A主内O主外,搭配和谐', 'O型的大气包容A型的细致,是最常见的和谐组合'),
+('A', 'AB', 70, 'AB型善解人意,A型感到被理解', 'AB型的理性刚好平衡A型的感性'),
+('B', 'B', 75, '同型相投,自由自在', '都给彼此空间,但可能缺乏规划'),
+('B', 'O', 70, 'O型包容B型,相处轻松', 'O型的稳定给了B型安全感'),
+('B', 'AB', 65, '互相欣赏,各有天地', 'B型的创意和AB型的分析能力互补'),
+('O', 'O', 85, '强强联合,行动力爆棚', '都是行动派,但要注意不要都太强势'),
+('O', 'AB', 75, 'O型领导,AB型军师', 'O型的大方向加AB型的精细思维,无敌组合'),
+('AB', 'AB', 60, '互相理解但可能过度理性', '两个理性派,别忘了情感交流');
+
+-- 生命灵数关系解读表
+CREATE TABLE IF NOT EXISTS life_number_relationship (
+    id               BIGINT AUTO_INCREMENT PRIMARY KEY,
+    relationship_number INT NOT NULL COMMENT '关系数字 1-9',
+    title            VARCHAR(100) COMMENT '关系主题',
+    description      TEXT COMMENT '关系解读',
+    advice           TEXT COMMENT '相处建议',
+    color_hex        VARCHAR(10) COMMENT '代表色',
+    created_at       DATETIME DEFAULT CURRENT_TIMESTAMP,
+    UNIQUE KEY uk_relationship_num (relationship_number)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='生命灵数关系解读表';
+
+INSERT IGNORE INTO life_number_relationship (relationship_number, title, description, advice, color_hex) VALUES
+(1, '开创者关系', '你们在一起充满创造力和领导力,彼此激励去实现目标', '注意不要互相竞争谁说了算,明确分工才能发挥最大能量', '#FF4444'),
+(2, '合作伙伴关系', '你们是天生的搭档,善于倾听和配合,营造和谐氛围', '过于迁就对方可能会失去自我,保持适度独立才能长久', '#FF8C42'),
+(3, '创意火花关系', '在一起充满欢乐和创造力,社交圈会因为你们而扩大', '注意不要太表面化,偶尔需要深度的对话来维系情感', '#FFD700'),
+(4, '建设者关系', '你们是务实稳健的组合,能一起把想法变成现实', '生活不能只有工作和责任,记得给彼此创造惊喜和浪漫', '#10B981'),
+(5, '探险者关系', '在一起充满变化和新鲜感,喜欢一起探索未知', '变化太多可能会让关系缺乏安全感,寻找一些共同的固定仪式', '#3B82F6'),
+(6, '守护者关系', '你们的关系以关爱和责任为基础,彼此是最坚实的后盾', '付出太多可能会感到疲惫,学会接受对方的爱和照顾', '#6366F1'),
+(7, '智者关系', '在一起有深度的精神交流和思想碰撞,追求真理', '不要沉浸在各自的世界里,记得用简单的方式表达爱', '#8B5CF6'),
+(8, '成就者关系', '你们是强强联合,追求物质和事业上的共同成就', '在追求成功的同时不要忽视感情的温度,平衡事业和生活', '#F59E0B'),
+(9, '圆满者关系', '在一起有强烈的宿命感,彼此理解和支持,是灵魂伴侣', '太理想化可能会失望,接受对方的不完美才能走得更远', '#FF6B9D');
+
+CREATE TABLE IF NOT EXISTS indicator_definitions (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    domain VARCHAR(50) NOT NULL COMMENT '领域: physical/mental/nutrition/behavior/social',
+    category VARCHAR(50) NOT NULL COMMENT '分类: 舌色/苔色/情绪/...',
+    code VARCHAR(50) NOT NULL UNIQUE COMMENT '编码: tongue_color/coating_color/...',
+    name VARCHAR(100) NOT NULL COMMENT '显示名: 舌体颜色/苔色/...',
+    data_type VARCHAR(20) NOT NULL DEFAULT 'enum' COMMENT '数据类型: enum/number/string',
+    options JSON COMMENT '枚举值列表: ["淡红","红","绛","青紫"] 或 null',
+    unit VARCHAR(50) COMMENT '单位',
+    ref_range VARCHAR(200) COMMENT '参考范围',
+    sort_order INT DEFAULT 0 COMMENT '排序',
+    status TINYINT DEFAULT 1 COMMENT '0=禁用 1=启用',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='全域指标定义';
+
+-- ========== 全域指标值表 ==========
+CREATE TABLE IF NOT EXISTS indicator_values (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    source_type VARCHAR(50) NOT NULL COMMENT '来源: tongue_record/health_report/assessment',
+    source_id BIGINT NOT NULL COMMENT '来源记录ID',
+    definition_id BIGINT NOT NULL COMMENT 'FK→indicator_definitions.id',
+    value VARCHAR(200) COMMENT '值',
+    numeric_value DECIMAL(10,2) COMMENT '数值(number类型时用)',
+    remark TEXT COMMENT '备注',
+    recorded_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    INDEX idx_source (source_type, source_id),
+    INDEX idx_definition (definition_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='全域指标值';
+
+-- ========== 舌诊主记录表 ==========
+CREATE TABLE IF NOT EXISTS tongue_records (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    member_id BIGINT NOT NULL COMMENT '家庭成员ID',
+    child_id BIGINT COMMENT '孩子ID',
+    image_url VARCHAR(500) COMMENT '舌象图片URL',
+    overall_assessment TEXT COMMENT '总体评估',
+    status VARCHAR(20) DEFAULT 'draft' COMMENT 'draft/confirmed',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    INDEX idx_member (member_id, child_id),
+    INDEX idx_status (status)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='舌诊主记录';
+
+-- ========== 种子数据:舌诊7项指标定义 ==========
+INSERT IGNORE INTO indicator_definitions (domain, category, code, name, data_type, options, sort_order, status) VALUES
+('physical', '舌色', 'tongue_color', '舌体颜色', 'enum', '["淡红","红","绛","青紫"]', 1, 1),
+('physical', '苔色', 'coating_color', '苔色', 'enum', '["薄白","白","黄","灰黑"]', 2, 1),
+('physical', '苔质', 'coating_texture', '苔质', 'enum', '["润","燥","滑","涩","腻"]', 3, 1),
+('physical', '裂纹', 'fissure', '裂纹程度', 'enum', '["无","轻","中","重"]', 4, 1),
+('physical', '齿痕', 'teeth_mark', '齿痕程度', 'enum', '["无","轻","中","重"]', 5, 1),
+('physical', '舌下络脉', 'sublingual_vein', '舌下络脉', 'enum', '["正常","轻","中","重"]', 6, 1),
+('physical', '体质', 'constitution', '体质辨识', 'enum', '["平和质","气虚质","阳虚质","阴虚质","湿热质","痰湿质","血瘀质","气郁质","特禀质"]', 7, 1);
+
+-- =============================================
+-- 活动报名 & 能量规则引擎 v1.4 - 字段扩展
+-- 通过 DatabaseInitializer.java 在 ALTER 阶段执行
+-- =============================================
+
+-- 活动表扩展字段
+ALTER TABLE activities ADD COLUMN require_registration TINYINT DEFAULT 1 COMMENT '是否需要报名: 1=需要, 0=直接参与';
+ALTER TABLE activities ADD COLUMN require_checkin_review TINYINT DEFAULT 1 COMMENT '打卡是否需要审核: 1=需要, 0=直接通过';
+ALTER TABLE activities ADD COLUMN energy_penalty_unregistered INT DEFAULT 5 COMMENT '未报名打卡的行能量扣减值';
+
+-- ============================================================
+-- 新增:系统配置表(角色年龄阈值等)
+-- ============================================================
+CREATE TABLE IF NOT EXISTS system_config (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    config_key VARCHAR(100) NOT NULL UNIQUE COMMENT '配置键',
+    config_value TEXT COMMENT '配置值',
+    description TEXT COMMENT '说明',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='系统配置表';
+
+-- ============================================================
+-- 数据迁移: children → family_members + roleOverride 变更
+-- 执行时机: Phase 9(所有代码变更完成后、上线前)
+-- ============================================================
+
+-- 1. family_members.capability_role → role_override (已在 DDL 中 ALTER)
+-- 2. relationship_types.capability_role → default_role (已在 DDL 中 ALTER)
+
+-- ============================================================
+-- 数据迁移: children → family_members + roleOverride 变更
+-- 执行时机: Phase 9(所有代码变更完成后、上线前)
+-- ============================================================
+
+-- 1. family_members 已包含所有必要字段(role_override, 孩子专属字段已在 DDL 中)
+-- relationship_types.capability_role → default_role 已在 DDL 中 ALTER
+
+-- 2. 迁移 children 数据到 family_members(匹配更新:family_members 已存在该成员记录时更新)
+UPDATE family_members fm
+INNER JOIN children c ON fm.family_id = c.family_id AND fm.nickname = c.nickname AND fm.user_id = c.user_id
+SET
+    fm.id_card = c.id_card,
+    fm.penalty_enabled = c.penalty_enabled,
+    fm.theme = c.theme,
+    fm.system_points = c.system_points,
+    fm.streak_days = c.streak_days,
+    fm.last_task_date = c.last_task_date,
+    fm.focus_max_daily = c.focus_max_daily,
+    fm.focus_remaining = c.focus_remaining,
+    fm.focus_reset_date = c.focus_reset_date,
+    fm.total_points = c.total_points,
+    fm.show_to_family = c.show_to_family,
+    fm.birthday = c.birthday,
+    fm.gender = c.gender,
+    fm.phone = c.phone,
+    fm.role_override = 'child';
+
+-- 3. 迁移 children 数据到 family_members(不匹配则插入新记录)
+INSERT INTO family_members (family_id, user_id, nickname, birthday, gender, phone,
+  id_card, penalty_enabled, theme, system_points, streak_days, last_task_date,
+  focus_max_daily, focus_remaining, focus_reset_date, show_to_family, total_points,
+  role_override, created_at, updated_at)
+SELECT family_id, user_id, nickname, birthday, gender, phone,
+  id_card, penalty_enabled, theme, system_points, streak_days, last_task_date,
+  focus_max_daily, focus_remaining, focus_reset_date, show_to_family, total_points,
+  'child', created_at, updated_at
+FROM children
+WHERE NOT EXISTS (
+    SELECT 1 FROM family_members fm2
+    WHERE fm2.family_id = children.family_id
+      AND fm2.nickname = children.nickname
+      AND fm2.user_id = children.user_id
+);
+
+-- 4. 插入 system_config 初始数据
+INSERT INTO system_config (config_key, config_value, description) VALUES
+  ('child_age_threshold', '18', '未成年年龄分界线(岁)'),
+  ('elderly_age_threshold', '65', '老年年龄分界线(岁)')
+ON DUPLICATE KEY UPDATE config_value = VALUES(config_value);
+
+-- 5. 删除 children 表(最后执行,确认迁移完成后再执行此步)
+-- DROP TABLE IF EXISTS children;
+
+-- ============================================================
+-- 购物车表
+-- ============================================================
+CREATE TABLE IF NOT EXISTS cart (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    user_id BIGINT NOT NULL COMMENT '用户ID',
+    product_id BIGINT NOT NULL COMMENT '商品ID',
+    quantity INT NOT NULL DEFAULT 1 COMMENT '数量',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    INDEX idx_user_product (user_id, product_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='购物车';
+
+-- ============================================================
+-- 供应商销售体系
+-- ============================================================
+
+CREATE TABLE IF NOT EXISTS supply_system (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    name VARCHAR(100) NOT NULL COMMENT '体系名称',
+    admin_id BIGINT NOT NULL COMMENT '管理员用户ID',
+    settlement_period_days INT NOT NULL DEFAULT 30 COMMENT '账期(天)',
+    platform_profit_rate DECIMAL(5,2) NOT NULL DEFAULT 0 COMMENT '平台留利比例(%)',
+    description TEXT COMMENT '描述',
+    status VARCHAR(20) NOT NULL DEFAULT 'active' COMMENT '状态: active/disabled',
+    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    KEY idx_admin_id (admin_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='供应商体系';
+
+CREATE TABLE IF NOT EXISTS supply_system_member (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    system_id BIGINT NOT NULL COMMENT '体系ID',
+    user_id BIGINT NOT NULL COMMENT '用户ID',
+    role VARCHAR(20) NOT NULL DEFAULT 'member' COMMENT '角色: admin/member',
+    status VARCHAR(20) NOT NULL DEFAULT 'active' COMMENT '状态: active/inactive',
+    joined_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    UNIQUE KEY uk_system_user (system_id, user_id),
+    KEY idx_user_id (user_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='体系成员';
+
+CREATE TABLE IF NOT EXISTS supply_settlement (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    system_id BIGINT NOT NULL COMMENT '体系ID',
+    period_start DATE NOT NULL COMMENT '结算周期开始',
+    period_end DATE NOT NULL COMMENT '结算周期结束',
+    total_sales INT NOT NULL DEFAULT 0 COMMENT '销售总额(分)',
+    platform_profit INT NOT NULL DEFAULT 0 COMMENT '平台留利金额(分)',
+    supplier_payout INT NOT NULL DEFAULT 0 COMMENT '供应商实付(分)',
+    status VARCHAR(20) NOT NULL DEFAULT 'pending' COMMENT '状态: pending/settled',
+    settled_at DATETIME COMMENT '结算时间',
+    remark TEXT COMMENT '备注',
+    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    KEY idx_system_id (system_id),
+    KEY idx_period (period_start, period_end)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='结算记录';
+
+CREATE TABLE IF NOT EXISTS supply_settlement_detail (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    settlement_id BIGINT NOT NULL COMMENT '结算ID',
+    order_id BIGINT NOT NULL COMMENT '订单ID',
+    order_no VARCHAR(64) NOT NULL COMMENT '订单号',
+    product_name VARCHAR(200) NOT NULL COMMENT '商品名称',
+    amount INT NOT NULL COMMENT '订单金额(分)',
+    platform_fee INT NOT NULL COMMENT '平台留利(分)',
+    supplier_id BIGINT COMMENT '收款供应商用户ID',
+    supplier_name VARCHAR(100) COMMENT '收款供应商名称',
+    payout INT NOT NULL COMMENT '供应商实付(分)',
+    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    KEY idx_settlement_id (settlement_id),
+    KEY idx_order_id (order_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='结算明细';
+
+-- =============================================
+-- 收货人与购买信息采集
+-- =============================================
+
+CREATE TABLE IF NOT EXISTS consignees (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    user_id BIGINT NOT NULL COMMENT '所属用户ID',
+    name VARCHAR(100) NOT NULL COMMENT '收货人姓名',
+    phone VARCHAR(20) COMMENT '手机号',
+    id_card VARCHAR(20) COMMENT '身份证号',
+    hand_signature TEXT COMMENT '手签名(base64图片或URL)',
+    ethnicity VARCHAR(20) COMMENT '民族',
+    blood_type VARCHAR(20) COMMENT '血型',
+    address VARCHAR(500) COMMENT '收货地址',
+    is_default TINYINT(1) DEFAULT 0 COMMENT '是否默认收货人',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+    INDEX idx_user_id (user_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='收货人信息(含购买所需特殊信息)';
+
+CREATE TABLE IF NOT EXISTS product_purchase_fields (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT '主键ID',
+    product_id BIGINT NOT NULL COMMENT '商品ID',
+    field_key VARCHAR(50) NOT NULL COMMENT '字段标识: name/phone/id_card/hand_signature/ethnicity/blood_type',
+    field_name VARCHAR(100) NOT NULL COMMENT '显示名: 收货人姓名/手机号/身份证号/手签名/民族/血型',
+    is_required TINYINT(1) DEFAULT 1 COMMENT '是否必填 1=是 0=否',
+    sort_order INT DEFAULT 0 COMMENT '排序',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    INDEX idx_product_id (product_id),
+    UNIQUE KEY uk_product_field (product_id, field_key)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='商品购买信息字段配置';
+
+-- AI管家会话表
+CREATE TABLE IF NOT EXISTS butler_sessions (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    user_id BIGINT NOT NULL COMMENT '用户ID',
+    title VARCHAR(200) DEFAULT '新会话' COMMENT '会话标题',
+    conversation_id VARCHAR(100) COMMENT 'Dify对话ID',
+    context TEXT COMMENT '上下文信息(JSON)',
+    status VARCHAR(20) DEFAULT 'active' COMMENT '状态: active(进行中)/archived(已归档)',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    INDEX idx_user_id (user_id),
+    INDEX idx_status (status),
+    INDEX idx_user_status (user_id, status)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='AI管家会话表';
+
+-- 家庭订阅记录
+CREATE TABLE IF NOT EXISTS member_subscription (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    family_id BIGINT NOT NULL COMMENT '家庭ID',
+    `level` VARCHAR(10) NOT NULL DEFAULT 'L1' COMMENT 'L1=一生一世, L2=久久一生',
+    status VARCHAR(20) NOT NULL DEFAULT 'active' COMMENT 'active/expired/cancelled',
+    start_time DATETIME DEFAULT NULL COMMENT '开始时间',
+    expire_time DATETIME DEFAULT NULL COMMENT '到期时间',
+    payment_id BIGINT DEFAULT NULL COMMENT '关联订单ID',
+    auto_renew TINYINT(1) DEFAULT 0 COMMENT '自动续费(L2)',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    INDEX idx_family_id (family_id),
+    INDEX idx_status (status),
+    INDEX idx_expire_time (expire_time)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='家庭订阅记录';
+
+-- 订阅订单
+CREATE TABLE IF NOT EXISTS member_subscription_order (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    family_id BIGINT NOT NULL COMMENT '家庭ID',
+    `level` VARCHAR(10) NOT NULL COMMENT 'L1/L2',
+    amount INT NOT NULL COMMENT '金额(分)',
+    status VARCHAR(20) NOT NULL DEFAULT 'pending' COMMENT 'pending/paid/cancelled/refunded',
+    payment_type VARCHAR(20) DEFAULT NULL COMMENT '支付方式 wechat/alipay',
+    transaction_id VARCHAR(64) DEFAULT NULL COMMENT '微信支付订单号',
+    order_no VARCHAR(64) NOT NULL COMMENT '订单号',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    paid_at DATETIME DEFAULT NULL,
+    UNIQUE KEY uk_order_no (order_no),
+    INDEX idx_family_id (family_id),
+    INDEX idx_status (status)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='订阅订单';
+
+-- 权益使用日志
+CREATE TABLE IF NOT EXISTS subscription_benefit_log (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    subscription_id BIGINT NOT NULL COMMENT '订阅ID',
+    benefit_code VARCHAR(50) NOT NULL COMMENT '权益代码',
+    used_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    detail TEXT COMMENT '使用详情(JSON)',
+    INDEX idx_subscription_id (subscription_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='权益使用日志';
+
+-- 推广等级 R0-R4
+CREATE TABLE IF NOT EXISTS promotion_tier (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    user_id BIGINT NOT NULL COMMENT '用户ID',
+    tier VARCHAR(20) NOT NULL DEFAULT 'R0' COMMENT 'R0利他者/R1传福人/R2聚能师/R3启慧者/R4传承者',
+    team_size_1st INT DEFAULT 0 COMMENT '一层团队人数',
+    team_size_2nd INT DEFAULT 0 COMMENT '二层团队人数',
+    team_size_3rd INT DEFAULT 0 COMMENT '三层团队人数',
+    total_team_size INT DEFAULT 0 COMMENT '三层累计总人数',
+    total_referral_earnings INT DEFAULT 0 COMMENT '累计推荐佣金(分)',
+    total_share_earnings INT DEFAULT 0 COMMENT '累计消费返利(分)',
+    promoted_at DATETIME DEFAULT NULL COMMENT '最近晋级时间',
+    last_change_at DATETIME DEFAULT NULL COMMENT '最后变更时间',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    UNIQUE KEY uk_user_id (user_id),
+    INDEX idx_tier (tier)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='推广等级';
+
+-- 推广等级变更记录
+CREATE TABLE IF NOT EXISTS promotion_tier_change_log (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    user_id BIGINT NOT NULL COMMENT '用户ID',
+    old_tier VARCHAR(20) DEFAULT NULL COMMENT '变更前等级',
+    new_tier VARCHAR(20) NOT NULL COMMENT '变更后等级',
+    reason VARCHAR(50) DEFAULT NULL COMMENT 'qualify升级/demote降级/admin管理员调整',
+    changed_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    INDEX idx_user_id (user_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='推广等级变更记录';
+
+-- 推荐关系树(三层)
+CREATE TABLE IF NOT EXISTS referral_tree (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    parent_id BIGINT NOT NULL COMMENT '推荐人ID',
+    child_id BIGINT NOT NULL COMMENT '被推荐人ID',
+    level INT NOT NULL COMMENT '层级深度(1/2/3)',
+    path VARCHAR(255) DEFAULT NULL COMMENT 'materialized path如/1/2/3/',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    UNIQUE KEY uk_child_id (child_id),
+    INDEX idx_parent_id (parent_id),
+    INDEX idx_level (level)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='推荐关系树';
+
+-- 产品P点配置
+CREATE TABLE IF NOT EXISTS product_ppoint (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    product_id BIGINT NOT NULL COMMENT '产品ID',
+    ppoint INT NOT NULL DEFAULT 0 COMMENT 'P点值(平台利润分)',
+    start_date DATE DEFAULT NULL COMMENT '生效日期',
+    end_date DATE DEFAULT NULL COMMENT '失效日期',
+    created_by BIGINT DEFAULT NULL COMMENT '创建人',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    INDEX idx_product_id (product_id),
+    INDEX idx_dates (start_date, end_date)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='产品P点配置';
+
+-- 测评商品扩展信息
+CREATE TABLE IF NOT EXISTS assessment_products (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    product_id BIGINT NOT NULL COMMENT '关联products表',
+    assessment_type VARCHAR(20) NOT NULL COMMENT 'single=单包, bundle=套餐',
+    total_sessions INT NOT NULL DEFAULT 1 COMMENT '包含测评次数',
+    validity_days INT NOT NULL DEFAULT 365 COMMENT '有效期(天)',
+    guide_scope VARCHAR(50) DEFAULT 'all' COMMENT '规划师范围: all/assigned/auto',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    INDEX idx_product_id (product_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='测评商品扩展信息';
+
+-- 测评额度表
+CREATE TABLE IF NOT EXISTS assessment_quotas (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    quota_no VARCHAR(32) NOT NULL COMMENT '额度编号',
+    family_id BIGINT NOT NULL COMMENT '家庭ID',
+    child_id BIGINT COMMENT '指定孩子ID(NULL=不限)',
+    product_order_id BIGINT NOT NULL COMMENT '来源订单ID',
+    product_id BIGINT NOT NULL COMMENT '商品ID',
+    product_name VARCHAR(100) NOT NULL COMMENT '商品名快照',
+    total_sessions INT NOT NULL DEFAULT 1 COMMENT '总次数',
+    remaining_sessions INT NOT NULL DEFAULT 1 COMMENT '剩余次数',
+    validity_start DATETIME NOT NULL COMMENT '有效期开始',
+    validity_end DATETIME NOT NULL COMMENT '有效期截止',
+    status VARCHAR(20) NOT NULL DEFAULT 'active' COMMENT 'active/expired/used_all/cancelled',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    INDEX idx_family (family_id),
+    INDEX idx_order (product_order_id),
+    UNIQUE KEY uk_quota_no (quota_no)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='测评额度表';
+
+-- 测评执行记录表
+CREATE TABLE IF NOT EXISTS assessment_executions (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    quota_id BIGINT NOT NULL COMMENT '关联额度ID',
+    child_id BIGINT NOT NULL COMMENT '被测评孩子',
+    guide_id BIGINT COMMENT '执行规划师ID',
+    assessment_type VARCHAR(30) COMMENT '本次具体测评类型',
+    appointment_id BIGINT COMMENT '关联预约ID',
+    result_id BIGINT COMMENT '关联测评结果ID',
+    status VARCHAR(20) NOT NULL DEFAULT 'pending' COMMENT 'pending/in_progress/completed/cancelled',
+    scheduled_date DATETIME COMMENT '预约执行时间',
+    completed_at DATETIME COMMENT '实际完成时间',
+    notes VARCHAR(500) COMMENT '备注',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    INDEX idx_quota (quota_id),
+    INDEX idx_child (child_id),
+    INDEX idx_appointment (appointment_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='测评执行记录表';
+
+-- 测评指导意见表(结构化存储)
+CREATE TABLE IF NOT EXISTS growth_guidances (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    result_id BIGINT NOT NULL COMMENT '关联测评结果ID',
+    dimension VARCHAR(30) NOT NULL COMMENT '维度: attention/focus/memory/logic/emotion/general',
+    score INT COMMENT '该维度得分(0-100)',
+    suggestion TEXT NOT NULL COMMENT '建议内容',
+    priority INT DEFAULT 0 COMMENT '优先级(0=普通, 1=重要, 2=紧急)',
+    sort_order INT DEFAULT 0 COMMENT '排序',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    INDEX idx_result (result_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='测评指导意见(结构化)';
+
+-- 方案生成规则表
+CREATE TABLE IF NOT EXISTS assessment_plan_rules (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    dimension VARCHAR(30) NOT NULL COMMENT '测评维度: attention/focus/memory/logic/emotion',
+    score_min INT NOT NULL COMMENT '分数下限(含)',
+    score_max INT NOT NULL COMMENT '分数上限(含)',
+    template_id BIGINT NOT NULL COMMENT '关联TaskTemplatePackage ID',
+    priority INT DEFAULT 0 COMMENT '优先级',
+    is_active TINYINT(1) DEFAULT 1 COMMENT '是否启用',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    INDEX idx_dimension (dimension),
+    INDEX idx_score (score_min, score_max)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='方案生成规则';
+
+-- 家庭访问安全日志表
+CREATE TABLE IF NOT EXISTS family_access_logs (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    user_id BIGINT NOT NULL COMMENT '访问方用户ID',
+    family_id BIGINT NOT NULL COMMENT '被访问的家庭ID',
+    request_uri VARCHAR(500) NOT NULL COMMENT '请求路径',
+    request_method VARCHAR(10) NOT NULL,
+    access_type VARCHAR(20) NOT NULL COMMENT 'check_type: query/path/body',
+    result VARCHAR(10) NOT NULL COMMENT 'allowed/denied/log_only',
+    client_ip VARCHAR(50),
+    user_agent VARCHAR(500),
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    INDEX idx_user_time (user_id, created_at),
+    INDEX idx_family_time (family_id, created_at)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='家庭访问安全日志';
+
+-- 五维能量分数历史记录表
+CREATE TABLE IF NOT EXISTS five_dimension_scores (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    member_id BIGINT NOT NULL COMMENT '成员ID(user或family_member)',
+    member_type VARCHAR(20) NOT NULL COMMENT '成员类型: user/member',
+    family_id BIGINT NOT NULL COMMENT '家庭ID',
+    dimension_code VARCHAR(20) NOT NULL COMMENT '维度编码: body/mind/wisdom/action/wealth',
+    score INT NOT NULL COMMENT '分数(0-100)',
+    assessed_at DATETIME NOT NULL COMMENT '评估时间',
+    source_type VARCHAR(50) COMMENT '来源类型: periodic/task/assessment/manual',
+    source_id BIGINT COMMENT '来源记录ID',
+    detail_json TEXT COMMENT '详细数据JSON',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    INDEX idx_member_dim (member_id, member_type, dimension_code),
+    INDEX idx_family_time (family_id, assessed_at),
+    INDEX idx_source (source_type, source_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='五维能量分数历史记录';
+
+-- 家庭邀请令牌表
+CREATE TABLE IF NOT EXISTS family_invitations (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    family_id BIGINT NOT NULL COMMENT '家庭ID',
+    token VARCHAR(64) NOT NULL UNIQUE COMMENT '邀请令牌(UUID)',
+    created_by BIGINT NOT NULL COMMENT '创建人用户ID',
+    status VARCHAR(16) DEFAULT 'active' COMMENT '状态: active/used/expired/revoked',
+    expires_at DATETIME COMMENT '过期时间',
+    max_use_count INT DEFAULT 1 COMMENT '最大使用次数',
+    used_count INT DEFAULT 0 COMMENT '已使用次数',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    INDEX idx_family_id (family_id),
+    INDEX idx_token (token),
+    INDEX idx_status (status)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='家庭邀请令牌';
+
+-- 规划师绑定家庭申请表
+CREATE TABLE IF NOT EXISTS teacher_family_binding_requests (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    teacher_id BIGINT NOT NULL COMMENT '规划师用户ID',
+    family_id BIGINT NOT NULL COMMENT '家庭ID',
+    invitation_token VARCHAR(128) COMMENT '关联邀请码/令牌',
+    status VARCHAR(20) NOT NULL DEFAULT 'pending' COMMENT 'pending/approved/rejected/cancelled',
+    requested_at DATETIME COMMENT '申请时间',
+    decided_by BIGINT COMMENT '审批人用户ID',
+    decided_at DATETIME COMMENT '审批时间',
+    reject_reason VARCHAR(200) COMMENT '拒绝原因',
+    message VARCHAR(500) COMMENT '申请留言',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    UNIQUE KEY uk_teacher_family (teacher_id, family_id),
+    INDEX idx_family_status (family_id, status)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='规划师绑定家庭申请表';
+
+-- Dify会话本地镜像表
+CREATE TABLE IF NOT EXISTS chat_conversations (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    user_id BIGINT NOT NULL,
+    dify_conversation_id VARCHAR(64),
+    assistant_type VARCHAR(32) COMMENT 'family/nutrition/tongue',
+    title VARCHAR(200),
+    last_message_at DATETIME,
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    UNIQUE KEY uk_dify_conv (dify_conversation_id),
+    INDEX idx_user (user_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='Dify会话本地镜像';
+
+CREATE TABLE IF NOT EXISTS chat_messages (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    conversation_id BIGINT NOT NULL,
+    dify_message_id VARCHAR(64),
+    role VARCHAR(20) NOT NULL COMMENT 'user/assistant',
+    content TEXT NOT NULL,
+    inputs_json TEXT,
+    metadata TEXT,
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    INDEX idx_conv (conversation_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='Dify消息本地镜像';
+
+-- 迁移版本追踪表
+CREATE TABLE IF NOT EXISTS schema_versions (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    version_code VARCHAR(64) NOT NULL UNIQUE,
+    description VARCHAR(500),
+    checksum VARCHAR(64),
+    applied_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    applied_by VARCHAR(100)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='迁移版本追踪表';
+
+-- 待退款记录表
+CREATE TABLE IF NOT EXISTS pending_refund (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    user_id BIGINT NOT NULL COMMENT '用户ID',
+    withdrawal_request_id BIGINT COMMENT '提现申请ID',
+    amount INT NOT NULL COMMENT '退款金额(分)',
+    attempt_count INT DEFAULT 0 COMMENT '当前尝试次数',
+    max_attempts INT DEFAULT 10 COMMENT '最大重试次数',
+    next_retry_time DATETIME COMMENT '下次重试时间',
+    status VARCHAR(20) DEFAULT 'pending' COMMENT '状态: pending/processing/success/failed',
+    failure_reason VARCHAR(500) COMMENT '失败原因',
+    refunded_amount INT COMMENT '实际退款金额(分)',
+    refunded_at DATETIME COMMENT '退款时间',
+    remark VARCHAR(500) COMMENT '备注',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    INDEX idx_user_id (user_id),
+    INDEX idx_status (status),
+    INDEX idx_next_retry (next_retry_time),
+    INDEX idx_withdrawal_request (withdrawal_request_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='待退款记录表';

+ 1337 - 0
docs/系统设计/家庭天盘设计方案.md

@@ -0,0 +1,1337 @@
+# 家庭天盘设计方案
+
+> **版本**: v1.0
+> **日期**: 2026-07-10
+> **状态**: 设计完成,待开发
+> **范围**: 小程序为主平台,后端聚合 API,整合现有传统命理数据
+> **性质**: 交接文档 — 可直接交给开发团队执行
+
+---
+
+## 目录
+
+1. [概念定义](#一概念定义)
+2. [现状盘点与可复用资产](#二现状盘点与可复用资产)
+3. [信息架构与数据源映射](#三信息架构与数据源映射)
+4. [后端 API 接口设计](#四后端-api-接口设计)
+5. [数据库增量设计](#五数据库增量设计)
+6. [小程序页面结构与组件设计](#六小程序页面结构与组件设计)
+7. [天盘可视化设计](#七天盘可视化设计)
+8. [交互设计](#八交互设计)
+9. [前端状态管理](#九前端状态管理)
+10. [开发任务拆解](#十开发任务拆解)
+11. [技术选型与风险点](#十一技术选型与风险点)
+12. [测试策略](#十二测试策略)
+
+---
+
+## 一、概念定义
+
+### 1.1 什么是「家庭天盘」
+
+家庭天盘是浠艾福(Care Family)小程序端的家庭命理全景可视化功能。它借鉴传统星盘/罗盘的辐射式布局,将家庭成员的**星座、生命密码(数字能量)、八字四柱、五行能量**等命理信息,以一种直观的盘面形式呈现,并叠加**家庭关系、近期关注事宜、流年运势**三层动态信息。
+
+### 1.2 核心价值主张
+
+| 维度 | 价值 |
+|------|------|
+| **认知** | 让家长一键看见全家命理全貌,理解每个家人的先天特质 |
+| **关系** | 揭示家庭成员间的命理契合度,用传统文化视角解读关系质量 |
+| **行动** | 基于命理+运势给出具体可行的「宜/忌」建议,落到家庭任务和沟通行动上 |
+| **传承** | 将传统命理文化以现代可视化形式呈现,让家庭文化传承可视化 |
+
+### 1.3 天盘的三层信息结构
+
+```
+┌─────────────────────────────────────────────────────────┐
+│                    外层: 关注事宜 (动态)                    │
+│  近期任务 │ 测评待办 │ 关系健康预警 │ 里程碑 │ 流年运势       │
+├─────────────────────────────────────────────────────────┤
+│                  中层: 家庭关系网络 (关联)                   │
+│     成员间的命理契合度连线、辈分关系、强弱互补分析               │
+├─────────────────────────────────────────────────────────┤
+│                  内层: 成员命理画像 (静态)                    │
+│  星座 │ 生命密码 │ 八字四柱 │ 五行能量 │ 先天心/智基础分        │
+└─────────────────────────────────────────────────────────┘
+```
+
+### 1.4 与现有「传统文化镜」的关系(推荐方案:整合提升)
+
+代码库中**已存在**`TraditionalMirrorController`(`/api/mind/traditional/*`)提供 `mirror`(单人命理)、`family-dashboard`(家庭天盘数据)、`compatibility`(兼容性)接口。后台日志直呼"获取家庭天盘数据失败"。
+
+**推荐策略:整合提升,而非废弃重写。**
+
+| 现有接口 | 处理方式 | 原因 |
+|---------|---------|------|
+| `POST /api/mind/traditional/mirror` | **保留** | 单人详情仍需要,天盘点击成员时复用 |
+| `POST /api/mind/traditional/family-dashboard` | **包装升级** | `CompatibilityService.getFamilyDashboard` 底层逻辑保留,新建 `TianpanController` 聚合增强 |
+| `POST /api/mind/traditional/compatibility` | **保留** | 两两兼容性仍独立可用 |
+
+新建 `TianpanController`(`/api/tianpan/*`)作为天盘功能的**统一入口**,内部调用 `CompatibilityService` + `FamilyMemberAttributeService` + `ZodiacAnnualEnergyService` + `RelationshipQualityService` + 能量/任务等服务,对外提供聚合 Response。`TraditionalMirrorController` 保留作为旧入口兼容(逐步引导前端迁移到新接口)。
+
+---
+
+## 二、现状盘点与可复用资产
+
+### 2.1 已有后端基础设施
+
+| 模块 | 路径 | 状态 | 天盘复用方式 |
+|------|------|------|-------------|
+| `TraditionalMirrorController` | `controller/mind/` | ✅ 已有 | 旧 `/mirror` 单人、`/family-dashboard`、`/compatibility` |
+| `CompatibilityService.getFamilyDashboard()` | `service/` | ✅ 已有 | 聚合成员+五行+关系+周洞察,天盘主体数据源 |
+| `CompatibilityService.buildMemberTradition()` | `service/` | ✅ 已有 | 单成员命理 VO 构建(八个字段) |
+| `CompatibilityService.aggregateWuxing()` | `service/` | ✅ 已有 | 家庭五行聚合,含最强/最弱/均衡成员分析 |
+| `CompatibilityService.computeRelationshipSummary()` | `service/` | ✅ 已有 | 两两关系综合评分 |
+| `FamilyMemberAttributeService` | `service/` | ✅ 已有 | 命理属性读写 |
+| `FamilyMemberAttributeService.getWuxingReading()` | `service/` | ✅ 已有 | 五行强弱→解读模板匹配 |
+| `ZodiacAnnualEnergyService` | `service/` | ✅ 已有 | 生肖年度能量+流年木星相位 |
+| `ZodiacConfigService` / `BaziConfigService` | `service/` | ✅ 已有 | 生肖/八字配置管理 |
+| `RelationshipQualityService` | `service/` | ✅ 已有 | 关系评分、健康预警、里程碑 |
+| `EnergyService` | `service/` | ✅ 已有 | 五维能量(身/智/富/行/心)发放与维度查询 |
+
+### 2.2 已有数据实体与字段
+
+#### `FamilyMemberAttributes`(命理主表)
+
+| 字段 | 用途 | 天盘是否需要 |
+|------|------|---------|
+| `birthDatetime` 出生日期(精确到分钟) | 八字排盘 | ✅ 必需 |
+| `eightCharacters` 八字四柱JSON | 内层命理 | ✅ 必需 |
+| `wuxingElements` 五行元素JSON | 内层命理+关系 | ✅ 必需 |
+| `zodiac` 生肖 | 内层命理 | ✅ 必需 |
+| `bloodType` 血型 | 关系兼容性 | ✅ 必需 |
+| `mindBaseScore` 心维度基础分 | 内层命理 | ✅ 必需 |
+| `wisdomBaseScore` 智维度基础分 | 内层命理 | ✅ 必需 |
+| `behaviorModifier` 行为修正(含lifeNumber) | 生命密码 | ✅ 必需 |
+
+#### `ZodiacConfig` 星座/生肖配置
+
+字段:`zodiacCode`, `zodiacName`, `element`, `startMonth/Day`, `endMonth/Day`, 基础分与修正因子映射到五维(心/智/身/行/富)。
+
+#### `BaziConfig` 八字配置
+
+字段:`stemOrBranch`, `type`, `element`, `yinYang`, 心/智/身/行/富基础与修正。
+
+#### `NumSoulConfig` 生命密码配置
+
+字段:`number` 1-9、`title` 称号、`keywords` 性格关键词、`mindGrowthAdvice`、`colorHex` 代表色。
+
+#### `BaziReadingTemplate` 五行解读模板
+
+字段:`element`、`condition` (strong/weak/balanced)、`personalTrait`、`mindGrowthAdvice`、`dailyTipTemplate` 每日宜忌模板。
+
+### 2.3 已有 DTO(天盘 Response 设计基础)
+
+#### `FamilyDashboardVO`(天盘主体)
+
+```
+familyId, familyName,
+members: List<FamilyMemberTraditionVO>,
+familyWuxing: FamilyWuxingVO,
+relationships: List<RelationshipSummaryVO>,
+weeklyInsight: String
+```
+
+#### `FamilyMemberTraditionVO`(成员命理)
+
+```
+memberId, nickname, memberType,
+zodiac, bloodType, lifeNumber,
+eightCharacters: {year, month, day, hour},
+wuxingElements: {wood, fire, earth, metal, water},
+mindBaseScore, wisdomBaseScore
+```
+
+> **缺失**: 无西方星座(Sun Sign)、无代表性色(colorHex)、无头像/角色信息,需要扩展。
+
+#### `FamilyWuxingVO`(家庭五行聚合)
+
+```
+aggregatePercentages: {wood, fire, earth, metal, water},
+strongestElement, weakestElement,
+balancedMemberName, analysis
+```
+
+#### `RelationshipSummaryVO`(两两关系)
+
+```
+memberId1, nickname1, memberId2, nickname2,
+overallScore, pairingType, summary,
+zodiacPairingType, zodiacScore
+```
+
+> **缺失**: 无五行互补/WuxingComplementarity、无血型/BloodTypeCompatibility、无生命密码/LifeNumberRelationship(这些在 `CompatibilityResultVO` 有,但 `RelationshipSummaryVO` 没有),天盘关系层需要补全。
+
+#### `CompatibilityResultVO`(完整兼容性)
+
+```
+member1, member2, zodiac, wuxing, bloodType, lifeNumber,
+overallScore, overallAdvice
+```
+
+### 2.4 前端现状
+
+- 小程序无「天盘」页面
+- 已有 `wuxing-sandbox` 组件(五行沙盘游戏化组件),可参考其 Canvas 绘制风格
+- `pages.json` TabBar 为「行/身/智/心/富」五行相生排列
+- 设计 Token 体系见 `uni.scss`(暖橙主色、暖白背景)
+
+### 2.5 前端限制(必须遵守)
+
+- ❌ 禁止可选链 `?.`(用 `&&` 替代)
+- ❌ 禁止 CSS Grid(用 flexbox)
+- ✅ Vue 2 Options API,禁止 Composition API
+- ❌ 禁止引入大型库(D3/ECharts),天盘用 Canvas 2D 原生绘制
+
+---
+
+## 三、信息架构与数据源映射
+
+### 3.1 天盘三层信息架构详表
+
+| 层 | 信息项 | 数据源后端服务 | 字段映射 |
+|----|-------|--------------|---------|
+| **内层-命理画像** | 生辰八字 | `FamilyMemberAttributes.birthDatetime` + 八字排盘 | `eightCharacters` JSON |
+| | 八字四柱 | `FamilyMemberAttributes.eightCharacters` | `{year, month, day, hour}` |
+| | 五行能量 | `FamilyMemberAttributes.wuxingElements` | `{wood, fire, earth, metal, water}` |
+| | 生肖 | `FamilyMemberAttributes.zodiac` + `ZodiacConfig` | `zodiacCode/zodiacName/element` |
+| | 西方星座 | 🆕 由 `birthDatetime` 计算(复用 `ZodiacAnnualEnergyService.findWesternSign`) | `westernSign` |
+| | 生命密码 | `FamilyMemberAttributes.behaviorModifier.lifeNumber` + `NumSoulConfig` | `number/title/keywords/colorHex` |
+| | 心/智先天基础分 | `FamilyMemberAttributes.mindBaseScore/wisdomBaseScore` | 整数 0-100 |
+| | 代表色 | `NumSoulConfig.colorHex` | 十六进制 |
+| | 五行解读 | `FamilyMemberAttributeService.getWuxingReading()` | `BaziReadingTemplate` |
+| | 头像/昵称 | `FamilyMember` | `nickname` + 头像 URL |
+| | 辈分 | `FamilyMember.generation` | -1/0/1/2 |
+| **中层-关系网络** | 两两综合评分 | `CompatibilityService.computeRelationshipSummary()` | `overallScore` |
+| | 生肖配对型 | 同上 | `zodiacPairingType/zodiacScore` |
+| | 五行互补 | 🆕 调用 `CompatibilityService` 内部完成(需补字段) | `wuxingComplementarity` |
+| | 血型兼容 | 🆕 同上补全 | `bloodTypeCompatibility` |
+| | 生命密码关系 | 🆕 同上补全 | `lifeNumberRelationship` |
+| | 辈分关系标签 | `FamilyRelationshipService.computeRelationshipLabel()` | 父/母/子/女/兄/弟 |
+| | 关系健康评分 | `RelationshipQualityService.getScores()` | `RelationshipScoreVO` |
+| **外层-关注事宜** | 近期任务 | `TaskService`(按 memberId 筛待办) | 任务列表 |
+| | 测评待办 | `AssessmentOrderService`(按 familyId/childId 筛 pending) | 测评预约 |
+| | 关系健康预警 | `RelationshipQualityService.getHealthAlerts()` | `HealthAlertVO` |
+| | 里程碑 | `RelationshipQualityService.getMilestones()` | `MilestoneVO` |
+| | 流年运势 | `ZodiacAnnualEnergyService.calculate()` | `AnnualEnergyResult` |
+| | 五维能量状态 | `EnergyService`(按 userId/memberId 聚合) | 维度分数 |
+| | AI 周洞察 | `CompatibilityService.generateWeeklyInsight()` 已有 / 🆕 调用 Dify 增强 | `weeklyInsight` |
+| | 每日宜忌 | 🆕 基于家庭五行+流年生成 | `dailyFortune` |
+
+### 3.2 数据聚合关系
+
+```
+TianpanController.getTianpan(familyId)
+    │
+    ├─→ CompatibilityService.getFamilyDashboard(familyId)  [已有的核心]
+    │      ├─→ FamilyMember 列表
+    │      ├─→ buildMemberTradition() → FamilyMemberAttributes
+    │      ├─→ aggregateWuxing() → FamilyWuxingVO
+    │      ├─→ computeRelationshipSummary() × N²
+    │      └─→ generateWeeklyInsight()
+    │
+    ├─→ 🆕 TianpanService.enrichDashboard(dashboard)
+    │      ├─→ 补西方星座(findWesternSign)
+    │      ├─→ 补 NumSoulConfig(colorHex/title/keywords)
+    │      ├─→ 补头像/辈分信息(FamilyMember)
+    │      └─→ 补五行解读(getWuxingReading)
+    │
+    ├─→ 🆕 TianpanService.buildRelatedItems(familyId)
+    │      ├─→ TaskService → 近期待办
+    │      ├─→ AssessmentOrderService → 测评待办
+    │      ├─→ RelationshipQualityService.getHealthAlerts()
+    │      ├─→ RelationshipQualityService.getMilestones(daysAhead=7)
+    │      └─→ EnergyService → 各成员五维能量聚合
+    │
+    ├─→ 🆕 TianpanService.buildAnnualEnergy(familyId, year)
+    │      └─→ ZodiacAnnualEnergyService.calculate() × 每个成员
+    │
+    └─→ 🆕 TianpanService.buildDailyFortune(familyId)
+           └─→ 基于家庭五行+当日干支→宜忌建议
+```
+
+### 3.3 角色权限矩阵
+
+| 角色 | 查看自己天盘 | 查看家庭天盘 | 编辑命理 | 编辑关注事宜配置 |
+|------|:-----------:|:-----------:|:-------:|:--------------:|
+| parent | ✅ | ✅ | ✅ | ✅ |
+| child | ✅ | ⚠️ 限部分内容 | ❌ | ❌ |
+| teacher | ❌ | ✅(绑定家庭) | ❌ | ❌ |
+| admin | — | — | ✅(配置) | — |
+
+> child 查看家庭天盘:仅展示成员基础信息+关系,**不展示八字详细四柱**(隐私保护),只展示简化版「我」天盘。
+
+---
+
+## 四、后端 API 接口设计
+
+### 4.1 接口总览
+
+新建 `TianpanController`(`/api/tianpan/*`)作为天盘统一入口,遵循项目约定:统一 `@PostMapping`、`Result<T>` 响应、`@RequestAttribute("userId")` 认证、控制器内手动角色检查。
+
+| 路由 | 方法名 | 返回类型 | 描述 |
+|------|--------|---------|------|
+| `POST /api/tianpan/dashboard` | `dashboard` | `Result<TianpanDashboardVO>` | 天盘主数据(聚合命理+关系+关注事宜) |
+| `POST /api/tianpan/member/{memberId}` | `memberDetail` | `Result<TianpanMemberVO>` | 单成员命理详情(点击盘面成员节点) |
+| `POST /api/tianpan/compatibility` | `compatibility` | `Result<CompatibilityResultVO>` | 两成员详细兼容性(点击关系连线) |
+| `POST /api/tianpan/annual-energy` | `annualEnergy` | `Result<List<MemberAnnualEnergyVO>>` | 全家流年运势(按年切换) |
+| `POST /api/tianpan/daily-fortune` | `dailyFortune` | `Result<DailyFortuneVO>` | 当日宜忌建议 |
+| `POST /api/tianpan/related-items` | `relatedItems` | `Result<RelatedItemsVO>` | 近期关注事宜聚合(任务/测评/预警/里程碑) |
+
+### 4.2 首接口:`POST /api/tianpan/dashboard`
+
+天盘首次加载一次性返回全部主数据,减少多请求往返。
+
+**请求**:
+```json
+{
+  "familyId": 123,
+  "year": 2026,
+  "daysAhead": 7
+}
+```
+
+**响应 `TianpanDashboardVO`**:
+```json
+{
+  "familyId": 123,
+  "familyName": "李氏家庭",
+  "members": [
+    {
+      "memberId": 101,
+      "nickname": "李爸爸",
+      "memberType": "parent",
+      "avatar": "https://...",
+      "generation": 1,
+      "zodiac": "dragon",
+      "zodiacName": "龙",
+      "westernSign": "scorpio",
+      "westernSignName": "天蝎座",
+      "element": "earth",
+      "bloodType": "A",
+      "lifeNumber": 7,
+      "lifeNumberTitle": "真理探求者",
+      "lifeNumberKeywords": "分析/内省/灵性",
+      "colorHex": "#9B59B6",
+      "eightCharacters": {"year":"甲辰","month":"丙寅","day":"戊辰","hour":"壬申"},
+      "wuxingElements": {"wood":30,"fire":15,"earth":45,"metal":25,"water":40},
+      "mindBaseScore": 65,
+      "wisdomBaseScore": 78,
+      "wuxingReading": {
+        "element": "earth",
+        "condition": "strong",
+        "personalTrait": "踏实稳重...",
+        "mindGrowthAdvice": "...",
+        "dailyTipTemplate": "..."
+      },
+      "energySnapshot": {
+        "body": 72, "mind": 65, "wisdom": 78, "action": 60, "wealth": 55
+      }
+    }
+  ],
+  "familyWuxing": {
+    "aggregatePercentages": {"wood":25,"fire":20,"earth":35,"metal":20,"water":25},
+    "strongestElement": "earth",
+    "weakestElement": "fire",
+    "balancedMemberName": "李妈妈",
+    "analysis": "你家土能量最强,火能量偏弱。李妈妈的五行最为均衡,是家庭的稳定器。"
+  },
+  "relationships": [
+    {
+      "memberId1": 101,
+      "nickname1": "李爸爸",
+      "memberId2": 102,
+      "nickname2": "李妈妈",
+      "overallScore": 82,
+      "pairingType": "相生",
+      "summary": "土能量与金能量互补...",
+      "zodiacPairingType": "六合",
+      "zodiacScore": 85,
+      "wuxingComplementarity": {"score": 78, "type": "木火相生"},
+      "bloodTypeCompatibility": {"score": 70, "type": "A+O互补"},
+      "lifeNumberRelationship": {"score": 75, "type": "7与3组合"},
+      "generationLabel": "夫妻",
+      "relationshipQualityScore": 80,
+      "qualityAlert": null
+    }
+  ],
+  "relatedItems": {
+    "pendingTasks": 5,
+    "pendingAssessments": 1,
+    "healthAlerts": [
+      {"type":"conflict_risk","members":["李爸爸","小李"],"severity":"medium","message":"本周关系质量下降..."}
+    ],
+    "upcomingMilestones": [
+      {"type":"birthday","memberName":"小李","date":"2026-07-15","daysAway":5}
+    ]
+  },
+  "annualEnergy": [
+    {"memberId":101,"zodiac":"dragon","year":2026,"overallTrend":"ascending","focusDimension":"mind","summary":"..."},
+    {"memberId":102,"zodiac":"snake","year":2026,"overallTrend":"steady","focusDimension":"body","summary":"..."}
+  ],
+  "dailyFortune": {
+    "date":"2026-07-10",
+    "ganZhi":"丙寅日",
+    "familyAdvice":"今日土能量旺,宜处理家庭实务;火弱需注意情绪表达",
+    "doActions":["家庭会议","整理家务","户外活动"],
+    "avoidActions":["激烈争论","熬夜","冲动消费"],
+    "luckyMembers":["李妈妈"],
+    "focusMember":"小李"
+  },
+  "weeklyInsight": "李爸爸和李妈妈是天生的好搭档,本周可以一起完成一个家庭任务"
+}
+```
+
+### 4.3 单成员详情:`POST /api/tianpan/member/{memberId}`
+
+点击盘面成员节点时展开详情卡。
+
+**请求**: path参数 `memberId`,body `{"memberType":"child"}`
+
+**响应 `TianpanMemberVO`**: 复用 `FamilyDashboardVO.members[]` 单项扩展,增加 `yearPillarDetail`(年柱详析)、`luckyDirection`(吉利方位)、`luckyColor` 等。
+
+### 4.4 关系详情:`POST /api/tianpan/compatibility`
+
+**请求**: `{"memberId1":101,"memberId2":102,"familyId":123}`
+
+**响应**: 复用已有 `CompatibilityResultVO`(已含 zodiac/wuxing/bloodType/lifeNumber + overallScore + overallAdvice),无需新增 DTO。
+
+### 4.5 流年运势切换:`POST /api/tianpan/annual-energy`
+
+**请求**: `{"familyId":123,"year":2027}`
+
+**响应 `List<MemberAnnualEnergyVO>`**:
+```json
+[
+  {
+    "memberId": 101,
+    "nickname": "李爸爸",
+    "zodiac": "dragon",
+    "zodiacName": "龙",
+    "year": 2027,
+    "overallTrend": "ascending",
+    "focusDimension": "mind",
+    "focusDimensionName": "心",
+    "summary": "2027年木星进入...,心能量显著提升...",
+    "monthlyForecast": [
+      {"month":1,"energy":75,"highlight":"开年规划"},
+      {"month":2,"energy":80,"highlight":"..."}
+    ]
+  }
+]
+```
+
+### 4.6 当日宜忌:`POST /api/tianpan/daily-fortune`
+
+**请求**: `{"familyId":123,"date":"2026-07-10"}`(date可空,默认当天)
+
+**响应 `DailyFortuneVO`**: 已在 dashboard 嵌入,也可独立调用切换日期。
+
+### 4.7 关注事宜聚合:`POST /api/tianpan/related-items`
+
+**请求**: `{"familyId":123,"daysAhead":7}`
+
+**响应 `RelatedItemsVO`**:
+```json
+{
+  "pendingTasks": [
+    {"id":1,"title":"完成阅读打卡","assignee":"小李","dueDate":"2026-07-12","priority":"high"},
+    {"id":2,"title":"家庭运动30分钟","assignee":"李爸爸","dueDate":"2026-07-11","priority":"medium"}
+  ],
+  "pendingAssessments": [
+    {"orderId":5,"childName":"小李","status":"paid","appointmentDate":"2026-07-20"}
+  ],
+  "healthAlerts": [],
+  "upcomingMilestones": [
+    {"type":"birthday","memberName":"小李","memberId":103,"date":"2026-07-15","daysAway":5,"description":"小李8岁生日"}
+  ]
+}
+```
+
+### 4.8 接口实现要点
+
+```
+TianpanController
+  ├─ @Resource TianpanService tianpanService
+  ├─ @Resource CompatibilityService compatibilityService  (复用)
+  ├─ @Resource ZodiacAnnualEnergyService zodiacAnnualEnergyService  (复用)
+  ├─ @Resource RelationshipQualityService relationshipQualityService (复用)
+  ├─ @Resource TaskService taskService  (复用)
+  ├─ @Resource AssessmentOrderService assessmentOrderService  (复用)
+  └─ @Resource EnergyService energyService  (复用)
+
+dashboard(familyId, year, daysAhead):
+  1. [复用] CompatibilityService.getFamilyDashboard(familyId) → base
+  2. [新增] TianpanService.enrichMembers(base.members)
+     - 调用 ZodiacAnnualEnergyService.findWesternSign → 西方星座
+     - 调用 FamilyMemberAttributeService.getNumSoulConfig → 生命密码详情
+     - 调用 FamilyMemberAttributeService.getWuxingReading → 五行解读
+     - 查 FamilyMember → 补 avatar/generation
+     - 查 EnergyService → 补能量快照
+  3. [新增] TianpanService.enrichRelationships(base.relationships)
+     - 补 wuxingComplementarity
+     - 补 bloodTypeCompatibility
+     - 补 lifeNumberRelationship
+     - 补 generationLabel(调 FamilyRelationshipService.computeRelationshipLabel)
+     - 补 relationshipQualityScore + qualityAlert(调 RelationshipQualityService)
+  4. [新增] TianpanService.buildRelatedItems(familyId, daysAhead)
+  5. [新增] TianpanService.buildAnnualEnergy(familyId, year)
+  6. [新增] TianpanService.buildDailyFortune(familyId)
+  7. 组装为 TianpanDashboardVO 返回
+```
+
+### 4.9 角色/权限实现
+
+控制器内手动检查(遵循项目约定):
+
+```java
+String role = (String) request.getAttribute("role");
+if ("child".equals(role)) {
+    // child: 只允许查自己家庭,且隐藏部分字段(eightCharacters 不返回详细)
+    Long userId = (Long) request.getAttribute("userId");
+    // 校验 familyId 属于 userId 的家庭
+    // 在 enrichMembers 中对 child 角色过滤 eightCharacters 详细字段
+}
+if (!"parent".equals(role) && !"teacher".equals(role) && !"child".equals(role) && !"admin".equals(role)) {
+    return Result.error(403, "无权访问天盘");
+}
+// teacher: 校验该 familyId 是否在 guide_families 表中绑定到该规划师
+// admin: 允许所有
+```
+
+---
+
+## 五、数据库增量设计
+
+### 5.1 新增表
+
+#### `tianpan_daily_fortune` — 每日宜忌缓存
+
+天盘打开量大,每日宜忌建议缓存避免重复计算。
+
+```sql
+CREATE TABLE IF NOT EXISTS tianpan_daily_fortune (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    family_id BIGINT NOT NULL COMMENT '家庭ID',
+    fortune_date DATE NOT NULL COMMENT '宜忌日期',
+    gan_zhi VARCHAR(20) COMMENT '当日干支(年柱)',
+    family_advice TEXT COMMENT '家庭整体宜忌建议',
+    do_actions VARCHAR(500) COMMENT '宜做事项(JSON数组)',
+    avoid_actions VARCHAR(500) COMMENT '忌做事项(JSON数组)',
+    lucky_members VARCHAR(200) COMMENT '运势较旺成员(JSON数组)',
+    focus_member VARCHAR(200) COMMENT '需关注的成员(JSON)',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    UNIQUE KEY uk_family_date (family_id, fortune_date),
+    INDEX idx_family (family_id),
+    INDEX idx_date (fortune_date)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='天盘每日宜忌缓存';
+```
+
+#### `tianpan_member_annual_energy` — 成员年度能量缓存
+
+流年运势按家庭成员×年度缓存。
+
+```sql
+CREATE TABLE IF NOT EXISTS tianpan_member_annual_energy (
+    id BIGINT AUTO_INCREMENT PRIMARY KEY,
+    member_id BIGINT NOT NULL COMMENT '成员ID',
+    member_type VARCHAR(20) NOT NULL COMMENT 'child/parent',
+    family_id BIGINT NOT NULL COMMENT '家庭ID',
+    zodiac VARCHAR(20) COMMENT '生肖',
+    target_year INT NOT NULL COMMENT '目标年份',
+    overall_trend VARCHAR(20) COMMENT '趋势: ascending/steady/descending',
+    focus_dimension VARCHAR(20) COMMENT '关注维度: body/mind/wisdom/action/wealth',
+    summary TEXT COMMENT '年度运势摘要',
+    monthly_forecast TEXT COMMENT '月度预测(JSON数组)',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+    UNIQUE KEY uk_member_year (member_id, member_type, target_year),
+    INDEX idx_family_year (family_id, target_year)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='天盘成员年度能量缓存';
+```
+
+### 5.2 现有表字段扩展
+
+#### `family_member_attributes` 增加西方星座字段
+
+虽然可通过 `birthDatetime` 计算,但缓存到列上更高效:
+
+```java
+// 迁移43: family_member_attributes 表增加西方星座字段
+ensureColumn("family_member_attributes", "western_zodiac",
+        "VARCHAR(20) COMMENT '西方星座: aries/taurus/gemini/...'");
+ensureColumn("family_member_attributes", "western_zodiac_name",
+        "VARCHAR(20) COMMENT '西方星座中文名'");
+```
+
+#### `family_member_tradition_vo` / 后端扩展
+
+`FamilyMemberTraditionVO` DTO 增加:
+```java
+private String westernSign;
+private String westernSignName;
+private String avatar;
+private Integer generation;
+private String colorHex;
+private String lifeNumberTitle;
+private String lifeNumberKeywords;
+private BaziReadingTemplate wuxingReading;
+private Map<String, Integer> energySnapshot;
+```
+
+### 5.3 迁移编号与文件同步
+
+| 迁移 | 文件 | 操作 |
+|------|------|------|
+| 迁移43 | `DatabaseInitializer.java` | 创建 `tianpan_daily_fortune` 表 |
+| 迁移44 | `DatabaseInitializer.java` | 创建 `tianpan_member_annual_energy` 表 |
+| 迁移45 | `DatabaseInitializer.java` | `family_member_attributes` 增加 `western_zodiac`、`western_zodiac_name` 两列 |
+| — | `schema.sql` | 同步追加以上三个 DDL 到 schema.sql |
+
+所有迁移幂等(`CREATE TABLE IF NOT EXISTS` + `ensureColumn`),可重复执行。
+
+### 5.4 配置数据填充(Seed)
+
+复用现有 `ZodiacConfig`/`BaziConfig`/`NumSoulConfig`/`BaziReadingTemplate` 配置数据,无需新增种子。
+
+---
+
+## 六、小程序页面结构与组件设计
+
+### 6.1 页面路由与入口
+
+在 `pages.json` 注册:
+
+```json
+{
+  "path": "pages/tianpan/index",
+  "style": {
+    "navigationBarTitleText": "家庭天盘",
+    "navigationStyle": "custom",
+    "disableScroll": true
+  }
+}
+```
+
+**入口设计**:
+- 小程序首页「心」维度 TabBar 二级入口(心 → 家庭天盘)
+- 家长端首页快捷操作卡片
+- 成长档案页面关联入口
+
+### 6.2 页面结构
+
+```
+pages/tianpan/index.vue  (主天盘页,Canvas全屏)
+├─ pages/tianpan/member-detail.vue  (成员详情)
+├─ pages/tianpan/relation-detail.vue  (关系详情)
+├─ pages/tianpan/annual-energy.vue  (流年运势)
+├─ pages/tianpan/daily-fortune.vue  (每日宜忌)
+└─ pages/tianpan/related-items.vue  (关注事宜)
+```
+
+### 6.3 主天盘页面布局(`index.vue`)
+
+```
+┌───────────────────────────────────────┐
+│  [自定义导航栏: 家庭天盘 + 日期切换]      │
+├──────────────────────────────────────┤
+│                                       │
+│         ╭───────────────╮             │
+│        ╱  家庭五行聚合盘    ╲            │
+│       │  (Canvas 主盘面)    │            │
+│        ╲                  ╱            │  ← 主交互区
+│         ╰───────────────╯             │
+│                                       │
+├──────────────────────────────────────┤
+│  [关注事宜 Tab 切换栏]                  │
+│  📋任务 5 │ 📝测评 1 │ ⚠预警 0 │ 🎂里程碑 │
+├──────────────────────────────────────┤
+│  [关注事宜内容区 (Tab 内容)]            │
+│  • 完成阅读打卡 — 小李 — 7/12          │
+│  • 家庭运动30分钟 — 李爸爸 — 7/11      │
+│  • 测评预约 — 小李 — 7/20              │
+├──────────────────────────────────────┤
+│  [周洞察/每日宜忌卡片]                  │
+│  🌟 今日宜: 家庭会议、整理家务          │
+│  ⚠ 今日忌: 激烈争论、熬夜               │
+│  💡 李爸爸和李妈妈是天生好搭档...        │
+└──────────────────────────────────────┘
+```
+
+### 6.4 组件设计(`components/tianpan/`)
+
+| 组件 | 职责 | Props |
+|------|------|-------|
+| `TianpanCanvas.vue` | 主盘面 Canvas 绘制(三层辐射) | `members`, `familyWuxing`, `relationships`, `relatedItems`, `dailyFortune` |
+| `TianpanMemberRing.vue` | 内层:成员命理节点环 | `members` |
+| `TianpanRelationRing.vue` | 中层:关系连线 | `members`, `relationships` |
+| `TianpanFocusRing.vue` | 外层:关注事宜标签环 | `relatedItems`, `dailyFortune` |
+| `TianpanMemberCard.vue` | 成员详情底部弹窗 | `member`, `onClose` |
+| `TianpanRelationCard.vue` | 关系详情底部弹窗 | `relation`, `onClose` |
+| `TianpanFortuneBar.vue` | 每日宜忌横条 | `dailyFortune` |
+| `TianpanInsightCard.vue` | 周洞察卡片 | `weeklyInsight` |
+| `TianpanRelatedTabs.vue` | 关注事宜 Tab 切换 | `relatedItems`, `activeTab` |
+
+### 6.5 天盘数据 API 封装
+
+在 `utils/api.js` 增加:
+
+```javascript
+// 天盘
+export const tianpanDashboard = (data) => request.post('/api/tianpan/dashboard', data)
+export const tianpanMemberDetail = (memberId, data) => request.post(`/api/tianpan/member/${memberId}`, data)
+export const tianpanCompatibility = (data) => request.post('/api/tianpan/compatibility', data)
+export const tianpanAnnualEnergy = (data) => request.post('/api/tianpan/annual-energy', data)
+export const tianpanDailyFortune = (data) => request.post('/api/tianpan/daily-fortune', data)
+export const tianpanRelatedItems = (data) => request.post('/api/tianpan/related-items', data)
+```
+
+### 6.6 角色差异化
+
+| 角色 | 显示差异 |
+|------|---------|
+| parent | 完整天盘,可查看所有成员命理,可编辑关注事宜配置 |
+| child | 简化天盘,仅自己有完整命理,其他成员只展示星座+生肖+昵称,八字细节隐藏 |
+| teacher | 看到所绑定家庭的完整天盘(只读) |
+
+### 6.7 降级方案
+
+| 缺失数据 | 降级策略 |
+|---------|---------|
+| 成员无 `FamilyMemberAttributes` | 节点显示灰色占位,标注「未录入出生信息」 |
+| 家庭五行无数据 | 盘面显示中性灰色,分析区显示「家庭五行数据不足,请录入成员出生信息」 |
+| 流年运势计算失败 | 天盘正常显示,流年卡片显示「暂未生成」 |
+| 无关注事宜 | 外层环显示空状态图标 + 提示文案 |
+
+---
+
+## 七、天盘可视化设计
+
+### 7.1 整体形态:同心三层辐射盘
+
+```
+        外层: 关注事宜环 (半径 R3)
+       /                                   \
+      /   中层: 关系网络环 (半径 R2)          \
+     /   /                            \     \
+    /   |     内层: 成员节点环 (半径 R1) |     \
+   |   |    ╭─────────────────────╮    |     |
+   |   |   │     中心: 家庭五行盘     │   |     |
+   |   |    ╰─────────────────────╯    |     |
+    \   \                            /     /
+     \   \                          /     /
+      \   \________________________/     /
+       \________________________________/
+```
+
+- **R1 ≈ 屏宽 × 0.18**:家庭成员围坐一圈(头像+昵称+代表色光晕)
+- **R2 ≈ 屏宽 × 0.32**:关系连线扇形(依据两成员角度画弧线,颜色按综合评分渐变)
+- **R3 ≈ 屏宽 × 0.46**:关注事宜标签节点(小圆,按类别着图标 emoji)
+- **中心圆盘 R0 ≈ 屏宽 × 0.12**:家庭五行聚合雷达图(5 维:木/火/土/金/水)
+
+### 7.2 色彩体系
+
+| 维度 | 五行 | 色值 | 用途 |
+|------|------|------|------|
+| 木 | 行/智慧 | `#10B981` | 节点光晕、连线、雷达 |
+| 火 | 心 | `#FF6B9D` | 节点光晕、连线、雷达 |
+| 土 | 身 | `#FF8C42` | 节点光晕、连线、雷达 |
+| 金 | 智 | `#6366F1` | 节点光晕、连线、雷达 |
+| 水 | 富 | `#F59E0B` | 节点光晕、连线、雷达 |
+
+成员节点光晕使用其**命主五行**(`wuxingElements` 中最高占比五行对应色)。
+关系连线按综合评分渐变:≥85 绿色 `#10B981`、60-84 黄色 `#F59E0B`、<60 红色 `#EF4444`。
+
+### 7.3 内层成员节点绘制规范
+
+每个成员节点:
+- 圆形头像 + 代表色发光圆环
+- 节点尺寸 60×60px(按 dpi × 设备像素比调整)
+- 下方文字:昵称(12px)+ 生肖中文(10px)
+- 悬浮态:光晕放大 1.3 倍,显示生命密码数字徽章(右上角小圆点)
+- 8 点位均匀分布(超过 8 人则缩小尺寸或外扩一圈)
+
+**点击命中区域**: 节点 + 周围 10px padding,便于手指触达。
+
+### 7.4 中心五行雷达图
+
+五边形雷达,5 个顶点对应五维:
+```
+        木(行)
+       /
+金(智) —— 中心 —— 火(心)
+       \
+        水(富)
+       /
+   土(身)
+```
+- 多边形填充:家庭聚合百分比(半透明 0.6)
+- 顶点标签:五行元素中文名 + 百分比
+- 中心文字:家庭名(粗体)+ 最强/最弱元素标签
+- 选中态:成员能量快照单独画一个雷达叠在上面(实线)
+
+### 7.5 中层关系连线绘制
+
+```
+对每对成员 (Mi, Mj):
+1. 计算两节点角度 θi, θj
+2. 画弧线(贝塞尔曲线):从 Mi 节点边缘出发到 Mj 节点边缘
+3. 连线粗细:综合评分越高越粗(1-4px)
+4. 连线颜色:评分渐变(见 7.2)
+5. 连线中点:显示评分小圆点(20×20),里面是数字
+6. 悬浮态:连线高亮(粗细 +2,亮度 +20%),显示关系类型气泡(如「六合」「相生」)
+```
+
+### 7.6 外层关注事宜环
+
+围绕在关系环外圈的小节点(30×30),每种事宜一个 emoji 图标:
+- 📋 待办任务(橙色)
+- 📝 测评预约(蓝色)
+- ⚠ 关系预警(红色)
+- 🎂 里程碑(紫色,生日/纪念日等)
+
+数量超 4 时,同类事项合并为「+N」徽章。
+
+### 7.7 命运流年环(次级层)
+
+当用户切换年份 / 点击「流年运势」卡片时,在 R3 外再画一圈瞬时环(R4 ≈ 屏宽 × 0.56):
+- 12 个等分扇形(月份)
+- 每个扇形颜色:月度能量高低渐变(弱红→中黄→强绿)
+- 扇形内标注月份序号
+- 点击扇形展开该月运势详情
+
+### 7.8 Canvas 实现关键
+
+```javascript
+// 伪代码示意 — TianpanCanvas.vue
+export default {
+  data() {
+    return {
+      canvasCtx: null,
+      rings: { R0: 0, R1: 0, R2: 0, R3: 0 }
+    }
+  },
+  methods: {
+    initCanvas() {
+      const sys = uni.getSystemInfoSync()
+      const size = sys.windowWidth
+      this.rings = { R0: size*0.12, R1: size*0.18, R2: size*0.32, R3: size*0.46 }
+      const ctx = uni.createCanvasContext('tianpan', this)
+      this.canvasCtx = ctx
+      this.draw()
+    },
+    draw() {
+      this.drawCenterPentagon()   // 家庭五行雷达
+      this.drawMembers()           // 内层节点
+      this.drawRelations()         // 中层连线
+      this.drawFocusRing()         // 外层关注事宜
+      this.canvasCtx.draw()
+    },
+    handleTap(e) {
+      // 命中检测:从外到内逐层判断
+      const point = this.getCanvasPoint(e)
+      const focus = this.hitTestFocusRing(point)
+      if (focus) return this.$emit('focus-tap', focus)
+      const relation = this.hitTestRelations(point)
+      if (relation) return this.$emit('relation-tap', relation)
+      const member = this.hitTestMembers(point)
+      if (member) return this.$emit('member-tap', member)
+    }
+  }
+}
+```
+
+**性能**:
+- 单次 `draw()`,不要分帧绘制(小程序 Canvas 不支持 requestAnimationFrame)
+- 节点 ≤ 12 时性能充足
+- 切换年份时整盘重绘,无过渡动画(小程序 Canvas 性能限制)
+
+### 7.9 降级与空状态
+
+- 无 Canvas 支持的旧版本小程序:降级显示列表布局(成员横向滚动 + 关系列表卡片)
+- 无五行数据:中心显示家庭 logo + 提示「请录入成员出生信息以生成五行盘」
+
+---
+
+## 八、交互设计
+
+### 8.1 主操作流
+
+```
+[打开天盘页]
+    ↓
+[POST /api/tianpan/dashboard]  (加载骨架屏)
+    ↓
+[绘图 + 显示三层盘面]
+    ↓
+[用户点击节点/连线/关注事宜]
+    ↓
+┌─────────────────────────────────────────┐
+│ 点击成员节点 → 弹出成员详情卡(底部弹层)    │
+│ 点击关系连线 → 弹出关系详情卡(底部弹层)    │
+│ 点击关注事宜 → 跳转对应详情页              │
+│ 点击中心雷达 → 展开/收回成员能量叠加       │
+│ 上滑 → 展开周洞察+每日宜忌卡片             │
+└─────────────────────────────────────────┘
+    ↓
+[二次操作: 编辑命理 / 查看流年 / 跳转任务]
+```
+
+### 8.2 关键交互细节
+
+| 交互 | 触发 | 反馈 |
+|------|------|------|
+| 成员节点单击 | tap | 底部弹出 `TianpanMemberCard`:八字四柱、五行、生命密码、先天心/智、星座行运 |
+| 成员节点长按 | longpress | 弹出操作菜单:编辑命理 / 查看流年 / 设为焦点 |
+| 关系连线点击 | tap | 底部弹出 `TianpanRelationCard`:综合评分、生肖配对型、五行互补、血型、生命密码关系、AI 建议 |
+| 关系连线长按 | longpress | 显示历史评分变化趋势(需 RelationshipQualityService 历史数据) |
+| 关注事宜 Tab 切换 | tap | 下方关注事宜区切换内容,高亮当前 Tab |
+| 点击关注事宜项 | tap | 跳转到对应详情页(任务详情、测评预约、预警解释) |
+| 顶部右上日期切换 | tap | 弹出日历选择器,切换流年运势 |
+| 中心雷达点击 | tap | 切换「家庭总览 / 焦点成员叠加」显示 |
+| 下拉刷新 | pulldown | 重新调用 dashboard 接口 |
+
+### 8.3 底部弹层规范(`TianpanMemberCard` / `TianpanRelationCard`)
+
+- 高度:屏幕 55%
+- 圆角顶部 16px
+- 顶部抓手条 (handle bar)
+- 关闭:下拉手势 / 点击遮罩 / 右上 ×
+- 内容区可滚动
+
+### 8.4 加载与骨架屏
+
+- 首屏:Canvas 区显示环形骨架 + 中心 logo
+- 关注事宜区:5 个灰色占位条
+- 洞察卡片:渐变扫光动画
+- 加载超时 5s:显示重试按钮
+
+### 8.5 错误处理
+
+| 场景 | 反馈 |
+|------|------|
+| familyId 缺失 | 全屏「请先创建家庭」引导卡片 |
+| 网络超时 | 顶部红色 toast + 重试按钮 |
+| 无成员 | 空盘 + 「邀请家庭成员加入」按钮 |
+| 角色无权限 | 403 → 跳转登录 / 显示「无权访问」 |
+
+### 8.6 无障碍与可访问性
+
+- Canvas 上每个节点底部加文字标签(不止图标)
+- 关键信息(成员详情、关系评分)在弹层中文字冗余呈现
+- 遵循 WCAG 对比度:所有文字背景对比度 ≥ 4.5:1
+
+---
+
+## 九、前端状态管理
+
+### 9.1 Vuex 模块 `tianpan`
+
+```javascript
+// store/modules/tianpan.js
+export default {
+  namespaced: true,
+  state: {
+    dashboard: null,          // TianpanDashboardVO
+    selectedMemberId: null,   // 当前选中的成员
+    selectedRelation: null,   // 当前选中的关系
+    selectedYear: new Date().getFullYear(),
+    selectedDate: new Date().toISOString().slice(0, 10),
+    loading: false,
+    error: null,
+    activeFocusTab: 'tasks'   // tasks/assessments/alerts/milestones
+  },
+  mutations: {
+    SET_DASHBOARD(state, data) { state.dashboard = data },
+    SET_SELECTED_MEMBER(state, id) { state.selectedMemberId = id },
+    SET_SELECTED_RELATION(state, rel) { state.selectedRelation = rel },
+    SET_SELECTED_YEAR(state, year) { state.selectedYear = year },
+    SET_SELECTED_DATE(state, date) { state.selectedDate = date },
+    SET_LOADING(state, val) { state.loading = val },
+    SET_ERROR(state, err) { state.error = err },
+    SET_FOCUS_TAB(state, tab) { state.activeFocusTab = tab }
+  },
+  actions: {
+    async loadDashboard({ commit }, { familyId, year, daysAhead }) {
+      commit('SET_LOADING', true)
+      try {
+        const res = await tianpanDashboard({ familyId, year, daysAhead })
+        if (res.code === 200) commit('SET_DASHBOARD', res.data)
+        else commit('SET_ERROR', res.message)
+      } catch (e) {
+        commit('SET_ERROR', e.message || '加载失败')
+      } finally {
+        commit('SET_LOADING', false)
+      }
+    },
+    async switchYear({ commit, dispatch, state }, year) {
+      commit('SET_SELECTED_YEAR', year)
+      // 重新拉取流年数据
+      dispatch('loadAnnualEnergy', { familyId: state.dashboard.familyId, year })
+    }
+  },
+  getters: {
+    members: state => state.dashboard && state.dashboard.members,
+    familyWuxing: state => state.dashboard && state.dashboard.familyWuxing,
+    relationships: state => state.dashboard && state.dashboard.relationships,
+    relatedItems: state => state.dashboard && state.dashboard.relatedItems,
+    dailyFortune: state => state.dashboard && state.dashboard.dailyFortune,
+    weeklyInsight: state => state.dashboard && state.dashboard.weeklyInsight,
+    selectedMember: state => {
+      if (!state.dashboard || !state.selectedMemberId) return null
+      return state.dashboard.members.find(m => m.memberId === state.selectedMemberId)
+    }
+  }
+}
+```
+
+### 9.2 页面组件数据流
+
+```
+pages/tianpan/index.vue
+   │
+   ├─ vuex: mapState('tianpan', ['dashboard', 'loading', 'selectedMemberId', ...])
+   ├─ vuex: mapActions('tianpan', ['loadDashboard', 'switchYear'])
+   │
+   │  created() { this.loadDashboard({ familyId, year, daysAhead: 7 }) }
+   │
+   ├─ <tianpan-canvas :dashboard="dashboard" @member-tap="..." @relation-tap="..." @focus-tap="..." />
+   ├─ <tianpan-related-tabs :items="relatedItems" :active="activeFocusTab" />
+   ├─ <tianpan-insight-card :insight="weeklyInsight" :fortune="dailyFortune" />
+   │
+   └─ 弹层:
+      ├─ <tianpan-member-card v-if="selectedMember" :member="selectedMember" />
+      └─ <tianpan-relation-card v-if="selectedRelation" :relation="selectedRelation" />
+```
+
+### 9.3 缓存策略
+
+| 数据 | 缓存位置 | TTL |
+|------|---------|-----|
+| dashboard 主结构 | Vuex 内存 | 当前会话,进入小程序时刷新 |
+| dailyFortune | 本地 storage | 当天有效(key: `tianpan_daily_${familyId}_${date}`) |
+| annualEnergy | 本地 storage | 当年有效(key: `tianpan_annual_${familyId}_${year}`) |
+| 成员详情 | Vuex,按 memberId+type 缓存 | 5 分钟 |
+
+### 9.4 数据更新时机
+
+- 进入小程序首页:「心」Tab → 拉取天盘 dashboard(强制刷新)
+- 切换年份:仅重新拉 `annualEnergy`
+- 切换日期:仅重新拉 `dailyFortune`
+- 编辑成员命理:本地 patch `dashboard.members[i]` + 后台静默重新拉 dashboard
+- 完成关注事宜(勾选任务):本地 `relatedItems.pendingTasks` 减 1,可后台静默校准
+
+---
+
+## 十、开发任务拆解
+
+> 每个任务带验收标准,可直接分配给开发。建议顺序:T1(后端基础) → T2(API+DTO) → T3(DB) → T4(前端骨架) → T5(Canvas绘制) → T6(交互) → T7(关联事宜) → T8(流年/宜忌) → T9(测试)。
+
+### T1:后端 DTO 构建(1 人日)
+
+**成果**: `TianpanDashboardVO`, `TianpanMemberVO`, `MemberAnnualEnergyVO`, `DailyFortuneVO`, `RelatedItemsVO`,扩展 `FamilyMemberTraditionVO`。
+
+**文件**:
+- `dto/TianpanDashboardVO.java`(新建)
+- `dto/TianpanMemberVO.java`(新建)
+- `dto/MemberAnnualEnergyVO.java`(新建)
+- `dto/DailyFortuneVO.java`(新建)
+- `dto/RelatedItemsVO.java`(新建)
+- `dto/FamilyMemberTraditionVO.java`(扩展字段)
+
+**验收标准**:
+1. [ ] 所有 DTO 添加 Lombok `@Data`
+2. [ ] `TianpanDashboardVO` 包含 §4.2 中所有字段
+3. [ ] `FamilyMemberTraditionVO` 新增 `westernSign/westernSignName/avatar/generation/colorHex/lifeNumberTitle/lifeNumberKeywords/wuxingReading/energySnapshot` 字段
+4. [ ] `mvn clean compile` 通过
+
+### T2:后端 TianpanService 核心(2 人日)
+
+**成果**: `TianpanService` 各 enrich/build 方法实现。
+
+**文件**:
+- `service/TianpanService.java`(新建)
+- `service/CompatibilityService.java`(暴露 `computeRelationshipSummary`、`aggregateWuxing` 给 TianpanService 调用,需把私有方法升级为 package-private)
+
+**验收标准**:
+1. [ ] `TianpanService.enrichMembers(List<FamilyMemberTraditionVO>)` 补西方星座(调用 `ZodiacAnnualEnergyService.findWesternSign`)
+2. [ ] `TianpanService.enrichRelationships(List<RelationshipSummaryVO>)` 补五行/血型/生命密码三件套 + `generationLabel`
+3. [ ] `TianpanService.buildRelatedItems(familyId, daysAhead)` 返回任务/测评/预警/里程碑聚合
+4. [ ] `TianpanService.buildAnnualEnergy(familyId, year)` 调用 `ZodiacAnnualEnergyService.calculate()` 聚合所有成员
+5. [ ] `TianpanService.buildDailyFortune(familyId)` 基于家庭五行+当日干支返回宜忌(先简单实现,AI 增强留 V2)
+6. [ ] child 角色调用时隐藏 `eightCharacters` 详细四柱(保留年柱占位)
+
+### T3:后端 Controller + 角色权限(0.5 人日)
+
+**成果**: `TianpanController` 6 个路由全部实现。
+
+**文件**:
+- `controller/tianpan/TianpanController.java`(新建目录与文件)
+
+**验收标准**:
+1. [ ] 6 个 `@PostMapping` 全部按 §4.1 实现
+2. [ ] JpostIdAttribute("userId")、role 校验完整
+3. [ ] child 角色调用家盘返回脱敏后数据
+4. [ ] teacher 调用 `familyId` 必须校验绑定关系
+5. [ ] 检查路径不与现有 controller 重复(运行 `grep '@PostMapping' cfc-backend/src/main/java/com/etotem/cfc/controller/ | grep -oP 'POST \K/\S+' | sort -u`)
+
+### T4:DB 迁移 + schema.sql 同步(0.5 人日)
+
+**成果**: 迁移 43/44/45 + schema.sql。
+
+**文件**:
+- `config/DatabaseInitializer.java` 增加 迁移 43/44/45
+- `resources/schema.sql` 同步三张表
+
+**验收标准**:
+1. [ ] `tianpan_daily_fortune` 表创建(含 `uk_family_date`)
+2. [ ] `tianpan_member_annual_energy` 表创建(含 `uk_member_year`)
+3. [ ] `family_member_attributes` 新增 `western_zodiac` 和 `western_zodiac_name` 列
+4. [ ] schema.sql 同步追加这三段 DDL
+5. [ ] 迁移幂等(重复执行报 duplicate column/table 时不影响)
+6. [ ] `mvn clean compile` 通过
+
+### T5:前端 API 封装 + Vuex 模块(0.5 人日)
+
+**成果**: `utils/api.js` 追加 6 个接口封装 + `store/modules/tianpan.js` Vuex 模块。
+
+**文件**:
+- `cfc-frontend/utils/api.js`(追加 6 个 export)
+- `cfc-frontend/store/modules/tianpan.js`(新建)
+- `cfc-frontend/store/index.js`(注册模块)
+
+**验收标准**:
+1. [ ] 全部接口封装使用项目已有 `request` 实例(不引入 axios 二次封装)
+2. [ ] Vuex 模块包含 §9.1 中所有 state/mutation/action/getter
+3. [ ] 与小程序已有的 store 结构一致
+4. [ ] 重试/错误处理对齐现网项目约定
+
+### T6:小程序天盘页面骨架(1 人日)
+
+**成果**: `pages/tianpan/index.vue` 页面建立,路由注册,骨架屏加载态。
+
+**文件**:
+- `cfc-frontend/pages/tianpan/index.vue`(新建)
+- `cfc-frontend/pages.json`(注册路由)
+
+**验收标准**:
+1. [ ] `pages.json` 注册 `pages/tianpan/index`
+2. [ ] 页面 created 调用 `loadDashboard({ familyId, year, daysAhead: 7 })`
+3. [ ] 加载中显示骨架屏(环形 + 文字占位条)
+4. [ ] 加载完毕展示「家庭名 + 天盘 Canvas 占位 + 关注事宜 Tab + 洞察卡片」布局
+5. [ ] 错误态显示「重试」按钮,点击重试触发 actions
+6. [ ] ❌ 不使用 `?.` 可选链(用 `&&` 替代)
+7. [ ] ❌ 不使用 CSS Grid(flexbox 布局)
+
+### T7:TianpanCanvas 组件 — 三层盘面绘制(3 人日,核心)
+
+**成果**: `components/tianpan/TianpanCanvas.vue` 实现 §7.1-§7.6 三层盘面绘制 + 命中检测。
+
+**验收标准**:
+1. [ ] 内层成员节点:按 8 点位或 12 点位均匀分布
+2. [ ] 中心五行雷达图:5 顶点对应木/火/土/金/水,半透明填充
+3. [ ] 中层关系连线:贝塞尔弧线 + 颜色按综合评分渐变
+4. [ ] 外层关注事宜小节点:emoji 图标 + 类别着色
+5. [ ] 单次 `canvas.draw()` 渲染,无分帧
+6. [ ] 点击命中检测层级:focus → relation → member
+7. [ ] emit `member-tap`/`relation-tap`/`focus-tap` / `center-tap` 事件携带 payload
+8. [ ] 在 iOS / 安卓主流机型实测帧率 ≥ 30 fps
+9. [ ] 成员 ≤ 3 时盘面不显得空旷(间距自动放大)
+
+### T8:成员/关系详情底部弹层 + 关注事宜 tabs(1 人日)
+
+**成果**: `TianpanMemberCard.vue`、`TianpanRelationCard.vue`、`TianpanRelatedTabs.vue`、`TianpanInsightCard.vue`。
+
+**验收标准**:
+1. [ ] 底部弹层高度 55%,圆角 16px,含抓手条
+2. [ ] 成员卡展示八字四柱 / 五行 / 生命密码 / 星座
+3. [ ] 关系卡展示综合分 + 生肖/五行/血型/生命密码四模块
+4. [ ] 关注事宜 4 个 Tab 切换流畅,数据空态合理
+5. [ ] 点击任务/测评项可跳转到对应详情页
+6. [ ] 弹层关闭手势:下拉 / 点击遮罩 / 右上 ×
+
+### T9:流年运势 + 每日宜忌次级层(1 人日)
+
+**成果**: `TianpanAnnualRing` 命运流年环 + 每日宜忌独立页面。
+
+**验收标准**:
+1. [ ] 点击「流年运势」卡片 → 在 Canvas 外层叠加 R4 流年环(12 等分扇形)
+2. [ ] 流年环按月度能量高低着色(弱红 → 中黄 → 强绿)
+3. [ ] 顶部右上日期选择器,切换年份重新拉 `annual-energy`
+4. [ ] 点击扇形展开月度卡片(运势摘要)
+5. [ ] 每日宜忌卡片:宜/忌/家庭建议/焦点成员/旺运成员
+
+### T10:角色降级 + 空状态 + 错误处理(0.5 人日)
+
+**验收标准**:
+1. [ ] child 角色:其他成员隐藏八字四柱,仅展示星座/生肖/昵称
+2. [ ] 无出生信息的成员节点:灰色占位「未录入」
+3. [ ] 家庭无任何五行数据:中心显示 logo + 「请录入成员出生信息」提示
+4. [ ] 网络异常:toast + 重试按钮
+5. [ ] familyId 缺失:全屏引导卡「请先创建家庭」
+
+### T11:Web 管理端配置补全(可选,0.5 人日)
+
+**成果**: `cfc-web` 新增「天盘」管理菜单,主要管理缓存表数据与配置外部 Dify AI 增强模板。
+
+**验收标准**:
+1. [ ] `views/admin/TianpanConfig.vue` 管理每日宜忌模板
+2. [ ] 可手动重新生成某家庭某日的宜忌缓存
+3. [ ] 路由注册到 `router/index.js`
+
+### 任务总工时(不含测试)
+
+**约 11 人日**(T1+T2×2+T3+T4+T5+T6+T7×3+T8+T9+T10 = 11)。
+
+---
+
+## 十一、技术选型与风险点
+
+### 11.1 技术选型
+
+| 层 | 选型 | 理由 |
+|----|------|------|
+| 前端 Canvas | uni-app `<canvas>` + 原生 `CanvasContext` | 小程序限制下唯一可行路径,不引入 D3/ECharts(小程序兼容性差 + 包体积) |
+| 前端状态 | Vuex namespaced module | 与项目现有 store 一致 |
+| 接口协议 | `@PostMapping` + `Result<T>` | 项目统一约定 |
+| DB 缓存 | 2 张新表 + memo | 避免 daily fortune/annual energy 反复计算 |
+| AI 增强(V2) | Dify Chatbot API(与 Aichi 对齐) | 周洞察/每日宜忌的深度解读可接入 AI 助手 |
+
+### 11.2 风险与对策
+
+| 风险 | 等级 | 对策 |
+|------|:----:|------|
+| **Canvas 性能** - iPhone X 之上机型能跑 30+fps,但旧机器可能掉帧 | 中 | 节点限制 ≤12 人、关系连线简化为弧线(不使用阴影)、关闭过渡动画 |
+| ★ 命中检测误差 - 高 dpi 设备坐标转换易错 | 中 | 复用 `uni.getSystemInfoSync().pixelRatio` + 缩放矩阵;写测试工具对比 tape point |
+| 星座计算不一致(西方 13 星座 vs 12 星座) | 中 | 复用 `ZodiacAnnualEnergyService.findWesternSign` 的实现,避免重复造轮子 |
+| 五行解读覆盖不全 | 低 | 缺失模板时返回 null,前端展示「暂无解读」空态 |
+| child 角色隐私泄露 | 高 | 后端强制隐藏:天盘响应在 Service 层做 redact,不依赖前端 |
+| 流年运势每年切换需重新计算 | 中 | 缓存到 `tianpan_member_annual_energy` 表,命中缓存则跳过 calculate |
+| daily fortune 数据可能被频繁查询 | 低 | 加 `family_id+date` 唯一索引,每天首页静默刷新一次 |
+| 关系数据缺失时盘面稀疏 | 低 | 降级连线为虚线灰色,标注「关系评分尚未生成」 |
+| teacher 越权访问其他家庭 | 高 | Controller 校验 `guide_families.teacher_id=familyId` 绑定关系 |
+| 每周 AI 周洞察成本 | 低 | 复用 `generateWeeklyInsight`(无 AI),V2 再接 Dify |
+
+### 11.3 性能预算
+
+| 指标 | 目标 |
+|------|------|
+| dashboard 接口响应 | P95 < 600ms(家庭 5 人) |
+| Canvas 首绘 | 进入页面 1 秒内 |
+| Tab 切换 | < 100ms |
+| 点击节点弹层 | < 200ms |
+
+### 11.4 兼容性
+
+- 微信小程序基础库 ≥ 2.7.0(Canvas 2D API)
+- iOS 9+ / 安卓 5+
+- 不支持 Canvas 的旧版本降级到列表布局(与 `wuxing-sandbox` 一致策略)
+
+### 11.5 不做(V1 不含)
+
+- AI 自动生成每日宜忌(V2 接 Dify)
+- 关系评分历史趋势图
+- 多语言界面
+- 分享天盘截图到朋友圈(V2 时再考虑)
+- 大于 12 人的大家庭盘面(V2 叠加多环)
+
+---
+
+## 十二、测试策略
+
+### 12.1 测试金字塔
+
+```
+        ┌──────────────┐
+        │   e2e (5%)    │  关键流:打开→渲染→点击→弹层
+        ├──────────────┤
+        │ integration  │  API/Vuex/Canvas 渲染回归
+        │     (15%)    │
+        ├──────────────┤
+        │   unit (80%) │  enrich/build/fortunegeneration
+        └──────────────┘
+```
+
+### 12.2 后端单元测试
+
+| 测试类 | 覆盖点 |
+|--------|--------|
+| `TianpanServiceTest` | `enrichMembers` 补字段、`enrichRelationships` 补字段、`buildRelatedItems` 聚合、`buildAnnualEnergy` 缓存命中 |
+| `TianpanServiceFortuneTest` | `buildDailyFortune` 各种五行组合产出宜忌合理性、空家庭输入 |
+| `TianpanServicePrivacyTest` | child 角色调用 dashboard 返回时,其他成员 `eightCharacters` 字段为 null/年柱占位 |
+| `CompatibilityServiceTest` | 已有 + 新增 EXPOSED package 方法不破坏现有逻辑 |
+
+### 12.3 后端集成测试
+
+| 测试 | 验证 |
+|------|------|
+| `TianpanControllerIT.dashboard_ok` | parent 角色查家庭,返回 `TianpanDashboardVO` 结构完整 |
+| `TianpanControllerIT.dashboard_child_redact` | child 调用,其他成员四柱字段为 redacted |
+| `TianpanControllerIT.dashboard_teacher_unauthorized` | teacher 未绑定该家庭 → 403 |
+| `TianpanControllerIT.annual_energy_cache` | 第二次调用应命中缓存(无 DB 写) |
+| `TianpanControllerIT.daily_fortune_idempotent` | 同一 family+date 多次调用返回一致(仅一次写 DB) |
+
+### 12.4 前端单元测试
+
+| 测试 | 覆盖 |
+|------|------|
+| `TianpanCanvas.spec` | draw 调用次数、命中检测函数正确(mock canvasContext) |
+| `store/modules/tianpan.spec` | `loadDashboard`/`switchYear` mutation/action 链路 |
+| `TianpanRelatedTabs.spec` | Tab 切换 emit 事件 / 空数据态 |
+
+### 12.5 e2e 测试
+
+| 场景 | 步骤 |
+|------|------|
+| 家长打开天盘全流程 | 登录家长 → 进入「心」→ 家庭天盘 → 验证盘面渲染 → 点击成员 → 弹层显示八字四柱 → 上滑洞察卡片 → 点击关注事宜跳转任务详情 |
+| 孩子简化视角 | 切换到孩子端 → 进入天盘 → 验证其他成员四柱 hidden |
+| 流年切换 | 点击日期选择器 → 切换到 2027 年 → 验证流年环重绘 |
+| 空状态 | 新家庭无命理数据 → 打开天盘 → 显示「请录入成员出生信息」 |
+
+### 12.6 验收清单
+
+开发完成后逐项自检:
+
+- [ ] `mvn clean compile` 通过
+- [ ] 数据库迁移幂等:`mvn spring-boot:run` 启动两次无异常
+- [ ] parent/child/teacher/admin 四种角色权限正确
+- [ ] 10 人家庭盘面渲染流畅(主流机型)
+- [ ] 无出生信息成员节点正确降级
+- [ ] 关系连线综合评分渐变色与设计一致
+- [ ] 关注事宜 4 个 Tab 切换流畅
+- [ ] 每日宜忌缓存正确(同一天多次进入不会重新计算)
+- [ ] 流年切换不破坏主盘面状态
+- [ ] 路由检查无重复:`grep '@PostMapping' cfc-backend/src/main/java/com/etotem/cfc/controller/ | grep -oP 'POST \K/\S+' | sort -u`
+- [ ] 小程序限制:无 `?.`、无 CSS Grid、Vue 2 Options API
+
+### 12.7 上线监控
+
+| 指标 | 阈值告警 |
+|------|---------|
+| `/api/tianpan/dashboard` P95 延迟 | > 800ms 告警 |
+| dashboard 接口错误率 | > 1% 告警 |
+| Canvas 渲染崩溃报告 | > 0 立即关注 |
+
+---
+
+## 附:交付物清单
+
+| # | 交付物 | 路径 |
+|---|--------|------|
+| 1 | 设计文档 | `docs/系统设计/家庭天盘设计方案.md`(本文) |
+| 2 | 后端 DTO | `dto/Tianpan*.java` |
+| 3 | 后端 Service | `service/TianpanService.java` |
+| 4 | 后端 Controller | `controller/tianpan/TianpanController.java` |
+| 5 | DB 迁移 | `DatabaseInitializer.java` 迁移 43-45 |
+| 6 | schema.sql 同步 | `resources/schema.sql` |
+| 7 | 前端 API | `utils/api.js` |
+| 8 | Vuex 模块 | `store/modules/tianpan.js` |
+| 9 | 天盘页面 | `pages/tianpan/index.vue` |
+| 10 | Canvas 组件 | `components/tianpan/TianpanCanvas.vue` |
+| 11 | 弹层组件 | `components/tianpan/TianpanMemberCard.vue` / `TianpanRelationCard.vue` |
+| 12 | 单测 | `tianpanServiceTest` / `tianpanControllerIT` |
+
+---
+
+> **下一步建议**:完成本设计文档评审 → 委派 `/ulw-plan` 打磨执行计划 → 调用 `/start-work` 执行实施。

+ 32 - 0
tools/check-test-mode.ps1

@@ -0,0 +1,32 @@
+#!/usr/bin/env pwsh
+#
+# CI Check Script: Fail build if any application-prod*.yml contains test-mode: true
+# Usage: ./check-test-mode.ps1
+#
+
+$ErrorActionPreference = "Stop"
+
+# Find all application-prod*.yml files
+$prodYamlFiles = Get-ChildItem -Path "$PSScriptRoot/../cfc-backend/src/main/resources/" -Filter "application-prod*.yml" -Recurse
+
+if ($prodYamlFiles.Count -eq 0) {
+    Write-Host "No application-prod*.yml files found. Skipping check."
+    exit 0
+}
+
+$foundViolation = $false
+foreach ($file in $prodYamlFiles) {
+    $content = Get-Content -Path $file.FullName -Raw
+    if ($content -match "test-mode:\s*true") {
+        Write-Error "ERROR: Found test-mode: true in production YAML file: $($file.FullName)"
+        $foundViolation = $true
+    }
+}
+
+if ($foundViolation) {
+    Write-Error "Build failed: test-mode: true detected in production profile YAML files."
+    exit 1
+} else {
+    Write-Host "✅ All application-prod*.yml files are clean (no test-mode: true)."
+    exit 0
+}