license-manager/docs/architecture/客户属性设计与web显示方案.md

# 客户属性设计与Web显示方案

## 1. 核心客户属性

### 基础标识
- `id` - 唯一标识符
  - **作用**: 数据库主键，系统内部引用
  - **生成**: UUID自动生成
  - **必填**: 是

- `customer_code` - 客户编码 (如: CUS-2025-001)
  - **作用**: 业务识别码，便于客服沟通和查找
  - **生成**: CUS-YYYY-NNNN格式，系统自动递增
  - **必填**: 是
  - **唯一**: 是
  - **意义**: 比数据库ID更有业务意义，支持按年度统计

- `customer_name` - 客户名称/公司名
  - **作用**: 主要识别信息，合同签署主体
  - **示例**: "北京科技有限公司"、"张三"
  - **必填**: 是
  - **搜索**: 支持模糊搜索

- `customer_type` - 客户类型 (个人/企业/政府/教育)
  - **作用**: 区分客户类别，影响服务策略和定价
  - **枚举**: individual(个人) | enterprise(企业) | government(政府) | education(教育)
  - **必填**: 是
  - **默认**: enterprise

### 联系信息
- `contact_person` - 联系人姓名
  - **作用**: 授权通知和技术支持的对接人
  - **必填**: 是
  - **示例**: "张三"

- `contact_title` - 联系人职务
  - **作用**: 了解联系人在组织中的角色，便于沟通
  - **必填**: 否
  - **示例**: "技术总监"、"IT经理"

- `email` - 主邮箱
  - **作用**: 授权激活通知、过期提醒、技术支持的主要渠道
  - **必填**: 是
  - **唯一**: 建议唯一
  - **验证**: 邮箱格式验证

- `phone` - 电话号码
  - **作用**: 紧急联系、电话技术支持
  - **必填**: 否
  - **格式**: 支持手机和固话

### 地址信息
- `address` - 地址
  - **作用**: 联系地址，邮寄材料或现场服务时使用
  - **必填**: 否
  - **示例**: "北京市朝阳区科技园区100号"
  - **格式**: 自由文本，用户可详细可简略

### 商业属性
- `company_size` - 企业规模 (小型/中型/大型/集团)
  - **作用**: 影响定价策略和服务等级
  - **枚举**: small(小型) | medium(中型) | large(大型) | enterprise(集团)
  - **必填**: 否
  - **用途**: 制定差异化授权策略

### 授权配置  
- `preferred_license_type` - 首选授权类型 (在线/离线/混合)
  - **作用**: 影响授权码生成策略和验证方式
  - **枚举**: online(在线) | offline(离线) | hybrid(混合)
  - **必填**: 否
  - **默认**: online
  - **意义**: 在线需要联网验证，离线可本地验证

### 客户分级
- `customer_level` - 客户等级 (普通/VIP/企业/战略)
  - **作用**: 影响服务优先级、授权数量限制、技术支持等级
  - **枚举**: normal(普通) | vip(VIP) | enterprise(企业) | strategic(战略)
  - **必填**: 否
  - **默认**: normal
  - **影响**: 高等级客户可获得更多授权、更快响应

### 状态管理
- `status` - 客户状态 (正常/禁用)
  - **作用**: 控制是否允许为该客户生成新授权
  - **枚举**: active(正常) | disabled(禁用)
  - **必填**: 是
  - **默认**: active
  - **影响**: 禁用状态下不能生成新授权，但现有授权仍可使用

- `description` - 客户描述/备注
  - **作用**: 记录客户特殊情况、业务背景、注意事项
  - **必填**: 否
  - **示例**: "重要客户，IoT平台采购方，需要优先技术支持"

### 时间字段
- `created_at` - 创建时间
  - **作用**: 记录客户注册时间，用于统计分析
  - **自动**: 系统自动记录
  - **不可修改**: 是

- `updated_at` - 更新时间
  - **作用**: 记录最后修改时间，追踪数据变更
  - **自动**: 系统自动更新
  - **触发**: 任何字段修改都会更新

