从零搭建轻量奖杯档案软件 全流程无代码落地实操完整指南

前置准备

本次部署全程无代码，普通家用/办公电脑即可完成，无需额外服务器：

• 硬件要求：Windows/macOS电脑，内存4G以上，剩余存储空间10G以上
• 软件环境：安装Docker Desktop，下载地址直接复制到浏览器打开即可：
  • Windows版：https://desktop.docker.com/win/main/amd64/Docker%20Desktop%20Installer.exe
  • macOS Intel芯片版：https://desktop.docker.com/mac/main/amd64/Docker.dmg
  • macOS M系列芯片版：https://desktop.docker.com/mac/main/arm64/Docker.dmg

Docker安装全程点击默认选项即可，安装完成后启动Docker Desktop，打开终端输入docker -v，显示版本号即代表安装成功。

第一步：部署奖杯档案软件核心服务

1. 在电脑任意位置新建文件夹，命名为trophy-archive，注意文件夹路径不要有中文和特殊字符
2. 打开该文件夹，新建文本文档，重命名为docker-compose.yml，注意要把后缀.txt删掉，完整文件名必须是docker-compose.yml
3. 把以下完整配置复制到该文件中，直接保存即可： ```yaml version: '3.8' services: trophy-web: image: registry.cn-hangzhou.aliyuncs.com/opensource-tools/trophy-archive:1.0 ports: - "8080:80" volumes: - ./data:/var/www/html/data depends_on: - trophy-db restart: always trophy-db: image: mysql:8.0 environment: MYSQL_ROOT_PASSWORD: trophy@2024 MYSQL_DATABASE: trophy MYSQL_USER: trophy_user MYSQL_PASSWORD: trophy_2024 volumes: - ./mysql:/var/lib/mysql restart: always ```
4. 打开终端，进入刚才新建的trophy-archive文件夹，输入命令docker-compose up -d，等待3分钟左右，服务即可启动完成
5. 打开浏览器访问http://localhost:8080，进入初始化页面即代表部署成功

第二步：软件初始化配置

按页面提示依次填写配置，所有参数直接复制以下内容即可，无需修改：

• 数据库地址：trophy-db
• 数据库端口：3306
• 数据库名：trophy
• 数据库用户名：trophy_user
• 数据库密码：trophy_2024

填完数据库配置后点击下一步，设置管理员账号密码，账号建议设为admin，密码不少于8位，提交后即可进入软件后台。

第三步：奖杯档案录入实操

3.1 自定义档案字段配置

先配置符合需求的档案字段，后续录入和查询都基于这些字段：

1. 点击左侧菜单栏【系统设置】-【字段管理】-【新增字段】
2. 按以下规则添加必选字段，非必要字段可自行增减：
   • 字段名：奖杯名称，字段类型：文本，是否必填：是，是否展示在列表：是
   • 字段名：获得时间，字段类型：日期，是否必填：是，是否展示在列表：是
   • 字段名：颁发单位，字段类型：文本，是否必填：是，是否展示在列表：是
   • 字段名：获奖主体，字段类型：文本，是否必填：是，是否展示在列表：是
   • 字段名：奖杯等级，字段类型：下拉选项，选项值填：国家级/省级/市级/区级/校级/企业级，是否必填：是，是否展示在列表：是
   • 字段名：奖杯照片，字段类型：附件，是否必填：否，是否展示在列表：否
   • 字段名：获奖证书扫描件，字段类型：附件，是否必填：否，是否展示在列表：否
3. 所有字段添加完成后点击【保存配置】即可生效

3.2 单个奖杯档案录入

日常新增奖杯直接走单个录入流程：

1. 点击左侧【档案管理】-【新增档案】
2. 按页面提示填写所有必填字段，照片和证书直接拖入上传框即可，支持JPG/PNG/PDF格式，单文件大小不超过50M
3. 填完所有内容后点击【保存并归档】，系统会自动生成唯一档案编号，可打印贴在奖杯实体上做关联标识

3.3 批量奖杯档案导入

如果有大量历史奖杯需要录入，走批量导入流程：

1. 点击【档案管理】-【批量导入】-【下载导入模板】，模板会自动同步你之前配置的所有字段
2. 按模板列提示填写所有内容，需要上传的附件单独放到一个文件夹，文件名和模板里的「附件文件名」列完全对应
3. 把所有附件打包成ZIP格式，注意不要嵌套文件夹，文件名不要有特殊字符
4. 回到导入页面，先上传填好的Excel，再上传附件ZIP包，点击【开始导入】
5. 导入完成后会显示成功/失败数量，失败的条目可下载错误报告，修改后重新导入即可

第四步：日常使用实操技巧

4.1 档案查询检索

点击左侧【档案管理】，顶部搜索框支持按奖杯名称、获奖时间、颁发单位、获奖等级多维度模糊搜索，点击【高级筛选】可按时间范围、奖项等级、获奖主体做精准筛选，筛选后的结果点击顶部【导出】按钮，可自动生成带附件下载链接的Excel文件。

4.2 多人协作权限配置

如果需要多部门共同管理档案，可按角色配置权限：

• 点击【系统设置】-【用户管理】-【新增用户】
• 可选角色：管理员（所有权限，可修改配置、增删改查档案）、编辑员（仅可增改查档案，无法删除、修改系统配置）、浏览员（仅可查询浏览档案，无法修改任何内容）
• 配置完成后把账号密码和访问地址发给对应人员即可，同一局域网内的用户直接访问你电脑的IP加8080端口即可，比如你电脑IP是192.168.1.100，访问地址就是http://192.168.1.100:8080

4.3 数据备份与恢复

• 自动备份：系统默认每天凌晨2点自动备份全量数据库和附件，备份文件存放在你之前新建的trophy-archive文件夹下的data/backup目录，默认保留最近30天的备份
• 手动备份：点击【系统设置】-【备份与恢复】-【立即备份】，可手动生成全量备份包
• 数据恢复：选择对应时间的备份包，点击【恢复】，等待2分钟即可恢复到对应时间点的数据

常见问题排查

• 部署后打不开http://localhost:8080：先检查Docker Desktop是否正常运行，打开终端输入docker ps，看trophy-web和trophy-db两个容器是否都是Up状态，若不是输入docker-compose restart重启服务即可
• 批量导入失败：先检查Excel必填字段是否有空值，再检查附件ZIP包是否有嵌套文件夹，文件名是否有中文特殊字符
• 外网访问需求：如果需要在外网访问系统，可使用内网穿透工具映射本地8080端口，或者把服务部署到云服务器，操作步骤和本地完全一致