档案制度建设监督员自动化监管系统搭建实战

一、环境准备与依赖安装

在开始构建档案制度自动化监管系统之前，需要确保运行环境满足以下基本要求。本系统基于Python开发，利用其强大的文件处理能力和轻量级数据库SQLite，实现无需复杂配置即可落地的监管方案。

1.1 安装Python环境

请确保系统已安装版本3.8及以上的Python。如果未安装，请根据操作系统执行以下命令：

• CentOS/RedHat: sudo yum install python3 python3-pip -y
• Ubuntu/Debian: sudo apt install python3 python3-pip -y
• Windows: 访问 https://www.python.org/downloads/ 下载安装包并安装，勾选 "Add Python to PATH"。

1.2 安装核心依赖库

我们需要使用watchdog库来监控文件系统变化，以及hashlib（内置）进行文件完整性校验。请在终端执行以下命令安装依赖：

pip3 install watchdog

二、项目目录结构规划

为了保持代码的可维护性，请在本地创建一个名为archive_supervisor的文件夹，并按照以下结构创建文件和目录：

• archive_supervisor/ (项目根目录)
  • config.json (配置文件，定义监管规则)
  • supervisor.py (核心监管逻辑脚本)
  • logs/ (日志存放目录)
  • reports/ (生成的监管报告存放目录)

三、配置文件编写

配置文件是监管系统的核心，监督员可以通过修改config.json来定义监管的目录、必须存在的制度文件以及命名规范。请完整复制以下内容到config.json中：

```json { "monitor_path": "./data", "database": "supervisor.db", "rules": { "required_files": ["档案管理制度.pdf", "归档范围表.xlsx", "保管期限表.xlsx"], "forbidden_extensions": [".tmp", ".bak", ".log"], "naming_convention": "^[A-Z]{2,4}-\\d{4}-\\d{3}$" }, "report_interval": 3600, "log_level": "INFO" } ```

配置项详解：

• monitor_path: 需要监督的档案根目录，此处默认为项目下的data文件夹，请根据实际路径修改（如/var/www/archives）。
• required_files: 档案制度建设必须包含的文件清单，系统会自动检测这些文件是否存在。
• naming_convention: 档案文件夹命名规范的正则表达式，上述示例表示“2-4位大写字母-4位数字-3位数字”。

四、核心功能代码实现

本部分将编写完整的监管逻辑代码。该脚本将自动扫描目录、校验规则、记录数据库并生成报告。请将以下代码完整复制到supervisor.py中。

4.1 导入库与初始化设置

代码首先加载必要的库，读取配置文件，并初始化SQLite数据库连接。数据库用于记录每次检查的结果，形成监管台账。

```python import os import json import sqlite3 import time import logging import hashlib import re from datetime import datetime from watchdog.observers import Observer from watchdog.events import FileSystemEventHandler 加载配置 with open('config.json', 'r', encoding='utf-8') as f: CONFIG = json.load(f) 初始化日志 logging.basicConfig( level=getattr(logging, CONFIG.get('log_level', 'INFO')), format='%(asctime)s - %(levelname)s - %(message)s', handlers=[ logging.FileHandler(os.path.join('logs', 'supervisor.log'), encoding='utf-8'), logging.StreamHandler() ] ) logger = logging.getLogger(__name__) 初始化数据库 def init_db(): conn = sqlite3.connect(CONFIG['database']) cursor = conn.cursor() cursor.execute(''' CREATE TABLE IF NOT EXISTS audit_logs ( id INTEGER PRIMARY KEY AUTOINCREMENT, folder_name TEXT, check_time TEXT, status TEXT, details TEXT, UNIQUE(folder_name, check_time) ) ''') conn.commit() conn.close() ```

4.2 文件校验与规则检查逻辑

此模块包含具体的检查逻辑：计算文件哈希值以验证完整性，检查文件夹命名是否符合规范，以及是否包含必要的制度文件。

