# 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.
Driver 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.
* Citizens 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 | - If the logged-in user is a ULB employee, then pass this information internally.
- If the logged-in user is an STP/FSTP operator, then ask the user to select the ULB name as one STP can be attached to multiple ULBs.
|
| STP/FSTP name | Dropdown | Internally pass this information: We have mapping between ULB and STP/FSTP. |
| DSO name | Search | N - Auto-populate 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 | - If the logged-in user is a ULB employee, then pass this information internally.
- If the logged-in user is an admin, show for all the districts.
|
| ULB name | Dropdown | - If the logged-in user is a ULB employee, then pass this information internally.
- If the logged-in user is an admin, show for all the ULBs.
|
| 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:
1. Share via:
a. Image: Downloads image
b. Whatsapp: Image shared via Whatsapp
2. 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 |
| Bottom 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 versus monthly waste disposed off | 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 |