# 股票最终版

**Repository Path**: hai_long_wang/final-version-of-stock

## 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-04-01
- **Last Updated**: 2026-04-16

## 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. 一键启动开发环境

```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/` 用于缓存、日志和桌面版本地运行状态
- `stock_data/postgres-local/data/` 与 `stock_data/postgres-local/logs/` 属于本地 PostgreSQL 运行目录，不应提交到仓库
- 业务数据统一存放在 `DB_URL` 指向的 PostgreSQL
- 本地开发、桌面版 EXE、线上部署都应配置并使用同一套 PostgreSQL
- 源码运行时优先读取 `backend/.env` 或项目根目录 `.env`
- 桌面版 EXE 运行时，可在 EXE 同级目录放置 `.env`，或直接设置系统环境变量 `DB_URL`

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

## 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)