社区医院儿童健康信息管理系统(java)

📋 项目概述

社区医院儿童健康信息管理系统是一个专为社区医院设计的儿童健康档案管理平台，采用前后端分离架构，提供儿童健康信息的录入、查询、统计和管理功能。

核心特性

• ✅ 儿童档案管理 - 完整的儿童健康档案信息管理
• 📊 健康数据统计 - 儿童健康数据的统计分析
• 🏥 就诊记录管理 - 儿童就诊历史记录管理
• 💉 疫苗接种管理 - 疫苗接种计划和记录管理
• 📈 成长曲线追踪 - 儿童身高体重等成长指标追踪
• 👨‍⚕️ 医生工作台 - 医生日常工作管理界面
• 🔐 权限管理 - 基于角色的访问控制
• 📱 响应式设计 - 支持多终端访问

---

🏗️ 项目结构

java版本/
├── backend/                    # 后端服务
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/          # Java源代码
│   │   │   └── resources/     # 配置文件
│   │   └── test/              # 测试代码
│   └── pom.xml                # Maven配置
├── web-java/                  # 前端应用
│   ├── src/
│   │   ├── assets/           # 静态资源
│   │   ├── components/       # Vue组件
│   │   ├── router/           # 路由配置
│   │   ├── stores/           # 状态管理
│   │   └── views/            # 页面视图
│   └── package.json          # 前端依赖
└── children_health.sql       # 数据库脚本

---

🔧 技术栈

后端技术

技术	版本	说明
Spring Boot	3.4.3	核心框架
Java	17	开发语言
MyBatis Plus	3.5.8-001	ORM框架
MySQL	8.0+	数据库
Lombok	1.18.30	简化代码
Hutool	5.8.36	工具类库
JWT	0.12.3	身份认证
SpringDoc	2.4.0	API文档
Knife4j	4.5.0	API文档增强

前端技术

技术	版本	说明
Vue	3.5.13	前端框架
Vite	6.2.4	构建工具
Element Plus	2.9.8	UI组件库
Pinia	3.0.1	状态管理
Vue Router	4.5.0	路由管理
Axios	1.9.0	HTTP客户端
Lodash	4.17.21	工具库

---

🚀 快速开始

环境要求

后端环境：

• JDK 17+
• Maven 3.6+
• MySQL 8.0+

前端环境：

• Node.js 16+
• pnpm 8+ (推荐) 或 npm

安装步骤

1. 数据库配置

# 创建数据库
mysql -u root -p

# 导入数据库脚本
mysql -u root -p < children_health.sql

或使用 Navicat 等工具导入 children_health.sql 文件。

2. 后端配置

修改 backend/src/main/resources/application.yml：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/children_health
    username: root
    password: 你的数据库密码 # 修改为你的密码

3. 启动后端

cd backend

# 使用 Maven 启动
./mvnw spring-boot:run

# 或使用 IDE (IntelliJ IDEA / Eclipse)
# 直接运行主类 ChildrenHealthApplication

后端服务将在 http://localhost:8081 启动

4. 启动前端

cd web-java

# 安装依赖
pnpm install
# 或
npm install

# 启动开发服务器
pnpm dev
# 或
npm run dev

前端应用将在 http://localhost:5173 启动（Vite 默认端口）

5. 访问系统

• 前端地址： http://localhost:5173
• 后端API： http://localhost:8081
• API文档： http://localhost:8081/swagger-ui.html
• Knife4j文档： http://localhost:8081/doc.html

---

📖 功能模块

1. 用户管理模块

• 用户注册与登录
• 用户信息管理
• 角色权限分配
• 密码修改与找回

2. 儿童档案管理

• 儿童基本信息录入
• 家长信息管理
• 档案查询与检索
• 档案信息修改
• 档案导出功能

3. 健康记录管理

• 体检记录管理
• 身高体重记录
• 成长曲线图表
• 健康评估报告

4. 就诊记录管理

• 就诊信息录入
• 诊断记录管理
• 处方管理
• 就诊历史查询

5. 疫苗接种管理

• 疫苗接种计划
• 接种记录管理
• 接种提醒功能
• 接种证明打印

