9d62a53b73
本次提交旨在完成一次架构一致性重构，核心目标是使前端代码和相关文档完全符合“`data-persistence-service`是唯一数据库守门人”的设计原则。
主要变更包括：
1. **移除前端数据库直连**:
* 从`docker-compose.yml`中删除了`frontend`服务的`DATABASE_URL`。
* 彻底移除了`frontend`项目中的`Prisma`依赖、配置文件和客户端实例。
2. **清理前端UI**:
* 从配置页面中删除了所有与数据库设置相关的UI组件和业务逻辑。
3. **同步更新文档**:
* 更新了《用户使用文档》和《需求文档》，移除了所有提及或要求前端进行数据库配置的过时内容。
此次重构后，系统前端的数据交互已完全收敛至`api-gateway`，确保了架构的统一性、健壮性和高内聚。
5.7 KiB
5.7 KiB
需求文档 - MVP版本
介绍
基本面选股系统MVP是一个综合的中文网站，允许用户输入证券代码和交易市场，生成包含多维度分析的详细股票基本面报告。系统通过多个专业分析模块，结合财务数据、AI分析和市场信息，为用户提供全面的投资决策支持。
术语表
- 选股系统 (Stock_Selection_System): 提供基本面分析和报告生成的主要系统
- 用户 (User): 使用系统进行股票分析的终端用户
- 证券代码 (Security_Code): 股票在特定交易市场的唯一标识符
- 交易市场 (Trading_Market): 股票交易的地理区域，包括中国、香港、美国、日本
- 基本面报告 (Fundamental_Report): 包含九个分析模块的综合股票分析报告
- TradingView图表 (TradingView_Chart): 使用TradingView高级图表组件显示的股价图表
- Tushare_API: 用于获取中国股票财务数据的数据源接口
- Gemini_Model: Google的大语言模型，用于生成业务分析内容
- PostgreSQL数据库 (PostgreSQL_Database): 用于存储报告数据的关系型数据库
- 分析模块 (Analysis_Module): 报告中的独立分析部分，每个模块对应一个显示页面
需求
需求 1
用户故事: 作为投资者，我希望能够输入股票代码和选择交易市场，以便获取该股票的综合基本面分析报告
验收标准
- 当用户访问首页时，选股系统应当显示证券代码输入框和交易市场选择器
- 当用户选择交易市场时，选股系统应当提供中国、香港、美国、日本四个选项
- 当用户提交证券代码和交易市场时，选股系统应当处理用户请求并跳转到报告页面
需求 2
用户故事: 作为投资者，我希望系统能够检查历史报告，以便决定是查看现有报告还是生成新报告
验收标准
- 当用户提交证券代码和交易市场后，选股系统应当在PostgreSQL数据库中查询对应的历史报告
- 如果存在历史报告，选股系统应当显示历史报告内容和"生成最新报告"按钮
- 如果不存在历史报告，选股系统应当自动启动九步报告生成流程
需求 3
用户故事: 作为投资者，我希望系统能够获取准确的财务数据，以便进行可靠的基本面分析
验收标准
- 当生成中国股票报告时，选股系统应当使用Tushare_API获取财务信息
- 当处理其他市场股票时，选股系统应当根据交易市场选择相应的数据源
- 当财务数据获取完成时，选股系统应当将数据作为后续分析的基础
需求 4
用户故事: 作为投资者，我希望系统能够通过AI分析获取公司业务信息，以便了解公司的全面情况
验收标准
- 当需要业务信息时，选股系统应当使用Gemini生成公司概览、主营业务、发展历程、核心团队、供应链、主要客户及销售模式、未来展望
- 当调用Gemini时，选股系统应当使用配置的API密钥进行身份验证
- 当业务信息生成完成时，选股系统应当将内容整合到报告的第二部分
需求 5
用户故事: 作为投资者，我希望系统能够提供多维度的专业分析，以便获得全面的投资决策支持
验收标准
- 当生成报告时，选股系统应当按顺序执行8个分析模块：基本面分析、看涨分析、看跌分析、市场分析、新闻分析、交易分析、内部人与机构动向分析、最终结论
- 当执行基本面分析时，选股系统应当使用问题集进行分析
- 当执行看涨分析时，选股系统应当研究潜在隐藏资产和护城河竞争优势
- 当执行看跌分析时，选股系统应当分析公司价值底线和最坏情况
- 当执行市场分析时，选股系统应当研究市场情绪分歧点与变化驱动
- 当执行新闻分析时，选股系统应当研究股价催化剂与拐点预判
- 当执行交易分析时，选股系统应当研究市场体量与增长路径
- 当执行内部人分析时，选股系统应当研究内部人与机构动向
- 当生成最终结论时，选股系统应当指出关键矛盾与预期差以及拐点的临近
需求 6
用户故事: 作为投资者，我希望每个分析模块都能独立查看，以便专注于特定的分析维度
验收标准
- 当显示报告时，选股系统应当为每个分析模块提供独立的显示页面
- 当用户在模块间切换时，选股系统应当保持导航的流畅性
- 当所有模块完成时，选股系统应当将完整报告保存到PostgreSQL数据库
需求 7
用户故事: 作为投资者，我希望在报告生成过程中能够看到实时进度，以便了解当前状态和预估完成时间
验收标准
- 当开始生成报告时，选股系统应当显示进度指示器展示所有分析步骤
- 当执行每个分析步骤时，选股系统应当高亮显示当前正在进行的步骤
- 当每个步骤完成时，选股系统应当更新步骤状态为已完成
- 当执行分析步骤时，选股系统应当记录每个步骤的开始时间和完成时间，如果使用AI记录使用token
- 当显示进度时，选股系统应当展示每个步骤的耗时统计
- 当步骤执行失败时，选股系统应当显示错误状态和错误信息
需求 8
用户故事: 作为系统管理员，我希望能够配置系统参数，以便系统能够正常连接外部服务
验收标准
- 选股系统应当提供配置页面用于设置Gemini_API密钥
- 选股系统应当提供配置页面用于设置各市场的数据源配置
- 当配置更新时，选股系统应当验证配置的有效性
- 当配置保存时，选股系统应当将配置持久化存储