# 拓客驾驶舱需求文档

## 📋 文档说明
- **创建日期**: 2025-01-XX
- **版本**: v1.3
- **状态**: 业务规则已确认，待开发
- **目标**: 基于现有拓客报表页面（`lqTkjlb/report`），设计并实现一个功能完整的拓客驾驶舱

### ✅ 已确认的业务规则
1. **大单标准**: 开单金额（`sfyj` 实付业绩）> 10000 元（不含等于）
2. **到店定义**: 使用耗卡记录（`lq_xh_hyhk`）判断，存在有效耗卡记录即视为到店
3. **团队显示**: 仅当活动类型为"全员拓客"（EventType=3）时显示团队相关字段和统计，日常拓客（EventType=1）无团队概念
4. **时间范围**: 选择拓客活动后，时间范围自动填充为该活动的开始和结束时间
5. **门店筛选**: 不提供门店筛选功能，数据按活动范围统计所有门店

---

## 一、现有功能梳理

### 1.1 现有报表页面统计内容（参考 `lqTkjlb/report`）

#### 📊 团队数据报表
- 参与门店数
- 参与战队数
- 参与人员数
- 总拓客数

#### 🏆 门店排行榜
- 目标张数
- 完成张数（总张数）
- 完成率
- 排名

#### 👥 个人排行榜
- 员工姓名
- 所属门店
- 所属团队
- 个人目标
- 完成数量
- 完成率

#### ❌ 未拓客人员
- 姓名
- 门店
- 团队
- 个人目标
- 完成数量（0）
- 完成率
- 最后拓客时间

#### 📈 到店情况（漏斗数据）
- **拓客数量**: 拓客总人数
- **邀约数量**: 邀约总人数
- **预约数量**: 预约总人数
- **开单数量**: 开单总人数
- **耗卡数量**: 耗卡总人数
- **耗卡金额**: 耗卡总金额
- **开单金额**: 开单总金额
- **到店率**: 耗卡数量 / 拓客数量 × 100%
- **成交率**: 开单数量 / 耗卡数量 × 100%
- **预约转化率**: 预约数量 / 拓客数量 × 100%
- **耗卡转化率**: 耗卡数量 / 预约数量 × 100%

#### 👤 员工统计
- 员工姓名
- 部门名称
- 岗位
- 拓客人数
- 到店人数
- 开单人数
- 开单金额
- 到店率: 到店人数 / 拓客人数 × 100%
- 开单率: 开单人数 / 到店人数 × 100%

---

## 二、新增需求

### 2.1 大单统计（核心新增功能）

#### 2.1.1 大单定义
- **标准**: 开单金额（`lq_kd_kdjlb.sfyj` 实付业绩）> 10000 元（不含等于）
- **判断条件**: `sfyj > 10000`
- **统计维度**:
  - 按拓客活动统计
  - 按门店统计
  - 按拓客人员统计
  - 按时间范围统计

#### 2.1.2 大单统计指标
- **大单数量**: 开单金额 > 10000 的订单数量
- **大单金额**: 大单订单总金额
- **大单平均金额**: 大单金额 / 大单数量
- **大单占比**: 大单数量 / 总开单数量 × 100%
- **大单金额占比**: 大单金额 / 总开单金额 × 100%
- **大单转化率**: 大单数量 / 拓客人数 × 100%
- **大单到店转化率**: 大单数量 / 到店人数 × 100%

#### 2.1.3 大单明细列表
- 顾客姓名
- 顾客手机号
- 拓客人员姓名
- 拓客时间
- 开单时间
- 开单金额
- 开单门店
- 项目明细（可选）

### 2.2 拓客人员参与统计（核心新增功能）

#### 2.2.1 统计内容
- **参与拓客人员列表**:
  - 员工姓名
  - 部门名称
  - 岗位
  - 所属门店
  - 所属团队（**仅在活动类型为"全员拓客"时显示**，日常拓客无团队概念）
  - 拓客人数（该人员拓客的顾客总数，去重）
  - 拓客张数（该人员拓客的购买张数总和）
  - 到店人数（该人员拓客的顾客中，到店人数）
  - 到店率（到店人数 / 拓客人数 × 100%）
  - 开单人数（该人员拓客的顾客中，开单人数）
  - 开单金额（该人员拓客的顾客中，开单总金额）
  - 开单转化率（开单人数 / 拓客人数 × 100%）
  - 大单数量（该人员拓客的顾客中，大单数量）
  - 大单金额（该人员拓客的顾客中，大单总金额）

