表单、线索与邮件

本页由 docs:sync 从数据库结构生成，请勿手工编辑。

leads

字段	类型	可空	默认	说明
id	bigint unsigned	否	—	—
tenant_id	bigint unsigned	否	—	—
site_id	bigint unsigned	否	—	—
session_id	bigint unsigned	是	—	—
name	varchar(100)	否	—	访客称呼
phone	varchar(50)	否	—	联系电话
email	varchar(255)	是	—	—
message	text	是	—	需求留言
meta	json	是	—	自定义表单字段提交值
source	varchar(20)	否	widget	线索来源
status	varchar(20)	否	new	new 待跟进 / handled 已跟进
tags	json	是	—	标签数组（站点标签库中的名字）
created_at	timestamp	是	—	—
updated_at	timestamp	是	—	—
form_key	varchar(40)	是	—	来源表单 key（null=默认联系表单/客服挂件）
note	text	是	—	跟进备注（销售记录沟通结果）
notified_at	timestamp	是	—	新线索通知已投递队列的时间
notify_error	varchar(60)	是	—	未通知原因：mail_unconfigured / no_recipient

site_forms

字段	类型	可空	默认	说明
id	bigint unsigned	否	—	—
tenant_id	bigint unsigned	否	—	—
site_id	bigint unsigned	否	—	—
key	varchar(40)	否	—	表单引用键（{% contact_form "key" %} 与提交归属用）
name	varchar(60)	否	—	表单名（如「简历投递」）
fields	json	否	—	字段定义 [{name,label,type,required}]；name/phone 身份字段始终必填
created_at	timestamp	是	—	—
updated_at	timestamp	是	—	—
notify_emails	varchar(500)	是	—	该表单线索的收件邮箱（逗号分隔，可为非系统用户）；留空=用站点默认收件人

subscribers

字段	类型	可空	默认	说明
id	bigint unsigned	否	—	—
tenant_id	bigint unsigned	否	—	—
site_id	bigint unsigned	否	—	—
email	varchar(255)	否	—	订阅邮箱
status	varchar(20)	否	subscribed	subscribed / unsubscribed
token	varchar(64)	否	—	退订令牌（邮件底部退订链接）
source	varchar(100)	是	—	订阅来源页路径
created_at	timestamp	是	—	—
updated_at	timestamp	是	—	—

mail_campaigns

字段	类型	可空	默认	说明
id	bigint unsigned	否	—	—
tenant_id	bigint unsigned	否	—	—
site_id	bigint unsigned	否	—	—
subject	varchar(200)	否	—	邮件主题
body_html	text	否	—	正文 HTML（发送前净化）
audience_type	varchar(20)	否	subscribers	收件人来源：subscribers / leads
audience_tags	json	是	—	线索受众的标签筛选（空=全部）
status	varchar(20)	否	queued	queued / sending / paused_limit / sent / failed
total	int unsigned	否	0	目标收件人数
sent_count	int unsigned	否	0	—
failed_count	int unsigned	否	0	—
created_by	bigint unsigned	是	—	—
sent_at	timestamp	是	—	—
created_at	timestamp	是	—	—
updated_at	timestamp	是	—	—

mail_logs

字段	类型	可空	默认	说明
id	bigint unsigned	否	—	—
tenant_id	bigint unsigned	否	—	—
site_id	bigint unsigned	否	—	—
campaign_id	bigint unsigned	否	—	—
email	varchar(255)	否	—	—
status	varchar(20)	否	—	sent / failed
error	varchar(500)	是	—	—
created_at	timestamp	是	—	—
updated_at	timestamp	是	—	—

mail_settings

字段	类型	可空	默认	说明
id	bigint unsigned	否	—	—
host	varchar(255)	是	—	SMTP 服务器
port	int unsigned	否	465	—
encryption	varchar(10)	否	ssl	ssl / tls / none
username	varchar(255)	是	—	—
password	text	是	—	Crypt 加密存储
from_address	varchar(255)	是	—	发件人地址（多与 username 一致）
from_name	varchar(100)	是	—	发件人显示名
batch_size	int unsigned	否	30	每批发送封数（批间隔 1 分钟防触发邮件商风控）
daily_limit	int unsigned	否	500	每日发送上限（防滥发）
created_at	timestamp	是	—	—
updated_at	timestamp	是	—	—