## 项目当前状态

### 项目目的
- **目标**：构建一套面向A股与美股的基本面分析与研究支持系统，聚合股价、财务数据与外部资讯，结合大模型进行结构化分析与自动化报告生成，并支持历史留存与复盘。

### 当前功能与数据状态
- **A股财务数据**：已可正常获取并落库/展示。
- **每股口径（per-share）数据**：仅部分可得；个别财务指标存在异常或口径不一致的问题。
  - 相关定义、口径说明与已知问题，请参见文档：[财务数据字典](./financial_data_dictionary.md)。
- **报告与分析**：
  - 首页输入公司代码与市场，点击“生成报告”后，应展示：
    - 公司股价
    - 财务数据
    - 大模型的分析结论
  - 目前分析步骤仅采用“提示词”的方式驱动；生成的报告支持保存到数据库。

### 系统运行与部署
- **数据库与网络**：
  - 数据库部署在许晨公司内部网络环境中；需要内网或通过跳板/映射方式访问。
  - 本地运行可能存在连接限制。数据库当前未在本机配置，但可按需进行本机配置（需要对 LV 做调整，最终仍以本机配置为主）。
- **运行方式**：
  - 可将项目打包为 Docker 运行，因此也支持纯本地部署。
  - 提供脚本位于 `scripts/`：
    - `dev.sh`：调试脚本，同时启动前端与后端
    - `run.sh`：直接运行脚本
- **当前运行环境**：
  - 目前在许成的一台虚拟机上运行，便于访问内部数据库，并通过 LV 保垒机进行映射。

### 已知问题/限制
- 每股数据覆盖面不全，部分财务指标存在疑似口径或计算问题（详见“财务数据字典”）。
- 数据库处于内网环境，外部或本地直连存在门槛；需配置 LV/隧道或切换至本机数据库配置。
- 大模型分析仍以提示词工程为主，未融合多源结构化信号。

### 后续计划（优先级由高到低）
1. **完成美股数据获取并校验正确性**（当前最紧要）
   - 引入更多数据源以提升覆盖面与一致性（如同花顺 iFinD）；如能接入 Bloomberg（蓬勃）更佳，但实现难度较高。
2. **接入第三方大模型 API**（由许成购买的公司提供）
   - 数据范围：新闻公告、研究报告、电话会议纪要等。
   - 具体接入方式尚未确定，需进一步讨论与评估。
3. **升级分析框架与规则**
   - 不再仅依赖提示词；需融合财务数据、股价、新闻与研报等多源信息。
   - 按模块/主题进行特征组合与权重设计；输出结构化因子与可解释结论。
   - 具体实现细节需与许成沟通确认。

### 待定与沟通事项
- 本机数据库配置方案与 LV 调整细节（端口、权限、备份策略）。
- 第三方大模型 API 的调用配额、上下文长度、费用与合规约束。
- 多数据源融合后的字段映射、口径优先级与冲突解决策略。
- 前端报告展示结构（股价/财务/大模型结论）的最终版式与交互细节。

### 参考
- 数据口径与字段说明：[财务数据字典](./financial_data_dictionary.md)
- 启动/运行脚本：`scripts/dev.sh`、`scripts/run.sh`
