a-share-analysis/docs/features/FEAT-MO-001-market-overview/design.md

设计

首屏顺序为：市场结论、驱动与风险、核心指数、市场宽度与量能、板块概览、资金趋势。分析偏好保存在浏览器本地，页面显示轻量的当前状态入口。Vue 不直连 TDX，由 Nest API 按模块拆分接口并隔离失败。

数据可用性

• summary 和 indices：使用 TDX K 线真实响应，展示来源、快照时间和指数涨跌。
• breadth：使用 TDX 指数快照的 UpHome、DownHome 汇总上证、深证和北证市场宽度；未返回的 unchanged 明确为 null，不得用总数推算。
• sectors：使用 TDX 系统分类中的一级行业（get_stock_list(market=16)）和批量日行情，按涨跌幅排序后展示重点强弱板块。
• funds：模块名称和口径为“成交额趋势”，使用核心交易所指数日行情的 Amount 汇总当前与前一交易日成交额；这不是主力净流入。
• 主力净流入和盘中新闻不在本次 TDX 首屏主链路中，后续通过独立补充数据源适配器接入，并在响应中标记来源与数据质量。
• 页面不把缺失或权限不足的指标降级为模拟值；单个来源失败只影响对应模块。

运行边界

本功能只读调用 TDX。MySQL、Redis、RocketMQ 仍为已规划基础设施，但当前没有业务状态、缓存或异步任务需要它们，因此本切片不启用。

安全策略与评估

• TDX 地址在配置层固定为 http://127.0.0.1:17710，API 是唯一访问边界，Vue 不直连行情服务。
• 请求只允许固定方法和公开行情参数；客户端限制超时与 1 MiB 响应，异常脱敏，不记录原始载荷、凭据或网络地址。
• 本功能不提供交易写入、账户操作、用户输入拼接查询或 AI 密钥下发；MySQL/Redis/RocketMQ 未启用，不读取生产数据库。
• 已通过客户端、服务、HTTP/OpenAPI、边界和 E2E 测试；生产授权、长期断线恢复和公网安全仍需后续评估。

性能目标与评估

• 五个模块并行请求，单个 TDX 请求受配置超时保护，模块失败不阻断其他模块。
• 客户端限制响应大小，避免异常行情载荷占用过多内存；本切片不增加数据库、缓存或消息队列负载。
• 已完成构建、浏览器桌面/390px 移动端验证；未进行 7×24 采集、峰值并发和长期网络抖动压测。

ETF监控、两融数据、大盘云图和实时消息仍是独立一级菜单，不属于短线和中长线切换。