03-CRM 客户中心详细PRD

CREATE TABLE `crm_role_terminal_policy` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `role_code` VARCHAR(64) NOT NULL COMMENT '角色编码；数据级别：普通',
  `terminal_scope` VARCHAR(64) NOT NULL COMMENT 'PC Web/教师 App/教师小程序；数据级别：普通',
  `menu_codes` JSON NOT NULL COMMENT '可见菜单；数据级别：普通',
  `button_codes` JSON NULL COMMENT '可见按钮；数据级别：普通',
  `field_policy_json` JSON NOT NULL COMMENT '字段明文/脱敏/隐藏策略；数据级别：普通',
  `data_scope_rule` JSON NOT NULL COMMENT '数据范围规则；数据级别：普通',
  `enabled` TINYINT NOT NULL COMMENT '是否启用；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_role_terminal` (`role_code`, `terminal_scope`),
  KEY `idx_enabled` (`enabled`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='CRMRoleTerminalPolicy：CRM 角色终端与字段权限策略';

CREATE TABLE `crm_lead` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `lead_no` VARCHAR(64) NOT NULL COMMENT '线索编号，唯一；数据级别：普通',
  `source_channel` VARCHAR(64) NOT NULL COMMENT '来源渠道；数据级别：普通',
  `campaign_id` BIGINT NULL COMMENT '来源活动 ID；数据级别：普通',
  `guardian_mobile` VARCHAR(32) NOT NULL COMMENT '家长手机号，敏感；数据级别：敏感',
  `student_name` VARCHAR(64) NULL COMMENT '学员姓名；数据级别：普通',
  `intent_course_id` BIGINT NULL COMMENT '意向课程；数据级别：普通',
  `owner_id` BIGINT NULL COMMENT '当前归属销售/顾问；数据级别：普通',
  `protect_until` DATETIME NULL COMMENT '保护期截止时间；数据级别：普通',
  `duplicate_status` VARCHAR(32) NOT NULL COMMENT '未查重/疑似重复/已合并/已忽略；数据级别：普通',
  `biz_status` VARCHAR(32) NOT NULL COMMENT '业务状态，取值来自状态机字典；数据级别：普通',
  `remark` VARCHAR(512) NULL COMMENT '业务备注，敏感内容按权限脱敏；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_lead_no` (`lead_no`),
  KEY `idx_mobile_student` (`guardian_mobile`, `student_name`),
  KEY `idx_owner_status` (`owner_id`, `duplicate_status`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='Lead：销售线索主表';

CREATE TABLE `crm_customer_family` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `family_no` VARCHAR(64) NOT NULL COMMENT '家庭编号，唯一；数据级别：普通',
  `primary_guardian_id` BIGINT NULL COMMENT '主监护人 ID；数据级别：普通',
  `student_id` BIGINT NULL COMMENT '主学员 ID；数据级别：普通',
  `owner_id` BIGINT NULL COMMENT '客户归属人；数据级别：普通',
  `risk_level` VARCHAR(32) NULL COMMENT '风险等级；数据级别：普通',
  `last_follow_at` DATETIME NULL COMMENT '最近跟进时间；数据级别：普通',
  `biz_status` VARCHAR(32) NOT NULL COMMENT '业务状态，取值来自状态机字典；数据级别：普通',
  `remark` VARCHAR(512) NULL COMMENT '业务备注，敏感内容按权限脱敏；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_family_no` (`family_no`),
  KEY `idx_owner_status` (`owner_id`, `biz_status`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='CustomerFamily：客户家庭档案';

CREATE TABLE `crm_guardian` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `family_id` BIGINT NOT NULL COMMENT '家庭 ID；数据级别：普通',
  `guardian_name` VARCHAR(64) NOT NULL COMMENT '监护人姓名；数据级别：普通',
  `mobile` VARCHAR(32) NOT NULL COMMENT '手机号，敏感；数据级别：敏感',
  `relationship` VARCHAR(32) NOT NULL COMMENT '与学员关系；数据级别：普通',
  `wechat_openid` VARCHAR(128) NULL COMMENT '微信 OpenID，敏感；数据级别：敏感',
  `verify_status` VARCHAR(32) NOT NULL COMMENT '未验证/已验证/已解绑；数据级别：普通',
  PRIMARY KEY (`id`),
  KEY `idx_family` (`family_id`),
  KEY `idx_mobile` (`mobile`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='Guardian：监护人/家长资料';

CREATE TABLE `stu_student` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `student_no` VARCHAR(64) NOT NULL COMMENT '学员编号，唯一；数据级别：普通',
  `family_id` BIGINT NULL COMMENT '家庭 ID；数据级别：普通',
  `student_name` VARCHAR(64) NOT NULL COMMENT '学员姓名；数据级别：普通',
  `gender` VARCHAR(16) NULL COMMENT '性别；数据级别：普通',
  `birthday` DATE NULL COMMENT '出生日期；数据级别：普通',
  `grade` VARCHAR(32) NULL COMMENT '年级；数据级别：普通',
  `school_name` VARCHAR(128) NULL COMMENT '学校名称；数据级别：普通',
  `biz_status` VARCHAR(32) NOT NULL COMMENT '业务状态，取值来自状态机字典；数据级别：普通',
  `remark` VARCHAR(512) NULL COMMENT '业务备注，敏感内容按权限脱敏；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_student_no` (`student_no`),
  KEY `idx_family` (`family_id`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='Student：学员基础档案';

CREATE TABLE `crm_follow_record` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `lead_id` BIGINT NULL COMMENT '线索 ID；数据级别：普通',
  `family_id` BIGINT NULL COMMENT '客户家庭 ID；数据级别：普通',
  `owner_id` BIGINT NOT NULL COMMENT '跟进人 ID；数据级别：普通',
  `follow_type` VARCHAR(32) NOT NULL COMMENT '电话/微信/到访/试听/其他；数据级别：普通',
  `follow_content` TEXT NOT NULL COMMENT '跟进内容；数据级别：普通',
  `next_follow_at` DATETIME NULL COMMENT '下次跟进时间；数据级别：普通',
  `follow_result` VARCHAR(32) NOT NULL COMMENT '有效/无效/待跟进/转化；数据级别：普通',
  PRIMARY KEY (`id`),
  KEY `idx_lead_time` (`lead_id`),
  KEY `idx_owner_next` (`owner_id`, `next_follow_at`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='FollowRecord：线索/客户跟进记录';

CREATE TABLE `crm_trial_lesson` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `trial_no` VARCHAR(64) NOT NULL COMMENT '试听编号，唯一；数据级别：普通',
  `lead_id` BIGINT NULL COMMENT '线索 ID；数据级别：普通',
  `student_id` BIGINT NOT NULL COMMENT '学员 ID；数据级别：普通',
  `course_id` BIGINT NOT NULL COMMENT '试听课程 ID；数据级别：普通',
  `lesson_time` DATETIME NOT NULL COMMENT '试听时间；数据级别：普通',
  `teacher_id` BIGINT NULL COMMENT '试听教师 ID；数据级别：普通',
  `trial_status` VARCHAR(32) NOT NULL COMMENT '待确认/已预约/已到访/未到访/已取消；数据级别：普通',
  `arrival_status` VARCHAR(32) NULL COMMENT '到访状态；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_trial_no` (`trial_no`),
  KEY `idx_lead_status` (`lead_id`, `trial_status`),
  KEY `idx_lesson_time` (`lesson_time`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='TrialLesson：试听预约';

CREATE TABLE `crm_trial_feedback` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `trial_id` BIGINT NOT NULL COMMENT '试听预约 ID；数据级别：普通',
  `teacher_feedback` TEXT NULL COMMENT '教师反馈；数据级别：普通',
  `guardian_rating` DECIMAL(4,2) NULL COMMENT '家长评分；数据级别：普通',
  `next_action` VARCHAR(64) NULL COMMENT '下一步动作；数据级别：普通',
  `conversion_status` VARCHAR(32) NOT NULL COMMENT '待转化/已转化/暂不转化/失败；数据级别：普通',
  PRIMARY KEY (`id`),
  KEY `idx_trial` (`trial_id`),
  KEY `idx_conversion` (`conversion_status`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='TrialFeedback：试听反馈与转化建议';

CREATE TABLE `crm_lead_assignment` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `assignment_no` VARCHAR(64) NOT NULL COMMENT '分配编号，唯一；数据级别：普通',
  `lead_id` BIGINT NOT NULL COMMENT '线索 ID；数据级别：普通',
  `from_owner_id` BIGINT NULL COMMENT '原归属人；数据级别：普通',
  `to_owner_id` BIGINT NOT NULL COMMENT '新归属人；数据级别：普通',
  `assignment_reason` VARCHAR(255) NOT NULL COMMENT '分配原因；数据级别：普通',
  `assignment_status` VARCHAR(32) NOT NULL COMMENT '待处理/已生效/已驳回；数据级别：普通',
  `approval_status` VARCHAR(32) NULL COMMENT '审批状态，未发起为空；数据级别：普通',
  `approval_instance_id` BIGINT NULL COMMENT '关联审批实例 ID；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_assignment_no` (`assignment_no`),
  KEY `idx_lead_status` (`lead_id`, `assignment_status`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='LeadAssignment：线索分配、重分配与申诉';

CREATE TABLE `crm_duplicate_candidate` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `candidate_no` VARCHAR(64) NOT NULL COMMENT '候选编号，唯一；数据级别：普通',
  `source_biz_type` VARCHAR(64) NOT NULL COMMENT '来源对象类型；数据级别：普通',
  `source_biz_id` BIGINT NOT NULL COMMENT '来源对象 ID；数据级别：普通',
  `matched_biz_id` BIGINT NOT NULL COMMENT '疑似重复对象 ID；数据级别：普通',
  `match_score` DECIMAL(8,4) NOT NULL COMMENT '匹配分数；数据级别：普通',
  `handle_status` VARCHAR(32) NOT NULL COMMENT '待处理/已合并/已忽略；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_candidate_no` (`candidate_no`),
  KEY `idx_source` (`source_biz_type`),
  KEY `idx_status_score` (`handle_status`, `match_score`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='DuplicateCandidate：重复线索/客户候选';

CREATE TABLE `crm_merge_dispute` (
  `id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
  `org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
  `campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
  `dispute_no` VARCHAR(64) NOT NULL COMMENT '争议编号，唯一；数据级别：普通',
  `lead_ids` JSON NOT NULL COMMENT '涉及线索 ID 列表；数据级别：普通',
  `family_id` BIGINT NULL COMMENT '客户家庭 ID；数据级别：普通',
  `owner_candidates` JSON NOT NULL COMMENT '候选归属人列表；数据级别：普通',
  `restore_snapshot` JSON NULL COMMENT '误合并恢复快照；数据级别：普通',
  `arbitrate_status` VARCHAR(32) NOT NULL COMMENT '待仲裁/已通过/已驳回/已恢复；数据级别：普通',
  `approval_status` VARCHAR(32) NULL COMMENT '审批状态，未发起为空；数据级别：普通',
  `approval_instance_id` BIGINT NULL COMMENT '关联审批实例 ID；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_dispute_no` (`dispute_no`),
  KEY `idx_status` (`arbitrate_status`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='MergeDispute：撞单、合并与归属仲裁';