Fundamental_Analysis/docs/project-status.md

项目当前状态

项目目的

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

当前功能与数据状态

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

系统运行与部署

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

已知问题/限制

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

后续计划（优先级由高到低）

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

待定与沟通事项

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

参考

• 数据口径与字段说明：财务数据字典
• 启动/运行脚本：scripts/dev.sh、scripts/run.sh