edit | blame | history | raw

全局数据格式

创建人员：Codex
文件职责：记录全局公共表和公共文件型数据的字段级 schema。
书写管理规范：参考 管理系统说明.md、全局规范.md。
引用文件：全局存储体系.md、<s_system_doc_root>/observer/天下模型沉淀/数据库索引数据.md、<s_system_doc_root>/observer/model/data/stock-data/scripts/integrate_stock_data_to_total_data.py。
记录方式：schema 账本文档；公共表新增或字段新增时同步更新；变更记录追加在文末。

1. 统一字段约定

字段	统一含义
`symbol`	股票代码，统一形如 `600000.SH`、`000001.SZ`、`920000.BJ`
`trade_date`	交易日，`date`
`trade_time`	日内分钟时间，`time`
`calendar_date`	自然日，`date`
`snapshot_date`	快照日期，`date`
`open_price` / `high_price` / `low_price` / `close_price`	开高低收价格
`volume`	成交量
`amount`	成交额
`run_id`	构建或实验运行 ID
`created_at` / `updated_at`	记录创建 / 更新时间

2. A 股行情事实表

`a_share_daily_price`

默认 A 股前复权日线 K 线主表。

字段	类型	约束	含义
`trade_date`	`date`	PK	交易日
`symbol`	`char(9)`	PK	股票代码
`open_price`	`decimal(12,4)`	not null	开盘价
`high_price`	`decimal(12,4)`	not null	最高价
`low_price`	`decimal(12,4)`	not null	最低价
`close_price`	`decimal(12,4)`	not null	收盘价
`volume`	`bigint`	nullable	成交量
`amount`	`decimal(20,2)`	nullable	成交额

`a_share_minute_price`

默认 A 股分钟 K 线主表。

字段	类型	约束	含义
`trade_date`	`date`	PK	交易日
`trade_time`	`time`	PK	分钟时间
`symbol`	`char(9)`	PK	股票代码
`open_price`	`decimal(12,4)`	not null	该分钟开盘价
`high_price`	`decimal(12,4)`	not null	该分钟最高价
`low_price`	`decimal(12,4)`	not null	该分钟最低价
`close_price`	`decimal(12,4)`	not null	该分钟收盘价
`volume`	`bigint`	nullable	该分钟成交量
`amount`	`decimal(20,2)`	nullable	该分钟成交额
`open_interest`	`bigint`	nullable	持仓量；部分源为空

`a_share_daily_front_adj_missing_ohlc_20230101_20260508`

前复权源包中停牌 / 无 OHLC 行审计表。

字段	类型	约束	含义
`trade_date`	`date`	PK	交易日
`symbol`	`char(9)`	PK	股票代码
`volume`	`bigint`	nullable	源成交量
`amount`	`decimal(20,2)`	nullable	源成交额
`pre_close`	`decimal(12,4)`	nullable	前收价
`suspend_flag`	`varchar(8)`	not null	停牌 / 无价标记

`a_share_daily_price_backup_before_front_adj_20260523_1808`

前复权切换前旧日线备份。字段与 a_share_daily_price 相同。

`a_share_daily_price_front_sync`

前复权日线同步影子表。

字段	类型	约束	含义
`trade_date`	`date`	PK	交易日
`symbol`	`char(9)`	PK	股票代码
`open_price`	`decimal(12,4)`	nullable	开盘价
`high_price`	`decimal(12,4)`	nullable	最高价
`low_price`	`decimal(12,4)`	nullable	最低价
`close_price`	`decimal(12,4)`	nullable	收盘价
`pre_close_price`	`decimal(12,4)`	nullable	前收价
`volume`	`bigint unsigned`	nullable	成交量
`amount`	`decimal(20,2)`	nullable	成交额
`turnover`	`double`	nullable	换手 / 源口径 turnover
`source_batch_id`	`varchar(64)`	nullable	源批次
`source_table`	`varchar(64)`	not null	源表名，默认 `cn_stock_kline_1d_front`
`source_updated_at`	`datetime`	nullable	源更新时间
`sync_run_id`	`varchar(96)`	indexed	同步运行 ID
`synced_at`	`timestamp`	auto update	同步写入时间

`a_share_minute_price_front_sync`

前复权分钟线同步影子表。

