妇幼保健院档案管理系统零基础快速搭建实操技术指南

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

所需工具均为免费开源，直接复制对应命令/链接操作即可：

• 安装Docker（全平台）：
  • Linux：执行命令 curl -fsSL https://get.docker.com | bash
  • Windows：打开 https://desktop.docker.com/win/stable/Docker%20Desktop%20Installer.exe 下载安装，安装后重启生效
  • Mac：打开 https://desktop.docker.com/mac/stable/Docker.dmg 下载安装
  核心操作：安装完成后执行 docker --version，出现版本号则安装成功
• 安装Git（拉取系统依赖）：
  • Linux：Debian系执行 apt install git -y，CentOS系执行 yum install git -y
  • Windows/Mac：随Docker Desktop自动安装，无需额外操作

二、系统部署实操（5分钟完成，零代码）

1. 创建数据存储目录

执行命令生成档案数据、数据库文件的专属目录（避免重装系统丢失数据）：

mkdir -p ~/medical-archive/{mysql,app}

操作说明：该命令会在用户主目录下生成medical-archive文件夹，内含两个核心子文件夹，分别存储数据库和系统代码

2. 编写部署配置文件

进入medical-archive文件夹，新建docker-compose.yml文件，直接复制以下完整内容（无需修改任何参数，新手可直接使用）：

``` version: '3.8' services: archive-web: image: zhouquanbao/medical-archive:v1.0 ports: - "8080:80" volumes: - ./app:/var/www/html environment: - DB_HOST=archive-mysql - DB_PORT=3306 - DB_DATABASE=妇幼档案 - DB_USER=root - DB_PASSWORD=ybjy123456 depends_on: - archive-mysql archive-mysql: image: mysql:5.7 volumes: - ./mysql:/var/lib/mysql environment: - MYSQL_ROOT_PASSWORD=ybjy123456 - MYSQL_DATABASE=妇幼档案 command: --default-authentication-plugin=mysql_native_password ```

配置说明：已设置默认访问端口8080、数据库密码ybjy123456，适配妇幼场景的档案存储需求

3. 启动系统服务

在medical-archive文件夹下执行启动命令：

docker-compose up -d

启动验证：执行 docker ps，能看到archive-web和archive-mysql两个容器，状态显示Up则启动成功

三、核心功能实操（医护人员直接上手）

打开浏览器输入http://localhost:8080，使用默认账号密码登录：账号admin，密码admin123

1. 档案录入

点击左侧菜单「新增档案」，页面显示必填带字段：姓名、年龄、孕周、检查日期、检查项目、检查结果，填写后点击「保存」即可，所有带字段未填会提交失败

2. 档案查询

在顶部搜索框输入姓名或孕周，点击「查询」，系统自动筛选匹配的档案记录，支持模糊查询，无需复杂条件筛选，适配医护快速找档需求

3. 档案导出

点击左侧菜单「档案导出」，系统自动生成CSV格式的标准妇幼档案清单，直接点击「下载」即可保存到本地，导出内容包含所有录入字段，无需额外插件

四、系统日常维护（每月10分钟）

1. 数据备份

执行命令生成带日期的备份文件（自动存储到用户主目录）：

docker exec -it $(docker ps -q -f name=archive-mysql) mysqldump -uroot -pybjy123456 "妇幼档案" > ~/archive_backup_$(date +%Y%m%d).sql

备份说明：文件命名格式为archive_backup_年月日.sql，方便后续快速查找和恢复

2. 系统更新

新版本发布时执行以下命令自动更新（无需手动修改代码）：

cd ~/medical-archive && docker-compose down && docker-compose pull && docker-compose up -d

五、常见问题快速解决

• 无法访问系统：检查Docker是否启动（Windows/Mac打开Docker Desktop，Linux执行systemctl status docker），再检查端口占用：执行netstat -tulpn | grep 8080，若被占用，修改docker-compose.yml的端口为未被占用的数值（如8081）
• 档案保存失败：确认所有带字段已填写，且docker-compose.yml里的数据库密码与配置文件一致
• 备份失败：查看docker ps获取archive-mysql的容器ID，替换命令中$(docker ps -q -f name=archive-mysql)为实际容器ID后重新执行