Skip to content

INFRASTRUCTURE_SETUP.md

Latest commit

 

History

History
245 lines (208 loc) · 8.75 KB

INFRASTRUCTURE_SETUP.md

File metadata and controls

245 lines (208 loc) · 8.75 KB

TradingAgents 基础设施层搭建完成

📋 已完成的基础设施组件

🏗️ 项目结构

  • ✅ 完整的目录结构创建
  • ✅ Python包初始化文件 (__init__.py)
  • ✅ 模块化的代码组织

⚙️ 配置管理

  • ✅ config/settings.py - 统一配置管理，基于Pydantic
  • ✅ config/database.py - PostgreSQL数据库连接和会话管理
  • ✅ config/redis.py - Redis缓存配置和管理
  • ✅ config/llm_models.py - LLM模型配置和管理

📦 依赖管理

  • ✅ requirements.txt - Python依赖包列表
  • ✅ pyproject.toml - 项目元数据和工具配置
  • ✅ 开发、测试、文档的可选依赖分组

🐳 容器化部署

  • ✅ Dockerfile - 应用容器镜像构建
  • ✅ docker-compose.yml - 完整的开发环境编排
  • ✅ 多服务配置：API、数据库、缓存、监控

🛠️ 开发工具

  • ✅ Makefile - 常用开发命令集合
  • ✅ .gitignore - Git忽略文件配置
  • ✅ scripts/setup_dev.py - 开发环境自动化设置脚本

🚀 应用程序

  • ✅ src/main.py - FastAPI应用主入口
  • ✅ 生命周期管理、中间件配置
  • ✅ 健康检查和错误处理

📁 项目目录结构

TradingAgentsSystem/
├── README.md                          # 项目说明文档
├── requirements.txt                   # Python依赖包  ✅
├── pyproject.toml                     # Python项目配置  ✅
├── Dockerfile                         # Docker镜像构建  ✅
├── docker-compose.yml                 # Docker编排  ✅
├── Makefile                           # 构建脚本  ✅
├── .gitignore                         # Git忽略文件  ✅
├── INFRASTRUCTURE_SETUP.md            # 基础设施文档  ✅
│
├── config/                            # 配置文件目录  ✅
│   ├── __init__.py                    ✅
│   ├── settings.py                    # 主配置文件  ✅
│   ├── database.py                    # 数据库配置  ✅
│   ├── redis.py                       # Redis配置  ✅
│   └── llm_models.py                  # LLM模型配置  ✅
│
├── src/                               # 源代码目录  ✅
│   ├── __init__.py                    ✅
│   ├── main.py                        # 应用入口  ✅
│   │
│   ├── agents/                        # 智能体模块  ✅
│   │   ├── __init__.py                ✅
│   │   ├── base/                      # 基础智能体  ✅
│   │   ├── analysts/                  # 分析师团队  ✅
│   │   ├── researchers/               # 研究团队  ✅
│   │   ├── trader/                    # 交易员  ✅
│   │   ├── risk_management/           # 风险管理团队  ✅
│   │   └── fund_manager/              # 基金经理  ✅
│   │
│   ├── core/                          # 核心模块  ✅
│   │   ├── __init__.py                ✅
│   │   ├── communication/             # 通信协议  ✅
│   │   ├── llm/                       # LLM集成  ✅
│   │   ├── security/                  # 安全模块  ✅
│   │   └── utils/                     # 工具模块  ✅
│   │
│   ├── data/                          # 数据模块  ✅
│   │   ├── __init__.py                ✅
│   │   ├── sources/                   # 数据源  ✅
│   │   ├── processors/                # 数据处理  ✅
│   │   ├── indicators/                # 技术指标  ✅
│   │   └── storage/                   # 数据存储  ✅
│   │
│   ├── api/                           # API层  ✅
│   │   ├── __init__.py                ✅
│   │   ├── v1/routes/                 # 路由定义  ✅
│   │   ├── v1/schemas/                # 数据模型  ✅
│   │   └── middleware/                # 中间件  ✅
│   │
│   ├── models/                        # 数据模型  ✅
│   │   ├── __init__.py                ✅
│   │   ├── database/                  # 数据库模型  ✅
│   │   └── business/                  # 业务模型  ✅
│   │
│   ├── services/                      # 服务层  ✅
│   │   └── __init__.py                ✅
│   │
│   └── background/                    # 后台任务  ✅
│       └── __init__.py                ✅
│
├── tests/                             # 测试目录  ✅
│   ├── unit/                          # 单元测试  ✅
│   ├── integration/                   # 集成测试  ✅
│   └── e2e/                          # 端到端测试  ✅
│
├── database/                          # 数据库相关  ✅
│   ├── migrations/                    # 数据库迁移  ✅
│   ├── seeds/                         # 种子数据  ✅
│   └── schemas/                       # 数据库架构  ✅
│
├── web/                               # 前端代码  ✅
│   ├── src/                           # 源代码  ✅
│   ├── public/                        # 静态资源  ✅
│   └── dist/                          # 构建输出  ✅
│
├── deploy/                            # 部署配置  ✅
│   ├── docker/                        # Docker配置  ✅
│   ├── k8s/                          # Kubernetes配置  ✅
│   └── nginx/                         # Nginx配置  ✅
│
├── scripts/                           # 脚本目录  ✅
│   └── setup_dev.py                   # 开发环境设置  ✅
│
└── docs/                              # 文档目录  ✅
    ├── api/                           # API文档  ✅
    ├── deployment/                    # 部署文档  ✅
    └── user_guide/                    # 用户指南  ✅

