yss-project/docs/task/20251024-customer-service-dashboard-real-data.md

客服工作台数据对接真实Parse数据

任务概述

将客服工作台（Dashboard）从模拟数据改为对接Parse Server真实数据，确保数据统计准确性，并优化界面显示。

修改日期

2024年10月24日

涉及文件

1. src/app/pages/customer-service/dashboard/dashboard.ts - 组件逻辑
2. src/app/pages/customer-service/dashboard/dashboard.html - 模板文件

---

修改内容详情

1. 数据统计卡片优化

1.1 新增"项目总数"统计卡片

目的: 显示公司所有项目的总数

实现:

// 添加到 stats 对象
totalProjects: signal(0), // 项目总数

// 查询逻辑
const totalProjectQuery = this.createQuery('Project');
const totalProjects = await totalProjectQuery.count();
this.stats.totalProjects.set(totalProjects);

数据来源: Project 表，使用公司过滤条件

1.2 修改"待派单数"为"待分配项目数"

原名称: 待派单数
新名称: 待分配项目数

查询逻辑:

const pendingQuery = this.createQuery('Project');
pendingQuery.equalTo('status', '待分配');
pendingQuery.doesNotExist('assignee');
const pendingAssignments = await pendingQuery.count();
this.stats.pendingAssignments.set(pendingAssignments);

查询条件:

• 项目状态为 待分配
• 未分配设计师 (assignee 字段不存在)

---

2. 数据对接Parse Server

2.1 项目总数

查询类: Project
过滤条件:

• company = 当前公司指针
• isDeleted ≠ true

2.2 新咨询数

查询类: Project
过滤条件:

• company = 当前公司指针
• isDeleted ≠ true
• createdAt >= 今日0点

说明: 统计今日新增的项目数量

2.3 待分配项目数

查询类: Project
过滤条件:

• company = 当前公司指针
• isDeleted ≠ true
• status = '待分配'
• assignee 不存在

2.4 异常项目数

查询类: ProjectIssue
过滤条件:

• company = 当前公司指针
• isDeleted ≠ true
• priority = 'high'
• status = 'open'

说明: 统计高优先级且未解决的项目问题

2.5 售后服务数量

查询类: ProjectFeedback
过滤条件:

• company = 当前公司指针
• isDeleted ≠ true
• status = 'pending'
• feedbackType = 'complaint'

说明: 统计待处理的客户投诉反馈

---

3. 隐藏的功能模块

3.1 核心指标卡片（已移除）

以下核心指标因为没有对应的数据表字段，已从界面移除：

• ❌ 当日成交率（conversionRateToday）
• ❌ 待处理投诉数（pendingComplaints）
• ❌ 未回复咨询数（unRepliedConsultations）

3.2 CRM队列模块（已隐藏）

新客户触达和老客户回访模块已暂时隐藏，等待后续功能开发：

• ❌ 新客户触达列表
• ❌ 老客户回访列表
• ❌ 新客户触达统计（newCustomerReachCount、newCustomerConversionRate）
• ❌ 老客户回访统计（oldCustomerFollowUpCount、oldCustomerRetentionRate）

原因: 这些功能需要额外的数据表支持，当前数据库schema中没有对应的表结构。

---

4. 数据统计看板最终显示

显示的统计卡片（共5个）

卡片名称	数据来源	图标颜色	说明
项目总数	Project 表计数	Primary（蓝色）	显示公司所有项目总数
新咨询数	Project 表（今日创建）	Secondary（紫色）	今日新增的咨询项目数
待分配项目数	Project 表（待分配且无设计师）	Warning（橙色）	需要分配设计师的项目数
异常项目	ProjectIssue 表（高优先级未解决）	Danger（红色）	需要紧急处理的项目问题
售后服务	ProjectFeedback 表（待处理投诉）	Success（绿色）	待处理的客户投诉数

---

5. 代码实现细节

5.1 统计数据结构

stats = {
  totalProjects: signal(0),       // 项目总数
  newConsultations: signal(0),    // 新咨询数
  pendingAssignments: signal(0),  // 待分配项目数
  exceptionProjects: signal(0),   // 异常项目数
  afterSalesCount: signal(0)      // 售后服务数量
};

5.2 查询实现方式

使用 createQuery() 方法创建带公司过滤的查询：

