Web 营销模块 — CUJ 关键用户旅程

Campaigns, Automation, Discounts, Tagging, Research Platform | 更新时间: 2026-03-02

目录

CUJ 总览与优先级矩阵

营销模块架构

营销功能全景

flowchart TD
    subgraph Content["内容层"]
        ET["邮件模板 (Code)"]
        ED["邮件设计 (Canvas)"]
        ST["SMS 模板"]
        VB["可视化编辑器"]
    end

    subgraph Schema["Schema SSOT 层"]
        SS["变量 Schema (4 types)"]
        SL["Schema Loader"]
        LC["Legacy Compat"]
        VV["变量验证器"]
        CB["Context Builders (4)"]
    end

    subgraph Targeting["定向层"]
        TAG["自动标签"]
        SEG["客户分群"]
        DISC["折扣/优惠券"]
    end

    subgraph Execution["执行层"]
        CAMP["营销活动"]
        CC["Campaign Composer"]
        AUTO["自动化规则"]
        TRIG["触发器模板"]
    end

    subgraph Intelligence["分析层"]
        EXP["A/B 实验"]
        STR["营销策略"]
        RES["用户研究"]
        ANA["营销分析"]
    end

    ET --> CAMP
    ED --> CC
    CC --> CAMP
    ST --> CAMP
    VB --> ET
    VB --> ED
    SS --> SL
    SL --> VV
    SL --> CB
    LC --> CB
    CB --> ET
    CB --> ED
    CB --> ST
    TAG --> SEG
    SEG --> CAMP
    DISC --> CAMP
    TRIG --> AUTO
    ET --> AUTO
    ST --> AUTO
    CAMP --> ANA
    EXP --> ANA
    STR --> CAMP

    style CAMP fill:#c62828,stroke:#b71c1c,color:#fff
    style AUTO fill:#e65100,stroke:#bf360c,color:#fff
    style TAG fill:#1565c0,stroke:#0d47a1,color:#fff
    style EXP fill:#6a1b9a,stroke:#4a148c,color:#fff
    style SS fill:#00695c,stroke:#004d40,color:#fff
    style CC fill:#ad1457,stroke:#880e4f,color:#fff

模板变量体系 — Schema SSOT 架构 (v3.0)

4 种 Schema 类型

变量分类详情

CUJ-I1: 折扣与优惠券管理

P0 促销 — 创建折扣规则和优惠券

折扣类型

优惠券类型

BDD 场景

场景 I1.1: 创建百分比折扣 + 优惠券

测试: full-flow/02f-discount-crud.spec.ts

场景 I1.2: 折扣应用校验

测试: full-flow/02f-discount-crud.spec.ts

场景 I1.3: 折扣叠加策略

测试: 未覆盖

CUJ-I2: 邮件模板管理

P0 沟通 — 创建品牌一致的邮件模板（Schema-Driven 变量系统 v3.0）

Promotion 页面 Tab 结构 (6 tabs)

用户流程 — 邮件模板 (Code)

flowchart TD
    A["Promotion → Email Templates tab"] --> B["模板列表"]
    B --> C{"操作?"}
    C -->|"新建"| D["选择模板类型 (4 种)"]
    D -->|"Service"| E1["编辑器: 仅 service_email 变量"]
    D -->|"Promotion"| E2["编辑器: 仅 promotion_email 变量"]
    D -->|"Lifecycle"| E3["编辑器: 仅 lifecycle_email 变量"]
    D -->|"Transactional"| E4["编辑器: 仅 transactional_email 变量"]
    E1 --> F["VariableDrawer: Schema-Driven 变量选择器"]
    E2 --> F
    E3 --> F
    E4 --> F
    F --> G["插入 Handlebars 变量"]
    G --> H["预览 (示例数据)"]
    H --> I["发送测试邮件"]
    I --> J["保存"]
    C -->|"编辑"| F
    C -->|"复制"| K["Duplicate 模板"]

    style F fill:#00695c,stroke:#004d40,color:#fff
    style D fill:#2196F3,stroke:#1565C0,color:#fff
    style H fill:#4CAF50,stroke:#388E3C,color:#fff

用户流程 — 邮件设计 (Canvas) + Campaign

