Decentralized Health Care Management System

This project is a TypeScript-based application for managing decentralized healthcare processes. It includes various entities such as Patients, Doctors, EHR (Electronic Health Records), Insurance Claims, and Telemedicine Consultations. The application supports key healthcare processes like patient registration, insurance claim processing, prescription management, and more.

Table of Contents

1. Project Overview
2. Features
3. Getting Started
4. Project Structure
5. Configuration Files
6. Running the Application
7. Testing
8. Docker Setup
9. CI/CD
10. Common Issues & Resolution
11. License

Project Overview

The Decentralized Health Care Management System (DHMS) is designed to improve healthcare operations by decentralizing critical healthcare processes. The system allows for secure management of patient data, insurance claims, prescriptions, and telemedicine consultations.

The application is structured using TypeScript and leverages modern development tools and practices, including Jest for testing and Docker for containerization.

Features

• Patient Registration: Efficient management of patient data, including registration and verification.
• Insurance Claim Processing: Handling of insurance claim submissions, verification, and processing.
• Prescription Management: Managing prescriptions issued by doctors and tracking their status.
• Telemedicine Consultations: Facilitates online consultations between patients and doctors.
• Research Data Sharing: Anonymized data sharing for medical research.

Getting Started

To get started with the project, clone the repository and install the dependencies.

Prerequisites

• Node.js (>=14.x)
• npm (for managing dependencies)
• Docker (for containerized deployments, optional)
• TypeScript (>=4.x)

Installation

1. Clone the repository:

   git clone https://github.com/nimk321/decentralized-health-care-management-system.git
   cd decentralized-health-care-management-system

2. Install dependencies:

   npm install

Project Structure

The project is organized as follows:

decentralized-health-care-management-system/
├── .github/
│   └── workflows/
│       └── ci.yml                     # GitHub Actions CI configuration
├── __tests__/                          # Test files
│   ├── Doctor.test.ts                  # Unit tests for Doctor entity
│   ├── EHR.test.ts                     # Unit tests for EHR entity
│   ├── InsuranceClaim.test.ts          # Unit tests for InsuranceClaim entity
│   ├── Patient.test.ts                 # Unit tests for Patient entity
│   ├── Prescription.test.ts            # Unit tests for Prescription entity
│   └── TelemedicineConsultation.test.ts # Unit tests for TelemedicineConsultation entity
├── docker/                             # Docker configuration
│   ├── .dockerignore                   # Files to ignore during Docker image build
│   └── Dockerfile                      # Dockerfile for creating Docker image
├── src/                                # Source files for the project
│   ├── entities/                       # Entity classes for the project
│   │   ├── Doctor.ts                   # Doctor entity definition
│   │   ├── EHR.ts                      # EHR (Electronic Health Record) entity definition
│   │   ├── InsuranceClaim.ts           # InsuranceClaim entity definition
│   │   ├── Patient.ts                  # Patient entity definition
│   │   ├── Prescription.ts             # Prescription entity definition
│   │   └── TelemedicineConsultation.ts # TelemedicineConsultation entity definition
│   ├── functions/                      # Business logic functions for healthcare processes
│   │   ├── InsuranceClaimProcessing.ts # Logic for processing insurance claims
│   │   ├── PatientRegistration.ts      # Logic for patient registration
│   │   ├── PrescriptionManagement.ts   # Logic for managing prescriptions
│   │   ├── ResearchDataSharing.ts      # Logic for sharing research data
│   │   └── TelemedicineConsultation.ts # Logic for handling telemedicine consultations
│   ├── index.ts                        # Main entry point for the application
├── .gitignore                          # Git ignore file for the repository
├── ISSUE_RESOLUTION.md                 # Troubleshooting guide for common issues
├── README.md                           # Project overview and documentation
├── index.html                          # Index HTML file (if applicable, for front-end)
├── package-lock.json                   # npm lock file for project dependencies
├── package.json                        # npm package configuration and dependencies
└── tsconfig.json                       # TypeScript configuration file

Configuration Files

• .gitignore: Specifies which files and directories should be ignored by Git, including node_modules, build outputs, and environment files.
• tsconfig.json: Configures TypeScript compilation options. It sets module to commonjs and enables strict type checking.
• package.json: Contains the project's dependencies, scripts, and metadata.
• ci.yml: Defines the CI pipeline using GitHub Actions. It runs tests on every push or pull request to the main branch.

Running the Application

1. Compile TypeScript files:

   npx tsc

2. Start the application:

   npm start

Testing

This project uses Jest for testing. To run the tests:

1. Run the tests using npm:

   npm test

Test results will be displayed in the console.

CI/CD

This project uses GitHub Actions for continuous integration and deployment (CI/CD). The ci.yml file in the .github/workflows/ directory defines the CI pipeline, which runs on every push or pull request to the main branch. It installs dependencies, runs tests, and deploys the application to production if tests pass.

Common Issues & Resolution

For troubleshooting common issues, refer to the ISSUE_RESOLUTION.md file, which includes solutions for issues related to TypeScript compilation, module imports, Node.js environment, Docker, testing, and dependency errors.

License

This project is licensed under the MIT License. See the LICENSE file for more details.