档案整理门禁系统零基础搭建全流程实操技术指南

环境准备

零门槛落地需依赖Python及Flask框架，无额外专业工具要求：

1. Python环境部署

下载安装包：https://www.python.org/downloads/windows/，安装时必须勾选Add Python to PATH，默认路径完成安装。

2. 安装核心依赖

按Win+R输入cmd打开命令提示符，执行以下命令：

```bash pip install flask==2.3.3 ```

（注：sqlite3为Python内置模块，无需单独安装）

核心代码编写

新建文件夹demo_archive_access，在文件夹内创建app.py文件，写入以下完整代码：

```python from flask import Flask, request, jsonify import sqlite3 app = Flask(__name__) 预设有效门禁卡号 VALID_CARDS = {"123456": "档案管理员", "654321": "档案录入员"} DB_PATH = "archive.db" 初始化档案数据库 def init_db(): conn = sqlite3.connect(DB_PATH) cursor = conn.cursor() cursor.execute(""" CREATE TABLE IF NOT EXISTS archive ( id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT NOT NULL, category TEXT NOT NULL, create_time TEXT DEFAULT CURRENT_TIMESTAMP ) """) conn.commit() conn.close() 门禁验证接口 @app.route("/access", methods=["POST"]) def access_verify(): data = request.get_json() card_no = data.get("card_no") if not card_no or card_no not in VALID_CARDS: return jsonify({"code": 403, "msg": "门禁验证失败，卡号无效"}), 403 return jsonify({"code": 200, "msg": f"验证通过，欢迎{VALID_CARDS[card_no]}"}), 200 档案新增接口（需门禁授权） @app.route("/archive", methods=["POST"]) def add_archive(): auth_header = request.headers.get("Authorization") if not auth_header or auth_header != "Bearer valid": return jsonify({"code":401,"msg":"未授权，请先通过门禁"}),401 data = request.get_json() name = data.get("name") category = data.get("category") if not name or not category: return jsonify({"code":400,"msg":"缺少必填字段name/category"}),400 conn = sqlite3.connect(DB_PATH) cursor = conn.cursor() cursor.execute("INSERT INTO archive (name, category) VALUES (?, ?)", (name, category)) conn.commit() conn.close() return jsonify({"code":200,"msg":"档案添加成功","data":{"id":cursor.lastrowid}}),200 if __name__ == "__main__": init_db() app.run(host="0.0.0.0", port=5000, debug=True) ```

系统启动与验证

1. 启动服务

在demo_archive_access文件夹内打开cmd，执行命令：

```bash python app.py ```

出现提示Running on http://127.0.0.1:5000 即启动成功。

2. 门禁验证测试

开新cmd窗口，执行以下命令测试有效卡号：

```bash curl -X POST http://127.0.0.1:5000/access -H "Content-Type: application/json" -d '{"card_no":"123456"}' ```

返回{"code":200,"msg":"验证通过，欢迎档案管理员"}为成功；非法卡号返回403错误。

3. 档案操作测试

执行以下命令新增档案（用简化授权验证）：

```bash curl -X POST http://127.0.0.1:5000/archive -H "Content-Type: application/json" -H "Authorization: Bearer valid" -d '{"name":"2023年度人事档案","category":"人事"}' ```

返回{"code":200,"msg":"档案添加成功","data":{"id":1}}即为操作完成。

常见问题修复

• 端口5000被占用：修改app.run的port为其他数字（如5001），重启服务即可。
• Python命令无效：确认已勾选Add Python to PATH，或用py命令替代python执行。
• 数据库创建失败：给demo_archive_access文件夹分配写入权限，或用管理员身份运行cmd。

可选功能扩展

实际场景可扩展：1. 将VALID_CORD改为数据库存储，支持批量卡号导入；2. 对接USB刷卡器API读取真实卡号；3. 增加档案查询/删除接口；4. 替换固定授权为门禁返回的动态token。