private createQuery(className: string): any {
  const query = new Parse.Query(className);
  query.equalTo('company', this.getCompanyPointer());
  query.notEqualTo('isDeleted', true);
  return query;
}

5.3 公司指针获取

private getCompanyPointer(): any {
  if (!this.company()) {
    throw new Error('公司信息未加载');
  }
  return {
    __type: 'Pointer',
    className: 'Company',
    objectId: this.company().id
  };
}

---

6. 数据表依赖关系

使用的Parse Server表

1. Project - 项目表

   • objectId: 项目ID
   • title: 项目名称
   • status: 项目状态
   • assignee: 分配的设计师（Pointer → Profile）
   • company: 所属公司（Pointer → Company）
   • createdAt: 创建时间
   • isDeleted: 是否已删除

2. ProjectIssue - 项目问题表

   • priority: 优先级（high/medium/low）
   • status: 状态（open/closed）
   • company: 所属公司
   • isDeleted: 是否已删除

3. ProjectFeedback - 项目反馈表

   • status: 状态（pending/resolved）
   • feedbackType: 反馈类型（complaint/suggestion/praise）
   • company: 所属公司
   • isDeleted: 是否已删除

4. Company - 公司表

   • objectId: 公司ID（固定为 'cDL6R1hgSi' - 映三色帐套）

---

7. 界面变化对比

修改前

• 5个基础统计卡片
• 3个核心指标卡片（渐变样式）
• 新客户触达列表
• 老客户回访列表
• 数据全部为模拟数据

修改后

• 5个基础统计卡片（含新增的"项目总数"）
• ✅ 数据来源于Parse Server真实数据
• ✅ "待派单数"改名为"待分配项目数"
• ❌ 移除3个核心指标卡片
• ❌ 隐藏CRM队列模块（新客户触达、老客户回访）

---

8. 数据加载流程

ngOnInit()
  ↓
initializeUserAndCompany()
  ↓
loadDashboardData()
  ↓
loadConsultationStats() ←── 加载所有统计数据
  ├─ 项目总数
  ├─ 新咨询数
  ├─ 待分配项目数
  ├─ 异常项目数
  └─ 售后服务数量

---

9. 错误处理

所有数据加载方法都包含错误处理：

try {
  // 查询数据
  const result = await query.count();
  this.stats.xxx.set(result);
  console.log(`✅ 数据加载成功`);
} catch (error) {
  console.error('❌ 数据加载失败:', error);
  // 不抛出错误，允许其他数据继续加载
}

---

10. 控制台日志

成功加载时的日志格式：

✅ 用户和公司信息初始化完成
✅ 咨询统计: 项目总数128, 新咨询12, 待分配5, 异常2, 售后15
✅ 紧急任务加载完成: 8 个任务
✅ 项目动态加载完成: 20 条动态
✅ 客服仪表板数据加载完成

---

后续优化建议

1. 待实现功能

1. 核心指标统计

   • 需要在数据库中添加相关字段或新建统计表
   • 建议字段：成交率、投诉统计、咨询回复状态

2. CRM客户管理

   • 新建 CustomerContact 表记录客户触达情况
   • 新建 CustomerFollowUp 表记录客户回访记录
   • 添加客户标签系统（价格敏感/品质敏感）

3. 实时数据更新

   • 考虑使用 Parse Live Query 实现实时数据更新
   • 避免频繁轮询造成服务器压力

2. 性能优化

1. 查询优化

   • 对于频繁查询的字段添加索引（status、createdAt、company）
   • 考虑使用 Parse Cloud Code 实现聚合查询

2. 缓存策略

   • 对于统计数据考虑添加本地缓存
   • 设置合理的刷新间隔（如5分钟）

---

测试验证

验证清单

• 项目总数显示正确
• 新咨询数统计今日新增项目
• 待分配项目数仅显示未分配设计师的项目
• 异常项目数统计高优先级问题
• 售后服务数统计待处理投诉
• 所有统计卡片点击跳转正常
• CRM模块已正确隐藏
• 核心指标卡片已移除
• 控制台无错误信息

---

相关文档

• Parse Server数据范式文档
• 管理员仪表板数据对接
• 客服端滚动问题修复

---

修改人员

AI Assistant (Claude)

备注

此次修改严格遵循了Parse Server的数据表结构，确保数据查询的准确性和安全性。所有查询都包含了公司过滤和软删除过滤，保证了数据的隔离性。