新增公司资料/指数/重大事项等 13 个接口, 文档全面对齐

- 新增 fin_mda/fin_equity/fin_company/fin_belong_index/fin_major_events 5 个模块
- 覆盖: 管理层讨论、股本结构、公司介绍、所属行业、指数分类/统计/成分、并购/股权激励/诉讼/关联交易/违规/担保
- _emchoice.fetch_report 支持"数据为空"按空结果处理
- api.py 增加 _simple_endpoint 统一生成纯 stocks 参数接口, 路由达 29 个 /fin 端点
- 冒烟测试扩展至 56 用例, 全部通过
- api_manual/blueprint/SKILLS/待优化 文档与代码路径 100% 对齐

docs/api_manual.md

@@ -285,6 +285,110 @@ curl "http://127.0.0.1:8765/fin/holder-num?stocks=603233.SH&years=3"
 
 ---
 
+## 9. 公司资料 / 股本 / 指数
+
+以下接口均只需 `stocks` 参数（无 `years`，返回全量），公司介绍每只 1 行。
+
+**示例**
+
+```bash
+# 公司介绍 (基本资料: 注册资本/董事长/行业等)
+curl "http://127.0.0.1:8765/fin/company-info?stocks=603233.SH"
+
+# 股本结构 (各报告期末股本变动全量历史)
+curl "http://127.0.0.1:8765/fin/equity?stocks=603233.SH"
+
+# 所属行业 (当前生效的行业分类)
+curl "http://127.0.0.1:8765/fin/industry?stocks=603233.SH"
+
+# 所属指数分类
+curl "http://127.0.0.1:8765/fin/index-classif?stocks=603233.SH"
+
+# 纳入指数统计 (指数/基金数量)
+curl "http://127.0.0.1:8765/fin/belong-index?stocks=603233.SH"
+
+# 指数成分权重 (纳入主要指数的权重)
+curl "http://127.0.0.1:8765/fin/index-membership?stocks=603233.SH"
+```
+
+**各接口常见列**
+
+| 接口 | 常见列 |
+|---|---|
+| 公司介绍 | `ORG_NAME`（公司全称）、`FOUND_DATE`、`REG_CAPITAL`、`LISTING_DATE`、`CHAIRMAN`、`PRESIDENT`、`INDUSTRYCSRC1` 等 |
+| 股本结构 | `END_DATE`、`CHANGE_REASON`（变动原因）、`LIMITED_SHARES`（限售股）、`UNLIMITED_SHARES`、`TOTAL_SHARES` 等 |
+| 所属行业 | `INDUSTRY_TYPE`（行业类型）、`INDUSTRY_NAME`、`INDUSTRY_CODE`、`ENTRY_DATE` 等 |
+| 指数分类 | `INDEX_CLASSIF_CODE`、`INDEX_CLASSIF` |
+| 纳入指数统计 | `INDEX_NUM`（指数数量）、`INDEX_FUND_NUM`、`FUND_NUM`、`FUND_TOTAL_SCALE` 等 |
+| 指数成分权重 | `INDEX_NAME_ABBR`（指数名）、`INDEX_CLASSIF`、`WEIGHT`（权重）、`NUM`、`INCLUDE_DATE` 等 |
+
+---
+
+## 10. 管理层讨论与分析（MD&A）
+
+年报/中报的董事会报告索引（含标题与页码），默认拉最近 5 年。
+
+**参数**
+
+| 参数 | 类型 | 必填 | 默认 | 说明 |
+|---|---|---|---|---|
+| `stocks` | string | ✅ | — | 逗号分隔股票代码，如 `603233.SH` |
+| `years` | int | | `5` | 拉取最近多少年的报告（1~20） |
+
+**示例**
+
+```bash
+curl "http://127.0.0.1:8765/fin/mda?stocks=603233.SH&years=5"
+```
+
+**常见列**：`REPORT_DATE`、`REPORT_NAME`（年报/中报）、`NOTICE_DATE`、`TITLE`（标题）、`PAGE`（页码）、`RELINFOCODE`（报告关联编码）。
+
+---
+
+## 11. 重大事项（并购 / 股权激励 / 诉讼 / 关联交易 / 违规 / 担保）
+
+**公共参数**
+
+| 参数 | 类型 | 必填 | 默认 | 说明 |
+|---|---|---|---|---|
+| `stocks` | string | ✅ | — | 逗号分隔股票代码，如 `603233.SH`。仅需代码，不需要 ORG_CODE |
+| `years` | int | | `3` | 拉取最近多少年的数据（1~20） |
+
+**示例**
+
+```bash
+# 并购事件
+curl "http://127.0.0.1:8765/fin/acquisitions?stocks=603233.SH&years=3"
+
+# 股权激励 (部分股票可能无数据, 如无记录返回 404)
+curl "http://127.0.0.1:8765/fin/equity-incentive?stocks=603233.SH&years=3"
+
+# 诉讼仲裁
+curl "http://127.0.0.1:8765/fin/litigation?stocks=603233.SH&years=3"
+
+# 关联交易
+curl "http://127.0.0.1:8765/fin/related-transaction?stocks=603233.SH&years=3"
+
+# 违规处罚
+curl "http://127.0.0.1:8765/fin/violation?stocks=603233.SH&years=3"
+
+# 对外担保 (部分股票可能无数据)
+curl "http://127.0.0.1:8765/fin/guarantee?stocks=603233.SH&years=3"
+```
+
+**各接口常见列**
+
+| 接口 | 常见列 |
+|---|---|
+| 并购 | `PLAN_PROCESS`（进展）、`NAME_OBJ`（标的）、`NAME_BUY`（收购方）、`DEAL_AMT`（交易金额）、`TRANSFER_RATIO` 等 |
+| 股权激励 | `PLAN_PROCESS`、`EI_TARGET`（对象）、`EI_WAY`（方式）、`TOTAL_INCENTIVE_SHARES`、`INITIAL_EXERCISE_PRICE`（行权价）等 |
+| 诉讼仲裁 | `CASE_NAME`（案件名）、`CASE_PROFILE`、`PLAINTIFF`、`DEFENCE`、`CASE_AMOUNT`（涉诉金额）、`LITIGATION_TYPE` 等 |
+| 关联交易 | `RELATED_PARTY`（关联方）、`RELATED_RELATION`（关系）、`TRADE_AMT`（金额）、`TRADE_PROFILE` 等 |
+| 违规 | `VIOLATE_TYPE`（违规类型）、`PUNISH_TYPE`（处罚类型）、`PUNISH_AMT`、`SOLVE_ORG`（处理机构）等 |
+| 担保 | `GUAR_NAME`（担保方）、`GUARANTEED_NAME`（被担保方）、`GUARANTEE_AMT`、`GUARANTEE_WAY`、`IS_RELATED_TRADE` 等 |
+
+---
+
 ## 接口一览
 
 | 路径 | 功能 | 数据来源报表 |