#### 2.2.2 数据来源
- **拓客记录表**: `lq_tkjlb`
  - `F_ExpansionUserId`: 拓客人员ID
  - `F_MemberId`: 会员ID
  - `F_BuyNumber`: 购买张数
- **开单记录表**: `lq_kd_kdjlb`
  - `kdhy`: 开单会员ID（关联 `lq_tkjlb.F_MemberId`）
  - `sfyj`: 实付业绩（用于判断大单）
- **耗卡记录表**: `lq_xh_hyhk`
  - `hyzh`: 会员账号（关联 `lq_tkjlb.F_MemberId`）
- **预约记录表**: `lq_yyjl`
  - `gk`: 顾客ID（关联 `lq_tkjlb.F_MemberId`）

### 2.3 到店转化分析（增强现有功能）

#### 2.3.1 到店定义（已确认）
- **定义**: 有耗卡记录即视为到店
- **判断条件**: 在 `lq_xh_hyhk` 表中存在记录，且 `F_IsEffective = 1`
- **关联字段**: `lq_tkjlb.F_MemberId = lq_xh_hyhk.hyzh`
- **说明**: 耗卡记录代表客户实际到店并进行了消费，是最准确的到店判断标准

#### 2.3.2 到店率计算（基于耗卡记录）
- **到店人数定义**: 在指定时间范围内，有耗卡记录的拓客客户数（按 `F_MemberId` 去重）
- **整体到店率**: 到店人数 / 拓客人数 × 100%
- **门店到店率**: 各门店的到店率（该门店拓客的客户中，有耗卡记录的比例）
- **人员到店率**: 各拓客人员的到店率（该人员拓客的客户中，有耗卡记录的比例）
- **时间维度到店率**: 按时间段的到店率趋势

#### 2.3.3 到店时间分析（基于耗卡记录）
- **首次到店时间**: 客户首次耗卡的时间（`lq_xh_hyhk.hksj` 最小值）
- **拓客到首次到店间隔**: 拓客时间到首次耗卡时间的间隔（天数）
- **拓客到首次到店间隔分布**: 
  - 1天内
  - 3天内
  - 7天内
  - 15天内
  - 30天内
  - 超过30天
- **平均到店间隔天数**: 所有有耗卡记录的客户的平均间隔天数

**注意**: 如果拓客时间晚于首次耗卡时间（异常情况），间隔天数记为0或负数，需要特别处理

---

## 三、可扩展统计维度（建议）

### 3.1 时间维度分析

#### 3.1.1 拓客时间趋势
- 按日期统计拓客人数
- 按周统计拓客人数
- 按月统计拓客人数
- 拓客高峰时段分析

#### 3.1.2 转化周期分析
- 拓客到预约的平均时间
- 拓客到到店的平均时间
- 拓客到开单的平均时间
- 到店到开单的平均时间
- 不同转化周期的转化率对比

### 3.2 客户画像分析

#### 3.2.1 新老客户分析
- 新客户拓客数量
- 老客户拓客数量
- 新老客户到店率对比
- 新老客户开单率对比
- 新老客户大单率对比

#### 3.2.2 客户来源分析
- 不同拓客活动来源的客户数量
- 不同来源客户的到店率
- 不同来源客户的开单率
- 不同来源客户的平均开单金额

### 3.3 门店对比分析

#### 3.3.1 门店效能对比
- 门店拓客效率排名
- 门店到店率排名
- 门店开单率排名
- 门店大单率排名
- 门店平均开单金额排名

#### 3.3.2 门店转化漏斗
- 各门店的完整转化漏斗（拓客→邀约→预约→到店→开单）
- 各门店的转化瓶颈分析

### 3.4 项目分析

#### 3.4.1 大单项目分析
- 大单订单中的项目分布
- 高价值项目列表
- 项目与开单金额的关联度

#### 3.4.2 项目转化分析
- 不同项目的开单率
- 不同项目的平均金额
- 项目组合分析

