跳到主要内容

customer-conversion Specification

Purpose​

TBD - created by archiving change add-lead-management-system. Update Purpose after archive.

Requirements​

Requirement: 线索转客户入口​

系统 MUST 在个人线索管理页面提供"转化为客户"按钮,允许用户将线索转化为客户。

Scenario: 单条线索转化​

  • WHEN 用户在个人线索列表中选择一条线索,点击"转化为客户"按钮
  • THEN 系统打开转化弹窗,自动填充线索信息到客户字段

Scenario: 批量线索合并转化​

  • WHEN 用户选择多条线索(如2-3条),点击"批量转化为客户"按钮
  • THEN 系统打开转化弹窗,校验所选线索是否可以合并(介绍人、线索来源、活动名称必须一致),通过后展示合并后的信息

Scenario: 已转化线索隐藏入口​

  • WHEN 线索状态="已转化"
  • THEN 系统在操作列显示"查看客户"按钮,隐藏"转化为客户"按钮

Requirement: 线索信息核实​

系统 MUST 在转化弹窗的第一区块展示线索信息,包括品牌名称、品牌国家/地区、介绍人、线索来源、活动名称,多条线索合并时展示最新一条的信息。

Scenario: 展示线索信息​

  • WHEN 用户打开转化弹窗
  • THEN 系统在"线索信息核实区"展示:品牌名称(自动带入,可修改)、品牌国家/地区(自动带入,可修改)、介绍人(自动带入)、线索来源(自动带入,不可修改)、活动名称(自动带入,不可修改)

Scenario: 多线索合并校验成功​

  • WHEN 用户选择2条线索转化,这2条线索的介绍人、线索来源、活动名称字段值一致
  • THEN 系统允许合并,展示合并后的信息(最新一条线索的数据)

Scenario: 多线索合并校验失败​

  • WHEN 用户选择2条线索转化,这2条线索的介绍人字段值不一致
  • THEN 系统提示"所选线索的介绍人不一致,无法合并",并阻止转化

Scenario: 删除线索带入信息​

  • WHEN 用户点击客户名称字段的"快捷删除"图标
  • THEN 系统清空该字段(用户可手动输入其他内容)

Requirement: 客户信息填写​

系统 MUST 在转化弹窗的第二区块要求用户填写客户信息,包括客户名称、客户类型、门店Logo、旗下店铺数、企业经营模式、企业知名度、客户等级、归属销售组织、归属销售人员、客户注册地国家/地区、关键联系人、联系人职务、联系人手机号、联系人邮箱、企业识别码类型、企业识别号码等必填字段。

Scenario: 自动填充客户名称​

  • WHEN 线索信息中公司名称="海底捞国际控股有限公司"
  • THEN 系统自动填充客户名称="海底捞国际控股有限公司",用户可修改或删除

Scenario: 选择客户类型​

  • WHEN 用户选择客户类型下拉选项
  • THEN 系统显示枚举值:国内客户、中餐出海客户、海外客户、渠道客户
  • WHEN 线索信息中包含门店Logo
  • THEN 系统自动填入Logo图片,用户可删除并重新上传

Scenario: 填写企业识别码​

  • WHEN 用户选择企业识别码类型="中国统一社会信用代码",输入企业识别号码="91110000XXXXXX"
  • THEN 系统校验格式并校验该识别码在全局唯一,通过后允许保存

Scenario: 企业识别码唯一性校验失败​

  • WHEN 用户输入的企业识别号码在客户表中已存在
  • THEN 系统提示"该企业识别码已存在,请检查",并阻止保存

Scenario: 联系人信息二选一必填​

  • WHEN 用户未填写联系人手机号和联系人邮箱
  • THEN 系统提示"联系人手机号和邮箱至少填写一项",并阻止保存

Scenario: 国际手机号格式校验​

  • WHEN 用户选择区号="+1"(美国),输入手机号="1234567890"
  • THEN 系统组合校验完整号码是否符合美国手机号格式,通过后允许保存

Scenario: 归属销售人员和组织自动填充​

  • WHEN 线索归属人为"张三",归属部门为"销售部-华北区"
  • THEN 系统自动填充归属销售人员="张三",归属销售组织="销售部-华北区",用户可修改或删除

Requirement: 品牌信息操作​

系统 MUST 在转化弹窗的第三区块要求用户填写或确认品牌信息,包括品牌名称、品牌业态、品牌描述等字段。

Scenario: 自动填充品牌名称​

  • WHEN 线索信息中品牌名称="海底捞"
  • THEN 系统自动填充品牌名称="海底捞",用户可修改

Scenario: 自动填充品牌业态​

  • WHEN 线索信息中品牌业态="正餐"
  • THEN 系统自动填充品牌业态="正餐",用户可修改

Scenario: 填写品牌描述​

  • WHEN 用户在品牌描述字段输入品牌故事和定位(如"海底捞成立于1994年,以火锅为主营业务...")
  • THEN 系统保存该描述(最多1000字符,支持富文本)

Requirement: 客户创建与关联​

系统 MUST 在用户确认提交后创建客户记录,生成唯一客户ID,建立线索-客户关联关系,更新线索状态为"已转化"。

Scenario: 单条线索转化成功​

  • WHEN 用户填写所有必填字段并点击"确定"按钮
  • THEN 系统创建客户记录,生成客户ID(规则:C+年月日+6位流水号,如"C20260126000001"),记录关联线索ID,更新线索状态="已转化",线索操作列切换为"查看客户"

