# 日影 Widget PRD

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

## 修订记录

| 日期 | 版本 | 变更类型 | 变更摘要 |
| --- | --- | --- |
| 2026-08-03 | v0.1 | 初始创建 | 定义日照/阴影资料的时间浏览与说明规则。 |

## 1. 基本信息

| 属性 | 定义 |
| --- | --- |
| Widget 名称 | 日影 |
| 唯一标识 | `sun-shadow-study` |
| 分类 | 周边环境 |
| 一句话介绍 | 让顾客按已提供日期和时刻查看项目及周边的日照/阴影资料。 |
| 封面图 | 日影分析类型图。 |
| 设计图 | 时间轴、主画面与说明面板设计示意。 |

## 2. 目标与场景

面向需要理解日照与遮挡资料的顾客。顾客选择有效日期/时间，查看对应影像与说明，完成对资料所表达条件的比较；不将资料扩展为实时预测或专业结论。

## 3. 内容与数据

必需为可浏览日影素材、日期/时刻标签和资料说明；方位、季节、分析条件可选。每个时间节点均须有对应素材；无完整节点不启用。仅展示项目已发布资料中的条件。

## 4. 使用与配置

配置可用日期、每日期间的时刻序列、默认节点和是否自动播放。默认节点失效时取首个有效节点；不完整节点从时间轴排除。可关闭自动播放。

## 5. C端 UI 与交互

默认显示主画面、日期选择、时间轴和资料说明。顾客切换日期/时刻、播放/暂停（如启用）并全屏查看；切换中显示局部加载。单节点失败跳过并提示，全部失效显示不可用。移动端时间轴可横向滚动，当前时刻始终可见。

## 6. 用户用例与验收

**UC-01**：顾客切换日期与时刻比较阴影变化。  
**UC-02**：顾客读取当前资料的分析条件说明。

| 验收编号 | 验收条件 |
| --- | --- |
| AC-01 | 当前画面、日期和时刻标签严格对应。 |
| AC-02 | 无素材节点不可选或被明确跳过。 |
| AC-03 | 自动播放、暂停和手动选择不会显示错位时刻。 |