### 3.5 团队效能分析（仅全员拓客活动）

#### 3.5.1 团队对比
- **适用范围**: 仅当活动类型为"全员拓客"（EventType=3）时显示
- 各团队的拓客数量
- 各团队的到店率
- 各团队的开单率
- 各团队的大单率
- 团队排名和对比

#### 3.5.2 团队协作分析
- 团队内成员的拓客贡献度
- 团队拓客协作效果
- 团队目标完成情况

**注意**: 日常拓客（EventType=1）无团队概念，不显示团队相关统计

### 3.6 流失分析

#### 3.6.1 流失节点分析
- 拓客未邀约数量及占比
- 邀约未预约数量及占比
- 预约未到店数量及占比
- 到店未开单数量及占比

#### 3.6.2 流失原因分析
- 各流失节点的可能原因
- 流失客户特征分析

### 3.7 支付方式分析

#### 3.7.1 支付方式分布
- 不同支付方式的开单数量
- 不同支付方式的开单金额
- 支付方式与客户类型的关系

### 3.8 复购分析

#### 3.8.1 拓客客户复购统计
- 拓客客户首次开单后的复购率
- 拓客客户复购时间间隔
- 拓客客户累计消费金额

### 3.9 业绩贡献分析

#### 3.9.1 拓客业绩贡献
- 拓客活动产生的总业绩
- 拓客活动业绩占总业绩的比例
- 拓客活动业绩趋势

#### 3.9.2 ROI分析
- 拓客活动成本（如果有）
- 拓客活动投入产出比

### 3.10 购买张数分析

#### 3.10.1 购买张数分布
- 不同购买张数的客户数量分布（1张、2张、3-5张、6-10张、10张以上）
- 购买张数与到店率的关系
- 购买张数与开单率的关系
- 购买张数与平均开单金额的关系

#### 3.10.2 购买张数效能
- 平均购买张数
- 高购买张数客户的转化率
- 购买张数TOP人员排名

### 3.11 加微信转化分析

#### 3.11.1 微信添加统计
- 加微信客户数量及占比（`F_IsAddWeChat` = "是"）
- 加微信与未加微信客户的到店率对比
- 加微信与未加微信客户的开单率对比
- 加微信转化率（加微信客户数 / 拓客人数）

#### 3.11.2 微信添加效能
- 加微信客户的平均到店间隔
- 加微信客户的复购率
- 各人员加微信转化率排名

### 3.12 支付方式分析

#### 3.12.1 拓客支付方式分布
- 不同支付方式的拓客数量（现金、微信、支付宝、银行卡等，基于 `F_PaymentMethod`）
- 不同支付方式的客户到店率
- 不同支付方式的客户开单率
- 不同支付方式的客户平均开单金额

### 3.13 客户类型分析

#### 3.13.1 新老客户对比
- 新客户（首次拓客）数量
- 老客户（再次拓客）数量
- 新老客户到店率对比
- 新老客户开单率对比
- 新老客户大单率对比
- 二次拓客转化率

#### 3.13.2 客户质量分析
- 高价值客户识别（拓客后多次到店或高额开单）
- 低质量客户识别（拓客后长期未到店）

### 3.14 部门/岗位效能分析

#### 3.14.1 部门对比
- 各部门的拓客人数
- 各部门的到店率
- 各部门的开单率
- 各部门的平均开单金额
- 各部门的大单率

#### 3.14.2 岗位对比
- 不同岗位的拓客效能
- 岗位与拓客转化率的关系
- 岗位排名分析

### 3.15 时段分析

#### 3.15.1 拓客时段分布
- 按小时统计拓客数量（识别拓客高峰时段）
- 按星期统计拓客数量（识别拓客高峰日期）
- 不同时段的拓客转化率
- 时段与到店率的关系

#### 3.15.2 转化周期时段分析
- 不同时段的拓客到店间隔
- 不同时段的拓客开单间隔

### 3.16 金三角分析（如有关联）

#### 3.16.1 金三角效能
- 各金三角的拓客数量
- 各金三角的到店率
- 各金三角的开单率
- 金三角与拓客转化的关联度

### 3.17 推荐人分析（如有关联）

