This is an old revision of the document!
Revised requirements for Trucks For You
Hirer use cases
Register and login
Hirer inputs phone number
If there are no previous records with the phone number, then the number is recorded into a new profile.
System records the input and sends an OTP to the phone number
The system prompts the hirer for the OTP
The hirer enters the OTP.
The system verifies the OTP.
If the OTP is incorrect, the hirer is told about it and given another chance.
If the OTP is correct, then the hirer is confirmed as a registered user.
If the hirer exits the app before keying in the correct OTP, then the hirer account is considered provisional.
After the entry of correct OTP, the system generates a token that is used by the app for all further communication on behalf of this hirer. This token is sent to the app.
The app stores the token and uses it in all further communication.
The system checks if the profile has a name.
If the profile doesn't have a name yet
The hirer is prompted.
The hirer enters name
The system saves the hirer's name
The hirer is redirected to wherever he/she was before login.
Request for a truck
The hirer inputs the following conditions.
Start city
End city
The earliest date on which goods are ready for loading
The latest date on which goods should be delivered
Load weight in tonnes
Type of truck: open, closed, container
Based on the hirer's conditions, the system generates suggestions. The suggestions do not point to individual trucks, but rather a combination of conditions that have been met. Each suggestion has the following field.
Date on which the truck will leave the start city.
Date on which the truck is expected to reach the end city.
Type of truck
Tonnage of truck
Normal tariff considering smooth delivery. The actual tariff will change based on events that happen during the trip and the delivery. Note that this tariff is calculated based on the load requested by the hirer and not the capacity of the truck, if a truck with a lower capacity is usually available with the system.
The hirer chooses one of the suggestions.
The system asks for the complete addresses of the source and destination facilities.
The hirer enters the complete addresses.
The system records the hirer's criteria and choice of suggestion. An SMS is sent to the hirer's number, informing them that a truck will be ready for their trip shortly.
The hirer waits for intimation about a truck.
Response to hire request
If the system does not have any trucks ready for the hirer, then a regret SMS is sent to the hirer.
If the system has a truck ready, then the system creates a confirmed trip and the following details are sent to the hirer.
Truck's registration number.
Driver's name.
Driver's phone number.
A hyperlink to the detailed page for the truck.
A hyperlink to the detailed page for the driver.
A hyperlink to confirm / cancel the trip.
A message saying that the trip must be cancelled within 3 hours. Otherwise the trip is assumed confirmed.
Driver's detailed page
The hirer can see the following details about a driver.
Full name
Passport photo
Photo of the driving license
Phone number, if the driver has been assigned to any trip requested by the hirer.
Truck's detailed page
The hirer can see the following details about a truck.
Registration number
Photo
Photo of RC book
Truck state intimation
The hirer is sent SMS messages whenever the state of the truck's trip changes.
The truck has arrived at the source facility for loading.
The truck has finished loading and weighing. The tare weight and gross weight are sent.
The truck is on the route.
The truck has arrived at the destination facility.
The truck has finished loading. The gross weight and tare weight are sent.
Request to pay
The system marks a trip as done.
If there are any unresolved disputes, the tariff amount is revised.
An SMS is sent to the hirer with the following details.
The total amount to be paid.
A hyperlink to the invoice, where a breakup is given along with the GST.
A link that takes the hirer to the payment gateway for payment.
Payment
The hirer opens the payment link.
The hirer is redirected to the payment gateweay.
The hirer pays the required tariff.
The payment is accepted and a receipt is shown.
The payment status of the trip is marked as paid.
Driver use cases
Get a list of applicable trips
Driver gets a list of requested trips for which he/she is eligible. Each trip has the following details.
Start city
End city
Date of start of trip
Date of end of trip
Tonnes of goods to carry
Tariff
The driver can see the details of a particular trip. the details are:
The full address of the loading point
The full address of the unloading point
Actively reject a trip
The driver actively chooses to reject a trip.
The system deletes the trip from the list of trips for that driver.
Pick a trip
The driver requests assignment to a trip.
If the trip is not already taken, it is assigned to him/her.
The system records the assignment and sends a notification to the hirer.
Get trip confirmation
The hirer of a trip chosen by the drive confirms the trip.
The trip status is marked as confirmed.
An SMS is sent to driver to notify confirmation of the trip.