装修工程档案管理系统本地部署与常用功能配置实操全指南

一、前期环境准备

1.1 硬件最低要求

Windows10/11、MacOS12+、CentOS7+ 任意系统均可，CPU2核以上，内存4G以上，存储空间预留50G以上（满足3年以上工程档案存储需求）。

1.2 依赖软件安装

所有依赖均为开源免费软件，直接从官方地址下载对应系统版本即可：

• Python3.9：https://www.python.org/downloads/release/python-3913/
• MySQL8.0：https://dev.mysql.com/downloads/mysql/8.0.html
• Node.js16.x：https://nodejs.org/dist/latest-v16.x/

安装注意事项：Python安装时勾选「Add Python 3.9 to PATH」，MySQL安装时设置root密码为123456（后续配置可修改），Node.js安装完成后执行 npm config set registry https://registry.npmmirror.com 切换国内源；CentOS系统提前执行 yum install python39-devel mysql-devel 避免后续依赖安装失败。

1.3 系统源码获取

已适配装修场景的开源版本可直接获取，无需从零开发：

有Git环境直接执行克隆命令：git clone https://gitee.com/opensource-decor/decor-archive-system.git

无Git环境直接下载压缩包：https://gitee.com/opensource-decor/decor-archive-system/repository/archive/master.zip

二、系统部署实操

2.1 数据库初始化

第一步：打开MySQL命令行，执行命令创建数据库：
create database decor_archive default character set utf8mb4 collate utf8mb4_general_ci;

第二步：进入源码根目录的sql文件夹，执行命令导入初始结构和数据：
mysql -u root -p123456 decor_archive < ./sql/init.sql

2.2 后端服务部署

第一步：进入源码backend目录，执行命令安装Python依赖：
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

第二步：修改backend目录下的config.py配置文件，完整可直接复制内容如下：

```python 数据库配置 DB_HOST = '127.0.0.1' DB_PORT = 3306 DB_USER = 'root' DB_PASSWORD = '123456' DB_NAME = 'decor_archive' 上传文件存储路径，Windows系统改为D:/decor_archive/upload UPLOAD_PATH = '/data/decor_archive/upload' 服务端口 SERVER_PORT = 8000 加密密钥 可自行修改为随机字符串 SECRET_KEY = 'decor_2024_archive_abc123' 单文件最大限制 单位字节 默认1G MAX_FILE_SIZE = 1073741824 ```

第三步：执行启动命令：python run.py，看到控制台输出「服务启动成功，监听端口8000」即为部署成功。

2.3 前端服务部署

第一步：进入源码frontend目录，执行命令安装前端依赖：npm install

第二步：修改frontend目录下的.env.development配置文件，内容如下：

``` VUE_APP_BASE_API = 'http://127.0.0.1:8000/api' VUE_APP_TITLE = '装修工程档案管理系统' ```

第三步：本地测试启动执行 npm run serve，访问http://localhost:8080，默认账号admin，密码123456，能正常登录即为部署成功；需要对外提供服务的话执行 npm run build，将生成的dist目录部署到Nginx即可。

三、核心功能配置实操（适配装修工程场景）

3.1 档案分类配置

登录系统后进入【系统设置-档案分类管理】，按照装修工程标准添加以下4个一级分类，可根据自身需求添加二级子分类：

• 隐蔽工程档案：对应水电、防水、地暖等隐蔽工序的验收记录、照片、视频，必填字段设置为「项目编号、验收人、验收时间、工序节点」
• 材料验收档案：对应瓷砖、板材、涂料、五金等材料的质检报告、进场验收记录，必填字段设置为「材料批次号、供应商、验收人、进场时间」
• 施工过程档案：对应各工序施工记录、巡检记录、整改通知，必填字段设置为「项目编号、巡检人、问题描述、整改期限」
• 竣工验收档案：对应整体竣工报告、空气质量检测报告、业主签字确认文件，必填字段设置为「项目编号、竣工时间、业主确认状态」

3.2 角色权限配置

进入【系统设置-角色管理】，添加3个默认角色，可根据团队规模扩展：

• 项目主管：拥有所有档案的上传、编辑、下载、删除、归档权限
• 施工班组长：仅拥有所属项目的档案上传、查看权限，不可修改删除已上传内容
• 业主：仅拥有所属项目的档案查看、下载权限，无上传编辑权限

配置完成后进入【用户管理】添加对应账号，绑定所属项目即可完成权限分配。

3.3 自动归档规则配置

进入【系统设置-归档规则】，开启工程结束自动归档功能，设置规则：项目标记为竣工后30天内所有档案自动锁定，禁止编辑、删除，仅可查看下载，避免档案被恶意修改。同时开启归档自动备份功能，设置备份路径，每日凌晨2点自动全量备份所有档案数据，防止数据丢失。

四、日常使用与问题排查

4.1 日常操作规范

所有档案上传时必须关联对应项目编号、工序节点，照片/视频命名规则统一为「项目编号_工序名称_时间_上传人」，方便后续检索。如果需要调整单文件大小限制，直接修改后端config.py中的MAX_FILE_SIZE参数后重启服务即可。

4.2 常见问题排查

• 后端启动报错提示数据库连接失败：检查MySQL服务是否正常启动，config.py中的数据库账号密码、端口是否和实际安装的一致
• 前端访问提示跨域：检查前端.env配置中的后端地址是否正确，后端服务是否正常启动
• 大文件上传失败：如果是Nginx部署的前端，检查Nginx配置的client_max_body_size是否大于上传文件大小，同时确认后端UPLOAD_PATH目录是否有写入权限

按照以上步骤操作即可完成装修工程档案管理系统的全流程搭建与配置，所有功能均可直接适配中小装修公司的档案管理需求，无需二次开发即可落地使用。