#### 3.17.1 推荐人效能
- 推荐人拓客数量
- 推荐人拓客的转化率
- 推荐人贡献度排名

### 3.18 拓客渠道分析

#### 3.18.1 渠道效能对比
- 不同拓客渠道的客户数量
- 不同渠道的到店率
- 不同渠道的开单率
- 不同渠道的平均开单金额
- 最优渠道识别

### 3.19 项目偏好分析（基于开单项目）

#### 3.19.1 拓客客户项目偏好
- 拓客客户最常购买的项目TOP10
- 大单客户的项目偏好
- 高转化率项目识别
- 项目与客户类型的匹配度

### 3.20 地域/门店分布分析

#### 3.20.1 门店效能对比（增强版）
- 门店拓客人数排名
- 门店到店率排名
- 门店开单率排名
- 门店大单率排名
- 门店平均开单金额排名
- 门店拓客成本效益分析

#### 3.20.2 门店类型分析
- 不同类型门店的拓客效能（如新店vs老店）
- 门店规模与拓客转化率的关系

---

## 四、数据表结构

### 4.1 核心数据表

#### `lq_tkjlb` - 拓客记录表
- `F_Id`: 拓客编号
- `F_ExpansionTime`: 拓客时间
- `F_ExpansionUserId`: 拓客人员ID
- `F_CustomerName`: 顾客姓名
- `F_CustomerPhone`: 顾客电话号码
- `F_BuyNumber`: 购买张数
- `F_EventId`: 拓客活动ID
- `F_StoreId`: 所属门店ID
- `F_TeamName`: 所属战队（**仅在活动类型为"全员拓客"时有值**）
- `F_MemberId`: 会员ID

#### `lq_kd_kdjlb` - 开单记录表
- `F_Id`: 开单编号
- `kdhy`: 开单会员ID（关联 `lq_tkjlb.F_MemberId`）
- `kdhyc`: 开单会员名称
- `kdrq`: 开单日期
- `zdyj`: 整单业绩
- `sfyj`: 实付业绩（用于判断大单，> 10000）
- `djmd`: 单据门店
- `F_IsEffective`: 是否有效

#### `lq_xh_hyhk` - 耗卡记录表
- `F_Id`: 耗卡编号
- `hyzh`: 会员账号（关联 `lq_tkjlb.F_MemberId`）
- `hksj`: 耗卡时间
- `xfje`: 消费金额
- `md`: 门店ID
- `F_IsEffective`: 是否有效

#### `lq_yyjl` - 预约记录表
- `F_Id`: 预约编号
- `gk`: 顾客ID（关联 `lq_tkjlb.F_MemberId`）
- `yysj`: 预约时间
- `F_Status`: 预约状态（"已确认"表示已到店）

#### `lq_yaoyjl` - 邀约记录表
- `F_Id`: 邀约编号
- `yykh`: 邀约客户（关联 `lq_tkjlb.F_MemberId`）
- `yysj`: 邀约时间

### 4.2 关联数据表

#### `BASE_USER` - 用户表
- `F_Id`: 用户ID（关联 `lq_tkjlb.F_ExpansionUserId`）
- `F_REALNAME`: 真实姓名（拓客人员姓名）
- `F_MDID`: 门店ID
- `F_ZW`: 职位
- `OrganizeId`: 部门ID

#### `lq_mdxx` - 门店信息表
- `F_Id`: 门店ID
- `dm`: 门店名称

#### `lq_event` - 拓客活动表
- `F_Id`: 活动ID
- `F_EventName`: 活动名称
- `F_EventType`: 活动类型（1=日常拓客，3=全员拓客）
- `F_StartTime`: 活动开始时间
- `F_EndTime`: 活动结束时间

#### `lq_eventuser` - 拓客活动用户表
- `F_EventId`: 拓客活动ID
- `F_UserId`: 用户ID
- `F_DepId`: 部门ID
- `F_TeamName`: 战队名称（**仅在活动类型为"全员拓客"时有值**）
- `F_StoreId`: 门店ID
- `F_EventTarget`: 拓客目标数量

---

## 五、接口设计

### 5.1 拓客驾驶舱统计接口

#### 5.1.1 获取驾驶舱概览数据
```
GET /api/Extend/LqTkDashboard/GetOverview
```

