# 营销（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 渠道的自动跟进规则
