Overview

This module helps in processing muster rolls through the workflow. Muster rolls created from SHG app end up in the web interface for workflow approval.

This module has 5 associated screens :

1. Inbox

2. Edit

3. View

4. Search

Module enablement configuration

1. Set module code as "AttendenceMgmt" in Module.js of AttendenceMgmt Module. Refer https://github.com/egovernments/works-mdms-data/blob/DEV/data/pg/tenant/citymodule.json

{
            "module": "AttendenceMgmt",
            "code": "AttendenceMgmt",
            "active": true,
            "order": 4,
            "tenants": [
                {
                    "code": "statea.citytwo"
                },
                {
                    "code": "statea.citythree"
                },
                {
                    "code": "statea.cityone"
                }
            ]
}

1. Enable Module in App.js. Update the object ‘enabledModules’. Use the code “AttendenceMgmt”. This code should match with the code of the cityModule.json, mentioned above.

Role-action mapping

Sidebar configuration

{
      "id": 59,
      "name": "ATTENDENCEMGMT",
      "url": "url",
      "displayName": "ATTENDENCEMGMT Inbox",
      "orderNumber": 2,
      "parentModule": "",
      "enabled": true,
      "serviceCode": "ATTENDENCEMGMT",
      "code": "null",
      "navigationURL": "/works-ui/employee/attendencemgmt/inbox",
      "path": "4ATTENDENCEMGMT.Inbox",
      "leftIcon": "dynamic:AttendanceIcon"
}

Screen configuration

Localization Configuration and Modules

Workflow Configuration

Customization

1. API-based Data -

• The amountTotal Wage Amount - Amount shown in the view muster roll screen is fetched from expense-calculator

2. Inbox / Search Screen :

1. Please use the common utility “preProcessMDMSConfigInboxSearch”.

2. Pass the associated dependencies for the config.

3. The utility will return a config that will run through RenderFormFields.

4. Refer to docs for Pre-Process config in Component comments.

Overview

This module helps in creating a work order for the Project based on the estimates designed. This enables in deciding the Tendering, Quotation and Nomination. Based on the nomination, CBO is being mapped to the respective work order.

This module has 5 associated screens :

1. Create

2. Search

3. Modify

4. View

5. Inbox

MDMS Configurations

Module Enablement Configuration

1. Set module code as “Contracts” in Module.js of Contracts Module. Refer https://github.com/egovernments/works-mdms-data/blob/DEV/data/pg/tenant/citymodule.json

 {
            "module": "Contracts",
            "code": "Contracts",
            "active": true,
            "order": 5,
            "tenants": [
                {
                    "code": "pg.cityb"
                },
                {
                    "code": "pg.cityc"
                },
                {
                    "code": "pg.citya"
                }
            ]
     }

1. Enable Module in App.js. Update the object ‘enabledModules’. Use the code “Contracts”. This code should match the code of the cityModule.json, mentioned above.

Role-action Mapping

Sidebar Configuration

{
      "id": 58,
      "name": "CONTRACTS",
      "url": "url",
      "displayName": "Contracts Inbox",
      "orderNumber": 2,
      "parentModule": "",
      "enabled": true,
      "serviceCode": "CONTRACTS",
      "code": "null",
      "navigationURL": "/works-ui/employee/contracts/inbox",
      "path": "3CONTRACTS.Inbox",
      "leftIcon": "dynamic:ContractIcon"
   }

Screen Configuration

Localization Configuration & Modules

Workflow Configuration

Customization

1. API-based Data -

• Name of CBO - This field is being captured on the Create screen and Modify screen. Data for this field comes from the backend.

• CBO ID - This field is being set based on the value selected in the Name Of CBO.

• Name of Officer In Charge - This field is being populated based on the HRMS Search. Here the role is hardcoded to ‘OFFICER_IN_CHARGE’.

• Designation of Officer In Charge - This field is being set based on the value selected in the Name of Officer in charge.

• Work Order Amount - This field shows the calculated amount of Total Estimated Cost minus the Overheads which has ‘isWorkOrderValue’ as true. Please refer to this OverHeads config for Amount calculation.

