星座周期内容中心功能需求文档
所属分类：文化娱乐/星座内容
产品案例页：https://engineering.gugudata.com/products/fortune/western-zodiac-content-center/
产品定位与截图范围
星座周期内容中心面向星座栏目、文化娱乐应用和多语言内容团队，提供十二星座选择、出生日期换算、周期内容生成、审核、发布日历和效果分析。产品支持今日、明日、本周、本月和本年五种周期，并把星座基础归属、周期范围与文化解读分开管理。
截图覆盖星座选择、出生日期换算、周期与目标日期、星座摘要、四类内容卡片、五维对照、内容日历、十二星座批量状态、多语言版本、异步任务和渠道发布清单。
目标用户与业务场景
主要用户包括文化娱乐内容编辑、星座栏目运营、国际化内容团队、会员订阅产品经理和社交渠道运营人员。
典型业务场景包括：
- 为单一星座生成今日或本周内容并进行人工审核；
- 输入出生日期自动换算星座，提供用户侧内容入口；
- 批量准备十二星座的每日内容，并跟踪每一项任务状态；
- 生成简体中文、繁体中文和英文版本，分别进入校对流程；
- 将已审核内容排入官网、公众号、微博或其他渠道日历。
截图可见信息组织
顶部导航包括内容总览、周期选题、星座管理、发布日历和效果分析。左侧展示十二星座、可选出生日期、五种周期、目标日期和语言。
中间顶部显示规范化星座中英文名称、星座日期边界、当前周期和周期范围。周期主题、事业学习、关系沟通和生活提醒构成主内容。五维对照只用于编辑侧快速浏览，不表示客观概率或现实结果。
下方内容日历展示每个日期的生成、审核和发布状态；十二星座批量表展示每个星座的内容与语言版本。右侧提供内容预览、审核记录、多语言状态、异步任务进度、渠道清单和文化娱乐参考说明。
核心功能需求
- 星座输入：支持中文、英文星座名称，也支持通过出生日期换算。
- 输入互斥：
sign与birthDate必须且只能传一个。 - 周期管理：支持今日、明日、本周、本月和本年，并展示准确边界。
- 内容结构：统一展示周期主题、事业学习、关系沟通和生活提醒。
- 批量生产：产品后台对十二星座分别创建请求和任务记录。
- 多语言版本：支持简体中文、繁体中文和英文，版本状态互相独立。
- 审核与发布：内容通过人工审核后才可加入渠道发布清单。
- 使用边界：页面和最终内容都明确属于文化娱乐参考。
主要操作流程
- 用户选择星座，或输入出生日期进行换算。
- 选择周期、目标日期和输出语言。
- 系统校验星座与出生日期二选一，规范化星座名称。
- 前台同步生成单条内容，或后台创建批量异步任务。
- 页面展示周期边界、四类内容和版本更新时间。
- 编辑人员校对语言、周期一致性和使用边界。
- 审核通过后将内容加入渠道发布日历。
- 发布结果、内容版本与接口任务状态分别留档。
数据与结果展示
星座基础信息包括规范化名称和日期边界。周期标识需要同时显示枚举名称和实际日期范围，尤其要避免“本周”内容跨周后仍被标记为当前版本。
五维对照、星级或阅读指数属于产品侧内容组织，只用于帮助编辑定位重点，不得包装成客观测量。批量表格按星座、周期主题、内容状态、审核状态、多语言完成度和更新时间展示。
多语言版本必须各自保存生成时间、审核人和发布状态。某一语言失败时，不应把其他语言标记为失败；源内容变化后，所有依赖版本需进入待更新状态。
接口调用蓝图
| 业务步骤 | 接口名称 | 接口文档 | 请求地址 | 关键入参 | 关键出参 | 传参关系 |
|---|---|---|---|---|---|---|
| 生成星座周期内容 | 星座周期趋势解读 | western-zodiac-period-insight |
POST https://api.gugudata.com/ai/western-zodiac-period-insight |
sign 或 birthDate、period、targetDate、language、responseMode、streaming |
Data.基础数据.星座、Data.基础数据.周期标识、Data.文化解读 |
星座名称与出生日期二选一；目标日期决定周期范围。 |
| 查询异步任务 | 任务状态查询 | operation 查询接口 | GET https://api.gugudata.com/ai/operations/{operation_id} |
operation_id*、appkey* |
任务状态、结果或失败原因 | 批量和多语言任务分别保存 operationId。 |
参数流转说明
直接选择星座时传 sign，支持中文或英文名称；通过生日换算时传 birthDate，格式为 YYYY-MM-DD。两者必须且只能存在一个。前端可以提供换算预览，但最终以接口规范化结果为准。
period 支持 today、tomorrow、week、month 和 year。targetDate 是计算周期的基准，缺省时使用北京时间当天。批量生成时，每个星座和每种语言都是独立请求，必须保留独立输入快照和任务状态。
体验要求与验收标准
首屏需要清楚显示当前星座、目标日期、周期范围和语言。用户切换任一条件后，旧预览立即标记为过期。桌面端可同时查看批量表与内容预览，移动端优先展示单星座内容和审核状态。
验收时需要确认：中文与英文星座名称是否规范化；出生日期边界换算是否正确；二选一校验是否生效；五种周期范围是否准确；批量任务是否互相独立；语言版本是否分开审核；发布是否必须经过审核；免责声明是否进入所有渠道版本。
截图功能验收清单
- 十二星座中英文名称对应正确；
- 星座与出生日期输入严格二选一；
- 周期名称和日期范围同时展示；
- 内容卡片绑定当前星座、周期和语言；
- 批量任务保留逐项状态与失败原因；
- 多语言版本独立生成、审核和发布；
- 内容日历区分草稿、待审核、已发布和失败；
- 页面不把文化娱乐内容表达为现实决策依据。
关于 GuGuData Engineering 产品案例
更多产品案例请访问 GuGuData Engineering 产品案例。
GuGuData Engineering 产品案例页展示基于咕咕数据接口能力构建的数据接入、业务流程和产品原型，帮助团队从真实业务场景出发，快速评估接口组合、调用方式和落地价值。
–EOF–
转载须以超链接形式标明文章原始出处和作者信息
