KwenaMokoka/PropertyApp

PropertyIQ — South African property due diligence in seconds. Price trends, crime analysis, and AI-powered investment scores for suburbs across Gauteng, KwaZulu-Natal, and the Western Cape. # PropertyIQ 🏘 Property due diligence for South Africa, done in seconds. PropertyIQ turns scattered property and safety data into a single, clear investment picture. Search any suburb across **Gauteng**, **KwaZulu-Natal (Durban)**, and the **Western Cape** to see where prices are heading, whether crime is improving or worsening, and what it all means for a buyer or investor. ## Features - **Price intelligence** — historical average/median prices, total growth, and compound annual growth rate (CAGR) - **Crime analysis** — year-on-year crime trends classified as improving, stable, or worsening - **AI investment score** — a 0–100 score with a plain-English verdict combining price and crime signals - **Compare areas** — side-by-side analysis of 2–4 suburbs with an automatic "best pick" - **Browse by area** — explore all covered suburbs grouped by province - **Most improved** — top-performing suburbs by price growth over a 3-year window - **Alerts** — subscribe by email to be notified when an area shows improvement or decline - **PDF export** — download any report as a clean, printable PDF ## Tech stack - **Backend:** FastAPI, SQLAlchemy, SQLite, Pydantic - **Frontend:** React, Vite, Tailwind CSS, Recharts - **Infra:** Docker, Docker Compose, Nginx ## Quick start (Docker) ```bash docker compose up --build ``` - Frontend → localhost - API → localhost - API docs → localhost ## Local development ### Backend ```bash cd property-intelligence-backend python -m venv venv venv\Scripts\activate # Windows pip install -r requirements.txt python seed.py # load sample data uvicorn app.main:app --reload ``` ### Frontend ```bash cd property-intelligence-frontend npm install npm run dev ``` ## Project structure ``` property-intelligence-backend/ FastAPI service (models, routers, services, analytics) property-intelligence-frontend/ React + Vite SPA docker-compose.yml Runs both services tog …