🚀 快速开始

自动化设置（推荐）

# 运行自动化设置脚本
python scripts/setup_dev.py

手动设置

# 1. 安装Python依赖
pip install -r requirements.txt

# 2. 启动Docker服务
docker-compose up -d db redis

# 3. 创建环境变量文件
cp .env.example .env
# 编辑.env文件，填入API密钥

# 4. 启动应用
python src/main.py

使用Makefile

# 查看所有可用命令
make help

# 设置开发环境
make setup

# 启动开发服务器
make run

# 运行测试
make test

🔧 配置说明

环境变量

主要配置在.env文件中：

  • DATABASE_URL - PostgreSQL数据库连接
  • REDIS_URL - Redis缓存连接
  • OPENAI_API_KEY - OpenAI API密钥
  • DEEPSEEK_API_KEY - DeepSeek API密钥
  • TUSHARE_TOKEN - Tushare数据源令牌

Docker服务

  • PostgreSQL: 端口5432，数据库名trading_agents
  • Redis: 端口6379，用于缓存和消息队列
  • API服务: 端口8000，主应用服务
  • 监控服务: Prometheus(9090), Grafana(3001)

🧪 测试基础设施

健康检查

# 检查应用健康状态
curl http://localhost:8000/health

# 检查应用信息
curl http://localhost:8000/info

数据库连接测试

from config.database import check_db_connection
print(check_db_connection())  # 应该返回True

Redis连接测试

from config.redis import check_redis_connection
print(check_redis_connection())  # 应该返回True

📝 下一步开发计划

基础设施层已完成，接下来按照以下顺序进行开发：

1. 数据层开发 (优先级：最高)

  • 数据库模型设计 (src/models/database/)
  • 数据源集成 (src/data/sources/)
  • 数据处理流水线 (src/data/processors/)
  • 技术指标计算 (src/data/indicators/)

2. 核心服务层 (优先级：高)

  • 工具模块 (src/core/utils/)
  • LLM客户端 (src/core/llm/)
  • 数据服务 (src/services/)

3. 智能体框架 (优先级：中)

  • 基础智能体类 (src/agents/base/)
  • 通信协议 (src/core/communication/)
  • 状态管理系统

4. API接口层 (优先级：低)

  • REST API路由 (src/api/v1/routes/)
  • 数据模型 (src/api/v1/schemas/)
  • 中间件 (src/api/middleware/)

🎯 架构特点

  1. 模块化设计: 清晰的模块边界，易于维护和扩展
  2. 配置驱动: 统一的配置管理，支持环境变量覆盖
  3. 容器化部署: 完整的Docker支持，一键部署开发环境
  4. 类型安全: 使用Pydantic进行配置验证和类型检查
  5. 可测试性: 完整的测试目录结构，支持多层次测试
  6. 监控友好: 内置健康检查和监控支持

基础设施层搭建完成时间: 2024年 状态: ✅ 完成 下一阶段: 数据层开发