FSM v1.3 Employee: Update Trips Flow

Objective

It allows an Employee to update the number of trips as much it is needed and even after assigning the vehicle.

Once the ULB employee with FSM_EDITOR login, assign the vehicle to the respective application, the employee will get the option to update the number of trips, if needed.

Number of trips can be added as many times as needed.

Updating the Number of trips will affect the rate of the service.

Update trips action is showing after assigning the vehicle

File Path: https://github.com/egovernments/DIGIT-Dev/blob/develop/frontend/micro-ui/web/micro-ui-internals/packages/modules/fsm/src/pages/employee/ApplicationDetails/Modal/index.js

Update Trips:

When clicked on update trips action, Update trips pop up screen will appear to update the trips.

Update trips pop up screen to update the trips

File Path:

https://github.com/egovernments/DIGIT-Dev/blob/develop/frontend/micro-ui/web/micro-ui-internals/packages/modules/fsm/src/pages/employee/ApplicationDetails/config/UpdateTrips.js

https://github.com/egovernments/DIGIT-Dev/blob/develop/frontend/micro-ui/web/micro-ui-internals/packages/modules/fsm/src/pages/employee/ApplicationDetails/Modal/index.js

https://github.com/egovernments/DIGIT-Dev/blob/develop/frontend/micro-ui/web/micro-ui-internals/packages/modules/fsm/src/pages/employee/ApplicationDetails/config/index.js

After updating their trips, the employee can view the updated trips in the application timeline

File Path: https://github.com/egovernments/DIGIT-Dev/blob/develop/frontend/micro-ui/web/micro-ui-internals/packages/modules/fsm/src/pages/employee/ApplicationDetails/index.js

The payload sent to the /fsm/v1/_update end point looks like the following:

{
  "citizen": {
    "id": 78703,
    "uuid": "239cdc7b-52e2-4fc6-81f0-0fca7f0129cf",
    "userName": "c52bb319-9337-4736-87f2-78225c9ca9bd",
    "name": "TEST Zero",
    "password": null,
    "mobileNumber": "7890987656",
    "tenantId": "pb",
    "salutation": null,
    "emailId": null,
    "altContactNumber": null,
    "pan": null,
    "aadhaarNumber": null,
    "permanentAddress": null,
    "permanentCity": null,
    "permanentPinCode": null,
    "correspondenceCity": null,
    "correspondencePinCode": null,
    "active": true,
    "dob": null,
    "pwdExpiryDate": 1685876017000,
    "locale": null,
    "type": "CITIZEN",
    "signature": null,
    "accountLocked": false,
    "roles": [
      {
        "id": null,
        "name": "Citizen",
        "code": "CITIZEN",
        "tenantId": "pb"
      }
    ],
    "bloodGroup": null,
    "identificationMark": null,
    "photo": null,
    "createdBy": "12069",
    "createdDate": 1678100017000,
    "lastModifiedBy": "12069",
    "lastModifiedDate": 1678100017000,
    "otpReference": null,
    "gender": "MALE"
  },
  "id": "4c7c3a2a-2362-485c-908c-b5cf93a71d16",
  "tenantId": "pb.amritsar",
  "applicationNo": "107-FSM-2023-03-06-006898",
  "description": null,
  "accountId": "239cdc7b-52e2-4fc6-81f0-0fca7f0129cf",
  "additionalDetails": {
    "tripAmount": 0
  },
  "applicationStatus": "DSO_INPROGRESS",
  "source": "TELEPHONE",
  "sanitationtype": null,
  "propertyUsage": "RESIDENTIAL.APARTMENT",
  "vehicleType": null,
  "noOfTrips": 1,
  "vehicleCapacity": "1000",
  "status": null,
  "vehicleId": "49b16b86-1583-4235-8385-6064903af072",
  "vehicle": null,
  "dsoId": "4a285833-0db1-4b17-b21d-b2e474a50f3b",
  "dso": null,
  "possibleServiceDate": 1678147200000,
  "pitDetail": {
    "type": null,
    "id": "cf1dc7c1-b707-406b-96db-fefba3789566",
    "tenantId": "pb.amritsar",
    "height": 0,
    "length": 0,
    "width": 0,
    "diameter": 0,
    "distanceFromRoad": 0,
    "auditDetails": {
      "createdBy": "29a02577-7f30-4d00-9041-0c499e34fd87",
      "lastModifiedBy": "97a111f0-e2fc-40ee-976f-96acfa1d085b",
      "createdTime": 1678100018009,
      "lastModifiedTime": 1678178056996
    },
    "additionalDetails": null
  },
  "address": {
    "tenantId": "pb.amritsar",
    "doorNo": null,
    "plotNo": null,
    "id": "9a7423b4-f6a0-4e3a-8538-0f041660fa8b",
    "landmark": null,
    "city": "Amritsar",
    "district": null,
    "region": null,
    "state": null,
    "country": null,
    "pincode": "143001",
    "additionalDetails": "{\"tripAmount\": 0}",
    "auditDetails": {
      "createdBy": "29a02577-7f30-4d00-9041-0c499e34fd87",
      "lastModifiedBy": "97a111f0-e2fc-40ee-976f-96acfa1d085b",
      "createdTime": 1678100018009,
      "lastModifiedTime": 1678178056996
    },
    "buildingName": null,
    "street": null,
    "slumName": "SL0001",
    "locality": {
      "code": "SUN04",
      "name": "Ajit Nagar - Area1",
      "label": "Locality",
      "latitude": null,
      "longitude": null,
      "children": [],
      "materializedPath": null
    },
    "geoLocation": {
      "id": "4fadd9e7-6067-4284-9378-8b51ddcaab83",
      "latitude": 0,
      "longitude": 0,
      "additionalDetails": null
    }
  },
  "auditDetails": {
    "createdBy": "29a02577-7f30-4d00-9041-0c499e34fd87",
    "lastModifiedBy": "97a111f0-e2fc-40ee-976f-96acfa1d085b",
    "createdTime": 1678100018009,
    "lastModifiedTime": 1678178056996
  },
  "wasteCollected": null,
  "completedOn": 0,
  "advanceAmount": null,
  "applicationType": "Adhoc Service",
  "oldApplicationNo": null,
  "paymentPreference": null
}