• The role of CBO will be shown based on the calculated Work Order Amount. If the calculated Work Order Amount is less than the ‘amount’ in RoleOfCBO Config, show Implementation Agency else show Implementation Partner. This logic will vary based on the updates in the RoleOfCBO config.

2. Custom Components used in Projects :

• Document Config - Based on the document config, respective documents will be rendered on the Create Screen. Please mention the validations, file type limits and file size limits in this config.

• Work Order Terms and Conditions - This component will help input the description in the table. Users can add and delete the rows. The first row will not be deleted, clicking on the delete button will empty the first row. Refer Component - WOTermsAndConditions.

3. Create Screen:

• Please use the common Utility “PreProcessMDMSConfig”.

• Pass the associated dependencies for the config.

• The utility will return a config which will run through FormComposer.

• Refer to docs for Pre-Process config in Component comments.

4. Inbox / Search Screen :

• Please use the common utility “preProcessMDMSConfigInboxSearch”.

• Pass the associated dependencies for the config.

• The utility will return a config which will run through RenderFormFields.

• Refer to docs for Pre-Process config in Component comments.

Work order is created for an approved estimate in order to award the work to CBO. CBO starts the work to complete it within a given time period.

In case organization comes to know that they are not in a position to complete the work within the given time frame due to various reasons, they need to inform the same to the officer in-charge of project and apply for time extension which is then subject to approval/ canceling of work order based on the analysis done by the ULB.

Requests for time extension can be directly raised by CBO using the mobile application and by the officer in-charge of the project on behalf of CBO using web application. Once a request is raised it goes for verification and approval.

We have the following screens for Time Extension in Web Interface

• Create Time Extension

• View Time Extension

• Edit Time Extension

• Search Time Extension ( Same as search work order screen)

• Inbox ( Same as work order inbox )

Conditions to Create a Time Extension Request

• Work order must be in Accepted state

• Existing Time Extension requests, if already created, must not be in workflow

• At Least one muster roll must be approved

How to Create a Time Extension Request in Web-Interface

• Login with work order creator role and Navigate to Home page.

• Home > Work Orders > Inbox > Search Work Order > View Work Order > Request Time Extension (From Action Menu)

• A screen similar to the Work Order View screen is opened along with two new input fields

• Enter time extension value (in days) and reason in those two inputs and click on Create action button

• A workflow popup is opened where users can enter the assignee and relevant comments. Click on Submit button

• A response page is opened which shows the newly created revised work order application’s number

Inbox, View and Search Screen For Time Extension in Web Interface

There is no separate inbox for time extension. Work order inbox will list the time extension requests which are INWORKFLOW state. Clicking on the time extension request will open a view time extension screen where the user can take actions on the request based on the roles defined in the workflow. Alternatively, users can go to the work order search screen to search for any time extension request.

Workflow for Time Extension

Overview

This module helps in creating an individual (Wage Seeker), it is needed in Mukta to assign work, track attendance and process DBTs.

This module has 3 associated screens :

1. Search

2. View

3. Modify

MDMS Configurations

Module Enablement Configuration

1. Set module code as “Masters” in Module.js for the Masters (Organization) Module. Refer

1. Enable Module in App.js. Update the object ‘enabledModules’. Use the code “Masters”. This code should match the code of the cityModule.json, mentioned above.

Role-action Mapping

Sidebar Configuration

Sample object for a sidebar action defined in MDMS (containing the navigation Url)

Screen Configuration

Localization Configuration & Modules

Workflow Configuration

NA

Customization

1. Modify Individual Screen

   • Use the common Utility “PreProcessMDMSConfig”.

   • Pass the associated dependencies for the config.

   • The utility will return a config which will run through FormComposer.

   • Refer to docs for Pre-Process configuration of Component comments.

2. Search Individual Screen

   • Use the common utility “preProcessMDMSConfigInboxSearch”.

   • Pass the associated dependencies for the config.

   • The utility will return a config which will run through RenderFormFields.

   • Refer to docs for Pre-Process configuration of Component comments.
3. Validations added

   • Form validations are integrated within the Screen Configurations. To facilitate this, include the appropriate populators for the respective validations. Additionally, make sure to specify the JSON path necessary for the pre-processing to function correctly.

