> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# 4. Calendar

Calendar 把 Tasks 里的任务按时间铺开：看每天每小时压了多少活、谁身上多、哪些逾期或没排时间，并且可以直接拖动改期。它不产生新的任务，数据和 Tasks 是同一份。

## 1 页面与操作

### 1.1 视图切换、筛选与统计

#### Open tasks / Closed tasks

| 标签           | 看什么                    | 日历落位时间                   | 可以做什么                           |
| ------------ | ---------------------- | ------------------------ | ------------------------------- |
| Open tasks   | 未关闭任务，查看和安排接下来的工作      | Next Action；没有时间的任务不进入日历 | 拖动重新排期、点击头像改派、点击卡片进入 Tasks 对应任务 |
| Closed tasks | 已关闭任务，回看每天关闭了哪些任务、由谁关闭 | Close time               | 查看关闭记录、点击卡片进入 Tasks 对应任务；日历内只读  |

**Deadline 不决定任务在日历中的位置**，只作为截止时间提示。所有日期与时间按门店时区显示。

Open 卡片显示负责人；Closed 卡片显示关闭人，可能是员工、Retaintive Agent，或无法确认关闭人的 Unknown。Closed 卡片使用灰底。

#### Week view / Month view

两种状态都可以切换周视图和月视图。进入 Calendar 默认是 Open tasks 的 Week view。

| 标签         | 展示方式                                           | 使用方式                                                             |
| ---------- | ---------------------------------------------- | ---------------------------------------------------------------- |
| Week view  | 连续 7 天，每天一列，左侧为 7 AM–9 PM 小时轴，每条任务单独显示卡片       | 查看每天各时段的工作安排；Open 任务可拖到未来某天的小时位置，分钟为 `:00`                       |
| Month view | 按月展示，每天显示任务数量和按人员汇总的头像数量标签，最多显示 4 组，更多折叠为 `+N` | 查看整月工作分布；点击日期或 `+N` 查看当天完整列表，展开人员分组查看任务；Open 任务拖到某天后，在确认框中选择具体时间 |

周视图的任务卡显示客户姓名、电话、时间、任务类型和人员头像。有 Deadline 时显示 `D 时间` 徽章，未关闭任务的 Deadline 过期后变红。小时轴之外的任务放在首尾时段，实际时间以卡片显示为准。

#### Filters、任务数量与人员统计

| 元素                         | 说明                                                      |
| -------------------------- | ------------------------------------------------------- |
| Filters                    | Task type 支持多选；Open 按 Assignee 筛选，Closed 按 Closed by 筛选 |
| `N on this page · M total` | 周视图：N 为当前显示的 7 天内任务数；M 为当前门店、状态及筛选下的任务总数，不受查看日期限制       |
| `N in September · M total` | 月视图：N 为当前月份的任务数；M 的口径与周视图一致                             |
| 人员头像 `×N`                  | 当前日历范围内每个人的任务数；Open 按负责人统计，Closed 按关闭人统计                |

### 1.2 Help 与日期导航

**Help** 解释当前 Open 或 Closed 视图的时间规则、卡片含义和可用操作。

| 视图         | 日期导航                                                       |
| ---------- | ---------------------------------------------------------- |
| Week view  | 双左箭头向前一周，单左箭头向前一天；单右箭头向后一天，双右箭头向后一周。翻一天时仍显示连续 7 天，不会切成单日视图 |
| Month view | 左右箭头切换上个月、下个月，中间显示当前查看的月份                                  |

离开当前日期范围后，可以用 **Back to today**（周视图）或 **Back to this month**（月视图）返回。

### 1.3 Needs attention

仅 Open tasks 显示红色 **Needs attention · N** 按钮，N 为下面两类任务的数量之和。默认收起，点击后在工具栏下方展开，再次点击收起。

两个区域在桌面端左右并排，窄屏上下排列，各自可以展开或折叠。标题按 `NEEDS ATTENTION · 分类 · 数量` 显示，下面说明拖拽用途。

| 区域                      | 哪些任务放在这里                              | 可以做什么                                   |
| ----------------------- | ------------------------------------- | --------------------------------------- |
| Next action due         | Next Action 已到或早于当前时刻的未关闭任务，按时间从早到晚排列 | 任务仍保留在原定日期的日历中；这里集中列出，方便直接拖到新的日期或时间重新排期 |
| Next action unscheduled | 没有 Next Action 时间的未关闭任务，尚未放入日历        | 直接拖到日历中安排时间                             |

这两个区域跟随当前门店及筛选条件，不受正在查看的周或月份限制，**不按 Deadline 判断**。卡片第一行左侧为客户名、右侧为 Next Action 时间或 Unscheduled；第二行左侧为任务类型、右侧为 Deadline（如有）。

确认排到未来时间后，任务退出 Needs attention，并按新时间出现在日历中；如果新时间不在当前查看范围，需要切换到对应日期查看。

### 1.4 拖拽后的确认

从日历或 Needs attention 拖动 Open 任务后，弹出 **Confirm new Next Action**：

- 顶部左侧显示客户名，右侧显示任务类型。
- 周视图显示 New Next Action；月视图显示目标日期和可编辑的时间。
- 有 Deadline 时显示截止时间。新时间晚于 Deadline 会出现红色提醒，仍可确认。
- 点击 **Confirm** 保存；点击 **Cancel** 保留原时间。不能安排到过去。

重新排期会记入任务 Timeline。缺少行动描述的任务也可以修改时间，不要求先补写描述。

### 1.5 与 Tasks、Lead Line 的关系

Calendar 与 [Tasks](/funding-strategy/02-产品说明书/03-tasks.md) 使用同一份任务数据，只是按时间展示；在日历中改期和改派会更新对应任务。

Lead Line（门店级开关的自动回拨）和人工任务队列使用同一个 Next Action 时间：未来的安排尚未到时不会自动外呼；新版任务没有 Next Action 时间时可视为现在可拨，但仍需满足其他外呼条件。联系节奏若因 Deadline 暂停并清空 Next Action，这类任务会进入 Next action unscheduled，供员工处理。

## 2 当前限制

- Lead Line 的两条线索类型限定（lead\_outreach、lead\_follow\_up）与任务节奏策略的线索家族（还含 booked\_not\_converted）范围不完全一致。
- 小时轴固定 7 AM–9 PM，不随门店营业时间变化；7 点前或 9 点后的任务贴在首尾格，肉眼看不出真实时刻，需看卡片上的时间。
- 旧版（legacy）任务改期时要求门店有在职员工，否则弹窗提示去 Setup 添加；处于过渡状态的任务暂时不能在日历改期，只提示刷新重试。

## 3 实现依据

本章按本地代码核查，页面实际启用情况以部署版本为准。

[Calendar](https://github.com/retaintive/callytics-infrastructure/blob/main/apps/web/src/pages/tasks/cadence.vue) · [落位规则](https://github.com/retaintive/callytics-infrastructure/blob/main/apps/web/src/pages/tasks/composables/cadence-schedule-basis.ts) · [页面自带 Help](https://github.com/retaintive/callytics-infrastructure/blob/main/apps/web/src/pages/tasks/components/cadence-help-dialog.vue) · [Lead Line 门控](https://github.com/retaintive/callytics-infrastructure/blob/main/lambda/lead-processor/src/core/ring-out-gates.ts) · [联系节奏](https://github.com/retaintive/callytics-infrastructure/blob/main/packages/task-engine/src/task-cadence/cadence-policy-v1.ts)