Web 客户模块 — CUJ 关键用户旅程

Guest/Customer Management · CRM · VIP · Tags | 更新时间: 2026-02-08

TOUCHES 追溯

架构概览：客户数据模型

erDiagram
    guests ||--o{ guest_notes : "has notes"
    guests ||--o{ guest_tags : "has tags"
    guests ||--o{ guest_relationships : "has relationships"
    guests ||--o{ appointments : "has appointments"
    guests ||--o{ gift_cards : "owns/receives"
    guests ||--o{ guest_verification_codes : "OTP codes"
    guests ||--o{ guest_merge_logs : "merge audit"

    guests {
        string id PK "guest_{ts}_{random}"
        string name "Full name"
        string phone "Optional for anonymous"
        string email "Optional"
        enum account_type "anonymous | identified | registered"
        string password_hash "Only for registered"
        enum vip_status "none | bronze | silver | gold | platinum"
        int vip_points "Loyalty points"
        int visit_count "Total visits"
        numeric total_spent "Lifetime value"
        boolean blacklist_status "Block flag"
        string blacklist_reason "Admin note"
        jsonb service_preferences "Allergies, prefs, comms"
        string preferred_language "en | zh | es | vi | ko"
        string inferred_preferred_time "AI calculated"
        string source "kiosk | web_booking | staff | zenoti"
    }

三级客户模型

VIP 等级体系

权限矩阵

目录

CUJ 总览与优先级矩阵

CUJ-E1: 客户列表与搜索

P0 CRM 基础 — 搜索和浏览客户

用户流程

flowchart TD
    A["侧边栏点击 Guests"] --> B["客户列表 /guests"]
    B --> C{"操作"}
    C -->|"搜索"| D["输入姓名/手机号 → 实时筛选"]
    C -->|"筛选"| E["门店筛选 useStoreFilter + 显示非活跃"]
    C -->|"点击行"| F["跳转客户详情 /guests/id"]
    C -->|"添加客户"| G["打开创建表单/弹窗"]
    D --> B
    E --> B

    style B fill:#2196F3,stroke:#1565C0,color:#fff

BDD 场景

场景 E1.1: 客户列表加载

测试: customers/list.spec.ts

场景 E1.2: 搜索客户（姓名 + 手机号）

测试: customers/list.spec.ts

场景 E1.3: 门店筛选与非活跃客户

CUJ-E2: 客户详情 360° 视图

P0 完整客户画像 — 查看客户全维度信息

用户流程

flowchart TD
    A["客户列表点击行"] --> B["客户详情页 /guests/id"]
    B --> H{"黑名单?"}
    H -->|"是"| BW["BlacklistWarning 横幅"]
    H -->|"否"| C

    B --> C["头部: 姓名 + VipBadge + 基础统计"]
    C --> TAB{"Tab 切换"}
    TAB --> T1["基本信息: 姓名、手机、邮箱、性别、DOB、语言"]
    TAB --> T2["预约历史: AppointmentHistory 时间线"]
    TAB --> T3["消费记录: 总额、平均客单价"]
    TAB --> T4["备注: GuestNotes (6 类型)"]
    TAB --> T5["偏好: ServicePreferences"]
    TAB --> T6["礼品卡: GuestGiftCards"]
    TAB --> T7["关系: GuestRelationships"]
    TAB --> T8["标签: GuestTagsList"]

    T1 --> ED{"编辑?"}
    ED -->|"是"| EF["GuestEditForm 内联编辑"]

    style B fill:#2196F3,stroke:#1565C0,color:#fff
    style BW fill:#c62828,stroke:#b71c1c,color:#fff

BDD 场景

场景 E2.1: 查看客户概览

测试: customers/details.spec.ts

场景 E2.2: 查看预约历史时间线

场景 E2.3: 编辑客户基本信息

场景 E2.4: 查看礼品卡摘要

CUJ-E3: 创建新客户

P1 客户数据积累 — Walk-in、电话预约、预约中添加

BDD 场景

场景 E3.1: 通过专用页面创建客户

测试: customers/create.spec.ts

场景 E3.2: 重复手机号检测

场景 E3.3: 预约流程中创建客户

CUJ-E4: 客户备注管理

P1 服务质量 — 技师间信息共享，私密备注保护

备注类型

BDD 场景

场景 E4.1: 创建和置顶备注

场景 E4.2: 私密备注权限控制

场景 E4.3: 编辑和删除备注

CUJ-E5: 服务偏好与过敏记录

P1 个性化服务 — 偏好技师、过敏安全、沟通设置

偏好数据结构

BDD 场景

场景 E5.1: 编辑服务偏好

场景 E5.2: 沟通偏好设置

CUJ-E6: VIP 忠诚度管理

P1 客户留存 — 5 级 VIP 体系，积分累积与等级升降

BDD 场景

场景 E6.1: 查看 VIP 状态与进度

场景 E6.2: 管理员调整 VIP 等级

场景 E6.3: 满级 Platinum 展示

CUJ-E7: 客户关系与标签

P2 关联客户 — 家庭/朋友关系 + 自动/手动标签分群

关系类型

标签类别

BDD 场景

场景 E7.1: 添加客户关系

测试: customers/relationships.spec.ts

场景 E7.2: 按标签筛选客户

CUJ-E8: 重复客户检测与合并

P2 数据质量 — 检测并合并重复客户记录

合并流程

flowchart TD
    A["管理员 → /admin/guests/duplicates"] --> B["系统检测重复组"]
    B --> C["显示: 相似度分数 + 匹配原因(手机/邮箱)"]
    C --> D{"选择操作"}
    D -->|"合并"| S1["Step 1: 选择主记录"]
    S1 --> S2["Step 2: 选择要合并的副本"]
    S2 --> S3["确认合并(不可逆警告)"]
    S3 --> R["合并结果"]
    R --> R1["预约历史合并到主记录"]
    R --> R2["积分累加，VIP 取最高"]
    R --> R3["副本标记 inactive"]
    R --> R4["guest_merge_logs 审计记录"]
    D -->|"忽略"| IGN["标记为已忽略"]

    style S3 fill:#c62828,stroke:#b71c1c,color:#fff

BDD 场景

场景 E8.1: 查看重复客户

场景 E8.2: 执行合并（3 步向导）

场景 E8.3: 合并约束 — 有活跃预约

CUJ-E9: 黑名单管理

P2 风险控制 — 管理问题客户，阻止预约

BDD 场景

场景 E9.1: 添加客户到黑名单

场景 E9.2: 黑名单列表管理

场景 E9.3: 移除黑名单

跨模块链接

业务规则