4. Delete API Usage

   • To modify existing skills, the "deleteIndividual" and "update Individual" APIs are utilized.

   • If skills are already present, they can be updated using the "update" API. If any skills need to be removed, the "delete" API is used. In the case of skill removal, the entire skill object should be sent with the 'isDeleted' flag set to true.

This module helps in creating an organization which are business functions that work with ULB to execute projects. These can be typical contractors, SHGs or material vendors. All of them are registered under the same Organization Master.

This module has 4 associated screens :

1. Create

2. Search

3. View

4. Modify

MDMS Configurations

MDMS Configurations

Module enablement configuration

1. Enable Module in App.js. Update the object ‘enabledModules’. Use the code “Masters”. This code should match with the code of the cityModule.json, mentioned above.

Role-action mapping

Sidebar configuration

Screen configuration

Localization Configuration and Modules

Workflow Configuration

NA

Customization

1. Custom Components used

TransferCodeTable -

• This component is a common component used to show Tax identifiers and Transfer Codes input options in the ‘Financial Details’ section in Create screen

• Dropdown options for tax identifiers and transfer codes are populated by MDMS data

• Used can select type via dropdown and value needs to be entered for the corresponding type

• Users can add and delete rows for tax identifiers since there can be multiple identifiers. First row won't be deleted.

2. Create Organization Screen

• Please use the common Utility “PreProcessMDMSConfig”.

• Pass the associated dependencies for the config.

• The utility will return a config that will run through FormComposer.

• Refer to docs for Pre-Process config in Component comments.

• Tax Identifiers and Transfer Codes are MDMS data.

3. Search Organization Screen

• Please use the common utility “preProcessMDMSConfigInboxSearch”.

• Pass the associated dependencies for the config.

• The utility will return a config that will run through RenderFormFields.

• Refer to docs for Pre-Process config in Component comments.

• Validations added

• All Form validations are being added in the Screen Configurations. Add the populators for respective validations and mention the JSON path for the Pre-Process to work.

• IFSC code has 2 validations as below

1. Pattern validation (given in config)

2. Third-party API is being used to get band and branch name based on entered valid IFSC code, This API throws 404 if the code is not valid, in that case the valid error message is displayed below the input field

3. Tax identifiers are not mandatory while creating Organisation. But as per API implementation, it's required in payload hence we send a dummy identifier value if the user has not entered anything in Tax identifier input. In the View Organisation screen if the PAN value is above the dummy value then ‘NA’ is displayed on the screen.

• Default value: Type => PAN, Value => XXXXX0123X

Overview

The Estimate module helps in creating estimates based on projects created. This enables in deciding the Tendering, and Quotation.

The module has 5 associated screens :

1. Create Estimate

2. Search Estimate

3. Edit Estimate

4. View Estimate

5. Estimate Inbox

MDMS Configurations

Module Enablement Configuration

Set module code as “Estimate” in Module.js of Estimate Module. Refer to the file

Enable Module in App.js. Update the object ‘enabledModules’. Use the code Estimate. This code should match the code of the cityModule.json, mentioned above.

Role-action Mapping

Sidebar Configuration

Sample object for a sidebar action defined in MDMS (containing navigationUrl )

Screen Configuration

Localization Configuration & Modules

Workflow Configuration

2. For Workflow related actions, the View screens use two components:

Customisation

Custom Components used in Estimate:

1. Document Config -
2. • Used in Create Estimate Screen to capture Non-Sor line items.

3. • Used in Create Estimate Screen to capture Overhead items.

4. • Used in Create Estimate Screen to calculate and render Total Estimate Amount.

6. • Used in Create Estimate screen to capture labour and material costs. The total labour and material costs cannot be greater than the total Estimate Amount.

Create Estimate Screen:

1. Use the common Utility “PreProcessMDMSConfig”.

2. Pass the associated dependencies for the config.

3. The utility will return a config which will run through FormComposer.

4. Refer to docs for Pre-Process config in Component comments.

5. UOM and Overheads captured in the create screen are MDMS data.

Inbox / Search Screen:

1. Use the common utility “preProcessMDMSConfigInboxSearch”.

2. Pass the associated dependencies for the config.

3. The utility will return a config which will run through RenderFormFields.

