zd_product_document/10-产品线/基础平台/功能模块/01-客户管理.md

5.1 客户管理

本文档从《基础平台产品设计》第 5 章拆分而来，用于独立描述基础平台功能模块的业务需求、规则和验收标准。

上级文档：基础平台产品设计

5.1.1 功能说明

客户管理用于维护使用公司产品的客户主体，是多客户隔离和业务系统开通的基础。

5.1.2 功能范围

• 新增客户
• 编辑客户信息
• 启用 / 停用客户
• 查询客户列表
• 查看客户详情
• 为客户开通应用
• 维护客户管理员

5.1.3 字段要求

客户基础信息至少包括：

字段	说明	是否必填
客户名称	客户企业、平台或项目主体的完整名称	是
客户简称	用于列表、菜单、切换器等场景的展示名称	是
客户编码	基础平台内识别客户的唯一编码	是
客户类型	用于区分客户经营主体和产品服务模式	是
所属行业	用于区分客户行业解决方案、产品适配和统计分析口径	是
联系人	客户主要业务或项目联系人	否
联系方式	联系人手机号、电话或邮箱	否
启用状态	客户是否可正常使用已开通应用	是
开通应用	当前客户已开通的业务应用范围	否
客户管理员	当前客户下具备客户级管理权限的用户	是
创建时间	客户档案创建时间	是
更新时间	客户档案最近更新时间	是

5.1.3.1 客户编码规则

客户编码用于在基础平台内唯一识别客户，不面向客户业务人员作为主要展示名称。

编码规则：

• 客户编码全局唯一。
• 客户编码创建后原则上不允许修改。
• 客户编码由系统生成，支持平台管理员在创建客户时按规则确认。
• 客户编码建议格式为：C + 6 位流水号。
• 示例：C000001、C000002。
• 流水号按基础平台全局递增，不按行业、客户类型或应用分别递增。
• 删除或停用客户后，原客户编码不得重新分配给其他客户。
• 客户编码仅用于系统识别、数据隔离、日志追踪和系统间关联，不承载客户行业、区域、品牌等业务含义。

编码生成要求：

• 新增客户时，系统自动生成下一个可用客户编码。
• 保存客户前，系统需要校验客户编码是否已存在。
• 客户编码生成失败或重复时，不允许保存客户。
• 导入客户数据时，如外部数据包含客户编码，需要校验是否符合平台编码规则；不符合规则的数据不得直接写入正式客户档案。

5.1.3.2 客户类型定义

客户类型用于区分客户主体与产品服务模式，支持后续按客户类型进行产品开通、交付管理、经营分析和权限初始化。

基础平台 1.0 支持以下客户类型：

客户类型	定义	适用示例
连锁型客户	拥有多个门店、品牌或区域组织的连锁经营客户	连锁餐饮、连锁鞋服、连锁药店
平台型客户	自身经营撮合、交易、结算或分账平台的客户	物流平台、充电桩平台
试点客户	用于产品试点、POC、样板项目验证的客户	物流平台分账试点客户
内部测试客户	公司内部用于演示、测试、培训的客户	演示客户、培训客户

业务规则：

• 客户类型创建客户时必须选择。
• 客户类型支持后续编辑，但变更后不自动改变已开通应用、组织、用户和权限。
• 客户类型用于管理和统计，不直接决定客户是否能访问某应用。
• 如需通过客户类型控制默认开通应用或初始化模板，应在后续客户初始化规则中单独定义。

5.1.3.3 客户所属行业定义

所属行业用于标识客户业务所在行业，支撑行业解决方案沉淀、产品适配、客户统计和后续行业化配置。

基础平台 1.0 支持以下所属行业：

所属行业	定义	适用示例
连锁餐饮	以餐饮门店经营为主的连锁客户	小吃、米线、火锅、卤味、自助餐、茶饮
连锁鞋服	以鞋服门店经营为主的连锁客户	鞋类、服饰、运动零售
连锁零售	以零售门店经营为主的连锁客户	便利店、专卖店、生活零售
连锁药店	以药品、健康产品零售为主的连锁客户	药店、健康门店
物流平台	以物流供需撮合、履约协同和平台交易为主的客户	货运撮合、同城配送撮合
充电桩平台	以充电桩运营和交易结算为主的客户	充电桩运营平台
其他行业	暂未归入标准行业分类的客户	待行业归类客户

