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:
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
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
Last updated