Distance Calculator

A web application that calculates the distance between two addresses. The application consists of a FastAPI backend and a Next.js frontend.

Features

• Calculate distance between two addresses
• View history of previous calculations
• Data persistence for search history

Prerequisites

Before running this application, make sure you have Docker installed on your machine:

• Docker Installation Guide

Running the Application

1. Clone the repository:

git clone dennisgera/deliverydist
cd deliverydist

2. Start the application using Docker Compose:

docker compose up

3. Access the application:

• Frontend: http://localhost:3000
• Backend API: http://localhost:8000

To rebuild the containers after making changes:

docker compose up --build

To stop the application:

docker compose down

API Endpoints

• GET /api/v1/queries - Get history of distance calculations
• POST /api/v1/queries - Calculate distance between two addresses

Development

If you want to develop the application locally, without using docker:

cd backend
poetry run app/db/db_management.py upgrade
cd ..
npm run install:all
npm run dev