科技部门档案制度建设全流程技术实操指南

一、构建标准化的档案目录结构配置

档案制度建设的核心在于标准化。为了避免人工创建文件夹时出现命名混乱，我们首先定义一个JSON配置文件。这个文件将作为所有技术项目档案的“宪法”，强制规定必须包含哪些目录和文件。

1.1 定义目录规范JSON

请在本地创建一个名为 archive_standard.json 的文件，并将以下内容完整复制进去。该配置定义了科技项目从立项到验收的全生命周期目录结构。

```json { "project_root": "PROJECT_NAME", "structure": { "01-立项阶段": { "required_files": ["立项申请书.docx", "可行性研究报告.pdf"], "description": "项目启动初期审批文档" }, "02-需求与设计": { "required_files": ["需求规格说明书.md", "系统架构图.png", "数据库设计文档.ppt"], "description": "技术方案与设计文档" }, "03-开发过程": { "subdirs": ["源代码", "API接口文档", "单元测试报告"], "description": "编码与过程记录" }, "04-测试与验收": { "required_files": ["测试计划.xlsx", "测试报告.pdf", "用户验收签字.pdf"], "description": "质量保证与交付凭证" }, "05-运维与部署": { "required_files": ["部署手册.md", "运维操作规范.docx"], "description": "上线后的维护指南" } } } ```

二、开发自动化归档检查与生成工具

有了标准，下一步是开发一个Python脚本来自动执行这个标准。这个工具将具备两个核心功能：一键初始化项目目录 和 档案合规性检查。

2.1 环境依赖安装

本脚本依赖Python 3.6+环境，无需安装第三方复杂库，仅使用标准库即可运行，确保零门槛。在终端执行以下命令确认Python环境：

```bash python3 --version ```

2.2 核心功能代码实现

新建文件 archive_manager.py，完整复制以下代码。该脚本包含了目录树生成、文件存在性检查以及彩色日志输出功能。

```python import os import json import sys import argparse class Color: GREEN = '\033[92m' RED = '\033[91m' YELLOW = '\033[93m' RESET = '\033[0m' def load_config(config_path): if not os.path.exists(config_path): print(f"{Color.RED}错误：配置文件 {config_path} 不存在！{Color.RESET}") sys.exit(1) with open(config_path, 'r', encoding='utf-8') as f: return json.load(f) def create_structure(config, project_name): base_path = os.path.abspath(project_name) if os.path.exists(base_path): print(f"{Color.YELLOW}警告：目录 {project_name} 已存在。{Color.RESET}") return os.makedirs(base_path) print(f"{Color.GREEN}正在创建项目档案目录：{project_name}{Color.RESET}") structure = config.get("structure", {}) for folder_name, content in structure.items(): folder_path = os.path.join(base_path, folder_name) os.makedirs(folder_path) 创建占位文件 if "required_files" in content: for file_name in content["required_files"]: file_path = os.path.join(folder_path, file_name) with open(file_path, 'w', encoding='utf-8') as f: f.write(f" {file_name} - 待补充内容\n") 创建子目录 if "subdirs" in content: for sub in content["subdirs"]: os.makedirs(os.path.join(folder_path, sub)) print(f"{Color.GREEN}档案结构初始化完成，路径：{base_path}{Color.RESET}") def check_compliance(config, project_path): if not os.path.exists(project_path): print(f"{Color.RED}错误：项目路径 {project_path} 不存在！{Color.RESET}") return print(f"{Color.YELLOW}开始检查项目合规性：{project_path}{Color.RESET}") structure = config.get("structure", {}) total_checks = 0 passed_checks = 0 for folder_name, content in structure.items(): folder_path = os.path.join(project_path, folder_name) if not os.path.exists(folder_path): print(f"{Color.RED}[缺失] 核心目录：{folder_name}{Color.RESET}") continue if "required_files" in content: for file_name in content["required_files"]: total_checks += 1 file_path = os.path.join(folder_path, file_name) if os.path.exists(file_path): print(f"{Color.GREEN}[通过] {folder_name}/{file_name}{Color.RESET}") passed_checks += 1 else: print(f"{Color.RED}[失败] {folder_name}/{file_name} - 文件未找到{Color.RESET}") print(f"\n{Color.YELLOW}检查结果：{passed_checks}/{total_checks} 项通过{Color.RESET}") if passed_checks == total_checks: print(f"{Color.GREEN}恭喜！该项目档案完全符合制度规范。{Color.RESET}") else: print(f"{Color.RED}请注意补充缺失的文件，以免影响归档验收。{Color.RESET}") def main(): parser = argparse.ArgumentParser(description="科技部门档案制度建设工具") parser.add_argument('action', choices=['init', 'check'], help="执行操作：init(初始化) 或 check(检查)") parser.add_argument('target', help="目标项目名称或路径") parser.add_argument('--config', default='archive_standard.json', help="配置文件路径，默认为当前目录下的archive_standard.json") args = parser.parse_args() config = load_config(args.config) if args.action == 'init': create_structure(config, args.target) elif args.action == 'check': check_compliance(config, args.target) if __name__ == "__main__": main() ```