@@ -306,9 +410,22 @@ curl "http://127.0.0.1:8765/fin/holder-num?stocks=603233.SH&years=3"
 | `/fin/free-holders` | 十大流通股东 | `RPT_F10_EH_FREEHOLDERS` |
 | `/fin/holders` | 十大股东明细 | `RPT_DMSK_HOLDERS` |
 | `/fin/holder-num` | 股东户数 | `RPT_F10_EH_HOLDERNUM` |
+| `/fin/mda` | 管理层讨论与分析 | `RPT_BUSINESSANALYSIS` |
+| `/fin/equity` | 股本结构 | `RPT_F10_EH_EQUITY` |
+| `/fin/company-info` | 公司介绍 | `RPT_HSF9_BASIC_ORGINFO` |
+| `/fin/industry` | 所属行业 | `RPT_STOCKF9_INDUSTRY` |
+| `/fin/index-classif` | 所属指数分类 | `RPT_HSF9_BELONGINDEX_CLASSIF` |
+| `/fin/belong-index` | 纳入指数统计 | `RPT_CUSTOM_HSF9_BELONG_INDEX` |
+| `/fin/index-membership` | 指数成分权重 | `RPT_HSF9_BELONG_INDEX` |
+| `/fin/acquisitions` | 并购事件 | `RPT_HS_ACQUISITIONS_EVENT` |
+| `/fin/equity-incentive` | 股权激励 | `RPT_DMSK_SH_EQUITYINCENTIVE` |
+| `/fin/litigation` | 诉讼仲裁 | `RPT_LITIGATION_ARBITRATION_BSINFO` |
+| `/fin/related-transaction` | 关联交易 | `RPT_RELATED_TRANSACTION` |
+| `/fin/violation` | 违规处罚 | `RPT_HSF9_OP_VIOLATION` |
+| `/fin/guarantee` | 对外担保 | `RPT_F9_GUARANTEE` |
 
 ## 测试
 
 ```bash
-uv run pytest tests/ -q   # 冒烟测试: 连真实接口验证各模块能取到数据 (30 用例)
+uv run pytest tests/ -q   # 冒烟测试: 连真实接口验证各模块能取到数据 (56 用例)
 ```