User story

[krutarth4]

Create some user story to see how it works for customer or stakeholder in normal day to day life

[vahidjb]

For Farmers/Brokers (Senders) 1. Registration and Profile Setup User Story: As a farmer/broker, I want to create a profile with my business information, so that I can start using the logistics platform.

Acceptance Criteria:

• Collect business details, contact information, and produce types.
• Allow users to set preferences for shipping frequency and preferred booking times.

2. Price Model Setup User Story: As a farmer/broker, I want to see the price per kilometer when I request a rider, so that I can make informed decisions about the cost of transport.

Acceptance Criteria:

• Display rider's price per kilometer during the order request process.
• Show a summary of the estimated total cost before confirming the order, including any additional fees.
• Provide an option to confirm or cancel the order based on the estimated cost

3. Suggestion and Filtering User Story: As a farmer/broker, I want to see prioritized suggestions for truck owners based on my needs, so that I can quickly find suitable transport options. Acceptance Criteria:

• Present a list of truck owners with filters such as type of vehicle, price, capacity, rating, and batch or single path order.
• Allow users to sort and filter results based on their preferences.
• Provide detailed profiles of truck owners including vehicle types, capacity, and equipment. Farmer should access to full profile data of riders.
• Show rider ratings as stars (for MVP, collect ratings by phone surveys with customers and farmers and update in an Excel sheet monthly).

4. Order Request and Matching System User Story: As a farmer/broker, I want to submit a transport request and have the system match my order with other nearby orders, so that I can reduce transportation costs. Acceptance Criteria: I wrote in detail but we can choose main ones

   Submission of Detailed Transport Requests

• Form Fields: Ensure the transport request form includes fields for:

• Pickup location (address, zip code)

• Delivery location (address, zip code)

• Pickup date and time

• Delivery date and time

• Type of goods (e.g., perishable, non-perishable, fragile)

• Quantity and volume of goods

• Special handling requirements (e.g., temperature control, fragile handling)

• Validation: Validate all fields to ensure completeness and accuracy before submission.

• Save and Edit: Allow users to save draft requests and edit them before final submission.

  2. Matching Principles and Algorithm

• Geographic Proximity: Match orders based on geographic proximity of pickup and delivery locations.

• Radius Filter: Implement a configurable radius filter (e.g., within 50 km) to find nearby orders.

• Time Windows: Consider the pickup and delivery time windows to ensure compatibility.

• Overlap Tolerance: Allow a configurable tolerance for time overlaps (e.g., +/- 2 hours).

• Type of Goods: Match orders with similar handling requirements to optimize transport efficiency.

• Category Matching: Categorize goods (e.g., perishable, non-perishable) and match within the same category.

• Vehicle Capacity: Ensure the combined volume and weight of pooled orders do not exceed the vehicle's capacity.

• Capacity Check: Calculate the total volume and weight of matched orders and compare with available vehicle capacity.

• 3,Display of Potential Cost Savings and Route Details

• Cost Breakdown: Display a detailed cost breakdown showing potential savings from pooling orders.

• Original Cost: Show the original cost if the order were transported individually.

• Pooled Cost: Show the reduced cost when the order is pooled.

• Savings: Highlight the total savings amount and percentage.

  4,Confirmation of Pooled Transport Details

• Detailed Confirmation: Send a detailed confirmation to both the farmer/broker and the rider.

• Order Summary: Include an order summary with pickup and delivery details, type of goods, quantity, and handling requirements.

• Route Details: Provide the final optimized route with all stops and estimated times.

• Cost Breakdown: Include a final cost breakdown showing the pooled cost and savings.

• Notifications: Send confirmation notifications via email and SMS to both parties.

• Email Content: Provide a comprehensive summary in the email.

• SMS Content: Send a concise summary with a link to view full details online.

5. Incentive System User Story: As a farmer, I want to receive vouchers for accepting pooled transport offers, so that I am encouraged to use this cost-saving option. Acceptance Criteria:

• Provide a clear explanation of the voucher system when a pooling option is presented. Show present incentives on this orders like 5% discount for next order.
• Issue vouchers automatically upon acceptance of a pooling offer.
• Send confirmation of issued vouchers via email and SMS.

6. Payment Options User Story: As a farmer/broker, I want to choose between online or cash payment options, so that I have flexibility in how I pay for transport services. Acceptance Criteria:

• Provide an option to select the payment method during the order request process.
• Offer secure online payment processing.
• Provide confirmation of cash payment instructions.
• Payment could be held in SHYFTX's account until delivery confirmation, ensuring reliability and trust.

7. Order Management System User Story: As a farmer/broker, I want to track the progress of ongoing orders and access archived orders, so that I can manage my shipments effectively. Acceptance Criteria:

• Provide a dashboard to track ongoing orders with status updates (e.g., accepted, preparing for pickup, in transit, delivered).
• Allow access to archived orders for reference and record-keeping.
• Send notifications via email and SMS for order acceptance, rejection, preparation for pickup, and delivery confirmation.

8. Notifications for Order Status User Story: As a farmer/broker, I want to receive notifications by email and SMS when my order is accepted or rejected, is being prepared for pickup, and when it is delivered, so that I stay informed about the status of my shipments. Acceptance Criteria:

• Send confirmation notifications via email and SMS upon order acceptance and rejection.
• Notify users when it is time to prepare for pickup.
• Confirm delivery completion through email and SMS notifications.

9. Contract Agreement User Story: As a farmer/broker, I want to sign a standard contract agreement with truck owners, so that I can ensure clarity and compliance with legal requirements. Acceptance Criteria:

• Provide a standard contract template during the registration process.
• Ensure both parties sign the contract before commencing services.
• Store the signed contract in the user’s profile and send a copy via email to both parties.

For Riders (Truck Owners)