- `created_by` - 创建人
  - **作用**: 记录是哪个管理员创建的客户
  - **必填**: 是
  - **关联**: 管理员用户ID

- `updated_by` - 更新人
  - **作用**: 记录最后修改人，便于问题追溯
  - **自动**: 系统自动记录当前操作员

---

## 2. Web列表页显示信息

### 主要显示列
```
| 客户编码 | 客户名称 | 客户类型 | 联系人 | 邮箱 | 客户等级 | 状态 | 创建时间 | 操作 |
```

### 具体显示内容与作用

**客户编码** (`customer_code`)
- 显示: CUS-2025-001
- 作用: 快速识别客户，支持精确搜索，客服沟通时的标准引用
- 交互: 点击可复制到剪贴板

**客户名称** (`customer_name`)
- 显示: 北京科技有限公司
- 作用: 主要识别信息，最重要的显示内容
- 交互: 点击进入客户详情页
- 样式: 可截断显示，悬停显示完整名称

**客户类型** (`customer_type`)
- 显示: 🏢企业 | 👤个人 | 🏛️政府 | 🎓教育
- 作用: 快速区分客户类别，影响服务策略
- 样式: 用图标+文字+颜色区分
- 筛选: 支持按类型筛选

**联系人** (`contact_person`)
- 显示: 张三
- 作用: 知道具体联系谁，便于沟通对接
- 交互: 悬停显示联系人职务信息

**邮箱** (`email`)
- 显示: zhangsan@example.com
- 作用: 重要联系方式，授权通知的主要渠道
- 交互: 点击可发送邮件
- 验证: 显示邮箱验证状态（已验证/未验证）

**客户等级** (`customer_level`)
- 显示: 🏢企业 | 👤普通 | ⭐VIP | 💼战略
- 作用: 显示客户重要程度，影响服务优先级
- 样式: 不同等级用不同颜色和图标
- 排序: 支持按等级排序

**状态** (`status`)
- 显示: ✅正常 | ❌禁用
- 作用: 显示客户是否可以生成新授权
- 交互: 可直接点击切换状态（需要确认）
- 样式: 正常为绿色，禁用为红色

**创建时间** (`created_at`)
- 显示: 2025-01-15
- 作用: 了解客户注册时间，便于分析客户生命周期
- 格式: YYYY-MM-DD
- 排序: 默认按创建时间倒序

**操作**
- 查看详情: 进入客户详情页
- 编辑: 修改客户信息
- 授权管理: 查看该客户的所有授权
- 生成授权: 快速为该客户生成新授权
- 更多操作: 禁用/启用、删除等

---

## 3. Web详情页显示信息

### 基本信息卡片
```
客户编码: CUS-2025-001          客户类型: 🏢企业
客户名称: 北京科技有限公司        客户等级: ⭐VIP客户  
联系人: 张三 (技术总监)          当前状态: ✅正常
邮箱: zhangsan@example.com     电话: 13800138000
```
**用途**: 核心信息一览，便于快速了解客户基本情况

### 地址信息卡片
```
地址: 北京市朝阳区科技园区100号
```
**用途**: 联系地址，邮寄材料或现场服务参考

### 商业信息卡片
```
企业规模: 中型企业             首选授权: 在线授权
备注描述: 重要客户，IoT平台采购方，需要优先技术支持
```
**用途**: 业务背景了解，制定针对性服务策略

### 状态信息卡片
```
当前状态: ✅正常              创建时间: 2025-01-15 10:30:00
创建人: 李四(管理员)           更新时间: 2025-01-20 15:45:00
更新人: 王五(客服)
```
**用途**: 跟踪客户生命周期，了解操作历史

### 授权统计卡片
```
总授权数: 3个                活跃授权: 2个
过期授权: 1个                最近授权: 2025-01-18
即将过期: 1个(7天内)          授权设备总数: 85台
```
**用途**: 快速了解客户授权使用情况，识别续费机会

---

## 4. 列表页功能特性

### 搜索筛选
- **全文搜索框**: 支持客户编码、名称、联系人、邮箱的模糊搜索
  - **作用**: 快速定位目标客户
  - **实现**: 实时搜索，输入即显示结果
  
