# 炒股

**Repository Path**: hai_long_wang/stock-trading

## Basic Information

- **Project Name**: 炒股
- **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-03-17
- **Last Updated**: 2026-04-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 技术型炒股系统

这是一个围绕 A 股技术交易闭环构建的本地化项目，覆盖了以下链路：

- 市场环境与主线识别
- 模板扫描与候选池
- 盘前计划与重点跟踪
- 盘中执行与复盘
- 本地历史数据仓库
- Windows 桌面版打包与自检

## 目录结构

- [backend](backend): FastAPI、调度、数据库、桌面版后端入口
- [tech-chart-vite](tech-chart-vite): Vue 3 + Vite 前端
- [scripts](scripts): 自检、编码检查等辅助脚本
- [stock_data](stock_data): 公共数据库、缓存、运行日志
- [dist](dist): 根目录桌面版产物

## 快速开始

### 1. 后端

```powershell
cd backend
python -m venv .venv
.venv\Scripts\activate
python -m pip install -r requirements.txt -r requirements-dev.txt
python -m alembic -c alembic.ini upgrade head
python run_backend.py
```

默认后端地址：`http://127.0.0.1:3377`

健康检查：

```powershell
Invoke-WebRequest "http://127.0.0.1:3377/api/health/ping" | Select-Object -ExpandProperty Content
```

### 2. 前端开发

```powershell
cd tech-chart-vite
npm ci
npm run dev
```

Vite 开发端口默认是 `5870`，前端会自动请求 `127.0.0.1:3377`。

### 3. 一键开发启动

项目根目录提供了一个 Python 包装入口：

```powershell
python start-dev.py
```

它会委托到现有的开发启动脚本，适合在本地直接拉起开发环境。

## 桌面版

### 打包

```powershell
cmd /c build-desktop.bat
```

打包成功后：

- 后端原始产物在 `backend/dist/technical-stock-desktop.exe`
- 根目录副本在 `dist/technical-stock-desktop.exe`

### 自检

桌面版支持完整冒烟检查：

```powershell
python scripts/desktop_smoke_check.py
```

CI/无界面场景下可用：

```powershell
python scripts/desktop_smoke_check.py --headless
```

这会校验：

- `GET /api/health/ping`
- `GET /api/health/info`
- 首页前端资源是否正确挂载
- `GET /api/signals/templates`
- `POST /api/signals/backtest`

## 数据目录与数据库

默认公共数据目录是 [stock_data](stock_data)。

- 开发环境默认数据库：`stock_data/technical_stock.db`
- 根目录 `dist/` 下运行的桌面版：仍共享 `stock_data/technical_stock.db`
- 如果把 EXE 复制到其他目录：会改用 `EXE 同级目录/stock_data/technical_stock.db`

后端健康信息接口 [backend/app/api/health.py](backend/app/api/health.py) 会返回当前 `data_dir` 和 `db_file`。

## CI

当前 CI 已覆盖三条主链路：

- 后端质量检查：`ruff`、Alembic、乱码检查、编译、pytest
- 前端质量检查：Vitest、Vite 构建
- Windows 桌面冒烟：桌面打包 + `desktop_smoke_check.py --headless`

工作流文件见 [.github/workflows/ci.yml](.github/workflows/ci.yml)。

## 职责边界

扫描结果和计划结果不是同一个概念，项目已经开始显式收口这条边界。

- 扫描结果：由 `/api/signals/scan*` 提供，目的是“发现机会、形成候选快照”
- 计划结果：由 `/api/plans/*` 提供，目的是“生成当日可执行计划、重点跟踪与盘前策略”

详细说明见 [docs/scan-plan-boundary.md](docs/scan-plan-boundary.md)。

## 相关说明

- 后端说明见 [backend/README.md](backend/README.md)
- 前端说明见 [tech-chart-vite/README.md](tech-chart-vite/README.md)
- 发布前检查清单见 [docs/release-checklist.md](docs/release-checklist.md)