字段	类型	约束	含义
`trade_date`	`date`	PK	交易日
`trade_time`	`time`	PK	分钟时间
`bar_time`	`datetime`	indexed	完整 bar 时间
`symbol`	`char(9)`	PK	股票代码
`open_price`	`decimal(12,4)`	nullable	开盘价
`high_price`	`decimal(12,4)`	nullable	最高价
`low_price`	`decimal(12,4)`	nullable	最低价
`close_price`	`decimal(12,4)`	nullable	收盘价
`volume`	`bigint unsigned`	nullable	成交量
`amount`	`decimal(20,2)`	nullable	成交额
`turnover`	`double`	nullable	换手 / 源口径 turnover
`source_batch_id`	`varchar(64)`	nullable	源批次
`source_table`	`varchar(64)`	not null	源表名，默认 `cn_stock_kline_1m_front`
`source_updated_at`	`datetime`	nullable	源更新时间
`sync_run_id`	`varchar(96)`	indexed	同步运行 ID
`synced_at`	`timestamp`	auto update	同步写入时间

`a_share_kline_front_sync_run`

K 线同步运行记录。

字段	类型	约束	含义
`run_id`	`varchar(96)`	PK	同步运行 ID
`started_at`	`datetime`	indexed	开始时间
`finished_at`	`datetime`	nullable	结束时间
`status`	`varchar(64)`	indexed	运行状态
`periods`	`varchar(64)`	not null	同步周期范围
`start_date`	`date`	nullable	请求开始日期
`end_date`	`date`	nullable	请求结束日期
`symbols_scope`	`text`	nullable	股票范围
`source_host`	`varchar(255)`	not null	源主机
`source_database`	`varchar(128)`	not null	源数据库
`local_database`	`varchar(128)`	not null	本地数据库
`daily_rows_source`	`bigint`	not null	源日线行数
`daily_rows_loaded`	`bigint`	not null	落库日线行数
`minute_rows_source`	`bigint`	not null	源分钟行数
`minute_rows_loaded`	`bigint`	not null	落库分钟行数
`summary_json`	`json`	nullable	运行摘要
`error_message`	`text`	nullable	错误信息

3. A 股基础维表和元数据表

`a_share_trading_calendar`

字段	类型	约束	含义
`calendar_date`	`date`	PK	自然日
`is_trading_day`	`tinyint`	not null	是否交易日
`trade_date_rank`	`int`	nullable	交易日序号
`weekday`	`tinyint`	not null	星期
`is_weekend`	`tinyint`	not null	是否周末
`market_scope`	`varchar(32)`	not null	市场范围
`source`	`varchar(128)`	not null	来源

`a_share_profile_snapshot`

字段	类型	约束	含义
`snapshot_date`	`date`	PK	快照日期
`symbol`	`char(9)`	PK	股票代码
`stock_name`	`varchar(64)`	not null	股票名称
`industry_l1`	`varchar(64)`	nullable	一级行业
`industry_l2`	`varchar(64)`	nullable	二级行业
`concepts_raw`	`text`	nullable	概念原文
`main_business_raw`	`text`	nullable	主营业务原文
`industry_source`	`varchar(64)`	nullable	行业来源
`concept_source_url`	`varchar(255)`	nullable	概念来源 URL
`main_business_source_url`	`varchar(255)`	nullable	主营来源 URL
`status`	`varchar(16)`	not null	采集状态
`error_reason`	`text`	nullable	错误原因

`a_share_true_capital_turnover`

字段	类型	约束	含义
`trade_date`	`date`	PK	交易日
`symbol`	`char(9)`	PK	股票代码
`total_shares`	`bigint`	nullable	总股本
`float_shares`	`bigint`	nullable	流通股本
`turnover_rate_pct`	`decimal(12,6)`	nullable	换手率百分比

`a_share_true_market_value`

字段	类型	约束	含义
`trade_date`	`date`	PK	交易日
`symbol`	`char(9)`	PK	股票代码
`total_market_cap`	`decimal(24,6)`	nullable	总市值
`float_market_cap`	`decimal(24,6)`	nullable	流通市值

`stock_source_artifact`

字段	类型	约束	含义
`artifact_path`	`varchar(512)`	PK	原始工件路径
`artifact_name`	`varchar(255)`	not null	文件名
`artifact_type`	`varchar(16)`	not null	文件类型
`size_bytes`	`bigint`	not null	文件大小
`modified_at`	`datetime`	not null	文件修改时间

`stock_dataset_manifest`

字段	类型	约束	含义
`manifest_path`	`varchar(512)`	PK	manifest 路径
`domain_name`	`varchar(64)`	not null	数据域
`batch_tag`	`varchar(64)`	nullable	批次标签
`manifest_json`	`longtext`	not null	manifest JSON
`modified_at`	`datetime`	not null	修改时间

`stock_import_chunk_log`

字段	类型	约束	含义
`id`	`bigint`	PK auto_increment	日志 ID
`table_name`	`varchar(64)`	indexed	目标表
`source_group`	`varchar(64)`	not null	源分组
`chunk_file`	`varchar(512)`	not null	chunk 文件
`row_count`	`bigint`	not null	chunk 行数
`loaded_at`	`datetime`	not null	导入时间
`duration_ms`	`bigint`	not null	导入耗时

