Expense calculator

The expense calculator is an implementation-specific service that works in tandem with the expense service. This service holds all the specific business logic in computing expenses and calls the billing service with the correct payload to create a bill. Once the bill is generated Excel and Pdf are generated by the calculator service.

There are three types of bills in HCM:

• Wage bill - generated from an approved muster roll and to be paid to wage seekers on completion of work

Dependency

• DIGIT backbone services

• Persister

• MDMS

• Attendance

• Muster roll

• Project

• Individual

• Expense

• Localization

• PdfService

• Filestore

Functionality

Calculate api: This API fetches the attendance registers and creates calculates the amount to be paid based on the rates and roles present in MDMS and individual skills respectively.

Deployment Details

Here is a list of variables that needs to be configured in the Helm environment file before deploying the muster roll service. This file can typically be found under a specific directory or location as given below:

https://github.com/{{ORG}}/DIGIT-DevOps/deploy-as-code/helm/environments/{{EnvironmentFile}}.yaml

Refer to the sample here.

• Add these ‘db-host’,’db-name’,’db-url’, ’domain’ and all the digit core platform services configurations (Idgen, workflow, user etc.) in respective environments yaml file.

• Add expense-calculator related environment variables’ value like the way it's done in the ‘dev’ environment yaml file.

  • https://github.com/egovernments/DIGIT-DevOps/blob/47594728968d9551990b0da81294f7898aceada2/deploy-as-code/helm/environments/unified-health-qa.yaml#L167

  • https://github.com/egovernments/DIGIT-DevOps/blob/07bdd11e0c91053cb434cd2a79f785e59e2785c8/deploy-as-code/helm/environments/unified-health-qa.yaml#L345-L353

  • https://github.com/egovernments/DIGIT-DevOps/tree/07bdd11e0c91053cb434cd2a79f785e59e2785c8/deploy-as-code/helm/charts/health-services/health-expense-calculator

• environment secret YAML file as per the steps outlined here.

• Make sure to add the digit core services-related secrets that are configured in the respective environment secret file as per the steps outlined here.

Configuration Details

Configure Actions

Add all the APIs exposed (refer to the table below for actual APIs) to the actions.json file in MDMS

Module name: ACCESSCONTROL-ACTIONS-TEST

Master name: actions-test

Configure Roles

Configure roles based on the roles column below in roles.json file.

Module name: ACCESSCONTROL-ROLES

Master name: roles

Configure Role-Action

Role-action mapping is configured in MDMS per the table below.

Module name: ACCESSCONTROL-ROLEACTIONS

Master name: roleactions.json

Roles	API Endpoints
CAMPAIGN_SUPERVISOR	/health-expense-calculator/v1/_calculator

Other masters to be added

Other muster roll masters are configured in the common-masters folder:

workerRates.json