flowchart TD
    A["Promotion → Email Designs tab"] --> B["设计画廊 (缩略图)"]
    B -->|"新建"| C["Canvas 编辑器 (Fabric.js)"]
    C --> D["拖放元素 + 文本 + 图片"]
    D --> E["Canvas 变量选择器"]
    E --> F["保存设计"]
    F --> G["Promotion → Campaigns tab"]
    G -->|"新建 Campaign"| H["Step 1: 选择设计模板"]
    H --> I["Step 2: 填写标题/Subject + HTML 内容"]
    I --> J["Step 3: 选择收件人 (All/Segment/Manual)"]
    J --> K["Step 4: 预览 + 发送/定时"]
    K -->|"立即发送"| L["发送进度页 (实时刷新)"]
    K -->|"定时发送"| M["Scheduled 状态"]
    L --> N["追踪: 打开率/点击率/退订率"]
    B -->|"编辑"| C

    style C fill:#ad1457,stroke:#880e4f,color:#fff
    style H fill:#e65100,stroke:#bf360c,color:#fff
    style L fill:#4CAF50,stroke:#388E3C,color:#fff

变量选择器 UX (Schema-Driven)

BDD 场景

场景 I2.1: 创建 Service 邮件模板 — 变量按 Schema 过滤

测试: template-variable-schema.spec.ts, template-variable-system.spec.ts

场景 I2.2: 创建 Lifecycle 邮件模板 — 生日/召回场景

测试: template-variable-schema.spec.ts

场景 I2.3: 创建 Transactional 邮件模板 — 支付收据

测试: template-variable-schema.spec.ts

场景 I2.4: 变量类型隔离校验 (Schema-Driven)

测试: template-variable-schema.spec.ts

场景 I2.5: 发送测试邮件 (Context Builder)

测试: 部分覆盖 (API test only)

场景 I2.6: Legacy 变量兼容

测试: legacy-compat.test.js

CUJ-I3: SMS 模板管理

P1 触达 — 高打开率的短信通道

BDD 场景

场景 I3.1: 创建 SMS 模板

测试: 未覆盖

场景 I3.2: SMS 字符限制

测试: 未覆盖

CUJ-I4: 营销活动发送

P0 核心 — 4 步 Campaign Composer 创建并发送邮件活动

活动创建流程 — CampaignComposer (4 Steps)

flowchart TD
    A["Promotion → Campaigns tab"] --> B["活动列表"]
    B -->|"新建"| S1

    subgraph Composer["Campaign Composer (4-Step Wizard)"]
        S1["Step 1: 选择 Email Design 模板"]
        S1 --> S2["Step 2: Campaign 名称 + Subject + HTML 内容"]
        S2 --> S3["Step 3: 选择收件人"]
        S3 --> S4["Step 4: 预览 + 发送/定时"]
    end

    S3 -->|"All Guests"| S4
    S3 -->|"Segment"| S4
    S3 -->|"Manual (paste emails)"| S4

    S4 -->|"立即发送"| P["发送进度页 (每5秒刷新)"]
    S4 -->|"定时发送"| SC["Scheduled (可选 weekly/monthly 循环)"]
    P --> T["追踪: 打开率, 点击率, 退订率, 投诉率"]

    style S1 fill:#e65100,stroke:#bf360c,color:#fff
    style S4 fill:#c62828,stroke:#b71c1c,color:#fff
    style P fill:#4CAF50,stroke:#388E3C,color:#fff
    style T fill:#1565c0,stroke:#0d47a1,color:#fff

Campaign 生命周期

Campaign 进度与追踪页

BDD 场景

场景 I4.1: 4 步创建并发送邮件活动

测试: 未覆盖

场景 I4.2: 定时 + 循环发送

测试: 未覆盖

场景 I4.3: 手动收件人发送

测试: 未覆盖

CUJ-I5: 自动化触发与规则

P1 效率 — 事件驱动的自动化营销

触发器架构

flowchart LR
    subgraph Events["触发事件"]
        E1["appointment_booked"]
        E2["appointment_reminder"]
        E3["appointment_no_show"]
        E4["birthday"]
        E5["loyalty_milestone"]
    end

    subgraph Trigger["触发器模板"]
        T1["时机: 事件后 X 时间"]
        T2["执行时间: 9:00 AM"]
    end

    subgraph Action["自动化规则"]
        A1["选择邮件/SMS 模板"]
        A2["选择目标受众"]
    end

    Events --> Trigger
    Trigger --> Action
    Action --> SEND["自动发送"]

    style SEND fill:#4CAF50,stroke:#388E3C,color:#fff