业务规则：

• 所属行业创建客户时必须选择。
• 一个客户 1.0 阶段只允许选择一个主行业。
• 多业态集团客户以主要合作业务或主要上线产品对应行业作为主行业。
• 所属行业用于行业统计、方案归档和默认模板选择，不直接决定客户是否能访问某应用。
• 新增行业分类需由产品负责人确认后维护到数据字典。

5.1.4 为客户开通应用

5.1.4.1 功能说明

为客户开通应用用于控制某个客户可以使用哪些业务应用，是客户访问业务系统、客户管理员分配权限、用户查看应用入口的前置条件。

5.1.4.2 功能范围

• 查看客户已开通应用。
• 为客户新增开通应用。
• 关闭客户已开通应用。
• 设置应用开通状态。
• 查看应用开通时间、开通人、关闭时间、关闭人。
• 查看应用开通记录。

5.1.4.3 开通应用字段

应用开通信息至少包括：

字段	说明	是否必填
客户	被开通应用的客户	是
应用	被开通的业务应用	是
开通状态	已开通、已关闭	是
开通时间	应用开通时间	是
开通人	执行开通操作的平台用户	是
关闭时间	应用关闭时间	否
关闭人	执行关闭操作的平台用户	否
备注	开通或关闭原因说明	否

5.1.4.4 业务规则

• 只有平台管理员或具备客户应用开通权限的用户可以为客户开通应用。
• 只能开通基础平台中已启用的应用。
• 客户停用后，不允许继续新增开通应用。
• 客户未开通某应用时，该客户下用户不可看到该应用入口。
• 客户开通应用后，客户管理员仍需为用户分配角色和权限，用户才可访问对应菜单和功能。
• 关闭客户应用后，该客户下用户不可继续访问该应用。
• 关闭应用不删除该客户在业务应用中的历史业务数据。
• 应用开通和关闭需要记录操作日志。
• 同一客户同一应用只能存在一条当前有效的开通关系。

5.1.5 维护客户管理员

5.1.5.1 功能说明

维护客户管理员用于为客户指定具备客户级管理权限的用户。客户管理员负责维护本客户下的组织、用户、角色、权限和菜单授权。

5.1.5.2 功能范围

• 创建客户管理员账号。
• 从已有用户中设置客户管理员。
• 取消客户管理员身份。
• 查看客户管理员列表。
• 重置客户管理员密码。
• 启用 / 停用客户管理员账号。

5.1.5.3 客户管理员字段

客户管理员信息至少包括：

字段	说明	是否必填
用户姓名	客户管理员姓名	是
登录账号	客户管理员登录账号	是
手机号	客户管理员手机号	是
所属客户	客户管理员归属客户	是
所属组织	客户管理员所属组织	否
管理员状态	启用、停用	是
创建时间	管理员账号创建时间	是

5.1.5.4 业务规则

• 一个客户至少应有一个启用状态的客户管理员。
• 客户创建后，应通过客户管理员维护功能指定至少一个客户管理员。
• 客户管理员必须归属于当前客户。
• 客户管理员只能管理本客户下的数据。
• 客户管理员不可管理其他客户的组织、用户、角色、权限和菜单。
• 取消客户管理员身份前，需要确认该客户是否仍至少保留一个启用状态客户管理员。
• 停用最后一个客户管理员时，系统应阻止操作或提示先指定新的客户管理员。
• 客户管理员账号停用后不可登录基础平台。
• 客户管理员创建、变更、停用、取消管理员身份需要记录操作日志。

5.1.6 界面设计

5.1.6.1 页面入口

客户管理作为基础平台的管理类功能，建议放置在基础平台左侧菜单：

基础平台
└── 平台管理
    └── 客户管理

页面访问规则：

• 仅平台超级管理员、平台运营人员或具备客户管理权限的用户可访问客户管理页面。
• 客户管理员不可访问客户管理页面，客户管理员只管理本客户下的组织、用户、角色、权限和菜单。
• 无客户管理权限的用户不展示客户管理菜单。

5.1.6.2 控件类型规则

客户管理界面涉及的输入控件按以下规则定义：

