Skip to main content
Skip to main content
数据管理模块架构
文档类型
架构文档
相关模块
data manager
相关版本
v0.x
发布日期
2026-02-15

Data Manager 架构文档

模块: modules.data_manager · 版本: 0.2.1


模块介绍

提供 Facade + 领域服务:DataManager 管理单例、库初始化与表注册;领域逻辑在 core/data_services/,经属性链访问(data_mgr.stock.kline.load)。

公开 Facade:DataManager。


分层结构

modules.data_manager/
├── __init__.py              # 仅 DataManager
├── contracts.py             # BaseTableNames
├── core/
│   ├── data_manager.py      # Facade 实现
│   ├── enums.py
│   ├── sample_universe/     # 开发样本股票宇宙
│   ├── dev/sample_stock_list/  # 分层抽样 CSV(进 Git)
│   └── data_services/       # stock / macro / calendar / …
├── docs/
└── __test__/                # 公开 API 契约测
层
职责
Facade
DataManager:initialize、表发现/注册、领域属性
协调
DataService:挂载 stock / macro / calendar / index / db_cache / backup_restore
领域
各 *_service 封装表读写

流程

flowchart TB
  DM[DataManager]
  DB[(DatabaseManager)]
  T[表发现 core/tables + userspace/extensions/tables]
  DS[DataService]
  SS[StockService / MacroService / ...]
  DM --> DB
  DM --> T
  DM --> DS
  DS --> SS