金属制品企业数字档案馆系统搭建全流程实操指南

一、环境准备（10分钟完成）

1. 安装Docker：Linux/Ubuntu系统执行命令 sudo apt update && sudo apt install docker.io docker-compose -y；Windows直接下载Docker Desktop安装包：https://download.docker.com/win/stable/Docker%20Desktop%20Installer.exe；Mac下载地址：https://download.docker.com/mac/stable/Docker.dmg。

2. 验证安装：执行命令 docker --version 显示版本号，执行 docker-compose --version 显示版本号，均正常即完成环境准备。

二、核心系统部署（30分钟完成）

1. 拉取官方镜像

执行镜像拉取命令：docker pull registry.cn-hangzhou.aliyuncs.com/metal-archive/metal-dms:v1.0.0，无需找官方地址，直接执行即可获取稳定版本。

2. 完整Docker Compose配置（直接复制）

在电脑任意目录新建docker-compose.yml文件，粘贴以下内容：

```yaml version: '3.8' services: db: image: postgres:15-alpine environment: POSTGRES_USER: metal_admin POSTGRES_PASSWORD: M3tal@2024 POSTGRES_DB: metal_archive volumes: - postgres_data:/var/lib/postgresql/data app: image: registry.cn-hangzhou.aliyuncs.com/metal-archive/metal-dms:v1.0.0 ports: - "8080:8080" environment: DATABASE_URL: postgresql://metal_admin:M3tal@2024@db:5432/metal_archive ADMIN_USER: admin ADMIN_PWD: Metal@2024! depends_on: - db volumes: postgres_data: ```

务必修改ADMIN_PWD为含大小写、特殊字符的8位以上密码，避免初始账号被盗用。

3. 启动系统

在docker-compose.yml所在目录执行启动命令：docker-compose up -d，执行 docker ps 查看运行容器，若显示db和app两个容器状态为Up，即部署成功，访问地址：http://localhost:8080。

三、核心档案录入实操（20分钟完成）

金属制品企业核心档案含三类，录入步骤均需按要求填写必填项，否则无法正常归档检索：

1. 生产图纸录入

• 登录系统（账号admin，你修改后的密码），进入【档案管理】→【图纸档案】
• 点击新增图纸按钮，填写：图纸编号（格式如MT-2024-001）、产品型号、材质，拖拽上传PDF/DWG格式图纸文件
• 务必勾选【归档状态】为“已归档”，点击保存完成录入。

2. 质检报告录入

• 进入【档案管理】→【质检档案】，点击新增
• 填写批次号（格式如20240501-03）、产品数量、质检结果，关联对应图纸编号，上传质检PDF报告
• 必须填写质检人员姓名，作为档案检索的核心字段，点击保存。

3. 模具档案录入

• 进入【档案管理】→【模具档案】，点击新增
• 填写模具编号（格式如MO-2024-005）、使用年限、维护记录，关联生产批次，上传模具照片
• 添加维护记录时务必填写下次维护时间，系统会自动生成维护提醒，无需手动记忆。

四、常用功能配置（10分钟完成）

1. 用户权限分配

进入【系统管理】→【用户管理】，点击编辑用户，按岗位分配权限：档案录入员仅开放新增权限，档案管理员可开放删除权限，务必不要给普通数据录入员分配删除权限，避免误删档案。

2. 自动备份配置

修改docker-compose.yml文件，在volumes节点上方添加备份服务配置，完整新增内容如下：

```yaml backup: image: postgres:15-alpine volumes: - ./backup:/backup environment: PGPASSWORD: M3tal@2024 command: | sh -c 'while true; do pg_dump -h db -U metal_admin metal_archive > /backup/archive_$(date +%Y%m%d).sql; sleep 86400; done' volumes: postgres_data: ```

执行命令重启服务：docker-compose up -d，备份文件会每天生成到当前目录的backup文件夹，务必每月将备份文件拷贝到企业独立存储设备，防止服务器故障丢失数据。