You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

5.8 KiB

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

智能期货期权分析系统 - 文档中心

📢 重要更新 (2026-03-03)

后端服务已实现! 系统现已完整包含用户认证、行情数据、技术指标、期权分析、AI智能分析等全部核心功能。


文档目录

文档 说明
01-项目概述.md 项目简介、核心功能、技术栈
02-开发文档.md 环境搭建、组件详解、数据类型
03-后续扩展计划.md 待实现功能、开发排期
04-API接口文档.md 接口规范、请求/响应示例
05-部署文档.md 部署方案、数据库设计
06-前端组件文档.md 组件Props、使用示例
07-TODO计划.md 详细任务清单、开发排期
../PROJECT_SUMMARY.md 功能实现总结
../DEPLOY.md 部署指南

🚀 快速启动

Docker方式 (推荐)

# 1. 进入项目目录
cd AlphaFuturesProMax

# 2. 启动所有服务
docker-compose up -d

# 3. 访问应用
# 前端: http://localhost
# API文档: http://localhost:3000/docs

手动部署

# 后端
cd app/server
npm install
npx prisma migrate deploy
npm run start:dev

# 前端
cd app
npm install
npm run dev

详细部署说明请参考 DEPLOY.md


已实现功能

后端服务 (NestJS + TypeScript)

  • 用户认证系统 - JWT认证、注册/登录/登出
  • 行情数据服务 - REST API + WebSocket实时推送
  • 技术指标引擎 - MACD, RSI, KDJ, BOLL, SAR, OBV, DMI, CCI, WR
  • 期权分析模块 - Black-Scholes定价、希腊值、波动率曲面
  • AI智能分析 - OpenAI集成、趋势判断、交易建议
  • 热点事件管理 - 事件增删改查、影响分析
  • 自选股功能 - 自选管理、价格预警
  • 价格预警系统 - 定时检查、触发通知

前端功能

  • 市场概览仪表盘
  • 热点事件智能分析
  • 多周期品种筛选
  • K线技术分析 (MACD/成交量/MA)
  • 交易建议系统
  • 响应式布局
  • 深色主题
  • API服务封装

部署运维

  • Docker容器化
  • Docker Compose编排
  • PostgreSQL数据库
  • Redis缓存
  • Nginx反向代理

📡 API接口

认证

  • POST /api/v1/auth/register - 注册
  • POST /api/v1/auth/login - 登录
  • GET /api/v1/auth/profile - 用户信息

行情

  • GET /api/v1/market/products - 品种列表
  • GET /api/v1/market/products/:symbol/kline - K线数据
  • GET /api/v1/market/overview - 市场概览
  • WebSocket: ws://localhost:3000/market - 实时推送

技术指标

  • GET /api/v1/indicators/:symbol - 全部指标
  • GET /api/v1/indicators/:symbol/macd - MACD
  • GET /api/v1/indicators/:symbol/rsi - RSI
  • GET /api/v1/indicators/:symbol/bollinger - 布林带

期权

  • POST /api/v1/options/pricing - 期权定价
  • GET /api/v1/options/chain/:underlying - 期权链
  • POST /api/v1/options/strategy/payoff - 策略盈亏

AI分析

  • GET /api/v1/ai/analyze/:symbol - AI智能分析

更多

完整API文档请访问: http://localhost:3000/docs


📊 项目进度

整体进度: [████████████████████░░░░] 85%

前端UI:    [████████████████████░░░░] 85%
后端服务:  [████████████████████░░░░] 85%
数据接入:  [████████████████████░░░░] 85%
部署配置:  [████████████████████████] 100%
文档完善:  [████████████████████████] 95%

当前状态

  • 已完成: 完整后端服务、前端UI、Docker部署
  • 待完善: 前端接入真实API、交易信号系统

🏗️ 技术栈

后端

  • 框架: NestJS 10 + TypeScript
  • 数据库: PostgreSQL 15 + Prisma ORM
  • 缓存: Redis 7
  • 认证: JWT + Passport
  • 文档: Swagger/OpenAPI

前端

  • 框架: React 18 + TypeScript + Vite
  • 样式: Tailwind CSS 3.4 + shadcn/ui
  • 图表: ECharts 5.4
  • 状态: Zustand (推荐)

部署

  • 容器: Docker + Docker Compose
  • 代理: Nginx
  • CI/CD: GitHub Actions (可选)

📁 项目结构

AlphaFuturesProMax/
├── app/                      # 前端
│   ├── src/
│   │   ├── components/       # UI组件
│   │   ├── services/         # API & WebSocket
│   │   └── ...
│   ├── Dockerfile
│   └── nginx.conf
│
├── app/server/               # 后端 (NestJS)
│   ├── src/
│   │   ├── auth/             # 认证模块
│   │   ├── market/           # 行情模块
│   │   ├── indicators/       # 技术指标
│   │   ├── options/          # 期权分析
│   │   ├── ai/               # AI分析
│   │   ├── events/           # 热点事件
│   │   ├── watchlist/        # 自选股
│   │   └── common/           # 公共模块
│   ├── prisma/
│   └── Dockerfile
│
├── docker-compose.yml        # Docker编排
├── DEPLOY.md                 # 部署指南
└── docs/                     # 文档目录

🎯 扩展建议

数据源接入

目前使用模拟数据,可接入:

  • Wind/iFinD/Choice API
  • 交易所官方API

新增功能

  • 交易信号系统 (多指标共振)
  • 量化策略回测引擎
  • 管理后台
  • 移动端APP

📄 许可证

MIT License


联系方式

如有问题或建议,欢迎反馈。