# Lider

**Repository Path**: kkllll/lider

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-05
- **Last Updated**: 2026-07-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Pro-Trader 量化盯盘工具

> A 股量化交易分析平台 | 全真实行情数据 | Vue3 + FastAPI + SQLite

![Version](https://img.shields.io/badge/version-1.0.0-green)
![Vue](https://img.shields.io/badge/Vue-3.5-42b883)
![FastAPI](https://img.shields.io/badge/FastAPI-0.115-009688)

---

## 📋 目录

- [项目概述](#项目概述)
- [技术栈](#技术栈)
- [架构设计](#架构设计)
- [五大页面](#五大页面)
- [快速开始](#快速开始)
- [API 文档](#api-文档)
- [数据库设计](#数据库设计)
- [部署指南](#部署指南)

---

## 🎯 项目概述

Pro-Trader 是一款面向 A 股市场的量化交易分析工具，提供五大核心功能模块：

| 模块 | 功能 |
|------|------|
| 📊 **市场总览** | 情绪指数分时图 + 8 项行情指标 + 板块热点 + 核心龙头 + 快捷入口 |
| 🐉 **龙头梯队** | 连板个股筛选（7 种标签）+ 3 维度排序 + 卡片展示 |
| 📈 **主升排行** | 多维算法 0-100 评分 + 阶段涨幅过滤 + 加入自选 |
| 🐅 **龙虎榜单** | 双栏买卖布局 + 席位弹窗 + 多条件联合筛选 |
| ⭐ **自选监控** | 4 类预警 Tab + 添加/移除 + 预警开关配置 |

### 核心特性

- **全真实行情数据** — AKShare 开源行情接口，零模拟、零硬编码
- **零假数据兜底** — 无行情时返回空数据，前端展示「暂无交易数据」
- **用户鉴权系统** — 注册/登录/Token 鉴权/多用户数据隔离
- **12 小时凭证** — Token 有效期 12 小时，30 分钟静默刷新
- **三源容错** — AKShare → Tushare → 东方财富 自动切换
- **防爆破** — 连续 5 次密码错误锁定 10 分钟

---

## 💻 技术栈

**前端**

| 技术 | 用途 |
|------|------|
| Vue 3 + Vite 5 | 框架 + 构建 |
| Tailwind CSS 3 | 样式 |
| ECharts 5 | 图表 |
| Axios | HTTP 客户端 |
| Vue Router 4 | 路由 + 守卫 |

**后端**

| 技术 | 用途 |
|------|------|
| Python 3.12+ | 运行环境 |
| FastAPI + Uvicorn | Web 服务 |
| SQLite | 数据库 |
| AKShare | A 股行情接口 |

**设计系统：Vivid Freshness 浅色主题**
- 背景 `#f4fafd`，主色 `#26C980`（薄荷绿）
- 涨 `#F25757`（红）/ 跌 `#26C980`（绿）
- 字体 Inter + JetBrains Mono

---

## 🏗️ 架构设计

### 数据流闭环

```
交易所行情(AKShare) → cron_collector.py 定时采集
  → 写入 trade.db (8 张业务表)
    → 本地算法计算情绪/连板/主升分
      → FastAPI 查询 SQLite
        → 前端渲染
```

### 项目结构

```
Pro-Trader/
├── frontend-pc/              # PC 前端
│   ├── src/
│   │   ├── api/              # API 接口模块
│   │   ├── components/       # 公共组件 (TopNav, AppFooter)
│   │   ├── router/           # 路由 + 鉴权守卫
│   │   ├── stores/           # 全局响应式状态 (auth)
│   │   └── views/            # 6 个页面组件
│   ├── vite.config.js
│   └── package.json
├── backend/                  # 后端服务
│   ├── routers/              # 12 个路由模块
│   │   ├── home.py           # 首页
│   │   ├── limit.py          # 龙头梯队
│   │   ├── stock_score.py    # 主升排行
│   │   ├── longhu.py         # 龙虎榜单
│   │   ├── self_watch.py     # 自选监控
│   │   ├── auth.py           # 登录注册
│   │   ├── common.py         # 公共接口
│   │   └── ...
│   ├── cron_collector.py     # 数据采集脚本
│   ├── data_source_manager.py# 三源容错
│   ├── auth_utils.py         # 鉴权工具
│   ├── db_trade.py           # 数据库连接
│   └── main.py               # 入口
├── *.md                      # 规范文档
└── README.md
```

---

## 📄 五大页面

### 🏠 首页 — 市场情绪总览 (`/`)

| 模块 | 数据表 | 说明 |
|------|--------|------|
| 情绪指数分时图 | `market_sentiment` | 22 分时点折线，高潮/冰点阈值线 |
| 全场概览 8 项指标 | `limit_up_record` + `daily_market` + `longhu_rank` | 涨停/跌停/连板率/炸板率/溢价/高度/大额成交/北向 |
| 板块热点 | `plate_hot` | 领涨/领跌 Tab，hover 弹窗 |
| 核心龙头 3 卡片 | `limit_up_record` + `stock_score` | 连板降序 + 评分联表 |
| 快捷入口 4 卡片 | 多表统计 | 龙头/龙虎/主升/自选摘要 |

### 🐉 龙头梯队 (`/leaderboard`)

- 7 种筛选标签：全部 / 1 板 / 2 板 / 3 板 / 4 板+ / 断板 / 炸板
- 3 种排序：连板高度 / 成交额 / 换手率
- 卡片展示：代码、名称、连板标签、涨幅、封单、换手率

### 📈 主升排行 (`/ranking`)

- 6 列数据表格 + 分页
- 多维评分算法（100 分）= 均线多头(20) + 放量上涨(20) + MACD 金叉(15) + 筹码集中(15) + 无连续阴线(15) + 涨停题材(15)
- 涨幅区间过滤 + 标签筛选 + 加入自选

### 🐅 龙虎榜单 (`/dragon`)

- 双栏布局：左栏主力买入 / 右栏主力卖出
- 筛选：Tab + 日期 + 股票搜索 + 营业部搜索 + 概念标签 + 资金流向
- 卡片展示：净额、席位、上榜原因、买卖 TOP2

### ⭐ 自选监控 (`/watchlist`)

- 4 类 Tab：全部 / 主升启动(score≥80) / 破位预警(price<MA20) / 连板晋级
- 操作：添加/移除/预警配置/备注标签
- 30 秒自动刷新

### 🔐 登录注册 (`/login`)

- 双 Tab：登录 / 注册
- 表单实时校验 + 过滤特殊字符
- PBKDF2-HMAC-SHA256 加密，12 小时 Token 有效期
- 防爆破 + 10 分钟锁定

---

## 🚀 快速开始

### 环境要求

- Node.js ≥ 20
- Python ≥ 3.12
- Git

### 1. 克隆项目

```bash
git clone https://gitee.com/kkllll/lider.git
cd lider
```

### 2. 启动后端

```bash
cd backend
python -m venv venv
# Windows: venv\Scripts\activate
# Linux/Mac: source venv/bin/activate
pip install -r requirements.txt
python -m uvicorn main:app --host 127.0.0.1 --port 8011 --reload
```

### 3. 启动前端

```bash
cd frontend-pc
npm install
npm run dev
```

### 4. 访问

- 前端：`http://localhost:3000`
- API 文档：`http://127.0.0.1:8011/docs`

---

## 📡 API 文档

### 鉴权

| 方法 | 路径 | 说明 |
|------|------|------|
| POST | `/api/auth/register` | 注册 |
| POST | `/api/auth/login` | 登录 |
| POST | `/api/auth/logout` | 退出 |
| POST | `/api/auth/refresh_token` | 刷新 Token |

### 首页

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `/api/home/sentiment/today` | 情绪指数 |
| GET | `/api/home/market/overview` | 8 项指标 |
| GET | `/api/home/plate/hot` | 板块热点 |
| GET | `/api/home/dragon/core` | 核心龙头 |
| GET | `/api/home/fast_card` | 快捷卡片 |
| POST | `/api/home/refresh` | 刷新数据 |

### 业务

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `/api/limit/list` | 龙头列表（7 筛选 + 3 排序 + 分页） |
| GET | `/api/stock/score/list` | 主升排行 |
| GET | `/api/longhu/total_stat` | 龙虎汇总 |
| GET | `/api/longhu/list` | 龙虎明细 |
| GET | `/api/self/list` | 自选列表 |
| POST | `/api/self/add` | 添加自选 |
| POST | `/api/self/warn` | 预警配置 |
| DELETE | `/api/self/{code}` | 移除自选 |

### 公共

| 方法 | 路径 | 说明 |
|------|------|------|
| POST | `/api/common/refresh` | 全局刷新 |
| GET | `/api/common/stock/search` | 个股搜索 |
| GET | `/api/common/plate/all_tags` | 板块标签 |

### 统一返回格式

```json
{"code": 0, "msg": "success", "data": {...}}
```

| code | 说明 |
|------|------|
| 0 | 成功 |
| 400 | 参数/业务错误 |
| 401 | 登录失效 |
| -1 | 服务器错误 |

---

## 🗄️ 数据库设计

### 8 张业务表

**`market_sentiment`** — 情绪指数（trade_date, time_point, score, up_count, burst_rate...）

**`limit_up_record`** — 涨跌停（code, name, change_pct, board_num, order_volume, is_burst...）

**`plate_hot`** — 板块热点（plate_name, change_pct, leader_code, leader_name...）

**`daily_market`** — 个股日线（open, close, high, low, volume, amount, ma5/10/20, macd...）

**`longhu_rank`** — 龙虎榜（code, net_buy, buy1~5_name/amt, sell1~5_name/amt, inst_net...）

**`stock_score`** — 主升评分（total_score, ma/volume/macd/chip_score, tag...）

**`stock_basic`** — 股票基础信息（code, name, industry, concept...）

**`self_watch`** — 自选（user_id, stock_code, warn_break/rise/board...）

**`user`** — 用户（username, password(bcrypt), token, token_expire, login_fails, lock_until...）

完整建表 SQL 见 `backend/db_trade.py`。

---

## 🌐 部署指南

### 一键部署与自动部署

服务器首次部署或升级部署：

```bash
cd /opt/lider
git fetch origin
git reset --hard origin/master
chmod +x deploy.sh
sudo ./deploy.sh
```

`deploy.sh` 会自动安装 root 定时任务：

```bash
* * * * * /bin/bash /opt/lider/scripts/auto_deploy.sh
```

之后只要把代码推送到 Gitee `master` 分支，服务器会在 1 分钟内自动检测新提交、拉取代码、构建前端、重启后端和 Nginx。

查看自动部署日志：

```bash
sudo tail -f /var/log/pro-trader-auto-deploy.log
```

### 后端（systemd）

```ini
[Unit]
Description=Pro-Trader API
After=network.target

[Service]
WorkingDirectory=/path/to/backend
ExecStart=/path/to/venv/bin/python -m uvicorn main:app --host 0.0.0.0 --port 8011
Restart=always
User=www-data

[Install]
WantedBy=multi-user.target
```

### 定时采集（crontab）

```bash
# 交易日 09:30-15:30 每 5 分钟
*/5 9-15 * * 1-5 cd /path/backend && python cron_collector.py

# 15:35 收盘完整采集
35 15 * * 1-5 cd /path/backend && python cron_collector.py

# 00:10 同步基础信息
10 0 * * * cd /path/backend && python cron_collector.py
```

### Nginx 反向代理

```nginx
server {
    listen 80;
    server_name your-domain.com;

    location /api/ {
        proxy_pass http://127.0.0.1:8011;
        proxy_set_header Host $host;
    }

    location / {
        root /path/to/frontend-pc/dist;
        try_files $uri $uri/ /index.html;
    }
}
```

---

## 📝 开发规范

- 所有 API 返回 `{code, msg, data}` 统一格式
- 禁止硬编码 / fallback，无行情返回空数据
- 前端使用 `<script setup>` + Tailwind
- 后端类型注解全覆盖