Attendance (CBO Application)

Overview

This module helps in logging the attendance of each individual in a register and creating the muster roll for a particular week.

ROLE: ORG_ADMIN

This module has 2 associated screens: View Register Inbox Track Attendance Table Screen

MDMS Configurations

S.No.	Data	MDMS Link
1	AttendanceHours	Attendance Hours
2	WageSeekerSkills	Wage Seeker Skills
3	CBOMusterSubmission	Muster Roll Submission

User Actions

This page involves several actions:

1. The CBO Admin selects a date range using the Date Picker.

2. Upon selecting a date, the entire week is automatically chosen.

3. After selecting the week, by clicking "Apply," the pre-saved attendance log for that week becomes visible.

4. The user can then modify the attendance log for each individual and save it as a draft using the "Save as Draft" button.

5. The user can also submit the muster roll. Upon submission, the user will be prompted to enter skills for each individual.

6. After entering skills, the user can submit the muster roll for that specific week.

Validations:

• If no date range is selected or cleared, attempting to use the "Save as Draft" button will display an error, prompting the user to select a date range.

• The ability to submit the muster roll depends on the CBOMusterSubmission MDMS Config.

isEndOfWeek && selectedDateRange!.endDate > DateTime.now().millisecondsSinceEpoch


code": "END_OF_WEEK",            "value": "end of week",            "active": false

Depending on the value of END_OF_WEEK:

1. If END_OF_WEEK is false, users can create the muster roll on any day of the week.

2. If END_OF_WEEK is true, users can submit the muster roll only on or after the last day of the week (Sunday).

If an existing muster roll for the selected range is in a workflow state, the Track Attendance page will be a view-only page. Otherwise, users will be able to log attendance and submit the muster roll.

The options for marking attendance are determined by the Attendance Hours list:

• If the list contains two options, users can mark attendance as Full Day or Absent.

• If the list has more than two options, users can mark attendance as Full Day, Half Day, or Absent.

API Details

S.No.	API	Body/Query Params	Description
1	attendance/v1/_search	{ "tenantId":””, "ids":”” }	Gives the list of registers linked to the org
2	muster-roll/v1/_estimate	{ "musterRoll": { "tenantId":, "registerId":, "startDate":, "endDate": } }	To get the attendance log for the selected Date range
3	attendance/log/v1/_create	{"attendance": []}	To log the attendance of the individuals for the week
4	attendance/log/v1/_update		To update the attendance log of the individuals for Sent Back To CBO Muster Rolls
5	muster-roll/v1/_search		To check if any existing muster rolls present for the selected week
6	egov-workflow-v2/egov-wf/businessservice/_search	{ "tenantId":, "businessServices": “musterRollId”, }	To check the workflow status of the Muster Roll

Sidebar Configuration

<details>

DIGIT Components & Custom Components Used

S.No.	Component	Path	Description
1	DigitTable	DigitTable.dart	Custom Table with fixed first column and other columns scrollable
2	DropDownDialog	DropDownDialog	A dialog with dropdown options
3	DateRangePicker	DateRangePicker	A custom Date Range picker to select a range of the month / year
4	DigitElevatedButton	DigitElevatedButton	An Elevated Submit Button
6	WorkDetailsCard	DetailsCard	Details Card based on DIGIT Figma design

Localization Configuration & Modules

TenantID	Module
pg	rainmaker-common
pg	rainmaker-attendance
pg	rainmaker-common-masters
pg	rainmaker-workflow
pg.citya	rainmaker-pg.citya

Reference Files/Links

1. Blocs:

   • Search Registers
   • Search Individual Register
   • Attendance Create Log Bloc
   • Muster Search With From and To Date Bloc
   • Get Muster Roll Workflow Bloc
   • Muster Get Attendance Log Bloc
   • Create and Update Muster Roll Bloc
2. Models:

   • Attendance register Model
   • Estimate Muster Roll Model
   • Search Muster Roll Model
   • Muster Workflow model
3. Repositories:

   • Attendance Register Repo
   • Muster Roll Repo
   • Workflow Repo
4. Screens:

   • Register Inbox Screen
   • Track Attendance Screen