4. Refer to docs for Pre-Process config in Component comments.

Overview

The Project module enables the Junior Engineer to capture the project details, search, view and modify the existing projects. This module is the initial step in starting the work.

The module has 4 associated screens :

1. Create

2. Search

3. Modify

4. View

MDMS Configurations

Module Enablement Configuration

Set module code as “Project” in Module.js of Project Module. Refer https://github.com/egovernments/works-mdms-data/blob/DEV/data/pg/tenant/citymodule.json.

Enable module in App.js. Update the object ‘enabledModules’. Use the code “Project”. This code should match the code of cityModule.json, mentioned above.

PDF Configuration

The project created can be downloaded in PDF format from the View Project screen in the project module. The PDF contains the respective project descriptions, work details, and location details.

PDF URL : https://works-dev.digit.org/egov-pdf/download/project/project-details?projectId=<project-Id>&tenantId=<tenant-Id>

Role-action Mapping

Sidebar Configuration

Sample Configuration

Screen Configuration

Localisation Configuration & Modules

Workflow Configuration

NA

Customisation

Create Screen:

1. Use the common Utility “PreProcessMDMSConfig”.

2. Pass the associated dependencies for the config.

3. The utility returns a config that will run through the FormComposer.

4. Refer to docs for pre-process config in component comments.

Search Screen:

1. Use the common utility “preProcessMDMSConfigInboxSearch”.

2. Pass the associated dependencies for the config.

3. The utility returns a config that will run through the RenderFormFields.

4. Refer to docs for pre-process config in component comments.

Custom Components Used in Projects:

2. Form Validations: Verify that all necessary form validations are included in the screen configurations. Add populators for respective validations and specify the JSON path to enable the pre-process function.

Overview

This module is used to handle all billing-related actions such as create, update and view Bills.

This module has 5 associated screens :

1. Create (Purchase Bill)

2. Search

3. View (Wage, Purchase, Supervision)

4. Modify (Purchase Bill)

5. Download Bills

MDMS Configurations

Module enablement configuration

1. Set module code as “Expenditure” in Module.js for Billing Module. Refer

1. Enable Module in App.js. Update the object ‘enabledModules’. Use the code “Expenditure”. This code should match with the code of the cityModule.json, mentioned above.

Role-action mapping

Sidebar configuration

Sample object for a sidebar action define in MDMS (containing navigationUrl)

Screen configuration

Localization Configuration and Modules

Workflow Configuration

<details>

Customization

1. Create Purchase Bill Screen

• Please use the common Utility “PreProcessMDMSConfig”.

• Pass the associated dependencies for the config.

• The utility will return a config which will run through FormComposer.

• Refer docs for Pre-Process config in Component comments.

1. Search Bill Screen

• Please use the common utility “preProcessMDMSConfigInboxSearch”.

• Pass the associated dependencies for the config.

• The utility will return a config which will run through RenderFormFields.

• Refer docs for Pre-Process config in Component comments.

• Checkbox selection is added to results table displayed in search screen based on search config passed via MDMS

1. Download Bill Screen

DownloadBillConfig is used to render table to show bills where download link is provided to download respective bills

Overview

This module helps in taking the measurement, for an accepted contract

This module has 5 associated screens :

1. Create

2. Inbox

3. Edit

4. View

5. Search

Module enablement configuration

1. Set module code as "Measurement" in Module.js of Measurement Module. Refer https://github.com/egovernments/works-mdms-data/blob/DEV/data/pg/tenant/citymodule.json

{
        "module": "Measurement",
        "code": "Measurement",
        "active": true,
        "order": 13,
        "tenants": [
            {
                "code": "pg.cityb"
            },
            {
                "code": "pg.cityc"
            },
            {
                "code": "pg.citya"
            }
        ]
}

1. Enable Module in App.js. Update the object ‘enabledModules’. Use the code “Measurement”. This code should match with the code of the cityModule.json, mentioned above.

Role-action mapping

Sidebar configuration