- **客户类型筛选**: 全部 | 企业 | 个人 | 政府 | 教育
  - **作用**: 按业务类型分类查看
  - **场景**: 针对不同类型客户制定营销策略
  
- **客户等级筛选**: 全部 | 普通 | VIP | 企业 | 战略
  - **作用**: 重点关注高价值客户
  - **场景**: 优先处理VIP和战略客户的需求
  
- **状态筛选**: 全部 | 正常 | 禁用
  - **作用**: 识别问题客户，及时处理
  - **场景**: 定期清理禁用客户，分析禁用原因

### 排序功能
- **按创建时间排序** (默认)
  - **作用**: 了解客户注册趋势，关注新客户
  
- **按客户名称排序**
  - **作用**: 字母序查找，便于浏览
  
- **按客户等级排序**
  - **作用**: 优先显示重要客户
  
- **按更新时间排序**
  - **作用**: 查看最近活跃的客户

### 批量操作
- **批量启用/禁用**
  - **作用**: 批量处理客户状态变更
  - **场景**: 批量处理欠费客户、恢复客户服务
  
- **批量导出**
  - **作用**: 导出客户数据进行分析
  - **格式**: Excel、CSV格式
  
- **批量删除**
  - **作用**: 清理无效客户数据
  - **安全**: 需要二次确认，软删除机制

### 分页显示
- **每页条数**: 10/20/50/100条可选
  - **默认**: 20条
  - **作用**: 平衡加载速度和浏览效率
  
- **总数统计**: 显示"共1,234个客户"
  - **作用**: 了解客户总体规模
  
- **页码导航**: 支持跳转到指定页
  - **作用**: 快速浏览大量数据

---

## 5. 显示优化建议

### 响应式设计
- **桌面端(>1200px)**: 显示所有列
  - **作用**: 完整信息展示，提高工作效率
  
- **平板端(768-1200px)**: 隐藏地址、电话等次要信息  
  - **作用**: 保持核心信息，适应中等屏幕
  
- **手机端(<768px)**: 卡片式布局，只显示客户名称、等级、状态
  - **作用**: 移动端快速浏览，支持现场客户查询

### 数据可视化(仪表盘)
- **客户等级分布饼图**
  - **作用**: 了解客户结构，制定等级提升策略
  
- **客户类型统计柱图**  
  - **作用**: 分析目标市场，调整营销重点
  
- **月度新增客户趋势图**
  - **作用**: 监控业务增长，评估营销效果

### 交互优化
- **悬停显示完整信息**
  - **场景**: 客户名称过长时显示完整名称
  - **内容**: 联系人悬停显示职务和电话
  
- **点击客户名称进入详情页**
  - **作用**: 快速访问详细信息
  
- **状态切换快捷操作**
  - **实现**: 点击状态图标直接切换，需要确认
  - **作用**: 快速处理客户状态变更
  
- **右键菜单快速操作**
  - **功能**: 编辑、查看授权、生成授权、禁用等
  - **作用**: 提高操作效率，减少页面跳转

### 性能优化
- **虚拟滚动**: 大数据量时采用虚拟滚动
  - **触发**: 客户数>1000时
  - **作用**: 保证页面流畅性
  
- **延迟加载**: 图片和非关键信息延迟加载
  - **作用**: 提高首屏加载速度
  
- **缓存策略**: 客户列表数据缓存5分钟
  - **作用**: 减少不必要的服务器请求

## 6. 业务价值总结

### 提高工作效率
- **快速识别**: 通过客户编码和等级快速识别重要客户
- **精准搜索**: 多维度搜索快速定位目标客户  
- **批量操作**: 减少重复性操作，提高处理效率

### 优化客户服务
- **服务分级**: 根据客户等级提供差异化服务
- **及时响应**: 通过状态管理及时识别问题客户
- **个性化**: 根据客户偏好(授权类型)提供合适的解决方案

### 支撑业务决策
- **客户分析**: 通过等级、类型分布了解客户结构
- **趋势监控**: 通过创建时间分析客户增长趋势
- **风险控制**: 通过状态管理防范业务风险