# data 目录导读

创建人员：Codex  
文件职责：说明 `data` 目录的定位，并确保该目录可被 Git 跟踪。  
管理规范/模板：../全局规范.md；../全局存储体系.md；../全局数据格式.md。  
引用文件：../全局存储体系.md；../全局数据格式.md。  
记录方式：目录导读；新增、删除或调整全局数据材料时同步更新。

## 1. 目录定位

本目录用于保存管理系统级别的全局统一数据源、数据索引材料或跨项目可复用的数据说明。

具体项目产生的数据不应直接写入本目录，应优先放入项目自己的数据目录，并在需要时通过索引或清单引用。

## 2. 当前状态

当前目录保存全局数据源说明、数据库索引说明、导入脚本说明和可跨项目复用的数据入口说明。

后续新增全局数据材料时，应先确认其是否满足跨项目复用、统一口径和长期维护要求。

当前已登记材料：

| 文件 | 用途 |
|---|---|
| `数据库索引数据.local.md` | 本机 MySQL 连接和历史索引说明；包含本机敏感信息，不提交远程 |
| `HTTP与MySQL使用说明.md` | 外部前复权 K 线服务 HTTP/MySQL 使用说明 |
| `K线同步到本地数据库全景说明.md` | 前复权 K 线同步到本地数据库的全景说明 |
| `全复权分钟线导入说明.md` | 2026-06-14 新增全复权 1 分钟 K 线入库说明 |

## 3. 使用原则

1. 不存放临时文件、缓存文件或单项目私有数据。
2. 不存放未说明来源、字段口径和更新时间的数据。
3. 新增数据材料时，应同步补充数据来源、字段说明、维护人和使用边界。
4. 与 `全局存储体系.md`、`全局数据格式.md` 冲突时，以全局规范文件为准。