6. 数据统计分析

• 儿童健康数据统计
• 疫苗接种率统计
• 就诊量统计
• 数据可视化图表

7. 系统管理

• 系统参数配置
• 数据字典管理
• 操作日志查询
• 系统监控

---

🔌 API 接口

接口文档访问

系统集成了 SpringDoc 和 Knife4j，提供完善的 API 文档：

• Swagger UI： http://localhost:8081/swagger-ui.html
• Knife4j UI： http://localhost:8081/doc.html

主要接口模块

用户认证接口

POST /api/auth/login          # 用户登录
POST /api/auth/register       # 用户注册
POST /api/auth/logout         # 用户登出
GET  /api/auth/info           # 获取当前用户信息

儿童档案接口

GET    /api/children          # 获取儿童列表
GET    /api/children/{id}     # 获取儿童详情
POST   /api/children          # 创建儿童档案
PUT    /api/children/{id}     # 更新儿童档案
DELETE /api/children/{id}     # 删除儿童档案

健康记录接口

GET    /api/health-records              # 获取健康记录列表
GET    /api/health-records/{id}         # 获取健康记录详情
POST   /api/health-records              # 创建健康记录
PUT    /api/health-records/{id}         # 更新健康记录
DELETE /api/health-records/{id}         # 删除健康记录
GET    /api/health-records/growth/{id}  # 获取成长曲线数据

疫苗接种接口

GET    /api/vaccinations           # 获取接种记录列表
GET    /api/vaccinations/{id}      # 获取接种记录详情
POST   /api/vaccinations           # 创建接种记录
PUT    /api/vaccinations/{id}      # 更新接种记录
DELETE /api/vaccinations/{id}      # 删除接种记录
GET    /api/vaccinations/plan/{id} # 获取接种计划

---

⚙️ 配置说明

后端配置

application.yml 配置项

server:
  port: 8081 # 服务端口

spring:
  application:
    name: children-health # 应用名称

  datasource:
    url: jdbc:mysql://localhost:3306/children_health
    username: root
    password: 你的密码
    driver-class-name: com.mysql.cj.jdbc.Driver

mybatis-plus:
  configuration:
    map-underscore-to-camel-case: true # 驼峰命名转换
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # SQL日志

springdoc:
  api-docs:
    enabled: true # 启用API文档
  swagger-ui:
    path: /swagger-ui.html # Swagger UI路径

前端配置

vite.config.js 配置

export default defineConfig({
  server: {
    port: 5173,                 # 开发服务器端口
    proxy: {
      '/api': {
        target: 'http://localhost:8081',  # 后端API地址
        changeOrigin: true
      }
    }
  }
})

---

🗄️ 数据库设计

主要数据表

表名	说明
sys_user	系统用户表
sys_role	角色表
sys_permission	权限表
children_info	儿童基本信息表
parent_info	家长信息表
health_record	健康记录表
medical_record	就诊记录表
vaccination_record	疫苗接种记录表
vaccination_plan	疫苗接种计划表
growth_record	成长记录表

数据库关系

sys_user (用户) 1:N sys_role (角色)
children_info (儿童) 1:N parent_info (家长)
children_info (儿童) 1:N health_record (健康记录)
children_info (儿童) 1:N medical_record (就诊记录)
children_info (儿童) 1:N vaccination_record (接种记录)
children_info (儿童) 1:N growth_record (成长记录)

---

🐛 常见问题

1. 后端启动失败

问题： 数据库连接失败

解决方案：

• 检查 MySQL 服务是否启动
• 确认数据库名称、用户名、密码是否正确
• 检查数据库是否已创建并导入数据

2. 前端无法访问后端接口

问题： 跨域错误或 404

解决方案：

• 确认后端服务已启动
• 检查前端代理配置是否正确
• 确认后端端口号是否为 8081

3. Maven 依赖下载失败

问题： 依赖下载超时

解决方案：

<!-- 在 pom.xml 中配置阿里云镜像 -->
<repositories>
    <repository>
        <id>aliyun</id>
        <url>https://maven.aliyun.com/repository/public</url>
    </repository>
