零基础Python搭建档案电子系统全流程实操

一、环境准备与依赖安装

在开始构建档案电子系统之前，需要确保你的开发环境已经配置妥当。我们将使用Python作为后端语言，Flask作为Web框架，SQLite作为数据库（无需额外安装数据库服务），以及Werkzeug处理文件上传的安全问题。这种组合轻量且高效，非常适合快速落地。

请在终端中执行以下命令安装所需的依赖库。如果尚未安装Python，请前往python.org下载并安装3.8及以上版本。

pip install flask flask-sqlalchemy flask-cors werkzeug

安装完成后，在本地创建一个项目文件夹，例如命名为digital_archive。在该文件夹下，我们需要预先创建以下目录结构以保持项目整洁：

• uploads/：用于存储用户上传的电子档案文件。
• instance/：Flask默认的数据库存放目录。
• templates/：存放前端HTML文件。
• static/：存放CSS和JS文件（本例我们将CSS和JS内嵌在HTML中，简化操作）。

执行以下命令创建必要的文件夹：

mkdir uploads instance templates

二、数据库模型设计

档案系统的核心在于对文件元数据的结构化存储。我们需要创建一个Archive模型来记录每一份档案的详细信息。设计字段包括：主键ID、原始文件名、存储路径、文件大小、上传时间、档案分类、描述信息以及标签。

在项目根目录下创建app.py文件，并写入以下代码。这段代码配置了数据库连接并定义了数据模型。

import os
from flask import Flask, request, jsonify, render_template, send_from_directory
from flask_sqlalchemy import SQLAlchemy
from flask_cors import CORS
from werkzeug.utils import secure_filename
from datetime import datetime
import uuid
app = Flask(__name__)
CORS(app)
配置上传文件夹和数据库路径
BASE_DIR = os.path.abspath(os.path.dirname(__file__))
app.config['UPLOAD_FOLDER'] = os.path.join(BASE_DIR, 'uploads')
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///archive.db'
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False
app.config['MAX_CONTENT_LENGTH'] = 100  1024  1024   限制最大上传100MB
确保上传目录存在
os.makedirs(app.config['UPLOAD_FOLDER'], exist_ok=True)
db = SQLAlchemy(app)
定义档案数据模型
class Archive(db.Model):
id = db.Column(db.Integer, primary_key=True)
original_filename = db.Column(db.String(255), nullable=False)
stored_filename = db.Column(db.String(255), nullable=False)
file_path = db.Column(db.String(500), nullable=False)
file_size = db.Column(db.Integer, nullable=False)
category = db.Column(db.String(50), nullable=True)
description = db.Column(db.Text, nullable=True)
tags = db.Column(db.String(255), nullable=True)
upload_time = db.Column(db.DateTime, default=datetime.utcnow)
def to_dict(self):
return {
'id': self.id,
'original_filename': self.original_filename,
'file_size': round(self.file_size / 1024, 2),  转换为KB
'category': self.category,
'description': self.description,
'tags': self.tags,
'upload_time': self.upload_time.strftime('%Y-%m-%d %H:%M:%S')
}
初始化数据库
with app.app_context():
db.create_all()

三、后端核心逻辑实现

接下来实现后端的核心业务逻辑，包括文件上传、列表查询、文件下载和删除功能。请将以下代码追加到app.py文件中。

1. 文件上传接口

该接口接收前端传来的文件和表单数据，进行安全校验后保存文件，并将元数据写入数据库。为了防止文件名冲突，我们使用UUID重命名文件。

ALLOWED_EXTENSIONS = {'txt', 'pdf', 'png', 'jpg', 'jpeg', 'doc', 'docx', 'xls', 'xlsx'}
def allowed_file(filename):
return '.' in filename and filename.rsplit('.', 1)[1].lower() in ALLOWED_EXTENSIONS
@app.route('/api/upload', methods=['POST'])
def upload_file():
if 'file' not in request.files:
return jsonify({'error': '没有文件部分'}), 400
file = request.files['file']
if file.filename == '':
return jsonify({'error': '未选择文件'}), 400
if file and allowed_file(file.filename):
获取表单其他数据
category = request.form.get('category', '未分类')
description = request.form.get('description', '')
tags = request.form.get('tags', '')
生成安全的文件名（使用UUID防止重名）
original_filename = secure_filename(file.filename)
ext = original_filename.rsplit('.', 1)[1].lower()
stored_filename = f"{uuid.uuid4().hex}.{ext}"
file_path = os.path.join(app.config['UPLOAD_FOLDER'], stored_filename)
file.save(file_path)
获取文件大小
file_size = os.path.getsize(file_path)
存入数据库
new_archive = Archive(
original_filename=original_filename,
stored_filename=stored_filename,
file_path=file_path,
file_size=file_size,
category=category,
description=description,
tags=tags
)
db.session.add(new_archive)
db.session.commit()
return jsonify({'message': '上传成功', 'data': new_archive.to_dict()}), 201
else:
return jsonify({'error': '不支持的文件类型'}), 400

2. 档案列表与搜索接口

该接口支持分页查询，并可根据关键词（文件名、描述或标签）进行模糊搜索。

