FSM Functional Specification
Desludging Operator Registration
Desludging operators (DSO) can be registered via a user interface (UI) available to the urban local body (ULB) admin. Once created, multiple vehicles and drivers can be mapped to a DSO. DSOs can also be enabled/disabled in the system.
Desludging operators will have the following details:
Field Name | Type | Mandatory | Editable (Y/N) | Unique within a ULB (Y/N) |
Vendor name | Free text | Y | N | N |
Gender | Array | Y | N | N |
DOB | Date | N | Y | N |
Email address | Free text (Email format) | N | Y | N |
Mobile number | Number | Y | N | Y |
Door number | Free text | N | Y | N |
Plot number | Free text | N | Y | N |
Building name | Free text | N | Y | N |
Street | Free text | N | Y | N |
Pincode | Free text | N | Y | N |
City | Array | Y | N | N |
Locality/mohalla | Array | Y | N | N |
Landmark | Free text | N | Y | N |
Additional Details | Free text | N | Y | N |
Status | Binary | Y | Y | N |
Driver Registration
Drivers can be registered via a UI available to the ULB admin. Once created, a driver can be mapped to a DSO. Drivers can also be enabled/disabled in the system.
Drivers operators will have the following details:
Field Name | Type | Mandatory | Editable (Y/N) | Unique within a ULB (Y/N) |
Driver name | Free text | Y | N | N |
Driver License Number | Free text (Validation on the license format) | Y | Y | N |
Gender | Array | N | Y | N |
DOB | Date | N | Y | N |
Email address | Free text (Email format) | N | Y | N |
Driver phone number | Number | Y | N | N |
Vehicle Registration
Vehicles can be registered via a UI available to the ULB admin. Once created, a vehicle can be mapped to a DSO. Vehicles can also be enabled/disabled in the system.
Vehicles operators will have the following details:
Field Name | Type | Mandatory | Editable (Y/N) | Unique within a ULB (Y/N) |
Registration number | Free Text | Y | N | Y |
Vehicle model | Array | Y | Y | N |
Vehicle type | Array | Y | Y | N |
Tank capacity | Array | Y | Y | N |
Pollution certificate valid till | Date | N | Y | N |
Insurance valid till | Date | N | Y | N |
Road tax paid till | Date | N | Y | N |
Fitness certificate valid till | Date | N | Y | N |
Vehicle owner name | Free text | Y | N | N |
Vehicle owner phone number | Number | Y | N | N |
Apply for Desludging Services
The citizen or the ULB official can apply for a desludging request.
Application Channel
Citizens can apply online using the web application.
Citizens can walk into a ULB and submit a request to the counter operator, who then creates an application on behalf of the citizen online.
Citizens can call the ULB and request for a desludging operation, which can then be transformed into an online application by the ULB official.
Application Submission
Desludging applications can be created by a citizen.
Desludging application requests can be created by a ULB official on behalf of a citizen.
- If the application is created by a ULB official, then capture the channel in which the request was received. It will be an additional field in the UI to capture the channel.
Field Name | Type | Mandatory | Editable | Comments |
Applicant name | Text | Y | N |
|
Mobile number | Numeric | Y | N |
|
Gender | Dropdown | Y | N |
|
City | Dropdown | Y
| N | As per the boundary data defined. |
Locality | Dropdown | Y | N | As per the boundary data defined. |
Whether property is in a slum | Binary | Y | N |
|
Slum name | Dropdown | Y | N | Only if the above selection is yes. List of slums per ULB to be uploaded in the system. |
Street name | Text | N | N |
|
Door house number | Text | N | N |
|
Landmark | Text | N | N |
|
Geo location | Lat-Long | N | N | As per DIGIT standards. |
Onsite sanitation type | Dropdown | N | Y | Select one from the list. |
PIT size | L*B*D in feet (This UOM might change from state to state) | N | Y | Numeric |
Property type | Dropdown | Y | N | Use the same ontology as defined in DIGIT Property Tax. |
Property sub-type | Dropdown | Y | N | Use the same ontology as defined in DIGIT Property Tax. |
Number of trips required | Numeric | Y | Y | Editable by ULB and DSO. |
Vehicle capacity | Dropdown | Y | N | Populated as per the vehicle capacities available in the particular ULB. |
Application channel | Dropdown | Y |
| Required only if the creator is a ULB official. |
Total amount | Numeric, display only | Y | N | Calculated based on the billing slabs. |
Minimum amount payable | Numeric, display only | Y | N | Displayed as per the configuration in the backend. |
Advance amount | Numeric | Y | Y |
|
Service Request Fee
Service request fee is calculated as a multiplier of the amount per trip defined in the billing slab table (based on property type, sub-type, whether it is a slum, vehicle capacity) and the number of trips.
For certain combinations with the above parameters, the pricing can be set at zero. In such cases, demand will not be generated.
ULBs can configure a minimum advance payment to be collected before starting a request. This can either be a fixed value (starting from 0) or a percentage (ranging from 0-100). Citizens will be able to make a payment above the minimum advance amount, and below the total trip amount as an advance payment.
Payment: Online/Cash Counter
Citizens can make both the advance and balance payments online.
Citizens can make both the advance and balance payments at the ULB counter.
Payment receipts will be generated and sent across via SMS. They can be downloaded at the citizen and ULB interfaces.
Update Application Request by ULB Official
When a service request is received by a ULB official, he/she can do the following:
- Search and assign a DSO to the application request.
- Cancel the application with remarks.
- Update the application request with the number of trips required to empty the septic tank or Pit and the vehicle details.
- Change the DSO from an application request if the assigned DSO is not available.
- Update the status of the request as completed, post desludging.
- View past records of requests and service delivery.
Cancellation of application
A citizen or a ULB official can cancel the application online.
Citizesn can cancel it only if the DSO is not assigned to the service request.
Application cannot be cancelled if the payment is made already.
ULB officials can cancel it only if the service is not completed by the DSO.
SMS and Email Updates
SMS and email updates are sent on every necessary process of the entire process flow.
Application view by DSO
A DSO should get notified about the request that is assigned to him/her. On receiving the request, the following actions can be taken:
- View the request.
- Assign requests to a vehicle.
- Update the number of trips.
- Flag a request ready for disposal.
- Close the request post desludging.
One DSO cannot see the details of the other DSO or the request assigned to the other DSOs.
Field Name | Type | Required | Comments |
Volume of waste collected | Numeric | Y |
|
Feedback by Citizen
Citizens can provide feedback on the desludging request
There will be an option to rate the service provided with comments.
There will be an option for citizens to update whether safety equipment is used by the sanitary workers during the operation.
Vehicle entry by FSTP/STP plant Operator
Plant operators can do the following:
View the list of desludging operations for a day. Since an application may have multiple trips, the plant operator will view multiple line items against an application in the inbox.
Update the Vehicle entry log against an application request with the details like:
- Date and time of entry.
- Volume of sludge dumped at the plant.
Field Name | Type | Required | Comments |
Vehicle in-time | Time | Y |
|
Vehicle out-time | Time | Y |
|
Volume of sludge dumped | Numeric | Y |
|
Additional details | Text | N |
|
Attachments | Document/Image | N |
|
If a vehicle without a corresponding request arrives at the FSTP, the FSTP can record the vehicle entry.
Field Name | Type | Required | Comments |
Vehicle number | Alphanumeric | Y | Only unregistered vehicles in the system.
|
DSO name | Text | Y |
|
Locality | Text | Y |
|
Vehicle in-time | Time | Y |
|
Vehicle out-time | Time | Y |
|
Volume of sludge dumped | Numeric | Y |
|
Additional details | Text | N |
|
Attachments | Document/Image | N |
|
The DSO can also decline an incoming vehicle.
Attribute | Type | Required? | Comments |
Vehicle | UUID | Y |
|
Trip Number | Numeric | Y |
|
Volume | Numeric | Y |
|
Desludging request | UUID | Y |
|
Reason for declining | String | Y | [ “Septage Source”, “Outside operational hours”, “Under Maintenance”] |
Feedback by Citizens
Citizens can provide feedback on the desludging request:
Rate the service provided (1-5 stars).
Multi-select to update whether safety equipment is used by the sanitary workers during the operation.
List of PDFs
Acknowledgement Recepit: Confirming receipt of desludging receipts.
Payment receipts: Multiple payment receipts based on the payments made.
Reports
Daily desludging request report
Search criteria
Field name | Type | Required |
ULB name | Default | Internally pass the ULB name (Y) |
From date | Date | Y |
To date | Date | Y |
DSO name | Search | N - Auto-populate on typing a few letters. |
Search result
Application number | Application date | Current Status | DSO Name | Amount (Rs) | Date of completion |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Area-wise daily collection report
Search criteria
Field name | Type | Required |
ULB name | Dropdown | Internally pass this info. |
Mohalla | Dropdown | N |
DSO | Search | N - Auto-populate on typing few characters. |
From date | Date | Y |
To date | Date | Y |
Search result
Application number /Date | Mohalla | DSO Name | Status | SLA compliance | Volume of waste collected |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FSTP/STP plant report with vehicle logs
Search criteria
Field Name | Type | Comments |
ULB name | Dropdown |
|
STP/FSTP name | Dropdown | Internally pass this information: We have mapping between ULB and STP/FSTP. |
DSO name | Search | N - Autopopulate on typing a few letters |
Vehicle number | Dropdown | Populate only if the DSO name is selected. |
From date | Date | Y |
To date | Date | Y |
Search result
Application number | DSO name /Vehicle number | Vehicle entry date | Vehicle in time | Vehicle out time | Volume of sludge dumped (L) |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Dashboard
Filter criteria
Field Name | Type | Comments |
DDR (District name) | Dropdown |
|
ULB name | Dropdown |
|
Date range (From and to dates) | Date | Mandatory, auto-select for entire time period. |
Selection criteria
Field Name | Type | Comments |
Denomination | Array | Choose the denominate between Cr, Lac and Unit. |
Other functionalities:
Share via:
a. Image: Downloads image
b. Whatsapp: Image shared via Whatsapp
Download:
a. Image format
Chart name | Chart type | X Axis | Y Axis | Logic | Comments | Tooltip (if any) | Drilldown available (Y/N) |
Overview: Total requests | KPI | NA | NA | Sum of total the requests cumulated over a period of time. | Absolute number and percentage increase or decrease from previous year for the same time period. | NA | N |
Overview: Total sludge treated (in KL) | KPI | NA | NA | Sum of the total sludge deposited from registered and unregistered vehicles at the FSTP. | Absolute number and percentage increase or decrease from the previous year for the same time period. | NA | N |
Overview: Total collection | KPI | NA | NA | Sum of the total revenue collected against service delivery. | Absolute number and percentage increase or decrease from the previous year for the same time period. | NA | N |
Overview: SLA compliance | KPI | NA | NA | Average SLA compliance (percentage of requests completed within SLA). | Percentage number and percentage increase or decrease from the previous year for the same time period. | NA | N |
Overview: Citizen average rating | KPI | NA | NA | Average citizen rating (Total citizen rating/total number of applications with feedback). | Absolute number and percentage increase or decrease from the previous year for the same time period. | NA | N |
Total cumulative collection | Area chart | Month | Total collection | Cumulative collection over a period of time. |
| - Month name - Value | N |
Revenue by property type | Pie chart | NA | NA | Distribution of requests by property type. | The percentage of requests by each property type to be displayed on the chart. | Display percentage and absolute value. | N |
Top 3 performing ULBs (SLA achievement) | Percentage completion on line chart | NA | NA | Average SLA per ULB. | Top 3 to be displayed. View more options available to view the entire list of ULBs. |
| N |
Botton 3 performing ULBs (SLA achievement) | Percentage completion on line chart | NA | NA | Average SLA per ULB | Bottom 3 to be displayed. View more options available to view the entire list of ULBs. |
| M |
FSTP - capacity utilisation | Line chart | Percentage capacity utilisation | Time (Month) | Total waste disposed of or total capacity. | Total waste treated to be displayed below the chart heading. | - Month - Capacity utilisation (%). - Capacity utilisation (%) as compared to last year for the same month. |
|
Monthly waste collected vs monthly waste disposed | Column chart | Waste collected and waste dumped | Time (Month) | - Sum of waste collected. - Sum of waste disposed of. |
| - Month - Waste collected (absolute number and % increase decrease as compared to last year for the same month). - Waste disposed (absolute number and % increase or decrease as compared to last year for the same month). |
|
Total request by region | Table | NA | NA | Fields: - Serial number. - District - # of open requests. - # of closed requests. - # of total requests. - Completion rate (Percentage completion). - SLA achieved: Percentage. - Total collection. | - Selection to display the number of rows in a table. - Option to move to the next and the previous pages, and display the current page number. - Search by district name. - Show filters applied, if any. |
| Drilldown on district name to ULBs mapped in the district. |
Vehicle log report | Table | NA | NA | Fields: - Serial number. - ULB. - Volume of waste collected. - Volume of waste dumped. - Capacity utilisation (percentage). - Show comparison to last year. | - Selection to display the number of rows in a table. - Option to move to the next and the previous pages, and display the current page number. - Search by district name. - Show filters applied, if any. |
|
|
Workflow Desludging Application
Advance Balance Workflow
Application type | Status | Roles | Action | Next state |
Desludging |
| Citizen FSM_CREATOR_EMP | Create application | Application created |
Desludging | Application created | Citizen FSM_CREATOR_EMP | Submit application | Pending for payment |
Desludging | Pending for DSO assignment | FSM_EDITOR_EMP | Reject application | Application created |
Desludging | Pending for payment | Citizen | Pay for the number of trips (may be 0 to full) | Pending for DSO assignment |
Desludging | Pending for DSO assignment | FSM_EDITOR_EMP | Assign DSO | Pending for DSO approval |
Desludging | Pending for DSO assignment | FSM_EDITOR_EMP | Return application | Application created |
Desludging | Pending for DSO assignment | FSM_EDITOR_EMP | Reassign DSO | Pending for DSO approval |
Desludging | Pending for DSO approval | DSO FSM_EDITOR_EMP | Assign Vehicle | DSO in progress |
Desludging | Pending for DSO approval | DSO FSM_EDITOR_EMP | Reject | Pending for DSO assignment |
Desludging | DSO in progress | FSM_EDITOR_EMP DSO | Update the number of trips or schedule trips | DSO in progress |
Desludging | DSO in progress | Citizen | Pay (full amount) | DSO in progress |
Desludging | DSO in progress | FSM_EDITOR_EMP DSO | Dispose | DSO in progress |
Desludging | DSO in progress | DSO FSM_EDITOR_EMP | Complete request (after collecting the total amount) | Pending citizen feedback |
Desludging | Pending citizen feedback | Citizen | Citizen provides feedback | Request completed |
Application Type | Status | Action | Roles | Next State |
VehicleTrip |
| Schedules trip | FSM_DSO | SCHEDULED |
VehicleTrip | SCHEDULED | Ready for disposal | FSM_DSO" "FSM_EDITOR_EMP | Waiting for disposal |
VehicleTrip | Waiting for disposal | Dispose | FSM_EMP_FSTPO | DISPOSED |
Pay Later Workflow
Application Type | Status | Roles | Action | Next state |
Desludging |
| Citizen FSM_CREATOR_EMP | Create application | Application created |
Desludging | Application created | Citizen FSM_CREATOR_EMP | Submit application | Pending for DSO assignment |
Desludging | Pending for DSO assignment | FSM_EDITOR_EMP | Reject application | Application created |
Desludging | Pending for DSO assignment | FSM_EDITOR_EMP | Assign DSO | Pending for DSO approval |
Desludging | Pending for DSO assignment | FSM_EDITOR_EMP | Return application | Application created |
Desludging | Pending for DSO assignment | FSM_EDITOR_EMP | Reassign DSO | Pending for DSO approval |
Desludging | Pending for DSO approval | DSO FSM_EDITOR_EMP | Assign Vehicle | DSO in progress |
Desludging | Pending for DSO approval | DSO FSM_EDITOR_EMP | Reject | Pending for DSO assignment |
Desludging | DSO in progress | FSM_EDITOR_EMP DSO | Update the number of trips or schedule trips | DSO in progress |
Desludging | DSO in progress | Citizen | Pay (Full Amount) | DSO in progress |
Desludging | DSO in progress | FSM_EDITOR_EMP DSO | Dispose | DSO in progress |
Desludging | DSO in progress | DSO FSM_EDITOR_EMP | Complete Request (after collecting the total amount) | Pending citizen Feedback |
Desludging | Pending citizen feedback | Citizen | Citizen provides feedback | Request completed |
Application Type | Status | Action | Roles | Next state |
VehicleTrip |
| Schedules trip | FSM_DSO | SCHEDULED |
VehicleTrip | SCHEDULED | Ready for disposal | FSM_DSO" "FSM_EDITOR_EMP | Waiting for disposal |
VehicleTrip | Waiting for disposal | Dispose | FSM_EMP_FSTPO | DISPOSED |
Zero Price Workflow
Application Type | Status | Roles | Action | Next State |
Desludging | - | Citizen FSM_CREATOR_EMP | Create application | Application created |
Desludging | Application created | Citizen FSM_CREATOR_EMP | Submit application | Pending for payment |
Desludging | Pending for DSO assignment | FSM_EDITOR_EMP | Reject application | Application created |
Desludging | Pending for DSO assignment | FSM_EDITOR_EMP | Assign DSO | Pending for DSO approval |
Desludging | Pending for DSO assignment | FSM_EDITOR_EMP | Return application | Application created |
Desludging | Pending for DSO assignment | FSM_EDITOR_EMP | Reassign DSO | Pending for DSO approval |
Desludging | Pending for DSO approval | DSO FSM_EDITOR_EMP | Assign vehicle | DSO in progress |
Desludging | Pending for DSO approval | DSO FSM_EDITOR_EMP | Reject | Pending for DSO Assignment |
Desludging | DSO in progress | FSM_EDITOR_EMP DSO | update No of trips / schedule trip | DSO in Progress |
Desludging | DSO in progress | FSM_EDITOR_EMP | Reassign DSO | Pending for DSO approval |
Desludging | DSO in progress | FSM_EDITOR_EMP DSO | Dispose | DSO in progress |
Desludging | DSO in progress | DSO FSM_EDITOR_EMP | Complete request (after collecting the total amount) | Pending citizen feedback |
Desludging | Pending citizen feedback | Citizen | Citizen provides Feedback | Request completed |
Application Type | Status | Action | Roles | Next state |
VehicleTrip |
| Schedules trip | FSM_DSO | SCHEDULED |
VehicleTrip | SCHEDULED | Ready for disposal | FSM_DSO" "FSM_EDITOR_EMP | Waiting for disposal |
VehicleTrip | Waiting for Disposal | Dispose | FSM_EMP_FSTPO | DISPOSED |
Last updated