4. 市场广度缓存表

`ts_market_breadth_daily_cache`

字段	类型	约束	含义
`trade_date`	`date`	PK	交易日
`scope_type`	`varchar(32)`	PK	范围类型
`scope_value`	`varchar(128)`	PK	范围值
`industry_snapshot_date`	`date`	nullable	行业快照日
`benchmark_type`	`varchar(32)`	not null	对比基准
`stock_count`	`int`	not null	股票数
`up_count`	`int`	not null	上涨数
`flat_count`	`int`	not null	平盘数
`down_count`	`int`	not null	下跌数
`zero_prev_close_count`	`int`	not null	前收为零 / 不可算数量
`positive_share`	`decimal(12,8)`	nullable	上涨占比
`avg_ret_from_prev_close_pct`	`decimal(18,8)`	nullable	等权涨跌幅
`price_source_table`	`varchar(64)`	not null	价格源表
`profile_source_table`	`varchar(64)`	nullable	画像源表
`profile_snapshot_pit_safe_flag`	`tinyint`	not null	画像是否 PIT-safe
`run_id`	`varchar(128)`	not null	构建运行 ID
`updated_at`	`timestamp`	auto update	更新时间

`ts_market_breadth_intraday_cache`

字段同 ts_market_breadth_daily_cache，额外包含：

字段	类型	约束	含义
`trade_time`	`time`	PK	分钟时间

`ts_market_breadth_intraday_daily_peak_cache`

字段	类型	约束	含义
`trade_date`	`date`	PK	交易日
`scope_type`	`varchar(32)`	PK	范围类型
`scope_value`	`varchar(128)`	PK	范围值
`max_up_count`	`int`	not null	日内最大上涨家数
`max_up_time`	`time`	not null	最大上涨家数时间
`first_up_count_ge_3000_time`	`time`	nullable	首次达到 3000 家上涨时间
`has_up_count_ge_3000_flag`	`tinyint`	not null	是否达到 3000 家
`max_positive_share`	`decimal(12,8)`	nullable	最大上涨占比
`max_avg_ret_from_prev_close_pct`	`decimal(18,8)`	nullable	最大等权涨幅
`minute_row_count`	`int`	not null	分钟行数
`source_table`	`varchar(64)`	not null	来源表
`run_id`	`varchar(128)`	not null	运行 ID
`updated_at`	`timestamp`	auto update	更新时间

`ts_market_breadth_cache_run`

字段	类型	约束	含义
`run_id`	`varchar(128)`	PK	运行 ID
`run_started_at`	`datetime`	not null	开始时间
`run_finished_at`	`datetime`	nullable	结束时间
`cache_level`	`varchar(32)`	PK	缓存层级
`start_date`	`date`	nullable	开始日期
`end_date`	`date`	nullable	结束日期
`requested_date_count`	`int`	not null	请求日期数
`processed_date_count`	`int`	not null	处理日期数
`daily_cache_rows`	`int`	not null	日级缓存行数
`intraday_cache_rows`	`int`	not null	分时缓存行数
`source_price_table`	`varchar(64)`	not null	价格源表
`source_profile_table`	`varchar(64)`	not null	画像源表
`profile_snapshot_pit_safe_flag`	`tinyint`	not null	画像是否 PIT-safe
`run_status`	`varchar(64)`	not null	运行状态
`run_note`	`text`	nullable	备注

5. 案例研究归档表

`ts_case_study_casepack`

字段	类型	约束	含义
`casepack_id`	`varchar(64)`	PK	案例包 ID
`run_id`	`varchar(128)`	indexed	运行 ID
`research_scope`	`varchar(128)`	not null	研究范围
`research_object`	`varchar(512)`	not null	研究对象
`source_note_items_json`	`json`	nullable	来源笔记条目
`result_path`	`varchar(1024)`	not null	结果目录
`script_path`	`varchar(1024)`	nullable	脚本路径
`source_panel_path`	`varchar(1024)`	nullable	来源面板
`source_panel_sha256`	`char(64)`	nullable	来源面板 hash
`price_source`	`varchar(512)`	nullable	价格源
`case_count`	`int`	not null	案例数
`readout`	`varchar(256)`	not null	读出状态
`engineering_allowed_flag`	`tinyint`	not null	是否允许工程化
`created_at` / `updated_at`	`datetime`	not null	创建 / 更新时间

`ts_case_study_case_header`

字段：case_id PK、casepack_id、run_id、case_family、research_scope、research_object、symbol、signal_trade_date、entry_trade_date、window_start_date、window_end_date、case_type、case_boundary_subtype、selector_set_key、note_item_ids_json、source_result_path、source_case_table_path、source_window_path、primary_chart_path、primary_chart_sha256、price_source、case_status、engineering_allowed_flag、created_at、updated_at。

