# school_customer_resources 表文档

## 表概述
**表名**: school_customer_resources  
**功能**: 客户资源管理表，负责管理教务系统中的潜在客户信息、销售线索跟踪、客户转化流程等客户关系管理功能

## 字段说明

```
Field	Type	Collation	Null	Key	Default	Extra	Privileges	Comment
id	int	NULL	NO	PRI	NULL	auto_increment	select,insert,update,references	编号
member_id	int	NULL	YES		0		select,insert,update,references	会员表id(登录时使用member表)
create_year_month	varchar(7)	utf8mb4_general_ci	NO		NULL		select,insert,update,references	入会时间
create_date	date	NULL	NO		NULL		select,insert,update,references	创建日期
source_channel	varchar(255)	utf8mb4_general_ci	NO		NULL		select,insert,update,references	来源渠道|0=线下
source	varchar(255)	utf8mb4_general_ci	NO		NULL		select,insert,update,references	来源
consultant	varchar(255)	utf8mb4_general_ci	NO		NULL		select,insert,update,references	顾问
name	varchar(255)	utf8mb4_general_ci	NO		NULL		select,insert,update,references	姓名
age	varchar(5)	utf8mb4_general_ci	YES		NULL		select,insert,update,references	年龄
gender	enum('male','female','other')	utf8mb4_general_ci	NO		NULL		select,insert,update,references	性别: male-男性, female-女性, other-其他
phone_number	varchar(15)	utf8mb4_general_ci	NO	UNI	NULL		select,insert,update,references	联系电话|唯一的
demand	text	utf8mb4_general_ci	YES		NULL		select,insert,update,references	需求
purchasing_power	varchar(255)	utf8mb4_general_ci	YES		NULL		select,insert,update,references	购买力
cognitive_idea	text	utf8mb4_general_ci	YES		NULL		select,insert,update,references	认知理念
optional_class_time	varchar(255)	utf8mb4_general_ci	YES		NULL		select,insert,update,references	可选上课时间
distance	varchar(255)	utf8mb4_general_ci	YES		NULL		select,insert,update,references	距离
decision_maker	varchar(255)	utf8mb4_general_ci	YES		NULL		select,insert,update,references	决策人
initial_intent	varchar(10)	utf8mb4_general_ci	YES		NULL		select,insert,update,references	客户初步意向度: high-高, medium-中, low-低
campus	int	NULL	YES		NULL		select,insert,update,references	所属校区
trial_class_count	int	NULL	YES		0		select,insert,update,references	体验课次数|默认0
created_at	timestamp	NULL	YES		CURRENT_TIMESTAMP	DEFAULT_GENERATED	select,insert,update,references	创建时间
updated_at	timestamp	NULL	YES		CURRENT_TIMESTAMP	DEFAULT_GENERATED on update CURRENT_TIMESTAMP	select,insert,update,references	更新时间
deleted_at	int	NULL	NO		0		select,insert,update,references	逻辑删除时间
member_label	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	会员标签
rf_type	varchar(255)	utf8mb4_general_ci	YES		NULL		select,insert,update,references	资源新增类型market市场人员新增sale销售人员新增teacher教练新增
status	varchar(15)	utf8mb4_general_ci	YES		NULL		select,insert,update,references	客户状态
miniopenid	varchar(255)	utf8mb4_general_ci	YES		NULL		select,insert,update,references	小程序 openid
wechatopenid	varchar(255)	utf8mb4_general_ci	YES		NULL		select,insert,update,references	公众号 openid
referral_resource_id	int	NULL	YES		0		select,insert,update,references	推荐人资源ID
password	varchar(255)	utf8mb4_general_ci	YES				select,insert,update,references	会员密码
login_ip	varchar(255)	utf8mb4_general_ci	YES				select,insert,update,references	当前登录ip
login_count	int	NULL	YES		0		select,insert,update,references	登录次数
login_time	int	NULL	YES		0		select,insert,update,references	当前登录时间
blacklist	tinyint	NULL	YES		1		select,insert,update,references	是否加入黑名单1 可追单 0 黑名单
```

## 功能用途