字段 / 操作	控件类型	适用页面
客户名称	文本输入框	客户列表查询、新增客户、编辑客户
客户简称	文本输入框	客户列表查询、新增客户、编辑客户
客户编码	文本输入框 / 只读文本	客户列表查询使用文本输入框，新增和编辑页面为只读文本
客户类型	下拉框	客户列表查询、新增客户、编辑客户
所属行业	下拉框	客户列表查询、新增客户、编辑客户
启用状态	下拉框 / Switch	客户列表查询使用下拉框，新增和编辑页面状态控制使用 Switch
应用名称	文本输入框	全部应用页签查询
应用编号	文本输入框	全部应用页签查询
开通状态	下拉框	全部应用页签查询
查询	按钮	查询区域
新增、编辑、查看、开通、关闭、维护管理员、添加管理员、保存、取消	按钮	列表、详情、弹窗
用户姓名	文本输入框	添加管理员表单弹窗
登录账号	文本输入框	添加管理员表单弹窗
手机号	文本输入框	添加管理员表单弹窗
所属组织	下拉框 / 树形选择器	添加管理员表单弹窗
管理员状态	Switch	客户管理员维护弹窗

状态类控件规则：

• 客户启用状态在新增、编辑或状态维护场景中使用 Switch。
• 客户管理员启用状态使用 Switch。
• 查询条件中的状态字段使用下拉框，便于选择全部、启用、停用等查询范围。
• 开通状态用于查询应用开通关系，使用下拉框，不使用 Switch。

5.1.6.3 页面结构

客户管理包含以下页面和区域：

页面 / 区域	展示方式	主要用途
客户列表页	查询表单 + 数据表格	查询、筛选、查看、新增、编辑、启用、停用客户
新增客户页 / 弹窗	表单	创建客户基础档案
编辑客户页 / 弹窗	表单	修改客户基础信息、客户类型、所属行业、联系人等信息
客户详情页	上方只读基础信息区 + 下方 Tab 页签	查看客户基础信息、全部应用、已开通应用、客户管理员、操作记录
客户管理员维护弹窗	数据表格 + 表单弹窗	通过管理员表格查看、创建、设置、取消、停用客户管理员

5.1.6.4 客户列表页

客户列表页用于平台侧查看和维护所有客户。

展示方式：

• 顶部为查询表单。
• 下方为客户数据表格。
• 表格右侧操作列展示查看、编辑、维护管理员、启用、停用等操作。

列表筛选条件：

• 客户名称
• 客户简称
• 客户编码
• 客户类型
• 所属行业
• 启用状态

查询区规则：

• 查询按钮作为查询表单的最后一个表单元素展示。
• 查询条件较多或页面宽度不足时，查询区需要支持收缩和展开。
• 收缩状态下优先展示客户名称、客户编码、启用状态和查询按钮。
• 展开状态下展示全部查询条件。

列表字段：

字段	说明
客户编码	展示系统生成的客户唯一编码
客户名称	展示客户完整名称
客户简称	展示客户简称
客户类型	展示连锁型客户、平台型客户、试点客户、内部测试客户
所属行业	展示连锁餐饮、连锁鞋服、连锁零售、连锁药店、物流平台、充电桩平台、其他行业
启用状态	展示启用或停用
已开通应用	展示客户已开通应用数量或应用名称摘要
客户管理员	展示启用状态客户管理员数量
创建时间	展示客户创建时间
操作	查看、编辑、维护管理员、启用、停用

列表操作规则：

• 点击客户名称或查看进入客户详情页。
• 点击新增客户进入新增客户页或弹窗。
• 点击编辑进入编辑客户页或弹窗。
• 点击维护管理员进入客户管理员维护弹窗。
• 停用状态客户可执行启用操作。
• 启用状态客户可执行停用操作。

5.1.6.5 新增客户页 / 弹窗

新增客户用于创建客户基础档案，不在新增客户页完成应用开通和客户管理员初始化。

展示方式：

• 采用表单方式展示。
• 表单只包含客户基础信息。
• 不使用表格、Tab 页签或树形结构。

表单分区：

分区	字段 / 内容
客户基础信息	客户名称、客户简称、客户编码、客户类型、所属行业、联系人、联系方式

页面规则：