**请求参数**:
```json
{
  "eventId": "活动ID（必填）",
  "startTime": "2025-01-01",  // 当选择活动时，自动填充活动的开始时间
  "endTime": "2025-01-31"     // 当选择活动时，自动填充活动的结束时间
}
```

**说明**:
- `eventId`: 必填，选择拓客活动后，时间范围会自动填充为该活动的开始和结束时间
- `startTime` / `endTime`: 根据选择的活动自动填充，用户可手动调整
- **不提供门店筛选功能**，数据按活动范围统计所有门店

**返回数据**:
```json
{
  "code": 200,
  "data": {
    "totalExpansionCount": 1000,      // 总拓客人数
    "totalVisitCount": 600,           // 总到店人数
    "totalBillingCount": 400,         // 总开单人数
    "totalBillingAmount": 5000000,    // 总开单金额
    "bigOrderCount": 50,              // 大单数量
    "bigOrderAmount": 800000,         // 大单金额
    "bigOrderAvgAmount": 16000,       // 大单平均金额
    "visitRate": 60.0,                // 整体到店率
    "billingRate": 66.67,             // 整体开单率
    "bigOrderRate": 5.0,              // 大单转化率
    "bigOrderAmountRate": 16.0,       // 大单金额占比
    "participantCount": 50,           // 参与拓客人员数
    "storeCount": 10                  // 参与门店数
  }
}
```

#### 5.1.2 获取大单统计
```
GET /api/Extend/LqTkDashboard/GetBigOrderStatistics
```

**请求参数**:
```json
{
  "eventId": "活动ID（必填）",
  "startTime": "2025-01-01",  // 自动填充活动开始时间
  "endTime": "2025-01-31"     // 自动填充活动结束时间
}
```

**返回数据**:
```json
{
  "code": 200,
  "data": {
    "summary": {
      "bigOrderCount": 50,
      "bigOrderAmount": 800000,
      "bigOrderAvgAmount": 16000,
      "bigOrderRate": 5.0,
      "bigOrderAmountRate": 16.0,
      "bigOrderConversionRate": 5.0,
      "bigOrderVisitConversionRate": 8.33
    },
    "byStore": [
      {
        "storeId": "门店ID",
        "storeName": "门店名称",
        "bigOrderCount": 10,
        "bigOrderAmount": 150000,
        "bigOrderRate": 5.0
      }
    ],
    "byEmployee": [
      {
        "employeeId": "员工ID",
        "employeeName": "员工姓名",
        "bigOrderCount": 5,
        "bigOrderAmount": 80000,
        "bigOrderRate": 10.0
      }
    ],
    "details": [
      {
        "customerName": "顾客姓名",
        "customerPhone": "手机号",
        "expansionUserName": "拓客人员",
        "expansionTime": "2025-01-01",
        "billingTime": "2025-01-05",
        "billingAmount": 15000,
        "storeName": "门店名称",
        "items": ["项目1", "项目2"]
      }
    ]
  }
}
```

#### 5.1.3 获取拓客人员参与统计
```
GET /api/Extend/LqTkDashboard/GetEmployeeParticipationStatistics
```

**请求参数**:
```json
{
  "eventId": "活动ID（必填）",
  "startTime": "2025-01-01",  // 自动填充活动开始时间
  "endTime": "2025-01-31"     // 自动填充活动结束时间
}
```

**返回数据**:
```json
{
  "code": 200,
  "data": [
    {
      "employeeId": "员工ID",
      "employeeName": "员工姓名",
      "departmentName": "部门名称",
      "position": "岗位",
      "storeId": "门店ID",
      "storeName": "门店名称",
      "teamName": "团队名称",  // 仅当活动类型为"全员拓客"时有值，日常拓客为null或空字符串
      "expansionCount": 100,              // 拓客人数
      "expansionCardCount": 150,          // 拓客张数
      "visitCount": 60,                   // 到店人数
      "visitRate": 60.0,                  // 到店率
      "billingCount": 40,                 // 开单人数
      "billingAmount": 500000,            // 开单金额
      "billingConversionRate": 40.0,      // 开单转化率
      "bigOrderCount": 5,                 // 大单数量
      "bigOrderAmount": 80000             // 大单金额
    }
  ]
}
```

