3.0 KiB
3.0 KiB
设计
首屏顺序为：市场结论、驱动与风险、核心指数、市场宽度与量能、板块概览、资金趋势。分析偏好保存在浏览器本地，页面显示轻量的当前状态入口。Vue 不直连 TDX，由 Nest API 按模块拆分接口并隔离失败。
数据可用性
summary和indices：使用 TDX K 线真实响应，展示来源、快照时间和指数涨跌。breadth：使用 TDX 指数快照的UpHome、DownHome汇总上证、深证和北证市场宽度；未返回的unchanged明确为null，不得用总数推算。sectors：使用 TDX 系统分类中的一级行业（get_stock_list(market=16)）和批量日行情，按涨跌幅排序后展示重点强弱板块。funds：模块名称和口径为“成交额趋势”，使用核心交易所指数日行情的Amount汇总当前与前一交易日成交额；这不是主力净流入。- 交易日对齐：交易日期必须是有效
YYYYMMDD公历日期；指数和一级行业只保留最新交易日截面。成交额还要求日期与金额数组等长且前一交易日早于当前交易日，再按最新有效日期对汇总，避免畸形日期、数组错位或旧市场覆盖新数据。市场宽度额外并行读取一个核心指数日线作为日期参考。 - 新鲜度：日行情交易日期与
Asia/Shanghai当前日历日期不同即标记delayed；宽度沿用参考指数日期。首版不引入交易日历依赖，休市日保守标延迟并展示实际日期。 - 主力净流入和盘中新闻不在本次 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监控、两融数据、大盘云图和实时消息仍是独立一级菜单，不属于短线和中长线切换。