B/S版工程档案软件部署及施工资质申报对接实操全指南

前置准备

软硬件环境要求

必须满足以下配置，否则会出现部署失败、上传卡顿问题：

• 服务端：CentOS7.9+/Ubuntu20.04+操作系统，4核8G以上CPU，1T以上SSD硬盘，公网IP，安全组放行80/443端口
• 客户端：Chrome100+/Edge100+版本浏览器，无需安装任何本地插件

材料准备

• 施工资质最新标准文件：http://www.mohurd.gov.cn/gongkai/fdzdgknr/zfhcxjsbgtwj/202202/t20220225_254684.html
• 企业营业执照扫描件、近3年工程业绩台账、人员执业资格证书扫描件、设备权属证明扫描件
• 开源B/S版工程档案软件安装包：https://gitee.com/oschina/engineering-archive-system/releases/download/v1.2.0/bs-archive-v1.2.0.tar.gz

第一步：B/S版档案软件部署实操

1.1 服务端基础环境配置

通过SSH工具登录服务器，依次执行以下命令安装Docker和Docker-Compose，所有命令可直接复制执行：

``` 安装Docker curl -fsSL https://get.docker.com | bash systemctl start docker systemctl enable docker 验证Docker安装成功，返回版本号即为正常 docker -v 安装Docker-Compose curl -L "https://github.com/docker/compose/releases/download/v2.15.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose chmod +x /usr/local/bin/docker-compose 验证Docker-Compose安装成功，返回版本号即为正常 docker-compose -v ```

1.2 档案软件安装启动

继续在服务器终端执行以下命令：

``` 创建安装目录 mkdir -p /opt/archive && cd /opt/archive 下载安装包 wget https://gitee.com/oschina/engineering-archive-system/releases/download/v1.2.0/bs-archive-v1.2.0.tar.gz 解压安装包 tar -zxvf bs-archive-v1.2.0.tar.gz 启动服务 docker-compose up -d ```

服务启动完成后，在客户端浏览器输入http://你的服务器公网IP，出现登录界面即为部署成功，默认账号为admin，默认密码为123456。首次登录必须立即修改密码，在「系统设置-安全设置」中开启IP白名单限制，仅允许企业内部IP访问后台。

第二步：档案系统与施工资质申报对接配置

2.1 档案分类规则配置

登录系统后台，进入「系统设置-分类管理」，按照施工资质申报要求配置4类核心档案，以下为必填字段，不得删减，否则会导致申报材料校验不通过：

• 人员资质档案：姓名、身份证号、执业资格证编号、证书有效期、近3个月社保缴纳证明、劳动合同扫描件
• 工程业绩档案：项目名称、项目规模、竣工时间、竣工验收证明、合同扫描件、回款凭证
• 设备仪器档案：设备名称、型号、检定有效期、购置发票、权属证明
• 信用档案：奖惩时间、奖惩单位、奖惩内容、官方证明文件

配置完成后点击「保存并生效」，系统会自动生成字段校验规则，后续上传材料时会自动校验必填项是否完整。

2.2 资质申报接口配置

进入「系统设置-接口管理」，找到「住建部资质申报接口」选项，填写以下配置内容，可直接复制修改：

``` { "apiUrl": "http://zizhijianshe.mohurd.gov.cn/api/archive/upload", "appKey": "你企业在住建部政务服务平台申请的appKey", "appSecret": "你企业在住建部政务服务平台申请的appSecret", "uploadType": "automatic", "checkEnable": true } ```

appKey和appSecret获取路径：住建部政务服务平台-企业服务-资质申报-接口授权，提交企业营业执照扫描件后1个工作日内审核通过即可获取，配置完成后点击「测试连接」，提示连接成功即为配置完成。

第三步：施工资质申报实操流程

3.1 档案材料上传校验

• 按照分类上传所有扫描件，命名规则统一为「分类-主体名称-关键信息-有效期」，例如「人员资质-张三-一级建造师-20280512」
• 所有材料上传完成后，点击左侧菜单栏「资质申报校验」功能，系统会自动比对当前申报资质的标准要求，校验不通过的项会标红提示缺失材料，必须100%完成校验后再提交，否则申报会被直接驳回
• 校验通过后，系统自动生成《工程档案合规性报告》，可直接下载打印留存

3.2 资质申报提交

• 登录住建部政务服务平台资质申报入口，选择对应要申报的资质等级
• 档案材料部分直接选择「系统对接导入」，输入企业统一社会信用代码即可自动拉取档案系统内所有合规材料，无需手动上传
• 填写完其他基础信息后提交申报，可在档案系统「申报进度」模块实时同步审核状态，驳回原因会同步到系统待办项，可直接修改后重新提交

常见问题排查

• 部署后无法访问系统：检查服务器安全组是否放行80/443端口，执行命令firewall-cmd --zone=public --add-port=80/tcp --permanent && firewall-cmd --reload开放端口，关闭服务器内部防火墙即可
• 接口连接失败：检查appKey和appSecret是否填写正确，服务器公网IP是否添加到住建部接口白名单，可登录住建部政务服务平台接口授权页面修改白名单
• 材料校验不通过：点击标红项的「查看详情」，按照提示补充材料，若确认材料无误可提交人工复核，1个工作日内会返回复核结果
• 材料导入失败：检查扫描件大小是否超过10M，格式是否为JPG/PDF，修改后重新上传即可