`ts_case_study_kline_window`

字段：case_id PK、symbol、trade_date PK、relative_day_to_signal、relative_day_to_entry、open_price、high_price、low_price、close_price、volume、amount、is_signal_flag、is_entry_flag、created_at。

`ts_case_study_anchor`

字段：anchor_id PK、case_id、anchor_type、anchor_date、relative_day_to_signal、relative_day_to_entry、open_price、high_price、low_price、close_price、anchor_metric_json、anchor_reason、source_rule_id、review_status、created_at。

`ts_case_study_asset`

字段：asset_id PK、casepack_id、case_id、asset_type、file_path、file_sha256、file_size、is_primary_chart、created_at。

`ts_case_study_judgment`

字段：case_id PK、judgment_version PK、judge_type、support_original_note_decision、ai_chart_review_bucket、visual_story、visual_position_reading、pre_signal_context_reading、hidden_condition_tags_json、rule_implication、manual_review_focus、confidence_level、human_review_status、created_at。

`ts_case_study_tag`

字段：case_id PK、tag_type PK、tag_value PK、tag_source PK、tag_weight、created_at。

6. 无忌 baseline 研究账本表

这些表只表示研究账本，不表示可投产交易系统。

表	字段摘要
`ts_baseline_run`	`baseline_run_id` PK、版本、研究范围、买卖策略文本、case 数、收益、胜率、最大亏损、readout、`engineering_allowed_flag`、时间戳
`ts_baseline_case_decision`	`baseline_case_id` PK、`baseline_variant_id` PK、案例、代码、决策时点、市场门槛、候选池命中、位置阶段、动作决策、未来函数标记、状态、时间戳
`ts_baseline_entry_exit_event`	`baseline_event_id` PK、案例、variant、事件序号、事件类型、交易日、时间、价格、仓位、原因、as-of 证据、分时快照路径
`ts_baseline_trade_lot`	`trade_lot_id` PK、入场 / 出场事件、代码、买卖日期时间价格、持有天数、仓位、收益、最大有利 / 不利浮动、退出类型
`ts_baseline_case_outcome`	案例 + variant 复合主键、结果状态、收益、胜负、回撤、最佳收益、失败 / 成功原因、未来结果摘要、复核标记
`ts_baseline_audit_check`	run + case + check 复合主键、期望值、实际值、是否通过、严重度、备注、创建时间

7. 无忌研究产物归档表

`ts_wuji_portfolio_archive_manifest`

字段：run_id PK、artifact_name PK、csv_path、row_count、file_sha256、created_at。

`ts_wuji_portfolio_archive_row`

字段：run_id PK、artifact_name PK、row_key PK、row_hash、row_json、created_at。

8. 公共信息缓存表

`news_body_cache`

字段：_row_id PK、url、fetch_status、status_code、content_type、body_text、body_length、body_hash、fetched_at、error、_dataset_version、_source_file、_imported_at。

`quality_summary`

字段：_row_id PK、file_name、status、row_count、date_min、date_max、required_fields、missing_fields、null_required、quality_note、meta、_dataset_version、_source_file、_imported_at。

9. 文件镜像 CSV 格式

STOCK_TOTAL_DATA_FILE_MIRROR 中的文件型行情使用以下源字段。

日线 CSV

字段	含义
`timetag`	日期或时间标签
`open`	开盘价
`high`	最高价
`low`	最低价
`close`	收盘价
`volumn`	成交量；源字段拼写保留为 `volumn`
`amount`	成交额

分钟 CSV

字段	含义
`timetag`	分钟时间标签
`open`	开盘价
`high`	最高价
`low`	最低价
`close`	收盘价
`volumn`	成交量；源字段拼写保留为 `volumn`
`amount`	成交额
`open_ineterst`	持仓量；源字段拼写保留为 `open_ineterst`

10. 未冻结字段合同的表组

本机 MySQL 还存在以下表组，已扫描但未在本文冻结字段合同：

表组	原因
`style_*`	既包含外部指标，也包含风格 / 风源专题研究表；需要单独拆分后再升格
`research_style_ju_*`	风格局 / 局实体研究表，非全局公共事实表
`darkline` / `dlroot` / `dltest*`	暗线专题研究表，非通用行情 / 市场指标事实表

如果后续要把其中某些外部指标表升格为全局公共表，必须先补字段级 schema、主键、用途、来源、PIT 边界和使用规范。

11. 变更记录

2026-06-03：首次建立全局数据格式文档；根据本机 MySQL information_schema、数据库索引文档和 stock-data 脚本整理公共表字段。