# 数据接入

按模块拆分：Data Source / Data Contract / Tables。

就绪

### Data Source 任务与状态

可手动运行单个 source 或全部 source；配置按 source 弹窗编辑

source | enabled | depends_on | target_table | status | 操作
--- | --- | --- | --- | --- | ---
stock_list | true | latest_trading_date | stock.stock_list | idle |
stock_klines | true | latest_trading_date, stock_list | stock.stock_klines | idle |
macro_gdp | false | latest_trading_date | macro.gdp | disabled |

### 执行预检

先做 dry-run，再执行真实写入。预检展示依赖顺序与影响表。

准备中…

尚未发起执行。

### Data Contract（只读 + 调试）

不支持新增/修改 contract，仅用于查看和调试。

data_key | scope | type | loader | 操作
--- | --- | --- | --- | ---
stock.kline | per_entity | time_series | stock_kline_loader |
stock.list | global | snapshot | stock_list_loader |
macro.gdp | global | time_series | macro_gdp_loader |

### Tables（sys 只读 / custom 可配）

系统表只读；自定义表可创建和删除。建表后当前版本仅支持查看，不支持编辑。
搜索表名

表名 | 主键 | 数据总量 | 操作
--- | --- | --- | ---

### Source 配置（per source）

source key: --

source key handler
目标数据表（只读）
depends_on--
renew.type--
renew_if_over_days--
API / Provider--

### Contract 调试（per contract）

contract: --

data_key entity_id（可选） params(JSON)

    {
      "note": "运行后展示返回结构样例"
    }

### 表信息（只读）

table: --

表名--
主键--
数据总量--
类型--

    {
      "fields": []
    }

当前版本：建表后仅支持查看，不支持编辑。

### 新建 Custom 表

表名（custom_ 开头） 主键（逗号分隔）

### 字段定义

字段名 | 类型 | 删除
--- | --- | ---