Attendance

Overview

The attendance service provides generic attendance logging functionality for recording "in" and "out" timestamps for individuals. These timestamps are logged on a per-individual basis. The muster roll service takes on the responsibility of aggregating and calculating attendance based on these recorded timestamps. It processes and computes attendance data using these individual "in" and "out" timestamps to provide a comprehensive view of attendance records.

Pre-requisites

A running DIGIT platform is needed to deploy the attendance service. Specifically, the following dependencies are needed:

  • Individual

  • MDMS

  • Idgen

  • Persister

  • Indexer

Functionality

Provides APIs to:

  • Create an attendance register

  • Map staff to the register

  • Map attendees to the register

  • Log attendance

  • Edit attendance registers, staff, attendees and attendance.

Code

Module code

Base URL: /attendance/v1/

Deployment Details

Below are the variables that should be configured for the contract service in the Helm environment file before deployment. The below path is used to locate the Helm environment file.

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

Refer to the sample here.

Restart egov-mdms-service, egov-persister, egov-indexer, inbox, egov-workflow-v2, egov-accesscontrol and ZUUL services after the above changes are performed.

Configuration Details

Configure Actions

Add all the APIs exposed by the attendance service (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

RolesAPIs /Actions
  • ORG_ADMIN

  • JUNIOR_ENGINEER

  • MUNICIPAL_ENGINEER

/attendance/v1/_create

  • ORG_ADMIN

  • JUNIOR_ENGINEER

  • MUNICIPAL_ENGINEER

/attendance/v1/_update

  • ORG_ADMIN

  • JUNIOR_ENGINEER

  • MUNICIPAL_ENGINEER

/attendance/v1/_search

  • ORG_ADMIN

  • ORG_STAFF

/attendance/staff/v1/_create

  • ORG_ADMIN

  • ORG_STAFF

/attendance/staff/v1/_delete

  • ORG_ADMIN

  • ORG_STAFF

/attendance/attendee/v1/_create

  • ORG_ADMIN

  • ORG_STAFF

/attendance/attendee/v1/_delete

  • ORG_ADMIN

  • ORG_STAFF

/attendance/log/v1/_create

  • ORG_ADMIN

  • ORG_STAFF

/attendance/log/v1/_search

  • ORG_ADMIN

  • ORG_STAFF

/attendance/log/v1/_update

Idgen Configuration

Make sure the id format is configured in the IdFormat.json file of the common-masters module in MDMS.

IDGen format for attendance register number

{

"format": "WR/[fy:yyyy-yy]/[cy:MM]/[cy:dd]/[SEQ_ATTENDANCE_REGISTER_NUM]",

"idname": "attendance.register.number"

}

Persister

Make sure that the file attendance-service-persister.yml is present in the MDMS repository of the organisation: https://github.com/{{ORG}}/works-configs/tree/<BRANCH>/egov-persister

Integration Details

Base Path:

/attendance/

API spec

Sample postman collections are here to demonstrate integration with the attendance service.

Last updated

All content on this page by eGov Foundation is licensed under a Creative Commons Attribution 4.0 International License.