# school_wechat_fans 表文档

## 表概述
**表名**: school_wechat_fans  
**功能**: 微信粉丝管理表，负责管理教务系统中的微信公众号粉丝信息，包括粉丝基本信息、关注状态、地理位置、关注渠道等数据的存储和管理

## 字段说明

```
Field	Type	Collation	Null	Key	Default	Extra	Privileges	Comment
fans_id	int	NULL	NO	PRI	NULL	auto_increment	select,insert,update,references	粉丝ID
nickname	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	昵称
avatar	varchar(500)	utf8mb4_general_ci	NO				select,insert,update,references	头像
sex	smallint	NULL	NO		1		select,insert,update,references	性别
language	varchar(20)	utf8mb4_general_ci	NO				select,insert,update,references	用户语言
country	varchar(60)	utf8mb4_general_ci	NO				select,insert,update,references	国家
province	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	省
city	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	城市
district	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	行政区/县
openid	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	用户的标识，对当前公众号唯一     用户的唯一身份ID
unionid	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	粉丝unionid
groupid	int	NULL	NO		0		select,insert,update,references	粉丝所在组id
is_subscribe	tinyint	NULL	NO		1		select,insert,update,references	是否订阅
remark	varchar(255)	utf8mb4_general_ci	NO				select,insert,update,references	备注
subscribe_time	int	NULL	NO		0		select,insert,update,references	关注时间
subscribe_scene	varchar(100)	utf8mb4_general_ci	NO				select,insert,update,references	返回用户关注的渠道来源
unsubscribe_time	int	NULL	NO		0		select,insert,update,references	取消关注时间
update_time	int	NULL	NO		0		select,insert,update,references	粉丝信息最后更新时间
app_id	int	NULL	NO		0		select,insert,update,references	应用appid
```

## 功能用途

### 主要功能
- **粉丝信息管理**: 存储微信粉丝的基本信息（昵称、头像、性别等）
- **地理位置记录**: 记录粉丝的地理位置信息（国家、省、市、区县）
- **关注状态跟踪**: 跟踪粉丝的关注和取消关注状态
- **关注渠道分析**: 记录粉丝关注的渠道来源
- **粉丝分组管理**: 支持粉丝分组和标签管理
- **备注信息**: 支持对粉丝添加备注信息
- **时间记录**: 记录关注时间、取消关注时间、信息更新时间
- **多应用支持**: 支持多个微信应用的粉丝管理
- **用户识别**: 通过openid和unionid进行用户身份识别

### 业务场景
- **粉丝获取**: 用户关注微信公众号时自动创建粉丝记录
- **信息同步**: 定期同步微信平台的粉丝信息
- **精准营销**: 基于粉丝地理位置和属性进行精准推送
- **粉丝分析**: 分析粉丝来源渠道和关注趋势
- **客户服务**: 通过备注信息提供个性化客户服务
- **消息推送**: 向特定粉丝群体推送营销消息
- **数据统计**: 统计粉丝增长、流失等关键指标
- **用户画像**: 构建粉丝用户画像用于精准营销
- **活动推广**: 基于粉丝信息开展线上线下活动

## 关联关系

### 主要关联表
- `school_member`: 会员信息表 (粉丝与会员关联)
- `school_wechat_reply`: 微信回复表 (粉丝消息回复)
- `school_wechat_media`: 微信素材表 (推送素材管理)
- `school_template_message`: 模板消息表 (消息推送)
- `school_sys_notice_log`: 通知日志表 (消息推送记录)
- `school_customer_resources`: 客户资源表 (粉丝转化为客户)
- `school_order_table`: 订单表 (粉丝下单)
- `school_contract`: 合同表 (粉丝签约)

### 关联说明
- **会员关联**: 粉丝可以通过openid关联到会员账户
- **消息关联**: 粉丝接收的各种微信消息和回复
- **素材关联**: 向粉丝推送的图文、视频等素材
- **推送关联**: 模板消息和通知推送记录
- **客户关联**: 粉丝可以转化为潜在客户资源
- **业务关联**: 粉丝可以直接进行下单、签约等业务操作
- **应用关联**: app_id关联到具体的微信应用配置

## 索引建议
- **主键索引**: fans_id (已存在)
- **唯一索引**: 
  - openid (微信用户唯一标识)
  - unionid (跨应用用户标识)
- **业务索引**: 
  - app_id (应用查询)
  - is_subscribe (关注状态查询)
  - groupid (分组查询)
  - subscribe_scene (渠道分析)
- **复合索引**: 
  - (app_id, is_subscribe) (应用粉丝状态查询)
  - (app_id, groupid) (应用分组查询)
  - (province, city) (地理位置查询)
- **时间索引**: 
  - subscribe_time (关注时间查询)
  - update_time (更新时间查询)

## 注意事项
- **openid唯一性**: 同一应用下openid必须唯一
- **unionid一致性**: 同一用户在不同应用下unionid应该一致
- **隐私保护**: 粉丝信息涉及个人隐私，需要严格保护
- **数据同步**: 需要定期与微信平台同步粉丝信息
- **关注状态**: is_subscribe字段需要及时更新
- **地理位置**: 地理位置信息可能为空或不准确
- **时间格式**: 时间字段使用Unix时间戳格式
- **数据清理**: 需要定期清理长期未关注的粉丝数据
- **API限制**: 微信API调用有频率限制，需要合理控制
- **备注长度**: 备注信息不宜过长，影响查询性能
- **分组管理**: groupid为0表示未分组
- **多应用**: 同一用户在不同应用下会有不同的openid
- **数据备份**: 粉丝数据是重要的营销资源，需要定期备份
- **合规要求**: 粉丝信息使用需要符合相关法律法规