正式仓库目录与过程记录规范

本规范可以直接发给组员。目标是让大家知道文件放哪里、过程怎么记录、哪些内容后期可以放到门户公开展示。

1. 总原则

仓库是最终提交和过程留痕的准来源。
群聊只用于沟通，不作为正式保存位置。
大文件不直接放仓库，使用外链登记。
每位成员必须用自己的账号提交自己负责的文件。
公共文件由组长整合，队员先把材料写到自己的过程记录。

2. 推荐目录结构

正式仓库建议使用：

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

代码/
├── 清洗/
├── 指标计算/
├── 推荐/
└── 可视化/

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

简历/

实训报告/

其他/
├── 外链登记/
├── 数据质量检查/
├── 过程截图/
├── 看板截图/
└── 临时素材/

如果老师给的模板已有一级目录，优先使用模板一级目录，只在里面增加二级目录。

3. 组长初始化目录命令

组长克隆正式仓库后，可以在仓库根目录执行以下 PowerShell 命令创建目录：

New-Item -ItemType Directory -Force `
  文档/需求文档, `
  文档/操作手册, `
  文档/过程记录, `
  文档/每日进度记录, `
  文档/指标字典, `
  文档/报告草稿, `
  文档/追问应答, `
  代码/清洗, `
  代码/指标计算, `
  代码/推荐, `
  代码/可视化, `
  答辩/PPT, `
  答辩/演示视频外链, `
  答辩/答辩素材, `
  简历, `
  实训报告, `
  其他/外链登记, `
  其他/数据质量检查, `
  其他/过程截图, `
  其他/看板截图, `
  其他/临时素材

4. 必须准备的文档

文档	建议位置	负责人	说明
需求文档	`文档/需求文档/`	组长主责，全员补材料	写清项目解决什么问题、需求、流程和设计
操作手册	`文档/操作手册/`	组长 + 看板负责人	让别人照着步骤能查看或复现成果
个人过程记录	`文档/过程记录/`	每位成员	记录每天任务、操作、问题、解决方法
每日进度记录	`文档/每日进度记录/`	组长	记录当天提交、问题、风险和次日安排
指标字典	`文档/指标字典/`	指标负责人	统一 UV、PV、转化率、复购率、动销率等口径
外链登记	`其他/外链登记/`	每位成员	登记大文件、视频、数据、看板等链接
答辩 PPT	`答辩/PPT/`	组长	10 页内，按答辩主线组织
演示视频外链	`答辩/演示视频外链/`	看板负责人	不直接提交大视频，登记链接
个人实训报告	`实训报告/`	每位成员	体现个人任务、操作过程、问题和收获

5. 个人过程记录写法

每位成员建议建立：

文档/过程记录/LZ-组6_姓名_个人过程记录_v1.md

每次记录按以下格式：

## 2026-07-14 阶段记录

### 今日任务

- 

### 操作过程

- 

### 产出文件

- 

### 遇到的问题

- 

### 解决方法

- 

### 截图或外链

- 

### 今日收获

-

遇到问题时不要只写“已解决”，要写清楚怎么解决，以及自己理解了什么。

6. 截图保存规则

截图建议放在：

其他/过程截图/
其他/看板截图/

截图命名：

LZ-组6_姓名_任务名_日期_v1.png

示例：

LZ-组6_张三_数据质量检查_2026-07-14_v1.png
LZ-组6_李四_指标透视表_2026-07-14_v1.png
LZ-组6_王五_看板截图_2026-07-14_v1.png

截图要在个人过程记录中说明用途，不能只把图片丢进目录。

7. 需求文档建议结构

# LZ-组6_需求文档_v1

## 1. 项目概述

## 2. 背景与实际意义

## 3. 业务问题

## 4. 数据需求

## 5. 功能性需求

## 6. 非功能性需求

## 7. 业务流程

## 8. 总体设计

## 9. 技术选型

## 10. 交付物清单

重点写清楚：本项目用淘宝用户行为数据解决哪些实际业务问题。

8. 操作手册建议结构

# LZ-组6_操作手册_v1

## 1. 项目目录说明

## 2. 环境和工具

## 3. 数据文件和外链

## 4. 如何查看清洗结果

## 5. 如何查看指标表

## 6. 如何查看可视化看板

## 7. 如何查看推荐结果

## 8. 如何查看复盘报告

## 9. 常见问题

操作手册的目标是让没参与项目的人照着步骤也能查看成果。

9. 门户公开展示建议

适合放到门户或文档站点公开展示：

项目任务剖析。
需求文档。
操作手册。
每日进度记录。
指标字典。
看板设计说明。
外链登记总表。
答辩资料说明。

不建议公开展示：

账号密码。
未经确认的个人隐私信息。
可能失效的临时下载链接。
没有说明来源的大文件。

10. 每天最低提交要求

每位成员每天至少提交一种有效材料：

更新个人过程记录。
提交自己负责的说明文档。
登记外链。
上传过程截图说明。
更新个人实训报告材料。

提交前看提交检查清单。