注册公用设备工程师证数字档案馆系统本地部署实操指南

一、环境准备：零门槛部署前提

必须先安装以下2款稳定工具，所有操作均采用官方版，避免兼容问题：

• Python 3.8及以上版本：运行系统核心代码
• Git 2.30及以上版本：获取项目源码

工具安装步骤

Python安装：打开https://www.python.org/downloads/release/python-31010/，下载对应系统的安装包，Windows版运行时必须勾选“Add Python to PATH”复选框，点击“Install Now”完成；安装后打开CMD/终端，输入python --version，输出版本号即为成功。

Git安装：打开https://git-scm.com/download/win，下载并运行安装包，保持默认设置完成；安装后打开CMD/终端，输入git --version，输出版本号即为成功。

二、项目源码获取与初始化

打开CMD/终端，执行以下命令克隆项目到本地：

``` git clone https://github.com/cert-archive/registered-utility-engineer.git cd registered-utility-engineer ```

执行后会生成项目文件夹，所有后续操作均在该文件夹内进行。

三、核心配置修改

用代码编辑器打开config.py，修改关键配置（禁止使用默认值，避免安全风险）：

```python import os BASE_DIR = os.path.abspath(os.path.dirname(__file__)) 数据库路径（自动生成，无需修改） DATABASE_URI = f'sqlite:///{os.path.join(BASE_DIR, "cert_archive.db")}' 替换为32位以上随机字符串，可通过https://randomkeygen.com/生成 SECRET_KEY = 'your_32bit_plus_random_string_here' 初始账号配置（可按需修改） DEFAULT_ADMIN_USER = 'admin' DEFAULT_ADMIN_PWD = 'new_8bit_above_pwd' ```

修改后保存config.py文件。

四、依赖安装与系统初始化

安装项目依赖

执行以下命令，用国内镜像加速安装依赖（避免国外源超时失败）：

``` pip install -i https://pypi.tuna.tsinghua.edu.cn/simple flask flask-sqlalchemy flask-migrate ```

初始化数据库

依次执行以下3条命令，自动创建数据库文件（首次使用必须执行）：

``` flask db init flask db migrate -m "initial cert archive" flask db upgrade ```

五、系统启动与初始验证

执行以下命令启动系统服务：

``` flask run ```

服务启动成功后，终端输出“Running on http://127.0.0.1:5000”，打开浏览器访问该地址，进入登录页。

初始登录账号为admin，密码为你在config.py中修改的DEFAULT_ADMIN_PWD；登录后必须立即点击“修改密码”，设置8位以上字母数字混合的新密码。

六、核心功能实操步骤

1. 上传注册公用设备工程师证书

登录后点击左侧菜单「证书管理→上传证书」，按表单填写：

• 证书编号：12位国家统一编号（在注册证书上查询）
• 注册专业：选“暖通”“给水排水”“动力”三者之一
• 有效期：格式YYYY-MM-DD（按证书填写）
• 上传证书照片：选清晰jpg/png文件，大小≤2MB

填写后点击「提交」，系统自动生成唯一存档记录。

2. 查询与导出证书

点击左侧菜单「证书查询」，搜索框输入证书编号或专业，点击「查询」，显示对应证书信息；点击结果后的「导出PDF」，生成标准化存档文件保存到本地。

七、常见问题快速排查

服务启动失败（端口占用）

Windows执行netstat -ano | findstr :5000，Linux/macOS执行lsof -i:5000，查看占用5000端口的进程；执行taskkill /PID 进程号 /F（Windows）或kill -9 进程号（Linux/macOS）终止进程，重新执行启动命令即可。

依赖安装超时

重复执行依赖安装命令，确保添加国内镜像参数；若仍失败，可先下载对应依赖的whl文件，再本地安装。