Quant AI - 量化投资系统

一个面向小散户的 AI 量化投资辅助系统，帮助你收集市场数据、观察经济事件、获取 AI 投资建议。

功能

• A股/港股实时行情数据采集
• 技术指标分析（MA、MACD、RSI 等）
• 新闻/公告/宏观事件聚合
• AI 驱动的股票诊断与投资建议
• 自选股管理
• 持仓记账与盈亏分析
• 策略回测与组合分析
• 支持飞书接入（通过 OpenClaw）

快速开始

Docker 部署（推荐）

# 1. 启动全部服务（首次会自动构建镜像）
docker-compose up -d --build

# 2. 查看状态
docker-compose ps

# 3. 查看日志
docker-compose logs -f server   # 后端日志
docker-compose logs -f client   # 前端日志

# 4. 停止并移除容器
docker-compose down

# 5. 彻底重置（包含数据库数据）
docker-compose down -v

环境要求：Docker + Docker Compose。确保 5432、6379、8000、4000 端口未被占用。

访问

服务	地址
前端	http://localhost:4000
后端 API	http://localhost:8000
API 文档	http://localhost:8000/docs

---

本地开发

后端

cd server

# 安装依赖
pip install uv
uv pip install -r pyproject.toml

# 启动（需本地已运行 PostgreSQL + Redis）
export DATABASE_URL="postgresql://quantai:quantai123@localhost:5432/quant_ai"
export REDIS_URL="redis://localhost:6379/0"
PYTHONPATH=. uvicorn src.main:app --reload --port 8000

前端

cd client
pnpm install
pnpm run dev          # http://localhost:5173

---

数据库管理

项目使用 Alembic 管理数据库迁移。

自动迁移（Docker 环境）

容器启动时会自动运行 alembic upgrade head，无需手动操作。

手动执行迁移

# 进入后端容器执行
docker-compose exec server alembic upgrade head

# 或在本地环境执行（需确保 DATABASE_URL 指向正确的数据库）
cd server
alembic upgrade head

回滚迁移

# 回滚到上一个版本
docker-compose exec server alembic downgrade -1

# 回滚到最初
docker-compose exec server alembic downgrade base

生成新的迁移文件

修改 server/src/models/models.py 后：

cd server
alembic revision --autogenerate -m "描述你的变更"
alembic upgrade head

---

测试

后端单元测试

cd server
PYTHONPATH=. pytest tests/ -v --ignore=tests/e2e

后端 E2E 测试（API 集成测试）

使用 FastAPI TestClient 对后端 API 进行集成测试。依赖 Docker PostgreSQL 临时容器，自动启动、迁移、销毁。

cd server
PYTHONPATH=. pytest tests/e2e/ -v

运行过程：

1. 自动拉取并启动 postgres:16-alpine 临时容器
2. 对该容器运行 alembic upgrade head 创建表结构
3. 每个测试在独立事务中执行，结束后回滚，互不干扰
4. 全部测试完成后自动销毁容器

注意：需要本地 Docker 守护进程可用。

前端 E2E 测试（Playwright 浏览器测试）

基于 Playwright 的真实浏览器端到端测试，覆盖完整的用户交互流程。

安装浏览器（首次）

cd client
pnpm exec playwright install chromium

本地运行

#  headed 模式（有界面）
cd client && pnpm run test:e2e

# UI 模式（交互式调试）
cd client && pnpm run test:e2e:ui

Docker 运行（完整栈）

# 启动 PostgreSQL + Redis + Server + Client + Playwright
E2E_SEED_ENABLED=true docker compose --profile e2e up --build --exit-code-from playwright

测试范围

测试文件	覆盖功能
e2e/auth.spec.ts	注册、登录、登出、受保护路由
e2e/dashboard.spec.ts	Dashboard 加载、导航菜单
e2e/screener.spec.ts	智能选股、筛选条件
e2e/portfolio.spec.ts	持仓管理、添加交易
e2e/quant.spec.ts	策略回测
e2e/ai-chat.spec.ts	AI 智能诊断
e2e/notifications.spec.ts	告警中心、通知 badge

调试

测试失败时自动保存：

• 截图：client/test-results/
• 视频：client/playwright-report/
• Trace：运行 npx playwright show-report 查看

Lint 检查

# 后端 (Docker)
docker-compose exec server ruff check src/

# 前端
cd client
pnpm run lint

技术栈

• 部署: Docker + Docker Compose
• 前端: React + Vite + pnpm + Nginx
• 后端: FastAPI + SQLAlchemy + uv
• 数据库: PostgreSQL + Redis
• 数据源: AkShare + yfinance
• AI: DeepSeek API
• Lint: Ruff + ESLint
• E2E 测试: Playwright

项目结构

quant-ai/
├── docker-compose.yml    # 部署配置
├── AGENTS.md             # Agent 开发指南
├── README.md             # 项目说明
├── server/               # FastAPI 后端
│   ├── src/
│   │   ├── models/      # 数据库模型
│   │   ├── services/    # 业务服务
│   │   ├── api/         # API 路由
│   │   └── main.py      # 入口
│   ├── tests/           # 测试（含 E2E）
│   ├── migrations/      # Alembic 迁移
│   ├── pyproject.toml   # 依赖与工具配置
│   ├── alembic.ini      # Alembic 配置
│   └── Dockerfile
├── client/              # React 前端
│   ├── src/
│   │   ├── pages/       # 页面组件
│   │   ├── components/  # 公共组件
│   │   └── services/    # API 客户端
│   ├── e2e/             # Playwright E2E 测试
│   ├── package.json
│   └── Dockerfile
└── openclaw-skills/     # OpenClaw Skill

License

MIT