三、实操演练：初始化与检查项目档案

代码编写完成后，我们通过具体的命令行操作来演示如何落地这套制度。假设我们要新建一个名为“2023-数据中心迁移”的项目。

3.1 初始化新项目档案

打开终端，切换到存放 archive_manager.py 和 archive_standard.json 的目录，执行以下命令：

```bash python3 archive_manager.py init "2023-数据中心迁移" ```

执行后，脚本会自动在当前目录下创建一个名为“2023-数据中心迁移”的文件夹。进入该文件夹，你将看到严格按照第一章JSON配置生成的目录树，所有必填文件都已创建为空文件（占位符），提示开发人员需要补充哪些内容。

3.2 执行合规性检查

在项目开发过程中，管理员或CI/CD流水线可以随时运行检查命令，确保档案没有缺失。假设我们已经补充了部分文档，现在运行检查：

```bash python3 archive_manager.py check "2023-数据中心迁移" ```

系统会逐项扫描 01-立项阶段 到 05-运维与部署 下的所有必填文件。控制台会输出绿色的“[通过]”或红色的“[失败]”信息，并给出最终的统计报告。这比人工翻看文件夹要高效且准确得多。

四、集成Git版本控制管理

技术档案必须具备版本追溯能力。我们将生成的档案目录纳入Git管理，并配置忽略规则，避免将临时文件提交。

4.1 初始化Git仓库

进入项目目录，初始化Git仓库：

```bash cd "2023-数据中心迁移" git init ```

4.2 配置.gitignore规则

在项目根目录下创建 .gitignore 文件，过滤掉非文档类的临时文件。请直接复制以下内容：

```text Python __pycache__/ .py[cod] $py.class .so Office 临时文件 ~$ .DS_Store Thumbs.db IDE .idea/ .vscode/ .swp ```

4.3 提交初始档案结构

将标准化的目录结构提交到版本库，作为档案的基线版本：

```bash git add . git commit -m "feat: 初始化科技项目档案标准目录结构" ```

五、生成可视化档案清单报告

为了方便非技术人员（如行政或审计人员）查看档案情况，我们扩展Python脚本，增加一个生成HTML报告的功能。这能让档案制度“看得见”。

5.1 增加HTML生成逻辑

在 archive_manager.py 中追加以下函数，用于生成静态HTML报告：

```python def generate_html_report(config, project_path): structure = config.get("structure", {}) report_lines = [] report_lines.append("") report_lines.append("") report_lines.append(f"项目档案合规性报告：{os.path.basename(project_path)}") report_lines.append("") for folder_name, content in structure.items(): folder_path = os.path.join(project_path, folder_name) if "required_files" in content: for file_name in content["required_files"]: file_path = os.path.join(folder_path, file_name) status = "√ 存在" if os.path.exists(file_path) else "× 缺失" report_lines.append(f"") report_lines.append("

目录	必填文件	状态
{folder_name}	{file_name}	{status}

") output_file = "archive_report.html" with open(output_file, 'w', encoding='utf-8') as f: f.writelines(report_lines) print(f"{Color.GREEN}HTML报告已生成：{os.path.abspath(output_file)}{Color.RESET}") ```

5.2 修改主函数支持报告生成

修改 main 函数中的 argparse 部分及后续逻辑，增加 report 动作：

```python 修改 parser.add_argument 行，增加 'report' parser.add_argument('action', choices=['init', 'check', 'report'], help="执行操作：init(初始化), check(检查) 或 report(生成报告)") ... 前面的代码保持不变 ... elif args.action == 'report': generate_html_report(config, args.target) ```

5.3 生成并查看报告

重新运行脚本，生成HTML格式的可视化报告：

```bash python3 archive_manager.py report "2023-数据中心迁移" ```

执行后，当前目录下会生成 archive_report.html。直接用浏览器打开该文件，你将看到一个清晰的表格，列出了所有制度要求的文件及其当前状态。这份报告可以直接发送给项目组或归档部门作为整改依据。