#### 5.1.4 获取到店转化分析
```
GET /api/Extend/LqTkDashboard/GetVisitConversionAnalysis
```

**请求参数**:
```json
{
  "eventId": "活动ID（必填）",
  "startTime": "2025-01-01",  // 自动填充活动开始时间
  "endTime": "2025-01-31"     // 自动填充活动结束时间
}
```

**返回数据**:
```json
{
  "code": 200,
  "data": {
    "overallVisitRate": 60.0,
    "averageVisitInterval": 7.5,         // 平均到店间隔（天）
    "visitIntervalDistribution": {
      "within1Day": 100,
      "within3Days": 200,
      "within7Days": 150,
      "within15Days": 100,
      "within30Days": 40,
      "over30Days": 10
    },
    "byStore": [
      {
        "storeId": "门店ID",
        "storeName": "门店名称",
        "visitRate": 65.0,
        "averageVisitInterval": 6.5
      }
    ],
    "byEmployee": [
      {
        "employeeId": "员工ID",
        "employeeName": "员工姓名",
        "visitRate": 70.0,
        "averageVisitInterval": 5.0
      }
    ]
  }
}
```

### 5.2 数据导出接口

#### 5.2.1 导出大单明细
```
GET /api/Extend/LqTkDashboard/ExportBigOrderDetails
```

#### 5.2.2 导出拓客人员统计
```
GET /api/Extend/LqTkDashboard/ExportEmployeeStatistics
```

---

## 六、前端页面设计

### 6.1 页面结构（不使用Tab切换）

```
拓客驾驶舱
├── 筛选条件区域（固定在顶部）
│   ├── 拓客活动选择（必填，下拉选择）
│   ├── 时间范围选择（自动填充活动开始/结束时间，可手动调整）
│   └── 查询按钮
│
├── 概览统计卡片区域（第一屏）
│   ├── 总拓客人数
│   ├── 总到店人数
│   ├── 总开单人数
│   ├── 总开单金额
│   ├── 大单数量
│   ├── 大单金额
│   ├── 整体到店率
│   └── 整体开单率
│
├── 大单统计区域（第二屏）
│   ├── 区域标题："大单统计"
│   ├── 大单概览卡片（5个指标）
│   │   ├── 大单数量
│   │   ├── 大单金额
│   │   ├── 大单平均金额
│   │   ├── 大单转化率
│   │   └── 大单金额占比
│   ├── 大单分布图表（可选，横排显示）
│   │   ├── 按门店分布饼图
│   │   ├── 按人员分布柱状图
│   │   └── 大单金额分布柱状图
│   └── 大单明细列表
│       ├── 表格展示大单明细
│       ├── 支持按门店、人员、金额排序
│       └── 支持导出Excel
│
├── 拓客人员统计区域（第三屏）
│   ├── 区域标题："拓客人员统计"
│   ├── 人员统计列表
│   │   ├── 表格展示所有参与拓客的人员及其统计数据
│   │   ├── 支持按拓客人数、到店率、开单率、大单数量排序
│   │   └── 支持导出Excel
│   └── 人员排名卡片（可选，横向展示）
│       ├── 拓客人数TOP10
│       ├── 到店率TOP10
│       ├── 开单率TOP10
│       └── 大单数量TOP10
│
├── 到店转化分析区域（第四屏）
│   ├── 区域标题："到店转化分析"
│   ├── 到店率统计卡片
│   │   ├── 整体到店率
│   │   ├── 各门店到店率对比（表格或图表）
│   │   └── 各人员到店率对比（表格或图表）
│   └── 到店时间分析
│       ├── 到店间隔分布图
│       ├── 平均到店间隔
│       └── 到店时间趋势图
│
└── 其他统计区域（可选，按需展示）
    ├── 门店对比分析（可选）
    ├── 时间趋势分析（可选）
    ├── 流失分析（可选）
    └── 其他维度统计（可选）
```

**页面布局说明**：
- **不使用Tab切换**，所有统计区域垂直排列，用户通过滚动查看不同区域
- 每个统计区域使用清晰的标题分隔
- 各区域之间使用适当的间距和分割线区分
- 支持页面内锚点导航（可选），用户可快速跳转到指定区域
- 筛选条件区域固定在顶部，方便用户随时修改筛选条件