and the workflow status as:

{
  "action": "UPDATE"
}

Technical Implementation Details:

PlusMinusInput.js component is responsible for rendering Updating Trips screen.

File Path: https://github.com/egovernments/DIGIT-Dev/blob/develop/frontend/micro-ui/web/micro-ui-internals/packages/modules/fsm/src/pageComponents/PlusMinusInput.js

https://github.com/egovernments/DIGIT-Dev/blob/develop/frontend/micro-ui/web/micro-ui-internals/packages/modules/fsm/src/Module.js

CSS File: https://github.com/egovernments/DIGIT-Dev/blob/develop/frontend/micro-ui/web/micro-ui-internals/packages/css/src/components/plusMinus.scss

https://github.com/egovernments/DIGIT-Dev/blob/develop/frontend/micro-ui/web/micro-ui-internals/packages/css/src/index.scss

Role Action Mapping:

	API	ROLES	ACTION ID

	API	ROLES	ACTION ID
1	`/egov-mdms-service/v1/_search`	`LOA_CREATOR,WO_CREATOR,AE_CREATOR,WORKS_MASTER_CREATOR,UC_EMP,SUPERUSER`	954
2	`/fsm/v1/_update`	`FSM_EDITOR_EMP,FSM_ADMIN,FSM_DSO,FSM_DRIVER,CITIZEN`	2045
3	`/fsm/v1/_search`	`FSM_CREATOR_EMP`,`CITIZEN`,`FSM_EDITOR_EMP`,`FSM_VIEW_EMP`,`FSM_ADMIN`,`FSM_DSO`,`FSM_DRIVER`,`FSM_EMP_FSTPO`,`FSM_COLLECTOR`	2044
4	`/vendor/v1/_search`	`FSM_CREATOR_EMP,FSM_ADMIN,FSM_DSO,FSM_EDITOR_EMP`,`FSM_VIEW_EMP,FSM_EMP_FSTPO,CITIZEN`	2053