Phần mềm Quản Lý Y Tế Học Đường

Phần mềm Quản Lý Y Tế Học Đường được xây dựng nhằm hỗ trợ phòng y tế của một trường học trong việc quản lý hồ sơ sức khỏe, tiêm chủng, thuốc & vật tư y tế, cũng như xử lý và báo cáo các sự kiện y tế xảy ra với học sinh. Ứng dụng gồm:

• Backend: Spring Boot (Java 17) – cung cấp RESTful API, truy cập dữ liệu qua Spring Data JPA, đóng gói bằng Docker.
• Frontend: React 18 – giao diện người dùng đơn trang (SPA) sử dụng SCSS.
• Database: MySQL (chạy kèm Docker).
• CI/CD: Maven build, docker-compose orchestration.

graph LR
    subgraph Client
        Users("
            <b>Người dùng</b><br>
            - Phụ huynh<br>
            - Nhân viên y tế<br>
            - Quản trị viên<br>
            - Học Sinh
        ")
    end

    subgraph "Frontend (React)"
        WebApp[React SPA]
    end

    subgraph "Backend (Spring Boot)"
        Controllers[REST Controllers] --> Services[Business Services]
        Services --> Repositories[JPA Repositories]
    end

    subgraph "Database"
        DB[(MySQL)]
    end

    Users -- "Trình duyệt web" --> WebApp
    WebApp -- "API Calls (REST/JSON)" --> Controllers
    Repositories -- JPA --> DB

1. Trang chủ thông tin & blog sức khỏe học đường.
2. Khai báo Hồ sơ sức khỏe học sinh (dị ứng, bệnh nền, tiêm chủng…).
3. Phụ huynh gửi thuốc cho học sinh, y tế tiếp nhận & ghi log.
4. Nhân viên y tế ghi nhận sự kiện y tế (tai nạn, sốt, dịch bệnh…).
5. Quản lý thuốc & vật tư y tế.
6. Quản lý quy trình tiêm chủng tại trường.
7. Quản lý khám sức khỏe định kỳ.
8. Hệ thống Dashboard & Báo cáo.
9. Quản lý người dùng & phân quyền (Admin, Nurse, Parent, Student…).

# 1. Clone source
$ git clone <repo> && cd project-java

# 2. Khởi chạy backend + database
$ cd backend
$ docker-compose up -d     # MySQL + app container

# 3. Chạy frontend
$ cd ../frontend
$ npm install
$ npm start               # http://localhost:3000

Thông tin kết nối DB được cấu hình trong backend/src/main/resources/application.properties.

1. Phụ huynh đăng ký tài khoản → đăng nhập → Khai báo hồ sơ sức khỏe → Gửi thuốc → Nhận thông báo tiêm chủng/khám sức khỏe và xác nhận → Xem kết quả & lịch sử.
2. Nhân viên y tế đăng nhập → Dashboard → Xem danh sách học sinh → Ghi nhận sự kiện y tế → Cập nhật kho thuốc → Thực hiện và ghi nhận tiêm chủng/khám sức khỏe → Xuất báo cáo.
3. Quản trị viên quản lý người dùng, blog, danh mục thuốc/vật tư.

• Controller: AuthController – /api/auth/*
• Service: AuthService – JWT, BCrypt.
• Entity: User, enum Role.
• Flow:

sequenceDiagram
    participant U as User
    participant FE as Frontend
    participant BE as AuthController
    U->>FE: Đăng nhập (email, password)
    FE->>BE: POST /login
    BE->>BE: Xác thực & sinh JWT
    BE-->>FE: 200 OK + JWT
    FE->>U: Lưu token & chuyển trang

• Entity: HealthProfile, HealthIncident, HealthCheckResult.
• Controller: HealthProfileController.
• Service: HealthProfileService.

flowchart LR
    P[Phụ huynh] -->|Form JSON| FE_HP
    FE_HP -->|POST /health-profiles| BE_HP[HealthProfileController]
    BE_HP --> Service
    Service --> DB

Entity MedicalSupply, Controller MedicalSupplyController, Service MedicalSupplyService. Các yêu cầu CRUD và thống kê xuất/nhập kho.

Entity HealthIncident, enum IncidentStatus. Luồng:

1. Nurse tạo sự kiện.
2. Ghi nhận thuốc/vật tư sử dụng (IncidentSupplyUsage).
3. Cập nhật trạng thái & gửi thông báo.

flowchart TD
    N[Nurse] -->|Tạo lịch| VS[VaccinationSchedule]
    VS -->|Gửi phiếu| P[Parent]
    P -->|Đồng ý/Không| VS
    VS -->|Danh sách học sinh| N
    N -->|Tiêm & ghi nhận| VS
    VS -->|Theo dõi sau tiêm| P

Tương tự 5.5 nhưng sử dụng HealthCampaign với CampainType.PERIODIC_CHECK.

Truy vấn tổng hợp qua Repository, hiển thị biểu đồ (Chart.js) trên frontend.

• Directory backend: controller/, service/, repository/, entity/, enums/, exception/.
• REST naming theo chuẩn /api/<resource>.
• Coding Style: Google Java Style; ESLint + Prettier cho React.
• Branching: main, feature/*, bugfix/*, PR review bắt buộc ≥1.
• Issue tracker: GitHub Projects.
• Test: JUnit 5, React Testing Library.

© 2024 School HealthCare Management – Version 0.9.0