• 客户编码由系统自动生成，页面展示但不允许普通编辑。
• 客户名称、客户简称、客户类型、所属行业为必填。
• 新增客户页不提供应用开通能力。
• 新增客户页不提供客户管理员创建或设置能力。
• 客户创建后，可在客户详情的全部应用页签中进行应用开通。
• 客户创建后，可在客户详情或客户列表中独立维护客户管理员。
• 保存成功后进入客户详情页或返回客户列表页。

5.1.6.6 编辑客户页 / 弹窗

编辑客户用于维护客户基础资料。

展示方式：

• 采用表单方式展示。
• 表单字段与新增客户基础信息保持一致。
• 客户编码、创建时间作为只读字段展示。
• 不使用表格、Tab 页签或树形结构。

可编辑字段：

• 客户名称
• 客户简称
• 客户类型
• 所属行业
• 联系人
• 联系方式

不可编辑字段：

• 客户编码
• 创建时间

页面规则：

• 修改客户类型不自动改变已开通应用、组织、用户、角色和权限。
• 修改所属行业不自动改变客户已使用的业务系统和历史数据。
• 编辑客户信息需记录操作日志。

5.1.6.7 客户详情页

客户详情页用于集中查看客户档案和客户使用状态。

客户详情页分为上下两部分：

区域	展示方式	主要内容
上方基础信息区	只读信息区	客户名称、简称、编码、类型、行业、联系人、联系方式、启用状态
下方页签区	Tab 页签	全部应用、已开通应用、客户管理员、操作记录

下方页签说明：

页签	主要内容
全部应用	查询区域 + 数据表格展示全部应用、开通状态、开通时间、开通人和操作
已开通应用	数据表格展示当前客户已开通应用、开通时间、开通人和关闭操作
客户管理员	数据表格展示管理员姓名、账号、手机号、状态、创建时间
操作记录	数据表格展示客户新增、编辑、启用、停用、应用开通、应用关闭、管理员变更记录

详情页主操作按钮：

• 添加客户管理员

页面规则：

• 点击添加客户管理员按钮，打开客户管理员维护弹窗，并默认进入添加管理员表单弹窗。
• 应用开通在全部应用页签内操作。
• 关闭应用在已开通应用页签内操作。
• 取消管理员、重置密码、启用、停用管理员在客户管理员页签内操作。

5.1.6.8 全部应用页签

全部应用页签用于在客户详情页中查看客户与所有可用应用的开通关系，并完成应用开通或关闭。

展示方式：

• 上方为查询区域。
• 下方为应用数据表格。
• 表格最后一列展示开通或关闭操作。
• 不使用树形结构。

查询条件：

• 应用名称
• 应用编号
• 开通状态

查询规则：

• 开通状态默认选择未开通。
• 开通状态支持未开通、已开通、全部。
• 查询结果按查询条件过滤当前客户可查看的全部应用。

表格字段：

字段	说明
应用名称	展示应用名称
应用编号	展示应用唯一编号
应用状态	展示应用是否启用
开通状态	展示已开通或未开通
开通时间	已开通应用展示开通时间，未开通应用为空
开通人	已开通应用展示开通人，未开通应用为空
操作	已开通应用展示关闭，未开通应用展示开通

页面规则：

• 仅展示基础平台中启用状态的应用，停用应用不允许新增开通。
• 未开通应用展示开通按钮。
• 已开通应用展示关闭按钮。
• 已开通应用不允许重复开通。
• 开通应用前需要确认开通操作。
• 关闭应用前需要二次确认。
• 关闭应用时应提示：关闭后该客户下用户不可继续访问该应用，但不删除历史业务数据。

5.1.6.9 已开通应用页签

已开通应用页签用于集中查看当前客户已经开通的应用，并支持关闭已开通应用。

展示方式：

• 采用数据表格展示。
• 不设置查询区域。
• 表格最后一列展示关闭操作。
• 不使用树形结构。

表格字段：

字段	说明
应用名称	展示已开通应用名称
应用编号	展示应用唯一编号
应用状态	展示应用是否启用
开通时间	展示应用开通时间
开通人	展示开通操作人
操作	关闭

页面规则：

