storlead-mail-service/storlead-mail

storlead-mail 子模块说明

邮件服务拆为四个 Maven 子模块，避免 CRM 与营销业务混在一起，调度统一编排。

模块

模块	Artifact	职责
common	storlead-mail-common	账户(smtp_pop_settings)、SMTP/IMAP 连接、公共投递、MailSceneEnum
crm	storlead-mail-crm	CRM 个人邮箱：emails / client_sent_emails、收信、文件夹、CRM 集成任务
mkt	storlead-mail-mkt	营销投递：mkt_mail_message / mkt_mail_attachment、草稿、附件、延时、打开追踪
dispatch	storlead-mail-dispatch	统一调度：定时发送（CRM+MKT）、CRM 收信拉取、服务器邮件延迟删除

依赖方向：

crm → common
mkt → common
dispatch → crm + mkt
api → dispatch

crm 与 mkt 互不依赖；调度放在 dispatch，避免任务只挂在 crm 里。

包名

• com.storlead.sales.mail.common.*
• com.storlead.sales.mail.crm.*
• com.storlead.sales.mail.mkt.*
• com.storlead.sales.mail.dispatch.*

API：

• com.storlead.mail.common — 账户配置
• com.storlead.mail.crm — CRM 邮件接口（原 /mail/**）
• com.storlead.mail.mkt — 营销接口（/mail/mkt/**）
  • POST /mail/mkt/file/cache_mail_file — 上传临时附件（scene=MKT，需 accountId）
  • POST /mail/mkt/file/list — 按邮件查正式附件 mkt_mail_attachment
  • POST /mail/mkt/file/download — 下载正式附件
  • POST /mail/mkt/file/download_temp — 下载临时附件
  • POST /mail/mkt/save_draft — 保存草稿（status=-2，绑定 fileIds/oldFileIds）
  • POST /mail/mkt/send — 发送（CID 内嵌图、附件、延时、追踪像素）
  • POST /mail/mkt/detail — 详情（草稿带临时附件，成功带正式附件）
  • GET /mail/mkt/track/{token} — 打开追踪像素

临时附件共用 mail_temp_attachment（scene 默认 CRM）；正式附件 CRM/MKT 分表。

调度任务

Job	覆盖范围
DelaySendEmailTaskJob	CRM 延时发信 + 营销延时发信
EmailPullHeadContentTaskJob	仅 CRM 收信（营销账户默认不收）
DelayDeleteServerEmailTaskJob	仅 CRM IMAP 服务器删除

库表变更

执行：storlead-mail-common/src/main/resources/sql/mail_scene_and_mkt.sql

• smtp_pop_settings 增加 scene / account_scope / org_id 等
• 新建 mkt_mail_message、mkt_mail_attachment
• mail_temp_attachment 增加 scene（默认 CRM）