Describes a group of individuals and their attendance details.
Screen to update muster roll status based on different roles
Objective: To view and modify the attendance days and perform various actions like verify, reject and approve based on roles.
Users can navigate to this screen by clicking on the muster roll id on the inbox page.
Initially, the muster has 'Submitted' status. Junior Engineer can view, Edit, Verify and Reject the Attendance.
Verify: Clicking on the ‘Verify’ action button verifies the existing muster and the user is redirected to the success page
Edit: Clicking on the ‘Edit’ action button displays the extra details in the table. The working days can be edited. Based on that ‘Modified Amount’ is updated dynamically.
As soon as the user updates anything ‘Action’ button changes to the ‘Save’ button. On click of Save, muster is verified with updated details and the user is redirected to the success page.
Reject: Clicking on the ‘Reject’ action displays a popup where the user can provide any comments and reject the muster.
On 'Confirm Reject', muster will be rejected and the user will be redirected to the success page.
The municipal Engineer can view, Approve, and Reject the attendance which is verified by Junior Engineer
Approve: Clicking on the ‘Approve action displays a popup where the user can provide any comments and approve the muster.
On 'Approve Attendance', the muster will be approved and the user will be redirected to the success page.
The municipal Engineer can also reject the attendance verified by Jr Engineer by clicking on the 'Reject' action.
Modify attendance technical implementation where all actions are handled can be found in the below file.
Hooks used
To update muster (modify, verify, reject, approve, resubmit), ‘useUpdateAttendance’ is used which updated muster roll details.
APIs used
Endpoint:
Sample curl for Update muster API:
Wage seeker skills data is fetched from MDMS using 'getMultipleTypesWithFilter' service.
Localisation keys are added under the ‘rainmaker-attendencemgmt’ locale module. In future, if any new labels are implemented in the attendance module they should also be pushed in the locale DB under rainmaker-attendencemgmt locale module. Below is an example of a few locale labels for Hindi and English.
The content on this screen is rendered based on the configuration passed on ApplicationDetails template component. Its implementation can be found in the below file.
/muster-roll/v1/_update
JUNIOR_ENGINEER
Reject
Send for Approval
Modify/Verify Muster Roll
/muster-roll/v1/_update
MUNICIPAL_ENGINEER
Approve
Reject
Inbox screen for Attendance Management Module
Overview:
Lists all the musters submitted by SHG
To search/filter the muster list based on various criteria
To navigate to Muster details/View Attendance page
The employee home screen will have a link to navigate to the Attendance Inbox screen
The inbox screen consists of a list of muster rolls created/submitted by SHG in tabular format. This table supports pagination and the number of records displayed per page can be editable
A minimum of 1 search criterion is required based on which the list will be populated with search results. Search parameters are as below:
Name of the work
Implementing Agency/Partner
This list can be filtered based on below parameters:
Date range
Muster roll status
A ‘No results found’ message is displayed if no records are found for the given search/filter criteria.
Both search and filter criteria can be cleared using the ‘Clear Search’ and ‘refresh’ buttons respectively. Muster Roll ID is a clickable link that navigates the user to the View Attendance screen (Muster Details).
Inbox screen technical implementation can be found in the file below.
Hooks used
To fetch inbox details, ‘useCustomAPIHook’ is used which takes all the API details like URL, query params and body from config (defined in MDMS).
To fetch inbox config, ‘useCustomMDMS’ hook is used which takes the module name, master details and config.
APIs used
Endpoint:
Sample curl for Inbox API:
Inbox screen config is fetched from MDMS using 'useCustomMDMS' hook.
Localisation keys are added under the ‘rainmaker-attendencemgmt’ locale module. In future, if any new labels are implemented in the attendance module they should be pushed to the locale DB under rainmaker-attendencemgmt locale module. Below is an example of a few locale labels for Hindi and English.
The content on this screen is rendered based on configuration passed via MDMS. Its implementation can be found in the below file.
/inbox/v2/_search
JUNIOR_ENGINEER
View inbox for Muster Rolls
/inbox/v2/_search
MUNICIPAL_ENGINEER
View inbox for Muster Rolls
Screen to view muster roll details for selected muster roll.
Objective:
To view weekly muster roll details/attendance for selected muster roll
To view the workflow history of the muster roll
Users can navigate to this screen by clicking on the muster roll id on the inbox page
The view screen consists of register details on top, Enrolled user details in tabular format, Workflow history and Actions that can be performed on selected muster. Initially, muster has ‘Submitted’ status.
View Attendance screen technical implementation can be found in the below file.
Hooks used
To fetch muster roll details, ‘useViewAttendance’ is used which takes tenant id and muster roll number.
To fetch workflow details, ‘useWorkflowDetails is used which takes tenant id, muster roll number, and business service (muster-roll-approval) as module code and config.
APIs used
Endpoint:
Sample curl for Search muster API:
Wage seeker skills data is fetched from MDMS using 'getMultipleTypesWithFilter' service.
Localisation keys are added under the ‘rainmaker-attendencemgmt’ locale module. In future, if any new labels are implemented in the attendance module they should also be pushed in the locale DB under rainmaker-attendencemgmt locale module. Below is an example of a few locale labels for Hindi and English.
The content on this screen is rendered based on the configuration passed on ApplicationDetails template component. Its implementation can be found in the below file.
/muster-roll/v1/_search
JUNIOR_ENGINEER
View Individual Muster Roll
/muster-roll/v1/_search
MUNICIPAL_ENGINEER
View Individual Muster Roll