Health and Wellness Centre (HWC) API Module

Health and Wellness centre (HWC) is one of the comprehensive applications of AMRIT designed to capture details of 7 Service packages as per guidelines which should be available at Health and Wellness centre.

Primary Features

• Provide medical advice and services to beneficiaries
• Out patient service
• Video consultation with specialists doctors
• Drug dispense and laboratory facility available at centre
• More than 20 lab tests can be performed using IOT devices and data flows directly to AMRIT
• Compliance with all 3 milestones of ABDM
• SnomedCT, LOINC, ICD -10, FHIR compatible

Patient Visit Category

• Ante natal care (ANC)
• Post natal care (PNC)
• Neonatal and infant health care services
• Childhood and adolescent health care services including immunisation
• Family planning, contraceptive services and other reproductive health care
• Care for acute simple illnesses and minor ailments
• Management of communicable diseases
• National health programs (General OPD)
• Prevention, screening and management of non communicable diseases (NCD)

Building From Source

This microservice is built on Java, Spring boot framework and MySQL DB.

Pre-requisites

• JDK 17 Oracle website or use an open-source JDK like OpenJDK
• Spring Tool Suite 3 / Eclipse(2023-03)
• Maven Apache Maven website.
• Redis-x64-3.0.504
• MySQL Workbench 8.0
• Node.js (v14 or later)
• npm (comes with Node.js)

Creating a build configuration in STS / Eclipse

1. You can copy common_example.properties to common_local.properties and edit the file accordingly. The file is under src/main/environment folder.
2. In your editor, click on Run -> Run configuration.
3. Double-click on Maven build and give a suitable name for the new configuration.
4. Populate the base directory by clicking on workspace and selecting HWC-API module.
5. Set goals to clean install -DENV_VAR=local(your choice of desired environment) and click on Apply.
6. It is advisable have a personal environment properties file under src/main/environment filling out all the placeholders to avoid repetitive manual work each time you run locally.
7. Click Run to run the build configuration.

Creating a run configuration in STS / Eclipse

• In your editor, click on Run -> Run configuration.
• Double click on Spring Boot App(in STS) / Java Application(in Eclipse) and give a suitable name for the new configuration.
• Select the project and main class and click on Apply.
• Click Run to run the configuration. Keep the Redis server open during this run.
• Once the run is complete, load http://localhost:8080/swagger-ui.html#!/

How to Import, Build, and Run Maven Code in Visual Studio Code

1. Install Visual Studio Code: Download and install Visual Studio Code from the official website.

2. Install Visual Studio Code Extensions:

   • Java Extension Pack: Open Visual Studio Code, go to the Extensions view by clicking on the Extensions icon in the Activity Bar, and search for "Java Extension Pack." Install it to get Java support and Maven integration.

3. Open the Project in Visual Studio Code:

   • Launch Visual Studio Code and open your folder in the editor.

4. Configure Java and Maven:

   • If not already configured, set up your Java Home and Maven Home in Visual Studio Code.
   • Go to File > Preferences > Settings, search for "Java Home" and "Maven Home," and specify the paths to your JDK and Maven installations.

5. Build and Run:

   • Navigate to your project directory using the cd command.
   • Use Maven commands like mvn clean install to build your project.
   • To run your Java application, use mvn spring-boot:run. Ensure the redis server is open during run.

DB restoration

blank_db_zip

Integrations

• Video Consultation

Usage

All features have been exposed as REST endpoints. Refer to the SWAGGER API specification for details.

Setting Up Commit Hooks

This project uses Git hooks to enforce consistent code quality and commit message standards. Even though this is a Java project, the hooks are powered by Node.js. Follow these steps to set up the hooks locally:

Setup Steps

1. Install Node.js and npm

   • Download and install from nodejs.org
   • Verify installation with:

     node --version
     npm --version
     

2. Install dependencies

   • From the project root directory, run:

     npm install
     npm ci
     

   • This will install all required dependencies including Husky and commitlint

3. Verify hooks installation

   • The hooks should be automatically installed by Husky
   • You can verify by checking if the .husky directory contains executable hooks

Commit Message Convention

This project follows a specific commit message format:

• Format: type(scope): subject
• Example: feat(login): add remember me functionality

Types include:

• feat: A new feature
• fix: A bug fix
• docs: Documentation changes
• style: Code style changes (formatting, etc.)
• refactor: Code changes that neither fix bugs nor add features
• perf: Performance improvements
• test: Adding or fixing tests
• build: Changes to build process or tools
• ci: Changes to CI configuration
• chore: Other changes (e.g., maintenance tasks, dependencies)

Your commit messages will be automatically validated when you commit, ensuring project consistency.

Filing Issues

If you encounter any issues, bugs, or have feature requests, please file them in the main AMRIT repository. Centralizing all feedback helps us streamline improvements and address concerns efficiently.

Join Our Community

We’d love to have you join our community discussions and get real-time support!
Join our Discord server to connect with contributors, ask questions, and stay updated.