Scenario: 批量线索转化成功​

  • WHEN 用户选择3条线索并批量转化
  • THEN 系统创建1条客户记录,记录关联的3个线索ID,更新这3条线索的状态为"已转化"

Scenario: 转化成功提示​

  • WHEN 客户创建成功
  • THEN 系统提示"客户创建成功",并跳转到客户详情页

Scenario: 转化失败回滚​

  • WHEN 客户创建失败(如企业识别码重复)
  • THEN 系统不创建客户记录,不更新线索状态,提示失败原因,弹窗保持打开

Requirement: 客户名称唯一性校验​

系统 MUST 在提交前校验客户名称在全局范围内唯一,避免重复创建客户。

Scenario: 客户名称唯一性校验通过​

  • WHEN 用户输入客户名称="海底捞国际控股有限公司",该名称在客户表中不存在
  • THEN 系统允许保存

Scenario: 客户名称唯一性校验失败​

  • WHEN 用户输入客户名称="海底捞国际控股有限公司",该名称在客户表中已存在
  • THEN 系统提示"该客户名称已存在,请检查",并阻止保存

Scenario: 客户名称大小写不敏感​

  • WHEN 系统校验客户名称唯一性
  • THEN 系统严格区分大小写(如"ABC"与"abc"视为不同客户)

Requirement: 多国家企业识别码支持​

系统 MUST 支持多国企业识别码类型(中国统一社会信用代码、美国EIN、香港BR、新加坡UEN等),并根据类型进行格式校验。

Scenario: 中国企业识别码​

  • WHEN 用户选择企业识别码类型="中国统一社会信用代码",输入18位识别码
  • THEN 系统校验格式(18位字符,包含字母和数字),通过后允许保存

Scenario: 美国企业识别码​

  • WHEN 用户选择企业识别码类型="美国EIN",输入格式如"12-3456789"
  • THEN 系统校验格式(XX-XXXXXXX),通过后允许保存

Scenario: 香港企业识别码​

  • WHEN 用户选择企业识别码类型="香港BR",输入格式如"12345678"
  • THEN 系统校验格式(8位数字),通过后允许保存

Scenario: 新加坡企业识别码​

  • WHEN 用户选择企业识别码类型="新加坡UEN",输入格式如"123456789A"
  • THEN 系统校验格式(9-10位字符),通过后允许保存

Requirement: 品牌同步​

系统 MUST 在创建客户时自动创建或更新品牌管理记录,建立品牌-客户关联关系。

Scenario: 新建品牌记录​

  • WHEN 系统创建客户,品牌名称="海底捞"在品牌表中不存在
  • THEN 系统自动创建品牌记录,关联该客户ID

Scenario: 更新品牌记录​

  • WHEN 系统创建客户,品牌名称="海底捞"在品牌表中已存在
  • THEN 系统更新品牌记录,关联该客户ID,建立品牌-客户多对多关系

Requirement: 客户类型识别​

系统 MUST 根据线索类型自动推断客户类型,但允许用户手动修改。

Scenario: 自动推断客户类型​

  • WHEN 线索类型="海外线索"
  • THEN 系统自动填充客户类型="海外客户"

Scenario: 手动修改客户类型​

  • WHEN 系统自动填充客户类型="海外客户",用户手动修改为"国内客户"
  • THEN 系统以用户最终选择为准保存

Requirement: 线索状态联动​

系统 MUST 在客户创建成功后自动更新线索状态为"已转化",并在操作列显示"查看客户"按钮。

Scenario: 线索状态自动更新​

  • WHEN 客户创建成功
  • THEN 系统自动更新关联线索的状态为"已转化",记录转化时间

Scenario: 操作列切换​

  • WHEN 线索状态="已转化"
  • THEN 系统在操作列显示"查看客户"按钮,隐藏"转化为客户"和"编辑"按钮

Scenario: 查看客户跳转​

  • WHEN 用户点击"查看客户"按钮
  • THEN 系统跳转到客户详情页,展示该线索转化后的客户信息

Requirement: 转化历史记录​

系统 MUST 记录线索转化为客户的历史,包括转化时间、转化人、关联客户ID等信息。

Scenario: 记录转化历史​

  • WHEN 线索转化为客户成功
  • THEN 系统在线索的修改记录中新增一条记录:"时间 用户 将线索转化为客户 客户名称 "

Scenario: 查看转化历史​

  • WHEN 用户查看线索详情
  • THEN 系统在"修改记录"Tab中展示转化历史记录

Requirement: 转化权限控制​

系统 MUST 仅允许线索归属人或上级执行转化操作。

Scenario: 归属人转化线索​

  • WHEN 线索归属人点击"转化为客户"按钮
  • THEN 系统允许转化

Scenario: 上级转化下级线索​

  • WHEN 销售主管转化其下属的线索
  • THEN 系统允许转化

Scenario: 无权限转化被拒绝​

  • WHEN 用户尝试转化其他销售人员的线索(非本人、非下级)
  • THEN 系统提示"无权转化该线索",并阻止操作

Requirement: 转化国际化支持​

系统 MUST 支持多语言客户名称、多国家地址格式、多币种等国际化场景。

Scenario: 多语言客户名称​

  • WHEN 用户输入客户名称="Haidilao International Holding Ltd."
  • THEN 系统保存并支持中英文查询和展示

Scenario: 多国家地址格式​

  • WHEN 客户注册地国家/地区="美国"
  • THEN 系统自动切换地址填写格式为英文格式(州、城市、街道、邮编)

Scenario: 多币种支持​

  • WHEN 客户注册地国家/地区="美国"
  • THEN 系统在涉及金额的字段(如预计年收入)自动切换为美元(USD)