数智金融框架搭建

目录

数智金融框架搭建

Digital Intelligence Finance Platform — 后端

核心功能模块

项目结构

API 端点概览

数据库说明

技术栈

Digital Intelligence Finance Platform — 前端

核心功能模块

项目结构

快速启动

页面与路由概览

对接后端 API 概览

技术栈

开发说明

---

Digital Intelligence Finance Platform — 后端

核心功能模块

模块	描述
用户偏好 Agent	长效记忆、风险画像自动建模、实时同步策略生成
新闻解读 Agent	多源爬虫、情感分析、事件-股市影响结构化输出
策略生成 Agent	自然语言→量化策略，DSSM召回+LLM生成
对抗辩论 Agent	多空双Agent多轮博弈，策略参数优化
RAG 知识教学	ChromaDB+BGE嵌入+LLM，金融知识精准问答
量化回测引擎	Backtrader 自动化回测，夏普/回撤/胜率等指标
市场数据服务	AKShare 历史行情+技术指标

项目结构

Digital_Intelligence_Finance_backend/
├── app/
│   ├── main.py                       # FastAPI 应用入口
│   ├── api/
│   │   ├── router.py                 # 路由聚合
│   │   └── routes/
│   │       ├── auth.py               # 注册/登录
│   │       ├── profile.py            # 用户画像
│   │       ├── strategy.py           # 策略生成
│   │       ├── backtest.py           # 量化回测
│   │       ├── news.py               # 新闻解读
│   │       ├── knowledge.py          # 知识教学
│   │       ├── debate.py             # 多空辩论
│   │       └── market.py             # 市场数据
│   ├── agents/
│   │   ├── user_preference_agent.py  # 用户偏好 Agent
│   │   ├── news_agent.py             # 新闻 Agent
│   │   ├── strategy_agent.py         # 策略生成 Agent
│   │   └── debate_agent.py           # 辩论 Agent
│   ├── services/
│   │   ├── backtest_service.py       # Backtrader 策略模板
│   │   ├── backtest_engine.py        # 回测引擎
│   │   ├── rag_service.py            # RAG 问答服务
│   │   └── market_data_service.py    # AKShare 数据
│   ├── models/                       # SQLAlchemy ORM 模型
│   ├── schemas/                      # Pydantic 校验模型
│   ├── db/                           # 数据库客户端
│   └── core/                         # 配置/安全/日志
├── data/
│   ├── chroma_db/                    # ChromaDB 持久化
│   ├── knowledge_base/               # 原始知识库
│   └── user_logs/                    # 用户行为日志
├── main.py                           # 启动入口
├── requirements.txt
├── .env.example
└── README.md

API 端点概览

方法	路径	说明
POST	/api/v1/auth/register	用户注册
POST	/api/v1/auth/login	用户登录
GET	/api/v1/profile/	获取用户画像
PUT	/api/v1/profile/	更新用户画像
POST	/api/v1/strategy/generate	自然语言生成策略
GET	/api/v1/strategy/list	策略列表
POST	/api/v1/backtest/run	提交回测任务
GET	/api/v1/backtest/{id}	查询回测结果
POST	/api/v1/news/analyze	分析新闻事件
GET	/api/v1/news/market-report	市场综合报告
POST	/api/v1/knowledge/ask	RAG 金融问答
POST	/api/v1/knowledge/learning-path	个性化学习路线
POST	/api/v1/debate/run	触发多空辩论
GET	/api/v1/market/history	股票历史行情
GET	/api/v1/market/quote	实时行情
GET	/api/v1/market/search	股票搜索

数据库说明

• 关系型数据库：默认 SQLite（开发），生产环境建议换 MySQL
• 向量数据库：ChromaDB（本地持久化），包含三个 Collection：
  • finance_knowledge：金融知识库
  • user_profiles：用户画像向量
  • strategy_pool：策略向量库（DSSM召回）

技术栈

• 框架：FastAPI + Uvicorn
• ORM：SQLAlchemy 2.0 异步
• 向量库：ChromaDB + BAAI/bge-small-zh-v1.5
• LLM：OpenAI 兼容接口（支持 DeepSeek/Qwen）
• 回测：Backtrader
• 金融数据：AKShare
• 认证：JWT (python-jose)

