文件命名与目录规范

目标：让老师、项目负责人和团队成员一眼看懂文件属于谁、是什么成果、哪个版本。

更完整的仓库目录建议见 成果目录建议。

1. 统一目录

小组成果仓库使用以下目录：

目录	放什么
文档/	复盘报告、操作手册、数据字典、优化方案、追问清单
代码/	Python 脚本、可复现工程、依赖说明
答辩/	答辩 PPT、演示视频外链、答辩录像外链
简历/	每位成员个人简历
实训报告/	每位成员个人实训报告
其他/	小样本数据、质量检查表、看板导出、截图、素材、外链登记

2. 推荐二级目录

可以在一级目录下按用途建立二级目录：

文档/
├── 过程记录/
├── 每日进度记录/
├── 指标字典/
├── 报告草稿/
└── 追问应答/

其他/
├── 外链登记/
├── 数据质量检查/
└── 看板截图/

答辩/
├── PPT/
└── 演示视频外链/

如果老师给了固定模板，优先保留模板一级目录，不随意新增一级目录。

3. 组级文件命名

格式：

LZ-组号_成果名_v版本.扩展名

示例：

LZ-组1_用户行为复盘报告_v1.docx
LZ-组1_优化方案_v1.docx
LZ-组1_综合演示看板_v1.html
LZ-组1_数据质量检查表_v1.xlsx

组级公共文件默认由组长整合，成员不要多人同时修改。

4. 个人文件命名

格式：

LZ-组号_姓名_成果名_v版本.扩展名

示例：

LZ-组1_张三_简历_v1.pdf
LZ-组1_李四_实训报告_v1.docx
LZ-组1_王五_清洗过程说明_v1.md

每位成员至少应有：

• 个人过程记录。
• 个人外链登记。
• 个人实训报告。
• 个人简历。

5. 版本号规则

• 初版使用 v1。
• 修改后使用 v2、v3。
• 不要使用 最终版、最新版、改完了。

错误示例：

最终版.docx
报告最新版(1).docx
张三的文件.xlsx

正确示例：

LZ-组1_用户行为复盘报告_v3.docx
LZ-组1_张三_实训报告_v2.docx

6. 外链登记文件命名

每个人维护自己的外链登记文件，减少冲突。

示例：

其他/外链登记/LZ-组1_张三_外链登记.md
答辩/外链登记/LZ-组1_李四_答辩外链登记.md

后期再统一整合总表。

7. 公共文件修改规则

公共文件包括：

• 项目总说明。
• 用户行为复盘报告。
• 运营优化方案。
• 操作手册。
• 答辩 PPT。
• 外链登记总表。

规则：

• 默认由组长修改。
• 队员要补充内容时，先写到自己的过程记录或发给组长。
• 如果确实要直接改公共文件，必须在群里说明修改范围。
• 不要多人同时改同一份公共文件。