# Chinese Equity Quant Research Framework

A modular Chinese A-share quant research framework built on
[backtrader](https://www.backtrader.com/) for backtesting, with
akshare (primary) and baostock (fallback) for daily bar data.

## Install

```bash
pip install -r requirements.txt
```

## Quick start

```bash
python3 run_example.py        # end-to-end smoke test (SMA crossover on 浦发银行)
python3 -m pytest tests/ -v   # run tests
```

## Layout

- `data/` — unified downloader (akshare -> baostock fallback) and data schema
- `backtest/` — config, pandas->backtrader feed adapter, and `BacktestRunner`
- `strategies/` — example `SmaCross` strategy
- `analysis/` — performance reporting (sharpe, drawdown, returns, trades)