钢铁部门档案管理软件本地部署零基础实操全流程指南

准备工作

硬件要求

普通办公电脑即可满足：CPU≥2核，内存≥4G，硬盘剩余空间≥50G，支持Windows/macOS/Linux任意系统。

软件安装

• 安装Python3.10，官方具体地址：https://www.python.org/ftp/python/3.10.11/python-3.10.11-amd64.exe（Windows64位），macOS对应下载.dmg包，Linux执行`sudo apt install python3.10 python3-pip`，安装时必须勾选Add Python to PATH（Windows）。
• 验证安装：打开CMD（Windows）或终端（macOS/Linux），输入`python --version`，输出Python 3.10.11即成功；再输入`pip --version`，确认pip可用。

下载部署文件与环境配置

① 直接从官方仓库下载压缩包：https://github.com/steel-archive/steel-department-archive/archive/refs/heads/main.zip，下载后解压到D:\SteelArchive（Windows）或~/SteelArchive（Linux/macOS）。

② 进入解压目录，打开CMD/终端执行依赖安装命令：

``` cd SteelArchive pip install -r requirements.txt ```

requirements.txt为项目自带文件，完整内容可直接复制使用，确保依赖包版本兼容：

``` Flask==2.3.3 Flask-SQLAlchemy==3.0.5 Werkzeug==2.3.7 requests==2.31.0 ```

核心配置修改

数据库配置

找到项目根目录的`config.py`，完整替换原有内容为可直接运行的配置：

```python import os basedir = os.path.abspath(os.path.dirname(__file__)) class Config: SQLALCHEMY_DATABASE_URI = 'sqlite:///' + os.path.join(basedir, 'steel_archive.db') SQLALCHEMY_TRACK_MODIFICATIONS = False SECRET_KEY = 'steel-dept-archive-2024-sec' ```

必须修改SECRET_KEY，替换为任意8位以上随机字符串（如`SECRET_KEY = 'my-steel-12345-arch'`），禁止使用默认值。

端口配置

打开项目根目录的`app.py`，找到最后一行原有代码`app.run()`，修改为固定端口配置（避免端口冲突）：

```python if __name__ == '__main__': app.run(host='0.0.0.0', port=8080, debug=False) ```

若端口8080被占用，可改为8081/8082等未使用的端口。

数据库初始化

在CMD/终端依次执行以下命令，步骤不能跳过：

1. 进入项目目录后输入`python`，进入Python交互环境；
2. 依次输入以下代码，创建数据库表结构： ```python from app import db db.create_all() exit() ```

成功标志：无任何报错，终端仅显示退出信息，项目根目录自动生成`steel_archive.db`文件。

管理员账号创建与登录测试

初始管理员账号创建

在CMD/终端执行创建脚本：

``` python create_admin.py ```

按提示输入：① 管理员用户名（如`steel_dept_admin`）；② 密码必须≥8位，含字母+数字，完成后会显示“管理员创建成功”。

登录测试

在本机浏览器输入`http://localhost:8080`，输入刚才创建的账号密码，即可进入系统后台。

钢铁部门档案录入实操

单条档案录入

进入后台后，点击左侧菜单【生产档案管理】→【新增档案】，按要求填写：

• 档案编号：固定格式为`STEEL-PROD-YYYYMMDD-XXX`（YYYY=年，MM=月，DD=日，XXX=当日序号，如`STEEL-PROD-20240520-001`）；
• 档案类型：从下拉列表选择对应类型（如炼铁车间日报、炼钢质量台账）；
• 关联部门：选择具体钢铁生产部门（如炼铁一部、轧钢二部）；
• 附件上传：支持PDF/Excel格式，单个文件≤10MB。

点击【保存】，系统自动生成唯一档案ID，录入完成。

批量导入（可选）

若已有历史档案清单，点击【生产档案管理】→【批量导入】，上传项目自带的`import_template.xlsx`模板，按模板要求填写后上传，系统自动校验并导入，错误会标注具体行号。

日常维护与访问

数据库备份

每周执行备份命令，避免数据丢失：

• Linux/macOS：`sqlite3 steel_archive.db .dump > backup_$(date +%Y%m%d).sql`，备份文件自动命名为日期格式；
• Windows：`sqlite3.exe steel_archive.db .dump > backup_%date:~10,4%%date:~4,2%%date:~7,2%.sql`。

局域网访问设置

其他电脑访问需关闭端口8080（或自定义端口）的防火墙：Windows操作路径：控制面板→Windows Defender防火墙→高级设置→入站规则→新建规则→端口→8080→允许连接→命名为SteelArchive，之后其他电脑输入`http://你的电脑IP:8080`即可访问。

更新系统时，执行`git pull origin main`（若用Git克隆）或重新下载最新压缩包覆盖，再执行依赖安装命令即可。