Digital Intelligence Finance Platform — 前端

核心功能模块

模块	描述
认证模块	登录 / 注册、JWT 本地持久化、自动鉴权请求
首页总览	统一入口，连接策略、知识、新闻、画像等功能页
策略生成	自然语言输入投资意图，生成结构化量化策略
量化回测	选择标的与区间，提交回测并查看指标结果
新闻解读	输入事件文本，输出市场影响分析与市场报告
RAG 知识教学	金融问答、个性化学习路径生成
多空辩论	对策略发起多轮多空辩论，辅助参数优化
用户画像	风险偏好、投资周期、行为日志记录与更新

项目结构

Digital_Intelligence_Finance_Frontend/
├── lib/
│   ├── main.dart                      # 应用入口
│   ├── core/
│   │   ├── constants/
│   │   │   └── app_constants.dart     # 全局常量（含 API 地址）
│   │   ├── network/
│   │   │   └── api_client.dart        # Dio 客户端/JWT 拦截器
│   │   ├── router/
│   │   │   └── app_router.dart        # GoRouter 路由配置
│   │   └── theme/
│   │       └── app_theme.dart         # 全局主题
│   ├── data/
│   │   ├── models/                    # 数据模型
│   │   └── services/                  # 业务 API 服务封装
│   ├── providers/                     # Provider 状态管理
│   ├── pages/                         # 各功能页面
│   └── widgets/                       # 通用组件/图表组件
├── assets/                            # 图片、图标等静态资源
├── pubspec.yaml                       # Flutter 依赖配置
└── README.md

快速启动

# 1. 进入前端目录
cd Digital_Intelligence_Finance_Frontend

# 2. 获取依赖
flutter pub get

# 3. 配置后端地址（按需修改）
# 编辑 lib/core/constants/app_constants.dart 中 baseUrl
# 默认: http://localhost:8000/api/v1

# 4. 启动应用
flutter run

页面与路由概览

路由	页面	说明
/login	登录页	用户登录
/register	注册页	新用户注册
/	首页	平台功能总入口
/knowledge	知识教学页	RAG 问答与学习路径
/strategy	策略页	策略生成与列表
/strategy/:id	策略详情页	查看策略细节
/backtest	回测提交页	配置并运行回测
/backtest/result/:id	回测结果页	查看回测指标与图表
/news	新闻页	新闻事件分析与市场报告
/profile	画像页	查看 / 更新用户画像
/debate/:strategyId	辩论页	对策略发起多空辩论

对接后端 API 概览

请求方法	接口路径	前端用途
POST	/auth/register	注册
POST	/auth/login	登录并保存 Token
GET	/auth/me	获取当前用户信息
GET	/profile/	获取用户画像
PUT	/profile/	更新用户画像
POST	/profile/behavior	记录用户行为
POST	/strategy/generate	生成策略
GET	/strategy/list	获取策略列表
GET	/strategy/{id}	获取策略详情
POST	/backtest/run	提交回测
GET	/backtest/{id}	获取回测结果
GET	/backtest/history/list	获取回测历史
POST	/news/analyze	新闻事件分析
GET	/news/market-report	获取市场综合报告
GET	/news/latest	获取最新新闻
POST	/knowledge/ask	金融问答
POST	/knowledge/learning-path	学习路径生成
GET	/knowledge/stats	获取知识库统计
POST	/debate/run	发起多空辩论
GET	/market/history	获取历史行情
GET	/market/quote	获取实时行情
GET	/market/search	股票搜索

技术栈

• 框架：Flutter 3.41.4（Dart 3）
• 状态管理：Provider
• 网络层：Dio + PrettyDioLogger
• 路由：GoRouter
• 本地存储：SharedPreferences / Flutter Secure Storage
• 图表能力：fl_chart / Syncfusion Charts
• 内容展示：flutter_markdown / cached_network_image / lottie

开发说明

网络请求统一由 ApiClient 管理，自动注入 JWT Token。
如后端未运行，涉及 API 的页面会请求失败，请先启动后端服务。
Android 真机调试时，localhost 指向设备本机；如后端在电脑运行，请改为电脑局域网 IP。