diff --git a/src/views/Company/STRUCTURE.md b/src/views/Company/STRUCTURE.md index d4d6b5ec..2eebdfd7 100644 --- a/src/views/Company/STRUCTURE.md +++ b/src/views/Company/STRUCTURE.md @@ -1,6 +1,6 @@ # Company 目录结构说明 -> 最后更新:2025-12-17(StockQuoteCard 数据下沉优化) +> 最后更新:2025-12-17(API 接口清单梳理) ## 目录结构 @@ -230,6 +230,83 @@ src/views/Company/ --- +## API 接口清单 + +Company 模块共使用 **27 个** API 接口(去重后)。 + +### 一、股票基础信息 (8 个) + +| 接口 | 方法 | 调用位置 | +|------|------|----------| +| `/api/stock/${stockCode}/basic-info` | GET | useBasicInfo.ts, useStockQuoteData.ts, NewsPanel.js | +| `/api/stock/${stockCode}/branches` | GET | useBranchesData.ts | +| `/api/stock/${stockCode}/management?active_only=true` | GET | useManagementData.ts | +| `/api/stock/${stockCode}/announcements?limit=20` | GET | useAnnouncementsData.ts | +| `/api/stock/${stockCode}/disclosure-schedule` | GET | useDisclosureData.ts | +| `/api/stock/${stockCode}/forecast` | GET | ForecastPanel.js | +| `/api/stock/${stockCode}/forecast-report` | GET | ForecastReport/index.tsx | +| `/api/stock/${stockCode}/latest-minute` | GET | marketService.ts | + +### 二、股东信息 (4 个) + +| 接口 | 方法 | 调用位置 | +|------|------|----------| +| `/api/stock/${stockCode}/actual-control` | GET | useShareholderData.ts | +| `/api/stock/${stockCode}/concentration` | GET | useShareholderData.ts | +| `/api/stock/${stockCode}/top-shareholders?limit=10` | GET | useShareholderData.ts | +| `/api/stock/${stockCode}/top-circulation-shareholders?limit=10` | GET | useShareholderData.ts | + +### 三、行情数据 (8 个) + +| 接口 | 方法 | 调用位置 | +|------|------|----------| +| `/api/stock/quotes` | POST | stockService.getQuotes | +| `/api/market/summary/${stockCode}` | GET | marketService.ts | +| `/api/market/trade/${stockCode}?days=${days}` | GET | marketService.ts | +| `/api/market/funding/${stockCode}?days=${days}` | GET | marketService.ts | +| `/api/market/bigdeal/${stockCode}?days=${days}` | GET | marketService.ts | +| `/api/market/unusual/${stockCode}?days=${days}` | GET | marketService.ts | +| `/api/market/pledge/${stockCode}` | GET | marketService.ts | +| `/api/market/rise-analysis/${stockCode}` | GET | marketService.ts | + +### 四、深度分析 (5 个) + +| 接口 | 方法 | 调用位置 | +|------|------|----------| +| `/api/company/comprehensive-analysis/${stockCode}` | GET | DeepAnalysis/index.js | +| `/api/company/value-chain-analysis/${stockCode}` | GET | DeepAnalysis/index.js | +| `/api/company/key-factors-timeline/${stockCode}` | GET | DeepAnalysis/index.js | +| `/api/company/value-chain/related-companies?node_name=...` | GET | ValueChainNodeCard/index.tsx | +| `/api/financial/industry-rank/${stockCode}` | GET | DeepAnalysis/index.js | + +### 五、财务数据 (1 个) + +| 接口 | 方法 | 调用位置 | +|------|------|----------| +| `/api/financial/financial-metrics/${stockCode}?limit=${limit}` | GET | financialService.getFinancialMetrics | + +### 六、事件/新闻 (1 个) + +| 接口 | 方法 | 调用位置 | +|------|------|----------| +| `/api/events?q=${searchTerm}&page=${page}&per_page=10` | GET | NewsPanel.js | + +### 统计汇总 + +| 分类 | 数量 | +|------|------| +| 股票基础信息 | 8 | +| 股东信息 | 4 | +| 行情数据 | 8 | +| 深度分析 | 5 | +| 财务数据 | 1 | +| 事件/新闻 | 1 | +| **去重后总计** | **27** | + +> 注:`/api/stock/${stockCode}/basic-info` 在 3 处调用,但只算 1 个接口。 + +--- + ## 文件职责说明 ### 入口文件