Overview

The household service helps and provides APIs to create households and household members for the HCM. This document provides the configuration details for setting up the household registry.

Pre-requisites

• Knowledge of Java/J2EE (preferably Java 8 version).

• Knowledge of spring boot and spring-boot micro-services.

• Knowledge of Git or any version control system.

• Knowledge of RESTful web services.

• Knowledge of the Lombok library is helpful.

• Knowledge of eGov-mdms service, eGov-persister, eGov-idgen, eGov-indexer, and eGov-user will be helpful.

Functionalities

1. Provides APIs to create, update, delete, and search households.

2. Provides APIs to bulk create, bulk update, and bulk delete households.

3. Provides APIs to create, update, delete, and search household members.

4. Provides APIs to bulk create, bulk update, and bulk delete household members.

Setup details

The source code for a Household is present in the health-campaign-services Git repo. The spring boot application needs the Lombok* extension added to the IDE to load it. Once the application is up and running, the API requests can be posted to the URL and the IDs can be generated.

*In the case of IntelliJ, the plugin can be installed directly. For eclipse, the Lombok jar location has to be added in the eclipse.ini file in this format javaagent:lombok.jar.

API Details

Refer to the Swagger API for YAML file details: Household.yaml

Application.properties file information:

Kafka topics persister configs for eGov persister

household.consumer.bulk.delete.topic=delete-household-bulk-topic
household.consumer.bulk.create.topic=create-household-bulk-topic
household.consumer.bulk.update.topic=update-household-bulk-topic

household.kafka.create.topic=save-household-topic
household.kafka.update.topic=update-household-topic
household.kafka.delete.topic=delete-household-topic

h.kafka.create.topic=save-household-topic
h.kafka.update.topic=update-household-topic

household.member.kafka.create.topic=save-household-member-topic
household.member.kafka.update.topic=update-household-member-topic
household.member.kafka.delete.topic=delete-household-member-topic

household.member.consumer.bulk.create.topic=household-member-consumer-bulk-create-topic
household.member.consumer.bulk.update.topic=household-member-consumer-bulk-update-topic
household.member.consumer.bulk.delete.topic=household-member-consumer-bulk-delete-topic

URLs for the external API references:

• eGov-Individual Service -> egov.individual.host = https://health-dev.digit.org/
• eGvo mdms -> egov.mdms.host = https://health-dev.digit.org/
• eGov -idGen -> egov.idgen.host = https://health-dev.digit.org/
• eGov-User Service -> egov.user.host = https://health-dev.digit.org/

Configuration details

Access MDMS configurations

Action test: URL actions adding

Action-test.json

Access to role-based actions

Persister configuration

Indexer configuration

Database schema

Postman collection