每日节奏洞察日历功能需求文档
所属分类：传统文化/每日趋势
产品案例页：https://engineering.gugudata.com/products/fortune/daily-rhythm-insight-calendar/
产品定位与截图范围
每日节奏洞察日历面向传统文化内容应用、个人记录产品和会员内容服务，把指定出生资料与目标日期对应的历法基础信息、每日主题、事业学习、关系沟通、生活节奏和行动提醒组织在一个可追溯的日历界面中。
截图覆盖个人资料、日期选择、公历与农历信息、今日主题、四类解读卡片、七日趋势、月历热力图、分时建议和待办清单。页面应把确定性的日期与历法字段同文化解读分开，所有内容仅用于文化研究与娱乐参考。
目标用户与业务场景
主要用户包括传统文化 App 产品团队、每日内容订阅服务、日历与效率工具开发者、内容编辑和多语言运营人员。
典型业务场景包括：
- 用户每天打开应用查看当日历法信息与文化主题；
- 用户切换到未来日期，为个人记录或内容排期提前生成参考；
- 运营人员批量准备一周内容，并在发布前复核日期和语言；
- 产品使用 SSE 逐步呈现较长解读，减少等待时的空白状态；
- 后台通过异步任务预生成会员次日内容，完成后写入内容日历。
截图可见信息组织
顶部导航包括今日概览、趋势日历、行动记录和历史解读。左侧展示个人资料、固定目标日期、公历信息、农历信息、生肖、星座、节气和数据更新时间。
中间顶部显示今日主题及年、月、日、时干支。事业学习、关系沟通、生活节奏和行动提醒四张卡片分别呈现摘要、关注点和简短建议。七日趋势与月历热力图用于浏览相邻日期内容，不应把文化解读分值包装成客观预测概率。
右侧按上午、下午、晚上组织时间建议，并提供当日待办。待办由用户自行创建或确认，不能把接口返回的文化内容自动标记为必须执行。底部固定展示文化娱乐参考说明和更新时间。
核心功能需求
- 个人资料：录入称呼、性别、历法、出生日期、出生时间、地点、闰月状态和语言。
- 日期查询：支持选择任意
targetDate；未传时明确使用北京时间当天。 - 基础信息：展示目标日期对应的公历、农历、干支、生肖、星座和节气。
- 主题解读：按每日主题、事业学习、关系沟通、生活节奏和行动提醒分区。
- 日历浏览：支持七日趋势和月历视图，切换日期后刷新当前结果。
- 响应模式：支持同步 JSON、异步任务与 SSE 流式响应，并遵守模式互斥规则。
- 历史记录：保存资料快照、目标日期、语言、生成时间和结果状态。
- 使用边界：不生成确定性结论，不替代现实判断或专业建议。
主要操作流程
- 用户建立或选择个人资料。
- 用户选择目标日期；默认值为北京时间当天。
- 系统校验历法、出生日期、时间格式和目标日期。
- 页面调用每日趋势接口，并优先展示基础历法信息。
- 文化解读按四个方向逐块加载。
- 用户在七日趋势或月历中切换日期，旧结果标记为历史版本。
- 用户按需把参考内容加入个人待办或保存到历史记录。
数据与结果展示
基础信息区展示出生资料和目标日期字段，必须清楚区分“用户出生日期”与“本次查询日期”。目标日期、时区和数据更新时间应始终可见，防止用户把历史结果误认为当天内容。
四类内容卡片采用固定字段顺序，卡片可以显示产品侧的阅读指数，但必须说明其仅用于内容排序。趋势图和热力图应提供图例、日期范围和无数据状态，不允许用颜色暗示确定性的吉凶结果。
时间建议只作为日程组织参考。用户可以复制、收藏或加入待办，但系统不得自动创建高风险事项，不得对健康、投资、法律、工作离职或关系决策给出确定性指令。
接口调用蓝图
| 业务步骤 | 接口名称 | 接口文档 | 请求地址 | 关键入参 | 关键出参 | 传参关系 |
|---|---|---|---|---|---|---|
| 获取每日内容 | 八字每日趋势解读 | bazi-daily-insight |
POST https://api.gugudata.com/ai/bazi-daily-insight |
profile*、targetDate、responseMode、streaming |
Data.基础数据、Data.文化解读 |
个人资料写入 profile，当前日历选择写入 targetDate。 |
| 查询异步任务 | 任务状态查询 | operation 查询接口 | GET https://api.gugudata.com/ai/operations/{operation_id} |
operation_id*、appkey* |
任务状态、结果或失败原因 | 预生成内容使用任务模式，完成后写入对应日期。 |
参数流转说明
profile.gender、profile.calendarType、profile.birthDate 和 profile.birthTime 必填。公历、农历和闰月状态需要在前端校验，不能仅依赖接口报错。targetDate 使用 YYYY-MM-DD，未传时服务端按北京时间当天处理。
日历切换会改变 targetDate。任何日期变化都必须使旧结果失效，并重新绑定新的请求 ID。streaming=true 时使用同步模式逐步呈现；批量预生成应使用 responseMode=task，由后台保存 operationId 并轮询。
体验要求与验收标准
页面首屏应清楚展示查询日期、基础历法信息和四类主题摘要。日历切换后，日期标题、内容、更新时间和历史状态同步变化。移动端按日期信息、主题卡片、趋势图、待办和免责声明排列。
验收时需要确认：目标日期是否正确；北京时间默认值是否明确；农历、干支、生肖、星座和节气是否属于同一目标日期；七日与月历视图是否同步；旧结果是否在切换日期后失效；流式与任务模式是否互斥；免责声明是否持续可见。
截图功能验收清单
- 个人资料和目标日期分别展示；
- 日期固定时，所有内容绑定同一请求结果；
- 七日趋势有图例、范围和更新时间；
- 月历选择状态与右侧内容一致；
- 时间建议可选择性加入待办，不自动执行；
- 历史记录保留资料快照与目标日期；
- 失败、限流和无数据状态不显示旧内容；
- 页面明确标注文化研究与娱乐参考边界。
关于 GuGuData Engineering 产品案例
更多产品案例请访问 GuGuData Engineering 产品案例。
GuGuData Engineering 产品案例页展示基于咕咕数据接口能力构建的数据接入、业务流程和产品原型，帮助团队从真实业务场景出发，快速评估接口组合、调用方式和落地价值。
–EOF–
转载须以超链接形式标明文章原始出处和作者信息