{
      "id": 59,
      "name": "MEASUREMENT",
      "url": "url",
      "displayName": "MEASUREMENT Inbox",
      "orderNumber": 2,
      "parentModule": "",
      "enabled": true,
      "serviceCode": "ATTENDENCEMGMT",
      "code": "null",
      "navigationURL": "/works-ui/employee/measurement/inbox",
      "path": "4MEASUREMENT.Inbox",
      "leftIcon": "dynamic:AttendanceIcon"
}

Document Configuration

https://github.com/egovernments/egov-mdms-data/commit/85761f2c82ced17a0259e077f6b82355e62ce35c

Screen configuration

Localization Configuration and Modules

Workflow Configuration

Custom Components

1. MeasureTable:

This is the main component that handles the Logic for capturing the measurement for SOR / NONSOR based on the given processed Line items from the Estimate.

The same component has been used in the Detailed estimate which captures the detailed measurement information

The same component has the capability to be used in both create and view screens.

1. MeasureCard:

   This component handles the logic of the inner table present inside the MeasureTable.

Overview

This module helps create wage seekers.

ROLE: ORG_ADMIN

This module contains 4 linked forms

1. Individual Details

2. Address Details

3. Financial Details

4. Summary Details

Individual Details

Address Details

Financial Details

This form combines the details of the previous 3 forms, and users can tap on the respective edit icon to edit the particular details.

On submit, the wage seeker is created successfully.

API Details

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

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

Sidebar Configuration

<details>

DIGIT Components & Custom Components Used

Localization Configuration & Modules

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

Overview

This module provides the ability to create SORs and Rates

This module has 5 associated screens :

1. Create

2. Edit

3. View

4. Search

Workbench

The SORs and some related masters were created using the workbench and MDMS v2.

Refer to the Workbench Release document to enable the Workbench

SOR Schemas

SOR

{
  "id": "fd565798-c000-4053-b5f0-4ef5af179934",
  "tenantId": "pg",
  "code": "WORKS-SOR.SOR",
  "description": "WORKS-SOR.SOR",
  "definition": {
    "type": "object",
    "title": "WORKS_SOR.SOR",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "id",
      "sorType",
      "uom",
      "quantity"
    ],
    "x-unique": [
      "id"
    ],
    "properties": {
      "id": {
        "type": "string"
      },
      "uom": {
        "type": "string"
      },
      "sorType": {
        "type": "string"
      },
      "quantity": {
        "type": "number"
      },
      "sorSubType": {
        "type": "string",
        "default": "NA"
      },
      "sorVariant": {
        "type": "string",
        "default": "NA"
      },
      "description": {
        "type": "string"
      }
    },
    "x-ui-schema": {
      "ui:order": [
        "sorType",
        "sorSubType",
        "sorVariant",
        "uom",
        "quantity",
        "description",
        "*"
      ],
      "description": {
        "ui:widget": "textarea"
      },
      "ui-autogenerate": {
        "id": "works.sor.number"
      }
    },
    "x-ref-schema": [
      {
        "fieldPath": "sorType",
        "schemaCode": "WORKS-SOR.Type"
      },
      {
        "fieldPath": "sorSubType",
        "schemaCode": "WORKS-SOR.SubType"
      },
      {
        "fieldPath": "sorVariant",
        "schemaCode": "WORKS-SOR.Variant"
      },
      {
        "fieldPath": "uom",
        "schemaCode": "common-masters.UOM"
      }
    ]
  },
  "isActive": true,
  "auditDetails": {
    "createdBy": null,
    "lastModifiedBy": null,
    "createdTime": 1695898033182,
    "lastModifiedTime": 1695898033182
  }
}

SOR Type

{
  "id": "9da79f30-0d7f-4ec8-927a-7151f803fcd5",
  "tenantId": "pg",
  "code": "WORKS-SOR.Type",
  "description": "WORKS-SOR.Type",
  "definition": {
    "type": "object",
    "title": "WORKS-SOR.Type",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "code",
      "active"
    ],
    "x-unique": [
      "code"
    ],
    "properties": {
      "code": {
        "type": "string"
      },
      "active": {
        "type": "boolean"
      },
      "description": {
        "type": "string"
      }
    }
  },
  "isActive": true,
  "auditDetails": {
    "createdBy": null,
    "lastModifiedBy": null,
    "createdTime": 1695897163197,
    "lastModifiedTime": 1695897163197
  }
}

