# stock

**Repository Path**: jetlag/stock

## Basic Information

- **Project Name**: stock
- **Description**: A 股 Web 量化工作台：八策略评分、全市场回测、市场雷达实时推送、模拟交易 · Spring Boot 开源

# 短线精灵 · A 股量化分析工作台

**还在用 Excel + 多个行情软件拼数据？**

短线精灵把 A 股短线投资最常用的一套能力收进一个 Web 工作台：

- 🎯 **八策略智能评分** — 趋势、动量、价值等维度自动打分，因子明细一目了然  
- 📊 **全市场历
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: dev
- **Homepage**: https://lhrj666.asia
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-05-06
- **Last Updated**: 2026-06-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 短线精灵 · A 股量化分析工作台

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Java](https://img.shields.io/badge/Java-17-orange)](https://openjdk.org/)
[![Spring Boot](https://img.shields.io/badge/Spring%20Boot-4.0-green)](https://spring.io/projects/spring-boot)

面向 A 股短线/波段投资者的 **Web 端智能分析平台**：聚合行情、八策略评分、全市场回测、条件选股、市场雷达实时推送、模拟交易与 RBAC 管理后台。

> **本仓库为 Community 基础版**（`dev` 分支：涨跌榜、板块、全市场、自选等）。  
> **会员功能**（市场雷达、八策略分析、全市场回测、模拟盘、兑换码等）不在公开源码中发布，见 [版本拆分说明](docs/edition-split.md)。

> **开源说明**：本项目以学习与研究为目的开放源码。**不构成任何投资建议**；部署后请自行配置数据库与密钥，勿将含密码的配置提交到公开仓库。

📖 **完整使用说明** → [docs/使用说明.md](docs/使用说明.md)

<p align="center">
  <img src="docs/assets/system-preview.png" alt="短线精灵工作台界面" width="920" />
</p>

<p align="center"><sub>工作台界面示意（首页 · 市场总览 · 市场雷达 · 八策略评分）</sub></p>

---

## 功能概览

### Community 基础版（本仓库）

| 模块 | 说明 |
|------|------|
| 涨跌榜 / 板块 | 涨跌幅排行、热点板块 |
| 全市场 | 快照列表浏览、轻量搜索 |
| 自选股 | 收藏与列表 |
| 基础 K 线 | 个股 K 线查询 |
| 登录 / RBAC | 用户、角色、精简管理后台 |

### Commercial 商业版（私有，不开源）

| 模块 | 说明 |
|------|------|
| 市场雷达 | 三榜热池、SSE 推送、P0/P1 异动 |
| 个股分析 | 八策略评分、因子明细、深度研究 |
| 策略分析 | 全市场历史回测、胜率统计 |
| 条件选股 | 多维筛选、规则保存 |
| 模拟交易 | 虚拟账户、排行榜 |
| 会员体系 | 兑换码、试用、邀请奖励 |

完整对比与仓库拆分方案 → [docs/edition-split.md](docs/edition-split.md)

---

## 快速开始

### 环境要求

| 组件 | 版本 |
|------|------|
| JDK | 17+ |
| Maven | 3.8+ |
| MySQL | 8.0+ |
| Python（可选） | 3.10+，用于 akshare / 深度研究桥接 |

### 1. 克隆仓库（基础版请用 `dev` 分支）

```bash
git clone -b dev https://gitee.com/jetlag/stock.git
cd stock
```

### 2. 创建数据库

```sql
CREATE DATABASE stock_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

表结构由 **Flyway** 在首次启动时自动迁移（`src/main/resources/db/migration/`）。

### 3. 本地配置

```bash
cp application-community.example.yml application-local.yml
# 或: cp application-local.example.yml application-local.yml
# 编辑 application-local.yml，填入本机 MySQL 账号密码
```

**务必**使用 `application-local.yml` 覆盖默认配置，不要将真实密码写入 `application.yml` 后推送公开仓库。

### 4. 启动

```bash
# 开发模式（HTTP 9999）
mvn spring-boot:run -Dspring-boot.run.profiles=local

# 或使用脚本
bash start_server.sh
```

浏览器访问：**http://localhost:9999**

- 主站：`/index.html`
- 登录：`/login.html`
- 管理后台：`/admin.html`

### 5. 管理员账号

首次启动时，`DataInitializer` 会自动初始化超级管理员账号（默认用户名为 `admin`）。

- **请勿在公开环境使用默认凭据** — 登录 [`/admin.html`](http://localhost:9999/admin.html) 后请立即修改密码  
- 忘记密码可在管理后台重置，或通过数据库更新 BCrypt 哈希（详见 [使用说明 · FAQ](docs/使用说明.md#q7管理员密码如何重置)）

### 6. Python 桥接（可选）

深度研究、资讯等依赖 akshare，需单独虚拟环境：

```bash
bash scripts/setup_venv_cn.sh
bash scripts/doctor_cn_bridge.sh   # 自检
```

---

## 技术栈

- **后端**：Spring Boot 4 · JPA · Flyway · Sa-Token · WebSocket
- **前端**：原生 HTML / CSS / JavaScript（无构建链）
- **数据**：东方财富 API · 本地快照缓存 · Python akshare 桥接
- **数据库**：MySQL 8

---

## 项目结构

```
stock/
├── src/main/java/com/jetlag/stock/   # 后端业务代码
├── src/main/resources/
│   ├── application.yml               # 默认配置（开源请改用 local 覆盖）
│   ├── application-local.example.yml # 本地配置模板
│   ├── db/migration/                 # Flyway 数据库迁移
│   └── static/                       # 前端页面与静态资源
├── scripts/                          # Python 桥接与运维脚本
├── docs/                             # 文档
├── promo/                            # 宣传物料（可选）
├── start_server.sh                   # 启动脚本
└── pom.xml
```

---

## 配置说明（摘要）

| 配置项 | 说明 | 默认 |
|--------|------|------|
| `server.port` | HTTP 端口 | 9999 |
| `app.sms.enabled` | 短信验证码 | false |
| `app.wechat-mp.enabled` | 微信公众号 | 可关闭 |
| `market-radar.enabled` | 市场雷达 | true |
| `crawler.cn-data-bridge-enabled` | Python 深度数据 | true |

生产部署、HTTPS、环境变量注入详见 [docs/使用说明.md](docs/使用说明.md#生产部署)。

---

## 交流与反馈

部署或使用中有问题，欢迎通过以下方式交流（**技术讨论与使用答疑，不构成投资建议**）：

| 渠道 | 说明 |
|------|------|
| **微信公众号** | 搜索 **「短线精灵」** 或扫码关注；菜单栏可登录工作台，回复 **「试用」** 了解兑换说明 |
| **QQ 群** | **量化达摩院交流 1 群** · 群号 `708167467` |

<p align="center">
  <img src="docs/assets/wechat-mp-qrcode.png" alt="短线精灵公众号" width="200" />
  &nbsp;&nbsp;&nbsp;
  <img src="docs/assets/qq-group-qrcode.png" alt="QQ群 708167467" width="200" />
</p>

<p align="center"><sub>左：微信公众号 · 右：QQ 群（708167467）</sub></p>

也可在 [Gitee Issues](https://gitee.com/jetlag/stock/issues) 提交 Bug 或功能建议。

---

## 系统设计文档

| 文档 | 内容 |
|------|------|
| [需求文档](docs/system/requirements.md) | 功能/非功能需求、用户角色、模块边界 |
| [概要设计](docs/system/overview-design.md) | 逻辑架构、技术选型、模块划分、部署架构 |
| [详细设计](docs/system/detailed-design.md) | 核心流程、数据模型、接口与缓存设计 |

**功能模块一览（摘自需求文档）：**

| 前台模块 | 能力摘要 |
|----------|----------|
| 首页 / 涨跌榜 / 板块 | 大盘指数、涨跌幅排行、热点板块 |
| 全市场 / 条件选股 | 快照列表、秒级搜索、多维筛选与策略保存 |
| 个股分析 | 八策略评分、K 线、因子明细、深度研究 |
| 策略分析 | 全市场回测、胜率统计、信号钻取 |
| 市场雷达 | 三榜热池、SSE 推送、P0/P1 异动 |
| 模拟交易 | 虚拟账户、实时撮合、排行榜 |
| 管理后台 | 用户/RBAC、审计、会员兑换码、客服、调度 |

---

## 文档索引

| 文档 | 内容 |
|------|------|
| [docs/使用说明.md](docs/使用说明.md) | **开源部署与功能使用（主文档）** |
| [docs/edition-split.md](docs/edition-split.md) | **基础版 / 商业版拆分与分支策略** |
| [docs/system/](docs/system/) | **需求 / 概要 / 详细设计** |
| [docs/database-tables.md](docs/database-tables.md) | 数据库表说明 |

---

## 免责声明

本软件仅供 **学习、研究与技术交流**，用于信息整理、规则对照与历史回测参考。

- 不构成任何投资建议、收益承诺或买卖推荐  
- 不提供代客理财、不荐股、不指导具体操作  
- 策略评分与回测结果不代表未来表现  
- 市场有风险，投资需独立判断  

---

## 许可证

[MIT License](LICENSE) © 2026