BDD 场景

场景 I5.1: 创建自动提醒规则

测试: marketing/rule-management.spec.ts

场景 I5.2: 查看自动化执行日志

测试: marketing/rule-management.spec.ts

CUJ-I6: 客户自动标签

P1 精准 — 基于行为的自动客户分群

标签类别

BDD 场景

场景 I6.1: 创建自动标签规则

测试: 未覆盖

场景 I6.2: 创建组合标签

测试: 未覆盖

场景 I6.3: 按标签查询客户

测试: 未覆盖

CUJ-I7: 营销实验 A/B 测试

P2 数据 — 科学决策的实验框架

实验生命周期

flowchart LR
    D["Draft 草稿"] -->|"start"| R["Running 运行中"]
    R -->|"pause"| P["Paused 暂停"]
    P -->|"start"| R
    R -->|"complete"| C["Completed 完成"]
    D -->|"cancel"| X["Cancelled 取消"]
    R -->|"cancel"| X

    style D fill:#455a64,stroke:#37474f,color:#fff
    style R fill:#2e7d32,stroke:#1b5e20,color:#fff
    style C fill:#1565c0,stroke:#0d47a1,color:#fff

实验场景类型

BDD 场景

场景 I7.1: 创建并启动实验

测试: marketing/research.spec.ts（含 experiments 重定向兼容用例）

场景 I7.2: 分析实验结果

测试: marketing/research.spec.ts

场景 I7.3: 复制实验

测试: marketing/research.spec.ts

CUJ-I8: 营销策略管理

P2 规划 — 多渠道营销策略编排

策略类型

BDD 场景

场景 I8.1: 创建留存策略

测试: marketing/strategies.spec.ts

CUJ-I9: 用户研究平台

P2 洞察 — 收集客户反馈和行为数据

研究类型

研究生命周期

flowchart LR
    D["Draft"] --> R["Recruiting 招募中"]
    R --> A["Active 进行中"]
    A --> C["Completed 完成"]
    D --> X["Cancelled"]
    R --> X

    style A fill:#2e7d32,stroke:#1b5e20,color:#fff

BDD 场景

场景 I9.1: 创建调查研究

测试: marketing/research.spec.ts

场景 I9.2: 邀请参与者并追踪

测试: marketing/research.spec.ts

CUJ-I10: 营销分析

P1 度量 — 营销效果追踪与优化

BDD 场景

场景 I10.1: 查看活动效果

测试: marketing/analytics.spec.ts

跨模块依赖

业务规则

1. 变量 Schema 隔离 (4 类型)：每种 Schema 类型严格限定可用变量。service_email 含 appointment/services/technician，promotion_email 含 campaign，lifecycle_email 含 guest 生命周期字段，transactional_email 含 transaction (items[])。跨类型变量使用在保存时被 validateAgainstSchema() 校验。
2. Pre-Send Validation (Feature Flag)：自动化发送前 _validateVariableContext() 检查缺失/未知变量，仅记录结构化警告 (warn-only)，不阻断发送。由 VARIABLE_SCHEMA_VALIDATION feature flag 控制。
3. Legacy 变量兼容：旧模板的平面变量名 (如 customer_name) 通过 legacy-compat.js 自动映射到嵌套格式 (如 guest.name)。每次 legacy 映射会记录结构化日志。
4. 优惠券 1:1：每个 discount_rule 对应恰好一个 coupon 记录，统一 CRUD。
5. 折扣叠加策略：三种模式 — "best"（取最高）、"stack"（叠加）、"member_first"（会员优先再叠促销）。
6. 标签评估幂等：重复评估同一标签定义不会创建重复标签记录。
7. 触发器系统/租户分离：trigger_templates 存储在 public schema（系统级 + 租户自定义），automation_rules 存储在租户 schema。
8. 实验参与者不可交叉：同一客户在同一实验中只能属于一个组。
9. 消息发送限流：邮件和 SMS 发送受熔断器控制，主供应商断路时自动切换备用。
10. 模板继承：系统模板 (is_system: true) 只读，租户可复制为自定义模板后编辑。
11. Campaign 4 步 Composer：必须先有保存的 Email Design 才能创建 Campaign。Step 1 选设计 → Step 2 填元数据 → Step 3 选收件人 → Step 4 预览+发送/定时。