概念

DataSource

DataSource 把 provider 访问封装在 read、exists 和 describe 后面。适配器位于 bagelquant_data.datasource，并消费 DataRequest，让调用方不依赖 provider 原生客户端 API。

Loader 负责编排请求并返回标准化的 LoadedDataset。如果配置了数据湖，它会优先读取本地快照，只在首次引导或显式刷新时访问 provider。

DataLakeManager 负责本地数据湖的新增、编辑、删除、列表查询，以及手动 provider 更新。

每个 source 的第一个配置表是类 universe 的参考表。对 Tushare 来说是 stock_basic，会同时刷新上市、退市和暂停上市股票，避免幸存者偏差。

Transform 是无状态 DataFrame 操作，可以通过 Transform 进行链式组合。

元数据独立于数据本身。契约用于描述数据集身份、schema、新鲜度、负责人、版本和血缘。

数据湖按 source、table、year 和 month 分层存储。写入会创建不可变快照，并更新 table 和 partition 层面的 latest 指针。

每个存储表包含 date 索引以及 create_time、delete_flag 生命周期列。非 panel 形状的参考表，例如 stock_basic，保留自己的普通行索引，同时也会获得生命周期列。

缓存接口是可选能力，不应改变数据集身份或可复现性保证。