SOR Subtype

{
  "id": "6d4b30f2-b489-4f8b-bb02-6b3014750e18",
  "tenantId": "pg",
  "code": "WORKS-SOR.SubType",
  "description": "WORKS-SOR.SubType",
  "definition": {
    "type": "object",
    "title": "WORKS-SOR.SubType",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "code",
      "active",
      "type"
    ],
    "x-unique": [
      "code"
    ],
    "properties": {
      "code": {
        "type": "string"
      },
      "type": {
        "type": "string"
      },
      "active": {
        "type": "boolean"
      },
      "description": {
        "type": "string"
      }
    },
    "x-ref-schema": [
      {
        "fieldPath": "type",
        "schemaCode": "WORKS-SOR.Type"
      }
    ]
  },
  "isActive": true,
  "auditDetails": {
    "createdBy": null,
    "lastModifiedBy": null,
    "createdTime": 1695897222499,
    "lastModifiedTime": 1695897222499
  }
}

SOR Variant

{
  "id": "6ea9de1f-f924-4133-8689-1571258b57fe",
  "tenantId": "pg",
  "code": "WORKS-SOR.Variant",
  "description": "WORKS-SOR.Variant",
  "definition": {
    "type": "object",
    "title": "WORKS-SOR.Variant",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "code",
      "active"
    ],
    "x-unique": [
      "code"
    ],
    "properties": {
      "code": {
        "type": "string"
      },
      "active": {
        "type": "boolean"
      },
      "description": {
        "type": "string"
      }
    }
  },
  "isActive": true,
  "auditDetails": {
    "createdBy": null,
    "lastModifiedBy": null,
    "createdTime": 1695897273559,
    "lastModifiedTime": 1695897273559
  }
}

UOM

{
  "id": "dc4eee9c-28a0-4c99-b113-d1695d1796d6",
  "tenantId": "pg",
  "code": "common-masters.UOM",
  "description": "common-masters.UOM",
  "definition": {
    "type": "object",
    "title": "common-masters.UOM",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "code"
    ],
    "x-unique": [
      "code"
    ],
    "properties": {
      "code": {
        "type": "string",
        "pattern": "^[A-Za-z]+$"
      },
      "baseUom": {
        "type": "boolean"
      },
      "description": {
        "type": "string",
        "pattern": "^[A-Za-z]+$"
      },
      "uomCategory": {
        "type": "string"
      },
      "conversionFactor": {
        "type": "number",
        "minLength": 2
      }
    },
    "x-ref-schema": []
  },
  "isActive": true,
  "auditDetails": {
    "createdBy": null,
    "lastModifiedBy": null,
    "createdTime": 1692771724255,
    "lastModifiedTime": 1692771724255
  }
}

Rates

{
  "id": "21d86249-65ec-4104-9b8f-ce9deb5ad235",
  "tenantId": "pg",
  "code": "WORKS-SOR.Rates",
  "description": "WORKS-SOR.Rates",
  "definition": {
    "type": "object",
    "title": "WORKS-SOR.Rates",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "sorId",
      "rate",
      "validFrom",
      "amountDetails"
    ],
    "x-unique": [
      "sorId",
      "validFrom"
    ],
    "properties": {
      "rate": {
        "type": "number"
      },
      "sorId": {
        "type": "string"
      },
      "validTo": {
        "type": "string"
      },
      "validFrom": {
        "type": "string"
      },
      "amountDetails": {
        "type": "array",
        "items": {
          "type": "object",
          "required": [
            "type",
            "heads",
            "amount"
          ],
          "properties": {
            "type": {
              "enum": [
                "percentage",
                "fixed"
              ],
              "type": "string"
            },
            "heads": {
              "type": "string"
            },
            "amount": {
              "type": "number"
            }
          }
        }
      }
    },
    "x-ui-schema": {
      "ui:order": [
        "sorId",
        "validFrom",
        "validTo",
        "rate",
        "amountDetails",
        "*"
      ]
    },
    "x-ref-schema": [
      {
        "fieldPath": "sorId",
        "schemaCode": "WORKS-SOR.SOR"
      },
      {
        "fieldPath": "amountDetails.*.heads",
        "schemaCode": "WORKS-SOR.Overhead"
      }
    ]
  },
  "isActive": true,
  "auditDetails": {
    "createdBy": null,
    "lastModifiedBy": null,
    "createdTime": 1696330283758,
    "lastModifiedTime": 1696330283758
  }
}

