# stock_analysis

**Repository Path**: dev11/stock_analysis

## Basic Information

- **Project Name**: stock_analysis
- **Description**: 股票分析系统
面向个人或小团队的 A 股数据沉淀、行情查看、因子与事件分析、产业链与估值辅助 的 Web 应用。后端由 Python（FastAPI）实现；前端使用 Vue 独立工程，通过 REST API 与后端交互。
重要声明：以下「估值区间」「风险提示」等均为基于历史数据与规则的辅助信息，不构成投资建议。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-04-11
- **Last Updated**: 2026-05-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 股票分析系统

面向个人或小团队的 **A 股数据沉淀、行情查看、因子与事件分析、产业链与估值辅助** 的 Web 应用。后端由 Python（FastAPI）实现；前端使用 **Vue** 独立工程，通过 REST API 与后端交互。  
**重要声明**：以下「估值区间」「风险提示」等均为基于历史数据与规则的辅助信息，**不构成投资建议**。

---

## 1. 项目目标

| 维度 | 说明 |
|------|------|
| **短期价值（可落地 MVP）** | 自选与行情列表、单股 K 线与量价、常用技术指标；数据稳定、界面清晰。 |
| **中期价值** | 新闻/宏观/产业链等结构化入库；因子输出可追溯；前端能展示因子与时间线。 |
| **长期价值** | 历史归因 + 当日新事件驱动的因子更新，对关联标的给出**估值区间与风险提示的辅助结论**（规则或模型输出均需可解释、可回测）。 |
| **边界** | 数据来源于公开接口或合规渠道；延迟、完整性与合规以数据源为准；本系统不提供投资建议。 |

---

## 2. 数据与分析愿景（业务拆解，分期实现）

本节对应你已梳理的思路，作为**后端与数据团队**的主线；前端按阶段暴露「查询、图表、因子说明、时间线」等能力。

### 2.1 数据层：写入 MySQL（Python 实现，由你主导）

| 编号 | 数据类型 | 状态 | 说明 |
|------|----------|------|------|
| ① | 每日股票行情 | 已有思路 | 日线/（可选）分钟线等，落库后支撑 K 线、技术指标与量价分析。 |
| ② | 新闻数据 | 待选型 | 见 **§3 新闻与宏观落地方案**。 |
| ③ | 宏观数据 | 待选型 | CPI、PPI、GDP、利率、信贷、汇率等；频率多为月/季/年，需统一日历与修订口径。 |

### 2.2 历史数据分析（因子/信号/归因）

| 编号 | 能力 | 输出示例 |
|------|------|----------|
| ④ | **行情技术分析** | KDJ 金叉/死叉、MACD 顶/底背离、量价关系（放量突破、缩量回调等）；输出为**带时间、标的、规则版本**的因子或信号表。 |
| ⑤ | **新闻与宏观归因** | 将文本或宏观序列映射到**主题因子**（如地缘冲突、通胀链、货币政策等），需**词典/分类模型 + 人工校验**迭代。 |
| ⑥ | **产业链成本结构** | 如服务器 BOM：电源/机柜/内存/CPU/GPU/主板/PCB 等占整机成本比例；数据来自研报拆解、财报分部、行业数据库等，需**来源字段与更新日期**。 |
| ⑦ | **公司业务与产业链位置** | 上市公司主营产品/分部收入 ↔ 产业节点（上中下游）；可用行业分类、财报分部、供应链披露、新闻共现等逐步补全。 |
| ⑧ | **综合结论（历史）** | 在 ④～⑦ 可复现前提下，输出**估值区间建议、风险提示、未来业绩敏感因子**（哪类因子变动可能带来增长/下滑）；**必须可解释、可回测**，避免黑盒一句结论。 |

### 2.3 实时与事件驱动（在「历史管线」跑通后）

当具备当日新闻流、新发布宏观数据、国际宏观、产业上下游业绩/公告时：

- 先做 **事件 → 因子变量** 的抽取与落库（同一套因子字典与版本号）。  
- 再映射到 **关联上市公司**（行业、供应链、产品关键词、股权关系等规则 + 可选模型）。  
- 最后输出 **更新的估值区间/风险提示**（与历史口径一致，便于对比与审计）。

---

## 3. 新闻数据与宏观数据（落地方案思路库）

以下为常见路径，**可组合使用**，不必一次上全；选型时重点考虑：**版权与 ToS、更新频率、字段稳定性、是否可回溯修订**。

### 3.1 新闻

- **官方与交易所**：交易所公告、巨潮资讯等（偏公告，结构化程度高）。  
- **聚合 RSS / 媒体开放接口**：适合 POC，需注意稳定性。  
- **商业数据终端 API**：字段规范、稳定，成本较高。  
- **处理管线**：抓取 → 去重 → 正文抽取 → **NLP（分类/实体：公司名、行业、地缘、政策）** → 与你的「主题因子」对齐 → 入库；关键事件建议保留 **原文链接与抓取时间**。  

### 3.2 宏观与国际宏观

- **国内**：国家统计局、央行、发改委等公开数据；可用 **AkShare / 官方 CSV** 等拉取后统一单位与频率。  
- **国际**：美联储、BLS、各国央行、IMF 等；注意 **时区、修订值、发布日历**。  
- **建模提示**：宏观多为低频序列，更适合 **状态标签 + 变化方向**（如「加息周期」「CPI 同比回落」）再与权益因子联动，避免过拟合。

---

## 4. 技术栈与目录约定