</repositories>

4. 前端依赖安装失败

问题： npm install 报错

解决方案：

# 清除缓存
npm cache clean --force

# 使用淘宝镜像
npm config set registry https://registry.npmmirror.com

# 或使用 pnpm
npm install -g pnpm
pnpm install

5. API 文档无法访问

问题： Swagger UI 404

解决方案：

• 确认 springdoc.api-docs.enabled=true
• 访问 http://localhost:8081/v3/api-docs 检查 API 文档是否生成
• 清除浏览器缓存重试

---

📝 开发指南

后端开发

1. 创建新的实体类

@Data
@TableName("table_name")
public class Entity {
    @TableId(type = IdType.AUTO)
    private Long id;

    private String name;

    @TableField("create_time")
    private LocalDateTime createTime;
}

2. 创建 Mapper 接口

@Mapper
public interface EntityMapper extends BaseMapper<Entity> {
    // 自定义查询方法
}

3. 创建 Service

@Service
public class EntityService extends ServiceImpl<EntityMapper, Entity> {
    // 业务逻辑
}

4. 创建 Controller

@RestController
@RequestMapping("/api/entity")
@Tag(name = "实体管理", description = "实体相关接口")
public class EntityController {

    @Autowired
    private EntityService entityService;

    @GetMapping
    @Operation(summary = "获取列表")
    public Result<List<Entity>> list() {
        return Result.success(entityService.list());
    }
}

前端开发

1. 创建 API 接口

// src/api/entity.js
import request from "@/utils/request";

export function getEntityList() {
  return request({
    url: "/api/entity",
    method: "get",
  });
}

2. 创建页面组件

<template>
  <div class="entity-container">
    <el-table :data="tableData">
      <el-table-column prop="name" label="名称" />
    </el-table>
  </div>
</template>

<script setup>
import { ref, onMounted } from "vue";
import { getEntityList } from "@/api/entity";

const tableData = ref([]);

onMounted(async () => {
  const { data } = await getEntityList();
  tableData.value = data;
});
</script>

---

🚢 部署指南

后端部署

1. 打包应用

cd backend
./mvnw clean package -DskipTests

生成的 JAR 文件位于 target/ChildrenHealth-1.0.0.jar

2. 运行应用

java -jar target/ChildrenHealth-1.0.0.jar

3. 使用 systemd 管理（Linux）

创建服务文件 /etc/systemd/system/children-health.service：

[Unit]
Description=Children Health Management System
After=network.target

[Service]
Type=simple
User=www-data
WorkingDirectory=/opt/children-health
ExecStart=/usr/bin/java -jar /opt/children-health/ChildrenHealth-1.0.0.jar
Restart=on-failure

[Install]
WantedBy=multi-user.target

启动服务：

sudo systemctl start children-health
sudo systemctl enable children-health

前端部署

1. 构建生产版本

cd web-java
pnpm build

生成的文件位于 dist/ 目录

2. Nginx 配置

server {
    listen 80;
    server_name your-domain.com;

    root /var/www/children-health/dist;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }

    location /api/ {
        proxy_pass http://localhost:8081/api/;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

3. 部署到服务器

# 上传 dist 目录到服务器
scp -r dist/* user@server:/var/www/children-health/dist/

# 重启 Nginx
sudo systemctl restart nginx

---

🔐 安全建议

1. 修改默认密码 - 部署前修改数据库和管理员密码
2. 启用 HTTPS - 生产环境使用 SSL 证书
3. 配置防火墙 - 限制数据库端口访问
4. 定期备份 - 定期备份数据库和重要文件
5. 更新依赖 - 及时更新框架和依赖版本
6. 日志监控 - 配置日志收集和监控系统

---

📚 参考资料

• Spring Boot 官方文档
• MyBatis Plus 官方文档
• Vue 3 官方文档
• Element Plus 官方文档
• Vite 官方文档

---

📄 许可证

MIT License

---

👥 技术支持

如有问题或建议，请通过以下方式联系：

• 提交 Issue
• 发送邮件

---

最后更新时间： 2024年12月

文档版本： v1.0.0

项目版本： v1.0.0