1. Registration and KYC User Story: As a rider, I want to complete a registration process that includes KYC and vehicle information, so that I can start receiving transport orders. Acceptance Criteria:

• Collect and verify personal identification (e.g., government-issued ID).
• Collect and verify vehicle information (e.g., vehicle type, registration number, capacity, insurance details).
• Allow riders to set their price per kilometer during the registration process.
• Ensure the profile is saved and can be updated as needed.

2. Order Notifications User Story: As a rider, I want to receive notifications about new orders via the app and SMS, so that I can quickly decide whether to accept or cancel them. Acceptance Criteria:

• Send real-time notifications for new orders through the app and SMS.
• Provide details about the order, including pickup location, destination, and price.

3. Order Acceptance and Management User Story: As a rider, I want to access load details and status updates for my orders, so that I can manage my transport efficiently. Acceptance Criteria:

• Allow riders to accept or cancel orders through the app.
• Provide access to load details, pickup date, and status updates for each order.
• Include navigation links to optimized routes for single or batched orders.

4. Order Management System User Story: As a rider, I want to track the progress of ongoing orders and access archived orders, so that I can manage my deliveries effectively. Acceptance Criteria:

• Provide a dashboard to track ongoing orders with status updates (e.g., accepted, preparing for pickup, in transit, delivered).
• Allow riders to access archived orders for reference and record-keeping.
• Send notifications via email and SMS for order acceptance, rejection, preparation for pickup, and delivery confirmation.

5. Notifications for Order Status User Story: As a rider, I want to receive notifications by email and SMS when I accept or reject an order, prepare for pickup, and deliver the order, so that I stay informed about my tasks. Acceptance Criteria:

• Send confirmation notifications via email and SMS upon order acceptance and rejection.
• Notify riders when it is time to prepare for pickup.
• Confirm delivery completion through email and SMS notifications.

6. Contract Agreement User Story: As a rider, I want to sign a standard contract agreement with farmers/brokers, so that I can ensure clarity and compliance with legal requirements. Acceptance Criteria:

Same for farmers.

[vahidjb]

User stories updated. We should talk and decide which ones exactly going to present @krutarth4

[krutarth4]

User stories updated. We should talk and decide which ones exactly going to present @krutarth4

you mean which one to select for the presentation(final pitch )?

[vahidjb]

@krutarth4 Yep!

[krutarth4]

Trucks category

Transporting goods requires different types of trucks, each designed to handle specific types of cargo. Here are some common types of trucks and their specifications:

Flatbed Trucks:
    Description: These trucks have a flat, open bed with no sides or roof.
    Usage: Ideal for transporting oversized or irregularly shaped cargo, construction materials, and heavy machinery.
    Specifications: Usually, no temperature control; focus on load securing mechanisms.

Box Trucks (Dry Vans):
    Description: Enclosed rectangular cargo area, often used for moving goods locally.
    Usage: Common for transporting furniture, non-perishable goods, and appliances.
    Specifications: Standardized sizes, no temperature control, weather protection.

Refrigerated Trucks (Reefers):
    Description: Insulated and equipped with a refrigeration unit.
    Usage: Transport perishable goods like food, pharmaceuticals, and flowers.
    Specifications: Temperature control from below freezing to ambient, humidity control, data logging for temperature monitoring.

Tanker Trucks:
    Description: Cylindrical tank designed to carry liquids or gases.
    Usage: Transporting fuel, chemicals, milk, and other liquids.
    Specifications: Often have compartments, temperature control for certain liquids, special coatings for corrosion resistance.

Flatbed with Conestoga:
    Description: Flatbed with a retractable tarping system.
    Usage: Provides the flexibility of a flatbed with the protection of a dry van.
    Specifications: No temperature control, ease of loading/unloading, weather protection.

Dump Trucks:
    Description: Open-box bed hinged at the rear, hydraulic pistons lift the front.
    Usage: Transporting loose materials like sand, gravel, or demolition waste.
    Specifications: No temperature control, heavy-duty construction, specific weight limits.

Livestock Trucks:
    Description: Designed to transport live animals.
    Usage: Moving cattle, sheep, pigs, and other livestock.
    Specifications: Ventilation systems, non-slip flooring, partitions for animal separation, sometimes temperature control.

Curtainside Trucks:
    Description: Sides covered by a tarpaulin, can be opened for loading/unloading.
    Usage: Versatile for various types of cargo needing side loading.
    Specifications: No temperature control, flexibility for loading/unloading, weather protection.

Lowboy Trailers:
    Description: Very low deck height.
    Usage: Transporting heavy equipment and machinery.
    Specifications: No temperature control, low center of gravity for stability, various deck lengths.

Car Carrier Trucks:
    Description: Multi-level carriers designed for transporting cars.
    Usage: Delivering new and used vehicles.
    Specifications: No temperature control, loading ramps, multiple vehicle capacities.

Side-lifter Trucks:
    Description: Equipped with cranes or lifts on the sides.
    Usage: Loading and unloading shipping containers without additional equipment.
    Specifications: No temperature control, hydraulic systems for lifting, container locks.

Hopper Trucks:
    Description: Funnel-shaped containers for transporting bulk dry goods.
    Usage: Grain, coal, sand, and similar materials.
    Specifications: No temperature control, gravity unloading, various capacities.

Box Trucks with Liftgate:
    Description: Enclosed cargo area with a hydraulic lift at the rear.
    Usage: Easier loading/unloading of heavy items, especially without loading docks.
    Specifications: Lift capacity specifications, no temperature control, standard box truck features.

Dry Bulk Trucks:
    Description: Enclosed tanks for dry bulk materials.
    Usage: Transporting powdered cement, flour, plastic pellets.
    Specifications: No temperature control, pressurized unloading systems, specific material handling designs.