双人关系洞察工作台功能需求文档
所属分类：传统文化/关系洞察
产品案例页：https://engineering.gugudata.com/products/fortune/relationship-insight-workbench/
产品定位与截图范围
双人关系洞察工作台面向传统文化内容平台、互动娱乐应用和关系主题内容服务，提供双方资料录入、分析方向配置、关系摘要、维度对照、沟通节奏、建议复核与历史记录管理。产品目标不是替代现实沟通或专业咨询，而是把八字关系合参接口返回的文化解读组织成结构清晰、来源明确、可以复查的内容参考。
截图覆盖一个完整桌面工作台：左侧录入 A 方与 B 方资料，中间展示关系总览、六维对照、互补矩阵和沟通节奏，右侧展示沟通、家庭、价值观及长期互动建议。若页面展示六维评分，每个单项必须明确采用 20 分制，进度条长度、刻度与右侧数字保持一致，不能把 20 分误画成百分制。
目标用户与业务场景
主要用户包括传统文化内容产品经理、互动内容运营人员、会员内容服务团队、关系主题应用开发者和需要管理多语言内容的编辑团队。
典型场景包括：
- 用户填写两人的公历或农历出生资料，生成一份关系主题文化解读；
- 运营人员选择沟通、家庭、价值观、长期相处等重点方向，制作专题内容；
- 内容团队使用简体中文、繁体中文或英文输出，为不同渠道准备版本；
- 后台通过异步任务生成较长报告，并在任务完成后进入人工复核；
- 用户在历史记录中对比不同时间生成的报告，但不混淆双方资料和分析条件。
截图可见信息组织
顶部导航包括工作台、关系总览、六维分析、沟通节奏、洞察建议、记录与复盘。右上角提供新建分析、历史记录和分享入口。
左侧资料区分别展示 A 方和 B 方。每一方包含称呼、性别、历法类型、出生日期、出生时间、出生地点、闰月状态和输出语言。双方卡片必须保持独立，编辑其中一方后，旧结果应标记为待刷新，避免页面继续显示与当前资料不一致的解读。
中间总览区展示一句话摘要、互补特点、关系主题和风险提醒。六维对照用于快速扫描价值观、沟通、情感需求、生活习惯、冲突处理和成长愿景；每项采用 20 分制，并在图表标题或刻度上明确标注。互补矩阵和沟通节奏属于产品层的组织方式，不能伪装成接口未返回的客观测量。
右侧建议区按沟通建议、家庭与亲密关系、价值观与人生观、长期互动与发展分组。每条建议应能展开查看来源摘要，并固定展示“传统文化与娱乐参考，不构成现实决策依据”的说明。
核心功能需求
- 双方资料管理：支持分别录入、编辑和校验两套出生资料，公历与农历字段必须和日期含义一致。
- 分析方向配置：允许选择最多六个重点方向；未选择时使用接口默认方向。
- 关系结果展示：分开展示基础数据和文化解读，基础出生资料不得被文案生成过程改写。
- 六维结果表达：如使用评分辅助浏览，必须统一采用 20 分制，数字、刻度、进度条和表格口径一致。
- 响应模式切换：支持同步 JSON、异步任务和 SSE 流式展示；流式模式不能与异步任务同时启用。
- 历史记录：保存输入快照、重点方向、语言、生成时间和结果版本，支持按双方称呼与日期检索。
- 内容复核：允许编辑人员标记待复核、已通过和需修改，并保留修改记录。
- 使用边界：在输入区、结果区和导出内容中持续展示文化娱乐参考说明。
主要操作流程
- 用户新建分析，分别填写 A 方和 B 方资料。
- 系统校验性别、历法、日期、时间和闰月状态。
- 用户选择最多六个重点分析方向及输出语言。
- 前台提交同步请求，或由后台创建异步任务。
- 页面先渲染规范化基础数据，再呈现关系摘要、互补特点和建议。
- 用户通过六维对照、互补矩阵和沟通节奏定位需要阅读的主题。
- 编辑人员完成复核后保存记录，按需分享或导出报告。
数据与结果展示
结果区采用“基础资料—关系摘要—主题解读—行动建议—免责声明”五层结构。双方资料必须清楚标识 A 方与 B 方，不能因姓名为空而互相覆盖。公历、农历、出生时间和地点应以规范化字段展示，方便用户发现录入错误。
六维对照只承担内容导航作用。每个维度显示 A 方、B 方或共同表现时，必须解释图例含义；单项满分固定为 20 分，不得出现数值为 20、进度条却只占五分之一以外的错误比例。若结果没有足够依据生成某个维度，应显示“暂无结果”，不能补造分数。
建议卡片需要使用克制、可执行的业务语言，例如“安排固定复盘时间”“在讨论前确认双方关注点”。页面不得使用确定性承诺，也不得把文化解读包装成医疗、法律、财务、婚姻或其他专业决策建议。
接口调用蓝图
接口调用蓝图只列出当前案例的核心接口。所有请求使用生产 API 域名，appkey 仅表示调用方自己的访问凭证占位。
| 业务步骤 | 接口名称 | 接口文档 | 请求地址 | 关键入参 | 关键出参 | 传参关系 |
|---|---|---|---|---|---|---|
| 生成关系洞察 | 八字关系合参 | bazi-relationship-insight |
POST https://api.gugudata.com/ai/bazi-relationship-insight |
personA*、personB*、focusAreas、responseMode、streaming |
Data.基础数据、Data.文化解读、Data.免责声明 |
两套资料分别写入 personA 和 personB；重点方向写入 focusAreas。 |
| 查询异步任务 | 任务状态查询 | operation 查询接口 | GET https://api.gugudata.com/ai/operations/{operation_id} |
operation_id*、appkey* |
任务状态、完成结果或失败原因 | 当 responseMode=task 时，使用返回的 operationId 轮询，成功结果进入同一结果视图。 |
参数流转说明
personA 与 personB 均为完整对象，其中 gender、calendarType、birthDate 和 birthTime 必填。birthDate 使用 YYYY-MM-DD，birthTime 使用 24 小时制；农历闰月通过 isLeapMonth 明确表达。产品侧不得把一方的地点、语言或闰月状态错误复用给另一方。
focusAreas 最多传入六项。用户修改任一资料或重点方向后，当前结果应进入过期状态，重新请求前不得继续标记为最新结果。streaming=true 只用于 responseMode=sync；选择异步任务时必须关闭流式响应。
体验要求与验收标准
桌面端需要同时看见双方资料、核心结论和建议区；较窄窗口可将建议区折叠，但不能隐藏免责声明。移动端按资料录入、结果摘要、六维对照、主题建议的顺序单列展示。
验收时需要确认：双方资料是否独立；公历和农历字段是否正确；六维评分是否明确为 20 分制；图表长度是否与分数一致；修改输入后旧结果是否失效；同步、异步和流式模式是否遵守互斥关系；历史记录是否保存输入快照；接口详情页和数据预览页是否可以正常访问。
截图功能验收清单
- A 方与 B 方资料卡字段完整且不会串值；
- 六维评分标题明确标注“20 分制”；
- 数值、横向进度条、均值和图例口径一致；
- 建议卡片能按重点方向展开并进入复核；
- 历史记录保留输入条件、语言和生成时间；
- 免责声明在页面与导出结果中均清晰可见；
- 接口异常、频率受限和任务失败均有业务化提示；
- 页面不使用文化解读替代现实沟通或专业判断。
关于 GuGuData Engineering 产品案例
更多产品案例请访问 GuGuData Engineering 产品案例。
GuGuData Engineering 产品案例页展示基于咕咕数据接口能力构建的数据接入、业务流程和产品原型，帮助团队从真实业务场景出发，快速评估接口组合、调用方式和落地价值。
–EOF–
转载须以超链接形式标明文章原始出处和作者信息
