项目技术开发档案标准化整理全流程实操方法与步骤

一、整理前必做2项准备

1.1 确认档案核心范围

仅保留开发阶段有效文件，剔除临时测试数据、废弃代码、个人笔记类无效文件。必须包含的文件：需求评审通过版、技术设计说明书、代码仓库链接、编译部署脚本、正式测试报告、上线回滚方案。禁止包含：未评审草稿、单文件测试记录、本地临时配置文件。

1.2 准备基础工具

无需额外下载软件，仅用2个系统自带工具：①Windows资源管理器（Mac用访达）；②Microsoft Excel（WPS表格同理）。

打开Excel新建空白表格，命名为「技术档案索引表.xlsx」，保存到待整理的档案根目录下。

二、档案分类实操步骤

2.1 建立标准化目录结构

在根目录下创建5个一级文件夹，名称必须严格统一，不得修改：

每个一级文件夹下按模块建二级子目录，命名采用「模块编号_模块名称」，例：「3-源代码/01-用户模块」，禁止用中文无规则命名（如「用户功能」）。

2.2 执行统一命名规则

所有文件命名遵循「档案类型_文件名称_版本号.扩展名」，版本号必须为V.X.X格式（例V1.0、V2.1），禁止用1、2.0这类非标准格式。

示例：需求文档命名为「1-需求_用户模块核心功能_V1.0.docx」，技术设计说明书命名为「2-设计_系统架构_V2.1.md」，代码文件保留仓库原始文件名，仅在代码目录添加「代码版本记录.txt」，记录每次提交的版本号与提交人。

三、技术档案索引表填写方法

索引表是快速检索的核心，必须每完成一个文件就填写对应行，不得事后补填，避免遗漏。

3.1 设置固定表头

打开新建的「技术档案索引表.xlsx」，在A1-F1输入固定表头，不得修改：

A1：档案类型；B1：文件名称；C1：版本号；D1：存放路径；E1：更新时间；F1：备注

选中A1-F1，点击Excel工具栏的「居中对齐」，确保表头格式统一。

3.2 按规则填写内容

每一行的填写示例：A2输入「需求文档」，B2输入「用户模块核心功能」，C2输入「V1.0」，D2输入「1-需求文档/1-需求_用户模块核心功能_V1.0.docx」（仅写根目录下的相对路径，无需绝对路径），E2输入当天日期（格式YYYY-MM-DD），F2填写备注（如「评审通过时间：2024-05-20」）。

代码文件的D列填写远程仓库链接，例：「https://github.com/项目组/xxx/tree/feature/pay」，禁止填写本地路径。

四、最终校验与归档操作

4.1 完整性校验

对照索引表逐行核对3项内容：①所有文件是否在对应目录；②版本号是否为V.X.X格式；③部署脚本是否放在「4-部署运维」目录（部署脚本命名格式：「部署_环境_脚本名称_VX.X.sh」/「.bat」，禁止与其他文件混放）。

4.2 归档备份

校验完成后执行2步备份：①本地备份：将整个「项目技术档案」文件夹复制到本地D盘「项目归档」目录；②云备份：上传到企业云盘，共享给项目组所有成员，设置仅查看权限，禁止成员自行修改档案文件。

五、日常维护技巧

开发过程中每周五下午统一整理当周新增文件，严格遵循「整理即录入索引表」原则，避免后期堆积遗漏。每月最后一天更新索引表的「更新时间」列，删除废弃文件的对应记录，并在备注中标记「废弃」。