### 6.2 大单统计区域

#### 6.2.1 大单概览卡片
- 大单数量
- 大单金额
- 大单平均金额
- 大单转化率
- 大单金额占比

#### 6.2.2 大单分布图表（可选）
- 按门店分布饼图
- 按人员分布柱状图
- 大单金额分布柱状图

**布局建议**：图表横向排列，每个图表占据1/3宽度

#### 6.2.3 大单明细列表
- 表格展示大单明细
- 支持按门店、人员、金额排序
- 支持导出Excel

### 6.3 拓客人员统计区域

#### 6.3.1 人员统计列表
- 表格展示所有参与拓客的人员及其统计数据
- 支持按拓客人数、到店率、开单率、大单数量排序
- 支持导出Excel

#### 6.3.2 人员排名卡片（可选）
- 拓客人数TOP10
- 到店率TOP10
- 开单率TOP10
- 大单数量TOP10

**布局建议**：排名卡片横向排列，每个卡片显示TOP10列表

### 6.4 到店转化分析区域

#### 6.4.1 到店率统计
- 整体到店率（卡片形式展示）
- 各门店到店率对比（表格或柱状图）
- 各人员到店率对比（表格或柱状图）

#### 6.4.2 到店时间分析
- 到店间隔分布图（柱状图）
- 平均到店间隔（卡片形式展示）
- 到店时间趋势图（折线图）

**布局建议**：图表采用两列布局，左侧展示分布图，右侧展示趋势图，平均间隔显示在顶部

---

## 七、技术实现要点

### 7.1 大单判断逻辑（已确认）
```csharp
// 大单定义：开单金额（实付业绩）> 10000（不含等于）
var bigOrderThreshold = 10000m;
var isBigOrder = kd.Sfyj > bigOrderThreshold;  // 严格大于，不含等于

// SQL查询示例
WHERE kd.sfyj > 10000 AND kd.F_IsEffective = 1
```

### 7.2 数据去重逻辑（已确认）
- **拓客人数**: 按 `lq_tkjlb.F_MemberId` 去重
- **到店人数**: 按 `lq_tkjlb.F_MemberId` 去重，且关联的 `lq_xh_hyhk.hyzh` 存在记录且 `F_IsEffective = 1`
- **开单人数**: 按 `lq_tkjlb.F_MemberId` 去重，且关联的 `lq_kd_kdjlb.kdhy` 存在记录且 `sfyj > 0` 且 `F_IsEffective = 1`
- **大单数量**: 按开单记录统计（`sfyj > 10000` 且 `F_IsEffective = 1`），不去重（一个客户可能有多个大单）

### 7.3 关联查询逻辑（已确认）
```sql
-- 拓客到开单关联（用于统计开单人数、开单金额、大单）
lq_tkjlb.F_MemberId = lq_kd_kdjlb.kdhy
WHERE lq_kd_kdjlb.F_IsEffective = 1

-- 拓客到耗卡关联（用于判断到店，已确认使用此方式）
lq_tkjlb.F_MemberId = lq_xh_hyhk.hyzh
WHERE lq_xh_hyhk.F_IsEffective = 1

-- 拓客到预约关联（可选，用于预约转化率统计）
lq_tkjlb.F_MemberId = lq_yyjl.gk
WHERE lq_yyjl.F_Status = '已确认'

-- 拓客人员信息关联
lq_tkjlb.F_ExpansionUserId = BASE_USER.F_Id

-- 大单判断（已确认标准）
lq_kd_kdjlb.sfyj > 10000  -- 严格大于，不含等于
```

### 7.4 团队字段显示逻辑（已确认）
```csharp
// 判断活动类型
var eventType = event.EventType; // 1=日常拓客, 3=全员拓客

// 仅在全员拓客时显示团队字段
if (eventType == 3) // 全员拓客
{
    // 显示团队相关字段和统计
    // 从 lq_eventuser.F_TeamName 或 lq_tkjlb.F_TeamName 获取
}
else // 日常拓客
{
    // 不显示团队字段，团队相关统计隐藏
}
```

