# new_qtm_py

**Repository Path**: mq/new_qtm_py

## Basic Information

- **Project Name**: new_qtm_py
- **Description**: new_qtm_py
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-15
- **Last Updated**: 2026-02-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 涨停预测系统 - 前后端分离版本

<div align="center">

![Vue](https://img.shields.io/badge/Vue-3.4+-4FC08D?style=flat&logo=vue.js&logoColor=white)
![TypeScript](https://img.shields.io/badge/TypeScript-5.3+-3178C6?style=flat&logo=typescript&logoColor=white)
![Vite](https://img.shields.io/badge/Vite-5.0+-646CFF?style=flat&logo=vite&logoColor=white)
![Pinia](https://img.shields.io/badge/Pinia-2.1+-FFD859?style=flat&logo=pinia&logoColor=black)
![Element Plus](https://img.shields.io/badge/Element_Plus-2.5+-409EFF?style=flat&logo=element&logoColor=white)

**基于Vue 3 + TypeScript的现代化股票涨停预测系统**

[在线演示](http://localhost:10000) | [快速开始](#快速开始) | [文档](#文档) | [更新日志](#更新日志)

</div>

## ✨ 特性

- 🚀 **现代化技术栈** - Vue 3.4+ / TypeScript 5.3+ / Vite 5.0+
- 📦 **完整的工程化** - ESLint / Prettier / Husky / Commitlint
- 🎨 **优秀的UI设计** - Element Plus + 自定义组件库
- 🔥 **热模块替换** - Vite HMR，开发体验极佳
- 💪 **类型安全** - 完整的TypeScript类型定义
- 🎯 **状态管理** - Pinia 2.1+，轻量且强大
- 📊 **数据可视化** - ECharts图表，支持K线、折线、柱状、饼图
- 🔐 **权限管理** - 完整的用户权限系统
- 📱 **响应式设计** - 支持桌面端和移动端
- ⚡ **性能优化** - 虚拟滚动、懒加载、代码分割

## 📦 项目结构

```
涨停预测系统/
├── backend/                 # 后端项目（Python）
│   ├── src/                # Python源代码
│   ├── packages/           # Python包
│   ├── services/           # 服务层
│   ├── apps/               # 应用层
│   ├── scripts/            # 脚本目录
│   ├── tests/              # 测试代码
│   ├── config/             # 配置文件
│   ├── docker/             # Docker配置
│   ├── pyproject.toml      # Python项目配置
│   └── start_all.bat       # 后端启动脚本
│
├── front/                   # 前端项目（Vue 3）
│   ├── src/
│   │   ├── api/            # API接口封装
│   │   ├── components/     # 组件库
│   │   ├── composables/    # 组合式函数
│   │   ├── router/         # 路由配置
│   │   ├── stores/         # 状态管理
│   │   ├── types/          # 类型定义
│   │   ├── utils/          # 工具函数
│   │   ├── views/          # 页面组件
│   │   ├── App.vue         # 根组件
│   │   └── main.ts         # 应用入口
│   ├── package.json        # 项目配置
│   ├── tsconfig.json       # TS配置
│   ├── vite.config.ts      # Vite配置
│   └── start_frontend_dev.bat  # 前端启动脚本
│
├── docs/                    # 设计文档
├── start_all.bat            # 一键启动前后端
├── start_backend.bat        # 启动后端
├── start_frontend.bat       # 启动前端
└── README.md                # 项目说明（本文件）
```

## 🚀 快速开始

### 环境要求

- Node.js >= 18.0.0
- npm >= 9.0.0 或 yarn >= 1.22.0
- Python >= 3.9, < 3.12
- Docker Desktop（用于数据库服务）

### 安装

```bash
# 克隆项目
git clone <repository-url>

# 一键启动前后端
start_all.bat

# 或分别启动
# 启动后端
cd backend
start_all.bat

# 启动前端（新终端）
cd front
npm install
npm run dev
```

### 开发

```bash
# 启动开发服务器
npm run dev

# 访问地址
http://localhost:10000
```

### 构建

```bash
# 构建生产版本
npm run build

# 预览生产版本
npm run preview
```

### 代码检查

```bash
# ESLint检查
npm run lint

# 类型检查
npm run type-check
```

## 📖 功能模块

### 1. 首页

- 系统概览统计
- 核心功能展示
- 技术栈展示
- 项目状态展示
- 快速操作入口

### 2. 实时预警

- 多维度筛选（类型、置信度、时间）
- 实时预警列表
- 预警统计分析
- 预警详情查看
- 导出功能

### 3. 个股分析

- 股票搜索（代码/名称）
- 股票信息面板
- K线图表（日K/周K/月K）
- 技术指标（MA/MACD/KDJ/RSI）
- AI涨停预测

### 4. 数据管理

- 数据下载（日线/分钟/Tick）
- 涨停数据下载
- 任务管理（启动/暂停/取消）
- 数据日历
- 数据统计

### 5. 模型管理

- 模型训练（LSTM/GRU/Transformer/XGBoost）
- 模型列表管理
- 预测结果查看
- 模型性能对比

### 6. 回测报告

- 回测配置
- 绩效指标（收益率/夏普比率/最大回撤）
- 权益曲线
- 交易明细
- 月度收益分布

## 🛠️ 技术栈

### 核心框架

- **Vue 3.4+** - 渐进式JavaScript框架
- **TypeScript 5.3+** - JavaScript的超集
- **Vite 5.0+** - 下一代前端构建工具

### UI组件

- **Element Plus 2.5+** - Vue 3组件库
- **ECharts 5.5+** - 数据可视化图表库

### 状态管理

- **Pinia 2.1+** - Vue官方状态管理库
- **Vue Router 4.x** - Vue官方路由管理器

### HTTP请求

- **Axios 1.6+** - Promise based HTTP client

### 工具库

- **Day.js** - 轻量级日期处理库
- **Lodash-es** - JavaScript工具库
- **Numeral.js** - 数字格式化库

### 开发工具

- **ESLint** - 代码检查工具
- **Prettier** - 代码格式化工具
- **Husky** - Git hooks工具
- **Commitlint** - 提交信息检查工具

## 📊 项目统计

- **文件总数**: 82个
- **代码行数**: 约17500行
- **组件数量**: 15个
- **页面数量**: 6个
- **API接口**: 21个
- **工具函数**: 80+个
- **类型定义**: 100+个

## 🎯 核心特性

### 1. 完整的类型系统

```typescript
// 完整的TypeScript类型定义
interface StockInfo {
  code: string
  name: string
  market: string
  industry?: string
  sector?: string
}

interface QuoteData {
  code: string
  price: number
  change: number
  volume: number
  // ...
}
```

### 2. 丰富的工具函数

```typescript
// 日期处理
formatDate(date, 'YYYY-MM-DD HH:mm:ss')
getRelativeTime(date) // "5分钟前"

// 数字处理
formatNumber(12345.67) // "12,345.67"
formatCurrency(12345.67) // "¥12,345.67"
formatLargeNumber(123456789) // "1.23亿"

// DOM操作
scrollToTop()
copyToClipboard(text)
downloadFile(url, filename)
```

### 3. 组合式函数

```typescript
// 请求状态管理
const { data, loading, error, execute } = useRequest(fetchData)

// 分页逻辑
const { page, pageSize, total, handlePageChange } = usePagination()

// 图表逻辑
const { chartData, updateData, resize } = useChart(initialData)
```

### 4. 状态管理

```typescript
// Pinia Store
const userStore = useUserStore()
const stockStore = useStockStore()
const alertStore = useAlertStore()

// 使用状态
const { isLoggedIn, username } = userStore
const { currentStock, favorites } = stockStore
const { alerts, statistics } = alertStore
```

## 📝 开发规范

### 代码风格

- 使用TypeScript严格模式
- 遵循Vue 3 Composition API
- 使用ESLint + Prettier
- 组件使用PascalCase命名
- 文件使用kebab-case命名

### Git提交规范

```bash
feat: 新功能
fix: 修复bug
docs: 文档更新
style: 代码格式调整
refactor: 代码重构
perf: 性能优化
test: 测试相关
chore: 构建/工具相关
```

### 组件开发规范

```vue
<template>
  <!-- 模板 -->
</template>

<script setup lang="ts">
// 导入
import { ref } from 'vue'

// 类型定义
interface Props {
  // ...
}

// Props
const props = defineProps<Props>()

// Emits
const emit = defineEmits<{
  (e: 'change', value: string): void
}>()

// 响应式数据
const data = ref('')

// 方法
const handleChange = () => {
  emit('change', data.value)
}
</script>

<style scoped>
/* 样式 */
</style>
```

## 🔧 配置说明

### 环境变量

```bash
# .env.development
VITE_API_BASE_URL=http://localhost:20000
VITE_WS_BASE_URL=ws://localhost:20000

# .env.production
VITE_API_BASE_URL=https://api.example.com
VITE_WS_BASE_URL=wss://api.example.com
```

### Vite配置

```typescript
// vite.config.ts
export default defineConfig({
  plugins: [vue()],
  resolve: {
    alias: {
      '@': '/src',
    },
  },
  server: {
    port: 10000,
    proxy: {
      '/api': {
        target: 'http://localhost:20000',
        changeOrigin: true,
      },
    },
  },
})
```

## 📚 文档

- [快速开始](./front/QUICK_START.md)
- [使用指南](./HOW_TO_USE.md)
- [设计文档](./docs/frontend_separation_design.md)
- [技术栈说明](./docs/frontend_tech_stack_2025.md)
- [API文档](./docs/api/)

## 🤝 贡献指南

欢迎贡献代码！请遵循以下步骤：

1. Fork本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'feat: Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启Pull Request

## 📄 许可证

[MIT License](./LICENSE)

## 👥 作者

- **开发团队** - [GitHub](https://github.com/your-team)

## 🙏 致谢

感谢以下开源项目：

- [Vue.js](https://vuejs.org/)
- [TypeScript](https://www.typescriptlang.org/)
- [Vite](https://vitejs.dev/)
- [Element Plus](https://element-plus.org/)
- [ECharts](https://echarts.apache.org/)
- [Pinia](https://pinia.vuejs.org/)

## 📞 联系方式

- 邮箱: contact@example.com
- 官网: https://example.com
- 问题反馈: [GitHub Issues](https://github.com/your-repo/issues)

## 🔄 更新日志

### v1.0.0 (2024-12-19)

#### ✨ 新功能
- 完整的前后端分离架构
- 6个主要功能模块
- 15个可复用组件
- 完整的类型系统
- 丰富的工具函数库

#### 🎨 UI/UX
- 现代化的界面设计
- 流畅的动画效果
- 响应式布局
- 深色模式支持（规划中）

#### ⚡ 性能优化
- 虚拟滚动
- 图片懒加载
- 代码分割
- 请求缓存

#### 📝 文档
- 完整的开发文档
- API接口文档
- 组件使用文档
- 部署指南

---

<div align="center">

**⭐ 如果这个项目对你有帮助，请给一个Star！⭐**

Made with ❤️ by Development Team

</div>