#Tasks Specification

Historical product spec / Superseded（2026-07-15）：本文的 UI、type_category 和 close_result 是 V1 snapshot，不得作为新实现依据。现行规范见 Task System Design。

定义 Tasks 页面展示的所有数据的来源和计算方式。数据全部来自 tasks 表（callytics-common/src/db/schema/tasks.ts）。

---

#一、数据来源字段

Overdue / Due Soon 不存 DB，由前端实时计算：Overdue = status='pending' AND due_at < NOW()，Due Soon = status='pending' AND due_at BETWEEN NOW() AND NOW() + interval。

---

#二、前端展示

#2.1 Summary Cards（顶部汇总）

#2.2 筛选器

#2.3 Task Card 展示字段

每个 task card 展示以下数据：

#2.4 Close Task 弹窗

---

#三、枚举值

#3.1 type_category（11 个）

注：当前 schema 为 9 个（缺 complaint_retention、payment_recovery、freeze_recovery、event_promotion、special_promotion，多了 retention、renewal、referral），需后端更新。

#3.2 close_result（13 个）

注：当前 schema 为 11 个（缺 lead_outreached、complaint_resolved、payment_recovered、freeze_recovered、event_signed_up、promotion_converted，多了 attempted、issue_resolved、renewed、referral_obtained），需后端更新。

---

#四、Schema 差异说明

当前 schema（callytics-common/src/db/schema/tasks.ts）和本文档设计目标有差异，需后端更新：

#type_category 变更

#close_result 变更

---

#参考文档

• Tasks 字段设计
• Task 生成、更新与关闭机制
• 任务与营收归因
• Dashboard Specification