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

项目简介

社区医院儿童健康信息管理系统是一个基于 Spring Boot 3 + Vue 3 的全栈 Web 应用，旨在为社区医院提供儿童健康信息的数字化管理解决方案。系统支持儿童档案管理、健康测评、疫苗预约、在线咨询等核心功能。

技术栈

后端技术

• 框架: Spring Boot 3.4.3
• Java 版本: JDK 17
• 数据库: MySQL 5.7
• ORM 框架: MyBatis-Plus 3.5.8
• API 文档: Knife4j 4.5.0 + SpringDoc OpenAPI 2.4.0
• 认证: JWT (JSON Web Token)
• 工具库: Hutool 5.8.36, Lombok 1.18.30
• 构建工具: Maven

前端技术

• 框架: Vue 3.5.13
• 构建工具: Vite 6.2.4
• UI 组件库: Element Plus 2.9.8
• 状态管理: Pinia 3.0.1
• 路由: Vue Router 4.5.0
• HTTP 客户端: Axios 1.9.0
• 样式: Sass
• 包管理器: pnpm

项目结构

java-ertongjiankang/
├── backend/                    # 后端项目
│   ├── src/
│   │   └── main/
│   │       ├── java/org/sqa/childhealth/
│   │       │   ├── common/            # 公共类（拦截器、响应封装等）
│   │       │   ├── config/            # 配置类
│   │       │   ├── controller/        # 控制器层
│   │       │   ├── dto/               # 数据传输对象
│   │       │   ├── entity/            # 实体类
│   │       │   ├── mapper/            # MyBatis Mapper
│   │       │   ├── service/           # 服务层
│   │       │   ├── util/              # 工具类
│   │       │   ├── vo/                # 视图对象
│   │       │   └── ChildrenHealthApplication.java
│   │       └── resources/
│   │           └── application.yml    # 应用配置
│   ├── pom.xml                        # Maven 配置
│   └── target/
│       └── ChildrenHealth-1.0.0.jar   # 打包后的 JAR 文件
├── web-java/                   # 前端项目
│   ├── src/
│   │   ├── api/               # API 接口
│   │   ├── assets/            # 静态资源
│   │   ├── components/        # 组件
│   │   ├── router/            # 路由配置
│   │   ├── stores/            # 状态管理
│   │   ├── views/             # 页面视图
│   │   ├── App.vue            # 根组件
│   │   └── main.js            # 入口文件
│   ├── public/                # 公共资源
│   ├── dist/                  # 构建输出
│   ├── package.json           # 依赖配置
│   ├── vite.config.js         # Vite 配置
│   └── .env                   # 环境变量
└── childrenHealth.sql         # 数据库脚本

核心功能模块

1. 用户管理

• 用户注册、登录（JWT 认证）
• 角色管理：超级管理员、医生、普通用户
• 用户信息维护

2. 儿童档案管理

• 儿童基本信息录入（姓名、出生日期、性别、身高、体重等）
• 家长信息关联
• 档案查询与更新

3. 健康测评系统

• 问卷管理（创建、编辑、发布）
• 问题与选项配置
• 测评结果记录与分析
• 医生评估与处理意见

4. 疫苗预约管理

• 疫苗预约登记
• 预约状态跟踪
• 医生信息关联

5. 在线咨询

• 用户与医生实时咨询
• 会话管理
• 消息记录

6. 医疗记录

• 就诊记录管理
• 治疗内容与建议
• 医生处理记录

7. 通知公告

• 系统通知发布
• 通知状态管理（草稿/发布）

8. 疾病知识库

• 疾病信息管理
• 症状、治疗方法、预防措施
• 严重程度分级

9. 个性化建议

• 医生为用户提供个性化健康建议
• 复查时间提醒

数据库设计

系统包含以下核心数据表：

• user - 用户表
• doctor_profiles - 医生信息表
• child_profile - 儿童档案表
• child_report - 儿童报告表
• questionnaires - 问卷表
• questionnaire_questions - 问卷问题表
• questionnaire_options - 问卷选项表
• test_results - 测评结果表
• vaccine_appointment - 疫苗预约表
• consultation_sessions - 咨询会话表
• consultation_messages - 咨询消息表
• medical_record - 医疗记录表
• notifications - 通知表
• diseases - 疾病表
• personalized_advice - 个性化建议表

环境要求

后端环境

• JDK 17 或更高版本
• Maven 3.6+
• MySQL 5.7+

前端环境

• Node.js 16+
• pnpm 8+

安装与运行

1. 数据库配置

# 创建数据库并导入数据
mysql -u root -p < childrenHealth.sql

2. 后端配置与启动

# 进入后端目录
cd backend

# 修改 application.yml 中的数据库配置
# spring.datasource.url: jdbc:mysql://localhost:3306/children_health
# spring.datasource.username: your_username
# spring.datasource.password: your_password

# 使用 Maven 编译打包
./mvnw clean package

# 运行项目
java -jar target/ChildrenHealth-1.0.0.jar

# 或者使用 Maven 直接运行
./mvnw spring-boot:run

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

3. 前端配置与启动

# 进入前端目录
cd web-java

# 安装依赖
pnpm install

# 启动开发服务器
pnpm dev

# 构建生产版本
pnpm build

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

API 文档

项目集成了 Knife4j，启动后端服务后可访问：

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

默认账号

根据数据库初始数据，系统预置以下账号：

用户名	密码	角色	说明
admin	123456	超级管理员	系统管理员
张三	123456	普通用户	测试用户
王医生	123456	医生	测试医生
赵医生	123456	医生	测试医生

配置说明

后端配置 (application.yml)

server:
  port: 8081                    # 服务端口

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/children_health
    username: your_username
    password: your_password

mybatis-plus:
  configuration:
    map-underscore-to-camel-case: true
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

前端配置 (.env)

VITE_API_BASE_URL = http://localhost:8081

开发规范

后端

• 遵循 RESTful API 设计规范
• 使用统一的响应格式封装（ResponseData）
• JWT Token 认证机制
• MyBatis-Plus 简化 CRUD 操作
• 使用 Lombok 减少样板代码

前端

• Vue 3 Composition API
• ESLint + Prettier 代码规范
• 组件化开发
• Pinia 状态管理
• Axios 统一请求封装

项目特色

1. 完整的权限体系: 支持多角色权限管理（管理员、医生、用户）
2. 健康测评系统: 灵活的问卷配置，支持自定义问题和选项
3. 在线咨询功能: 用户与医生实时沟通
4. 数据可视化: 儿童健康数据统计与分析
5. API 文档完善: Knife4j 提供友好的接口测试界面
6. 前后端分离: 独立部署，易于扩展

注意事项

1. 首次运行需要先导入数据库脚本 childrenHealth.sql
2. 确保 MySQL 服务已启动
3. 后端需要 JDK 17 环境
4. 前端推荐使用 pnpm 作为包管理器
5. 生产环境部署时需修改数据库连接配置和 JWT 密钥

项目演示

项目包含演示视频：社区医院儿童健康信息管埋系统.mp4

技术支持

如有问题，请查看：

• API 文档: http://localhost:8081/doc.html
• 项目结构图: web-java/功能图.png

许可证

本项目仅供学习交流使用。