πͺπΉ Fetari (αα£αͺ) β An AI-powered product comparison platform that ranks sellers across Ethiopian marketplaces like Jiji, Shega, and more. Built with Django, React, and Claude API.
# πͺπΉ EthioCompare - Smart Price Comparison Engine
EthioCompare is a modern, high-performance web platform designed to aggregate, scrape, and compare product listings from popular online marketplaces in Ethiopia (such as Jiji, Shega, and local retail stores). It ranks listings and evaluates sellers to help users make smart shopping decisions.
---
## π Project Architecture
```text
ethiocompare/
β
βββ backend/ # Django REST Framework backend
β βββ config/ # Main settings, URLs, WSGI, and ASGI
β βββ apps/ # Modular backend applications
β β βββ users/ # Authentication, user roles, profile management
β β βββ products/ # Product and category catalog models
β β βββ sellers/ # Seller profiles, verification scoring, and reviews
β β βββ listings/ # Scraped marketplace listing indexer
β β βββ scraper/ # Scraper engine (Jiji, Shega, etc.)
β β βββ search/ # Search index, ranking, and filtration rules
β β βββ alerts/ # Price tracking and email/SMS alerts system
β βββ requirements.txt # Python dependencies list
β βββ manage.py # Django administrative utility
β
βββ frontend/ # React.js SPA (Vite Dev Server)
β βββ src/
β β βββ pages/ # Pages (Home, Search, Product Details, Profiles)
β β βββ components/ # Reusable components (SearchBar, SellerCard, RankBadge)
β β βββ api/ # API clients (Axios connection to Django REST)
β β βββ store/ # Global contexts (Authentication state, UI settings)
β βββ package.json # Frontend Node dependencies and build scripts
β βββ vite.config.js # Vite configuration settings
β
βββ README.md # System overview and developer instructions
```
---
## π Quick Start Guide
### 1. Prerequisites
Make sure you have **WSL** (Windows Subsystem for Linux), **Python 3.12+**, β¦