| 部分 | 技术选型 | 目录 |
|------|-----------|------|
| 后端 | Python 3、FastAPI、Uvicorn、SQLAlchemy、Redis（按现有工程） | `src/` |
| 前端 | Vue 3 + 构建工具（Vite）+ 组件库（如 Element Plus / Naive UI，实现阶段再定） | `web/` |
| 交互原型 | 纯 HTML/CSS/JS 单页或多页，用于确认布局与流程 **不写业务逻辑** | `webUI/` |
| 部署 | Docker / Nginx（见 `docker-compose.yml`、`bin/`） | 仓库根目录 |

**协作原则**：接口以 OpenAPI（FastAPI 自动生成）或独立 `docs/api.md` 为准；前端只依赖约定好的 JSON 字段；**因子与规则需带版本号**，便于回测与前端展示「依据」。

---

## 5. 功能需求分层（前端与 API 暴露，建议路线图）

以下为 **方案组合**，可与 §2 分期对齐；确认后可在「迭代计划」中勾选。

### 5.1 第一阶段（MVP，强烈建议先做）

- **自选管理**：添加/删除/排序股票（代码、名称、所属市场）。  
- **行情列表**：展示自选或全市场列表（代码、名称、最新价、涨跌幅、成交量等）。  
- **单股详情**：基础信息 + **K 线（日线为主）** + 成交量；时间区间切换。  
- **用户与会话**：简单登录（JWT）或单用户本地部署，二选一。  
- **统一错误与加载态**。  

### 5.2 第二阶段（增强分析，对齐 §2.2 ④）

- 更多周期（周线、60 分钟等）；**MA、MACD、KDJ、BOLL** 等逐步上线。  
- 股票搜索；手动刷新 + 可选轮询。  
- 后端：技术因子/信号入库，前端展示 **信号列表与 K 线标注**（可选）。  

### 5.3 第三阶段（新闻/宏观/产业链，对齐 §2.2 ⑤～⑦）

- 新闻时间线、宏观指标图表、产业链与产品关系 **只读展示**（数据就绪一条开放一条）。  
- 因子字典与归因说明页（可追溯来源与规则版本）。  

### 5.4 第四阶段（综合结论与事件驱动，对齐 §2.2 ⑧ 与 §2.3）

- 估值区间与风险提示的 **展示与回溯**；新事件推送或轮询后的 **增量更新**（实现方式与后端任务队列绑定）。  

---

## 6. 方案对比（便于决策）

| 方案维度 | 选项 A（偏快上线） | 选项 B（偏完整） |
|----------|-------------------|------------------|
| 登录 | 先不做，单用户 | 注册登录 + 多用户自选 |
| K 线 | 仅日线 | 日线 + 周线 + 分时（视数据源） |
| 图表 | ECharts 等 | 同上，可增加画线/复权 |
| 因子与结论 | 仅技术信号 | 技术 + 新闻/宏观 + 产业链 + 估值辅助 |

**建议**：先 **A + 技术因子** 跑通；新闻/宏观采用 **§3 中最小可行数据源** 再扩展。

---

## 7. 非功能需求

- **性能**：列表与图表分页或按需加载；避免单次请求过大数据集。  
- **安全**：若对外网开放，必须 HTTPS、鉴权、防暴力请求与敏感配置不入库明文。  
- **可维护**：前端目录结构清晰（views / components / api / stores）；后端按领域模块划分；**因子规则代码化与版本化**。  
- **合规与免责**：页面显著位置提示「数据仅供参考，不构成投资建议」。  
- **可审计**：重要结论建议保留 **输入数据快照或哈希、规则版本、生成时间**，便于回测与争议排查。  

---

## 8. 开发流程（与原型约定）

1. **需求与本文档**：在 `README.md` 中确认范围与 MVP 勾选项。  
2. **原型（`webUI/`）**：用 HTML 做出主要页面布局与点击流程，**你确认后再进入 Vue 工程**。  
3. **前端工程（`web/`）**：按原型搭 Vue 3 项目、路由、状态管理与 API 封装。  
4. **联调**：对照 OpenAPI 联调；环境变量区分 `dev` / `prod` API 地址。  

---

## 9. 迭代计划（待勾选）

### 9.1 前端与基础能力

- [ ] MVP：自选 + 行情列表 + 日线 K 线 + 成交量  
- [ ] 用户方案：无登录单用户 / JWT 多用户（二选一或分阶段）  
- [ ] 技术指标：MA / MACD / KDJ / 其他：________  
- [ ] 股票搜索  
- [ ] 周线或分钟线  

### 9.2 数据与因子（后端主线，与 §2 对齐）

- [ ] 每日行情入库与回溯（已有）  
- [ ] 新闻：数据源选型 + 抓取 + NLP 主题因子  
- [ ] 宏观：国内 +（可选）国际序列与修订口径  
- [ ] 技术因子：背离/金叉/量价规则落库与版本号  
- [ ] 产业链 BOM 与业务分部映射（分标的逐步补全）  
- [ ] 估值区间与风险提示：**规则引擎或模型** + 前端展示与回溯  
- [ ] 当日事件驱动：新新闻/新宏观 → 关联标的 → 更新结论  

---

## 10. 本地开发（后端，摘要）

- 后端入口：`src/main/start.py`（默认端口以配置为准，常见为 `8000`）。  
- 依赖：`src/requirements.txt`。  
- 具体启动命令与环境变量以你本地 `.env` 为准。  

---

## 11. 修订记录

| 日期 | 说明 |
|------|------|
| 2026-04-12 | 初版：目标、分层功能、方案对比、流程与非功能需求 |
| 2026-04-12 | 扩充：数据与分析愿景（行情/新闻/宏观/产业链/估值/事件驱动）、新闻与宏观落地方案、迭代计划与后端主线勾选 |