6.2 KiB
市场综合概览 PRD
- 功能编号：FEAT-MO-001
- PRD版本：0.1
- 状态：approved
- 日期：2026-08-12
背景与问题
现有概念稿能够展示指数、情绪、板块和资金数据，但更接近数据看板，用户难以快速回答“市场当前强弱、量能是否支持、行情由谁驱动、风险在哪里”。
目标用户与使用场景
主要用户为产品所有者，少量朋友可以使用同一只读工具。用户在盘中以分钟级数据观察全市场状态，在收盘后查看冻结的最终总结和历史交易日结果。
产品目标
- 用户进入市场概览后，优先看到一句市场定性以及驱动、风险两列摘要。
- 用户能够继续核对指数、市场宽度、量能、板块、情绪和资金证据。
- 用户能够在综合、短线和中长线视角间临时切换，并选择规则、AI、混合或对照分析。
- 所有实时性、数据日期和分析依据均明确可见。
非目标
- 不做自选股、持仓、笔记、交易计划、社区、荐股、跟单和公开组合。
- 本切片直接接入已验证的 TDX 只读桥接层；不接入 RocketMQ、MySQL、Redis 和付费 AI。
- 本切片不实现用户、邀请、会员、订阅和支付。
- ETF监控、两融数据、大盘云图和实时消息仍是独立一级模块。
用户流程
- 用户进入“市场概览”。
- 首先读取市场定性、驱动因素和风险信号。
- 通过“查看依据”核对指标来源。
- 向下查看指数、宽度、量能、板块、情绪和资金摘要。
- 点击轻量分析状态入口，临时切换分析周期和分析引擎。
- 点击指数或板块入口进入未来的详情页；首个切片只保留可识别入口。
功能需求
| 编号 | 优先级 | 需求 | 可观察结果 |
|---|---|---|---|
| FR-001 | P0 | 结论优先展示市场定性 | 首屏顶部出现一句结论、市场状态、量能状态和情绪状态 |
| FR-002 | P0 | 展示驱动与风险 | 结论下方并列显示已由 TDX 支持的驱动和风险证据；缺少口径时明确标记 |
| FR-003 | P0 | 展示数据新鲜度 | 页面显示交易状态、数据更新时间和正常/延迟/不完整状态 |
| FR-004 | P0 | 提供分析偏好 | 可选择综合/短线/中长线和规则/AI/混合/对照，并在本地保存默认值 |
| FR-005 | P1 | 展示市场证据模块 | 指数、宽度、量能、板块、情绪和资金摘要可阅读 |
| FR-006 | P1 | 查看结论依据 | 点击入口后展示指标、数值、口径和更新时间 |
| FR-007 | P1 | 支持异常状态 | 加载、空、部分数据、过期和错误状态具有明确文案 |
数据与口径
首个切片由 Nest API 直接读取 TDX 只读桥接层。指数和摘要使用真实 TDX K 线映射；市场宽度使用三市场指数快照，板块使用一级行业目录与日行情，量能使用三市场指数成交额汇总。主力净流入和盘中新闻不在本切片 TDX 主链路中，必须保持明确的补充源边界，不得用指数或离线样本冒充。所有响应仍包含交易日期、快照时间、来源状态、完整性和单位。
A 股使用红涨绿跌。成交额统一展示为亿元，比例明确使用百分比。历史数据和低频资金数据必须显示实际数据日期，旧数据不得标记为实时。
TDX 交易日期必须通过真实公历日期校验。成交额当前/前一日金额必须与同索引日期对齐，且前一交易日严格早于当前交易日；不满足条件的市场不参与汇总，也不得抢占最新日期截面。
指数和板块涨跌幅必须同时具备有效且严格递增的相邻日期。前一根日期非法、重复或晚于当前日期时，指数只展示当前价而不生成涨跌信号，板块不进入强弱排序。
首个切片不引入交易日历依赖：指数、一级行业和成交额的最新交易日期与 Asia/Shanghai 当前日历日期不同即标记 delayed；市场宽度快照缺少日期字段，使用同批核心指数日线作为日期参考。周末和法定休市日会保守显示延迟并同时展示实际交易日期，后续接入权威交易日历后再细化“最新交易日”语义。
状态与异常
- 交易中：显示分钟级更新时间。
- 午间休市或已收盘：显示对应市场状态。
- 数据延迟：保留最近有效值并标记延迟。
- 部分数据：只隐藏缺失指标，不让整页失败。
- AI不可用：规则分析继续可用，并标记降级。
权限、合规与安全
当前为只读访问，不提供交易指令。结论不得包含买入、卖出、目标价和仓位建议。付费 AI 密钥未来只保存在服务端。
成功指标
- 用户能够在 30 秒内说出市场定性、主要驱动和首要风险。
- 所有结论均能展开查看至少一项数据依据。
- 页面在目标桌面视口和窄窗口中不阻断核心内容。
验收标准
- Given 页面加载有效快照，When 用户进入市场概览，Then 结论、驱动、风险和更新时间在首屏可见。
- Given 用户打开分析状态入口，When 切换周期或引擎，Then 页面状态立即更新且可选择设为默认。
- Given 数据快照被标记为延迟，When 页面渲染，Then 最近有效值保留并明确显示延迟，不能显示“实时”。
- Given 用户看到查看依据入口，When 后续依据抽屉功能立项，Then 能看到指标名称、数值、口径和更新时间；本切片只保留入口。
风险与依赖
- 免费数据源稳定性和商业授权需要在正式接入阶段重新评估。
- AI 分析必须受结构化数据和规则事实约束。
- 首个视觉版本用于验证信息层级，不作为最终设计冻结版本。
发布范围与回退触发条件
本次仅发布本地 Vue 3 首屏原型。核心交互不可用、结论依据不可追溯或窄屏遮挡核心信息时不得发布；出现回归时回退到上一个本地标签。
变更记录
- 0.1：建立首版 PRD，补充结论优先、分析偏好和异常状态。
- 0.2：根据 TDX 实连验证修正数据源、可用性边界和未接入基础设施范围。
- 0.3：核对官方行情接口后确认市场宽度、一级行业板块和成交额趋势可由 TDX 直接提供；主力净流入与盘中新闻保留补充源边界。