# 活动日历 Widget PRD

版本：v0.2  
优先级：P2  
状态：待独立页面原型与实现验证

## 修订记录

| 日期 | 版本 | 变更类型 | 变更摘要 |
| --- | --- | --- |
| 2026-08-03 | v0.1 | 初始创建 | 定义活动发现、详情和过期状态的独立流程。 |
| 2026-08-03 | v0.2 | 时间与名额状态补充 | 根据 DeepSeek PM 评审补充跨日活动的日历规则及名额已满时的入口处理。 |

## 1. 基本信息

| 属性 | 定义 |
| --- | --- |
| Widget 名称 | 活动日历 |
| 唯一标识 | `event-calendar` |
| 分类 | 资料内容 |
| 一句话介绍 | 让顾客按日期查找项目、案场或关联周边的已发布活动，并查看活动详情与可用行动。 |
| 封面图 | 活动日历类型图。 |
| 设计图 | 日历、列表和活动详情设计示意。 |

## 2. 目标与场景

面向希望了解近期案场活动或相关事项的顾客。顾客选择日期或活动类型、阅读详情并按可用入口继续，完成活动发现；该流程以独立页面为主。

## 3. 内容与数据

活动名称、起止时间、状态和详情摘要必需；起止时间最低精确到日期，配置具体时段时精确到分钟。跨日活动在覆盖的每一日均有日历标识，详情显示完整起止时间。地点、封面、类别、名额/说明、预约入口可选。仅展示已发布活动；已结束活动可按配置显示“已结束”，取消活动须明确状态。配置名额且已满时显示“已满”，不显示预约入口，保留联系/候补动作（如已配置）。预约入口只在活动可报名、未满额且目标可达时显示。

## 4. 使用与配置

配置活动集合、默认视图（日历/列表）、显示时间范围、类别筛选和是否保留已结束活动。默认范围无数据时显示邻近有效日期提示；无活动时显示空状态。活动排序默认按开始时间。

## 5. C端 UI 与交互

顾客可在日历与列表间切换、筛选、打开详情，并进入有效预约/联系入口。详情显示状态、时间、地点和完整说明；取消/结束活动不可误导为可报名。筛选无结果可重置。移动端日历可切换为日期列表，详情使用全屏或底部面板。

## 6. 用户用例与验收

**UC-01**：顾客查找某日活动并查看详情。  
**UC-02**：顾客识别活动已结束或已取消，不执行无效行动。

| 验收编号 | 验收条件 |
| --- | --- |
| AC-01 | 日历/列表中的时间与详情一致。 |
| AC-02 | 活动状态直接可见，失效预约入口不出现。 |
| AC-03 | 无活动和无筛选结果均有明确且可恢复的状态。 |