# 客户管理模块 (Customer Management)

## 模块概述
客户管理模块提供完整的客户档案管理、交接管理和公海池功能，支持360度客户视图和自动化工作流程。

## 功能特性

### 2.2 客户管理模块

#### 2.2.1 客户档案管理
- **基础信息**：客户类型（个人/企业）、联系方式、所属行业、分级标签（重要/普通/潜在）
- **360度视图**：整合商机记录、合同历史、服务工单、回款情况，参考纷享销客客户档案体系
- **数据校验**：手机号/企业税号唯一性校验，避免重复建档

#### 2.2.2 客户交接管理
- **触发场景**：人员离职/岗位调整自动触发交接流程
- **交接内容**：含客户基本信息、未结商机、历史合同、未解决问题等核心数据
- **交接流程**：
  a. 准备阶段：系统自动生成交接清单，原负责人补充完善
  b. 审核阶段：负责人审核清单完整性  
  c. 确认阶段：接手人确认接收，系统自动更新客户负责人
- **客户通知**：交接完成后自动发送短信/邮件告知客户对接人变更

#### 2.2.3 客户公海池
- **规则配置**：自动回收N天未跟进的客户
- **分配机制**：手动分配或销售自主领取

## 数据库表结构

### customers (客户档案表)
- `id`: 客户ID (主键)
- `customer_name`: 客户名称 (必填)
- `customer_type`: 客户类型 (individual=个人, enterprise=企业)
- `phone`: 手机号 (唯一性约束)
- `tax_id`: 企业税号 (唯一性约束，仅企业客户)
- `industry`: 所属行业
- `customer_level`: 分级标签 (important=重要, normal=普通, potential=潜在)
- `owner_id`: 负责人ID
- `last_follow_up`: 最后跟进时间
- `status`: 状态 (active=活跃, inactive=非活跃, in_pool=公海)

### customer_handover (客户交接表)
- `id`: 交接ID (主键)
- `customer_id`: 客户ID
- `from_owner_id`: 原负责人ID
- `to_owner_id`: 新负责人ID
- `handover_reason`: 交接原因 (resignation=离职, position_change=岗位调整)
- `current_stage`: 当前阶段 (preparation/review/confirmation/completed)

### customer_handover_items (交接项目明细表)
- `id`: 项目ID (主键)
- `handover_id`: 交接ID
- `item_type`: 项目类型 (basic_info/opportunities/contracts/service_tickets/payment_issues)
- `item_description`: 项目描述
- `is_completed`: 是否完成

### customer_pool (客户公海池表)
- `id`: 公海记录ID (主键)
- `customer_id`: 客户ID
- `original_owner_id`: 原负责人ID
- `recycle_reason`: 回收原因 (inactive_days=未跟进超限, manual=手动)
- `pool_status`: 公海状态 (available/assigned/claimed)

## API接口

### 客户管理
- `create_customer()`: 创建客户档案（包含唯一性校验）
- `get_customer_360_view()`: 获取客户360度视图

### 交接管理
- `initiate_handover()`: 发起交接流程（自动生成清单）
- `complete_handover_preparation()`: 完成准备阶段
- `approve_handover()`: 审核交接清单
- `confirm_handover()`: 确认接收（自动更新负责人并发送通知）

### 公海管理
- `recycle_to_pool()`: 回收客户到公海池
- `claim_from_pool()`: 从公海池认领客户

## 前端界面
- 客户档案CRUD界面
- 客户交接管理界面
- 客户公海池界面
- 客户360度视图查询面板

## 安装部署
1. 将模块目录复制到 `~/repos/` 目录下
2. 运行主应用的 `build.sh` 脚本，自动处理数据库表创建和前端资源链接
3. 模块将自动集成到系统中

## 依赖要求
- ahserver >= 1.0.0
- sqlor-database-module >= 1.0.0
- bricks-framework >= 1.0.0