tools-only financial-report-analysis Specification
Purpose
TBD - created by archiving change add-financial-report-agent. Update Purpose after archive.
Requirements
Requirement: Financial Report Data Retrieval
系统 SHALL 能够获取和展示上市公司的三大财务报表数据，包括利润表、资产负债表和现金流量表。
Scenario: 获取单只股票财务数据
- WHEN 用户请求特定股票代码的财务数据
- THEN 系统返回该股票的历史财务报表数据
- AND 数据包含至少8个报告期的完整财务指标
- AND 数据格式符合前端展示要求
Scenario: 财务数据格式验证
- WHEN 系统获取财务数据
- THEN 所有数值字段应当正确格式化
- AND 日期字段应当统一为 YYYYMMDD 格式
- AND 缺失数据应当标记为 null 而非空字符串
Requirement: Financial Metrics Calculation
系统 SHALL 能够计算和展示关键财务指标，包括盈利能力、偿债能力、运营效率等指标。
Scenario: 盈利能力指标计算
- WHEN 用户查看财务指标
- THEN 系统计算并展示 ROE、ROA、毛利率、净利率等指标
- AND 指标计算公式应当符合财务分析标准
- AND 异常值应当有适当的标识和说明
Scenario: 财务指标趋势分析
- WHEN 用户查看指标趋势
- THEN 系统展示至少4个季度的指标变化趋势
- AND 提供同比和环比增长率计算
- AND 标识出显著的变化点和异常值
Requirement: Industry Comparison Analysis
系统 SHALL 支持同行业公司的财务数据对比分析功能。
Scenario: 同业对比数据获取
- WHEN 用户选择多只同行业股票进行对比
- THEN 系统获取所选股票的相同时期财务数据
- AND 数据应当标准化处理以便对比
- AND 提供行业平均值和中位数参考
Scenario: 对比结果可视化
- WHEN 用户查看对比分析结果
- THEN 系统以表格和图表形式展示对比数据
- AND 突出显示各公司的优势和劣势指标
- AND 提供排名和百分位信息
Requirement: AI-Powered Financial Analysis
系统 SHALL 提供基于 AI 的财报解读和投资洞察功能。
Scenario: AI 财报解读
- WHEN 用户请求 AI 分析特定公司财报
- THEN 系统生成包含以下内容的分析报告：
- 财务健康状况评估
- 盈利能力和成长性分析
- 风险点识别和提示
- 与同行业对比的相对表现
- AND 分析结果应当基于真实财务数据
- AND 包含明确的免责声明
Scenario: 投资建议生成
- WHEN AI 完成财报分析
- THEN 系统提供基于分析结果的投资参考意见
- AND 建议应当包含风险等级评估
- AND 明确标注为参考意见而非投资建议
- AND 提供支撑建议的关键数据点
Requirement: Financial Report Service Integration
系统 SHALL 集成现有的 tushare_finace_indicator 数据源，提供统一的财报数据服务。
Scenario: 数据源集成
- WHEN FinancialReportService 需要获取财务数据
- THEN 系统通过 TuShareFinaceIndicatorService 获取数据
- AND 数据获取应当包含适当的错误处理
- AND 支持批量和单个股票的数据查询
Scenario: 数据缓存和性能优化
- WHEN 系统频繁请求相同的财务数据
- THEN 实现适当的缓存机制减少数据库查询
- AND 缓存应当有合理的过期时间
- AND 支持缓存失效和强制刷新
Requirement: Enhanced Report Agent
现有的 ReportAgent SHALL 增强以支持完整的财报分析功能。
Scenario: Agent 工具扩展
- WHEN ReportAgent 处理财报分析请求
- THEN Agent 应当能够调用以下工具：
- get_income_statement: 获取利润表数据
- get_balance_sheet: 获取资产负债表数据
- get_cashflow: 获取现金流量表数据
- analyze_financial_health: 分析财务健康状况
- AND 工具调用应当包含参数验证
- AND 支持批量数据处理
Scenario: 智能分析流程
- WHEN 用户请求复杂的财报分析
- THEN Agent 应当按照标准分析流程执行：
- 获取基本信息和最新财务数据
- 计算关键财务指标
- 进行同业对比分析
- 生成 AI 分析报告
- AND 每个步骤的结果应当可追溯
- AND 异常情况应当有适当的处理和用户提示
Requirement: Frontend Financial Components
前端 SHALL 提供专业的财报展示和交互组件。
Scenario: 财务数据表格展示
- WHEN 用户查看财务报表
- THEN FinancialTable 组件应当展示：
- 多期财务数据的对比表格
- 数值的适当格式化（亿、万、百分比）
- 同比环比增长率的计算和显示
- 异常数据的高亮标识
- AND 支持表格数据的排序和筛选
- AND 提供数据导出功能
Scenario: 趋势图表可视化
- WHEN 用户查看财务指标趋势
- THEN TrendChart 组件应当提供：
- 多指标的时间序列图表
- 同比环比增长率的柱状图
- 同行业对比的雷达图
- 交互式的图表缩放和数据点查看
- AND 图表应当响应式适配不同屏幕尺寸
- AND 支持图表的保存和分享
Scenario: AI 洞察展示
- WHEN 用户查看 AI 分析结果
- THEN AIInsight 组件应当展示：
- 结构化的分析报告内容
- 关键指标的可视化评分
- 风险点的醒目提示
- 投资建议的分级展示
- AND 支持分析结果的收藏和历史查看
- AND 提供分析依据的数据溯源链接