# API 测试用例清单

## 新增数据同步接口测试用例

| 测试ID | 测试名称 | 方法 | 路径 | 说明 |
|--------|----------|------|------|------|
| `admin_data_sync_full` | 全量数据同步 | POST | `/v1/admin/data/sync` | 同步基础+行情+财务数据 |
| `admin_data_sync_base` | 同步基础K线数据 | POST | `/v1/admin/data/sync` | 仅同步OHLCV基础数据 |
| `admin_data_sync_quote` | 同步行情指标数据 | POST | `/v1/admin/data/sync` | 同步均线/MACD/涨跌幅 |
| `admin_data_sync_finance` | 同步财务数据 | POST | `/v1/admin/data/sync` | 同步市值/股本/利润 |
| `admin_data_sync_incremental` | 增量数据同步 | POST | `/v1/admin/data/sync/incremental` | 同步最近30天数据 |
| `admin_data_sync_futures` | 期货数据同步 | POST | `/v1/admin/data/sync` | 同步期货数据 |

## 测试用例分类统计

| 分类 | 用例数 |
|------|--------|
| 股票接口 | 4 |
| 期货接口 | 5 |
| 管理接口 | 7 |
| 适配器管理 | 3 |
| **数据同步接口** | **6** |
| 测试管理 | 1 |
| **总计** | **26** |

## 使用方法

### 通过管理后台API测试
```bash
# 1. 获取测试列表
curl "http://localhost:8080/v1/admin/tests/api"

# 2. 执行全量数据同步测试
curl -X POST "http://localhost:8080/v1/admin/tests/api/run" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "admin_data_sync_full",
    "params": {
      "symbols": ["000001.SZ"],
      "sync_type": "full"
    }
  }'

# 3. 执行基础数据同步测试
curl -X POST "http://localhost:8080/v1/admin/tests/api/run" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "admin_data_sync_base"
  }'
```

### 直接调用数据同步接口
```bash
# 全量同步
curl -X POST "http://localhost:8080/v1/admin/data/sync" \
  -H "Content-Type: application/json" \
  -d '{
    "symbols": ["600519.SH", "000001.SZ"],
    "sync_type": "full",
    "start_date": "20240101",
    "end_date": "20240301"
  }'

# 增量同步
curl -X POST "http://localhost:8080/v1/admin/data/sync/incremental" \
  -H "Content-Type: application/json" \
  -d '["600519.SH", "000001.SZ"]'
```

## 对应的适配器方法

| API接口 | 适配器方法 |
|---------|-----------|
| `/admin/data/sync` (base) | `fetch_kline_base` |
| `/admin/data/sync` (quote) | `fetch_kline_quote` |
| `/admin/data/sync` (finance) | `fetch_kline_finance` |
| `/admin/data/sync/incremental` | `sync_daily_incremental` |