@app.route('/api/archives', methods=['GET'])
def get_archives():
page = request.args.get('page', 1, type=int)
per_page = request.args.get('per_page', 10, type=int)
search = request.args.get('search', '')
query = Archive.query
if search:
query = query.filter(
db.or_(
Archive.original_filename.like(f'%{search}%'),
Archive.description.like(f'%{search}%'),
Archive.tags.like(f'%{search}%')
)
)
按上传时间倒序排列
pagination = query.order_by(Archive.upload_time.desc()).paginate(page=page, per_page=per_page, error_out=False)
archives_list = [item.to_dict() for item in pagination.items]
return jsonify({
'items': archives_list,
'total': pagination.total,
'pages': pagination.pages,
'current_page': page
})

3. 文件下载与删除接口

下载接口通过send_from_directory安全地发送文件，删除接口则会同时移除物理文件和数据库记录。

@app.route('/api/download/', methods=['GET'])
def download_file(archive_id):
archive = Archive.query.get_or_404(archive_id)
return send_from_directory(app.config['UPLOAD_FOLDER'], archive.stored_filename, as_attachment=True, download_name=archive.original_filename)
@app.route('/api/archive/', methods=['DELETE'])
def delete_archive(archive_id):
archive = Archive.query.get_or_404(archive_id)
删除物理文件
if os.path.exists(archive.file_path):
try:
os.remove(archive.file_path)
except Exception as e:
return jsonify({'error': f'文件删除失败: {str(e)}'}), 500
删除数据库记录
db.session.delete(archive)
db.session.commit()
return jsonify({'message': '档案删除成功'})

四、前端页面开发

为了实现零门槛操作，我们创建一个单页应用HTML，包含上传表单和档案列表展示。在templates文件夹下创建index.html，并写入以下代码：

档案上传


选择文件:



分类:



描述:



标签 (逗号分隔):


上传档案

档案列表


搜索




文件名
分类
大小(KB)
上传时间
操作

在app.py文件末尾添加路由以渲染该HTML页面：

@app.route('/')
def index():
return render_template('index.html')
if __name__ == '__main__':
app.run(debug=True, port=5000)

五、系统运行与测试

所有代码已经准备就绪，现在可以启动系统进行测试。

1. 启动服务

在终端中进入项目根目录，执行以下命令启动Flask服务器：

python app.py

当终端显示Running on http://127.0.0.1:5000时，说明服务已成功启动。

2. 功能测试

打开浏览器，访问http://127.0.0.1:5000。你将看到一个简洁的操作界面。

• 上传测试：点击“选择文件”，选取一个PDF或图片，填写分类为“测试文档”，描述为“系统功能验证”，点击上传。成功后会看到下方列表自动刷新出该条目。
• 搜索测试：在搜索框输入刚才填写的描述或文件名，点击搜索，列表将过滤显示匹配的档案。
• 下载测试：点击列表中的“下载”按钮，浏览器将下载原始文件。
• 删除测试：点击“删除”按钮，确认弹窗后，该条目将从列表中移除，且服务器uploads文件夹下的物理文件也会被同步删除。

相关文章

档案制度建设机构排名怎么找靠谱的？避坑+实用筛选指南全送你

档案制度建设机构排名怎么找靠谱的？避坑+实用筛选指南全送你 1 别直接搜「档案制度建设机构排名」！没用 我知道很多人第一反应就是去搜这个关键词 结果跳出来的都是一堆广告 或者机构自吹自擂的软文 ...

档案管理系统易扩展性差？过来人分享实用解决方案

档案管理系统易扩展性差？过来人分享实用解决方案 唠唠我踩过的痛：档案管理系统易扩展性差的社死瞬间 哎，跟你唠唠我去年在公司踩的超级大坑——那段时间真的天天想摸鱼溜号，全拜那破系统所赐！对了，就是那种档...

2026年企业或事业单位在株洲实施档案管理系统需要多少钱？选型流程是怎样的？

2026年企业或事业单位在株洲实施档案管理系统需要多少钱？选型流程是怎样的？ 一、开篇直答 2026年部署一套成熟的株洲档案管理系统，费用通常在3万元至50万元人民币之间，具体价格取决于用户数量、功能...

别被坑了！数字档案馆系统售后服务费用真相

别被坑了！数字档案馆系统售后服务费用真相 这钱到底都花哪儿了？ 咱们做档案数字化这行的，都知道一个痛处：买系统的时候，那是上帝，钱到位了，笑脸相迎；等签完合同进了维保期，那感觉立马变了。这数字档案馆系...

典当行业档案软件：解决典当行管档难题的实用工具

典当行业档案软件：解决典当行管档难题的实用工具 一、我踩过的典当行业档案的那些“血坑”（过来人掏心窝子的血泪史） 各位典当行的老炮儿、刚入行的小老弟小老妹，咱先唠个掏心窝子的——我之前待过3家典当行，...

做好档案制度建设管理人员培训 夯实单位档案管理工作基础

做好档案制度建设管理人员培训 夯实单位档案管理工作基础 我当初踩过的坑，那叫一个“鞋崩鞋柜塌” 说出来你不信，我刚管单位档案那两年，掉的头发比我当年考职称那会都多。为啥？还不是没摸对门路，整个档案库就...