• 仅展示当前客户已开通应用。
• 点击关闭前需要二次确认。
• 关闭应用时应提示：关闭后该客户下用户不可继续访问该应用，但不删除历史业务数据。
• 关闭成功后，已开通应用页签列表刷新。
• 关闭成功后，该应用在全部应用页签中的开通状态变更为未开通。

5.1.6.10 客户管理员维护弹窗

客户管理员维护采用表格 + 表单弹窗的组合方式。

弹窗结构：

层级	形式	主要用途
客户管理员维护弹窗	表格	查看当前客户管理员列表，并执行添加、设置、取消、重置密码、启用、停用操作
添加管理员表单弹窗	表单	创建新用户作为客户管理员，或从已有用户中选择并设置为客户管理员

客户管理员维护弹窗主体为管理员列表表格。

表格字段：

字段	说明
用户姓名	客户管理员姓名
登录账号	客户管理员登录账号
手机号	客户管理员手机号
所属组织	客户管理员所属组织
管理员状态	启用、停用
创建时间	管理员创建时间
操作	取消管理员、重置密码、启用、停用

维护弹窗按钮：

• 添加管理员
• 关闭弹窗

添加管理员表单弹窗支持两种方式：

添加方式	表单内容	说明
创建新用户	用户姓名、登录账号、手机号、所属组织、初始密码或密码生成方式	创建新用户并设置为客户管理员
选择已有用户	用户查询条件、用户列表、选中用户	从当前客户已有用户中设置客户管理员

页面规则：

• 客户管理员维护弹窗打开后，默认展示当前客户管理员表格。
• 点击添加管理员后，打开添加管理员表单弹窗。
• 添加管理员表单弹窗提交成功后，返回客户管理员维护弹窗，并刷新管理员表格。
• 支持创建新用户作为客户管理员。
• 支持从当前客户已有用户中设置客户管理员。
• 取消管理员身份前，需要校验是否仍保留至少一个启用状态客户管理员。
• 停用客户管理员前，需要校验是否仍保留至少一个启用状态客户管理员。
• 客户管理员账号和手机号校验规则复用用户与账号管理模块。

5.1.7 使用导航

5.1.7.1 新增客户

操作路径：

基础平台 > 平台管理 > 客户管理 > 新增客户

操作步骤：

1. 进入客户管理列表页。
2. 点击新增客户。
3. 填写客户名称、客户简称、客户类型、所属行业、联系人、联系方式。
4. 系统自动生成客户编码。
5. 保存客户。
6. 保存成功后，系统生成客户档案和客户编码。
7. 根据需要进入应用开通或客户管理员维护功能继续配置。

5.1.7.2 编辑客户信息

操作路径：

基础平台 > 平台管理 > 客户管理 > 客户列表 > 编辑

操作步骤：

1. 进入客户管理列表页。
2. 按客户名称、客户编码、客户类型或所属行业查询客户。
3. 点击编辑。
4. 修改客户基础信息。
5. 保存修改。
6. 系统记录客户信息变更日志。

5.1.7.3 查看客户详情

操作路径：

基础平台 > 平台管理 > 客户管理 > 客户列表 > 查看

或：

基础平台 > 平台管理 > 客户管理 > 客户列表 > 客户名称

操作步骤：

1. 进入客户管理列表页。
2. 按客户名称、客户编码、客户类型或所属行业查询客户。
3. 点击查看或客户名称。
4. 进入客户详情页。
5. 在上方只读基础信息区查看客户基础信息。
6. 在下方 Tab 页签中查看全部应用、已开通应用、客户管理员和操作记录。

5.1.7.4 为客户开通应用

操作路径：

基础平台 > 平台管理 > 客户管理 > 客户详情 > 全部应用

操作步骤：

1. 进入客户详情页。
2. 打开全部应用页签。
3. 查询区域默认按开通状态为未开通进行查询。
4. 可按应用名称、应用编号、开通状态调整查询条件。
5. 在应用数据表格中选择需要开通的未开通应用。
6. 点击表格最后一列的开通按钮。
7. 确认开通操作。
8. 系统记录应用开通关系和操作日志。
9. 客户管理员进入角色管理后，可为本客户角色配置该应用菜单权限、操作权限和数据范围，再在用户与账号管理中为用户分配角色。

5.1.7.5 关闭客户应用

操作路径：

