docs: 补充数据目录导读

cai

2026-06-03 6b5e6b29251c46d98c8dc57fe2588492dfba87be

docs: 补充数据目录导读

 common/data-doc/目录导读.md

New file
@@ -0,0 +1,32 @@
# 数据体系目录导读

创建人员：Codex  
文件职责：说明 `common/data-doc` 下数据体系公共规范、模板和创建指南的用途，并确保该目录可被 Git 跟踪。  
管理规范/模板：../../全局规范.md；../../体系创建流程.md；../../全局存储体系.md；../../全局数据格式.md。  
引用文件：../../全局存储体系.md；../../全局数据格式.md。  
记录方式：目录导读；新增、删除或调整数据体系公共文档时同步更新。

## 1. 体系定位

数据体系用于管理项目内数据来源、数据格式、数据账本、数据质量检查和数据使用边界。

数据体系不替代实验体系、案例分析体系或开发体系。它负责维护数据口径和数据证据链，其他体系在使用数据时应引用数据体系中的说明、索引和检查结果。

## 2. 当前状态

当前目录暂未放置完整数据体系模板，仅保留本导读文件用于占位和 Git 跟踪。

后续补充数据体系时，建议至少包含：

1. 数据体系规范。
2. 数据环境创建指南。
3. 数据索引或数据清单模板。
4. 数据质量检查记录模板。
5. 数据问题记录模板。

## 3. 使用原则

1. 项目内启用数据体系时，应先明确数据来源、更新频率、字段口径和权限边界。
2. 数据文件、数据索引和数据质量检查结果应可追溯。
3. 临时数据、缓存和生成物不得混入公共模板目录。
4. 数据体系文档与全局数据规范冲突时，以 `全局存储体系.md` 和 `全局数据格式.md` 为准。

 data/目录导读.md

New file
@@ -0,0 +1,26 @@
# data 目录导读

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

## 1. 目录定位

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

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

## 2. 当前状态

当前目录暂不放置具体数据文件，仅保留本导读文件用于占位和 Git 跟踪。

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

## 3. 使用原则

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