```python def calculate_file_hash(filepath): """计算文件的SHA256值，用于完整性校验""" sha256 = hashlib.sha256() try: with open(filepath, "rb") as f: for chunk in iter(lambda: f.read(4096), b""): sha256.update(chunk) return sha256.hexdigest() except Exception as e: logger.error(f"无法读取文件 {filepath}: {e}") return None def check_folder_compliance(folder_path): """执行单个文件夹的合规性检查""" folder_name = os.path.basename(folder_path) issues = [] 1. 检查命名规范 pattern = re.compile(CONFIG['rules']['naming_convention']) if not pattern.match(folder_name): issues.append(f"命名不符合规范: {folder_name}") 2. 检查必须存在的制度文件 files_in_folder = os.listdir(folder_path) for req_file in CONFIG['rules']['required_files']: if req_file not in files_in_folder: issues.append(f"缺失必备制度文件: {req_file}") else: 如果文件存在，进行完整性校验（示例：检查是否为0字节） full_path = os.path.join(folder_path, req_file) if os.path.getsize(full_path) == 0: issues.append(f"制度文件为空: {req_file}") 3. 检查是否存在违禁文件扩展名 for file in files_in_folder: ext = os.path.splitext(file)[1].lower() if ext in CONFIG['rules']['forbidden_extensions']: issues.append(f"发现违禁文件类型: {file}") status = "PASS" if not issues else "FAIL" details = "; ".join(issues) if issues else "合规" 写入数据库 conn = sqlite3.connect(CONFIG['database']) cursor = conn.cursor() check_time = datetime.now().strftime('%Y-%m-%d %H:%M:%S') try: cursor.execute("INSERT INTO audit_logs (folder_name, check_time, status, details) VALUES (?, ?, ?, ?)", (folder_name, check_time, status, details)) conn.commit() except sqlite3.IntegrityError: 避免重复记录同一秒的检查 pass conn.close() return status, details ```

4.3 报告生成与文件监控

该部分实现了HTML格式的监管报告生成，以及利用watchdog实现实时的文件系统监控。一旦有新档案加入或修改，系统自动触发检查。

```python def generate_report(): """生成HTML格式的监管报告""" conn = sqlite3.connect(CONFIG['database']) cursor = conn.cursor() cursor.execute("SELECT FROM audit_logs ORDER BY check_time DESC LIMIT 100") rows = cursor.fetchall() conn.close() html_content = """ 档案制度建设监管报告

生成时间: {time}

{rows}

档案文件夹	检查时间	状态	详情

""" row_html = "" for row in rows: status_class = "fail" if row[3] == "FAIL" else "pass" row_html += f""" {row[1]} {row[2]} {row[3]} {row[4]} """ report_path = os.path.join('reports', f'report_{int(time.time())}.html') with open(report_path, 'w', encoding='utf-8') as f: f.write(html_content.format(time=datetime.now().strftime('%Y-%m-%d %H:%M:%S'), rows=row_html)) logger.info(f"监管报告已生成: {report_path}") class ArchiveEventHandler(FileSystemEventHandler): def on_modified(self, event): if event.is_directory: logger.info(f"检测到目录变更: {event.src_path}") check_folder_compliance(event.src_path) generate_report() def run_monitor(): 确保目录存在 if not os.path.exists(CONFIG['monitor_path']): os.makedirs(CONFIG['monitor_path']) if not os.path.exists('logs'): os.makedirs('logs') if not os.path.exists('reports'): os.makedirs('reports') init_db() 首次全量扫描 logger.info("开始全量扫描...") for root, dirs, files in os.walk(CONFIG['monitor_path']): for dir_name in dirs: full_path = os.path.join(root, dir_name) check_folder_compliance(full_path) generate_report() 启动实时监控 event_handler = ArchiveEventHandler() observer = Observer() observer.schedule(event_handler, CONFIG['monitor_path'], recursive=True) observer.start() logger.info(f"档案监督服务已启动，正在监控: {CONFIG['monitor_path']}") try: while True: time.sleep(1) except KeyboardInterrupt: observer.stop() observer.join() if __name__ == "__main__": run_monitor() ```

五、系统部署与执行

代码和配置准备就绪后，按照以下步骤启动系统，即可开始自动化的档案制度监督工作。

5.1 创建测试数据

为了验证系统功能，我们需要创建一些符合和不符合规范的测试数据。在项目根目录下执行：

• 创建数据目录：mkdir -p data/GOOD-2023-001
• 创建合规文件：touch data/GOOD-2023-001/档案管理制度.pdf touch data/GOOD-2023-001/归档范围表.xlsx touch data/GOOD-2023-001/保管期限表.xlsx
• 创建不合规目录（命名错误）：mkdir -p data/bad_folder
• 创建不合规目录（缺文件）：mkdir -p data/MISS-2023-002

5.2 启动监督服务

在终端中运行以下命令启动程序：

python3 supervisor.py

5.3 查看监管结果

启动后，终端会显示扫描日志。程序会自动在reports目录下生成一个HTML文件。直接在浏览器中打开该文件，你将看到包含如下内容的表格：

• GOOD-2023-001: 状态显示为绿色PASS，详情为“合规”。
• bad_folder: 状态显示为红色FAIL，详情提示“命名不符合规范”。
• MISS-2023-002: 状态显示为红色FAIL，详情提示“缺失必备制度文件”。

此时，如果你尝试在data目录下新建文件夹或修改文件，系统会自动触发检查并更新日志和报告，实现了档案制度建设的全流程自动化监督。