Compare commits
16
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
 FoXiMao
|
1f6ed00e6f | ||
|
FoXiMao
|
c2fdfa625b | ||
|
FoXiMao
|
ae2a7e08ed | ||
|
FoXiMao
|
7e4dcd9232 | ||
|
FoXiMao
|
49f6be9c43 | ||
|
FoXiMao
|
ff8ada8316 | ||
|
FoXiMao
|
82619489a9 | ||
|
FoXiMao
|
27bc3c198f | ||
|
FoXiMao
|
15a25002ce | ||
|
FoXiMao
|
c2fa929936 | ||
|
FoXiMao
|
6eb34b5afe | ||
|
FoXiMao
|
d283ee3196 | ||
|
FoXiMao
|
9a965fab14 | ||
|
FoXiMao
|
b49e7b8b08 | ||
|
FoXiMao
|
11edeb0111 | ||
|
FoXiMao
|
16bde94df6 |
@@ -29,7 +29,7 @@
|
||||
<!-- gitnexus:start -->
|
||||
# GitNexus — Code Intelligence
|
||||
|
||||
This project is indexed by GitNexus as **a-share-analysis** (2429 symbols, 3280 relationships, 63 execution flows). Use the GitNexus MCP tools to understand code, assess impact, and navigate safely.
|
||||
This project is indexed by GitNexus as **a-share-analysis** (2432 symbols, 3283 relationships, 63 execution flows). Use the GitNexus MCP tools to understand code, assess impact, and navigate safely.
|
||||
|
||||
> If any GitNexus tool warns the index is stale, run `npx gitnexus analyze` in terminal first.
|
||||
|
||||
|
||||
@@ -4,6 +4,13 @@
|
||||
|
||||
## Unreleased
|
||||
|
||||
## 0.0.10 - 2026-08-18
|
||||
|
||||
- 使用 Node.js 22.x 与 mysql2 直接读取 MySQL 5.7.x 元数据和 `SHOW CREATE`，移除 Schema 基线对本机 MySQL CLI 的依赖。
|
||||
- 新增 format v3 exporter/driver 元数据，永久只读兼容 format v1/v2。
|
||||
- 增加对象目录、视图依赖排序、并发漂移检测、错误脱敏、超时和定义大小保护。
|
||||
- 恢复版本开发门禁并封存 `v0.0.9` development `captured_empty` Schema 基线。
|
||||
|
||||
## 0.0.9 - 2026-08-17
|
||||
|
||||
- Node.js 运行时约束明确为完整 22.x，不绑定 minor 或 patch。
|
||||
|
||||
@@ -0,0 +1,33 @@
|
||||
{
|
||||
"format_version": 3,
|
||||
"status": "captured_empty",
|
||||
"application_version": "v0.0.10",
|
||||
"git_commit": "16bde94df68263672fa12e2823afe024c741f84e",
|
||||
"source_environment": "development",
|
||||
"database_name": "a_share_analysis_dev",
|
||||
"charset": "utf8mb4",
|
||||
"collation": "utf8mb4_general_ci",
|
||||
"generated_at": "2026-08-17T19:07:54.864Z",
|
||||
"generator": "schema-baseline/3.0.0",
|
||||
"reason": "none",
|
||||
"schema_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
|
||||
"objects": {
|
||||
"tables": false,
|
||||
"views": false,
|
||||
"triggers": false,
|
||||
"routines": false,
|
||||
"events": false
|
||||
},
|
||||
"object_counts": {
|
||||
"tables": 0,
|
||||
"views": 0,
|
||||
"triggers": 0,
|
||||
"routines": 0,
|
||||
"events": 0
|
||||
},
|
||||
"exporter_name": "mysql2-show-create",
|
||||
"exporter_version": "1.0.0",
|
||||
"database_driver": "mysql2",
|
||||
"database_driver_version": "3.23.3",
|
||||
"mysql_server_version": "5.7.42-0ubuntu0.18.04.1"
|
||||
}
|
||||
+2
@@ -4,6 +4,8 @@ APP_ENV=development
|
||||
API_HOST=127.0.0.1
|
||||
API_PORT=3000
|
||||
LOG_LEVEL=debug
|
||||
TDX_BASE_URL=http://127.0.0.1:17710
|
||||
TDX_TIMEOUT_MS=5000
|
||||
|
||||
# 第一阶段实际启用的 Redis。
|
||||
REDIS_HOST=127.0.0.1
|
||||
|
||||
+2
@@ -3,6 +3,8 @@ APP_ENV=production
|
||||
API_HOST=127.0.0.1
|
||||
API_PORT=3000
|
||||
LOG_LEVEL=info
|
||||
TDX_BASE_URL=http://127.0.0.1:17710
|
||||
TDX_TIMEOUT_MS=5000
|
||||
|
||||
REDIS_HOST=127.0.0.1
|
||||
REDIS_PORT=6379
|
||||
|
||||
@@ -1,5 +1,33 @@
|
||||
# 设计
|
||||
|
||||
首屏顺序为：市场结论、驱动与风险、核心指数、市场宽度与量能、板块概览、情绪与资金摘要。分析偏好保存在浏览器本地，页面只显示轻量的当前状态入口。
|
||||
首屏顺序为：市场结论、驱动与风险、核心指数、市场宽度与量能、板块概览、资金趋势。分析偏好保存在浏览器本地，页面显示轻量的当前状态入口。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监控、两融数据、大盘云图和实时消息仍是独立一级菜单，不属于短线和中长线切换。
|
||||
|
||||
@@ -0,0 +1,55 @@
|
||||
# FEAT-MO-001 开发总结
|
||||
|
||||
## 原始开发需求
|
||||
|
||||
实现市场概览首屏：结论优先展示市场状态、驱动与风险，并支持综合、短线、中长线视角和规则、AI、混合、对照分析选择；用户可从指数和板块入口进入后续详细分析。
|
||||
|
||||
## 需求与范围变化
|
||||
|
||||
- 数据源从早期“确定性模拟快照”调整为 TDX 只读直连，Nest API 访问本机 `127.0.0.1:17710`，Vue 不直接访问 TDX。
|
||||
- API 按摘要、指数、市场宽度、板块和资金拆分，避免把整个首屏塞入单个接口。
|
||||
- 当前 TDX 桥接已确认 `get_market_snapshot`、`get_stock_list` 和批量 `get_market_data` 可用；市场宽度、一级行业板块和成交额趋势改为真实 TDX 映射。主力净流入字段虽存在但当前实测为零值，盘中新闻无官方行情接口，因此两者延期到补充源功能。
|
||||
- MySQL、Redis、RocketMQ 和 AI 仍不进入本切片运行链路；它们保留为后续基础设施边界。
|
||||
|
||||
## 实际完成需求
|
||||
|
||||
- 新增 TDX 配置校验、超时/响应大小限制、错误脱敏的 Node 客户端。
|
||||
- 新增市场概览 DTO、服务、控制器、OpenAPI 契约和前端 Axios API 文件。
|
||||
- 完成结论、驱动与风险、核心指数、市场宽度、板块、资金趋势模块，以及加载/错误/不可用状态。
|
||||
- 完成分析视角和分析引擎切换，本地保存用户偏好。
|
||||
- 真实 TDX 指数和摘要已通过本机隧道冒烟；未用指数或离线样本伪造缺失指标。
|
||||
- 真实 TDX 市场宽度、一级行业和成交额趋势已通过本机桥接冒烟；资金模块明确使用成交额口径，不宣称主力净流入。
|
||||
|
||||
## 修复缺陷
|
||||
|
||||
- 修正 PRD 和实施计划中仍描述“模拟数据”的旧表述。
|
||||
- 避免单个 TDX 模块失败导致整页失败，改为五个模块并行、独立状态。
|
||||
- 对未注册桥接方法返回结构化原因，避免前端显示“实时”或空白数据。
|
||||
- 修复 Vue TypeScript 单文件组件未被 ESLint 正确解析的问题，并为 E2E 测试进程补齐必需的本机 TDX 配置边界。
|
||||
- 隔离应用外壳单测中的真实 Axios 请求，消除 JSDOM 网络错误噪声，保持页面测试只验证外壳职责。
|
||||
- 根据代码 Review 修复畸形 TDX 字段被折算为零、缺市场成交额误报三市、交易日错位跨日求和、空行业目录误报 `fresh`、前端隐藏 `partial/delayed` 警告和零变化使用上涨色等缺陷，并补齐对应回归测试。
|
||||
- 根据二次 Review 继续修复涨跌家数接受非整数、成交额受市场定义顺序影响、指数/板块跨交易日混排和后端从不生成 `delayed` 的边界；宽度增加核心指数日期参考，不新增基础设施或第三方依赖。
|
||||
- 根据第三轮独立 Review 修复 8 位畸形日期被误认为有效公历日期、成交额接受倒序日期对与日期/金额数组错位，以及服务测试依赖运行当天的问题。
|
||||
- 根据第四轮独立 Review 修复指数/板块未校验前一根 K 线日期的问题；非法、重复或倒序的前一日期不再生成涨跌信号。
|
||||
|
||||
## 未完成与延期项
|
||||
|
||||
- 主力净流入的权限/数据质量验证、盘中新闻补充源、真实图表和口径仍延期。
|
||||
- “查看依据”抽屉、指数/板块详情页、AI 请求和用户体系另立功能。
|
||||
- 本地验证不代表生产 7×24 采集稳定性、商业授权或公网部署安全性。
|
||||
|
||||
## 关键提交
|
||||
|
||||
- `9a965fa`、`d283ee3`、`6eb34b5`、`c2fa929`、`15a2500`、`27bc3c1`、`8261948`、`ff8ada8`、`49f6be9`、`7e4dcd9`、`ae2a7e0`、`c2fdfa6`
|
||||
|
||||
## 验证证据
|
||||
|
||||
- GitNexus 已完成提交前重新索引；上一修复提交的最终 staged 检测映射 66 个符号、21 条概览执行流并标记 critical。风险来自本功能修改核心概览服务、TDX 映射和前端数据面板，已由定向单测、HTTP/OpenAPI、前端状态回归、构建、浏览器视觉验证和 E2E 覆盖；未发现额外业务模块调用方。第三轮修复前又用 MCP 对 `toTradeDate` 和 `mapTurnoverTrend` 执行符号级影响分析，直接调用方仅在市场概览映射与测试范围。
|
||||
- API 冒烟：`/breadth`、`/sectors`、`/funds` 均返回 `source=tdx,status=fresh`；完整结果和耗时见 `tdx-smoke-report.md`。
|
||||
- 家庭 LAN 隧道二次复验：五个市场概览接口均为 `fresh`，指数 3 项、板块 8 项、成交额覆盖 3 个市场且交易日期完整；只保存脱敏统计。
|
||||
- 日期对齐与延迟状态修复后，后端 60/60、完整全仓门禁和家庭 LAN 五接口当日 `fresh` 复验通过；第三轮日期真实性与测试时钟修复后，后端增加至 63/63；第四轮相邻日期修复后，后端增加至 67/67。`c2fdfa6` 推送前后均执行完整 `pnpm verify`，契约、Lint、格式、类型、全部测试、构建和 E2E 均通过。
|
||||
- 前端单测、typecheck、build、后端 TDX/映射/服务/HTTP/OpenAPI 测试通过。
|
||||
- `pnpm verify:e2e`：4/4 通过（桌面和移动端各覆盖页面与健康契约）。
|
||||
- 浏览器桌面与 390px 移动视口验证无横向溢出，视角与引擎切换可用。
|
||||
- 五轮独立 Review 均已归档：前四轮发现的数据完整性、状态、日期真实性/顺序、测试时钟和前一根日期校验问题均已关闭；第五轮最终结论为 `Ready to merge: Yes`，无 Critical、Important 或 Minor 问题。
|
||||
- 开发 Schema 按用户确认跳过，沿用 `v0.0.10 captured_empty` 追溯边界，不读取生产库。
|
||||
@@ -0,0 +1,26 @@
|
||||
# GitNexus 开发后基线
|
||||
|
||||
## GitNexus 状态
|
||||
|
||||
```text
|
||||
Repository: /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis/.worktrees/feat-mo-001-tdx-overview
|
||||
Indexed: 8/18/2026, 9:13:11 PM
|
||||
Indexed commit: c2fdfa6
|
||||
Current commit: c2fdfa6
|
||||
Status: ✅ up-to-date
|
||||
```
|
||||
|
||||
## Git 已跟踪变更摘要
|
||||
|
||||
```text
|
||||
AGENTS.md | 2 +-
|
||||
1 file changed, 1 insertion(+), 1 deletion(-)
|
||||
```
|
||||
|
||||
## Git 工作区摘要
|
||||
|
||||
```text
|
||||
M AGENTS.md
|
||||
```
|
||||
|
||||
业务代码基线 `c2fdfa6` 已提交并推送；上述唯一工作区差异是 GitNexus 自动维护的入口说明，未纳入功能提交。
|
||||
@@ -0,0 +1,16 @@
|
||||
# GitNexus 前后对比
|
||||
|
||||
## 开发前
|
||||
|
||||
- 基线：`gitnexus/before.md`、`gitnexus/implementation-baseline.md`。
|
||||
- 目标是把模拟首屏改为 TDX 只读概览，并拆分五个 HTTP 模块接口。
|
||||
|
||||
## 开发后
|
||||
|
||||
- CLI 已完成最终重新索引，保留 85 条执行流并识别本功能影响路径。
|
||||
- 宽范围修复曾识别 21 条概览执行流并标记 critical；最终相邻日期修复收敛为 3 条候选映射执行流并标记 medium。核心路径均有单测、HTTP/OpenAPI、前端状态、构建、视觉和 E2E 验证。
|
||||
- 未新增消息、数据库、Redis、Scheduler、Worker 或部署运行时依赖。
|
||||
|
||||
## 差异结论
|
||||
|
||||
直接影响集中于 TDX API、市场概览服务、前端 API/页面和测试夹具；生产数据边界、基础设施暂不启用边界和回退路径保持不变。
|
||||
@@ -0,0 +1,19 @@
|
||||
# GitNexus 开发后变更检测
|
||||
|
||||
## 检测命令
|
||||
|
||||
```text
|
||||
npx gitnexus analyze
|
||||
npx gitnexus detect-changes --repo "$PWD" --scope staged
|
||||
```
|
||||
|
||||
## 结果
|
||||
|
||||
- 索引：已完成最终增量更新。
|
||||
- 暂存文件：11 个文件、24 个符号；GitNexus 自动改写的 `AGENTS.md` 已明确排除。
|
||||
- 影响执行流：3 条，CLI 风险：medium。
|
||||
- 主要执行流：`Candidates → ToNumber`、`Candidates → ToTradeDate` 与 `Candidates → MapDirection`；本轮未修改服务状态策略或跨模块契约。
|
||||
|
||||
## 处置
|
||||
|
||||
本轮 medium 来自指数/板块相邻日期比较的局部映射变更，不是未知跨业务扩散。已用 TDX 映射/服务测试、类型检查和 `git diff --check` 验证；前一提交已覆盖 HTTP/OpenAPI、前端状态、构建、浏览器视觉和 4/4 E2E，未发现用户、消息、数据库、Redis、RocketMQ、Scheduler、Worker、认证或部署调用方。当前环境已使用 GitNexus MCP 与同版本 CLI 交叉确认，没有将工具限制误判为低风险。
|
||||
@@ -2,8 +2,8 @@
|
||||
|
||||
- 功能编号：FEAT-MO-001
|
||||
- 基线提交：`c0a6f5560584`
|
||||
- 当前阶段：TDX 开发连接设计与首页方案确认
|
||||
- 当前总体风险：LOW（仅本机 SSH 配置和操作文档）；首页业务代码风险待设计确认后按符号补充
|
||||
- 当前阶段：TDX 直连首页实施，已完成开发前门禁和最小只读协议验证
|
||||
- 当前总体风险：LOW（新增边界尚未落地）；TDX 客户端、API、OpenAPI 和 Web 首屏实现后按符号补充
|
||||
|
||||
## 直接与间接影响
|
||||
|
||||
@@ -11,14 +11,14 @@
|
||||
|
||||
- 正式行情来源确定为 TDX；家庭局域网和外部 Tailscale 只改变 Mac 到同一 Windows `sshd` 的网络路径。
|
||||
- TDX Bridge 的稳定入口固定为 Mac 回环地址 `127.0.0.1:17710`，市场概览、规则分析、AI 分析和未来 HTTP 契约不得依赖家庭地址、Tailscale 地址或 TDX 原始字段。
|
||||
- 当前仓库没有 TDX Provider 或市场概览运行时符号，本阶段只更新操作文档；GitNexus 未识别可执行调用链影响。
|
||||
- 当前仓库尚无 TDX Provider 或市场概览运行时符号；本次将新增 API 业务模块、TDX 客户端、OpenAPI 契约和 Web 首屏。新增符号的直接调用链将在实现后重新索引并执行变更检测。
|
||||
- 首页业务设计确认后，必须对 `App.vue`、`createAppRouter`、后端模块装配、HTTP DTO 和新增市场概览符号分别执行 upstream impact。HIGH 或 CRITICAL 结果先告知用户再修改。
|
||||
|
||||
## 跨模块同步修改
|
||||
|
||||
- HTTP/OpenAPI：当前连接文档不修改；首页正式接入时需要版本化市场概览 DTO 与 OpenAPI 契约。
|
||||
- Web API 与 adapter：当前不修改；未来页面只能经 `web/src/api/<业务域>/index.ts`、Axios 封装和 ViewModel 消费数据。
|
||||
- 消息契约、Redis、MySQL、Scheduler、Worker：当前不启用。正式采集链路仍按独立功能立项，不能由 API 请求临时抓取全市场数据。
|
||||
- HTTP/OpenAPI：本次新增版本化市场概览 DTO 和五个只读路径，并重新生成 OpenAPI 契约。
|
||||
- Web API 与 adapter：本次新增 `web/src/api/market-overview/index.ts`，页面只能经 Axios 封装和 ViewModel 消费数据。
|
||||
- 消息契约、Redis、MySQL、Scheduler、Worker：本次首屏不启用业务链路，仅保留既有架构边界；正式采集、快照持久化、缓存和异步分发仍按独立功能立项。
|
||||
- 配置部署：真实地址、用户名、密钥和控制套接字只保留在开发机，不进入仓库、环境模板或前端构建物。
|
||||
- 测试：两种 SSH 路径均需验证到同一 Mac 回环端点；离线样本只作显式开发回退，不得标记为实时 TDX。
|
||||
- 文档：同步更新 Tailscale/SSH 开发手册，明确家庭局域网与外部 Tailscale 的选择、启动、停止、切换和验证方法。
|
||||
|
||||
@@ -0,0 +1,32 @@
|
||||
# FEAT-MO-001 实施前门禁基线
|
||||
|
||||
- 功能编号：FEAT-MO-001
|
||||
- 分支：`codex/feat-mo-001-tdx-overview`
|
||||
- 基线提交：`d283ee319692d4550149c591d4fe7f522c0bc6b8`
|
||||
- 记录时间：2026-08-18 13:04 CST
|
||||
|
||||
## Schema
|
||||
|
||||
- `pnpm schema:baseline`：通过，`v0.0.10 captured_empty`。
|
||||
- `pnpm schema:verify`：通过，`v0.0.10 captured_empty`。
|
||||
- 本次没有数据库结构变更，不读取生产数据库。
|
||||
|
||||
## GitNexus
|
||||
|
||||
```text
|
||||
Repository: /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis/.worktrees/feat-mo-001-tdx-overview
|
||||
Indexed commit: d283ee3
|
||||
Current commit: d283ee3
|
||||
Status: up-to-date
|
||||
```
|
||||
|
||||
影响分析结果：
|
||||
|
||||
- `ApiModule` upstream：LOW，直接消费者为 API `main.ts` 和进程冒烟测试。
|
||||
- `createAppRouter` upstream：LOW，无直接执行流消费者。
|
||||
- `createRequestClient` upstream：LOW，直接使用方为 Web API 健康请求模块。
|
||||
- `ApiModule.register` 复合名称未被 CLI 解析，已用 `ApiModule` 类上下文、`main.ts` 静态引用和 `register` 候选结果补齐证据；没有 HIGH/CRITICAL 结果。
|
||||
|
||||
## 工作区说明
|
||||
|
||||
主工作区已有用户修改的 `AGENTS.md`，本功能分支不将其纳入提交。功能代码只在本隔离工作区开发。
|
||||
@@ -1,8 +1,11 @@
|
||||
# 实施计划
|
||||
|
||||
1. 初始化 Vue 3、Vite、TypeScript和 Dart Sass。
|
||||
2. 建立市场快照类型和确定性模拟数据。
|
||||
3. 实现终端外壳、数据状态和结论区。
|
||||
4. 实现指数、宽度、量能、板块、情绪与资金模块。
|
||||
5. 实现分析偏好菜单和依据抽屉。
|
||||
6. 完成测试、构建、浏览器验证和视觉对比。
|
||||
1. ~~初始化 Vue 3、Vite、TypeScript 和 Dart Sass。~~ 已完成。
|
||||
2. ~~建立 TDX 配置、Node fetch 客户端、DTO、映射和五个模块接口。~~ 已完成。
|
||||
3. ~~实现终端外壳、分模块加载状态和结论区。~~ 已完成。
|
||||
4. ~~实现指数、宽度、板块和资金模块；不可用指标使用结构化状态。~~ 已完成。
|
||||
5. ~~实现分析偏好菜单和本地持久化。~~ 已完成；依据抽屉和详情页入口延期至独立功能。
|
||||
6. ~~完成单元测试、类型检查、构建、接口冒烟、浏览器桌面/移动端视觉验证。~~ 已完成。
|
||||
7. ~~补齐 TDX 市场宽度、一级行业板块和成交额趋势映射。~~ 已确认官方接口和本机桥接可用；主力净流入与盘中新闻保留为补充源需求。
|
||||
8. 更新 DTO、OpenAPI 类型和前端组件，使真实数据状态、单位和 `unchanged=null` 口径可见。
|
||||
9. 完成 TDX 真实响应夹具、错误隔离、类型、构建和浏览器视觉验证；Review 后再收口功能档案。
|
||||
|
||||
@@ -1,12 +1,12 @@
|
||||
id: FEAT-MO-001
|
||||
name: 市场综合概览
|
||||
slug: market-overview
|
||||
status: approved
|
||||
status: in_review
|
||||
owner: project
|
||||
created_at: 2026-08-12
|
||||
requirements: requirements.md
|
||||
prd: prd.md
|
||||
design: design.md
|
||||
implementation_plan: implementation-plan.md
|
||||
traceability_note: 开发尚未开始，GitNexus与QA证据将在开发门禁执行时创建
|
||||
traceability_note: 已完成 TDX 直连开发、GitNexus 前后分析、接口冒烟、桌面/移动端视觉验证、独立代码 Review 和规范 Review；开发完成门禁已通过，待合并发布
|
||||
release: unreleased
|
||||
|
||||
@@ -23,7 +23,7 @@
|
||||
## 非目标
|
||||
|
||||
- 不做自选股、持仓、笔记、交易计划、社区、荐股、跟单和公开组合。
|
||||
- 本切片不接正式行情源、RocketMQ、MySQL、Redis和付费 AI。
|
||||
- 本切片直接接入已验证的 TDX 只读桥接层；不接入 RocketMQ、MySQL、Redis 和付费 AI。
|
||||
- 本切片不实现用户、邀请、会员、订阅和支付。
|
||||
- ETF监控、两融数据、大盘云图和实时消息仍是独立一级模块。
|
||||
|
||||
@@ -41,7 +41,7 @@
|
||||
| 编号 | 优先级 | 需求 | 可观察结果 |
|
||||
|---|---|---|---|
|
||||
| FR-001 | P0 | 结论优先展示市场定性 | 首屏顶部出现一句结论、市场状态、量能状态和情绪状态 |
|
||||
| FR-002 | P0 | 展示驱动与风险 | 结论下方并列显示至少三条驱动和三条风险证据 |
|
||||
| FR-002 | P0 | 展示驱动与风险 | 结论下方并列显示已由 TDX 支持的驱动和风险证据；缺少口径时明确标记 |
|
||||
| FR-003 | P0 | 展示数据新鲜度 | 页面显示交易状态、数据更新时间和正常/延迟/不完整状态 |
|
||||
| FR-004 | P0 | 提供分析偏好 | 可选择综合/短线/中长线和规则/AI/混合/对照，并在本地保存默认值 |
|
||||
| FR-005 | P1 | 展示市场证据模块 | 指数、宽度、量能、板块、情绪和资金摘要可阅读 |
|
||||
@@ -50,10 +50,16 @@
|
||||
|
||||
## 数据与口径
|
||||
|
||||
首个切片使用确定性模拟快照。字段仍必须包含交易日期、快照时间、来源状态、完整性和单位，以便以后无结构变更地替换为后端 API。
|
||||
首个切片由 Nest API 直接读取 TDX 只读桥接层。指数和摘要使用真实 TDX K 线映射；市场宽度使用三市场指数快照，板块使用一级行业目录与日行情，量能使用三市场指数成交额汇总。主力净流入和盘中新闻不在本切片 TDX 主链路中，必须保持明确的补充源边界，不得用指数或离线样本冒充。所有响应仍包含交易日期、快照时间、来源状态、完整性和单位。
|
||||
|
||||
A 股使用红涨绿跌。成交额统一展示为亿元，比例明确使用百分比。历史数据和低频资金数据必须显示实际数据日期，旧数据不得标记为实时。
|
||||
|
||||
TDX 交易日期必须通过真实公历日期校验。成交额当前/前一日金额必须与同索引日期对齐，且前一交易日严格早于当前交易日；不满足条件的市场不参与汇总，也不得抢占最新日期截面。
|
||||
|
||||
指数和板块涨跌幅必须同时具备有效且严格递增的相邻日期。前一根日期非法、重复或晚于当前日期时，指数只展示当前价而不生成涨跌信号，板块不进入强弱排序。
|
||||
|
||||
首个切片不引入交易日历依赖：指数、一级行业和成交额的最新交易日期与 `Asia/Shanghai` 当前日历日期不同即标记 `delayed`；市场宽度快照缺少日期字段，使用同批核心指数日线作为日期参考。周末和法定休市日会保守显示延迟并同时展示实际交易日期，后续接入权威交易日历后再细化“最新交易日”语义。
|
||||
|
||||
## 状态与异常
|
||||
|
||||
- 交易中：显示分钟级更新时间。
|
||||
@@ -77,7 +83,7 @@ A 股使用红涨绿跌。成交额统一展示为亿元，比例明确使用百
|
||||
- Given 页面加载有效快照，When 用户进入市场概览，Then 结论、驱动、风险和更新时间在首屏可见。
|
||||
- Given 用户打开分析状态入口，When 切换周期或引擎，Then 页面状态立即更新且可选择设为默认。
|
||||
- Given 数据快照被标记为延迟，When 页面渲染，Then 最近有效值保留并明确显示延迟，不能显示“实时”。
|
||||
- Given 用户点击查看依据，When 抽屉打开，Then 能看到指标名称、数值、口径和更新时间。
|
||||
- Given 用户看到查看依据入口，When 后续依据抽屉功能立项，Then 能看到指标名称、数值、口径和更新时间；本切片只保留入口。
|
||||
|
||||
## 风险与依赖
|
||||
|
||||
@@ -92,3 +98,5 @@ A 股使用红涨绿跌。成交额统一展示为亿元，比例明确使用百
|
||||
## 变更记录
|
||||
|
||||
- 0.1：建立首版 PRD，补充结论优先、分析偏好和异常状态。
|
||||
- 0.2：根据 TDX 实连验证修正数据源、可用性边界和未接入基础设施范围。
|
||||
- 0.3：核对官方行情接口后确认市场宽度、一级行业板块和成交额趋势可由 TDX 直接提供；主力净流入与盘中新闻保留补充源边界。
|
||||
|
||||
@@ -0,0 +1,19 @@
|
||||
# FEAT-MO-001 测试结果
|
||||
|
||||
## 自动化结果
|
||||
|
||||
- 前端 Vitest：8 个文件、20 个测试通过。
|
||||
- 后端 Vitest：11 个文件、67 个测试通过；API 启动器 Node 测试 2/2 通过，Schema、治理、边界和部署门禁通过。
|
||||
- `pnpm verify:e2e`：桌面/移动端页面和健康契约共 4 个测试通过。
|
||||
- `pnpm typecheck`、`pnpm build`、`pnpm format:check`：通过。
|
||||
- ESLint：0 error，保留 35 条 Vue 风格 warning，不阻断门禁。
|
||||
|
||||
## 手工结果
|
||||
|
||||
- `GET /api/v1/market-overview/indices` 和 `summary` 返回真实 TDX `fresh` 快照。
|
||||
- TDX 隧道未监听时，五个模块均返回明确不可用状态，未伪造指标；切换到家庭 LAN 隧道后，`summary`、`indices`、`breadth`、`sectors`、`funds` 均返回 `source=tdx,status=fresh`。
|
||||
- 家庭 LAN 真实冒烟中，指数返回 3 项、板块返回 8 项、成交额覆盖 3 个市场且交易日期完整；未保存真实价格或成交额数值。
|
||||
- 修复日期对齐和延迟状态后再次通过家庭 LAN 真实冒烟，五个接口在当日数据下仍为 `fresh` 且无 warning。
|
||||
- 第三轮 Review 修复后，非法月份/日期、倒序日期对和日期/金额数组错位均被映射层排除；服务测试统一冻结时钟，不依赖执行当天。
|
||||
- 第四轮 Review 修复后，指数前一根非法、重复或倒序日期不再生成涨跌幅，板块对应记录不进入强弱排序。
|
||||
- 桌面默认视口与 390px 移动视口无横向溢出；视角和引擎切换可用。
|
||||
@@ -0,0 +1,20 @@
|
||||
# FEAT-MO-001 视觉 QA
|
||||
|
||||
## 验证范围
|
||||
|
||||
- 桌面默认视口：顶部应用识别、结论区、驱动/风险、核心指数和不可用模块均可见。
|
||||
- 移动视口：390×844，首屏按单列排列，标题、状态、指数和模块说明不遮挡。
|
||||
|
||||
## 结果
|
||||
|
||||
- 通过：2026-08-18 使用本地 API/Web 实际页面复验；桌面视口为 `1440×900`，移动视口为 `390×844`。
|
||||
- 通过：桌面 `clientWidth=1440, scrollWidth=1440`，移动端 `clientWidth=390, scrollWidth=390`；移动端六个主要区块左右边界均位于 `14px~376px`，未发生页面级或区块级横向溢出。
|
||||
- 通过：综合、短线、中长线切换和规则/AI/混合/对照选择有可见状态。
|
||||
- 通过：实际切换到“综合”和“混合”后，按钮激活态和下拉选中项同步更新。
|
||||
- 通过：家庭 LAN 隧道 `127.0.0.1:17710` 下完成真实 TDX 行情复验；摘要、3 个核心指数、市场宽度、8 个一级行业板块和 3 市成交额均显示 `source=tdx`、`status=fresh`，无模块警告。
|
||||
- 通过：桌面与移动端浏览器控制台均无 `warning` 或 `error`；移动端仅有 Vite 开发服务器连接调试信息。
|
||||
- 通过：真实行情移动端 `clientWidth=390, scrollWidth=390`，无页面级横向溢出、内部文字截断或控件重叠；长风险说明、指数数值、板块标签和成交额均完整展示。
|
||||
|
||||
## 残余项
|
||||
|
||||
依据抽屉、指数/板块详情页和真实图表尚未立项，不作为本次首屏视觉验收项。真实 TDX 接口值、交易日期和模块状态的逐项证据见 `tdx-smoke-report.md`；本次视觉复验使用同一家庭 LAN 隧道和真实接口响应，不使用离线样本伪装实时行情。
|
||||
@@ -0,0 +1,17 @@
|
||||
# FEAT-MO-001 发布说明
|
||||
|
||||
## 本次发布
|
||||
|
||||
- 新增 TDX 直连的市场概览首屏和五个模块 API。
|
||||
- 支持综合、短线、中长线视角与规则、AI、混合、对照偏好选择。
|
||||
- 市场宽度、一级行业强弱和成交额趋势接入真实 TDX 数据，并对空数据、部分数据、日期不一致和延迟状态显示明确边界。
|
||||
- 指数和板块按最新交易日截面对齐，成交额按最新有效交易日期对汇总；后端根据上海当前日历日期实际生成 `delayed`，市场宽度使用同批核心指数日期参考。
|
||||
- 拒绝非法公历日期、倒序交易日期以及日期/金额数组错位的 TDX 数据，避免异常市场抢占最新截面或产生时间倒置的成交额趋势。
|
||||
- 指数和板块仅使用有效且严格递增的相邻 K 线日期计算涨跌，前一日期非法、重复或倒序时不生成市场强弱信号。
|
||||
- 明确显示 TDX 来源、快照时间、交易日期、市场覆盖数和模块级错误。
|
||||
|
||||
## 明确不包含
|
||||
|
||||
- 不启用 MySQL、Redis、RocketMQ 或 AI 运行链路。
|
||||
- 不包含用户体系、详情页、依据抽屉、交易操作和荐股能力。
|
||||
- 不包含主力净流入、盘中新闻、真实图表和详情页；这些能力需另立补充数据源和功能需求。
|
||||
@@ -2,4 +2,12 @@
|
||||
|
||||
首屏为“市场概览”模块中的综合概览，采用结论优先。市场概览内部通过轻量分析状态入口切换综合、短线和中长线视角，并支持规则、AI、混合与对照分析。
|
||||
|
||||
当前切片仅开发 Vue 3 可交互首屏和本地模拟数据，不接用户体系和正式数据链路。
|
||||
当前切片开发 Vue 3 可交互首屏，Nest API 通过 TDX 只读桥接层提供真实指数、市场宽度、板块和成交额趋势；主力净流入与盘中新闻不作为本次 TDX 主链路指标，不使用离线样本。不接用户体系，也不启用 MySQL、Redis、RocketMQ 或 AI 运行链路。
|
||||
|
||||
## 本次实际范围
|
||||
|
||||
- 已完成综合、短线、中长线视角切换，以及规则、AI、混合、对照偏好选择；偏好只保存于浏览器本地。
|
||||
- 已完成按摘要、指数、宽度、板块、资金拆分的五个 HTTP 接口和前端 API 封装。
|
||||
- 已完成 TDX 请求超时、响应大小限制、错误脱敏和模块级失败隔离。
|
||||
- 已确认并接入 TDX 市场宽度、一级行业板块和成交额趋势；资金模块明确不等同于主力净流入，`unchanged` 无可靠总数时返回 `null`。
|
||||
- 详情页和“查看依据”抽屉只保留入口，另立需求实现，不在本次发布范围内。
|
||||
|
||||
@@ -0,0 +1,86 @@
|
||||
# 代码 Review
|
||||
|
||||
## 首轮独立 Review
|
||||
|
||||
- 对比基线：`8261948`
|
||||
- 审查提交：`ff8ada8`
|
||||
- 结论：`Ready to merge: No`
|
||||
|
||||
首轮发现及处置：
|
||||
|
||||
1. 畸形 `UpHome/DownHome` 被折算为零并误标 `fresh`：改为有限、非负且成对校验，无效市场整体排除并按有效市场数返回 `fresh/partial/unavailable`。
|
||||
2. 成交额缺市场或交易日错位仍误标三市实时数据：只汇总非负金额和一致交易日，公开 `marketCount`、`tradeDate`、`previousTradeDate`，缺市场返回 `partial`。
|
||||
3. 空板块目录误标 `fresh`：一级行业为空时直接返回 `unavailable`，且只保留存在相邻两日收盘价和有效涨跌幅的板块。
|
||||
4. 前端隐藏 `partial/delayed` 警告：宽度、板块和成交额面板均展示非 `fresh` 状态提示，并展示板块与成交额真实交易日期。
|
||||
5. PRD、发布说明和 Review 文档残留旧口径：已同步更正为真实 TDX 宽度、一级行业与成交额趋势口径，主力净流入和新闻仍明确延期。
|
||||
6. 异常分支测试不足：新增畸形宽度、部分市场、错位交易日、空行业目录、额外字段隔离、前端状态提示和零变化中性色回归测试。
|
||||
|
||||
次要问题也已同步处理：OpenAPI `required + nullable` 定义、板块 DTO 额外 `price` 字段泄露、成交额零变化上涨色和新增映射中文口径注释。
|
||||
|
||||
## 范围
|
||||
|
||||
覆盖 TDX 客户端、市场概览后端模块、OpenAPI/前端契约、Axios API 封装、Vue 首屏组件和对应测试。
|
||||
|
||||
## 检查结果
|
||||
|
||||
- 通过：API 按模块拆分，前端请求集中在 `web/src/api/market-overview/index.ts`，Vue 不直连 TDX。
|
||||
- 通过：真实指数和摘要字段经过 DTO/映射；桥接层未提供的方法返回结构化 `unavailable`，没有模拟数据冒充。
|
||||
- 通过：模块并行加载且独立处理异常；TDX 请求有固定回环地址、超时、响应大小限制和错误脱敏。
|
||||
- 通过：未将密码、令牌、行情原始载荷或生产数据写入代码、文档和日志。
|
||||
- 通过：E2E 测试夹具显式声明回环 TDX 配置但不要求 TDX 可达，避免测试环境绕过正式配置校验。
|
||||
|
||||
## 安全与残余风险
|
||||
|
||||
- TDX 只读边界固定为回环地址，客户端限制超时和响应大小并脱敏异常；未接入交易、AI 密钥、数据库写入或生产数据。
|
||||
- 残余风险是 TDX 桥接方法覆盖不全、市场数据授权和生产 7×24 稳定性尚未验证，已在需求和回退说明中标明。
|
||||
|
||||
## GitNexus 与同步修改
|
||||
|
||||
开发前已保存 GitNexus 影响计划。早期提交曾映射 11 条执行流并标记 high；`49f6be9` 修复提交的 staged 检测映射 20 个文件、67 个符号、16 条执行流并标记 critical。critical 来自市场概览核心服务、TDX 映射和前端数据面板，不是未知跨业务扩散；未发现数据库、Redis、RocketMQ、Scheduler、Worker、认证或部署调用方。当前环境未暴露 GitNexus MCP 变更检测工具，已使用同版本 CLI 和 worktree 绝对路径保留证据。
|
||||
|
||||
## 性能与资源影响
|
||||
|
||||
- 五个模块并行请求，单请求超时并限制 1 MiB 响应；市场宽度并行增加一次单指数、单日线日期参考请求，不引入 MySQL、Redis、RocketMQ 在线负载。
|
||||
- 未进行 7×24、断线重连和生产压测；主力净流入、盘中新闻、权威交易日历及详情页仍待独立功能。
|
||||
- ESLint 对 Vue 单文件组件仅保留 35 条既有风格 warning，无 error；格式、类型和构建门禁均通过。
|
||||
|
||||
## 二次独立 Review
|
||||
|
||||
- 审查范围：`ff8ada8..49f6be9`
|
||||
- 结论：`Ready to merge: No`
|
||||
- Critical：无。
|
||||
- Important：宽度仍接受小数/十六进制等非计数值；成交额以首个市场日期为锚；板块跨交易日混排仍标 `fresh`；后端没有真实 `delayed` 路径。
|
||||
- Minor：GitNexus 风险/执行流和 TDX 已接入范围存在旧口径。
|
||||
|
||||
上述问题已按 TDD 增加失败用例后修复：宽度只接受十进制非负安全整数；指数/板块只保留最新交易日；成交额选择最新有效日期对；四个后端日行情路径均具备 `delayed` 判定，宽度使用同批指数日期参考。修复后等待再次独立 Review。
|
||||
|
||||
## 第三轮独立 Review
|
||||
|
||||
- 审查范围：`49f6be9..7e4dcd9`
|
||||
- 结论：`Ready to merge: No`
|
||||
- Critical：无。
|
||||
- Important：8 位数字日期未验证真实公历语义，成交额未强制前一交易日早于当前日且未验证日期/金额数组对齐；服务测试固定使用 `20260818` 行情却没有统一冻结系统时间，会在自然日期变化后失败。
|
||||
- Minor：开发总结未包含 `7e4dcd9`，GitNexus 仍保留上一轮 16 条执行流口径。
|
||||
|
||||
处置：按 TDD 先得到 3 个预期失败，再增加真实公历日期、日期顺序和数组对齐校验；服务测试套件统一冻结上海日期，并由单个延迟用例显式切换。修复后后端 Vitest `63/63`、启动器 `2/2` 和类型检查通过，等待再次独立 Review。
|
||||
|
||||
## 第四轮独立 Review
|
||||
|
||||
- 审查范围：`49f6be9..ae2a7e0`
|
||||
- 结论：`Ready to merge: No`
|
||||
- Critical：无。
|
||||
- Important：指数和板块只校验当前 K 线日期，前一根日期非法、重复或倒序时仍计算涨跌；最终治理材料仍处于 `pending`，尚未执行 `governance:finish`。
|
||||
- Minor：无新增。
|
||||
|
||||
处置：按 TDD 先得到 4 个预期失败，再要求前一日期有效且严格早于当前日期；无可比前收盘时指数保留当前价但不生成涨跌，板块不进入强弱排序。后端 Vitest 增加至 `67/67`。治理状态保持 `pending` 是有意的门禁顺序：需本修复再次独立 Review 通过后，才能合法写入 `passed` 并运行 `governance:finish`。
|
||||
|
||||
## 第五轮最终独立 Review
|
||||
|
||||
- 审查范围：`ae2a7e0..c2fdfa6`
|
||||
- 结论：`Ready to merge: Yes`
|
||||
- Critical：无。
|
||||
- Important：无；上一轮指数/板块前一根 K 线日期校验问题已关闭。
|
||||
- Minor：无。
|
||||
- 验证：指数非法、重复、倒序前一日期参数化用例和板块过滤用例齐全；后端 Vitest `67/67`、启动器 `2/2`、服务端类型检查与 `git diff --check` 均通过。安全、性能及 PRD/设计/测试/QA 口径一致。
|
||||
|
||||
最终结论：passed
|
||||
@@ -0,0 +1,29 @@
|
||||
# 开发规范符合性 Review
|
||||
|
||||
## 安全、性能与架构检查
|
||||
|
||||
- 已建立并更新 PRD、需求、设计、实施计划、测试计划、开发总结和 Review 文档。
|
||||
- 已记录安全策略、性能目标、GitNexus 影响、验证证据、范围变化和残余风险。
|
||||
- 后端按业务模块组织并使用 DTO/映射；前端请求通过统一 Axios 封装，业务 API 独立存放。
|
||||
- 代码注释集中在配置边界、异常恢复和偏好存储等非显然逻辑，没有逐行噪声注释。
|
||||
- 未启用 MySQL、Redis、RocketMQ；本切片没有伪造基础设施已接入，也没有触碰生产数据库。
|
||||
- Git 提交和推送将在 Review 通过后按中文 Conventional Commit 执行；不修改 Git 全局配置。
|
||||
|
||||
## GitNexus 与开发总结检查
|
||||
|
||||
- 开发前影响计划、开发后索引、变更检测和风险处置已归档。
|
||||
- 开发总结记录原始需求、范围变化、实际完成、修复缺陷、延期项、提交和验证证据。
|
||||
- QA、发布说明和回退说明与本功能档案保持同一功能编号。
|
||||
|
||||
## 首轮问题同步检查
|
||||
|
||||
- 数据完整性、状态语义、OpenAPI nullable、DTO 输出边界和前端降级提示均已补齐回归测试。
|
||||
- PRD、发布说明、测试计划和开发总结已同步实际口径，避免实现与文档分叉。
|
||||
- 浏览器复验覆盖桌面与 `390×844` 移动视口；当前 TDX 隧道未监听时只确认结构化降级，历史真实行情冒烟证据保持独立。
|
||||
- 二次独立 Review 发现的严格整数、日期对齐和真实 `delayed` 语义已按 TDD 修复；后端新增 9 个断言并完成家庭 LAN 当日行情复验。
|
||||
- 新鲜度暂按上海当前日历日期保守判断，周末和法定休市日可能显示 `delayed`；该残余边界已同步 PRD、设计和测试计划，不伪装成交易日历已接入。
|
||||
- 第三轮 Review 的日期真实性、先后顺序、数组对齐和测试时钟问题已按 TDD 修复；需求、设计、测试计划、测试结果、发布说明和开发总结已同步。
|
||||
- 第四轮 Review 的前一根日期校验问题已按 TDD 修复；治理结论继续保持 `pending`，等待本次代码修复再次独立确认。
|
||||
- 第五轮最终独立 Review 无 Critical、Important 或 Minor 问题并给出 `Ready to merge: Yes`；中文提交、Gitea 推送、GitNexus、完整门禁和视觉证据均已复核。
|
||||
|
||||
最终结论：passed
|
||||
@@ -0,0 +1,17 @@
|
||||
# FEAT-MO-001 回退说明
|
||||
|
||||
## 触发条件
|
||||
|
||||
- TDX 请求错误导致核心指数无法展示或页面加载阻断。
|
||||
- 发现前端横向溢出、来源状态误标为实时，或不可用指标被伪造。
|
||||
- 生产部署验证发现配置边界、权限或错误脱敏回归。
|
||||
|
||||
## 操作
|
||||
|
||||
1. 停止当前 API/Web systemd 服务，保留日志和失败快照摘要，不保存原始行情载荷。
|
||||
2. 回退到上一个已推送的 Gitea 提交/标签，重新执行源码构建和 `pnpm verify:source`。
|
||||
3. 恢复 TDX 桥接隧道后只做只读接口冒烟；确认通过前不得重新对外开放。
|
||||
|
||||
## 数据边界
|
||||
|
||||
本功能没有写入 MySQL、Redis 或 RocketMQ，也没有数据库迁移；回退不执行生产数据库操作。开发 Schema 继续遵循仅读取开发库的门禁。
|
||||
@@ -0,0 +1,34 @@
|
||||
# FEAT-MO-001 TDX 只读冒烟报告
|
||||
|
||||
- 验证时间：2026-08-18 17:21 CST
|
||||
- 网络场景：本机回环桥接（TDX 服务可达）
|
||||
- 本机业务入口：`127.0.0.1:17710`
|
||||
- API 入口：`127.0.0.1:3000/api/v1/market-overview`
|
||||
- 请求方式：HTTP GET（业务 API）及桥接层 HTTP POST JSON
|
||||
- 请求类型：市场宽度、一级行业板块、成交额趋势只读请求
|
||||
- 原始载荷：未保存
|
||||
|
||||
## 结果
|
||||
|
||||
- 三条业务接口均返回 HTTP `200`，响应状态均为 `fresh`，`source` 均为 `tdx`。
|
||||
- `/breadth`：成功汇总上证、深证和北证指数快照中的 `UpHome`、`DownHome`；`unchanged` 返回 `null`，未进行总数推算。
|
||||
- `/sectors`：成功读取一级行业目录并批量获取日行情，按涨跌幅排序返回前 8 项。
|
||||
- `/funds`：成功汇总三个交易所指数日行情 `Amount`，按万元转换为亿元并计算较前一交易日变化；该指标展示为“成交额趋势”，不宣称主力净流入。
|
||||
- 端到端耗时：市场宽度约 `0.11s`，一级行业约 `0.27s`，成交额趋势约 `0.12s`（单次本机冒烟，不代表生产 SLA）。
|
||||
- 未调用交易、账户、自选、写入接口；未保存真实行情原始载荷。
|
||||
|
||||
## 家庭 LAN 二次复验
|
||||
|
||||
- 验证时间：2026-08-18 19:35 CST。
|
||||
- 先按开发手册切换到家庭 LAN SSH 别名，确认本机 `127.0.0.1:17710` 的监听者为本次 SSH 隧道；平台配置仍只使用回环地址。
|
||||
- 桥接层最小只读 HTTP POST 成功，没有调用交易、账户、自选或写入方法。
|
||||
- Nest API 的 `/summary`、`/indices`、`/breadth`、`/sectors`、`/funds` 均返回 HTTP `200`、`source=tdx`、`status=fresh` 且无 warning。
|
||||
- `/indices` 返回 3 项，`/sectors` 返回 8 项；`/breadth` 返回有限且非负的涨跌家数；`/funds` 返回 `marketCount=3`，当前和上一交易日期均存在且不同。
|
||||
- 本次只记录结构、状态、数量和日期完整性，不记录真实价格、成交额数值、家庭网络地址、SSH 用户或原始响应。
|
||||
- 完成严格整数、最新交易日截面和后端 `delayed` 修复后再次复验：五个接口在当日行情下仍为 `fresh` 且无 warning，证明新增新鲜度判断未误伤当前日期数据。
|
||||
|
||||
## 脱敏与限制
|
||||
|
||||
- 报告不保存真实价格、成交量、家庭网络地址、Tailscale 地址、SSH 用户、密钥或完整响应。
|
||||
- 本报告只证明当前开发机到 TDX 的只读接口和本次映射可达，不证明 7×24 生产采集、商业再分发授权、主力净流入口径或盘中新闻接口已经可用。
|
||||
- 主力净流入和盘中新闻继续保留为补充数据源需求；后续接入必须单独记录来源、权限、口径和数据质量。
|
||||
@@ -3,6 +3,36 @@
|
||||
- 结论、驱动和风险在首屏可见。
|
||||
- 分析状态可以临时切换并保存默认值。
|
||||
- 依据抽屉能够打开和关闭。
|
||||
- 时间范围切换更新图表。
|
||||
- 五个模块并行请求，一个模块失败不阻断其他模块。
|
||||
- 真实 TDX 指数、市场宽度、一级行业板块和成交额趋势响应可映射；主力净流入与盘中新闻不以占位值伪造。
|
||||
- 加载、部分数据、过期和错误状态具有明确文案。
|
||||
- 桌面和窄窗口不出现阻断核心内容的溢出。
|
||||
|
||||
## 已执行证据
|
||||
|
||||
- 前端 Vitest、typecheck、build：通过。
|
||||
- 后端 TDX 客户端、映射、服务、HTTP/OpenAPI 测试：通过。
|
||||
- `curl` 冒烟：`/breadth`、`/sectors`、`/funds` 均返回 `source=tdx,status=fresh`；分别验证 `UpHome/DownHome` 汇总、一级行业排序和成交额单位转换。
|
||||
- 异常映射：覆盖畸形涨跌家数字段（小数、指数、十六进制和超出安全整数）、当前及前一根非法公历日期、相邻日期重复/倒序、空一级行业目录、单根板块 K 线、指数/板块混合交易日、成交额缺市场/交易日倒序/日期金额数组错位/负数/首市场落后，以及三市完整性状态。
|
||||
- 后端状态：覆盖指数、市场宽度、一级行业和成交额旧交易日期的真实 `delayed` 分支；休市日保守延迟属于已记录边界。
|
||||
- 测试时钟：市场概览服务套件统一冻结到上海 `2026-08-18`，单个 `delayed` 用例显式切换目标日期并在用例后恢复，保证测试不会随自然日期变化。
|
||||
- 前端状态：覆盖宽度、板块和成交额模块的 `partial`/`delayed` 警告、真实交易日期和成交额零变化中性色。
|
||||
- 浏览器验证：桌面默认视口和 390px 移动视口无横向溢出；综合/短线切换和分析引擎选择可用。
|
||||
|
||||
## 安全、性能与残余风险
|
||||
|
||||
- 安全：TDX 地址固定为本机回环桥接端口；请求超时、响应 1 MiB 上限、错误脱敏；只读行情，不接受用户输入拼接请求。
|
||||
- 性能：五个模块并行请求，单次 TDX 请求受超时保护；本切片不引入数据库、缓存或消息负载，未进行持续压测。
|
||||
- 残余风险：主力净流入字段当前桥接实测为零值，需权限和口径专项验证；盘中新闻仍需补充源；详情页、依据抽屉和 AI 运行时需另立功能；市场数据授权和生产 7×24 稳定性未由本地冒烟证明。
|
||||
|
||||
## 安全验证
|
||||
|
||||
- 验证 TDX 只能使用回环地址和固定端口，错误响应不包含原始 URL、请求体或凭据。
|
||||
- 验证前端只能通过统一 Axios API 文件访问后端，边界测试拒绝页面直连 Axios/fetch 和 Server 内部依赖。
|
||||
- 验证 E2E 夹具使用无秘密的生产测试环境变量，不读取仓库内本地凭据或生产配置。
|
||||
|
||||
## 性能验证
|
||||
|
||||
- 验证五个模块并发加载、单模块失败隔离和请求超时行为。
|
||||
- 验证响应体 1 MiB 上限和构建产物体积；浏览器桌面/移动端无横向溢出。
|
||||
- 7×24 运行、峰值并发、TDX 断线重连和消息/缓存压力测试不适用于当前只读首屏，已列为后续采集与生产功能边界。
|
||||
|
||||
@@ -35,6 +35,7 @@
|
||||
|
||||
- `06466f3`、`8e954a3`、`54fd928`、`7e9d906`、`dc8ad7d`
|
||||
- `c11de09`、`3d12c83`、`874796a`、`afd186c`、`f1c412b`
|
||||
- `58026ae`、`16bde94`、`11edeb0`
|
||||
|
||||
## 验证证据
|
||||
|
||||
@@ -42,3 +43,4 @@
|
||||
- `npm run test:environment-baseline`：10/10；contracts：3/3；boundaries：16/16；deployment：6/6。
|
||||
- `pnpm lint`、`pnpm typecheck`、Prettier、`npm run schema:verify` 均通过。
|
||||
- 真实 development MySQL 5.7.42 连接成功，`a_share_analysis_dev` 五类对象均为 0，v0.0.9 manifest 已提交并推送。
|
||||
- 发布 `v0.0.10` 标签已推送；发布后 `v0.0.10` `captured_empty` manifest 已按标签提交校验并推送 `main`。
|
||||
|
||||
@@ -3,14 +3,14 @@
|
||||
- 功能编号：GOV-012
|
||||
- 记录时间：2026年08月18日 CST
|
||||
- 分支：`codex/gov-012-node-schema-exporter`
|
||||
- 当前提交：`f1c412b`
|
||||
- 当前提交：`11edeb0`
|
||||
|
||||
## GitNexus 状态
|
||||
|
||||
```text
|
||||
Indexed commit: f1c412b
|
||||
Nodes: 2,383
|
||||
Edges: 3,234
|
||||
Nodes: 2,431
|
||||
Edges: 3,282
|
||||
Clusters: 54
|
||||
Flows: 63
|
||||
MCP: Transport closed（按 CLI 与静态证据降级）
|
||||
@@ -21,3 +21,4 @@ MCP: Transport closed（按 CLI 与静态证据降级）
|
||||
- 运行时只影响 Schema 治理工具、测试、治理文档和 `v0.0.9` 开发基线。
|
||||
- HTTP/OpenAPI、Web API、消息契约、Redis、API、Scheduler、Worker 和部署入口没有代码变更。
|
||||
- MySQL 连接仅命中用户确认的 development 配置和 `a_share_analysis_dev`；没有生产数据库访问。
|
||||
- `v0.0.10` 标签指向发布提交 `16bde94`，发布后基线提交为 `11edeb0`；两份基线均已推送 Gitea `main`。
|
||||
|
||||
@@ -2,8 +2,8 @@
|
||||
|
||||
| 项目 | 开发前 | 开发后 | 判断 |
|
||||
| --- | --- | --- | --- |
|
||||
| Git 提交 | `3555b7c` | `f1c412b` | GOV-012 独立分支完成实现和文档提交 |
|
||||
| 索引规模 | 2,112 nodes / 2,790 edges / 50 flows | 2,383 nodes / 3,234 edges / 63 flows | 仅新增导出器、测试和文档相关符号 |
|
||||
| Git 提交 | `3555b7c` | `11edeb0` | GOV-012 实现、发布和 v0.0.10 基线均已提交 |
|
||||
| 索引规模 | 2,112 nodes / 2,790 edges / 50 flows | 2,431 nodes / 3,282 edges / 63 flows | 仅新增导出器、测试、文档和基线清单相关符号 |
|
||||
| MCP | `Transport closed` | `Transport closed` | 使用 CLI、静态引用和回归测试降级核对 |
|
||||
| 数据库范围 | 缺失 `v0.0.9` 基线 | `a_share_analysis_dev`，`captured_empty` | 开发门禁恢复 |
|
||||
| 数据库范围 | 缺失 `v0.0.9` 基线 | `a_share_analysis_dev`，v0.0.9/v0.0.10 均 `captured_empty` | 开发与发布后门禁均恢复 |
|
||||
| 跨模块变更 | 待分析 | 无 HTTP/OpenAPI、消息、Redis、运行时服务变更 | 符合影响计划 |
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
id: GOV-012
|
||||
name: 纯 Node.js 开发库 Schema 导出器
|
||||
slug: node-schema-exporter
|
||||
status: approved
|
||||
status: released
|
||||
owner: project
|
||||
created_at: 2026-08-18
|
||||
requirements: requirements.md
|
||||
@@ -9,4 +9,4 @@ prd: prd.md
|
||||
design: design.md
|
||||
implementation_plan: implementation-plan.md
|
||||
traceability_note: 设计已确认；实施计划需在用户复核书面规格后创建
|
||||
release: unreleased
|
||||
release: v0.0.10
|
||||
|
||||
@@ -15,3 +15,8 @@
|
||||
- 先在 `main` 完成代码 Review、规范 Review、`governance:finish` 和全量验证。
|
||||
- 创建并推送 `v0.0.10` 标签，再独立生成并推送 `database/schema-baselines/v0.0.10/manifest.yaml`。
|
||||
- 发布失败时按 `rollback.md` 回退代码提交，禁止删除或覆盖 v0.0.9 基线。
|
||||
|
||||
## 发布结果
|
||||
|
||||
- `v0.0.10` 标签指向 `16bde94`，已单独推送 Gitea。
|
||||
- 发布后 `v0.0.10` Schema 基线提交为 `11edeb0`，状态为 `captured_empty`，已推送 `main`。
|
||||
|
||||
@@ -0,0 +1,488 @@
|
||||
# 市场综合概览 TDX 直连实施计划
|
||||
|
||||
> **For agentic workers:** REQUIRED SUB-SKILL: Use `superpowers:executing-plans` to implement this plan task-by-task with review checkpoints.
|
||||
|
||||
**Goal:** 使用 Nest API 直接读取本机 TDX 隧道，在 Vue 3 首页提供可独立降级的市场综合概览。
|
||||
|
||||
**Architecture:** API 服务通过固定的 `127.0.0.1:17710` TDX HTTP 客户端读取只读行情，将 TDX 原始字段映射为版本化市场概览 DTO。首页按摘要、指数、宽度、板块和资金拆分请求，通过 Axios API 文件消费 Nest 接口；浏览器不直接连接 TDX。
|
||||
|
||||
**Tech Stack:** Vue 3、Vue Router、Pinia、Naive UI、Dart Sass、NestJS 11、TypeScript 5.9、Node.js 22.x 内置 `fetch`、OpenAPI/Swagger、Vitest、Playwright。
|
||||
|
||||
## Global Constraints
|
||||
|
||||
- Node 使用 `22.x`，MySQL 兼容 `5.7.x`，字符集排序规则为 `utf8mb4_general_ci`。
|
||||
- TDX 只读访问固定到服务端 `http://127.0.0.1:17710/`，不得由请求参数传入任意 URL。
|
||||
- TDX 不可用时显示 `unavailable`，不得使用离线样本或伪造实时行情回退。
|
||||
- 前端业务请求只能位于 `web/src/api/<业务域>/index.ts`，统一调用 `web/src/utils/request.ts` 的 Axios 封装。
|
||||
- 业务代码必须提供准确中文注释；不以原子化为目的过度拆分文件。
|
||||
- 本功能不启用 MySQL、Redis、RocketMQ、AI、用户体系、交易指令或公网采集链路。
|
||||
- 不提交 SSH 地址、Tailscale 地址、密钥、密码、`.env`、真实原始 TDX 载荷或生产数据。
|
||||
- 修改符号前必须完成 GitNexus 影响分析；提交前必须执行 GitNexus 变更检测。
|
||||
- 每个提交使用中文 Conventional Commit，并立即推送当前分支到项目 Gitea。
|
||||
|
||||
## 文件地图
|
||||
|
||||
### 后端
|
||||
|
||||
- Modify: `server/libs/config/src/runtime-config.ts`，增加 API 专属 TDX 地址和超时配置及严格校验。
|
||||
- Modify: `deploy/env/development/api.env.example`，增加不含凭据的 `TDX_BASE_URL` 与 `TDX_TIMEOUT_MS` 模板。
|
||||
- Create: `server/apps/api/src/market-overview/tdx/tdx.types.ts`，记录已验证的 TDX 请求、响应和错误类型。
|
||||
- Create: `server/apps/api/src/market-overview/tdx/tdx.client.ts`，封装固定地址、超时、响应大小和脱敏错误。
|
||||
- Create: `server/apps/api/src/market-overview/tdx/tdx.mapper.ts`，转换 TDX 字段和数据口径。
|
||||
- Create: `server/apps/api/src/market-overview/market-overview.dto.ts`，定义 OpenAPI/HTTP 响应 DTO。
|
||||
- Create: `server/apps/api/src/market-overview/market-overview.service.ts`，并行获取模块数据并生成统一快照元数据。
|
||||
- Create: `server/apps/api/src/market-overview/market-overview.controller.ts`，提供五个只读接口。
|
||||
- Create: `server/apps/api/src/market-overview/market-overview.module.ts`，装配 TDX 客户端、服务和控制器。
|
||||
- Modify: `server/apps/api/src/api.module.ts`，注册市场概览模块并注入 API 配置。
|
||||
- Modify: `server/tools/export-openapi.ts`，让 OpenAPI 生成器包含市场概览控制器及其测试替身。
|
||||
- Modify: `server/openapi/openapi.json`，提交生成后的契约。
|
||||
- Create: `server/apps/api/src/market-overview/tdx/tdx.client.test.ts`，测试 TDX 请求、超时、网络错误和响应上限。
|
||||
- Create: `server/apps/api/src/market-overview/tdx/tdx.mapper.test.ts`，测试字段映射、单位和缺失字段。
|
||||
- Create: `server/apps/api/src/market-overview/market-overview.service.test.ts`，测试并行接口、快照时间和模块级降级。
|
||||
- Create: `server/apps/api/test/market-overview.e2e-spec.ts`，测试 HTTP 状态、响应结构和错误映射。
|
||||
|
||||
### 前端
|
||||
|
||||
- Modify: `web/src/api/generated/schema.ts`，由 OpenAPI 生成命令更新。
|
||||
- Create: `web/src/types/market-overview.ts`，定义页面消费的类型别名和显示状态。
|
||||
- Create: `web/src/api/market-overview/index.ts`，集中封装五个 Axios 请求。
|
||||
- Create: `web/src/views/market-overview/useMarketOverview.ts`，管理并行加载、刷新、模块状态和分析偏好本地存储。
|
||||
- Create: `web/src/views/market-overview/MarketOverviewPage.vue`，组织首屏布局和页面级状态。
|
||||
- Create: `web/src/views/market-overview/components/MarketConclusion.vue`，显示结论、交易状态、更新时间和来源。
|
||||
- Create: `web/src/views/market-overview/components/MarketDrivers.vue`，显示驱动与风险证据。
|
||||
- Create: `web/src/views/market-overview/components/IndexOverview.vue`，显示可点击核心指数。
|
||||
- Create: `web/src/views/market-overview/components/MarketBreadth.vue`，显示涨跌分布、宽度和量能。
|
||||
- Create: `web/src/views/market-overview/components/SectorOverview.vue`，显示可点击板块排行。
|
||||
- Create: `web/src/views/market-overview/components/FundTrend.vue`，显示资金趋势和不可用状态。
|
||||
- Modify: `web/src/app/router.ts`，将 `/` 指向市场概览页面。
|
||||
- Modify: `web/src/app/App.vue` 与 `web/src/styles/index.scss`，更新应用壳和响应式页面基础样式。
|
||||
- Create: `web/src/api/market-overview/index.test.ts`，测试 API 路径、方法、参数和错误脱敏。
|
||||
- Create: `web/src/views/market-overview/useMarketOverview.test.ts`，测试并行加载、刷新和偏好保存。
|
||||
- Modify: `web/src/app/App.test.ts`，改为验证市场概览首屏语义和状态入口。
|
||||
- Modify: `web/tests/smoke.spec.ts`，增加桌面、窄屏、模块降级和无水平溢出验证。
|
||||
|
||||
### 功能档案
|
||||
|
||||
- Modify: `docs/features/FEAT-MO-001-market-overview/requirements.md`，同步 TDX 直连和分模块接口范围。
|
||||
- Modify: `docs/features/FEAT-MO-001-market-overview/design.md`，链接本设计并移除旧的样本默认表述。
|
||||
- Modify: `docs/features/FEAT-MO-001-market-overview/implementation-plan.md`，更新为已执行任务索引。
|
||||
- Modify: `docs/features/FEAT-MO-001-market-overview/test-plan.md`，加入 TDX 联调、模块降级、安全和性能证据。
|
||||
- Create: `docs/features/FEAT-MO-001-market-overview/development-summary.md`，记录原始需求、实际完成、缺陷、延期项、提交和验证证据。
|
||||
- Create: `docs/features/FEAT-MO-001-market-overview/review/code-review.md`，记录代码 Review 结论和残余风险。
|
||||
- Create: `docs/features/FEAT-MO-001-market-overview/review/standards-review.md`，记录开发规范符合性 Review。
|
||||
- Create: `docs/features/FEAT-MO-001-market-overview/tdx-smoke-report.md`，只保存脱敏的真实 TDX 字段完整性、耗时和错误分类。
|
||||
|
||||
---
|
||||
|
||||
### Task 1: 开发门禁、工作区和 TDX 协议基线
|
||||
|
||||
**Files:**
|
||||
- Modify: `docs/features/FEAT-MO-001-market-overview/gitnexus/impact-plan.md`
|
||||
- Create: `docs/features/FEAT-MO-001-market-overview/gitnexus/implementation-baseline.md`
|
||||
- Create: `docs/features/FEAT-MO-001-market-overview/tdx-smoke-report.md`
|
||||
|
||||
**Interfaces:**
|
||||
- Consumes: 已确认设计文档、现有 Tailscale SSH 隧道、开发环境 API 配置。
|
||||
- Produces: 新分支和工作区、GitNexus 影响证据、TDX 只读请求方法及脱敏字段基线。
|
||||
|
||||
- [ ] **Step 1: 创建隔离工作区并确认远程状态**
|
||||
|
||||
```bash
|
||||
git fetch origin main
|
||||
git worktree add .worktrees/feat-mo-001-tdx-overview -b codex/feat-mo-001-tdx-overview origin/main
|
||||
git -C .worktrees/feat-mo-001-tdx-overview status --short --branch
|
||||
```
|
||||
|
||||
预期：新工作区基于已推送的 `9a965fa`，不携带主工作区的 `AGENTS.md` 未提交修改。
|
||||
|
||||
- [ ] **Step 2: 执行开发前门禁并记录结果**
|
||||
|
||||
```bash
|
||||
pnpm schema:baseline
|
||||
pnpm schema:verify
|
||||
npx gitnexus analyze
|
||||
npx gitnexus impact --repo /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis --scope upstream "ApiModule.register"
|
||||
npx gitnexus impact --repo /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis --scope upstream "createAppRouter"
|
||||
npx gitnexus impact --repo /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis --scope upstream "createRequestClient"
|
||||
```
|
||||
|
||||
预期：Schema 命令只读取开发环境；若本机缺少 MySQL 5.7.x 客户端，沿用已确认的 FEAT-MO-001 一次性 waiver 记录失败，不伪造基线。任何 HIGH/CRITICAL 影响先记录并暂停代码修改。
|
||||
|
||||
- [ ] **Step 3: 用当前 TDX 隧道执行最小只读协议请求**
|
||||
|
||||
```bash
|
||||
curl --fail-with-body --silent --show-error \
|
||||
--connect-timeout 3 --max-time 10 \
|
||||
-H 'Content-Type: application/json' \
|
||||
-X POST 'http://127.0.0.1:17710/' \
|
||||
--data '{"id":1,"method":"get_market_data","params":{"stock_list":["600519.SH"],"count":5,"dividend_type":"none","period":"1d"}}'
|
||||
```
|
||||
|
||||
预期：记录实际 HTTP 状态、业务错误码、响应耗时、字段名称和字段完整性；报告不得保存原始载荷、地址、账户或密钥。若方法不可用，按 TDX 返回的公开错误信息调整为仓库文档支持的只读方法，并把最终方法名写入 `tdx.types.ts` 和冒烟报告。
|
||||
|
||||
- [ ] **Step 4: 提交门禁和协议基线**
|
||||
|
||||
```bash
|
||||
git add docs/features/FEAT-MO-001-market-overview/gitnexus docs/features/FEAT-MO-001-market-overview/tdx-smoke-report.md
|
||||
git commit -m "docs(FEAT-MO-001): 建立TDX概览开发基线"
|
||||
git push -u origin codex/feat-mo-001-tdx-overview
|
||||
```
|
||||
|
||||
预期：提交只包含治理和脱敏报告，不包含真实 TDX 原始 JSON。
|
||||
|
||||
### Task 2: 配置和 TDX 客户端
|
||||
|
||||
**Files:**
|
||||
- Modify: `server/libs/config/src/runtime-config.ts`
|
||||
- Modify: `deploy/env/development/api.env.example`
|
||||
- Create: `server/apps/api/src/market-overview/tdx/tdx.types.ts`
|
||||
- Create: `server/apps/api/src/market-overview/tdx/tdx.client.ts`
|
||||
- Create: `server/apps/api/src/market-overview/tdx/tdx.client.test.ts`
|
||||
|
||||
**Interfaces:**
|
||||
- Consumes: Task 1 的已验证只读请求方法和字段基线。
|
||||
- Produces: `ApiRuntimeConfig.tdx`、`TdxClient.request<TResponse>()`、`TdxClientError`。
|
||||
|
||||
- [ ] **Step 1: 先写配置和客户端失败测试**
|
||||
|
||||
```ts
|
||||
it('拒绝非本机 TDX 地址', () => {
|
||||
expect(() => loadApiConfig({ ...validEnv, TDX_BASE_URL: 'http://example.test' })).toThrow(
|
||||
'TDX_BASE_URL 必须指向本机回环地址',
|
||||
);
|
||||
});
|
||||
|
||||
it('将 TDX 超时转换为脱敏错误', async () => {
|
||||
const client = createTdxClient({ baseUrl: 'http://127.0.0.1:17710', timeoutMs: 50 }, timeoutFetch);
|
||||
await expect(client.request('get_market_data', { stock_list: ['600519.SH'] })).rejects.toMatchObject({
|
||||
kind: 'timeout',
|
||||
});
|
||||
});
|
||||
```
|
||||
|
||||
- [ ] **Step 2: 运行定向测试确认失败**
|
||||
|
||||
```bash
|
||||
pnpm --filter @a-share-analysis/server exec vitest run apps/api/src/market-overview/tdx/tdx.client.test.ts
|
||||
```
|
||||
|
||||
预期：因配置字段、客户端工厂和错误类型不存在而失败。
|
||||
|
||||
- [ ] **Step 3: 实现最小配置和客户端**
|
||||
|
||||
`ApiRuntimeConfig` 增加：
|
||||
|
||||
```ts
|
||||
tdx: Readonly<{
|
||||
baseUrl: 'http://127.0.0.1:17710';
|
||||
timeoutMs: number;
|
||||
}>;
|
||||
```
|
||||
|
||||
`TdxClient` 暴露：
|
||||
|
||||
```ts
|
||||
interface TdxClient {
|
||||
request<TResponse>(method: string, params: Record<string, unknown>): Promise<TResponse>;
|
||||
}
|
||||
```
|
||||
|
||||
客户端使用 Node 22 内置 `fetch`，固定 POST `/`、JSON-RPC 请求体、连接/读取超时和 1 MiB 响应上限；只抛出 `timeout`、`network`、`protocol`、`unavailable` 四类错误，禁止把 URL、请求头或原始正文放入错误对象。
|
||||
|
||||
- [ ] **Step 4: 运行定向测试确认通过**
|
||||
|
||||
```bash
|
||||
pnpm --filter @a-share-analysis/server exec vitest run apps/api/src/market-overview/tdx/tdx.client.test.ts
|
||||
pnpm --filter @a-share-analysis/server typecheck
|
||||
```
|
||||
|
||||
- [ ] **Step 5: 提交并推送**
|
||||
|
||||
```bash
|
||||
git add server/libs/config/src/runtime-config.ts deploy/env/development/api.env.example server/apps/api/src/market-overview/tdx
|
||||
git commit -m "feat(FEAT-MO-001): 增加TDX直连客户端"
|
||||
git push
|
||||
```
|
||||
|
||||
### Task 3: 市场概览 DTO、映射和分模块 API
|
||||
|
||||
**Files:**
|
||||
- Create: `server/apps/api/src/market-overview/tdx/tdx.mapper.ts`
|
||||
- Create: `server/apps/api/src/market-overview/tdx/tdx.mapper.test.ts`
|
||||
- Create: `server/apps/api/src/market-overview/market-overview.dto.ts`
|
||||
- Create: `server/apps/api/src/market-overview/market-overview.service.ts`
|
||||
- Create: `server/apps/api/src/market-overview/market-overview.service.test.ts`
|
||||
- Create: `server/apps/api/src/market-overview/market-overview.controller.ts`
|
||||
- Create: `server/apps/api/src/market-overview/market-overview.module.ts`
|
||||
- Modify: `server/apps/api/src/api.module.ts`
|
||||
- Create: `server/apps/api/test/market-overview.e2e-spec.ts`
|
||||
|
||||
**Interfaces:**
|
||||
- Consumes: `TdxClient.request<TResponse>()` 和 `ApiRuntimeConfig.tdx`。
|
||||
- Produces: `GET /api/v1/market-overview/{summary,indices,breadth,sectors,funds}`，统一响应元数据和模块数据。
|
||||
|
||||
- [ ] **Step 1: 写 DTO 和映射失败测试**
|
||||
|
||||
```ts
|
||||
it('将涨跌字段转换为 A 股红涨绿跌口径并保留百分比', () => {
|
||||
expect(mapIndexQuote({ code: '000001', name: '上证指数', price: 3380.12, change: 28.4 })).toEqual({
|
||||
code: '000001', name: '上证指数', price: 3380.12, changePercent: 0.86, direction: 'up',
|
||||
});
|
||||
});
|
||||
|
||||
it('缺少板块数据时返回 partial 而不是抛出整页错误', async () => {
|
||||
const response = await service.getSectors();
|
||||
expect(response.status).toBe('partial');
|
||||
expect(response.warnings).toHaveLength(1);
|
||||
});
|
||||
```
|
||||
|
||||
- [ ] **Step 2: 运行定向测试确认失败**
|
||||
|
||||
```bash
|
||||
pnpm --filter @a-share-analysis/server exec vitest run apps/api/src/market-overview/tdx/tdx.mapper.test.ts apps/api/src/market-overview/market-overview.service.test.ts
|
||||
```
|
||||
|
||||
- [ ] **Step 3: 实现 DTO 和五个服务方法**
|
||||
|
||||
服务公开以下方法：
|
||||
|
||||
```ts
|
||||
getSummary(): Promise<MarketOverviewResponse<SummaryData>>;
|
||||
getIndices(): Promise<MarketOverviewResponse<IndexData>>;
|
||||
getBreadth(): Promise<MarketOverviewResponse<BreadthData>>;
|
||||
getSectors(): Promise<MarketOverviewResponse<SectorData>>;
|
||||
getFunds(): Promise<MarketOverviewResponse<FundData>>;
|
||||
```
|
||||
|
||||
每次请求生成 `snapshotId` 和 `asOf`，调用已验证的 TDX 只读方法，映射后只返回页面需要字段。单模块错误映射为 `partial` 或 `unavailable`，不将 TDX 原始错误透传。
|
||||
|
||||
- [ ] **Step 4: 注册控制器并完成 HTTP 测试**
|
||||
|
||||
控制器只注入 `MarketOverviewService`，每个 `@Get` 方法仅调用对应服务方法并声明 Swagger 成功/不可用响应；模块在 `ApiModule.register(config)` 中装配 `TdxClient` 的配置工厂。
|
||||
|
||||
```bash
|
||||
pnpm --filter @a-share-analysis/server exec vitest run apps/api/test/market-overview.e2e-spec.ts
|
||||
```
|
||||
|
||||
预期：五个接口返回 200 或结构化 503，响应不包含 TDX 地址、请求参数或原始载荷。
|
||||
|
||||
- [ ] **Step 5: 提交并推送**
|
||||
|
||||
```bash
|
||||
git add server/apps/api/src/market-overview server/apps/api/src/api.module.ts server/apps/api/test/market-overview.e2e-spec.ts
|
||||
git commit -m "feat(FEAT-MO-001): 增加市场概览分模块接口"
|
||||
git push
|
||||
```
|
||||
|
||||
### Task 4: OpenAPI 契约和前端 API 状态层
|
||||
|
||||
**Files:**
|
||||
- Modify: `server/tools/export-openapi.ts`
|
||||
- Modify: `server/openapi/openapi.json`
|
||||
- Modify: `web/src/api/generated/schema.ts`
|
||||
- Create: `web/src/types/market-overview.ts`
|
||||
- Create: `web/src/api/market-overview/index.ts`
|
||||
- Create: `web/src/api/market-overview/index.test.ts`
|
||||
- Create: `web/src/views/market-overview/useMarketOverview.ts`
|
||||
- Create: `web/src/views/market-overview/useMarketOverview.test.ts`
|
||||
|
||||
**Interfaces:**
|
||||
- Consumes: 后端五个 OpenAPI 路径和 `web/src/utils/request.ts`。
|
||||
- Produces: `marketOverviewApi`、`useMarketOverview()`、统一模块加载状态和本地分析偏好。
|
||||
|
||||
- [ ] **Step 1: 先写前端 API 和状态层失败测试**
|
||||
|
||||
```ts
|
||||
it('使用独立路径请求指数接口', async () => {
|
||||
const request = vi.fn().mockResolvedValue({ data: { status: 'fresh' } });
|
||||
await createMarketOverviewApi(request).getIndices();
|
||||
expect(request).toHaveBeenCalledWith({ method: 'GET', url: '/api/v1/market-overview/indices' });
|
||||
});
|
||||
|
||||
it('一个模块失败时其他模块仍保留结果', async () => {
|
||||
const state = await useMarketOverview({ summary: okSummary, indices: failed, breadth: okBreadth, sectors: okSectors, funds: failed });
|
||||
expect(state.summary.status).toBe('ready');
|
||||
expect(state.indices.status).toBe('error');
|
||||
});
|
||||
```
|
||||
|
||||
- [ ] **Step 2: 运行定向测试确认失败**
|
||||
|
||||
```bash
|
||||
pnpm --filter @a-share-analysis/web exec vitest run src/api/market-overview/index.test.ts src/views/market-overview/useMarketOverview.test.ts
|
||||
```
|
||||
|
||||
- [ ] **Step 3: 生成并校验 OpenAPI 类型**
|
||||
|
||||
```bash
|
||||
pnpm check:contracts
|
||||
```
|
||||
|
||||
预期：生成的 JSON 和 TypeScript 契约只包含五个市场概览路径，且 `verify-generated-contracts` 通过。
|
||||
|
||||
- [ ] **Step 4: 实现 API 文件和 composable**
|
||||
|
||||
API 文件只调用请求封装：
|
||||
|
||||
```ts
|
||||
export function createMarketOverviewApi(requestClient = request) {
|
||||
return {
|
||||
getSummary: () => requestClient<SummaryResponse>({ method: 'GET', url: '/api/v1/market-overview/summary' }),
|
||||
getIndices: () => requestClient<IndicesResponse>({ method: 'GET', url: '/api/v1/market-overview/indices' }),
|
||||
getBreadth: () => requestClient<BreadthResponse>({ method: 'GET', url: '/api/v1/market-overview/breadth' }),
|
||||
getSectors: () => requestClient<SectorsResponse>({ method: 'GET', url: '/api/v1/market-overview/sectors' }),
|
||||
getFunds: () => requestClient<FundsResponse>({ method: 'GET', url: '/api/v1/market-overview/funds' }),
|
||||
};
|
||||
}
|
||||
```
|
||||
|
||||
`useMarketOverview()` 使用 `Promise.allSettled` 并行加载，暴露 `refresh()`、每个模块的 `loading/ready/error` 状态，以及浏览器 `localStorage` 中的分析周期和分析引擎偏好；不得存储行情原始载荷。
|
||||
|
||||
- [ ] **Step 5: 运行定向测试和类型检查**
|
||||
|
||||
```bash
|
||||
pnpm --filter @a-share-analysis/web exec vitest run src/api/market-overview/index.test.ts src/views/market-overview/useMarketOverview.test.ts
|
||||
pnpm --filter @a-share-analysis/web typecheck
|
||||
```
|
||||
|
||||
- [ ] **Step 6: 提交并推送**
|
||||
|
||||
```bash
|
||||
git add server/tools/export-openapi.ts server/openapi/openapi.json web/src/api/generated/schema.ts web/src/types/market-overview.ts web/src/api/market-overview web/src/views/market-overview/useMarketOverview.ts web/src/views/market-overview/useMarketOverview.test.ts
|
||||
git commit -m "feat(FEAT-MO-001): 同步市场概览前端契约"
|
||||
git push
|
||||
```
|
||||
|
||||
### Task 5: Vue 首屏和交互状态
|
||||
|
||||
**Files:**
|
||||
- Create: `web/src/views/market-overview/MarketOverviewPage.vue`
|
||||
- Create: `web/src/views/market-overview/components/MarketConclusion.vue`
|
||||
- Create: `web/src/views/market-overview/components/MarketDrivers.vue`
|
||||
- Create: `web/src/views/market-overview/components/IndexOverview.vue`
|
||||
- Create: `web/src/views/market-overview/components/MarketBreadth.vue`
|
||||
- Create: `web/src/views/market-overview/components/SectorOverview.vue`
|
||||
- Create: `web/src/views/market-overview/components/FundTrend.vue`
|
||||
- Modify: `web/src/app/router.ts`
|
||||
- Modify: `web/src/app/App.vue`
|
||||
- Modify: `web/src/styles/index.scss`
|
||||
- Modify: `web/src/app/App.test.ts`
|
||||
- Modify: `web/tests/smoke.spec.ts`
|
||||
|
||||
**Interfaces:**
|
||||
- Consumes: `useMarketOverview()`、市场概览类型和 `marketOverviewApi`。
|
||||
- Produces: `/` 可访问的市场综合概览首屏，包含数据来源、时间、模块状态、依据入口和分析偏好入口。
|
||||
|
||||
- [ ] **Step 1: 先写页面失败测试**
|
||||
|
||||
```ts
|
||||
it('首屏显示市场结论、更新时间和 TDX 来源', async () => {
|
||||
const wrapper = mountMarketOverview({ state: freshState });
|
||||
expect(wrapper.getByRole('heading', { name: '市场综合概览' })).toBeTruthy();
|
||||
expect(wrapper.getByText('数据来源：TDX')).toBeTruthy();
|
||||
expect(wrapper.getByText('更新时间')).toBeTruthy();
|
||||
});
|
||||
|
||||
it('TDX 不可用时显示错误状态而不是实时数据', async () => {
|
||||
const wrapper = mountMarketOverview({ state: unavailableState });
|
||||
expect(wrapper.getByText('TDX 数据不可用')).toBeTruthy();
|
||||
expect(wrapper.queryByText('实时行情')).toBeNull();
|
||||
});
|
||||
```
|
||||
|
||||
- [ ] **Step 2: 运行前端测试确认失败**
|
||||
|
||||
```bash
|
||||
pnpm --filter @a-share-analysis/web exec vitest run src/app/App.test.ts
|
||||
```
|
||||
|
||||
- [ ] **Step 3: 实现首屏和组件状态**
|
||||
|
||||
页面保持结论优先顺序；指数、板块使用按钮/链接样式保留未来详情页入口；加载、空、部分、过期、错误状态均有明确文案和稳定尺寸。分析周期和分析引擎使用 Naive UI 的选择控件，偏好保存在本地，不触发 TDX 请求参数变化。
|
||||
|
||||
- [ ] **Step 4: 接入路由和应用壳**
|
||||
|
||||
`createAppRouter()` 的 `/` 路由渲染 `MarketOverviewPage`；应用壳保留可访问 header、main 和 `NMessageProvider`，不新增无业务意义的导航菜单。
|
||||
|
||||
- [ ] **Step 5: 运行组件、构建和浏览器冒烟**
|
||||
|
||||
```bash
|
||||
pnpm --filter @a-share-analysis/web exec vitest run src/app/App.test.ts src/views/market-overview
|
||||
pnpm --filter @a-share-analysis/web build
|
||||
pnpm verify:e2e -- --project=chromium
|
||||
```
|
||||
|
||||
预期：桌面和窄屏无横向溢出，TDX 连接不可用时页面仍可读但明确标记不可用。
|
||||
|
||||
- [ ] **Step 6: 提交并推送**
|
||||
|
||||
```bash
|
||||
git add web/src/views/market-overview web/src/app/router.ts web/src/app/App.vue web/src/styles/index.scss web/src/app/App.test.ts web/tests/smoke.spec.ts
|
||||
git commit -m "feat(FEAT-MO-001): 完成TDX市场概览首屏"
|
||||
git push
|
||||
```
|
||||
|
||||
### Task 6: 真实 TDX 联调、文档追踪和 Review
|
||||
|
||||
**Files:**
|
||||
- Modify: `docs/features/FEAT-MO-001-market-overview/requirements.md`
|
||||
- Modify: `docs/features/FEAT-MO-001-market-overview/design.md`
|
||||
- Modify: `docs/features/FEAT-MO-001-market-overview/implementation-plan.md`
|
||||
- Modify: `docs/features/FEAT-MO-001-market-overview/test-plan.md`
|
||||
- Create: `docs/features/FEAT-MO-001-market-overview/development-summary.md`
|
||||
- Create: `docs/features/FEAT-MO-001-market-overview/review/code-review.md`
|
||||
- Create: `docs/features/FEAT-MO-001-market-overview/review/standards-review.md`
|
||||
- Modify: `docs/features/FEAT-MO-001-market-overview/manifest.yaml`
|
||||
|
||||
**Interfaces:**
|
||||
- Consumes: 已完成的 API、前端页面、脱敏 TDX 基线和测试结果。
|
||||
- Produces: 完整功能档案、开发总结、安全/性能证据、代码 Review 和规范 Review。
|
||||
|
||||
- [ ] **Step 1: 外出 Tailscale 隧道执行真实只读联调**
|
||||
|
||||
```bash
|
||||
ssh -S "$HOME/.ssh/tdx-windows-tailnet-control" -O check tdx-windows-tailnet
|
||||
lsof -nP -iTCP:17710 -sTCP:LISTEN
|
||||
pnpm --filter @a-share-analysis/server exec vitest run apps/api/test/market-overview.e2e-spec.ts
|
||||
```
|
||||
|
||||
记录接口耗时、字段完整性、模块状态和 TDX 错误分类；报告不保存地址、密钥、完整请求或完整响应。
|
||||
|
||||
- [ ] **Step 2: 更新功能档案**
|
||||
|
||||
开发总结必须明确：原始需求、范围变化（由分层混合改为 TDX 单路径）、实际完成、修复缺陷、延期项、关键提交、测试/构建/视觉证据和残余风险。需求、设计、测试计划和 manifest 的状态必须一致。
|
||||
|
||||
- [ ] **Step 3: 执行代码 Review 和规范 Review**
|
||||
|
||||
Review 至少检查：TDX 地址白名单、错误脱敏、模块级降级、请求超时、响应大小、DTO 不透传原始字段、Axios API 边界、中文注释、性能目标、无凭据提交和移动端溢出。问题及处置写入两个 Review 文档。
|
||||
|
||||
- [ ] **Step 4: 完成全量验证和 GitNexus 变更检测**
|
||||
|
||||
```bash
|
||||
npx gitnexus analyze
|
||||
npx gitnexus detect-changes --repo /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis --scope all
|
||||
pnpm verify
|
||||
pnpm verify:source
|
||||
```
|
||||
|
||||
预期：GitNexus 只显示市场概览、配置、OpenAPI、前端路由和测试相关变更；任何未预期跨模块影响必须先处置。
|
||||
|
||||
- [ ] **Step 5: 执行治理收尾并推送标签（仅在用户批准发布时）**
|
||||
|
||||
```bash
|
||||
pnpm governance:finish -- FEAT-MO-001 market-overview
|
||||
git add docs/features/FEAT-MO-001-market-overview
|
||||
git commit -m "docs(FEAT-MO-001): 完成市场概览开发收尾"
|
||||
git push
|
||||
```
|
||||
|
||||
未获发布批准前不创建或推送版本标签；所有提交推送失败时不得标记功能完成。
|
||||
|
||||
## 计划自审
|
||||
|
||||
- 设计中的五个分模块接口均在 Task 3、Task 4、Task 5 有对应实现和测试。
|
||||
- TDX 单一路径、无样本回退、安全、性能、分钟级刷新、错误状态和脱敏报告均有明确任务。
|
||||
- OpenAPI、前端 Axios API 文件、Nest 分层、中文注释和 GitNexus 门禁均有明确文件及命令。
|
||||
- 没有 `TODO`、`TBD` 或未定义的后续函数；TDX 方法名在 Task 1 以实际只读协议验证结果为准并写入类型，避免臆测字段。
|
||||
- MySQL/Redis/RocketMQ/AI/用户体系未被实现任务隐式引入。
|
||||
@@ -0,0 +1,140 @@
|
||||
# 市场综合概览 TDX 直连设计
|
||||
|
||||
- 功能编号：FEAT-MO-001
|
||||
- 设计版本：0.2
|
||||
- 状态：已获用户确认，待实现计划
|
||||
- 日期：2026-08-18
|
||||
|
||||
## 1. 设计目标
|
||||
|
||||
首页市场概览直接使用 TDX 行情数据，向用户提供结论优先的综合盘面视图。数据链路不保留离线样本 Provider 或运行时数据源切换，TDX 不可用时明确展示不可用状态，不伪造实时行情。
|
||||
|
||||
首屏支持综合、短线和中长线视角，以及规则、AI、混合和对照模式的状态入口；本次 TDX 首屏只提供统一的市场快照和规则事实展示，不在本轮实现付费 AI 结论。
|
||||
|
||||
## 2. 系统边界
|
||||
|
||||
浏览器不得直接连接 TDX。Nest API 在服务端调用本机 TDX 隧道端点，Vue 通过既有 Axios 封装访问 Nest API。
|
||||
|
||||
```text
|
||||
Vue 市场概览
|
||||
-> Axios request 封装
|
||||
-> Nest 市场概览 API
|
||||
-> TDX HTTP 客户端
|
||||
-> 127.0.0.1:17710
|
||||
-> SSH / Tailscale 隧道
|
||||
-> Windows 127.0.0.1:17709
|
||||
-> TDX
|
||||
```
|
||||
|
||||
家庭局域网和外出 Tailscale 只改变 SSH 别名和网络路径，业务服务始终访问本机 `127.0.0.1:17710`。真实地址、用户、密钥和控制套接字只保存在开发机，不进入仓库。
|
||||
|
||||
## 3. 后端模块设计
|
||||
|
||||
后端按市场概览业务模块组织，保持连续可读的职责边界：
|
||||
|
||||
```text
|
||||
server/apps/api/src/market-overview/
|
||||
├── market-overview.module.ts
|
||||
├── market-overview.controller.ts
|
||||
├── market-overview.service.ts
|
||||
├── market-overview.dto.ts
|
||||
└── tdx/
|
||||
├── tdx.client.ts
|
||||
├── tdx.mapper.ts
|
||||
└── tdx.types.ts
|
||||
```
|
||||
|
||||
- `controller`：提供按业务模块拆分的只读 HTTP 接口。
|
||||
- `service`：组织 TDX 数据、统一快照时间并生成规则事实摘要。
|
||||
- `dto`：定义 HTTP 响应契约，禁止把 TDX 原始字段直接暴露给前端。
|
||||
- `tdx.client`：只负责请求本机 TDX 端点、超时和协议级错误。
|
||||
- `tdx.mapper`：把 TDX 原始字段转换为领域字段和展示口径。
|
||||
- `tdx.types`：描述经过确认的 TDX 原始响应结构。
|
||||
|
||||
首版接口：
|
||||
|
||||
```text
|
||||
GET /api/market-overview/summary
|
||||
GET /api/market-overview/indices
|
||||
GET /api/market-overview/breadth
|
||||
GET /api/market-overview/sectors
|
||||
GET /api/market-overview/funds
|
||||
```
|
||||
|
||||
接口按模块拆分，页面进入时可并行请求；每个接口失败不会使其他模块整体失败。未来详情页可以复用指数和板块的业务边界，不通过新增巨型首页接口解决。
|
||||
|
||||
## 4. 前端模块设计
|
||||
|
||||
```text
|
||||
web/src/
|
||||
├── api/market-overview/index.ts
|
||||
├── views/market-overview/
|
||||
│ ├── MarketOverviewPage.vue
|
||||
│ ├── useMarketOverview.ts
|
||||
│ └── components/
|
||||
└── types/market-overview.ts
|
||||
```
|
||||
|
||||
业务请求只能通过 `web/src/api/market-overview/index.ts` 调用 `web/src/utils/request.ts`。页面组件不直接使用 Axios、不拼接 TDX 地址，也不读取服务端环境变量。
|
||||
|
||||
首屏顺序：市场结论、驱动与风险、核心指数、涨跌分布与市场宽度、成交量与成交额、板块强弱、资金趋势、更新时间和 TDX 连接状态。指数和板块保留进入未来详情页的可识别入口。
|
||||
|
||||
## 5. 响应契约与状态
|
||||
|
||||
每个业务接口采用统一外层结构：
|
||||
|
||||
```json
|
||||
{
|
||||
"snapshotId": "20260818-101500",
|
||||
"asOf": "2026-08-18T10:15:00+08:00",
|
||||
"source": "tdx",
|
||||
"status": "fresh",
|
||||
"data": {},
|
||||
"warnings": []
|
||||
}
|
||||
```
|
||||
|
||||
`status` 取值为 `fresh`、`delayed`、`partial` 或 `unavailable`。`snapshotId` 和 `asOf` 用于让并行接口在同一次市场快照下可对照；数据日期、更新时间和来源状态必须在页面可见。
|
||||
|
||||
- TDX 单个模块失败：只显示对应模块错误。
|
||||
- TDX 返回部分字段：保留可用字段并标记 `partial`。
|
||||
- TDX 超时或完全不可用：显示连接状态和重试入口，不显示虚假行情。
|
||||
- 后端日志只记录脱敏错误摘要，不保存完整原始行情载荷。
|
||||
|
||||
## 6. 安全策略
|
||||
|
||||
- TDX 地址固定来自服务端配置，禁止由 HTTP 请求参数传入任意 URL，避免 SSRF。
|
||||
- TDX 仅通过本机回环端点访问；Windows TDX 继续只监听 `127.0.0.1:17709`。
|
||||
- API 只读，不提供交易指令、买卖建议、目标价或仓位建议。
|
||||
- SSH、Tailscale、TDX 账号、密钥、密码、本地环境文件和生产地址不提交 Git。
|
||||
- 真实行情只用于只读联调，日志、测试报告和截图不得保存家庭网络信息或完整原始载荷。
|
||||
|
||||
## 7. 性能策略
|
||||
|
||||
- 页面并行请求各业务接口，避免串行阻塞整页。
|
||||
- TDX 客户端设置连接超时和读取超时，并记录请求耗时。
|
||||
- DTO 只返回页面需要字段，不透传完整 TDX 原始响应。
|
||||
- 首版采用分钟级刷新，不承诺秒级实时；暂不启用 Redis 缓存，待数据口径和刷新频率稳定后评估。
|
||||
- 前端使用模块级加载、空、部分数据和错误状态，避免一个模块阻断首屏。
|
||||
|
||||
## 8. 测试与验证
|
||||
|
||||
- TDX 类型转换和展示口径的单元测试。
|
||||
- 每个接口的成功、超时、空数据、部分字段和不可用测试。
|
||||
- Nest API 响应契约和错误状态测试。
|
||||
- Vue API 模块、页面状态和模块级失败降级测试。
|
||||
- 家庭局域网 SSH 路径和外出 Tailscale SSH 路径的端到端只读联调。
|
||||
- 桌面与窄屏视觉验证，确认结论、更新时间和错误状态不重叠。
|
||||
- 开发前和提交前执行 GitNexus 影响分析与变更检测；开发完成执行代码 Review、规范 Review、测试、构建和 `governance:finish`。
|
||||
|
||||
## 9. 明确不在本次实现范围
|
||||
|
||||
- 离线样本 Provider、运行时数据源切换和自动回退。
|
||||
- MySQL、Redis、RocketMQ 的正式行情存储或采集链路。
|
||||
- 付费 AI 请求和 AI 结论生成。
|
||||
- 用户、邀请、会员、订阅、社区、自选股、笔记、计划和交易功能。
|
||||
- 指数或板块详情页的完整实现；本次只保留入口和接口边界。
|
||||
|
||||
## 10. 回退方案
|
||||
|
||||
若 TDX 协议字段无法稳定确认、首屏核心模块无法独立降级或隧道联调影响本地构建，则停止 TDX 直连功能提交，回退到上一个本地标签；不得以样本数据冒充 TDX 实时结果。回退只撤销本功能提交，不删除开发机 SSH、Tailscale 或 TDX 配置。
|
||||
@@ -10,6 +10,15 @@ export default [
|
||||
eslint.configs.recommended,
|
||||
...tseslint.configs.recommended,
|
||||
...vue.configs['flat/recommended'],
|
||||
{
|
||||
files: ['**/*.vue'],
|
||||
languageOptions: {
|
||||
parserOptions: {
|
||||
// Vue 单文件组件的 script setup 使用 TypeScript，避免 ESLint 退回 Espree。
|
||||
parser: tseslint.parser,
|
||||
},
|
||||
},
|
||||
},
|
||||
{
|
||||
files: ['**/*.{js,mjs,cjs,ts,tsx,vue}'],
|
||||
languageOptions: {
|
||||
|
||||
@@ -6,6 +6,7 @@ import { createMysqlHealthClient } from '../../../libs/infrastructure/src/mysql-
|
||||
import { createRedisHealthClient } from '../../../libs/infrastructure/src/redis-health.client';
|
||||
import { HealthController } from './health.controller';
|
||||
import { HealthService, MYSQL_HEALTH_PORT, REDIS_HEALTH_PORT } from './health.service';
|
||||
import { MarketOverviewModule } from './market-overview/market-overview.module';
|
||||
|
||||
/** API 进程的只读配置注入令牌，确保测试和启动入口使用同一份显式配置。 */
|
||||
export const API_RUNTIME_CONFIG = Symbol('API_RUNTIME_CONFIG');
|
||||
@@ -19,6 +20,7 @@ export class ApiModule {
|
||||
static register(config: ApiRuntimeConfig): DynamicModule {
|
||||
return {
|
||||
module: ApiModule,
|
||||
imports: [MarketOverviewModule.register(config)],
|
||||
controllers: [HealthController],
|
||||
providers: [
|
||||
HealthService,
|
||||
|
||||
@@ -0,0 +1,47 @@
|
||||
import { Controller, Get, Inject } from '@nestjs/common';
|
||||
import { ApiOkResponse, ApiTags } from '@nestjs/swagger';
|
||||
|
||||
import {
|
||||
BreadthResponseDto,
|
||||
FundsResponseDto,
|
||||
IndicesResponseDto,
|
||||
SectorsResponseDto,
|
||||
SummaryResponseDto,
|
||||
} from './market-overview.dto';
|
||||
import { MarketOverviewService } from './market-overview.service';
|
||||
|
||||
@ApiTags('market-overview')
|
||||
@Controller('market-overview')
|
||||
export class MarketOverviewController {
|
||||
constructor(@Inject(MarketOverviewService) private readonly service: MarketOverviewService) {}
|
||||
|
||||
@Get('summary')
|
||||
@ApiOkResponse({ type: SummaryResponseDto })
|
||||
getSummary(): Promise<SummaryResponseDto> {
|
||||
return this.service.getSummary();
|
||||
}
|
||||
|
||||
@Get('indices')
|
||||
@ApiOkResponse({ type: IndicesResponseDto })
|
||||
getIndices(): Promise<IndicesResponseDto> {
|
||||
return this.service.getIndices();
|
||||
}
|
||||
|
||||
@Get('breadth')
|
||||
@ApiOkResponse({ type: BreadthResponseDto })
|
||||
getBreadth(): Promise<BreadthResponseDto> {
|
||||
return this.service.getBreadth();
|
||||
}
|
||||
|
||||
@Get('sectors')
|
||||
@ApiOkResponse({ type: SectorsResponseDto })
|
||||
getSectors(): Promise<SectorsResponseDto> {
|
||||
return this.service.getSectors();
|
||||
}
|
||||
|
||||
@Get('funds')
|
||||
@ApiOkResponse({ type: FundsResponseDto })
|
||||
getFunds(): Promise<FundsResponseDto> {
|
||||
return this.service.getFunds();
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,147 @@
|
||||
import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
|
||||
|
||||
export type MarketOverviewStatus = 'fresh' | 'delayed' | 'partial' | 'unavailable';
|
||||
export type QuoteDirection = 'up' | 'down' | 'flat';
|
||||
|
||||
export class MarketOverviewMetaDto {
|
||||
@ApiProperty({ type: String })
|
||||
snapshotId!: string;
|
||||
|
||||
@ApiProperty({ type: String, format: 'date-time' })
|
||||
asOf!: string;
|
||||
|
||||
@ApiProperty({ type: String, enum: ['tdx'] })
|
||||
source!: 'tdx';
|
||||
|
||||
@ApiProperty({ enum: ['fresh', 'delayed', 'partial', 'unavailable'] })
|
||||
status!: MarketOverviewStatus;
|
||||
|
||||
@ApiProperty({ type: [String] })
|
||||
warnings!: string[];
|
||||
}
|
||||
|
||||
export class IndexQuoteDto {
|
||||
@ApiProperty({ type: String })
|
||||
code!: string;
|
||||
|
||||
@ApiProperty({ type: String })
|
||||
name!: string;
|
||||
|
||||
@ApiProperty({ type: Number })
|
||||
price!: number;
|
||||
|
||||
@ApiPropertyOptional({ type: Number, nullable: true })
|
||||
changePercent!: number | null;
|
||||
|
||||
@ApiProperty({ enum: ['up', 'down', 'flat'] })
|
||||
direction!: QuoteDirection;
|
||||
|
||||
@ApiProperty({ type: String })
|
||||
tradeDate!: string;
|
||||
}
|
||||
|
||||
export class IndicesDataDto {
|
||||
@ApiProperty({ type: [IndexQuoteDto] })
|
||||
items!: IndexQuoteDto[];
|
||||
}
|
||||
|
||||
export class SummaryDataDto {
|
||||
@ApiProperty({ type: String })
|
||||
verdict!: string;
|
||||
|
||||
@ApiProperty({ type: String })
|
||||
marketStatus!: string;
|
||||
|
||||
@ApiProperty({ type: String })
|
||||
volumeStatus!: string;
|
||||
|
||||
@ApiProperty({ type: String })
|
||||
sentimentStatus!: string;
|
||||
|
||||
@ApiProperty({ type: [String] })
|
||||
drivers!: string[];
|
||||
|
||||
@ApiProperty({ type: [String] })
|
||||
risks!: string[];
|
||||
}
|
||||
|
||||
export class BreadthDataDto {
|
||||
@ApiProperty({ type: Number })
|
||||
advancing!: number;
|
||||
|
||||
@ApiProperty({ type: Number })
|
||||
declining!: number;
|
||||
|
||||
@ApiProperty({ type: Number, nullable: true })
|
||||
unchanged!: number | null;
|
||||
}
|
||||
|
||||
export class SectorQuoteDto {
|
||||
@ApiProperty({ type: String })
|
||||
code!: string;
|
||||
|
||||
@ApiProperty({ type: String })
|
||||
name!: string;
|
||||
|
||||
@ApiProperty({ type: Number })
|
||||
changePercent!: number;
|
||||
|
||||
@ApiProperty({ enum: ['up', 'down', 'flat'] })
|
||||
direction!: QuoteDirection;
|
||||
|
||||
@ApiProperty({ type: String })
|
||||
tradeDate!: string;
|
||||
}
|
||||
|
||||
export class SectorDataDto {
|
||||
@ApiProperty({ type: [SectorQuoteDto] })
|
||||
items!: SectorQuoteDto[];
|
||||
}
|
||||
|
||||
export class FundDataDto {
|
||||
@ApiProperty({ type: Number })
|
||||
currentAmount!: number;
|
||||
|
||||
@ApiProperty({ type: Number })
|
||||
previousAmount!: number;
|
||||
|
||||
@ApiProperty({ type: Number })
|
||||
changePercent!: number;
|
||||
|
||||
@ApiProperty({ type: String, example: '亿元' })
|
||||
unit!: '亿元';
|
||||
|
||||
@ApiProperty({ type: Number, minimum: 1, maximum: 3 })
|
||||
marketCount!: number;
|
||||
|
||||
@ApiProperty({ type: String, example: '20260818' })
|
||||
tradeDate!: string;
|
||||
|
||||
@ApiProperty({ type: String, example: '20260817' })
|
||||
previousTradeDate!: string;
|
||||
}
|
||||
|
||||
export class SummaryResponseDto extends MarketOverviewMetaDto {
|
||||
@ApiProperty({ type: () => SummaryDataDto, nullable: true })
|
||||
data!: SummaryDataDto | null;
|
||||
}
|
||||
|
||||
export class IndicesResponseDto extends MarketOverviewMetaDto {
|
||||
@ApiProperty({ type: () => IndicesDataDto, nullable: true })
|
||||
data!: IndicesDataDto | null;
|
||||
}
|
||||
|
||||
export class BreadthResponseDto extends MarketOverviewMetaDto {
|
||||
@ApiProperty({ type: () => BreadthDataDto, nullable: true })
|
||||
data!: BreadthDataDto | null;
|
||||
}
|
||||
|
||||
export class SectorsResponseDto extends MarketOverviewMetaDto {
|
||||
@ApiProperty({ type: () => SectorDataDto, nullable: true })
|
||||
data!: SectorDataDto | null;
|
||||
}
|
||||
|
||||
export class FundsResponseDto extends MarketOverviewMetaDto {
|
||||
@ApiProperty({ type: () => FundDataDto, nullable: true })
|
||||
data!: FundDataDto | null;
|
||||
}
|
||||
@@ -0,0 +1,21 @@
|
||||
import { type DynamicModule, Module } from '@nestjs/common';
|
||||
|
||||
import type { ApiRuntimeConfig } from '../../../../libs/config/src/runtime-config';
|
||||
import { MarketOverviewController } from './market-overview.controller';
|
||||
import { MarketOverviewService, TDX_CLIENT_PORT } from './market-overview.service';
|
||||
import { createTdxClient } from './tdx/tdx.client';
|
||||
|
||||
@Module({})
|
||||
export class MarketOverviewModule {
|
||||
/** 将 API 已校验的 TDX 配置注入业务模块，避免模块内部重新读取环境变量。 */
|
||||
static register(config: ApiRuntimeConfig): DynamicModule {
|
||||
return {
|
||||
module: MarketOverviewModule,
|
||||
controllers: [MarketOverviewController],
|
||||
providers: [
|
||||
MarketOverviewService,
|
||||
{ provide: TDX_CLIENT_PORT, useValue: createTdxClient(config.tdx) },
|
||||
],
|
||||
};
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,323 @@
|
||||
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
|
||||
|
||||
import { MarketOverviewService } from './market-overview.service';
|
||||
|
||||
const indexSeries = {
|
||||
Date: ['20260817', '20260818'],
|
||||
Open: ['3350', '3370'],
|
||||
High: ['3385', '3400'],
|
||||
Low: ['3340', '3360'],
|
||||
Close: ['3360', '3380'],
|
||||
Amount: ['100', '120'],
|
||||
Volume: ['1000', '1100'],
|
||||
};
|
||||
|
||||
const indexResult = {
|
||||
ErrorId: '0',
|
||||
Value: Object.fromEntries(
|
||||
['000001.SH', '399001.SZ', '399006.SZ'].map((code) => [code, indexSeries]),
|
||||
),
|
||||
};
|
||||
|
||||
const breadthSnapshot = (up: string, down: string) => ({
|
||||
ErrorId: '0',
|
||||
UpHome: up,
|
||||
DownHome: down,
|
||||
ItemNum: '0',
|
||||
});
|
||||
|
||||
const sectorResult = {
|
||||
ErrorId: '0',
|
||||
Value: [
|
||||
{ Code: '881319.SH', Name: '半导体' },
|
||||
{ Code: '881355.SH', Name: '软件服务' },
|
||||
],
|
||||
};
|
||||
|
||||
const sectorKlineResult = {
|
||||
ErrorId: '0',
|
||||
Value: {
|
||||
'881319.SH': {
|
||||
Date: ['20260817', '20260818'],
|
||||
Open: ['100', '105'],
|
||||
High: ['106', '110'],
|
||||
Low: ['99', '104'],
|
||||
Close: ['100', '108'],
|
||||
Amount: ['1000', '1200'],
|
||||
Volume: ['100', '120'],
|
||||
},
|
||||
'881355.SH': {
|
||||
Date: ['20260817', '20260818'],
|
||||
Open: ['100', '98'],
|
||||
High: ['101', '99'],
|
||||
Low: ['97', '95'],
|
||||
Close: ['100', '96'],
|
||||
Amount: ['1000', '900'],
|
||||
Volume: ['100', '90'],
|
||||
},
|
||||
},
|
||||
};
|
||||
|
||||
const turnoverResult = {
|
||||
ErrorId: '0',
|
||||
Value: Object.fromEntries(
|
||||
['000001.SH', '399001.SZ', '899050.BJ'].map((code) => [
|
||||
code,
|
||||
{
|
||||
Date: ['20260817', '20260818'],
|
||||
Open: ['100', '100'],
|
||||
High: ['101', '101'],
|
||||
Low: ['99', '99'],
|
||||
Close: ['100', '100'],
|
||||
Amount: ['100000', '120000'],
|
||||
Volume: ['1000', '1100'],
|
||||
},
|
||||
]),
|
||||
),
|
||||
};
|
||||
|
||||
describe('市场概览服务', () => {
|
||||
beforeEach(() => {
|
||||
vi.useFakeTimers();
|
||||
vi.setSystemTime(new Date('2026-08-18T03:00:00.000Z'));
|
||||
});
|
||||
|
||||
afterEach(() => {
|
||||
vi.useRealTimers();
|
||||
});
|
||||
|
||||
it('读取指数并返回统一快照元数据', async () => {
|
||||
const client = { request: vi.fn().mockResolvedValue(indexResult) };
|
||||
const service = new MarketOverviewService(client);
|
||||
|
||||
const response = await service.getIndices();
|
||||
|
||||
expect(response).toMatchObject({
|
||||
source: 'tdx',
|
||||
status: 'fresh',
|
||||
data: { items: expect.any(Array) },
|
||||
});
|
||||
expect(response.snapshotId).toMatch(/^20260818-/);
|
||||
expect(client.request).toHaveBeenCalledWith(
|
||||
'get_market_data',
|
||||
expect.objectContaining({ count: 5 }),
|
||||
);
|
||||
});
|
||||
|
||||
it('核心指数交易日旧于上海当前日期时标记 delayed', async () => {
|
||||
vi.setSystemTime(new Date('2026-08-19T03:00:00.000Z'));
|
||||
const client = { request: vi.fn().mockResolvedValue(indexResult) };
|
||||
const service = new MarketOverviewService(client);
|
||||
|
||||
const response = await service.getIndices();
|
||||
|
||||
expect(response.status).toBe('delayed');
|
||||
expect(response.warnings).toEqual(['核心指数交易日期为 20260818，非当前日期']);
|
||||
});
|
||||
|
||||
it('汇总三个市场指数的上涨和下跌家数并保留未知平盘数', async () => {
|
||||
const client = {
|
||||
request: vi
|
||||
.fn()
|
||||
.mockResolvedValueOnce(breadthSnapshot('10', '5'))
|
||||
.mockResolvedValueOnce(breadthSnapshot('20', '15'))
|
||||
.mockResolvedValueOnce(breadthSnapshot('3', '2'))
|
||||
.mockResolvedValueOnce(indexResult),
|
||||
};
|
||||
const service = new MarketOverviewService(client);
|
||||
|
||||
const response = await service.getBreadth();
|
||||
|
||||
expect(response).toMatchObject({
|
||||
source: 'tdx',
|
||||
status: 'fresh',
|
||||
data: { advancing: 33, declining: 22, unchanged: null },
|
||||
});
|
||||
expect(client.request).toHaveBeenCalledWith(
|
||||
'get_market_snapshot',
|
||||
expect.objectContaining({ stock_code: '000001.SH' }),
|
||||
);
|
||||
});
|
||||
|
||||
it('市场宽度排除畸形快照并标记部分数据', async () => {
|
||||
const client = {
|
||||
request: vi
|
||||
.fn()
|
||||
.mockResolvedValueOnce(breadthSnapshot('10', '5'))
|
||||
.mockResolvedValueOnce({ ErrorId: '0', UpHome: '', DownHome: '3' })
|
||||
.mockRejectedValueOnce(new Error('raw network detail'))
|
||||
.mockResolvedValueOnce(indexResult),
|
||||
};
|
||||
const service = new MarketOverviewService(client);
|
||||
|
||||
const response = await service.getBreadth();
|
||||
|
||||
expect(response).toMatchObject({
|
||||
status: 'partial',
|
||||
data: { advancing: 10, declining: 5, unchanged: null },
|
||||
});
|
||||
expect(response.warnings[0]).toContain('深证市场、北证市场');
|
||||
expect(response.warnings.join(' ')).not.toContain('raw network detail');
|
||||
});
|
||||
|
||||
it('市场宽度使用核心指数交易日识别 delayed，不把旧快照标为 fresh', async () => {
|
||||
const staleIndexResult = structuredClone(indexResult);
|
||||
staleIndexResult.Value['000001.SH'].Date = ['20260816', '20260817'];
|
||||
const client = {
|
||||
request: vi
|
||||
.fn()
|
||||
.mockResolvedValueOnce(breadthSnapshot('10', '5'))
|
||||
.mockResolvedValueOnce(breadthSnapshot('20', '15'))
|
||||
.mockResolvedValueOnce(breadthSnapshot('3', '2'))
|
||||
.mockResolvedValueOnce(staleIndexResult),
|
||||
};
|
||||
const service = new MarketOverviewService(client);
|
||||
|
||||
const response = await service.getBreadth();
|
||||
|
||||
expect(response.status).toBe('delayed');
|
||||
expect(response.warnings).toEqual(['市场宽度交易日期为 20260817，非当前日期']);
|
||||
});
|
||||
|
||||
it('按一级行业涨跌幅排序板块并保留 TDX 代码', async () => {
|
||||
const client = {
|
||||
request: vi.fn().mockResolvedValueOnce(sectorResult).mockResolvedValueOnce(sectorKlineResult),
|
||||
};
|
||||
const service = new MarketOverviewService(client);
|
||||
|
||||
const response = await service.getSectors();
|
||||
|
||||
expect(response).toMatchObject({
|
||||
source: 'tdx',
|
||||
status: 'fresh',
|
||||
data: {
|
||||
items: [
|
||||
expect.objectContaining({ code: '881319.SH', name: '半导体', changePercent: 8 }),
|
||||
expect.objectContaining({ code: '881355.SH', name: '软件服务', changePercent: -4 }),
|
||||
],
|
||||
},
|
||||
});
|
||||
expect(client.request).toHaveBeenNthCalledWith(1, 'get_stock_list', {
|
||||
market: '16',
|
||||
list_type: 1,
|
||||
});
|
||||
});
|
||||
|
||||
it('一级行业目录为空时返回不可用而不是 fresh 空数据', async () => {
|
||||
const client = { request: vi.fn().mockResolvedValue({ ErrorId: '0', Value: [] }) };
|
||||
const service = new MarketOverviewService(client);
|
||||
|
||||
const response = await service.getSectors();
|
||||
|
||||
expect(response).toMatchObject({ status: 'unavailable', data: null });
|
||||
expect(response.warnings).toEqual(['一级行业目录为空']);
|
||||
expect(client.request).toHaveBeenCalledTimes(1);
|
||||
});
|
||||
|
||||
it('一级行业强弱结果最多展示前八项', async () => {
|
||||
const definitions = Array.from({ length: 9 }, (_, index) => ({
|
||||
Code: `88100${index}.SH`,
|
||||
Name: `行业${index}`,
|
||||
}));
|
||||
const value = Object.fromEntries(
|
||||
definitions.map(({ Code }, index) => [
|
||||
Code,
|
||||
{
|
||||
...indexSeries,
|
||||
Close: ['100', `${101 + index}`],
|
||||
},
|
||||
]),
|
||||
);
|
||||
const client = {
|
||||
request: vi
|
||||
.fn()
|
||||
.mockResolvedValueOnce({ ErrorId: '0', Value: definitions })
|
||||
.mockResolvedValueOnce({ ErrorId: '0', Value: value }),
|
||||
};
|
||||
const service = new MarketOverviewService(client);
|
||||
|
||||
const response = await service.getSectors();
|
||||
|
||||
expect(response.status).toBe('fresh');
|
||||
expect(response.data?.items).toHaveLength(8);
|
||||
expect(response.data?.items[0].name).toBe('行业8');
|
||||
});
|
||||
|
||||
it('一级行业混合交易日时返回 partial，不把不同日期误标 fresh', async () => {
|
||||
const mixedDates = structuredClone(sectorKlineResult);
|
||||
mixedDates.Value['881355.SH'].Date = ['20260818', '20260819'];
|
||||
const client = {
|
||||
request: vi.fn().mockResolvedValueOnce(sectorResult).mockResolvedValueOnce(mixedDates),
|
||||
};
|
||||
const service = new MarketOverviewService(client);
|
||||
|
||||
const response = await service.getSectors();
|
||||
|
||||
expect(response).toMatchObject({
|
||||
status: 'partial',
|
||||
data: { items: [expect.objectContaining({ code: '881355.SH', tradeDate: '20260819' })] },
|
||||
});
|
||||
expect(response.warnings).toEqual(['部分一级行业未返回有效行情']);
|
||||
});
|
||||
|
||||
it('一级行业交易日旧于上海当前日期时标记 delayed', async () => {
|
||||
vi.setSystemTime(new Date('2026-08-19T03:00:00.000Z'));
|
||||
const client = {
|
||||
request: vi.fn().mockResolvedValueOnce(sectorResult).mockResolvedValueOnce(sectorKlineResult),
|
||||
};
|
||||
const service = new MarketOverviewService(client);
|
||||
|
||||
const response = await service.getSectors();
|
||||
|
||||
expect(response.status).toBe('delayed');
|
||||
expect(response.warnings).toEqual(['一级行业交易日期为 20260818，非当前日期']);
|
||||
});
|
||||
|
||||
it('按交易所指数成交额计算亿元级趋势而不宣称主力净流入', async () => {
|
||||
const client = { request: vi.fn().mockResolvedValue(turnoverResult) };
|
||||
const service = new MarketOverviewService(client);
|
||||
|
||||
const response = await service.getFunds();
|
||||
|
||||
expect(response).toMatchObject({
|
||||
source: 'tdx',
|
||||
status: 'fresh',
|
||||
data: {
|
||||
currentAmount: 36,
|
||||
previousAmount: 30,
|
||||
changePercent: 20,
|
||||
unit: '亿元',
|
||||
marketCount: 3,
|
||||
tradeDate: '20260818',
|
||||
previousTradeDate: '20260817',
|
||||
},
|
||||
});
|
||||
expect(response.warnings).toEqual([]);
|
||||
});
|
||||
|
||||
it('成交额缺少一个市场时标记 partial 并展示实际市场数', async () => {
|
||||
const partialResult = structuredClone(turnoverResult);
|
||||
delete partialResult.Value['899050.BJ'];
|
||||
const client = { request: vi.fn().mockResolvedValue(partialResult) };
|
||||
const service = new MarketOverviewService(client);
|
||||
|
||||
const response = await service.getFunds();
|
||||
|
||||
expect(response).toMatchObject({
|
||||
status: 'partial',
|
||||
data: { currentAmount: 24, previousAmount: 20, marketCount: 2, tradeDate: '20260818' },
|
||||
});
|
||||
expect(response.warnings).toEqual(['部分市场成交额不可用，当前汇总 2 个市场']);
|
||||
});
|
||||
|
||||
it('成交额交易日旧于上海当前日期时标记 delayed', async () => {
|
||||
vi.setSystemTime(new Date('2026-08-19T03:00:00.000Z'));
|
||||
const client = { request: vi.fn().mockResolvedValue(turnoverResult) };
|
||||
const service = new MarketOverviewService(client);
|
||||
|
||||
const response = await service.getFunds();
|
||||
|
||||
expect(response.status).toBe('delayed');
|
||||
expect(response.warnings).toEqual(['成交额交易日期为 20260818，非当前日期']);
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,301 @@
|
||||
import { Inject, Injectable } from '@nestjs/common';
|
||||
|
||||
import type {
|
||||
BreadthDataDto,
|
||||
FundDataDto,
|
||||
IndicesDataDto,
|
||||
SectorDataDto,
|
||||
SummaryDataDto,
|
||||
} from './market-overview.dto';
|
||||
import { CORE_INDEXES } from './tdx/tdx.types';
|
||||
import {
|
||||
mapBreadthSnapshots,
|
||||
mapIndexQuotes,
|
||||
mapSectorQuotes,
|
||||
mapTurnoverTrend,
|
||||
} from './tdx/tdx.mapper';
|
||||
import { TdxClientError, type TdxClient } from './tdx/tdx.client';
|
||||
import type {
|
||||
TdxMarketDataResult,
|
||||
TdxMarketSnapshotResult,
|
||||
TdxStockListResult,
|
||||
} from './tdx/tdx.types';
|
||||
import { BREADTH_INDEXES, TURNOVER_INDEXES } from './tdx/tdx.types';
|
||||
|
||||
export const TDX_CLIENT_PORT = Symbol('TDX_CLIENT_PORT');
|
||||
|
||||
export type MarketOverviewResponse<TData> = {
|
||||
snapshotId: string;
|
||||
asOf: string;
|
||||
source: 'tdx';
|
||||
status: 'fresh' | 'delayed' | 'partial' | 'unavailable';
|
||||
data: TData | null;
|
||||
warnings: string[];
|
||||
};
|
||||
|
||||
function createSnapshotMeta(): Pick<
|
||||
MarketOverviewResponse<never>,
|
||||
'snapshotId' | 'asOf' | 'source'
|
||||
> {
|
||||
const asOf = new Date().toISOString();
|
||||
const snapshotId = `${asOf.slice(0, 10).replaceAll('-', '')}-${asOf.slice(11, 19).replaceAll(':', '')}`;
|
||||
return { snapshotId, asOf, source: 'tdx' };
|
||||
}
|
||||
|
||||
/** 交易日状态统一按上海日历判断；休市日保守标记 delayed，避免把历史值冒充实时。 */
|
||||
function getShanghaiCalendarDate(asOf: string): string {
|
||||
const parts = new Intl.DateTimeFormat('en-US', {
|
||||
timeZone: 'Asia/Shanghai',
|
||||
year: 'numeric',
|
||||
month: '2-digit',
|
||||
day: '2-digit',
|
||||
}).formatToParts(new Date(asOf));
|
||||
const values = Object.fromEntries(parts.map((part) => [part.type, part.value]));
|
||||
return `${values.year}${values.month}${values.day}`;
|
||||
}
|
||||
|
||||
function createTradeDateWarning(subject: string, tradeDate: string | undefined, asOf: string) {
|
||||
if (!tradeDate) return `${subject}交易日期无法确认`;
|
||||
return tradeDate === getShanghaiCalendarDate(asOf)
|
||||
? null
|
||||
: `${subject}交易日期为 ${tradeDate}，非当前日期`;
|
||||
}
|
||||
|
||||
@Injectable()
|
||||
export class MarketOverviewService {
|
||||
constructor(@Inject(TDX_CLIENT_PORT) private readonly tdxClient: TdxClient) {}
|
||||
|
||||
async getIndices(): Promise<MarketOverviewResponse<IndicesDataDto>> {
|
||||
const meta = createSnapshotMeta();
|
||||
try {
|
||||
const result = await this.tdxClient.request<TdxMarketDataResult>('get_market_data', {
|
||||
stock_list: CORE_INDEXES.map((item) => item.code),
|
||||
count: 5,
|
||||
dividend_type: 'none',
|
||||
period: '1d',
|
||||
});
|
||||
const items = mapIndexQuotes(result, CORE_INDEXES);
|
||||
const tradeDateWarning = createTradeDateWarning('核心指数', items[0]?.tradeDate, meta.asOf);
|
||||
const status =
|
||||
items.length !== CORE_INDEXES.length ? 'partial' : tradeDateWarning ? 'delayed' : 'fresh';
|
||||
return {
|
||||
...meta,
|
||||
status,
|
||||
data: { items },
|
||||
warnings:
|
||||
status === 'partial'
|
||||
? ['部分核心指数未返回有效数据']
|
||||
: tradeDateWarning
|
||||
? [tradeDateWarning]
|
||||
: [],
|
||||
};
|
||||
} catch (error) {
|
||||
return {
|
||||
...meta,
|
||||
status: 'unavailable',
|
||||
data: null,
|
||||
warnings: [this.toWarning(error, '核心指数')],
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
async getSummary(): Promise<MarketOverviewResponse<SummaryDataDto>> {
|
||||
const indices = await this.getIndices();
|
||||
if (indices.status === 'unavailable' || !indices.data) {
|
||||
return { ...indices, data: null };
|
||||
}
|
||||
|
||||
const changes = indices.data.items
|
||||
.map((item) => item.changePercent)
|
||||
.filter((value): value is number => value !== null);
|
||||
const averageChange = changes.length
|
||||
? Math.round((changes.reduce((sum, value) => sum + value, 0) / changes.length) * 100) / 100
|
||||
: null;
|
||||
const marketStatus =
|
||||
averageChange === null ? '指数数据不完整' : averageChange >= 0 ? '指数偏强' : '指数偏弱';
|
||||
const summary: SummaryDataDto = {
|
||||
verdict:
|
||||
averageChange === null
|
||||
? '市场状态待确认'
|
||||
: averageChange >= 0
|
||||
? '市场维持偏强震荡'
|
||||
: '市场维持偏弱震荡',
|
||||
marketStatus,
|
||||
volumeStatus: '成交额趋势见下方',
|
||||
sentimentStatus: '涨跌家数见下方',
|
||||
drivers: changes.length ? [`核心指数平均涨跌幅 ${averageChange}%`] : ['核心指数数据不足'],
|
||||
risks: ['主力净流入和盘中新闻仍待补充数据源验证'],
|
||||
};
|
||||
return { ...indices, data: summary };
|
||||
}
|
||||
|
||||
async getBreadth(): Promise<MarketOverviewResponse<BreadthDataDto>> {
|
||||
const meta = createSnapshotMeta();
|
||||
const [results, [referenceResult]] = await Promise.all([
|
||||
Promise.allSettled(
|
||||
BREADTH_INDEXES.map((item) =>
|
||||
this.tdxClient.request<TdxMarketSnapshotResult>('get_market_snapshot', {
|
||||
stock_code: item.code,
|
||||
}),
|
||||
),
|
||||
),
|
||||
Promise.allSettled([
|
||||
this.tdxClient.request<TdxMarketDataResult>('get_market_data', {
|
||||
stock_list: [CORE_INDEXES[0].code],
|
||||
count: 1,
|
||||
dividend_type: 'none',
|
||||
period: '1d',
|
||||
}),
|
||||
]),
|
||||
]);
|
||||
const validSnapshots = results.flatMap((result) => {
|
||||
if (result.status === 'rejected') return [];
|
||||
return mapBreadthSnapshots([result.value]).validCount === 1 ? [result.value] : [];
|
||||
});
|
||||
const mapped = mapBreadthSnapshots(validSnapshots);
|
||||
const unavailableMarkets = BREADTH_INDEXES.filter((_, index) => {
|
||||
const result = results[index];
|
||||
return (
|
||||
!result ||
|
||||
result.status === 'rejected' ||
|
||||
mapBreadthSnapshots([result.value]).validCount === 0
|
||||
);
|
||||
}).map((item) => item.name);
|
||||
if (!mapped.data) {
|
||||
return {
|
||||
...meta,
|
||||
status: 'unavailable',
|
||||
data: null,
|
||||
warnings: [`市场宽度数据不可用：${unavailableMarkets.join('、')}`],
|
||||
};
|
||||
}
|
||||
const referenceTradeDate =
|
||||
referenceResult?.status === 'fulfilled'
|
||||
? mapIndexQuotes(referenceResult.value, [CORE_INDEXES[0]])[0]?.tradeDate
|
||||
: undefined;
|
||||
const tradeDateWarning = createTradeDateWarning('市场宽度', referenceTradeDate, meta.asOf);
|
||||
const status =
|
||||
mapped.validCount !== BREADTH_INDEXES.length
|
||||
? 'partial'
|
||||
: tradeDateWarning
|
||||
? 'delayed'
|
||||
: 'fresh';
|
||||
return {
|
||||
...meta,
|
||||
status,
|
||||
data: mapped.data,
|
||||
warnings:
|
||||
status === 'partial'
|
||||
? [`部分市场涨跌家数不可用：${unavailableMarkets.join('、')}`]
|
||||
: tradeDateWarning
|
||||
? [tradeDateWarning]
|
||||
: [],
|
||||
};
|
||||
}
|
||||
|
||||
async getSectors(): Promise<MarketOverviewResponse<SectorDataDto>> {
|
||||
const meta = createSnapshotMeta();
|
||||
try {
|
||||
const catalog = await this.tdxClient.request<TdxStockListResult>('get_stock_list', {
|
||||
market: '16',
|
||||
list_type: 1,
|
||||
});
|
||||
const definitions = catalog.Value.map(({ Code: code, Name: name }) => ({ code, name }));
|
||||
if (!definitions.length) {
|
||||
return {
|
||||
...meta,
|
||||
status: 'unavailable',
|
||||
data: null,
|
||||
warnings: ['一级行业目录为空'],
|
||||
};
|
||||
}
|
||||
const result = await this.tdxClient.request<TdxMarketDataResult>('get_market_data', {
|
||||
stock_list: definitions.map((item) => item.code),
|
||||
count: 2,
|
||||
dividend_type: 'none',
|
||||
period: '1d',
|
||||
});
|
||||
const mappedItems = mapSectorQuotes(result, definitions);
|
||||
const items = mappedItems.slice(0, 8);
|
||||
const tradeDateWarning = createTradeDateWarning(
|
||||
'一级行业',
|
||||
mappedItems[0]?.tradeDate,
|
||||
meta.asOf,
|
||||
);
|
||||
const status =
|
||||
mappedItems.length === 0
|
||||
? 'unavailable'
|
||||
: mappedItems.length !== definitions.length
|
||||
? 'partial'
|
||||
: tradeDateWarning
|
||||
? 'delayed'
|
||||
: 'fresh';
|
||||
return {
|
||||
...meta,
|
||||
status,
|
||||
data: items.length ? { items } : null,
|
||||
warnings:
|
||||
status === 'fresh'
|
||||
? []
|
||||
: status === 'partial'
|
||||
? ['部分一级行业未返回有效行情']
|
||||
: status === 'delayed' && tradeDateWarning
|
||||
? [tradeDateWarning]
|
||||
: ['一级行业行情不可用'],
|
||||
};
|
||||
} catch (error) {
|
||||
return {
|
||||
...meta,
|
||||
status: 'unavailable',
|
||||
data: null,
|
||||
warnings: [this.toWarning(error, '板块行情')],
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
async getFunds(): Promise<MarketOverviewResponse<FundDataDto>> {
|
||||
const meta = createSnapshotMeta();
|
||||
try {
|
||||
const result = await this.tdxClient.request<TdxMarketDataResult>('get_market_data', {
|
||||
stock_list: TURNOVER_INDEXES.map((item) => item.code),
|
||||
count: 2,
|
||||
dividend_type: 'none',
|
||||
period: '1d',
|
||||
});
|
||||
const mapped = mapTurnoverTrend(result, TURNOVER_INDEXES);
|
||||
if (!mapped.data)
|
||||
return { ...meta, status: 'unavailable', data: null, warnings: ['成交额趋势数据不完整'] };
|
||||
const tradeDateWarning = createTradeDateWarning('成交额', mapped.data.tradeDate, meta.asOf);
|
||||
const status =
|
||||
mapped.validMarketCount !== TURNOVER_INDEXES.length
|
||||
? 'partial'
|
||||
: tradeDateWarning
|
||||
? 'delayed'
|
||||
: 'fresh';
|
||||
return {
|
||||
...meta,
|
||||
status,
|
||||
data: mapped.data,
|
||||
warnings:
|
||||
status === 'partial'
|
||||
? [`部分市场成交额不可用，当前汇总 ${mapped.validMarketCount} 个市场`]
|
||||
: tradeDateWarning
|
||||
? [tradeDateWarning]
|
||||
: [],
|
||||
};
|
||||
} catch (error) {
|
||||
return {
|
||||
...meta,
|
||||
status: 'unavailable',
|
||||
data: null,
|
||||
warnings: [this.toWarning(error, '成交额趋势')],
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
private toWarning(error: unknown, subject: string): string {
|
||||
if (error instanceof TdxClientError && error.kind === 'timeout') return `${subject}请求超时`;
|
||||
if (error instanceof TdxClientError && error.kind === 'network') return `${subject}网络不可用`;
|
||||
return `${subject}数据不可用`;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,78 @@
|
||||
import { describe, expect, it, vi } from 'vitest';
|
||||
|
||||
import { createTdxClient } from './tdx.client';
|
||||
|
||||
function response(body: unknown, init?: ResponseInit): Response {
|
||||
return new Response(JSON.stringify(body), {
|
||||
status: 200,
|
||||
headers: { 'content-type': 'application/json' },
|
||||
...init,
|
||||
});
|
||||
}
|
||||
|
||||
describe('TDX 客户端', () => {
|
||||
it('发送固定 JSON 请求并返回业务结果', async () => {
|
||||
const fetchImpl = vi
|
||||
.fn<typeof fetch>()
|
||||
.mockResolvedValue(response({ id: 1, result: { ErrorId: '0', Value: {} } }));
|
||||
const client = createTdxClient({
|
||||
baseUrl: 'http://127.0.0.1:17710',
|
||||
timeoutMs: 5_000,
|
||||
fetchImpl,
|
||||
});
|
||||
|
||||
await expect(client.request('get_market_data', { stock_list: ['600519.SH'] })).resolves.toEqual(
|
||||
{
|
||||
ErrorId: '0',
|
||||
Value: {},
|
||||
},
|
||||
);
|
||||
|
||||
expect(fetchImpl).toHaveBeenCalledWith(
|
||||
'http://127.0.0.1:17710/',
|
||||
expect.objectContaining({
|
||||
method: 'POST',
|
||||
headers: { 'content-type': 'application/json' },
|
||||
}),
|
||||
);
|
||||
const request = fetchImpl.mock.calls[0]?.[1];
|
||||
expect(JSON.parse(String(request?.body))).toMatchObject({
|
||||
id: 1,
|
||||
method: 'get_market_data',
|
||||
params: { stock_list: ['600519.SH'] },
|
||||
});
|
||||
});
|
||||
|
||||
it('将 TDX 错误响应转换为脱敏协议错误', async () => {
|
||||
const fetchImpl = vi
|
||||
.fn<typeof fetch>()
|
||||
.mockResolvedValue(
|
||||
response({ id: 1, error: { code: 'bad_request', message: '内部连接信息' } }),
|
||||
);
|
||||
const client = createTdxClient({
|
||||
baseUrl: 'http://127.0.0.1:17710',
|
||||
timeoutMs: 5_000,
|
||||
fetchImpl,
|
||||
});
|
||||
|
||||
const firstError = client.request('get_market_data', {});
|
||||
await expect(firstError).rejects.toMatchObject({
|
||||
kind: 'protocol',
|
||||
message: 'TDX 返回业务错误',
|
||||
});
|
||||
await expect(firstError).rejects.not.toThrow('内部连接信息');
|
||||
});
|
||||
|
||||
it('将 AbortError 转换为超时错误', async () => {
|
||||
const fetchImpl = vi
|
||||
.fn<typeof fetch>()
|
||||
.mockRejectedValue(new DOMException('aborted', 'AbortError'));
|
||||
const client = createTdxClient({
|
||||
baseUrl: 'http://127.0.0.1:17710',
|
||||
timeoutMs: 50,
|
||||
fetchImpl,
|
||||
});
|
||||
|
||||
await expect(client.request('get_market_data', {})).rejects.toMatchObject({ kind: 'timeout' });
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,101 @@
|
||||
import type { TdxRuntimeConfig } from '../../../../../libs/config/src/runtime-config';
|
||||
|
||||
export type TdxClientErrorKind = 'timeout' | 'network' | 'protocol' | 'unavailable';
|
||||
|
||||
export class TdxClientError extends Error {
|
||||
constructor(
|
||||
readonly kind: TdxClientErrorKind,
|
||||
message: string,
|
||||
) {
|
||||
super(message);
|
||||
this.name = 'TdxClientError';
|
||||
}
|
||||
}
|
||||
|
||||
export interface TdxClient {
|
||||
request<TResponse>(method: string, params: Record<string, unknown>): Promise<TResponse>;
|
||||
}
|
||||
|
||||
export interface TdxClientOptions extends TdxRuntimeConfig {
|
||||
fetchImpl?: typeof fetch;
|
||||
maxResponseBytes?: number;
|
||||
}
|
||||
|
||||
interface TdxRpcEnvelope<TResponse> {
|
||||
id?: number;
|
||||
result?: TResponse;
|
||||
error?: unknown;
|
||||
}
|
||||
|
||||
const DEFAULT_MAX_RESPONSE_BYTES = 1 * 1024 * 1024;
|
||||
|
||||
function isAbortError(error: unknown): boolean {
|
||||
return error instanceof Error && error.name === 'AbortError';
|
||||
}
|
||||
|
||||
function hasBusinessError(value: unknown): boolean {
|
||||
if (!value || typeof value !== 'object') return false;
|
||||
const record = value as Record<string, unknown>;
|
||||
return 'ErrorId' in record && record.ErrorId !== '0' && record.ErrorId !== 0;
|
||||
}
|
||||
|
||||
/**
|
||||
* 将 TDX 的 JSON-RPC/业务错误限制在客户端边界内，避免 URL、请求头和原始载荷进入上层异常。
|
||||
*/
|
||||
export function createTdxClient({
|
||||
baseUrl,
|
||||
timeoutMs,
|
||||
fetchImpl = fetch,
|
||||
maxResponseBytes = DEFAULT_MAX_RESPONSE_BYTES,
|
||||
}: TdxClientOptions): TdxClient {
|
||||
const endpoint = `${baseUrl.replace(/\/$/, '')}/`;
|
||||
let requestId = 0;
|
||||
|
||||
return {
|
||||
async request<TResponse>(method: string, params: Record<string, unknown>): Promise<TResponse> {
|
||||
const controller = new AbortController();
|
||||
const timeout = setTimeout(() => controller.abort(), timeoutMs);
|
||||
|
||||
try {
|
||||
const response = await fetchImpl(endpoint, {
|
||||
method: 'POST',
|
||||
headers: { 'content-type': 'application/json' },
|
||||
body: JSON.stringify({ id: ++requestId, method, params }),
|
||||
signal: controller.signal,
|
||||
});
|
||||
|
||||
const contentLength = response.headers.get('content-length');
|
||||
if (contentLength && Number(contentLength) > maxResponseBytes) {
|
||||
throw new TdxClientError('protocol', 'TDX 响应体超过安全上限');
|
||||
}
|
||||
|
||||
const text = await response.text();
|
||||
if (Buffer.byteLength(text, 'utf8') > maxResponseBytes) {
|
||||
throw new TdxClientError('protocol', 'TDX 响应体超过安全上限');
|
||||
}
|
||||
if (!response.ok) throw new TdxClientError('unavailable', 'TDX 服务不可用');
|
||||
|
||||
let envelope: TdxRpcEnvelope<TResponse>;
|
||||
try {
|
||||
envelope = JSON.parse(text) as TdxRpcEnvelope<TResponse>;
|
||||
} catch {
|
||||
throw new TdxClientError('protocol', 'TDX 返回格式错误');
|
||||
}
|
||||
|
||||
if (envelope.error !== undefined || envelope.result === undefined) {
|
||||
throw new TdxClientError('protocol', 'TDX 返回业务错误');
|
||||
}
|
||||
if (hasBusinessError(envelope.result)) {
|
||||
throw new TdxClientError('protocol', 'TDX 返回业务错误');
|
||||
}
|
||||
return envelope.result;
|
||||
} catch (error) {
|
||||
if (error instanceof TdxClientError) throw error;
|
||||
if (isAbortError(error)) throw new TdxClientError('timeout', 'TDX 请求超时');
|
||||
throw new TdxClientError('network', 'TDX 网络请求失败');
|
||||
} finally {
|
||||
clearTimeout(timeout);
|
||||
}
|
||||
},
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,461 @@
|
||||
import { describe, expect, it } from 'vitest';
|
||||
|
||||
import {
|
||||
mapBreadthSnapshots,
|
||||
mapIndexQuotes,
|
||||
mapSectorQuotes,
|
||||
mapTurnoverTrend,
|
||||
} from './tdx.mapper';
|
||||
|
||||
describe('TDX 行情映射', () => {
|
||||
it('将 K 线数组转换为 A 股红涨绿跌的指数报价', () => {
|
||||
const result = mapIndexQuotes(
|
||||
{
|
||||
ErrorId: '0',
|
||||
Value: {
|
||||
'000001.SH': {
|
||||
Date: ['20260817', '20260818'],
|
||||
Open: ['3350.00', '3370.00'],
|
||||
High: ['3385.00', '3400.00'],
|
||||
Low: ['3340.00', '3360.00'],
|
||||
Close: ['3360.00', '3380.16'],
|
||||
Amount: ['100', '120'],
|
||||
Volume: ['1000', '1100'],
|
||||
},
|
||||
},
|
||||
},
|
||||
[{ code: '000001.SH', name: '上证指数' }],
|
||||
);
|
||||
|
||||
expect(result).toEqual([
|
||||
expect.objectContaining({
|
||||
code: '000001.SH',
|
||||
name: '上证指数',
|
||||
price: 3380.16,
|
||||
changePercent: 0.6,
|
||||
direction: 'up',
|
||||
tradeDate: '20260818',
|
||||
}),
|
||||
]);
|
||||
});
|
||||
|
||||
it('缺少前一日收盘价时标记为平盘并保留当前价', () => {
|
||||
const result = mapIndexQuotes(
|
||||
{
|
||||
ErrorId: '0',
|
||||
Value: {
|
||||
'399006.SZ': {
|
||||
Date: ['20260818'],
|
||||
Open: ['2100.00'],
|
||||
High: ['2110.00'],
|
||||
Low: ['2090.00'],
|
||||
Close: ['2105.00'],
|
||||
Amount: ['100'],
|
||||
Volume: ['1000'],
|
||||
},
|
||||
},
|
||||
},
|
||||
[{ code: '399006.SZ', name: '创业板指' }],
|
||||
);
|
||||
|
||||
expect(result[0]).toMatchObject({ price: 2105, changePercent: null, direction: 'flat' });
|
||||
});
|
||||
|
||||
it.each([
|
||||
['非法公历日期', ['20269999', '20260818']],
|
||||
['重复日期', ['20260818', '20260818']],
|
||||
['倒序日期', ['20260819', '20260818']],
|
||||
])('前一根 K 线为%s时保留指数当前价但不计算涨跌', (_caseName, dates) => {
|
||||
const result = mapIndexQuotes(
|
||||
{
|
||||
ErrorId: '0',
|
||||
Value: {
|
||||
'000001.SH': {
|
||||
Date: dates,
|
||||
Open: ['100', '200'],
|
||||
High: ['100', '200'],
|
||||
Low: ['100', '200'],
|
||||
Close: ['100', '200'],
|
||||
Amount: ['1', '1'],
|
||||
Volume: ['1', '1'],
|
||||
},
|
||||
},
|
||||
},
|
||||
[{ code: '000001.SH', name: '上证指数' }],
|
||||
);
|
||||
|
||||
expect(result).toEqual([
|
||||
expect.objectContaining({
|
||||
code: '000001.SH',
|
||||
price: 200,
|
||||
changePercent: null,
|
||||
direction: 'flat',
|
||||
tradeDate: '20260818',
|
||||
}),
|
||||
]);
|
||||
});
|
||||
|
||||
it('市场宽度映射只汇总可用的上涨和下跌家数', () => {
|
||||
expect(
|
||||
mapBreadthSnapshots([
|
||||
{ UpHome: '10', DownHome: '5' },
|
||||
{ UpHome: '2', DownHome: '3' },
|
||||
]),
|
||||
).toEqual({
|
||||
data: { advancing: 12, declining: 8, unchanged: null },
|
||||
validCount: 2,
|
||||
});
|
||||
});
|
||||
|
||||
it('市场宽度排除字段缺失、非数值和负数的快照', () => {
|
||||
expect(
|
||||
mapBreadthSnapshots([
|
||||
{ UpHome: '10', DownHome: '5' },
|
||||
{ UpHome: '', DownHome: '3' },
|
||||
{ UpHome: 'NaN', DownHome: '2' },
|
||||
{ UpHome: '-1', DownHome: '2' },
|
||||
]),
|
||||
).toEqual({
|
||||
data: { advancing: 10, declining: 5, unchanged: null },
|
||||
validCount: 1,
|
||||
});
|
||||
});
|
||||
|
||||
it('市场宽度拒绝小数和十六进制字符串，避免把非计数值纳入汇总', () => {
|
||||
expect(
|
||||
mapBreadthSnapshots([
|
||||
{ UpHome: '1.5', DownHome: '5' },
|
||||
{ UpHome: '0x10', DownHome: '2' },
|
||||
{ UpHome: '1e3', DownHome: '2' },
|
||||
{ UpHome: '9007199254740992', DownHome: '2' },
|
||||
{ UpHome: '10', DownHome: '5' },
|
||||
]),
|
||||
).toEqual({
|
||||
data: { advancing: 10, declining: 5, unchanged: null },
|
||||
validCount: 1,
|
||||
});
|
||||
});
|
||||
|
||||
it('核心指数混合交易日时只保留最新交易日，避免跨日组合', () => {
|
||||
const result = mapIndexQuotes(
|
||||
{
|
||||
ErrorId: '0',
|
||||
Value: {
|
||||
'000001.SH': {
|
||||
Date: ['20260817', '20260818'],
|
||||
Open: ['1', '1'],
|
||||
High: ['1', '1'],
|
||||
Low: ['1', '1'],
|
||||
Close: ['100', '102'],
|
||||
Amount: ['1', '1'],
|
||||
Volume: ['1', '1'],
|
||||
},
|
||||
'399001.SZ': {
|
||||
Date: ['20260818', '20260819'],
|
||||
Open: ['1', '1'],
|
||||
High: ['1', '1'],
|
||||
Low: ['1', '1'],
|
||||
Close: ['100', '101'],
|
||||
Amount: ['1', '1'],
|
||||
Volume: ['1', '1'],
|
||||
},
|
||||
},
|
||||
},
|
||||
[
|
||||
{ code: '000001.SH', name: '旧日期指数' },
|
||||
{ code: '399001.SZ', name: '最新日期指数' },
|
||||
],
|
||||
);
|
||||
|
||||
expect(result).toEqual([expect.objectContaining({ code: '399001.SZ', tradeDate: '20260819' })]);
|
||||
});
|
||||
|
||||
it('核心指数拒绝不存在的公历日期，避免畸形日期抢占最新截面', () => {
|
||||
const series = (dates: string[], close: string[]) => ({
|
||||
Date: dates,
|
||||
Open: close,
|
||||
High: close,
|
||||
Low: close,
|
||||
Close: close,
|
||||
Amount: ['1', '1'],
|
||||
Volume: ['1', '1'],
|
||||
});
|
||||
|
||||
expect(
|
||||
mapIndexQuotes(
|
||||
{
|
||||
ErrorId: '0',
|
||||
Value: {
|
||||
'000001.SH': series(['20260817', '20260818'], ['100', '102']),
|
||||
'399001.SZ': series(['20269898', '20269999'], ['100', '101']),
|
||||
},
|
||||
},
|
||||
[
|
||||
{ code: '000001.SH', name: '有效日期指数' },
|
||||
{ code: '399001.SZ', name: '畸形日期指数' },
|
||||
],
|
||||
),
|
||||
).toEqual([expect.objectContaining({ code: '000001.SH', tradeDate: '20260818' })]);
|
||||
});
|
||||
|
||||
it('板块只保留有两个交易日和有效涨跌幅的精确字段', () => {
|
||||
const result = mapSectorQuotes(
|
||||
{
|
||||
ErrorId: '0',
|
||||
Value: {
|
||||
'881001.SH': {
|
||||
Date: ['20260817', '20260818'],
|
||||
Open: ['1', '1'],
|
||||
High: ['1', '1'],
|
||||
Low: ['1', '1'],
|
||||
Close: ['100', '102'],
|
||||
Amount: ['1', '1'],
|
||||
Volume: ['1', '1'],
|
||||
},
|
||||
'881002.SH': {
|
||||
Date: ['20260818'],
|
||||
Open: ['1'],
|
||||
High: ['1'],
|
||||
Low: ['1'],
|
||||
Close: ['100'],
|
||||
Amount: ['1'],
|
||||
Volume: ['1'],
|
||||
},
|
||||
},
|
||||
},
|
||||
[
|
||||
{ code: '881001.SH', name: '行业一' },
|
||||
{ code: '881002.SH', name: '行业二' },
|
||||
],
|
||||
);
|
||||
|
||||
expect(result).toEqual([
|
||||
{
|
||||
code: '881001.SH',
|
||||
name: '行业一',
|
||||
changePercent: 2,
|
||||
direction: 'up',
|
||||
tradeDate: '20260818',
|
||||
},
|
||||
]);
|
||||
});
|
||||
|
||||
it('板块前一根 K 线日期无效时不进入强弱排序', () => {
|
||||
expect(
|
||||
mapSectorQuotes(
|
||||
{
|
||||
ErrorId: '0',
|
||||
Value: {
|
||||
'881001.SH': {
|
||||
Date: ['20269999', '20260818'],
|
||||
Open: ['100', '200'],
|
||||
High: ['100', '200'],
|
||||
Low: ['100', '200'],
|
||||
Close: ['100', '200'],
|
||||
Amount: ['1', '1'],
|
||||
Volume: ['1', '1'],
|
||||
},
|
||||
},
|
||||
},
|
||||
[{ code: '881001.SH', name: '畸形日期行业' }],
|
||||
),
|
||||
).toEqual([]);
|
||||
});
|
||||
|
||||
it('板块混合交易日时只保留最新交易日，避免把不同日期混排', () => {
|
||||
const series = (dates: string[], close: string[]) => ({
|
||||
Date: dates,
|
||||
Open: close,
|
||||
High: close,
|
||||
Low: close,
|
||||
Close: close,
|
||||
Amount: ['1', '1'],
|
||||
Volume: ['1', '1'],
|
||||
});
|
||||
expect(
|
||||
mapSectorQuotes(
|
||||
{
|
||||
ErrorId: '0',
|
||||
Value: {
|
||||
'881001.SH': series(['20260817', '20260818'], ['100', '102']),
|
||||
'881002.SH': series(['20260818', '20260819'], ['100', '101']),
|
||||
},
|
||||
},
|
||||
[
|
||||
{ code: '881001.SH', name: '旧日期行业' },
|
||||
{ code: '881002.SH', name: '最新日期行业' },
|
||||
],
|
||||
),
|
||||
).toEqual([expect.objectContaining({ code: '881002.SH', tradeDate: '20260819' })]);
|
||||
});
|
||||
|
||||
it('成交额映射将 TDX 万元转换为亿元并计算环比', () => {
|
||||
expect(
|
||||
mapTurnoverTrend(
|
||||
{
|
||||
ErrorId: '0',
|
||||
Value: {
|
||||
'000001.SH': {
|
||||
Date: ['20260817', '20260818'],
|
||||
Open: ['1', '1'],
|
||||
High: ['1', '1'],
|
||||
Low: ['1', '1'],
|
||||
Close: ['1', '1'],
|
||||
Amount: ['100000', '120000'],
|
||||
Volume: ['1', '1'],
|
||||
},
|
||||
},
|
||||
},
|
||||
[{ code: '000001.SH', name: '上证市场' }],
|
||||
),
|
||||
).toEqual({
|
||||
data: {
|
||||
currentAmount: 12,
|
||||
previousAmount: 10,
|
||||
changePercent: 20,
|
||||
unit: '亿元',
|
||||
marketCount: 1,
|
||||
tradeDate: '20260818',
|
||||
previousTradeDate: '20260817',
|
||||
},
|
||||
validMarketCount: 1,
|
||||
});
|
||||
});
|
||||
|
||||
it('成交额只汇总交易日期一致且金额非负的市场', () => {
|
||||
const series = (dates: string[], amounts: string[]) => ({
|
||||
Date: dates,
|
||||
Open: ['1', '1'],
|
||||
High: ['1', '1'],
|
||||
Low: ['1', '1'],
|
||||
Close: ['1', '1'],
|
||||
Amount: amounts,
|
||||
Volume: ['1', '1'],
|
||||
});
|
||||
const result = mapTurnoverTrend(
|
||||
{
|
||||
ErrorId: '0',
|
||||
Value: {
|
||||
'000001.SH': series(['20260817', '20260818'], ['100000', '120000']),
|
||||
'399001.SZ': series(['20260816', '20260817'], ['200000', '240000']),
|
||||
'899050.BJ': series(['20260817', '20260818'], ['10000', '-1']),
|
||||
},
|
||||
},
|
||||
[
|
||||
{ code: '000001.SH', name: '上证市场' },
|
||||
{ code: '399001.SZ', name: '深证市场' },
|
||||
{ code: '899050.BJ', name: '北证市场' },
|
||||
],
|
||||
);
|
||||
|
||||
expect(result).toMatchObject({
|
||||
validMarketCount: 1,
|
||||
data: { currentAmount: 12, previousAmount: 10, marketCount: 1, tradeDate: '20260818' },
|
||||
});
|
||||
});
|
||||
|
||||
it('成交额以多数市场的最新交易日为锚，避免首个市场日期异常导致丢数', () => {
|
||||
const series = (dates: string[], amounts: string[]) => ({
|
||||
Date: dates,
|
||||
Open: ['1', '1'],
|
||||
High: ['1', '1'],
|
||||
Low: ['1', '1'],
|
||||
Close: ['1', '1'],
|
||||
Amount: amounts,
|
||||
Volume: ['1', '1'],
|
||||
});
|
||||
expect(
|
||||
mapTurnoverTrend(
|
||||
{
|
||||
ErrorId: '0',
|
||||
Value: {
|
||||
'000001.SH': series(['20260817', '20260818'], ['100000', '120000']),
|
||||
'399001.SZ': series(['20260818', '20260819'], ['200000', '240000']),
|
||||
'899050.BJ': series(['20260818', '20260819'], ['300000', '360000']),
|
||||
},
|
||||
},
|
||||
[
|
||||
{ code: '000001.SH', name: '上证市场' },
|
||||
{ code: '399001.SZ', name: '深证市场' },
|
||||
{ code: '899050.BJ', name: '北证市场' },
|
||||
],
|
||||
),
|
||||
).toEqual({
|
||||
data: {
|
||||
currentAmount: 60,
|
||||
previousAmount: 50,
|
||||
changePercent: 20,
|
||||
unit: '亿元',
|
||||
marketCount: 2,
|
||||
tradeDate: '20260819',
|
||||
previousTradeDate: '20260818',
|
||||
},
|
||||
validMarketCount: 2,
|
||||
});
|
||||
});
|
||||
|
||||
it('成交额排除倒序和非法公历日期，不能让异常日期抢占汇总锚点', () => {
|
||||
const series = (dates: string[], amounts: string[]) => ({
|
||||
Date: dates,
|
||||
Open: ['1', '1'],
|
||||
High: ['1', '1'],
|
||||
Low: ['1', '1'],
|
||||
Close: ['1', '1'],
|
||||
Amount: amounts,
|
||||
Volume: ['1', '1'],
|
||||
});
|
||||
|
||||
expect(
|
||||
mapTurnoverTrend(
|
||||
{
|
||||
ErrorId: '0',
|
||||
Value: {
|
||||
'000001.SH': series(['20260817', '20260818'], ['100000', '120000']),
|
||||
'399001.SZ': series(['20260817', '20260818'], ['200000', '240000']),
|
||||
'899050.BJ': series(['20260820', '20260819'], ['300000', '360000']),
|
||||
'899051.BJ': series(['20269898', '20269999'], ['300000', '360000']),
|
||||
},
|
||||
},
|
||||
[
|
||||
{ code: '000001.SH', name: '上证市场' },
|
||||
{ code: '399001.SZ', name: '深证市场' },
|
||||
{ code: '899050.BJ', name: '日期倒序市场' },
|
||||
{ code: '899051.BJ', name: '非法日期市场' },
|
||||
],
|
||||
),
|
||||
).toEqual({
|
||||
data: {
|
||||
currentAmount: 36,
|
||||
previousAmount: 30,
|
||||
changePercent: 20,
|
||||
unit: '亿元',
|
||||
marketCount: 2,
|
||||
tradeDate: '20260818',
|
||||
previousTradeDate: '20260817',
|
||||
},
|
||||
validMarketCount: 2,
|
||||
});
|
||||
});
|
||||
|
||||
it('成交额拒绝日期与金额数组错位的市场', () => {
|
||||
expect(
|
||||
mapTurnoverTrend(
|
||||
{
|
||||
ErrorId: '0',
|
||||
Value: {
|
||||
'000001.SH': {
|
||||
Date: ['20260816', '20260817', '20260818'],
|
||||
Open: ['1', '1', '1'],
|
||||
High: ['1', '1', '1'],
|
||||
Low: ['1', '1', '1'],
|
||||
Close: ['1', '1', '1'],
|
||||
Amount: ['100000', '120000'],
|
||||
Volume: ['1', '1', '1'],
|
||||
},
|
||||
},
|
||||
},
|
||||
[{ code: '000001.SH', name: '数组错位市场' }],
|
||||
),
|
||||
).toEqual({ data: null, validMarketCount: 0 });
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,200 @@
|
||||
import type {
|
||||
BreadthDataDto,
|
||||
FundDataDto,
|
||||
IndexQuoteDto,
|
||||
SectorQuoteDto,
|
||||
} from '../market-overview.dto';
|
||||
import type { IndexDefinition, TdxMarketDataResult, TdxKlineSeries } from './tdx.types';
|
||||
|
||||
function toNumber(value: string | undefined): number | null {
|
||||
if (value === undefined || value.trim() === '') return null;
|
||||
const parsed = Number(value);
|
||||
return Number.isFinite(parsed) ? parsed : null;
|
||||
}
|
||||
|
||||
function toNonNegativeNumber(value: string | undefined): number | null {
|
||||
const parsed = toNumber(value);
|
||||
return parsed !== null && parsed >= 0 ? parsed : null;
|
||||
}
|
||||
|
||||
function toNonNegativeInteger(value: string | undefined): number | null {
|
||||
const normalized = value?.trim();
|
||||
if (!normalized || !/^\d+$/.test(normalized)) return null;
|
||||
const parsed = Number(normalized);
|
||||
return Number.isSafeInteger(parsed) ? parsed : null;
|
||||
}
|
||||
|
||||
function toTradeDate(value: string | undefined): string | null {
|
||||
if (!value || !/^\d{8}$/.test(value)) return null;
|
||||
|
||||
const year = Number(value.slice(0, 4));
|
||||
const month = Number(value.slice(4, 6));
|
||||
const day = Number(value.slice(6, 8));
|
||||
const date = new Date(0);
|
||||
date.setUTCHours(0, 0, 0, 0);
|
||||
date.setUTCFullYear(year, month - 1, day);
|
||||
|
||||
return year >= 1000 &&
|
||||
date.getUTCFullYear() === year &&
|
||||
date.getUTCMonth() === month - 1 &&
|
||||
date.getUTCDate() === day
|
||||
? value
|
||||
: null;
|
||||
}
|
||||
|
||||
function latestTradeDate<T extends { tradeDate: string }>(items: readonly T[]): string | null {
|
||||
return items.reduce<string | null>(
|
||||
(latest, item) => (latest === null || item.tradeDate > latest ? item.tradeDate : latest),
|
||||
null,
|
||||
);
|
||||
}
|
||||
|
||||
function mapDirection(changePercent: number | null): IndexQuoteDto['direction'] {
|
||||
if (changePercent === null || changePercent === 0) return 'flat';
|
||||
return changePercent > 0 ? 'up' : 'down';
|
||||
}
|
||||
|
||||
function mapIndexQuote(series: TdxKlineSeries, definition: IndexDefinition): IndexQuoteDto | null {
|
||||
const lastIndex = series.Close.length - 1;
|
||||
const price = toNumber(series.Close[lastIndex]);
|
||||
const previousPrice = toNumber(series.Close[lastIndex - 1]);
|
||||
const tradeDate = toTradeDate(series.Date[lastIndex]);
|
||||
if (price === null || !tradeDate) return null;
|
||||
const previousTradeDate = toTradeDate(series.Date[lastIndex - 1]);
|
||||
|
||||
const changePercent =
|
||||
previousPrice === null ||
|
||||
previousPrice === 0 ||
|
||||
previousTradeDate === null ||
|
||||
previousTradeDate >= tradeDate
|
||||
? null
|
||||
: Math.round(((price - previousPrice) / previousPrice) * 100 * 100) / 100;
|
||||
|
||||
return {
|
||||
code: definition.code,
|
||||
name: definition.name,
|
||||
price,
|
||||
changePercent,
|
||||
direction: mapDirection(changePercent),
|
||||
tradeDate,
|
||||
};
|
||||
}
|
||||
|
||||
/** 只把已确认字段映射为领域 DTO，缺失的单个指数不阻断其他指数。 */
|
||||
export function mapIndexQuotes(
|
||||
result: TdxMarketDataResult,
|
||||
definitions: readonly IndexDefinition[],
|
||||
): IndexQuoteDto[] {
|
||||
const candidates = definitions.flatMap((definition) => {
|
||||
const series = result.Value[definition.code];
|
||||
if (!series) return [];
|
||||
const quote = mapIndexQuote(series, definition);
|
||||
return quote ? [quote] : [];
|
||||
});
|
||||
const tradeDate = latestTradeDate(candidates);
|
||||
return tradeDate ? candidates.filter((item) => item.tradeDate === tradeDate) : [];
|
||||
}
|
||||
|
||||
/** TDX 涨跌家数必须成对有效且非负；无效市场整体排除，禁止把缺失字段折算为零。 */
|
||||
export function mapBreadthSnapshots(snapshots: readonly { UpHome?: string; DownHome?: string }[]): {
|
||||
data: BreadthDataDto | null;
|
||||
validCount: number;
|
||||
} {
|
||||
const validSnapshots = snapshots.flatMap((item) => {
|
||||
const advancing = toNonNegativeInteger(item.UpHome);
|
||||
const declining = toNonNegativeInteger(item.DownHome);
|
||||
return advancing === null || declining === null ? [] : [{ advancing, declining }];
|
||||
});
|
||||
if (!validSnapshots.length) return { data: null, validCount: 0 };
|
||||
|
||||
return {
|
||||
data: {
|
||||
advancing: validSnapshots.reduce((total, item) => total + item.advancing, 0),
|
||||
declining: validSnapshots.reduce((total, item) => total + item.declining, 0),
|
||||
unchanged: null,
|
||||
},
|
||||
validCount: validSnapshots.length,
|
||||
};
|
||||
}
|
||||
|
||||
/** 一级行业只有在具备相邻两日收盘价时才参与强弱排序，返回对象严格匹配公开 DTO。 */
|
||||
export function mapSectorQuotes(
|
||||
result: TdxMarketDataResult,
|
||||
definitions: readonly IndexDefinition[],
|
||||
): SectorQuoteDto[] {
|
||||
const candidates = definitions.flatMap((definition) => {
|
||||
const series = result.Value[definition.code];
|
||||
if (!series) return [];
|
||||
const quote = mapIndexQuote(series, definition);
|
||||
if (!quote || quote.changePercent === null) return [];
|
||||
return [
|
||||
{
|
||||
code: quote.code,
|
||||
name: quote.name,
|
||||
changePercent: quote.changePercent,
|
||||
direction: quote.direction,
|
||||
tradeDate: quote.tradeDate,
|
||||
},
|
||||
];
|
||||
});
|
||||
const tradeDate = latestTradeDate(candidates);
|
||||
return candidates
|
||||
.filter((item) => item.tradeDate === tradeDate)
|
||||
.sort((left, right) => right.changePercent - left.changePercent);
|
||||
}
|
||||
|
||||
/** 成交额仅汇总交易日期对齐、金额非负的市场；TDX Amount 从万元转换为亿元。 */
|
||||
export function mapTurnoverTrend(
|
||||
result: TdxMarketDataResult,
|
||||
definitions: readonly IndexDefinition[],
|
||||
): { data: FundDataDto | null; validMarketCount: number } {
|
||||
const candidates = definitions.flatMap((definition) => {
|
||||
const series = result.Value[definition.code];
|
||||
if (!series) return [];
|
||||
if (series.Date.length < 2 || series.Date.length !== series.Amount.length) return [];
|
||||
const current = toNonNegativeNumber(series.Amount.at(-1));
|
||||
const previous = toNonNegativeNumber(series.Amount.at(-2));
|
||||
const tradeDate = toTradeDate(series.Date.at(-1));
|
||||
const previousTradeDate = toTradeDate(series.Date.at(-2));
|
||||
if (
|
||||
current === null ||
|
||||
previous === null ||
|
||||
previous === 0 ||
|
||||
!tradeDate ||
|
||||
!previousTradeDate ||
|
||||
previousTradeDate >= tradeDate
|
||||
) {
|
||||
return [];
|
||||
}
|
||||
return [{ current, previous, tradeDate, previousTradeDate }];
|
||||
});
|
||||
if (!candidates.length) return { data: null, validMarketCount: 0 };
|
||||
|
||||
const expected = candidates.reduce((latest, item) =>
|
||||
item.tradeDate > latest.tradeDate ||
|
||||
(item.tradeDate === latest.tradeDate && item.previousTradeDate > latest.previousTradeDate)
|
||||
? item
|
||||
: latest,
|
||||
);
|
||||
const aligned = candidates.filter(
|
||||
(item) =>
|
||||
item.tradeDate === expected.tradeDate &&
|
||||
item.previousTradeDate === expected.previousTradeDate,
|
||||
);
|
||||
const currentAmount = aligned.reduce((total, item) => total + item.current, 0);
|
||||
const previousAmount = aligned.reduce((total, item) => total + item.previous, 0);
|
||||
if (previousAmount === 0) return { data: null, validMarketCount: aligned.length };
|
||||
|
||||
return {
|
||||
data: {
|
||||
currentAmount: Math.round((currentAmount / 10000) * 100) / 100,
|
||||
previousAmount: Math.round((previousAmount / 10000) * 100) / 100,
|
||||
changePercent: Math.round(((currentAmount - previousAmount) / previousAmount) * 10000) / 100,
|
||||
unit: '亿元',
|
||||
marketCount: aligned.length,
|
||||
tradeDate: expected.tradeDate,
|
||||
previousTradeDate: expected.previousTradeDate,
|
||||
},
|
||||
validMarketCount: aligned.length,
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,55 @@
|
||||
export interface TdxKlineSeries {
|
||||
Date: string[];
|
||||
Open: string[];
|
||||
High: string[];
|
||||
Low: string[];
|
||||
Close: string[];
|
||||
Amount: string[];
|
||||
Volume: string[];
|
||||
ForwardFactor?: string[];
|
||||
}
|
||||
|
||||
export interface TdxMarketDataResult {
|
||||
ErrorId: string | number;
|
||||
Value: Record<string, TdxKlineSeries>;
|
||||
}
|
||||
|
||||
export interface TdxMarketSnapshotResult {
|
||||
ErrorId: string | number;
|
||||
UpHome?: string;
|
||||
DownHome?: string;
|
||||
Inside?: string;
|
||||
Outside?: string;
|
||||
Amount?: string;
|
||||
}
|
||||
|
||||
export interface TdxStockListResult {
|
||||
ErrorId: string | number;
|
||||
Value: Array<{ Code: string; Name: string }>;
|
||||
}
|
||||
|
||||
export interface IndexDefinition {
|
||||
code: string;
|
||||
name: string;
|
||||
}
|
||||
|
||||
/** 首屏只使用已通过 TDX K 线只读冒烟的三大指数，代码口径统一带市场后缀。 */
|
||||
export const CORE_INDEXES: readonly IndexDefinition[] = [
|
||||
{ code: '000001.SH', name: '上证指数' },
|
||||
{ code: '399001.SZ', name: '深证成指' },
|
||||
{ code: '399006.SZ', name: '创业板指' },
|
||||
];
|
||||
|
||||
/** TDX 快照对指数提供上涨/下跌家数，三个市场相加后作为首屏市场宽度口径。 */
|
||||
export const BREADTH_INDEXES: readonly IndexDefinition[] = [
|
||||
{ code: '000001.SH', name: '上证市场' },
|
||||
{ code: '399001.SZ', name: '深证市场' },
|
||||
{ code: '899050.BJ', name: '北证市场' },
|
||||
];
|
||||
|
||||
/** 首屏资金模块使用交易所指数成交额，避免把成交额趋势误称为主力净流入。 */
|
||||
export const TURNOVER_INDEXES: readonly IndexDefinition[] = [
|
||||
{ code: '000001.SH', name: '上证市场' },
|
||||
{ code: '399001.SZ', name: '深证市场' },
|
||||
{ code: '899050.BJ', name: '北证市场' },
|
||||
];
|
||||
@@ -0,0 +1,119 @@
|
||||
import type { INestApplication } from '@nestjs/common';
|
||||
import { Test } from '@nestjs/testing';
|
||||
import request from 'supertest';
|
||||
import { afterEach, describe, expect, it, vi } from 'vitest';
|
||||
|
||||
import { MarketOverviewController } from '../src/market-overview/market-overview.controller';
|
||||
import {
|
||||
MarketOverviewService,
|
||||
TDX_CLIENT_PORT,
|
||||
} from '../src/market-overview/market-overview.service';
|
||||
|
||||
describe('市场概览 HTTP API', () => {
|
||||
let app: INestApplication | undefined;
|
||||
|
||||
afterEach(async () => {
|
||||
await app?.close();
|
||||
app = undefined;
|
||||
});
|
||||
|
||||
it('按模块返回指数和 TDX 来源元数据', async () => {
|
||||
const client = {
|
||||
request: vi.fn().mockResolvedValue({
|
||||
ErrorId: '0',
|
||||
Value: {
|
||||
'000001.SH': {
|
||||
Date: ['20260817', '20260818'],
|
||||
Open: ['3350', '3370'],
|
||||
High: ['3385', '3400'],
|
||||
Low: ['3340', '3360'],
|
||||
Close: ['3360', '3380'],
|
||||
Amount: ['100', '120'],
|
||||
Volume: ['1000', '1100'],
|
||||
},
|
||||
'399001.SZ': {
|
||||
Date: ['20260817', '20260818'],
|
||||
Open: ['10000', '10100'],
|
||||
High: ['10200', '10300'],
|
||||
Low: ['9900', '10050'],
|
||||
Close: ['10000', '10200'],
|
||||
Amount: ['100', '120'],
|
||||
Volume: ['1000', '1100'],
|
||||
},
|
||||
'399006.SZ': {
|
||||
Date: ['20260817', '20260818'],
|
||||
Open: ['2100', '2110'],
|
||||
High: ['2120', '2130'],
|
||||
Low: ['2090', '2100'],
|
||||
Close: ['2100', '2120'],
|
||||
Amount: ['100', '120'],
|
||||
Volume: ['1000', '1100'],
|
||||
},
|
||||
},
|
||||
}),
|
||||
};
|
||||
const moduleRef = await Test.createTestingModule({
|
||||
controllers: [MarketOverviewController],
|
||||
providers: [MarketOverviewService, { provide: TDX_CLIENT_PORT, useValue: client }],
|
||||
}).compile();
|
||||
app = moduleRef.createNestApplication();
|
||||
app.setGlobalPrefix('api/v1');
|
||||
await app.init();
|
||||
|
||||
const response = await request(app.getHttpServer())
|
||||
.get('/api/v1/market-overview/indices')
|
||||
.expect(200);
|
||||
|
||||
expect(response.body).toMatchObject({
|
||||
source: 'tdx',
|
||||
status: 'fresh',
|
||||
data: { items: expect.any(Array) },
|
||||
});
|
||||
expect(JSON.stringify(response.body)).not.toContain('127.0.0.1');
|
||||
});
|
||||
|
||||
it('板块接口返回可点击的 TDX 一级行业对象', async () => {
|
||||
const client = {
|
||||
request: vi
|
||||
.fn()
|
||||
.mockResolvedValueOnce({
|
||||
ErrorId: '0',
|
||||
Value: [{ Code: '881319.SH', Name: '半导体' }],
|
||||
})
|
||||
.mockResolvedValueOnce({
|
||||
ErrorId: '0',
|
||||
Value: {
|
||||
'881319.SH': {
|
||||
Date: ['20260817', '20260818'],
|
||||
Open: ['100', '101'],
|
||||
High: ['102', '103'],
|
||||
Low: ['99', '100'],
|
||||
Close: ['100', '102'],
|
||||
Amount: ['1000', '1200'],
|
||||
Volume: ['100', '120'],
|
||||
},
|
||||
},
|
||||
}),
|
||||
};
|
||||
const moduleRef = await Test.createTestingModule({
|
||||
controllers: [MarketOverviewController],
|
||||
providers: [MarketOverviewService, { provide: TDX_CLIENT_PORT, useValue: client }],
|
||||
}).compile();
|
||||
app = moduleRef.createNestApplication();
|
||||
app.setGlobalPrefix('api/v1');
|
||||
await app.init();
|
||||
|
||||
const response = await request(app.getHttpServer())
|
||||
.get('/api/v1/market-overview/sectors')
|
||||
.expect(200);
|
||||
|
||||
expect(response.body).toMatchObject({
|
||||
source: 'tdx',
|
||||
status: 'fresh',
|
||||
data: {
|
||||
items: [expect.objectContaining({ code: '881319.SH', name: '半导体', changePercent: 2 })],
|
||||
},
|
||||
});
|
||||
expect(JSON.stringify(response.body)).not.toContain('127.0.0.1');
|
||||
});
|
||||
});
|
||||
@@ -50,6 +50,8 @@ describe('进程级运行配置', () => {
|
||||
LOG_LEVEL: 'debug',
|
||||
API_HOST: '127.0.0.1',
|
||||
API_PORT: '3000',
|
||||
TDX_BASE_URL: 'http://127.0.0.1:17710',
|
||||
TDX_TIMEOUT_MS: '5000',
|
||||
...baseRedisEnv,
|
||||
...disabledMysqlEnv,
|
||||
...disabledAiEnv,
|
||||
@@ -129,6 +131,8 @@ describe('进程级运行配置', () => {
|
||||
LOG_LEVEL: 'debug',
|
||||
API_HOST: '127.0.0.1',
|
||||
API_PORT: '3000',
|
||||
TDX_BASE_URL: 'http://127.0.0.1:17710',
|
||||
TDX_TIMEOUT_MS: '5000',
|
||||
...baseRedisEnv,
|
||||
...enabledMysql,
|
||||
...disabledAiEnv,
|
||||
@@ -138,12 +142,38 @@ describe('进程级运行配置', () => {
|
||||
expect(() => loadApiConfig({ ...apiEnv, MYSQL_TIMEZONE: 'SYSTEM' })).toThrow(/MYSQL_TIMEZONE/);
|
||||
});
|
||||
|
||||
it('TDX 只允许本机回环地址和固定端口', () => {
|
||||
const apiEnv = {
|
||||
APP_ENV: 'development',
|
||||
LOG_LEVEL: 'debug',
|
||||
API_HOST: '127.0.0.1',
|
||||
API_PORT: '3000',
|
||||
TDX_BASE_URL: 'http://127.0.0.1:17710',
|
||||
TDX_TIMEOUT_MS: '5000',
|
||||
...baseRedisEnv,
|
||||
...disabledMysqlEnv,
|
||||
...disabledAiEnv,
|
||||
};
|
||||
|
||||
expect(() => loadApiConfig({ ...apiEnv, TDX_BASE_URL: 'http://192.168.28.106:17709' })).toThrow(
|
||||
/TDX_BASE_URL 必须指向本机回环地址/,
|
||||
);
|
||||
expect(() => loadApiConfig({ ...apiEnv, TDX_BASE_URL: 'https://127.0.0.1:17710' })).toThrow(
|
||||
/TDX_BASE_URL 必须使用 http 协议/,
|
||||
);
|
||||
expect(() => loadApiConfig({ ...apiEnv, TDX_BASE_URL: 'http://127.0.0.1:17711' })).toThrow(
|
||||
/TDX_BASE_URL 必须使用 17710 端口/,
|
||||
);
|
||||
});
|
||||
|
||||
it('日志摘要不包含任何连接密码、密钥或未知字段', () => {
|
||||
const config = loadApiConfig({
|
||||
APP_ENV: 'development',
|
||||
LOG_LEVEL: 'debug',
|
||||
API_HOST: '127.0.0.1',
|
||||
API_PORT: '3000',
|
||||
TDX_BASE_URL: 'http://127.0.0.1:17710',
|
||||
TDX_TIMEOUT_MS: '5000',
|
||||
...baseRedisEnv,
|
||||
...disabledMysqlEnv,
|
||||
...disabledAiEnv,
|
||||
|
||||
@@ -35,6 +35,12 @@ export interface AiRuntimeConfig {
|
||||
timeoutMs: number;
|
||||
}
|
||||
|
||||
/** API 只允许通过本机 SSH/Tailscale 隧道访问 TDX，禁止把家庭地址暴露给业务请求。 */
|
||||
export interface TdxRuntimeConfig {
|
||||
baseUrl: string;
|
||||
timeoutMs: number;
|
||||
}
|
||||
|
||||
/** RocketMQ 公共寻址配置；实际生产/消费参数由相应进程扩展。 */
|
||||
export interface RocketMqRuntimeConfig {
|
||||
enabled: boolean;
|
||||
@@ -54,6 +60,7 @@ interface CommonRuntimeConfig {
|
||||
export interface ApiRuntimeConfig extends CommonRuntimeConfig {
|
||||
processName: 'api';
|
||||
api: Readonly<{ host: string; port: number }>;
|
||||
tdx: Readonly<TdxRuntimeConfig>;
|
||||
mysql: MysqlRuntimeConfig;
|
||||
ai: AiRuntimeConfig;
|
||||
}
|
||||
@@ -196,6 +203,30 @@ function loadAiConfig(env: EnvironmentSource): AiRuntimeConfig {
|
||||
};
|
||||
}
|
||||
|
||||
function loadTdxConfig(env: EnvironmentSource): TdxRuntimeConfig {
|
||||
const baseUrl = requireText(env, 'TDX_BASE_URL').replace(/\/$/, '');
|
||||
let parsed: URL;
|
||||
try {
|
||||
parsed = new URL(baseUrl);
|
||||
} catch {
|
||||
throw new Error('TDX_BASE_URL 必须为有效 URL');
|
||||
}
|
||||
|
||||
if (parsed.protocol !== 'http:') throw new Error('TDX_BASE_URL 必须使用 http 协议');
|
||||
if (parsed.hostname !== '127.0.0.1') {
|
||||
throw new Error('TDX_BASE_URL 必须指向本机回环地址');
|
||||
}
|
||||
if (parsed.port !== '17710') throw new Error('TDX_BASE_URL 必须使用 17710 端口');
|
||||
if (parsed.pathname !== '' && parsed.pathname !== '/') {
|
||||
throw new Error('TDX_BASE_URL 不得包含额外路径');
|
||||
}
|
||||
|
||||
return {
|
||||
baseUrl: parsed.toString().replace(/\/$/, ''),
|
||||
timeoutMs: parseInteger(env, 'TDX_TIMEOUT_MS', { min: 100, max: 30_000 }),
|
||||
};
|
||||
}
|
||||
|
||||
function loadRocketMqConfig(env: EnvironmentSource): RocketMqRuntimeConfig {
|
||||
const enabled = parseBoolean(env, 'ROCKETMQ_ENABLED');
|
||||
const nameServerAddress = optionalText(env, 'ROCKETMQ_NAMESRV_ADDR');
|
||||
@@ -225,6 +256,7 @@ export function loadApiConfig(env: EnvironmentSource): ApiRuntimeConfig {
|
||||
host: requireText(env, 'API_HOST'),
|
||||
port: parseInteger(env, 'API_PORT', { min: 1, max: 65_535 }),
|
||||
},
|
||||
tdx: loadTdxConfig(env),
|
||||
redis: loadRedisConfig(env),
|
||||
mysql: loadMysqlConfig(env),
|
||||
ai: loadAiConfig(env),
|
||||
|
||||
@@ -1,6 +1,34 @@
|
||||
{
|
||||
"components": {
|
||||
"schemas": {
|
||||
"BreadthDataDto": {
|
||||
"properties": {
|
||||
"advancing": { "type": "number" },
|
||||
"declining": { "type": "number" },
|
||||
"unchanged": { "nullable": true, "type": "number" }
|
||||
},
|
||||
"required": ["advancing", "declining", "unchanged"],
|
||||
"type": "object"
|
||||
},
|
||||
"BreadthResponseDto": {
|
||||
"properties": {
|
||||
"asOf": { "format": "date-time", "type": "string" },
|
||||
"data": {
|
||||
"allOf": [{ "$ref": "#/components/schemas/BreadthDataDto" }],
|
||||
"nullable": true,
|
||||
"type": "object"
|
||||
},
|
||||
"snapshotId": { "type": "string" },
|
||||
"source": { "enum": ["tdx"], "type": "string" },
|
||||
"status": {
|
||||
"enum": ["fresh", "delayed", "partial", "unavailable"],
|
||||
"type": "string"
|
||||
},
|
||||
"warnings": { "items": { "type": "string" }, "type": "array" }
|
||||
},
|
||||
"required": ["snapshotId", "asOf", "source", "status", "warnings", "data"],
|
||||
"type": "object"
|
||||
},
|
||||
"DependencyHealthDto": {
|
||||
"properties": {
|
||||
"detail": { "type": "string" },
|
||||
@@ -12,6 +40,46 @@
|
||||
"required": ["status", "detail"],
|
||||
"type": "object"
|
||||
},
|
||||
"FundDataDto": {
|
||||
"properties": {
|
||||
"changePercent": { "type": "number" },
|
||||
"currentAmount": { "type": "number" },
|
||||
"marketCount": { "maximum": 3, "minimum": 1, "type": "number" },
|
||||
"previousAmount": { "type": "number" },
|
||||
"previousTradeDate": { "example": "20260817", "type": "string" },
|
||||
"tradeDate": { "example": "20260818", "type": "string" },
|
||||
"unit": { "example": "亿元", "type": "string" }
|
||||
},
|
||||
"required": [
|
||||
"currentAmount",
|
||||
"previousAmount",
|
||||
"changePercent",
|
||||
"unit",
|
||||
"marketCount",
|
||||
"tradeDate",
|
||||
"previousTradeDate"
|
||||
],
|
||||
"type": "object"
|
||||
},
|
||||
"FundsResponseDto": {
|
||||
"properties": {
|
||||
"asOf": { "format": "date-time", "type": "string" },
|
||||
"data": {
|
||||
"allOf": [{ "$ref": "#/components/schemas/FundDataDto" }],
|
||||
"nullable": true,
|
||||
"type": "object"
|
||||
},
|
||||
"snapshotId": { "type": "string" },
|
||||
"source": { "enum": ["tdx"], "type": "string" },
|
||||
"status": {
|
||||
"enum": ["fresh", "delayed", "partial", "unavailable"],
|
||||
"type": "string"
|
||||
},
|
||||
"warnings": { "items": { "type": "string" }, "type": "array" }
|
||||
},
|
||||
"required": ["snapshotId", "asOf", "source", "status", "warnings", "data"],
|
||||
"type": "object"
|
||||
},
|
||||
"HealthDependenciesDto": {
|
||||
"properties": {
|
||||
"mysql": { "$ref": "#/components/schemas/DependencyHealthDto" },
|
||||
@@ -32,6 +100,125 @@
|
||||
},
|
||||
"required": ["status", "process", "checkedAt", "dependencies"],
|
||||
"type": "object"
|
||||
},
|
||||
"IndexQuoteDto": {
|
||||
"properties": {
|
||||
"changePercent": { "nullable": true, "type": "number" },
|
||||
"code": { "type": "string" },
|
||||
"direction": { "enum": ["up", "down", "flat"], "type": "string" },
|
||||
"name": { "type": "string" },
|
||||
"price": { "type": "number" },
|
||||
"tradeDate": { "type": "string" }
|
||||
},
|
||||
"required": ["code", "name", "price", "direction", "tradeDate"],
|
||||
"type": "object"
|
||||
},
|
||||
"IndicesDataDto": {
|
||||
"properties": {
|
||||
"items": {
|
||||
"items": { "$ref": "#/components/schemas/IndexQuoteDto" },
|
||||
"type": "array"
|
||||
}
|
||||
},
|
||||
"required": ["items"],
|
||||
"type": "object"
|
||||
},
|
||||
"IndicesResponseDto": {
|
||||
"properties": {
|
||||
"asOf": { "format": "date-time", "type": "string" },
|
||||
"data": {
|
||||
"allOf": [{ "$ref": "#/components/schemas/IndicesDataDto" }],
|
||||
"nullable": true,
|
||||
"type": "object"
|
||||
},
|
||||
"snapshotId": { "type": "string" },
|
||||
"source": { "enum": ["tdx"], "type": "string" },
|
||||
"status": {
|
||||
"enum": ["fresh", "delayed", "partial", "unavailable"],
|
||||
"type": "string"
|
||||
},
|
||||
"warnings": { "items": { "type": "string" }, "type": "array" }
|
||||
},
|
||||
"required": ["snapshotId", "asOf", "source", "status", "warnings", "data"],
|
||||
"type": "object"
|
||||
},
|
||||
"SectorDataDto": {
|
||||
"properties": {
|
||||
"items": {
|
||||
"items": { "$ref": "#/components/schemas/SectorQuoteDto" },
|
||||
"type": "array"
|
||||
}
|
||||
},
|
||||
"required": ["items"],
|
||||
"type": "object"
|
||||
},
|
||||
"SectorQuoteDto": {
|
||||
"properties": {
|
||||
"changePercent": { "type": "number" },
|
||||
"code": { "type": "string" },
|
||||
"direction": { "enum": ["up", "down", "flat"], "type": "string" },
|
||||
"name": { "type": "string" },
|
||||
"tradeDate": { "type": "string" }
|
||||
},
|
||||
"required": ["code", "name", "changePercent", "direction", "tradeDate"],
|
||||
"type": "object"
|
||||
},
|
||||
"SectorsResponseDto": {
|
||||
"properties": {
|
||||
"asOf": { "format": "date-time", "type": "string" },
|
||||
"data": {
|
||||
"allOf": [{ "$ref": "#/components/schemas/SectorDataDto" }],
|
||||
"nullable": true,
|
||||
"type": "object"
|
||||
},
|
||||
"snapshotId": { "type": "string" },
|
||||
"source": { "enum": ["tdx"], "type": "string" },
|
||||
"status": {
|
||||
"enum": ["fresh", "delayed", "partial", "unavailable"],
|
||||
"type": "string"
|
||||
},
|
||||
"warnings": { "items": { "type": "string" }, "type": "array" }
|
||||
},
|
||||
"required": ["snapshotId", "asOf", "source", "status", "warnings", "data"],
|
||||
"type": "object"
|
||||
},
|
||||
"SummaryDataDto": {
|
||||
"properties": {
|
||||
"drivers": { "items": { "type": "string" }, "type": "array" },
|
||||
"marketStatus": { "type": "string" },
|
||||
"risks": { "items": { "type": "string" }, "type": "array" },
|
||||
"sentimentStatus": { "type": "string" },
|
||||
"verdict": { "type": "string" },
|
||||
"volumeStatus": { "type": "string" }
|
||||
},
|
||||
"required": [
|
||||
"verdict",
|
||||
"marketStatus",
|
||||
"volumeStatus",
|
||||
"sentimentStatus",
|
||||
"drivers",
|
||||
"risks"
|
||||
],
|
||||
"type": "object"
|
||||
},
|
||||
"SummaryResponseDto": {
|
||||
"properties": {
|
||||
"asOf": { "format": "date-time", "type": "string" },
|
||||
"data": {
|
||||
"allOf": [{ "$ref": "#/components/schemas/SummaryDataDto" }],
|
||||
"nullable": true,
|
||||
"type": "object"
|
||||
},
|
||||
"snapshotId": { "type": "string" },
|
||||
"source": { "enum": ["tdx"], "type": "string" },
|
||||
"status": {
|
||||
"enum": ["fresh", "delayed", "partial", "unavailable"],
|
||||
"type": "string"
|
||||
},
|
||||
"warnings": { "items": { "type": "string" }, "type": "array" }
|
||||
},
|
||||
"required": ["snapshotId", "asOf", "source", "status", "warnings", "data"],
|
||||
"type": "object"
|
||||
}
|
||||
}
|
||||
},
|
||||
@@ -67,6 +254,91 @@
|
||||
},
|
||||
"tags": ["health"]
|
||||
}
|
||||
},
|
||||
"/api/v1/market-overview/breadth": {
|
||||
"get": {
|
||||
"operationId": "MarketOverviewController_getBreadth",
|
||||
"parameters": [],
|
||||
"responses": {
|
||||
"200": {
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": { "$ref": "#/components/schemas/BreadthResponseDto" }
|
||||
}
|
||||
},
|
||||
"description": ""
|
||||
}
|
||||
},
|
||||
"tags": ["market-overview"]
|
||||
}
|
||||
},
|
||||
"/api/v1/market-overview/funds": {
|
||||
"get": {
|
||||
"operationId": "MarketOverviewController_getFunds",
|
||||
"parameters": [],
|
||||
"responses": {
|
||||
"200": {
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": { "$ref": "#/components/schemas/FundsResponseDto" }
|
||||
}
|
||||
},
|
||||
"description": ""
|
||||
}
|
||||
},
|
||||
"tags": ["market-overview"]
|
||||
}
|
||||
},
|
||||
"/api/v1/market-overview/indices": {
|
||||
"get": {
|
||||
"operationId": "MarketOverviewController_getIndices",
|
||||
"parameters": [],
|
||||
"responses": {
|
||||
"200": {
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": { "$ref": "#/components/schemas/IndicesResponseDto" }
|
||||
}
|
||||
},
|
||||
"description": ""
|
||||
}
|
||||
},
|
||||
"tags": ["market-overview"]
|
||||
}
|
||||
},
|
||||
"/api/v1/market-overview/sectors": {
|
||||
"get": {
|
||||
"operationId": "MarketOverviewController_getSectors",
|
||||
"parameters": [],
|
||||
"responses": {
|
||||
"200": {
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": { "$ref": "#/components/schemas/SectorsResponseDto" }
|
||||
}
|
||||
},
|
||||
"description": ""
|
||||
}
|
||||
},
|
||||
"tags": ["market-overview"]
|
||||
}
|
||||
},
|
||||
"/api/v1/market-overview/summary": {
|
||||
"get": {
|
||||
"operationId": "MarketOverviewController_getSummary",
|
||||
"parameters": [],
|
||||
"responses": {
|
||||
"200": {
|
||||
"content": {
|
||||
"application/json": {
|
||||
"schema": { "$ref": "#/components/schemas/SummaryResponseDto" }
|
||||
}
|
||||
},
|
||||
"description": ""
|
||||
}
|
||||
},
|
||||
"tags": ["market-overview"]
|
||||
}
|
||||
}
|
||||
},
|
||||
"servers": [],
|
||||
|
||||
@@ -59,6 +59,7 @@ describe('NestJS 三进程入口', () => {
|
||||
appEnv: 'development',
|
||||
logLevel: 'debug',
|
||||
api: Object.freeze({ host: '127.0.0.1', port: 3000 }),
|
||||
tdx: Object.freeze({ baseUrl: 'http://127.0.0.1:17710', timeoutMs: 5000 }),
|
||||
redis: redisConfig,
|
||||
mysql: mysqlConfig,
|
||||
ai: aiConfig,
|
||||
|
||||
@@ -8,17 +8,24 @@ import path from 'node:path';
|
||||
import { format } from 'prettier';
|
||||
|
||||
import { HealthController } from '../apps/api/src/health.controller';
|
||||
import { MarketOverviewController } from '../apps/api/src/market-overview/market-overview.controller';
|
||||
import {
|
||||
HealthService,
|
||||
MYSQL_HEALTH_PORT,
|
||||
REDIS_HEALTH_PORT,
|
||||
} from '../apps/api/src/health.service';
|
||||
import {
|
||||
MarketOverviewService,
|
||||
TDX_CLIENT_PORT,
|
||||
} from '../apps/api/src/market-overview/market-overview.service';
|
||||
import { DisabledHealthClient } from '../libs/infrastructure/src/disabled-health.client';
|
||||
|
||||
@Module({
|
||||
controllers: [HealthController],
|
||||
controllers: [HealthController, MarketOverviewController],
|
||||
providers: [
|
||||
HealthService,
|
||||
MarketOverviewService,
|
||||
{ provide: TDX_CLIENT_PORT, useValue: { request: async () => ({}) } },
|
||||
{ provide: REDIS_HEALTH_PORT, useValue: new DisabledHealthClient('文档生成不连接 Redis') },
|
||||
{ provide: MYSQL_HEALTH_PORT, useValue: new DisabledHealthClient('文档生成不连接 MySQL') },
|
||||
],
|
||||
|
||||
@@ -46,6 +46,9 @@ export async function runTestApi() {
|
||||
LOG_LEVEL: 'error',
|
||||
API_HOST: '127.0.0.1',
|
||||
API_PORT: '3000',
|
||||
// API 配置要求始终声明本机 TDX 边界；E2E 不依赖 TDX 可达性，页面会验证不可用状态。
|
||||
TDX_BASE_URL: 'http://127.0.0.1:17710',
|
||||
TDX_TIMEOUT_MS: '5000',
|
||||
REDIS_HOST: '127.0.0.1',
|
||||
REDIS_PORT: '6379',
|
||||
REDIS_USERNAME: '',
|
||||
|
||||
@@ -20,15 +20,134 @@ export interface paths {
|
||||
patch?: never;
|
||||
trace?: never;
|
||||
};
|
||||
'/api/v1/market-overview/breadth': {
|
||||
parameters: {
|
||||
query?: never;
|
||||
header?: never;
|
||||
path?: never;
|
||||
cookie?: never;
|
||||
};
|
||||
get: operations['MarketOverviewController_getBreadth'];
|
||||
put?: never;
|
||||
post?: never;
|
||||
delete?: never;
|
||||
options?: never;
|
||||
head?: never;
|
||||
patch?: never;
|
||||
trace?: never;
|
||||
};
|
||||
'/api/v1/market-overview/funds': {
|
||||
parameters: {
|
||||
query?: never;
|
||||
header?: never;
|
||||
path?: never;
|
||||
cookie?: never;
|
||||
};
|
||||
get: operations['MarketOverviewController_getFunds'];
|
||||
put?: never;
|
||||
post?: never;
|
||||
delete?: never;
|
||||
options?: never;
|
||||
head?: never;
|
||||
patch?: never;
|
||||
trace?: never;
|
||||
};
|
||||
'/api/v1/market-overview/indices': {
|
||||
parameters: {
|
||||
query?: never;
|
||||
header?: never;
|
||||
path?: never;
|
||||
cookie?: never;
|
||||
};
|
||||
get: operations['MarketOverviewController_getIndices'];
|
||||
put?: never;
|
||||
post?: never;
|
||||
delete?: never;
|
||||
options?: never;
|
||||
head?: never;
|
||||
patch?: never;
|
||||
trace?: never;
|
||||
};
|
||||
'/api/v1/market-overview/sectors': {
|
||||
parameters: {
|
||||
query?: never;
|
||||
header?: never;
|
||||
path?: never;
|
||||
cookie?: never;
|
||||
};
|
||||
get: operations['MarketOverviewController_getSectors'];
|
||||
put?: never;
|
||||
post?: never;
|
||||
delete?: never;
|
||||
options?: never;
|
||||
head?: never;
|
||||
patch?: never;
|
||||
trace?: never;
|
||||
};
|
||||
'/api/v1/market-overview/summary': {
|
||||
parameters: {
|
||||
query?: never;
|
||||
header?: never;
|
||||
path?: never;
|
||||
cookie?: never;
|
||||
};
|
||||
get: operations['MarketOverviewController_getSummary'];
|
||||
put?: never;
|
||||
post?: never;
|
||||
delete?: never;
|
||||
options?: never;
|
||||
head?: never;
|
||||
patch?: never;
|
||||
trace?: never;
|
||||
};
|
||||
}
|
||||
export type webhooks = Record<string, never>;
|
||||
export interface components {
|
||||
schemas: {
|
||||
BreadthDataDto: {
|
||||
advancing: number;
|
||||
declining: number;
|
||||
unchanged: number | null;
|
||||
};
|
||||
BreadthResponseDto: {
|
||||
/** Format: date-time */
|
||||
asOf: string;
|
||||
data: components['schemas']['BreadthDataDto'] | null;
|
||||
snapshotId: string;
|
||||
/** @enum {string} */
|
||||
source: 'tdx';
|
||||
/** @enum {string} */
|
||||
status: 'fresh' | 'delayed' | 'partial' | 'unavailable';
|
||||
warnings: string[];
|
||||
};
|
||||
DependencyHealthDto: {
|
||||
detail: string;
|
||||
/** @enum {string} */
|
||||
status: 'healthy' | 'unavailable' | 'disabled';
|
||||
};
|
||||
FundDataDto: {
|
||||
changePercent: number;
|
||||
currentAmount: number;
|
||||
marketCount: number;
|
||||
previousAmount: number;
|
||||
/** @example 20260817 */
|
||||
previousTradeDate: string;
|
||||
/** @example 20260818 */
|
||||
tradeDate: string;
|
||||
/** @example 亿元 */
|
||||
unit: string;
|
||||
};
|
||||
FundsResponseDto: {
|
||||
/** Format: date-time */
|
||||
asOf: string;
|
||||
data: components['schemas']['FundDataDto'] | null;
|
||||
snapshotId: string;
|
||||
/** @enum {string} */
|
||||
source: 'tdx';
|
||||
/** @enum {string} */
|
||||
status: 'fresh' | 'delayed' | 'partial' | 'unavailable';
|
||||
warnings: string[];
|
||||
};
|
||||
HealthDependenciesDto: {
|
||||
mysql: components['schemas']['DependencyHealthDto'];
|
||||
redis: components['schemas']['DependencyHealthDto'];
|
||||
@@ -43,6 +162,70 @@ export interface components {
|
||||
/** @enum {string} */
|
||||
status: 'healthy' | 'unavailable';
|
||||
};
|
||||
IndexQuoteDto: {
|
||||
changePercent?: number | null;
|
||||
code: string;
|
||||
/** @enum {string} */
|
||||
direction: 'up' | 'down' | 'flat';
|
||||
name: string;
|
||||
price: number;
|
||||
tradeDate: string;
|
||||
};
|
||||
IndicesDataDto: {
|
||||
items: components['schemas']['IndexQuoteDto'][];
|
||||
};
|
||||
IndicesResponseDto: {
|
||||
/** Format: date-time */
|
||||
asOf: string;
|
||||
data: components['schemas']['IndicesDataDto'] | null;
|
||||
snapshotId: string;
|
||||
/** @enum {string} */
|
||||
source: 'tdx';
|
||||
/** @enum {string} */
|
||||
status: 'fresh' | 'delayed' | 'partial' | 'unavailable';
|
||||
warnings: string[];
|
||||
};
|
||||
SectorDataDto: {
|
||||
items: components['schemas']['SectorQuoteDto'][];
|
||||
};
|
||||
SectorQuoteDto: {
|
||||
changePercent: number;
|
||||
code: string;
|
||||
/** @enum {string} */
|
||||
direction: 'up' | 'down' | 'flat';
|
||||
name: string;
|
||||
tradeDate: string;
|
||||
};
|
||||
SectorsResponseDto: {
|
||||
/** Format: date-time */
|
||||
asOf: string;
|
||||
data: components['schemas']['SectorDataDto'] | null;
|
||||
snapshotId: string;
|
||||
/** @enum {string} */
|
||||
source: 'tdx';
|
||||
/** @enum {string} */
|
||||
status: 'fresh' | 'delayed' | 'partial' | 'unavailable';
|
||||
warnings: string[];
|
||||
};
|
||||
SummaryDataDto: {
|
||||
drivers: string[];
|
||||
marketStatus: string;
|
||||
risks: string[];
|
||||
sentimentStatus: string;
|
||||
verdict: string;
|
||||
volumeStatus: string;
|
||||
};
|
||||
SummaryResponseDto: {
|
||||
/** Format: date-time */
|
||||
asOf: string;
|
||||
data: components['schemas']['SummaryDataDto'] | null;
|
||||
snapshotId: string;
|
||||
/** @enum {string} */
|
||||
source: 'tdx';
|
||||
/** @enum {string} */
|
||||
status: 'fresh' | 'delayed' | 'partial' | 'unavailable';
|
||||
warnings: string[];
|
||||
};
|
||||
};
|
||||
responses: never;
|
||||
parameters: never;
|
||||
@@ -79,4 +262,99 @@ export interface operations {
|
||||
};
|
||||
};
|
||||
};
|
||||
MarketOverviewController_getBreadth: {
|
||||
parameters: {
|
||||
query?: never;
|
||||
header?: never;
|
||||
path?: never;
|
||||
cookie?: never;
|
||||
};
|
||||
requestBody?: never;
|
||||
responses: {
|
||||
200: {
|
||||
headers: {
|
||||
[name: string]: unknown;
|
||||
};
|
||||
content: {
|
||||
'application/json': components['schemas']['BreadthResponseDto'];
|
||||
};
|
||||
};
|
||||
};
|
||||
};
|
||||
MarketOverviewController_getFunds: {
|
||||
parameters: {
|
||||
query?: never;
|
||||
header?: never;
|
||||
path?: never;
|
||||
cookie?: never;
|
||||
};
|
||||
requestBody?: never;
|
||||
responses: {
|
||||
200: {
|
||||
headers: {
|
||||
[name: string]: unknown;
|
||||
};
|
||||
content: {
|
||||
'application/json': components['schemas']['FundsResponseDto'];
|
||||
};
|
||||
};
|
||||
};
|
||||
};
|
||||
MarketOverviewController_getIndices: {
|
||||
parameters: {
|
||||
query?: never;
|
||||
header?: never;
|
||||
path?: never;
|
||||
cookie?: never;
|
||||
};
|
||||
requestBody?: never;
|
||||
responses: {
|
||||
200: {
|
||||
headers: {
|
||||
[name: string]: unknown;
|
||||
};
|
||||
content: {
|
||||
'application/json': components['schemas']['IndicesResponseDto'];
|
||||
};
|
||||
};
|
||||
};
|
||||
};
|
||||
MarketOverviewController_getSectors: {
|
||||
parameters: {
|
||||
query?: never;
|
||||
header?: never;
|
||||
path?: never;
|
||||
cookie?: never;
|
||||
};
|
||||
requestBody?: never;
|
||||
responses: {
|
||||
200: {
|
||||
headers: {
|
||||
[name: string]: unknown;
|
||||
};
|
||||
content: {
|
||||
'application/json': components['schemas']['SectorsResponseDto'];
|
||||
};
|
||||
};
|
||||
};
|
||||
};
|
||||
MarketOverviewController_getSummary: {
|
||||
parameters: {
|
||||
query?: never;
|
||||
header?: never;
|
||||
path?: never;
|
||||
cookie?: never;
|
||||
};
|
||||
requestBody?: never;
|
||||
responses: {
|
||||
200: {
|
||||
headers: {
|
||||
[name: string]: unknown;
|
||||
};
|
||||
content: {
|
||||
'application/json': components['schemas']['SummaryResponseDto'];
|
||||
};
|
||||
};
|
||||
};
|
||||
};
|
||||
}
|
||||
|
||||
@@ -0,0 +1,29 @@
|
||||
import { describe, expect, it, vi } from 'vitest';
|
||||
|
||||
import type { RequestClient } from '@/utils/request';
|
||||
import { createMarketOverviewApi } from './index';
|
||||
|
||||
describe('市场概览业务 API', () => {
|
||||
it('使用独立版本化路径请求五个模块', async () => {
|
||||
const requestMock = vi.fn((config: Parameters<RequestClient>[0]) => {
|
||||
void config;
|
||||
return Promise.resolve({});
|
||||
});
|
||||
const requestClient = requestMock as unknown as RequestClient;
|
||||
const api = createMarketOverviewApi(requestClient);
|
||||
|
||||
await api.getSummary();
|
||||
await api.getIndices();
|
||||
await api.getBreadth();
|
||||
await api.getSectors();
|
||||
await api.getFunds();
|
||||
|
||||
expect(requestMock.mock.calls.map(([config]) => config.url)).toEqual([
|
||||
'/api/v1/market-overview/summary',
|
||||
'/api/v1/market-overview/indices',
|
||||
'/api/v1/market-overview/breadth',
|
||||
'/api/v1/market-overview/sectors',
|
||||
'/api/v1/market-overview/funds',
|
||||
]);
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,27 @@
|
||||
import request, { type RequestClient } from '@/utils/request';
|
||||
import type {
|
||||
BreadthResponse,
|
||||
FundsResponse,
|
||||
IndicesResponse,
|
||||
SectorsResponse,
|
||||
SummaryResponse,
|
||||
} from '@/types/market-overview';
|
||||
|
||||
export function createMarketOverviewApi(requestClient: RequestClient = request) {
|
||||
return {
|
||||
getSummary: () =>
|
||||
requestClient<SummaryResponse>({ method: 'get', url: '/api/v1/market-overview/summary' }),
|
||||
getIndices: () =>
|
||||
requestClient<IndicesResponse>({ method: 'get', url: '/api/v1/market-overview/indices' }),
|
||||
getBreadth: () =>
|
||||
requestClient<BreadthResponse>({ method: 'get', url: '/api/v1/market-overview/breadth' }),
|
||||
getSectors: () =>
|
||||
requestClient<SectorsResponse>({ method: 'get', url: '/api/v1/market-overview/sectors' }),
|
||||
getFunds: () =>
|
||||
requestClient<FundsResponse>({ method: 'get', url: '/api/v1/market-overview/funds' }),
|
||||
};
|
||||
}
|
||||
|
||||
const marketOverviewApi = createMarketOverviewApi();
|
||||
|
||||
export default marketOverviewApi;
|
||||
+23
-2
@@ -1,11 +1,32 @@
|
||||
import { createPinia } from 'pinia';
|
||||
import { mount } from '@vue/test-utils';
|
||||
import { createMemoryHistory } from 'vue-router';
|
||||
import { describe, expect, it } from 'vitest';
|
||||
import { describe, expect, it, vi } from 'vitest';
|
||||
|
||||
import App from './App.vue';
|
||||
import { createAppRouter } from './router';
|
||||
|
||||
// 应用外壳测试只验证导航和主区域，不应因页面挂载触发真实 Axios 请求。
|
||||
vi.mock('@/api/market-overview', () => {
|
||||
const response = {
|
||||
source: 'tdx',
|
||||
status: 'unavailable',
|
||||
data: null,
|
||||
snapshotId: 'test',
|
||||
asOf: '2026-08-18T00:00:00.000Z',
|
||||
warnings: ['测试环境未连接 TDX'],
|
||||
};
|
||||
return {
|
||||
default: {
|
||||
getSummary: vi.fn().mockResolvedValue(response),
|
||||
getIndices: vi.fn().mockResolvedValue(response),
|
||||
getBreadth: vi.fn().mockResolvedValue(response),
|
||||
getSectors: vi.fn().mockResolvedValue(response),
|
||||
getFunds: vi.fn().mockResolvedValue(response),
|
||||
},
|
||||
};
|
||||
});
|
||||
|
||||
describe('应用外壳', () => {
|
||||
it('提供可访问的应用标题和主内容区域', async () => {
|
||||
const router = createAppRouter(createMemoryHistory());
|
||||
@@ -21,6 +42,6 @@ describe('应用外壳', () => {
|
||||
expect(wrapper.get('header').attributes('aria-label')).toBe('应用导航');
|
||||
expect(wrapper.get('main').attributes('id')).toBe('main-content');
|
||||
expect(wrapper.text()).toContain('A 股市场分析工具');
|
||||
expect(wrapper.text()).toContain('工程基线已就绪');
|
||||
expect(wrapper.text()).toContain('市场综合概览');
|
||||
});
|
||||
});
|
||||
|
||||
+8
-2
@@ -10,8 +10,14 @@ const appTitle = import.meta.env.VITE_APP_TITLE || 'A 股市场分析工具';
|
||||
<NMessageProvider>
|
||||
<div class="app-shell">
|
||||
<header class="app-header" aria-label="应用导航">
|
||||
<span class="app-mark" aria-hidden="true">A</span>
|
||||
<strong>{{ appTitle }}</strong>
|
||||
<div class="app-identity">
|
||||
<span class="app-mark" aria-hidden="true">A</span>
|
||||
<div>
|
||||
<strong>{{ appTitle }}</strong>
|
||||
<small>市场复盘工作台</small>
|
||||
</div>
|
||||
</div>
|
||||
<span class="header-context">只读行情 · TDX</span>
|
||||
</header>
|
||||
<main id="main-content" class="app-main">
|
||||
<RouterView />
|
||||
|
||||
@@ -4,16 +4,14 @@ import {
|
||||
type RouterHistory,
|
||||
type RouteRecordRaw,
|
||||
} from 'vue-router';
|
||||
import { h } from 'vue';
|
||||
|
||||
import MarketOverviewPage from '@/views/market-overview/MarketOverviewPage.vue';
|
||||
|
||||
const routes: RouteRecordRaw[] = [
|
||||
{
|
||||
path: '/',
|
||||
name: 'home',
|
||||
component: {
|
||||
// 工程基线不引入运行时模板编译器；业务首页落地前用渲染函数提供可观测占位内容。
|
||||
render: () => h('section', { 'aria-label': '应用就绪' }, [h('p', '工程基线已就绪')]),
|
||||
},
|
||||
component: MarketOverviewPage,
|
||||
},
|
||||
];
|
||||
|
||||
|
||||
+532
-1
@@ -44,7 +44,7 @@ textarea {
|
||||
.app-header {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 10px;
|
||||
justify-content: space-between;
|
||||
min-height: 52px;
|
||||
padding: 0 20px;
|
||||
color: #fff;
|
||||
@@ -52,6 +52,29 @@ textarea {
|
||||
border-bottom: 1px solid #343b44;
|
||||
}
|
||||
|
||||
.app-identity {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 10px;
|
||||
}
|
||||
|
||||
.app-identity strong,
|
||||
.app-identity small {
|
||||
display: block;
|
||||
}
|
||||
|
||||
.app-identity small {
|
||||
margin-top: 2px;
|
||||
color: #aeb7c2;
|
||||
font-size: 11px;
|
||||
font-weight: 500;
|
||||
}
|
||||
|
||||
.header-context {
|
||||
color: #aeb7c2;
|
||||
font-size: 12px;
|
||||
}
|
||||
|
||||
.app-mark {
|
||||
display: inline-grid;
|
||||
width: 28px;
|
||||
@@ -69,10 +92,518 @@ textarea {
|
||||
padding: 20px;
|
||||
}
|
||||
|
||||
.market-overview-page {
|
||||
display: grid;
|
||||
gap: 16px;
|
||||
}
|
||||
|
||||
.overview-toolbar {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: space-between;
|
||||
gap: 14px;
|
||||
min-height: 42px;
|
||||
}
|
||||
|
||||
.view-switcher {
|
||||
display: inline-flex;
|
||||
padding: 3px;
|
||||
background: #e8edf1;
|
||||
border: 1px solid #d5dce3;
|
||||
border-radius: 6px;
|
||||
}
|
||||
|
||||
.view-switcher button,
|
||||
.refresh-button,
|
||||
.quiet-button,
|
||||
.sector-list button {
|
||||
border: 0;
|
||||
border-radius: 4px;
|
||||
cursor: pointer;
|
||||
font: inherit;
|
||||
}
|
||||
|
||||
.view-switcher button {
|
||||
min-width: 72px;
|
||||
padding: 7px 12px;
|
||||
color: #4c5966;
|
||||
background: transparent;
|
||||
font-size: 13px;
|
||||
}
|
||||
|
||||
.view-switcher button.active {
|
||||
color: #17212b;
|
||||
background: #fff;
|
||||
box-shadow: 0 1px 3px rgb(28 40 52 / 14%);
|
||||
}
|
||||
|
||||
.toolbar-actions {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 10px;
|
||||
}
|
||||
|
||||
.toolbar-actions label {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 7px;
|
||||
color: #65717d;
|
||||
font-size: 12px;
|
||||
}
|
||||
|
||||
.toolbar-actions select {
|
||||
min-height: 32px;
|
||||
padding: 0 28px 0 9px;
|
||||
color: #24303b;
|
||||
background: #fff;
|
||||
border: 1px solid #ccd4dc;
|
||||
border-radius: 4px;
|
||||
font: inherit;
|
||||
}
|
||||
|
||||
.refresh-button {
|
||||
min-height: 32px;
|
||||
padding: 0 12px;
|
||||
color: #fff;
|
||||
background: #167d82;
|
||||
font-size: 12px;
|
||||
}
|
||||
|
||||
.refresh-button:disabled {
|
||||
cursor: wait;
|
||||
opacity: 0.55;
|
||||
}
|
||||
|
||||
.overview-conclusion,
|
||||
.overview-panel {
|
||||
background: #fff;
|
||||
border: 1px solid #dbe1e6;
|
||||
border-radius: 7px;
|
||||
box-shadow: 0 3px 14px rgb(26 38 49 / 5%);
|
||||
}
|
||||
|
||||
.overview-conclusion {
|
||||
padding: 22px 24px 18px;
|
||||
}
|
||||
|
||||
.section-kicker {
|
||||
color: #167d82;
|
||||
font-size: 11px;
|
||||
font-weight: 700;
|
||||
letter-spacing: 0.08em;
|
||||
text-transform: uppercase;
|
||||
}
|
||||
|
||||
.conclusion-heading,
|
||||
.panel-heading {
|
||||
display: flex;
|
||||
align-items: flex-start;
|
||||
justify-content: space-between;
|
||||
gap: 16px;
|
||||
}
|
||||
|
||||
.conclusion-heading {
|
||||
margin-top: 8px;
|
||||
}
|
||||
|
||||
.conclusion-heading h1,
|
||||
.panel-heading h2 {
|
||||
margin: 0;
|
||||
color: #17212b;
|
||||
letter-spacing: 0;
|
||||
}
|
||||
|
||||
.conclusion-heading h1 {
|
||||
font-size: clamp(24px, 3vw, 38px);
|
||||
line-height: 1.2;
|
||||
}
|
||||
|
||||
.panel-heading h2 {
|
||||
margin-top: 4px;
|
||||
font-size: 17px;
|
||||
}
|
||||
|
||||
.conclusion-copy {
|
||||
margin: 10px 0 0;
|
||||
color: #475563;
|
||||
font-size: 15px;
|
||||
}
|
||||
|
||||
.source-status {
|
||||
display: grid;
|
||||
grid-template-columns: auto auto;
|
||||
align-items: center;
|
||||
gap: 5px 7px;
|
||||
min-width: 142px;
|
||||
padding: 9px 11px;
|
||||
color: #167d82;
|
||||
background: #eff8f7;
|
||||
border: 1px solid #cbe6e2;
|
||||
border-radius: 5px;
|
||||
font-size: 12px;
|
||||
font-weight: 700;
|
||||
}
|
||||
|
||||
.source-status small {
|
||||
grid-column: 1 / -1;
|
||||
color: #6d7a85;
|
||||
font-size: 10px;
|
||||
font-weight: 500;
|
||||
}
|
||||
|
||||
.source-status[data-status='unavailable'] {
|
||||
color: #a45e1b;
|
||||
background: #fff7ec;
|
||||
border-color: #f0d7b5;
|
||||
}
|
||||
|
||||
.status-dot {
|
||||
width: 7px;
|
||||
height: 7px;
|
||||
background: currentcolor;
|
||||
border-radius: 50%;
|
||||
}
|
||||
|
||||
.conclusion-facts {
|
||||
display: grid;
|
||||
grid-template-columns: repeat(3, minmax(0, 1fr));
|
||||
gap: 10px;
|
||||
margin-top: 21px;
|
||||
padding-top: 15px;
|
||||
border-top: 1px solid #e6eaee;
|
||||
}
|
||||
|
||||
.conclusion-facts div {
|
||||
display: grid;
|
||||
gap: 5px;
|
||||
}
|
||||
|
||||
.conclusion-facts span,
|
||||
.panel-meta,
|
||||
.breadth-values span,
|
||||
.column-label {
|
||||
color: #7b8792;
|
||||
font-size: 11px;
|
||||
}
|
||||
|
||||
.conclusion-facts strong {
|
||||
color: #2e3b47;
|
||||
font-size: 14px;
|
||||
}
|
||||
|
||||
.module-warning {
|
||||
margin: 13px 0 0;
|
||||
color: #a45e1b;
|
||||
font-size: 12px;
|
||||
}
|
||||
|
||||
.overview-panel .module-warning {
|
||||
display: flex;
|
||||
gap: 8px;
|
||||
padding: 7px 9px;
|
||||
border-left: 3px solid #b67a2d;
|
||||
background: #fff8ec;
|
||||
}
|
||||
|
||||
.overview-panel .module-warning strong {
|
||||
white-space: nowrap;
|
||||
}
|
||||
|
||||
.overview-grid {
|
||||
display: grid;
|
||||
gap: 16px;
|
||||
}
|
||||
|
||||
.overview-grid-top {
|
||||
grid-template-columns: minmax(0, 0.9fr) minmax(0, 1.1fr);
|
||||
}
|
||||
|
||||
.overview-grid-bottom {
|
||||
grid-template-columns: repeat(3, minmax(0, 1fr));
|
||||
}
|
||||
|
||||
.overview-panel {
|
||||
min-height: 190px;
|
||||
padding: 18px;
|
||||
}
|
||||
|
||||
.panel-heading {
|
||||
align-items: center;
|
||||
margin-bottom: 17px;
|
||||
}
|
||||
|
||||
.panel-meta {
|
||||
white-space: nowrap;
|
||||
}
|
||||
|
||||
.quiet-button {
|
||||
padding: 6px 9px;
|
||||
color: #167d82;
|
||||
background: #eff8f7;
|
||||
font-size: 11px;
|
||||
}
|
||||
|
||||
.drivers-grid {
|
||||
display: grid;
|
||||
grid-template-columns: 1fr 1fr;
|
||||
gap: 17px;
|
||||
}
|
||||
|
||||
.driver-column + .driver-column {
|
||||
padding-left: 17px;
|
||||
border-left: 1px solid #e6eaee;
|
||||
}
|
||||
|
||||
.column-label {
|
||||
display: block;
|
||||
margin-bottom: 8px;
|
||||
font-weight: 700;
|
||||
}
|
||||
|
||||
.column-label.positive,
|
||||
.positive {
|
||||
color: #c33f3f;
|
||||
}
|
||||
|
||||
.column-label.negative,
|
||||
.negative {
|
||||
color: #19846e;
|
||||
}
|
||||
|
||||
.driver-column ul {
|
||||
display: grid;
|
||||
gap: 8px;
|
||||
margin: 0;
|
||||
padding: 0;
|
||||
color: #485664;
|
||||
font-size: 12px;
|
||||
line-height: 1.55;
|
||||
list-style: none;
|
||||
}
|
||||
|
||||
.driver-column li {
|
||||
position: relative;
|
||||
padding-left: 13px;
|
||||
}
|
||||
|
||||
.driver-column li::before {
|
||||
position: absolute;
|
||||
top: 0.62em;
|
||||
left: 0;
|
||||
width: 5px;
|
||||
height: 5px;
|
||||
background: #aeb8c1;
|
||||
border-radius: 50%;
|
||||
content: '';
|
||||
}
|
||||
|
||||
.index-grid {
|
||||
display: grid;
|
||||
grid-template-columns: repeat(3, minmax(0, 1fr));
|
||||
gap: 9px;
|
||||
}
|
||||
|
||||
.index-item {
|
||||
display: grid;
|
||||
gap: 7px;
|
||||
min-height: 112px;
|
||||
padding: 13px;
|
||||
color: #4c5966;
|
||||
text-align: left;
|
||||
background: #f8fafb;
|
||||
border: 1px solid #e3e8ec;
|
||||
border-radius: 5px;
|
||||
cursor: pointer;
|
||||
font: inherit;
|
||||
}
|
||||
|
||||
.index-item:hover {
|
||||
border-color: #a5c9c7;
|
||||
box-shadow: 0 2px 8px rgb(26 38 49 / 8%);
|
||||
}
|
||||
|
||||
.index-item strong {
|
||||
color: #1c2a35;
|
||||
font-size: 20px;
|
||||
}
|
||||
|
||||
.index-item small {
|
||||
color: #7d8893;
|
||||
font-size: 12px;
|
||||
}
|
||||
|
||||
.index-item[data-direction='up'] small {
|
||||
color: #c33f3f;
|
||||
}
|
||||
|
||||
.index-item[data-direction='down'] small {
|
||||
color: #19846e;
|
||||
}
|
||||
|
||||
.breadth-values {
|
||||
display: grid;
|
||||
grid-template-columns: repeat(3, 1fr);
|
||||
gap: 8px;
|
||||
margin-top: 32px;
|
||||
}
|
||||
|
||||
.breadth-values div {
|
||||
display: grid;
|
||||
gap: 8px;
|
||||
text-align: center;
|
||||
}
|
||||
|
||||
.breadth-values strong {
|
||||
color: #2e3b47;
|
||||
font-size: 25px;
|
||||
}
|
||||
|
||||
.module-placeholder,
|
||||
.module-unavailable {
|
||||
display: grid;
|
||||
align-content: center;
|
||||
min-height: 104px;
|
||||
gap: 6px;
|
||||
color: #8a959f;
|
||||
font-size: 12px;
|
||||
}
|
||||
|
||||
.module-unavailable strong {
|
||||
color: #a45e1b;
|
||||
font-size: 13px;
|
||||
}
|
||||
|
||||
.module-unavailable span {
|
||||
line-height: 1.5;
|
||||
}
|
||||
|
||||
.sector-list {
|
||||
display: flex;
|
||||
flex-wrap: wrap;
|
||||
gap: 7px;
|
||||
}
|
||||
|
||||
.sector-list button {
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
justify-content: space-between;
|
||||
min-width: 112px;
|
||||
gap: 10px;
|
||||
padding: 7px 9px;
|
||||
color: #4c5966;
|
||||
background: #f3f7f7;
|
||||
font-size: 12px;
|
||||
}
|
||||
|
||||
.sector-list button strong {
|
||||
font-weight: 650;
|
||||
}
|
||||
|
||||
.sector-list button[data-direction='up'] strong,
|
||||
.turnover-trend [data-direction='up'] {
|
||||
color: #c33f3f;
|
||||
}
|
||||
|
||||
.sector-list button[data-direction='down'] strong,
|
||||
.turnover-trend [data-direction='down'] {
|
||||
color: #19846e;
|
||||
}
|
||||
|
||||
.turnover-trend [data-direction='flat'] {
|
||||
color: #6f7a84;
|
||||
}
|
||||
|
||||
.turnover-trend {
|
||||
display: grid;
|
||||
gap: 12px;
|
||||
margin-top: 24px;
|
||||
}
|
||||
|
||||
.turnover-trend div {
|
||||
display: flex;
|
||||
align-items: baseline;
|
||||
gap: 7px;
|
||||
}
|
||||
|
||||
.turnover-trend strong {
|
||||
color: #1c2a35;
|
||||
font-size: 25px;
|
||||
}
|
||||
|
||||
.turnover-trend small,
|
||||
.turnover-trend p {
|
||||
color: #7d8893;
|
||||
font-size: 12px;
|
||||
}
|
||||
|
||||
@media (max-width: 900px) {
|
||||
.overview-grid-top,
|
||||
.overview-grid-bottom {
|
||||
grid-template-columns: 1fr;
|
||||
}
|
||||
}
|
||||
|
||||
@media (max-width: 600px) {
|
||||
.app-header,
|
||||
.app-main {
|
||||
padding-right: 14px;
|
||||
padding-left: 14px;
|
||||
}
|
||||
|
||||
.header-context {
|
||||
display: none;
|
||||
}
|
||||
|
||||
.overview-toolbar,
|
||||
.conclusion-heading {
|
||||
align-items: stretch;
|
||||
flex-direction: column;
|
||||
}
|
||||
|
||||
.toolbar-actions {
|
||||
justify-content: space-between;
|
||||
}
|
||||
|
||||
.view-switcher {
|
||||
width: 100%;
|
||||
}
|
||||
|
||||
.view-switcher button {
|
||||
flex: 1;
|
||||
}
|
||||
|
||||
.overview-conclusion {
|
||||
padding: 18px 16px 15px;
|
||||
}
|
||||
|
||||
.conclusion-heading h1 {
|
||||
font-size: 27px;
|
||||
}
|
||||
|
||||
.source-status {
|
||||
width: 100%;
|
||||
}
|
||||
|
||||
.conclusion-facts {
|
||||
gap: 7px;
|
||||
}
|
||||
|
||||
.conclusion-facts strong {
|
||||
font-size: 12px;
|
||||
}
|
||||
|
||||
.drivers-grid {
|
||||
grid-template-columns: 1fr;
|
||||
}
|
||||
|
||||
.driver-column + .driver-column {
|
||||
padding-top: 14px;
|
||||
padding-left: 0;
|
||||
border-top: 1px solid #e6eaee;
|
||||
border-left: 0;
|
||||
}
|
||||
|
||||
.index-grid {
|
||||
grid-template-columns: 1fr;
|
||||
}
|
||||
}
|
||||
|
||||
@@ -0,0 +1,14 @@
|
||||
import type { components } from '@/api/generated/schema';
|
||||
|
||||
export type SummaryResponse = components['schemas']['SummaryResponseDto'];
|
||||
export type IndicesResponse = components['schemas']['IndicesResponseDto'];
|
||||
export type BreadthResponse = components['schemas']['BreadthResponseDto'];
|
||||
export type SectorsResponse = components['schemas']['SectorsResponseDto'];
|
||||
export type FundsResponse = components['schemas']['FundsResponseDto'];
|
||||
export type SummaryData = NonNullable<SummaryResponse['data']>;
|
||||
export type IndicesData = NonNullable<IndicesResponse['data']>;
|
||||
export type BreadthData = NonNullable<BreadthResponse['data']>;
|
||||
export type SectorsData = NonNullable<SectorsResponse['data']>;
|
||||
export type FundsData = NonNullable<FundsResponse['data']>;
|
||||
|
||||
export type OverviewModuleStatus = 'idle' | 'loading' | 'ready' | 'error';
|
||||
@@ -0,0 +1,96 @@
|
||||
<script setup lang="ts">
|
||||
import { onMounted } from 'vue';
|
||||
|
||||
import MarketBreadth from './components/MarketBreadth.vue';
|
||||
import MarketConclusion from './components/MarketConclusion.vue';
|
||||
import MarketDrivers from './components/MarketDrivers.vue';
|
||||
import SectorOverview from './components/SectorOverview.vue';
|
||||
import FundTrend from './components/FundTrend.vue';
|
||||
import IndexOverview from './components/IndexOverview.vue';
|
||||
import { useMarketOverview } from './useMarketOverview';
|
||||
|
||||
const {
|
||||
summary,
|
||||
indices,
|
||||
breadth,
|
||||
sectors,
|
||||
funds,
|
||||
isLoading,
|
||||
analysisHorizon,
|
||||
analysisEngine,
|
||||
refresh,
|
||||
setAnalysisHorizon,
|
||||
setAnalysisEngine,
|
||||
} = useMarketOverview();
|
||||
|
||||
onMounted(() => {
|
||||
void refresh();
|
||||
});
|
||||
|
||||
function openDetail(label: string) {
|
||||
// 详情页尚未立项，先保留明确入口并避免伪造导航地址。
|
||||
console.info(`市场概览详情入口：${label}`);
|
||||
}
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<div class="market-overview-page">
|
||||
<div class="overview-toolbar">
|
||||
<div class="view-switcher" aria-label="分析视角">
|
||||
<button
|
||||
v-for="option in ['综合', '短线', '中长线']"
|
||||
:key="option"
|
||||
type="button"
|
||||
:class="{ active: analysisHorizon === option }"
|
||||
@click="setAnalysisHorizon(option)"
|
||||
>
|
||||
{{ option }}
|
||||
</button>
|
||||
</div>
|
||||
<div class="toolbar-actions">
|
||||
<label>
|
||||
<span>分析引擎</span>
|
||||
<select
|
||||
:value="analysisEngine"
|
||||
@change="setAnalysisEngine(($event.target as HTMLSelectElement).value)"
|
||||
>
|
||||
<option>规则</option>
|
||||
<option>AI</option>
|
||||
<option>混合</option>
|
||||
<option>对照</option>
|
||||
</select>
|
||||
</label>
|
||||
<button
|
||||
type="button"
|
||||
class="refresh-button"
|
||||
:disabled="isLoading"
|
||||
title="重新读取 TDX 行情"
|
||||
@click="refresh"
|
||||
>
|
||||
{{ isLoading ? '读取中…' : '刷新行情' }}
|
||||
</button>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<MarketConclusion :response="summary.response" :loading="summary.status === 'loading'" />
|
||||
|
||||
<div class="overview-grid overview-grid-top">
|
||||
<MarketDrivers :response="summary.response" />
|
||||
<IndexOverview
|
||||
:response="indices.response"
|
||||
:loading="indices.status === 'loading'"
|
||||
@select="openDetail"
|
||||
/>
|
||||
</div>
|
||||
|
||||
<div class="overview-grid overview-grid-bottom">
|
||||
<MarketBreadth :response="breadth.response" :loading="breadth.status === 'loading'" />
|
||||
<SectorOverview
|
||||
:response="sectors.response"
|
||||
:loading="sectors.status === 'loading'"
|
||||
@select="openDetail"
|
||||
/>
|
||||
<FundTrend :response="funds.response" :loading="funds.status === 'loading'" />
|
||||
</div>
|
||||
</div>
|
||||
</template>
|
||||
@@ -0,0 +1,53 @@
|
||||
<script setup lang="ts">
|
||||
import type { FundsResponse } from '@/types/market-overview';
|
||||
|
||||
defineProps<{ response: FundsResponse | null; loading: boolean }>();
|
||||
|
||||
function formatTradeDate(value: string | undefined): string {
|
||||
return value?.length === 8 ? `${value.slice(0, 4)}-${value.slice(4, 6)}-${value.slice(6)}` : '—';
|
||||
}
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<section class="overview-panel" aria-labelledby="funds-title">
|
||||
<div class="panel-heading">
|
||||
<div>
|
||||
<span class="section-kicker">量能观察</span>
|
||||
<h2 id="funds-title">成交额趋势</h2>
|
||||
</div>
|
||||
<span class="panel-meta">{{ formatTradeDate(response?.data?.tradeDate) }}</span>
|
||||
</div>
|
||||
<div v-if="loading" class="module-placeholder">正在读取资金趋势…</div>
|
||||
<div v-else-if="response?.status === 'unavailable'" class="module-unavailable">
|
||||
<strong>暂不可用</strong>
|
||||
<span>{{ response.warnings[0] }}</span>
|
||||
</div>
|
||||
<template v-else-if="response?.data">
|
||||
<div v-if="response.status !== 'fresh'" class="module-warning">
|
||||
<strong>{{ response.status === 'partial' ? '部分数据' : '数据延迟' }}</strong>
|
||||
<span>{{ response.warnings[0] }}</span>
|
||||
</div>
|
||||
<div class="turnover-trend">
|
||||
<div>
|
||||
<span>{{ response.data.marketCount }} 市成交额</span>
|
||||
<strong>{{ response.data.currentAmount.toLocaleString('zh-CN') }}</strong>
|
||||
<small>{{ response.data.unit }}</small>
|
||||
</div>
|
||||
<p
|
||||
:data-direction="
|
||||
response.data.changePercent === 0
|
||||
? 'flat'
|
||||
: response.data.changePercent > 0
|
||||
? 'up'
|
||||
: 'down'
|
||||
"
|
||||
>
|
||||
较前一交易日
|
||||
{{ response.data.changePercent > 0 ? '+' : ''
|
||||
}}{{ response.data.changePercent.toFixed(2) }}%
|
||||
</p>
|
||||
</div>
|
||||
</template>
|
||||
<div v-else class="module-placeholder">暂无成交额趋势数据</div>
|
||||
</section>
|
||||
</template>
|
||||
@@ -0,0 +1,41 @@
|
||||
<script setup lang="ts">
|
||||
import type { IndicesResponse } from '@/types/market-overview';
|
||||
|
||||
defineProps<{ response: IndicesResponse | null; loading: boolean }>();
|
||||
const emit = defineEmits<{ select: [code: string] }>();
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<section class="overview-panel" aria-labelledby="indices-title">
|
||||
<div class="panel-heading">
|
||||
<div>
|
||||
<span class="section-kicker">核心指数</span>
|
||||
<h2 id="indices-title">主要市场温度</h2>
|
||||
</div>
|
||||
<span class="panel-meta">{{ response?.asOf ? response.asOf.slice(11, 19) : '—' }}</span>
|
||||
</div>
|
||||
<div v-if="loading" class="module-placeholder">正在读取指数…</div>
|
||||
<div v-else-if="!response?.data?.items.length" class="module-placeholder">
|
||||
TDX 指数数据不可用
|
||||
</div>
|
||||
<div v-else class="index-grid">
|
||||
<button
|
||||
v-for="item in response.data.items"
|
||||
:key="item.code"
|
||||
type="button"
|
||||
class="index-item"
|
||||
:data-direction="item.direction"
|
||||
:title="`进入${item.name}详细分析`"
|
||||
@click="emit('select', item.code)"
|
||||
>
|
||||
<span>{{ item.name }}</span>
|
||||
<strong>{{ item.price.toFixed(2) }}</strong>
|
||||
<small>{{
|
||||
item.changePercent == null
|
||||
? '—'
|
||||
: `${item.changePercent > 0 ? '+' : ''}${item.changePercent.toFixed(2)}%`
|
||||
}}</small>
|
||||
</button>
|
||||
</div>
|
||||
</section>
|
||||
</template>
|
||||
@@ -0,0 +1,40 @@
|
||||
<script setup lang="ts">
|
||||
import type { BreadthResponse } from '@/types/market-overview';
|
||||
|
||||
defineProps<{ response: BreadthResponse | null; loading: boolean }>();
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<section class="overview-panel" aria-labelledby="breadth-title">
|
||||
<div class="panel-heading">
|
||||
<div>
|
||||
<span class="section-kicker">市场宽度</span>
|
||||
<h2 id="breadth-title">涨跌分布与量能</h2>
|
||||
</div>
|
||||
<span class="panel-meta">分钟级</span>
|
||||
</div>
|
||||
<div v-if="loading" class="module-placeholder">正在读取市场宽度…</div>
|
||||
<div v-else-if="response?.status === 'unavailable'" class="module-unavailable">
|
||||
<strong>暂不可用</strong>
|
||||
<span>{{ response.warnings[0] }}</span>
|
||||
</div>
|
||||
<template v-else-if="response?.data">
|
||||
<div v-if="response.status !== 'fresh'" class="module-warning">
|
||||
<strong>{{ response.status === 'partial' ? '部分数据' : '数据延迟' }}</strong>
|
||||
<span>{{ response.warnings[0] }}</span>
|
||||
</div>
|
||||
<div class="breadth-values">
|
||||
<div>
|
||||
<span>上涨</span><strong class="positive">{{ response.data.advancing }}</strong>
|
||||
</div>
|
||||
<div>
|
||||
<span>下跌</span><strong class="negative">{{ response.data.declining }}</strong>
|
||||
</div>
|
||||
<div>
|
||||
<span>平盘</span><strong>{{ response.data.unchanged ?? '—' }}</strong>
|
||||
</div>
|
||||
</div>
|
||||
</template>
|
||||
<div v-else class="module-placeholder">暂无宽度数据</div>
|
||||
</section>
|
||||
</template>
|
||||
@@ -0,0 +1,42 @@
|
||||
<script setup lang="ts">
|
||||
import type { SummaryResponse } from '@/types/market-overview';
|
||||
|
||||
defineProps<{
|
||||
response: SummaryResponse | null;
|
||||
loading: boolean;
|
||||
}>();
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<section class="overview-conclusion" aria-labelledby="market-overview-title">
|
||||
<div class="section-kicker">市场综合概览</div>
|
||||
<div class="conclusion-heading">
|
||||
<div>
|
||||
<h1 id="market-overview-title">盘面先看结论，再看证据</h1>
|
||||
<p class="conclusion-copy">
|
||||
{{ loading ? '正在读取 TDX 行情…' : response?.data?.verdict || 'TDX 数据暂不可用' }}
|
||||
</p>
|
||||
</div>
|
||||
<div class="source-status" :data-status="response?.status || 'unavailable'">
|
||||
<span class="status-dot" aria-hidden="true"></span>
|
||||
<span>{{ response?.source === 'tdx' ? 'TDX 行情' : '等待数据' }}</span>
|
||||
<small>{{ response?.asOf ? `更新于 ${response.asOf}` : '尚未连接' }}</small>
|
||||
</div>
|
||||
</div>
|
||||
<div class="conclusion-facts">
|
||||
<div>
|
||||
<span>市场状态</span>
|
||||
<strong>{{ response?.data?.marketStatus || '待确认' }}</strong>
|
||||
</div>
|
||||
<div>
|
||||
<span>量能状态</span>
|
||||
<strong>{{ response?.data?.volumeStatus || '待确认' }}</strong>
|
||||
</div>
|
||||
<div>
|
||||
<span>情绪状态</span>
|
||||
<strong>{{ response?.data?.sentimentStatus || '待确认' }}</strong>
|
||||
</div>
|
||||
</div>
|
||||
<p v-if="response?.warnings.length" class="module-warning">{{ response.warnings[0] }}</p>
|
||||
</section>
|
||||
</template>
|
||||
@@ -0,0 +1,155 @@
|
||||
import { mount } from '@vue/test-utils';
|
||||
import { describe, expect, it } from 'vitest';
|
||||
|
||||
import FundTrend from './FundTrend.vue';
|
||||
import MarketBreadth from './MarketBreadth.vue';
|
||||
import SectorOverview from './SectorOverview.vue';
|
||||
|
||||
const meta = {
|
||||
snapshotId: '20260818-150000',
|
||||
asOf: '2026-08-18T15:00:00.000Z',
|
||||
source: 'tdx' as const,
|
||||
status: 'fresh' as const,
|
||||
warnings: [],
|
||||
};
|
||||
|
||||
describe('市场概览真实数据面板', () => {
|
||||
it('市场宽度对未知平盘家数显示占位符而不是零', () => {
|
||||
const wrapper = mount(MarketBreadth, {
|
||||
props: {
|
||||
loading: false,
|
||||
response: { ...meta, data: { advancing: 2121, declining: 3292, unchanged: null } },
|
||||
},
|
||||
});
|
||||
|
||||
expect(wrapper.text()).toContain('2121');
|
||||
expect(wrapper.text()).toContain('3292');
|
||||
expect(wrapper.text()).toContain('平盘—');
|
||||
});
|
||||
|
||||
it('板块展示名称和涨跌幅并以代码触发详情入口', async () => {
|
||||
const wrapper = mount(SectorOverview, {
|
||||
props: {
|
||||
loading: false,
|
||||
response: {
|
||||
...meta,
|
||||
data: {
|
||||
items: [
|
||||
{
|
||||
code: '881319.SH',
|
||||
name: '半导体',
|
||||
changePercent: 2.56,
|
||||
direction: 'up',
|
||||
tradeDate: '20260818',
|
||||
},
|
||||
],
|
||||
},
|
||||
},
|
||||
},
|
||||
});
|
||||
|
||||
expect(wrapper.text()).toContain('半导体');
|
||||
expect(wrapper.text()).toContain('+2.56%');
|
||||
await wrapper.get('button').trigger('click');
|
||||
expect(wrapper.emitted('select')).toEqual([['881319.SH']]);
|
||||
});
|
||||
|
||||
it('市场宽度 partial 状态显示警告且保留有效数据', () => {
|
||||
const wrapper = mount(MarketBreadth, {
|
||||
props: {
|
||||
loading: false,
|
||||
response: {
|
||||
...meta,
|
||||
status: 'partial',
|
||||
warnings: ['部分市场涨跌家数不可用：北证市场'],
|
||||
data: { advancing: 10, declining: 5, unchanged: null },
|
||||
},
|
||||
},
|
||||
});
|
||||
|
||||
expect(wrapper.text()).toContain('部分数据');
|
||||
expect(wrapper.text()).toContain('北证市场');
|
||||
expect(wrapper.text()).toContain('10');
|
||||
});
|
||||
|
||||
it('板块 delayed 状态显示警告和真实交易日期', () => {
|
||||
const wrapper = mount(SectorOverview, {
|
||||
props: {
|
||||
loading: false,
|
||||
response: {
|
||||
...meta,
|
||||
status: 'delayed',
|
||||
warnings: ['板块数据已延迟'],
|
||||
data: {
|
||||
items: [
|
||||
{
|
||||
code: '881319.SH',
|
||||
name: '半导体',
|
||||
changePercent: 2.56,
|
||||
direction: 'up',
|
||||
tradeDate: '20260818',
|
||||
},
|
||||
],
|
||||
},
|
||||
},
|
||||
},
|
||||
});
|
||||
|
||||
expect(wrapper.text()).toContain('数据延迟');
|
||||
expect(wrapper.text()).toContain('板块数据已延迟');
|
||||
expect(wrapper.text()).toContain('2026-08-18');
|
||||
});
|
||||
|
||||
it('资金模块明确展示成交额和与上一交易日的变化', () => {
|
||||
const wrapper = mount(FundTrend, {
|
||||
props: {
|
||||
loading: false,
|
||||
response: {
|
||||
...meta,
|
||||
data: {
|
||||
currentAmount: 12345.67,
|
||||
previousAmount: 11000,
|
||||
changePercent: 12.23,
|
||||
unit: '亿元' as const,
|
||||
marketCount: 3,
|
||||
tradeDate: '20260818',
|
||||
previousTradeDate: '20260817',
|
||||
},
|
||||
},
|
||||
},
|
||||
});
|
||||
|
||||
expect(wrapper.text()).toContain('成交额趋势');
|
||||
expect(wrapper.text()).toContain('12,345.67');
|
||||
expect(wrapper.text()).toContain('较前一交易日 +12.23%');
|
||||
expect(wrapper.text()).not.toContain('主力净流入');
|
||||
});
|
||||
|
||||
it('部分数据保留数值并显示警告和实际交易日期', () => {
|
||||
const wrapper = mount(FundTrend, {
|
||||
props: {
|
||||
loading: false,
|
||||
response: {
|
||||
...meta,
|
||||
status: 'partial',
|
||||
warnings: ['部分市场成交额不可用，当前汇总 2 个市场'],
|
||||
data: {
|
||||
currentAmount: 100,
|
||||
previousAmount: 100,
|
||||
changePercent: 0,
|
||||
unit: '亿元' as const,
|
||||
marketCount: 2,
|
||||
tradeDate: '20260818',
|
||||
previousTradeDate: '20260817',
|
||||
},
|
||||
},
|
||||
},
|
||||
});
|
||||
|
||||
expect(wrapper.text()).toContain('部分数据');
|
||||
expect(wrapper.text()).toContain('部分市场成交额不可用');
|
||||
expect(wrapper.text()).toContain('2 市成交额');
|
||||
expect(wrapper.text()).toContain('2026-08-18');
|
||||
expect(wrapper.get('[data-direction="flat"]').attributes('data-direction')).toBe('flat');
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,33 @@
|
||||
<script setup lang="ts">
|
||||
import type { SummaryResponse } from '@/types/market-overview';
|
||||
|
||||
defineProps<{ response: SummaryResponse | null }>();
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<section class="overview-panel drivers-panel" aria-labelledby="drivers-title">
|
||||
<div class="panel-heading">
|
||||
<div>
|
||||
<span class="section-kicker">判断依据</span>
|
||||
<h2 id="drivers-title">驱动与风险</h2>
|
||||
</div>
|
||||
<button type="button" class="quiet-button" title="查看当前结论依据">查看依据</button>
|
||||
</div>
|
||||
<div class="drivers-grid">
|
||||
<div class="driver-column">
|
||||
<span class="column-label positive">驱动</span>
|
||||
<ul>
|
||||
<li v-for="driver in response?.data?.drivers || ['等待 TDX 数据']" :key="driver">
|
||||
{{ driver }}
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
<div class="driver-column">
|
||||
<span class="column-label negative">风险</span>
|
||||
<ul>
|
||||
<li v-for="risk in response?.data?.risks || ['等待 TDX 数据']" :key="risk">{{ risk }}</li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
</template>
|
||||
@@ -0,0 +1,49 @@
|
||||
<script setup lang="ts">
|
||||
import type { SectorsResponse } from '@/types/market-overview';
|
||||
|
||||
defineProps<{ response: SectorsResponse | null; loading: boolean }>();
|
||||
const emit = defineEmits<{ select: [sector: string] }>();
|
||||
|
||||
function formatTradeDate(value: string | undefined): string {
|
||||
return value?.length === 8 ? `${value.slice(0, 4)}-${value.slice(4, 6)}-${value.slice(6)}` : '—';
|
||||
}
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<section class="overview-panel" aria-labelledby="sectors-title">
|
||||
<div class="panel-heading">
|
||||
<div>
|
||||
<span class="section-kicker">板块扫描</span>
|
||||
<h2 id="sectors-title">强弱分布</h2>
|
||||
</div>
|
||||
<span class="panel-meta">{{ formatTradeDate(response?.data?.items[0]?.tradeDate) }}</span>
|
||||
</div>
|
||||
<div v-if="loading" class="module-placeholder">正在读取板块…</div>
|
||||
<div v-else-if="response?.status === 'unavailable'" class="module-unavailable">
|
||||
<strong>暂不可用</strong>
|
||||
<span>{{ response.warnings[0] }}</span>
|
||||
</div>
|
||||
<template v-else-if="response?.data?.items.length">
|
||||
<div v-if="response.status !== 'fresh'" class="module-warning">
|
||||
<strong>{{ response.status === 'partial' ? '部分数据' : '数据延迟' }}</strong>
|
||||
<span>{{ response.warnings[0] }}</span>
|
||||
</div>
|
||||
<div class="sector-list">
|
||||
<button
|
||||
v-for="sector in response.data.items"
|
||||
:key="sector.code"
|
||||
type="button"
|
||||
:data-direction="sector.direction"
|
||||
:title="`进入${sector.name}详细分析`"
|
||||
@click="emit('select', sector.code)"
|
||||
>
|
||||
<span>{{ sector.name }}</span>
|
||||
<strong>{{
|
||||
`${sector.changePercent > 0 ? '+' : ''}${sector.changePercent.toFixed(2)}%`
|
||||
}}</strong>
|
||||
</button>
|
||||
</div>
|
||||
</template>
|
||||
<div v-else class="module-placeholder">暂无板块数据</div>
|
||||
</section>
|
||||
</template>
|
||||
@@ -0,0 +1,43 @@
|
||||
import { describe, expect, it, vi } from 'vitest';
|
||||
|
||||
import { useMarketOverview } from './useMarketOverview';
|
||||
|
||||
const response = {
|
||||
source: 'tdx',
|
||||
status: 'fresh',
|
||||
data: null,
|
||||
snapshotId: '20260818-101500',
|
||||
asOf: '2026-08-18T10:15:00+08:00',
|
||||
warnings: [],
|
||||
} as const;
|
||||
|
||||
describe('市场概览状态', () => {
|
||||
it('并行加载五个模块，一个模块失败不影响其他模块', async () => {
|
||||
const api = {
|
||||
getSummary: vi.fn().mockResolvedValue(response),
|
||||
getIndices: vi.fn().mockRejectedValue(new Error('failed')),
|
||||
getBreadth: vi.fn().mockResolvedValue(response),
|
||||
getSectors: vi.fn().mockResolvedValue(response),
|
||||
getFunds: vi.fn().mockResolvedValue(response),
|
||||
};
|
||||
const state = useMarketOverview(api);
|
||||
|
||||
await state.refresh();
|
||||
|
||||
expect(state.summary.value.status).toBe('ready');
|
||||
expect(state.indices.value.status).toBe('error');
|
||||
expect(state.breadth.value.status).toBe('ready');
|
||||
expect(state.isLoading.value).toBe(false);
|
||||
});
|
||||
|
||||
it('分析偏好写入本地存储并可恢复', () => {
|
||||
const first = useMarketOverview({} as never);
|
||||
first.setAnalysisHorizon('短线');
|
||||
first.setAnalysisEngine('混合');
|
||||
|
||||
const second = useMarketOverview({} as never);
|
||||
|
||||
expect(second.analysisHorizon.value).toBe('短线');
|
||||
expect(second.analysisEngine.value).toBe('混合');
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,112 @@
|
||||
import { computed, ref } from 'vue';
|
||||
|
||||
import marketOverviewApi, { type createMarketOverviewApi } from '@/api/market-overview';
|
||||
import type {
|
||||
BreadthResponse,
|
||||
FundsResponse,
|
||||
IndicesResponse,
|
||||
OverviewModuleStatus,
|
||||
SectorsResponse,
|
||||
SummaryResponse,
|
||||
} from '@/types/market-overview';
|
||||
|
||||
type MarketResponse =
|
||||
SummaryResponse | IndicesResponse | BreadthResponse | SectorsResponse | FundsResponse;
|
||||
|
||||
export interface OverviewModuleState<TResponse extends MarketResponse> {
|
||||
status: OverviewModuleStatus;
|
||||
response: TResponse | null;
|
||||
}
|
||||
|
||||
function createState<TResponse extends MarketResponse>(): OverviewModuleState<TResponse> {
|
||||
return { status: 'idle', response: null };
|
||||
}
|
||||
|
||||
function readPreference(key: string, fallback: string): string {
|
||||
try {
|
||||
return window.localStorage.getItem(key) || fallback;
|
||||
} catch {
|
||||
return fallback;
|
||||
}
|
||||
}
|
||||
|
||||
function writePreference(key: string, value: string): void {
|
||||
try {
|
||||
window.localStorage.setItem(key, value);
|
||||
} catch {
|
||||
// 隐私模式或禁用存储时只保留本次页面状态，不让偏好存储阻断行情展示。
|
||||
}
|
||||
}
|
||||
|
||||
export function useMarketOverview(
|
||||
api: ReturnType<typeof createMarketOverviewApi> = marketOverviewApi,
|
||||
) {
|
||||
const summary = ref<OverviewModuleState<SummaryResponse>>(createState());
|
||||
const indices = ref<OverviewModuleState<IndicesResponse>>(createState());
|
||||
const breadth = ref<OverviewModuleState<BreadthResponse>>(createState());
|
||||
const sectors = ref<OverviewModuleState<SectorsResponse>>(createState());
|
||||
const funds = ref<OverviewModuleState<FundsResponse>>(createState());
|
||||
const analysisHorizon = ref(readPreference('a-share-analysis:overview-horizon', '综合'));
|
||||
const analysisEngine = ref(readPreference('a-share-analysis:overview-engine', '规则'));
|
||||
const isLoading = computed(() =>
|
||||
[summary.value, indices.value, breadth.value, sectors.value, funds.value].some(
|
||||
(module) => module.status === 'loading',
|
||||
),
|
||||
);
|
||||
|
||||
function setLoading() {
|
||||
summary.value.status = 'loading';
|
||||
indices.value.status = 'loading';
|
||||
breadth.value.status = 'loading';
|
||||
sectors.value.status = 'loading';
|
||||
funds.value.status = 'loading';
|
||||
}
|
||||
|
||||
async function loadModule<TResponse extends MarketResponse>(
|
||||
state: { value: OverviewModuleState<TResponse> },
|
||||
loader: () => Promise<TResponse>,
|
||||
): Promise<void> {
|
||||
try {
|
||||
state.value.response = await loader();
|
||||
state.value.status = 'ready';
|
||||
} catch {
|
||||
state.value.response = null;
|
||||
state.value.status = 'error';
|
||||
}
|
||||
}
|
||||
|
||||
async function refresh(): Promise<void> {
|
||||
setLoading();
|
||||
await Promise.all([
|
||||
loadModule(summary, api.getSummary),
|
||||
loadModule(indices, api.getIndices),
|
||||
loadModule(breadth, api.getBreadth),
|
||||
loadModule(sectors, api.getSectors),
|
||||
loadModule(funds, api.getFunds),
|
||||
]);
|
||||
}
|
||||
|
||||
function setAnalysisHorizon(value: string) {
|
||||
analysisHorizon.value = value;
|
||||
writePreference('a-share-analysis:overview-horizon', value);
|
||||
}
|
||||
|
||||
function setAnalysisEngine(value: string) {
|
||||
analysisEngine.value = value;
|
||||
writePreference('a-share-analysis:overview-engine', value);
|
||||
}
|
||||
|
||||
return {
|
||||
summary,
|
||||
indices,
|
||||
breadth,
|
||||
sectors,
|
||||
funds,
|
||||
isLoading,
|
||||
analysisHorizon,
|
||||
analysisEngine,
|
||||
refresh,
|
||||
setAnalysisHorizon,
|
||||
setAnalysisEngine,
|
||||
};
|
||||
}
|
||||
@@ -14,6 +14,7 @@ test('应用外壳在桌面和移动视口均可正常呈现', async ({ page })
|
||||
|
||||
await expect(page.locator('main')).toBeVisible();
|
||||
await expect(page.getByText('A 股市场分析工具')).toBeVisible();
|
||||
await expect(page.getByRole('heading', { name: '盘面先看结论，再看证据' })).toBeVisible();
|
||||
|
||||
const hasHorizontalOverflow = await page.evaluate(
|
||||
() => document.documentElement.scrollWidth > document.documentElement.clientWidth,
|
||||
|
||||
Reference in New Issue
Block a user