### 主要功能
- **客户信息管理**: 管理潜在客户的基本信息和联系方式
- **来源渠道跟踪**: 记录客户的来源渠道和获客方式
- **销售线索管理**: 跟踪客户的购买意向和决策过程
- **顾问分配**: 为客户分配专属销售顾问进行跟进
- **意向度评估**: 评估和记录客户的购买意向强度
- **体验课管理**: 记录客户的体验课参与情况
- **推荐关系**: 管理客户推荐关系和转介绍业务
- **黑名单管理**: 控制不良客户的追单权限
- **登录账户**: 支持客户登录查看相关信息
- **微信集成**: 关联小程序和公众号用户身份

### 业务场景
- **线索收集**: 从各种渠道收集潜在客户信息
- **销售跟进**: 销售顾问跟进客户并记录沟通情况
- **体验课安排**: 为潜在客户安排和记录体验课
- **意向评估**: 评估客户购买意向并制定跟进策略
- **转化分析**: 分析不同渠道的客户转化效果
- **推荐奖励**: 处理客户推荐带来的新客户
- **客户服务**: 为已注册客户提供信息查询服务
- **营销活动**: 基于客户标签进行精准营销
- **数据分析**: 分析客户来源、转化率等关键指标

## 关联关系

### 主要关联表
- `school_member`: 会员信息表 (member_id)
- `school_campus`: 校区信息表 (campus)
- `school_personnel`: 人员信息表 (顾问关联)
- `school_course_schedule`: 课程安排表 (体验课关联)
- `school_order_table`: 订单信息表 (转化订单)
- `school_contract`: 合同信息表 (签约转化)
- `school_follow_record`: 跟进记录表 (客户跟进)
- `school_trial_class`: 体验课记录表 (体验课管理)

### 关联说明
- **会员关联**: member_id关联正式会员，支持客户转化为正式学员
- **校区关联**: campus确定客户所属校区，便于就近服务
- **顾问关联**: consultant字段关联销售顾问，支持客户分配和跟进
- **推荐关联**: referral_resource_id建立客户推荐关系链
- **体验课关联**: trial_class_count记录体验课参与情况
- **转化关联**: 通过订单和合同表跟踪客户转化结果
- **微信关联**: 通过openid关联微信生态用户身份

## 索引建议
- **主键索引**: id (已存在)
- **唯一索引**: phone_number (已存在，客户唯一标识)
- **外键索引**: 
  - member_id (会员关联查询)
  - campus (校区客户查询)
  - referral_resource_id (推荐关系查询)
- **业务索引**: 
  - status (客户状态查询)
  - initial_intent (意向度查询)
  - source_channel (来源渠道分析)
  - consultant (顾问客户查询)
  - rf_type (资源类型查询)
  - blacklist (黑名单过滤)
- **时间索引**: 
  - create_date (创建日期查询)
  - create_year_month (月度统计)
  - created_at (创建时间查询)
  - login_time (登录时间查询)
- **软删除索引**: deleted_at (有效客户查询)
- **复合索引**: 
  - (campus, status, deleted_at) (校区有效客户查询)
  - (consultant, status) (顾问客户状态查询)
  - (source_channel, create_date) (渠道效果分析)
  - (initial_intent, status) (意向客户查询)
- **微信索引**: 
  - miniopenid (小程序用户查询)
  - wechatopenid (公众号用户查询)

## 注意事项
- **手机号唯一性**: phone_number字段具有唯一约束，确保客户不重复
- **性别枚举**: gender字段使用枚举类型，只能是male/female/other
- **意向度标准**: initial_intent使用high/medium/low标准化意向度评估
- **软删除机制**: deleted_at字段控制逻辑删除，保证数据完整性
- **密码安全**: password字段需要加密存储，不能明文保存
- **登录控制**: 通过login_count和login_time跟踪客户登录行为
- **黑名单逻辑**: blacklist字段控制追单权限（1=可追单，0=黑名单）
- **推荐关系**: referral_resource_id建立推荐链，需要防止循环推荐
- **体验课计数**: trial_class_count需要与实际体验课记录保持一致
- **校区归属**: campus字段确定客户归属，影响服务分配
- **来源跟踪**: source_channel和source字段用于渠道效果分析
- **顾问分配**: consultant字段需要与人员表保持一致性
- **微信绑定**: openid字段用于微信生态集成，需要保证唯一性
- **数据完整性**: 客户转化为会员时需要同步更新member_id
- **时间一致性**: create_date和created_at需要保持逻辑一致
- **标签管理**: member_label支持多标签，建议使用JSON格式
- **状态流转**: status字段变更需要记录变更日志
- **权限控制**: 不同角色对客户信息的访问权限需要严格控制