# 资源管理规范

## 1. 适用范围

`resources/raw/` 用于保存项目收到的原始输入，包括但不限于：

- Excel 工作簿
- Markdown 原稿
- 产品原型设计源文件和导出文件
- 其他用于 AIGC 内容生产的输入资料

整理后需要持续维护的需求、设计说明和架构文档应移入 `docs/`，不再作为原始输入管理。

## 2. 日期目录

原始资料按进入项目的北京时间归档：

```text
resources/raw/
└── YYYY/
    └── YYYY-MM-DD/
        ├── source-name.xlsx
        ├── prototype-name.fig
        └── notes.md
```

例如，2026 年 8 月 13 日收到的资料存放在 `resources/raw/2026/2026-08-13/`。

## 3. 文件命名

- 文件名使用英文小写、数字和连字符，不使用空格。
- 文件名应描述内容，不使用 `new`、`final-final` 等不明确后缀。
- 同日收到同名新版本时追加版本号，例如 `product-list-v02.xlsx`。
- 无法重命名的外部交付文件可保留原名，但应在同目录索引中记录说明。

## 4. 原始性与版本

- 原始资料只追加，不覆盖已有文件。
- 需要修改时保留原文件并新增版本；不得直接编辑后冒充原始输入。
- 每个日期目录建议添加 `index.md`，记录来源、接收时间、用途和授权限制。
- 不确定版权或授权范围的资料必须在 `index.md` 标注，不得直接用于对外发布。

建议索引格式：

```markdown
# 资料索引

| 文件 | 来源 | 接收时间 | 用途 | 授权或限制 |
| --- | --- | --- | --- | --- |
| example.xlsx | 产品团队 | 2026-08-13 | 内容生成输入 | 仅限内部使用 |
```

## 5. Git 管理

- 当前原始资料和大型文件均直接提交到 Git。
- 提交前检查文件中是否包含个人信息或其他敏感数据。
- 二进制文件无法有效合并；多人协作修改前应先确认文件负责人。
- 当仓库体积显著影响克隆、拉取或 CI 时，再评估 Git LFS 或对象存储归档。