### 7.5 时间范围自动填充逻辑
```javascript
// 前端：选择活动后自动填充时间
onEventChange(eventId) {
  const event = eventList.find(e => e.id === eventId);
  if (event) {
    this.queryParams.startTime = event.startTime;
    this.queryParams.endTime = event.endTime;
  }
}
```

```csharp
// 后端：根据活动ID获取活动时间范围
var event = await _db.Queryable<LqEventEntity>()
    .Where(e => e.Id == eventId)
    .FirstAsync();

var startTime = event?.StartTime;
var endTime = event?.EndTime;
```

### 7.6 性能优化建议
- 使用索引优化查询（`F_MemberId`, `F_ExpansionUserId`, `F_EventId`, `kdhy`, `hyzh`, `F_EventType`）
- 使用聚合查询减少数据库访问
- 大数据量时考虑分页或缓存
- 使用视图预计算常用统计数据
- 根据活动类型动态构建查询（团队相关查询仅在全员拓客时执行）

---

## 八、开发优先级

### 8.1 第一优先级（必须实现）
1. ✅ **大单统计功能**
   - 大单概览统计
   - 大单明细列表
   - 大单导出功能

2. ✅ **拓客人员参与统计**
   - 人员统计列表
   - 人员数据导出

3. ✅ **到店转化分析增强**
   - 到店率计算优化
   - 到店时间分析

### 8.2 第二优先级（建议实现）
1. 时间维度分析
2. 门店对比分析
3. 客户画像分析

### 8.3 第三优先级（可选实现）
1. 流失分析
2. 复购分析
3. ROI分析

---

## 九、待讨论问题

### 9.1 业务规则确认（已确认）
1. ✅ **大单标准**: 已确认使用 **> 10000 元**作为大单标准（不含等于）
2. ✅ **到店定义**: 已确认使用 **耗卡记录**（`lq_xh_hyhk`）来判断到店
3. ✅ **团队显示**: 已确认仅当活动类型为"全员拓客"（EventType=3）时显示团队相关字段和统计，日常拓客（EventType=1）无团队概念
4. ✅ **时间范围**: 已确认选择拓客活动后，时间范围自动填充为该活动的开始和结束时间，用户可手动调整
5. ✅ **门店筛选**: 已确认不提供门店筛选功能，数据按活动范围统计所有门店
6. **权限控制**: 是否需要按门店权限过滤数据？

### 9.2 数据展示确认
1. **大单明细**: 是否需要显示项目明细？如果需要，如何获取？
2. **人员统计**: 是否需要支持按部门、岗位筛选？
3. **导出格式**: Excel导出需要哪些字段？是否需要自定义格式？

### 9.3 功能扩展确认
1. **图表展示**: 是否需要可视化图表（如折线图、柱状图、饼图）？
2. **对比分析**: 是否需要支持多活动对比、多门店对比？
3. **实时更新**: 数据是否需要实时更新，还是定时刷新？

---

## 十、参考资料

### 10.1 现有代码参考
- **前端页面**: `antis-ncc-admin/src/views/lqTkjlb/Report.vue`
- **后端服务**: `netcore/src/Modularity/Extend/NCC.Extend/LqTkjlbService.cs`
- **实体类**: `netcore/src/Modularity/Extend/NCC.Extend.Entitys/Entity/lq_tkjlb/LqTkjlbEntity.cs`

### 10.2 数据库表
- `lq_tkjlb`: 拓客记录表
- `lq_kd_kdjlb`: 开单记录表
- `lq_xh_hyhk`: 耗卡记录表
- `lq_yyjl`: 预约记录表
- `lq_yaoyjl`: 邀约记录表

---

## 📝 修改记录

| 日期 | 版本 | 修改内容 | 修改人 |
|------|------|----------|--------|
| 2025-01-XX | v1.0 | 初始版本创建 | - |
| 2025-01-XX | v1.1 | 确认大单标准（>10000）和到店定义（耗卡记录） | - |
| 2025-01-XX | v1.2 | 确认团队显示规则（仅全员拓客）、时间自动填充、移除门店筛选，新增多维度统计建议 | - |
| 2025-01-XX | v1.3 | 修改页面结构，不使用Tab切换，改为垂直滚动布局 | - |

---

**文档状态**: ✅ 业务规则已确认，待开发实施