Overheads

{
  "id": "13f4ee64-0d83-4ff8-9cd2-c166fc410405",
  "tenantId": "pg",
  "code": "WORKS-SOR.Overhead",
  "description": "WORKS-SOR.Overhead",
  "definition": {
    "type": "object",
    "title": "WORKS-SOR.Overhead",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "code",
      "active",
      "validFrom",
      "id",
      "description"
    ],
    "x-unique": [
      "code",
      "id"
    ],
    "properties": {
      "id": {
        "type": "string"
      },
      "code": {
        "type": "string"
      },
      "type": {
        "enum": [
          "percentage",
          "lumpsum"
        ],
        "type": "string"
      },
      "value": {
        "type": "string"
      },
      "active": {
        "type": "boolean"
      },
      "validTo": {
        "type": "string",
        "format": "date-time"
      },
      "validFrom": {
        "type": "string",
        "format": "date-time"
      },
      "description": {
        "type": "string"
      }
    }
  },
  "isActive": true,
  "auditDetails": {
    "createdBy": null,
    "lastModifiedBy": null,
    "createdTime": 1695898168948,
    "lastModifiedTime": 1695898168948
  }
}

MDMS Role Action Configs

Sample data can be referred from the below sheet

Overview

This module helps in viewing and updating the muster rolls.

ROLE: ORG_ADMIN

This module has 2 associated screens :

1. View Muster Rolls Inbox

2. Muster Roll Table Screen

MDMS Configurations

Based on the business workflow state set for Muster Roll ( Sent BAck for Correction) in respective environments, Add the corresponding code in Sent Back to CBO Code MDMS

User actions

On this page, the following actions need to be performed: If the muster roll is in workflow, User can only view the muster roll, If the muster roll is sent back to CBO,then user can edit the attendance and resubmit the muster roll,

Validations

• If Muster Roll is in Workflow, The screen will only be a view page and Save as Draft and Re-Submit button will not be shown in the screen

• Based on the Attendance Hours list, users will be allowed to mark the attendance as Full Day, Half Day, or absent. If the list is of length 2, users will be allowed to mark only Full and Absent, Else, users can mark halfday as well.

API Details

DIGIT Components and Custom Components Used

Localization Configuration and Modules

Reference Files

1. Blocs :

• Attendance Create Log Bloc

• Search Muster Rolls in a Tenanat

• Muster Search From Muster ID Bloc

• Get Muster Roll Workflow Bloc

• Muster Get Attendance Log Bloc

• Create and Update Muster Roll Bloc

1. Models :

• Estimate Muster Roll Model

• Search Muster Roll Model

• Muster Workflow model

1. Repositories:

• Attendance Register Repo

• Muster Roll Repo

• Workflow Repo

1. Screens

• Muster Inbox Screen

• Muster Roll View and Edit Table

Overview

The Estimate Template feature helps in creating a template for particular work, so it can be directly taken refrence of or added by user in estimate creation. This feature has been incorporated in the estimate create screen where it can searched and added.

Configurations

MDMS Configurations

Module Enablement Configuration

Estimate Template is a part of mdms-v2 data, so In order to see the changes in the UI, both Estimate module and Workbench module has to be enabled in the file CityModule.json

Role-action Mapping

Sidebar Configuration

Sample object for a sidebar action defined in MDMS (containing navigationUrl )

{
      "id": 193,
      "name": "MDMS",
      "url": "url",
      "displayName": "Manage Works Estimate Template",
      "orderNumber": 1,
      "parentModule": "",
      "enabled": true,
      "serviceCode": "MDMS",
      "code": "null",
      "navigationURL": "/workbench-ui/employee/workbench/mdms-search-v2?moduleName=WORKS&masterName=EstimateTemplate",
      "path": "9MDMS.WORKS-SOR.EstimateTemplate",
      "leftIcon": "dynamic:ContractIcon"
}