From 7a11800cba14d0b31d2cba5689889fa4e0b7fa72 Mon Sep 17 00:00:00 2001
From: zdl <3489966805@qq.com>
Date: Wed, 17 Dec 2025 15:42:55 +0800
Subject: [PATCH] =?UTF-8?q?docs(Company):=20=E6=B7=BB=E5=8A=A0=20API=20?=
 =?UTF-8?q?=E6=8E=A5=E5=8F=A3=E6=B8=85=E5=8D=95=E5=88=B0=20STRUCTURE.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 梳理 Company 模块共 27 个 API 接口（去重后）
- 分 6 大类：股票基础信息(8)、股东信息(4)、行情数据(8)、深度分析(5)、财务数据(1)、事件新闻(1)
- 标注每个接口的方法类型和调用位置

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 src/views/Company/STRUCTURE.md | 79 +++++++++++++++++++++++++++++++++-
 1 file changed, 78 insertions(+), 1 deletion(-)

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 个接口。
+
+---
+
 ## 文件职责说明
 
 ### 入口文件