档案管理软件助力能源管理体系资质认证实操指南
系统环境搭建
在构建符合能源管理体系（如ISO 50001）资质要求的档案管理模块时，推荐使用Python作为后端语言，配合Flask框架和SQLite数据库。这种组合轻量且易于部署，能够快速实现文档的版本控制与审计追踪。
请在你的终端中执行以下命令来创建项目目录并安装必要的依赖库：
```bash mkdir energy_doc_system cd energy_doc_system pip install flask flask-sqlalchemy flask-login ```创建完成后，项目根目录下应包含以下文件结构：app.py（主程序）、models.py（数据库模型）、templates/（前端模板目录）。请确保Python版本为3.8及以上以保证兼容性。
数据库表结构设计
能源管理体系资质认证的核心在于对受控文件的严格管理。我们需要设计两张核心表：EnergyDocument（存储文档基础信息）和DocumentVersion（存储版本历史与变更记录）。在models.py中写入以下完整代码：
```python from flask_sqlalchemy import SQLAlchemy from datetime import datetime db = SQLAlchemy() class EnergyDocument(db.Model): __tablename__ = 'energy_documents' id = db.Column(db.Integer, primary_key=True) doc_code = db.Column(db.String(50), unique=True, nullable=False) 文件编号，如 EN-POL-001 title = db.Column(db.String(200), nullable=False) 文件标题 category = db.Column(db.String(50), nullable=False) 类别：能源方针、目标指标、运行准则等 is_controlled = db.Column(db.Boolean, default=True) 是否为受控文件 current_version_id = db.Column(db.Integer, db.ForeignKey('document_versions.id')) versions = db.relationship('DocumentVersion', backref='document', lazy='dynamic') class DocumentVersion(db.Model): __tablename__ = 'document_versions' id = db.Column(db.Integer, primary_key=True) doc_id = db.Column(db.Integer, db.ForeignKey('energy_documents.id')) version_no = db.Column(db.String(10), nullable=False) 版本号：V1.0, V1.1 file_path = db.Column(db.String(255), nullable=False) 物理存储路径 upload_time = db.Column(db.DateTime, default=datetime.utcnow) uploader = db.Column(db.String(50), nullable=False) 上传人 change_desc = db.Column(db.Text) 变更说明，审核重点 md5_checksum = db.Column(db.String(32)) 文件完整性校验 ```此设计强制要求每个受控文件必须有唯一的编号（doc_code）和明确的类别，这是审核员检查时的第一关注点。
后端核心逻辑开发
在app.py中实现文件上传、版本迭代及MD5校验逻辑。为了满足资质要求，上传文件时必须填写“变更说明”，系统将自动计算文件哈希值以防止篡改。
配置文件详解
在代码头部加入配置信息，指定上传目录和数据库连接：
```python import os from flask import Flask, request, redirect, url_for, render_template from werkzeug.utils import secure_filename import hashlib app = Flask(__name__) app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///energy_ms.db' app.config['UPLOAD_FOLDER'] = './uploads' app.config['ALLOWED_EXTENSIONS'] = {'pdf', 'doc', 'docx'} os.makedirs(app.config['UPLOAD_FOLDER'], exist_ok=True) from models import db, EnergyDocument, DocumentVersion db.init_app(app) with app.app_context(): db.create_all() ```文件上传与元数据绑定
以下代码处理文件上传请求。请注意，这里通过MD5算法确保存档文件的完整性，这是能源管理体系中数据真实性的关键技术保障：
```python def allowed_file(filename): return '.' in filename and filename.rsplit('.', 1)[1].lower() in app.config['ALLOWED_EXTENSIONS'] def calculate_md5(file_path): with open(file_path, 'rb') as f: return hashlib.md5(f.read()).hexdigest() @app.route('/upload', methods=['POST']) def upload_file(): doc_code = request.form['doc_code'] title = request.form['title'] category = request.form['category'] uploader = request.form['uploader'] change_desc = request.form['change_desc'] file = request.files['file'] if file and allowed_file(file.filename): 1. 安全处理文件名 filename = secure_filename(file.filename) timestamp = datetime.now().strftime("%Y%m%d%H%M%S") save_name = f"{timestamp}_{filename}" save_path = os.path.join(app.config['UPLOAD_FOLDER'], save_name) file.save(save_path) 2. 计算MD5 file_hash = calculate_md5(save_path) 3. 查找或创建文档记录 doc = EnergyDocument.query.filter_by(doc_code=doc_code).first() version_no = "V1.0" if not doc: doc = EnergyDocument(doc_code=doc_code, title=title, category=category) db.session.add(doc) db.session.flush() 获取ID else: 简单的版本号递增逻辑 last_ver = DocumentVersion.query.filter_by(doc_id=doc.id).order_by(DocumentVersion.id.desc()).first() major, minor = map(int, last_ver.version_no[1:].split('.')) version_no = f"V{major}.{minor + 1}" 4. 创建版本记录 new_version = DocumentVersion( doc_id=doc.id, version_no=version_no, file_path=save_path, uploader=uploader, change_desc=change_desc, md5_checksum=file_hash ) db.session.add(new_version) 5. 更新当前版本指针 doc.current_version_id = new_version.id db.session.commit() return redirect(url_for('index')) return "Invalid file or no file selected", 400 ```前端交互页面开发
为了方便操作人员录入，我们需要一个简洁的上传表单。在templates目录下创建index.html，表单字段必须包含能源管理所需的特定元数据：
```html受控文件上传
```在app.py中添加路由以渲染此页面：
```python @app.route('/') def index(): return render_template('index.html') ```审计日志与合规导出
资质认证审核时，审核员通常会要求查看“文件发放记录”或“版本变更一览表”。我们需要增加一个导出功能，将数据库中的版本记录生成为CSV格式的报表。
在app.py中添加以下代码：
```python import csv from io import StringIO @app.route('/export_audit_log') def export_audit_log(): 查询所有版本记录 versions = DocumentVersion.query.all() 创建CSV流 si = StringIO() writer = csv.writer(si) 写入表头 writer.writerow(['文件编号', '文件标题', '版本号', '上传时间', '上传人', '变更说明', 'MD5校验值']) for v in versions: writer.writerow([ v.document.doc_code, v.document.title, v.version_no, v.upload_time.strftime('%Y-%m-%d %H:%M:%S'), v.uploader, v.change_desc, v.md5_checksum ]) output = si.getvalue() 返回CSV文件下载 response = app.response_class( output, mimetype='text/csv', headers={"Content-Disposition": "attachment;filename=energy_audit_log.csv"} ) return response ```部署与验证
完成代码编写后，直接运行启动服务：
```bash python app.py ```浏览器访问 http://127.0.0.1:5000 即可看到上传界面。进行一次完整的上传测试，上传一份PDF格式的《能源管理手册》，填写文件编号为“EN-MAN-001”，类别选择“能源方针”。
上传成功后，访问 http://127.0.0.1:5000/export_audit_log。如果浏览器自动下载了一个包含刚才上传记录的CSV文件，且MD5校验值已生成，说明系统构建成功。此时，你的档案管理软件已具备支撑能源管理体系资质审核的受控文件管理能力，能够证明文件的不可篡改性和全生命周期追溯性。
相关文章
