# QuantDB

**Repository Path**: qusong0627/quant-db

## Basic Information

- **Project Name**: QuantDB
- **Description**: 专为量化回测准备数据库，调用简单，包含2016年1月1日至今所有股票基础数据，共几十个维度，每月更新。
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-01-29
- **Last Updated**: 2026-02-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# QuantDB - 股票量化数据包和简易 DuckDB 管理器

这是一个使用 Python 和 PyQt6 开发的轻量级 DuckDB 数据库管理工具，另包含了中国股市的相关数据2016年1月1日至今，数据库大小约9GB,数据量大约5000万条，具体字段请查阅下方。

因为数据量较大，数据包存放至夸克云盘，需要先下载到本地后导入。
下载连接：https://pan.quark.cn/s/2f9bbad84d17

数据每月更新一次，包含所有上市股票的每日报价、财务指标等。如链接失效请发邮件qusong0627@live.cn联系作者。
## 功能特性

- **打开数据库**: 连接本地 `.duckdb` 文件。
- **表浏览**: 在左侧栏查看数据库中的所有表。
- **快速预览**: 双击表名即可预览前 100 行数据。
- **SQL 编辑器**: 编写并执行自定义 SQL 查询。
- **结果视图**: 以表格形式查看查询结果，支持分页浏览。

## 环境要求

- Python 3.10+
- 依赖库（详见 `requirements.txt`）:
    - `duckdb`
    - `PyQt6`
    - `pandas` (可选)

## 安装步骤

1.  克隆代码仓库。
2.  安装依赖:
    ```bash
    pip install -r requirements.txt
    ```

## 使用方法

运行程序:

```bash
python main.py
```

1.  点击 **文件 -> 打开数据库** 选择你的 DuckDB 文件。
2.  双击左侧的表名以查看数据。
3.  在顶部编辑区输入 SQL 语句并点击 **运行查询**。

## 项目结构

- `main.py`: 程序入口。
- `src/database.py`: 数据库连接与查询逻辑。
- `src/ui/`: UI 组件 (主窗口、数据模型)。

## 数据库结构说明 (`db/stock_new.duckdb`)

本项目包含的数据库文件 `db/stock_new.duckdb` 存储了中国股市的相关数据。以下是各表的详细说明：

### 1. 财务指标
- **`fi_raw`**: 原始财务指标数据。
    - `stock_code`: 股票代码。
    - `pe_ratio_1`, `pe_ratio_2`, `pe_ratio_ttm`: 不同计算方式的市盈率 (PE)。
    - `pb_ratio`, `pb_ratio_parent`: 市净率 (PB)。
- **`relative_value_metrics_filled`**: 经过处理/填充的相对估值指标 (PE, PB 等)。如数据缺失为该公司未按时公告或亏损。

### 2. 股票信息与映射
- **`stock_code_mapping`**: 股票代码映射表 (原始代码到带市场前缀的代码)。
    - `original_code`: 原始代码，如 '300425'。
    - `adjusted_symbol`: 调整后代码，如 'SZ300425'。
- **`trd_co`**: 上市公司基本信息。
    - `stkcd`: 股票代码。
    - `conme`: 公司中文名称。
    - `indnme`: 行业名称。
    - `listdt`: 上市日期。
    - `province`, `city`: 省份与城市。

### 3. 市场行情 (报价)
- **`trd_dalyr`**: 日线交易数据 (未复权)。
    - `opnprc`, `hiprc`, `loprc`, `clsprc`: 开盘价、最高价、最低价、收盘价。
    - `dnshrtrd`: 成交量 (股)。
    - `dnvaltrd`: 成交额 (元)。
- **`trd_bwardquotation`**: 后复权日线行情。
    - 包含复权后的 OHLC 价格、成交量、换手率、总市值、流通市值等。
- **`trd_fwardquotation`**: 前复权日线行情。
- **`stock_price_adjusted_clean`**: 清洗后的复权股价表。
    - `fward_close_price`: 前复权收盘价。
    - `bward_close_price`: 后复权收盘价。
    - `fward_factor`, `bward_factor`: 复权因子。
- **`trd_index`**: 市场指数交易数据。
    - `opnindex`, `hiindex`, `loindex`, `clsindex`: 指数的开高低收点位。

### 4. 复权与公司行为
- **`trd_adjustfactor`**: 股价复权因子表。
- **`trd_capchg`**: 股本变动表 (记录总股本、流通股本的变化)。
- **`trd_cptl`**: 分红配股事件表。
    - `disttyp`: 分配类型 (分红/送股/配股)。
    - `exdistdt`: 除权除息日。
    - `amount`: 分配金额或比例。

### 5. 市场统计与趋势
- **`trd_mkstructd`**: 每日市场板块统计。
    - `listedco_num`: 上市公司数量。
    - `total_shares`: 总股本。
    - `market_value`: 总市值。
    - `avg_pe`: 平均市盈率。
- **`trd_stocktrend`**: 技术趋势分析数据。
    - `continued_rise_days`: 连涨天数。
    - `continued_fall_days`: 连跌天数。
    - `life_high`, `life_low`: 历史最高/最低价