Healthcare Connect là một hệ thống Telemedicine toàn diện, kết nối trực tiếp Bệnh nhân, Bác sĩ và Cơ sở y tế.
Giới thiệu
Healthcare Connect là hệ thống hỗ trợ kết nối giữa:
Bệnh nhân: Tìm kiếm bác sĩ, đặt lịch khám, thanh toán và quản lý hồ sơ sức khỏe cá nhân.
Bác sĩ: Quản lý lịch hẹn, thực hiện tư vấn và cập nhật bệnh án điện tử cho bệnh nhân.
Lễ tân: Tiếp đón, đặt lịch và thực hiện check-in cho bệnh nhân tại quầy và điều phối luồng khám bệnh.
Quản lý bệnh viện: Quản lý danh sách bác sĩ, chuyên khoa và theo dõi báo cáo doanh thu, hiệu suất.
Admin: Kiểm duyệt toàn bộ cơ sở y tế, cấu hình hệ thống và giám sát hoạt động qua Audit Log.
Thông qua:
Đặt lịch khám online: Tìm kiếm bác sĩ theo chuyên khoa, giá khám và khung giờ trống. Tự động khóa slot khám khi đang xử lý thanh toán để tránh đặt trùng lịch (Race Condition).
Check in lịch khám: Lễ tân xác thực mã lịch hẹn và đổi trạng thái sang "Chờ khám" ngay khi bệnh nhân có mặt tại bệnh viện. Tự động thông báo đến bác sĩ thông qua hệ thống để chuẩn bị tiếp nhận ca khám.
Quản lý bệnh án điện tử: Lưu trữ lịch sử khám bệnh, đơn thuốc, kết quả xét nghiệm và ghi chú của bác sĩ một cách bảo mật. Cho phép bệnh nhân tra cứu lịch sử bệnh lý mọi lúc mọi nơi trên nền tảng.
Thanh toán/hoàn tiền trực tuyến: Tích hợp cổng thanh toán MoMo, xử lý giao dịch tự động 24/7. Cơ chế hoàn tiền: Tự động tính toán tỷ lệ hoàn tiền (ví dụ: 100%, 50%) dựa trên thời điểm bệnh nhân yêu cầu hủy lịch so với giờ khám.
Theo dõi lịch khám realtime: Sử dụng WebSocket để cập nhật trạng thái thanh toán và số thứ tự khám hiện tại theo thời gian thực.
Chức năng chính của những role
PATIENT
Đặt lịch khám online
Tìm kiếm bác sĩ theo chuyên khoa, giá khám và thời gian trống
Thanh toán trực tuyến qua MoMo
Theo dõi trạng thái thanh toán realtime
Hủy lịch và hoàn tiền tự động
Quản lý hồ sơ sức khỏe điện tử
Xem lịch sử khám bệnh và toa thuốc
Nhận email/thông báo nhắc lịch khám
Đánh giá bác sĩ sau khi khám
DOCTOR
Đăng ký bác sĩ và cập nhật hồ sơ chuyên môn
Upload chứng chỉ hành nghề
Quản lý lịch khám và thời gian làm việc
Theo dõi danh sách bệnh nhân
Tư vấn và cập nhật bệnh án điện tử
Kê toa thuốc và ghi chú điều trị
Theo dõi đánh giá từ bệnh nhân
Xem thống kê hiệu suất khám bệnh
Quản lý trạng thái lịch hẹn
Xem lịch sử tư vấn và điều trị
RECEPTIONIST
Đăng ký lễ tân và cập nhật hồ sơ chuyên môn
Xác nhận check-in bệnh nhân
Hỗ trợ tạo lịch khám trực tiếp tại quầy
Quản lý hàng đợi khám bệnh
Cập nhật trạng thái lịch hẹn
Kiểm tra thanh toán của bệnh nhân
Hỗ trợ bệnh nhân hủy hoặc đổi lịch
In thông tin lịch khám
Quản lý danh sách bệnh nhân trong ngày
Hỗ trợ hướng dẫn bệnh nhân
HOSPITAL MANAGER
Duyệt hồ sơ bác sĩ/lễ tân
Quản lý chuyên khoa và dịch vụ y tế
Quản lý danh sách bác sĩ thuộc bệnh viện
Theo dõi doanh thu bệnh viện
Xem thống kê số lượng ca khám
Theo dõi hiệu suất bác sĩ
Quản lý lịch làm việc bác sĩ
Quản lý giá khám và phí dịch vụ
Theo dõi báo cáo hoạt động bệnh viện
ADMIN
Quản lý toàn bộ hệ thống
Kiểm duyệt tài khoản Manager và Doctor
Quản lý cấu hình hệ thống
Theo dõi Audit Log
Quản lý trạng thái bảo trì hệ thống
Quản lý phân quyền và role
Theo dõi thống kê hệ thống
Kiểm soát dữ liệu và nội dung hệ thống
XEM THÊM ==> Hướng dẫn cài đặt chi tiết
Nguồn: Sharecode.vn
***LƯU Ý***
- MỞ FILE application-local.properties cấu hình lại các tài khoản mail, database, rabbitMQ, ...
**DỮ LIỆU MOCK**
- Dữ liệu ở các trang thống kê, dashboard là MOCK
- Để dùng dữ liệu thật, tìm và sửa các file sau:
| File | Flag cần sửa |
|------|--------------|
| `shared/mock/doctorStatisticsMock.ts` | `USE_MOCK_DOCTOR_STATS = false` |
| `shared/mock/adminMock.ts` | `USE_MOCK_ADMIN = false` |
| `shared/mock/managerMock.ts` | `USE_MOCK_MANAGER = false` |
| `shared/mock/receptionistMock.ts` | `USE_MOCK = false` |
| `shared/mock/statisticsMock.ts` | `USE_MOCK_STATISTICS = false` |
| `shared/mock/statisticsMock.ts` | `USE_MOCK_DATA = false` |
**DỮ LIỆU INSERT Ở data.sql**
- Dữ liệu mẫu trong data.sql không chính xác để test
- Nên tự tạo dữ liệu thủ công để test ổn định
====Chạy FRONTEND(Visual Studio Code)====
1. cd healthcare-connect-frontend
2. npm install
3. npm run dev
====DATABASE(POSTGRES)====
1. Tải postgres 16
2. Tạo tài khoản postgres
3. nhập thông tin vào application-local.properties
DB_HOST=localhost
DB_PORT=5432
DB_NAME=healthcare_db
DB_USERNAME=postgres
DB_PASSWORD=mật khẩu
====Chạy BACKEND(Intellij idea)====
***NOTE SỬA ĐƯỜNG DẪN Ở application-local.properties theo npm run dev -- --host # ================= FRONTEND & CORS =================
1. cd healthcare-connect-backend
2. Cài đặt JDK 17: https://adoptium.net/
3. Tải Docker Desktop: https://docs.docker.com/get-started/get-docker/
3. docker run -d --name rabbitmq -e RABBITMQ_DEFAULT_USER={RABBIT_USERNAME} -e RABBITMQ_DEFAULT_PASS='{RABBIT_PASSWORD}' -p 5672:5672 -p 15672:15672 rabbitmq:3-management
*Note: {RABBIT_USERNAME} VÀ {RABBIT_PASSWORD} khớp với thông tin ở application-local.properties
4. Run
===Cấu hình MOMO để test thanh toán===
1. Cài ngrok
# Bước 1: Tải ngrok
# Vào https://ngrok.com/download tải file phù hợp
# Bước 2: Giải nén và đặt vào PATH (hoặc chạy từ thư mục hiện tại)
# Bước 3: Đăng ký tài khoản và lấy token tại dashboard
# Bước 4: Đăng nhập
ngrok config add-authtoken YOUR_TOKEN
# Bước 5: Chạy ở
ngrok http 8080
2. download Momo uat: https://developers.momo.vn/v3/download/