storlead-sasa-platform/java/storlead-crm/storlead-marketing

营销（storlead-marketing）功能需求与设计说明

对应目录：storlead-marketing · Maven artifactId：storlead-marketing · Java 包根：com.storlead.crm.marketing

1. 模块目标

基于“创建营销活动”四步向导，为销售团队提供可执行、可追踪、可自动化的邮件营销能力。当前版本聚焦邮件渠道，不包含 WhatsApp、LinkedIn、微信企业号等多渠道触达。

2. 核心业务流程（四步向导）

1. 基本信息：定义活动名称、类型、优先级、周期、负责人、活动描述和活动目标。
2. 目标客户：基于客户分群和筛选条件圈定触达对象，形成目标客户包。
3. 触达渠道：配置邮件触达参数（发件账号、发送策略、模板、主题、正文）。
4. 自动化规则：配置 SOP 序列和跟进规则，保存并执行活动。

2.1 智能寻客任务展示约束（新增）

• 营销侧“智能寻客任务”展示区的数据来源，必须是用户在“创建智能寻客任务”流程中实际创建并保存成功的任务数据。
• 展示层禁止使用硬编码、Mock 假数据或与任务主记录无关联的缓存拼装数据。
• 任务列表最少展示：任务名称、创建人、创建时间、当前状态、目标客户规模、最近执行时间。
• 任务详情需要可回溯到创建时配置：策略条件、画像参数、筛选条件、渠道选择与自动化规则版本。
• 当创建任务被修改或重跑后，展示页需实时反映最新任务版本，并保留历史执行记录入口。

3. 详细功能需求

3.1 基本信息页

功能项

• 活动基础字段维护：活动名称、活动类型、优先级、开始日期、结束日期、负责人、活动描述。
• 活动目标输入：支持录入本次活动目标值（如触达量、打开量、回复量等）。
• AI 辅助：支持“一键生成活动名称”“智能生成活动描述和策略”。

设计要求

• 页面校验：活动名称、负责人、开始/结束日期为必填。
• 日期校验：结束日期不能早于开始日期。
• 目标值校验：仅允许非负整数。
• 当前版本去除“关联商机”和“商机数”目标字段。

3.2 目标客户页

功能项

• 预设客户包：全部潜客、本周新增、高意向客户、沉默客户。
• AI 智能推荐客户包（系统可按活动类型推荐优先人群）。
• 高级筛选：地区、行业、意向分数、客户规模、关键词搜索。
• 结果展示：展示已选择客户数、来源分布，并支持“预览客户”。

设计要求

• “已选择客户”数量需实时更新，并作为下一步可执行前置条件。
• 支持“清除筛选”和回退上一步后保留筛选条件。
• 当前版本去除“客户阶段”“采购意向”两个筛选维度。

3.3 触达渠道页（当前仅邮件）

功能项

• 渠道选择：只启用“邮件营销”。
• 邮件发送设置：发件邮箱、发送时间（含 AI 推荐时段）、单批发送量。
• 内容设置：邮件模板、邮件主题、邮件正文、AI 生成正文。
• 追踪设置：邮件打开追踪。

设计要求

• 仅允许单渠道邮件，不展示或不启用 WhatsApp、LinkedIn、微信企业号。
• 邮件主题必填，正文必填（或由 AI 生成后自动填充）。
• 发件邮箱必须是已验证账号。
• 当前版本不启用“追踪链接点击”“追踪客户回复”勾选项。
• 当前版本不展示“渠道效果预测”卡片（预计打开率/回复率/转化率）。

3.4 自动化规则页

功能项

• SOP 序列模板：标准开发序列、快速跟进序列、培育序列、唤醒序列。
• 序列步骤展示：按顺序显示动作（邮件、电话等），支持重定义步骤文案。
• 跟进规则开关：
  
  • 未打开邮件自动跟进（可配置等待天数）
    
  • 未点击链接跟进（可配置等待天数）
    
  • 客户回复后停止自动化

设计要求

• 规则粒度为“活动级”，生效范围是本活动所有目标客户。
• 等待天数支持可配置下拉值（如 1/3/5/7 天）。
• 规则冲突时优先级：停止类规则 > 跟进类规则。
• 当前版本去除“未回复自动跟进（依赖 WhatsApp/LinkedIn）”与“客户预约后停止自动化”。

4. 活动状态与执行设计

状态定义

• 草稿：向导未完成或仅保存未提交。
• 待执行：已配置完成，等待到达发送时间。
• 执行中：发送任务或自动化规则正在运行。
• 已完成：活动执行完毕且无后续动作。
• 已暂停：人工暂停，不再触发自动动作。

状态流转

• 草稿 -> 待执行 -> 执行中 -> 已完成
• 执行中 -> 已暂停（人工操作）
• 已暂停 -> 执行中（恢复）

5. 数据展示与运营支持

• 活动列表需支持按状态、负责人、日期范围筛选。
• 活动详情需展示：
  • 目标客户规模
  • 实际触达数
  • 邮件打开表现
  • 自动化规则命中次数
• 支持活动复用：以历史活动为模板创建新活动。

6. 权限与边界

权限

• 活动创建/编辑：营销负责人及授权角色。
• 活动审批/发布（如有）：管理角色。
• 查看权限：按租户和团队范围隔离。

模块边界

• 本模块负责活动编排、目标客户圈选、邮件触达配置、自动化规则执行编排。
• 邮件底层投递能力由 storlead-email 或基础消息能力承接。
• 客户主数据维护由 storlead-customer 承接。

7. 本期范围说明（与页面标注一致）

本期保留：

• 邮件营销单渠道
• 客户分群与高级筛选（不含客户阶段/采购意向）
• SOP 模板与基础自动化规则

本期不做：

• WhatsApp、LinkedIn、微信企业号渠道
• 关联商机与商机目标字段
• 链接点击与客户回复追踪
• 触达效果预测卡片
• 依赖外部 IM 渠道的自动跟进规则