AbdulmalikAlayande/Amala-Atlas

Community-driven location intelligence platform for discovering, mapping, and verifying Nigeria's best Amala food spots — powered by WhatsApp bot submissions, AI discovery agents, and human verification. Because the best Amala spots don't have Google listings. # Amala Atlas A community-driven location intelligence platform for discovering, mapping, and verifying **Amala food spots** across Nigeria. We specialize in finding obscure, undocumented, and informal locations that fly under the radar of mainstream directories like Google Maps. ## The Problem Nigeria's best Amala spots are invisible online. They don't have websites, Google listings, or social media pages. They're known by word of mouth: "Iya Basira under the bridge in Mokola" or "that buka behind the market in Surulere." This knowledge lives in people's heads and WhatsApp groups — not on the internet. ## The Solution Instead of scraping the web for data that doesn't exist, we go where the knowledge is: **the people who eat Amala every day**. Amala Atlas turns community knowledge into verified map data through multiple discovery channels, all feeding into a single verification pipeline. ## How It Works ``` User eats Amala -> Their spot is missing from the map -> They submit via WhatsApp/web -> Spot gets verified -> Appears on the map -> User shares "I added my spot" -> Friends see it -> Their spots are missing -> They submit -> Cycle repeats ``` ## System Architecture This project is organized as a monorepo hub with three components: ``` amala-atlas/ ├── amala-atlas-backend-api/ # Django REST API — the system of record ├── amala-atlas-auto-discovery/ # Scrapy-based web crawler (archived) └── amala-atlas-explorer/ # React frontend (separate repo) ``` | Component | Role | Tech | Repo | |-----------|------|------|------| | **Backend API** | System of record — ingestion, verification, spot lifecycle | Django 5.x, DRF, PostgreSQL | amala-atlas-backend-api | | **Auto-Discovery** | Web crawler for bootstrapping data (archived — replaced by lightweight agents in the backend) | Scrapy, spaCy, SQLAlchemy | amala-atlas-auto-discovery | | **Frontend** | Map UI for browsing, searching, and submitting spots | React, Vercel | amala-atlas-ex …