Monorepo Project

This repository hosts a microservices-based architecture for a grocery price comparison platform. It aggregates product data from multiple external retailers to give to the end-user the ability to compare prices.

Tech Stack 💻

Core

Infrastructure

Observability

Project Structure

• apps/comparator: Responsible for get data from external APIs, normalize it and save it in database, and compare data from different retailers. Plus, it has a web interface to show the results, give the user the ability to search for products and compare prices.
  • comparator-api: (under development).
  • comparator-web: (under development).
• apps/external-apis: Contains API services. Dedicated services for fetching and normalizing data from specific retailers:
  • continente-api: Laravel 12 API service.
  • aldi-api: Node.js/TypeScript API service using Drizzle ORM.
  • lidl-api: .NET Core API service using Entity Framework with SQL Server.
• infra: Infrastructure configurations (Docker Compose, Nginx, Observability).

How to Run

To run the project, ensure you have Docker and Docker Compose installed.

Application Stack

Continente API

Start the service:

docker-compose -f infra/docker-compose.continente.yml up -d --build --scale continente-api=3

Access the application at http://localhost:3001.

Aldi API

Start the service:

docker-compose -f infra/docker-compose.aldi.yml up -d --build

Access the application at http://localhost:3333.

Lidl API

Start the service:

docker-compose -f infra/docker-compose.lidl.yml up -d --build

Access the application at http://localhost:3004.

Observability Stack

To run the observability stack (Loki, Promtail, Grafana):

docker-compose -f infra/docker-compose.observability.yml up -d

• Grafana: http://localhost:3000 (User: admin, Password: admin)
• Loki: http://localhost:3100

1. Access http://localhost:3000.
2. Go to Connections -> Data sources.
3. Search for Loki, and set http://loki:3100 in the URL field.

RabbitMQ

http://localhost:15672

(user/pass: guest/guest)