Welcome to JOI Delivery

JOI Delivery is built for real life. For the young professional who gets home late and doesn’t have the energy to cook. For the student with an exam tomorrow and an empty fridge tonight. These aren’t exceptions — they’re everyday moments. That’s why JOI Delivery brings food and groceries to your door, fast, fresh, and right when you need them.

Customers struggle with:

• Cluttered browsing experiences that don’t understand their preferences.
• Limited customization when ordering meals or groceries.
• Unclear order status or delivery timelines.
• Poor payment experience, or failed checkouts.
• Lack of timely feedback channels to report a bad experience or appreciate a good one.

JOI Delivery was built not just as another delivery app, but as a thoughtful, technology-first platform that reimagines how essentials reach customers in the most seamless way.

Introducing JOI Delivery

JOI Delivery, launched in 2024, is a hyperlocal delivery app designed to bring food and groceries to your doorstep in under 45 minutes. With the tagline "Speed meets convenience," it connects customers to nearby restaurants and stores through a seamless digital experience. The app solves the hassle of long wait times and limited local options by offering real-time tracking, instant order updates, and a wide network of trusted vendors.

Business Goals

• Differentiated Value Proposition & Niche Dominance
• Deliver Unmatched Customer Experience & Loyalty
• Superior Operational Efficiency & Cost Advantage
• Robust & Engaged Partner Ecosystem

Why they need Thoughtworks help

As JOI Delivery continues to grow and serve more neighborhoods, we’re scaling our platform to handle increasing demand, enhance user experience, and support smarter delivery logistics. They're looking for passionate developers to help us build robust, efficient, and scalable solutions that power everything from order placement to real-time tracking. Your expertise will directly impact how quickly and reliably customers receive their essentials—and how smoothly local vendors and delivery partners operate within our ecosystem.

Users/Customers

Sample user profiles are available in the repository to support development and testing scenarios.

UserId	FirstName	LastName
user101	John	Doe

Stores

Sample store data seeded for development purposes only.

StoreId	OutletName
store101	Fresh Picks
store102	Natural Choice

Grocery Products

Dummy Products for Stores to sell and users to buy from.

ProductId	ProductName	StoreRefId
product101	Wheat Bread	store101
product102	Spinach	store101
product103	Crackers	store101

API

Below is a list of API endpoints with their respective input and output. Please note that the application needs to be running for the following endpoints to work. For more information about how to run the application, please refer to run the application section above.

Add Product to Cart

POST /cart/product
Content-Type: application/json

Request Body

{
  "userId": "user101",
  "productId": "product101",
  "outletId": "store101"
}

Response Body

{
  "cart": {
    "cartId": "cart101",
    "outlet": null,
    "products": [
      {
        "productId": "product103",
        "productName": "Crackers",
        "mrp": 10.5,
        "sellingPrice": null,
        "weight": 500,
        "expiryDate": 0,
        "threshold": 10,
        "availableStock": 30,
        "discount": null,
        "store": {
          "name": "Fresh Picks",
          "description": null,
          "outletId": "store101",
          "inventory": []
        }
      }
    ],
    "user": null
  },
  "product": {
    "productId": "product103",
    "productName": "Crackers",
    "mrp": 10.5,
    "sellingPrice": null,
    "weight": 500,
    "expiryDate": 0,
    "threshold": 10,
    "availableStock": 30,
    "discount": null,
    "store": {
      "name": "Fresh Picks",
      "description": null,
      "outletId": "store101",
      "inventory": []
    }
  },
  "sellingPrice": null
}

View Cart

GET /cart/view?userId=user101

Response Body

{
  "id": "cart101",
  "outlet": null,
  "user": {
    "id": "user101",
    "username": "",
    "firstName": "John",
    "lastName": "Doe",
    "email": "",
    "phoneNumber": "",
    "cart": null
  },
  "products": []
}

Inventory Health

GET /inventory/health?storeid=<storeid>

Response Body

{
    // to be implemented.
}

Tech Requirements & Quick Setup

Prerequisites

• Go 1.24.5 or higher (refer—https://go.dev/doc/install)

1. Clone and Setup

git clone git@github.com:techops-recsys-lateral-hiring/joi-delivery-golang.git
cd joi-delivery-golang

2. Install Dependencies

make deps

3. Run Tests

make test

4. Start the Server

make run

The server will start on http://localhost:8080

Development Commands

The project includes a Makefile with common development tasks:

Command	Description
make run	Run the application locally
make test	Run all tests
make deps	Download dependencies
make tidy	Tidy go.mod and go.sum