基础平台 > 平台管理 > 客户管理 > 客户详情 > 已开通应用 > 关闭

操作步骤：

1. 进入客户详情页。
2. 打开已开通应用页签。
3. 在已开通应用表格中选择需要关闭的应用。
4. 点击表格最后一列的关闭按钮。
5. 系统提示关闭影响。
6. 确认关闭。
7. 系统关闭该客户应用访问关系，并记录操作日志。

5.1.7.6 维护客户管理员

操作路径：

基础平台 > 平台管理 > 客户管理 > 客户列表 > 维护管理员

或：

基础平台 > 平台管理 > 客户管理 > 客户详情 > 添加客户管理员

或：

基础平台 > 平台管理 > 客户管理 > 客户详情 > 客户管理员 Tab > 添加管理员

操作步骤：

1. 进入客户管理列表页或客户详情页。
2. 点击维护管理员或在客户详情页点击添加客户管理员。
3. 系统打开客户管理员维护弹窗。
4. 在维护弹窗中查看当前客户管理员表格。
5. 点击添加管理员。
6. 在添加管理员表单弹窗中选择创建新用户或选择已有用户。
7. 填写或选择用户信息。
8. 保存管理员设置。
9. 系统校验该客户至少存在一个启用状态客户管理员。
10. 系统记录管理员维护日志，并刷新客户管理员表格。

5.1.7.7 启用 / 停用客户

操作路径：

基础平台 > 平台管理 > 客户管理 > 客户列表 > 启用 / 停用

操作步骤：

1. 进入客户管理列表页。
2. 查询目标客户。
3. 点击启用或停用。
4. 停用客户时，系统提示停用影响。
5. 确认操作。
6. 系统更新客户状态并记录操作日志。

停用影响：

• 客户下用户不可继续登录业务系统。
• 客户已开通应用不可继续访问。
• 历史客户档案、组织、用户、权限、日志和业务数据不删除。

5.1.8 业务规则

• 客户编码全局唯一。
• 停用客户后，该客户下用户不可登录业务系统。
• 客户停用不删除历史数据。
• 客户未开通某应用时，该客户下用户不可看到该应用入口。
• 一个客户至少应有一个客户管理员。

5.1.9 验收标准

• 可创建、编辑、停用客户。
• 新增客户时，系统可按规则生成全局唯一客户编码。
• 客户编码重复时，不允许保存客户。
• 可维护客户类型，并按客户类型查询客户。
• 可维护客户所属行业，并按所属行业查询客户。
• 可为客户开通和关闭应用。
• 客户详情页包含全部应用页签。
• 客户详情页保留已开通应用页签。
• 全部应用页签采用查询区域 + 数据表格展示。
• 全部应用页签查询条件包含应用名称、应用编号、开通状态。
• 全部应用页签开通状态默认选择未开通。
• 全部应用表格最后一列支持对未开通应用执行开通操作。
• 已开通应用页签采用数据表格展示当前客户已开通应用。
• 已开通应用只允许关闭，不允许重复开通。
• 客户未开通应用时，该客户下用户不可看到该应用入口。
• 客户开通应用后，客户管理员可继续为用户分配该应用权限。
• 关闭客户应用后，该客户下用户不可继续访问该应用。
• 可创建、设置、取消、停用客户管理员。
• 每个客户至少保留一个启用状态的客户管理员。
• 客户管理员维护采用表格 + 表单弹窗组合，维护弹窗展示管理员表格，添加管理员时打开表单弹窗。
• 客户列表页可按客户名称、客户简称、客户编码、客户类型、所属行业、启用状态查询客户。
• 客户列表页查询按钮作为查询表单最后一个表单元素展示。
• 客户列表页查询条件较多时支持收缩和展开。
• 客户类型、所属行业等枚举字段使用下拉框。
• 客户启用状态、客户管理员启用状态在状态维护场景中使用 Switch。
• 查询条件中的状态字段使用下拉框。
• 客户详情页可查看基础信息、全部应用、已开通应用、客户管理员和操作记录。
• 新增客户页不包含应用开通和客户管理员维护。
• 应用开通在客户详情页全部应用页签中完成。
• 客户管理员维护可从客户列表或客户详情进入。
• 停用客户后，该客户下账号无法继续访问系统。
• 客户之间数据不可互相查看。