aggreypaintsil168/greenpulse

GreenPulse - Ghana's Integrated Waste Intelligence Ecosystem (Global Challenge 2026) # GreenPulse 🌿 ### Ghana's First Integrated Waste Intelligence Ecosystem **Global Challenge Lab 2026 | Smart Cities Track | University of Ghana, Legon** --- ## Project Structure ``` greenpulse/ ├── greenpulse-frontend/ ← React + Vite (deploy to Vercel) ├── greenpulse-backend/ ← Node.js + Express + Prisma (deploy to Render) └── greenpulse-routing/ ← Python + FastAPI (deploy to Render) ``` --- ## Five User Roles | Role | Entry Point | What they do | |------|------------|--------------| | **Citizen** | `/report` | Scan QR code, report choked drain, earn GreenPoints | | **Collector** | `/login` | Accept drain jobs, clear waste, log weight → auto-listed on marketplace | | **Recycler** | `/recycler/login` | Browse sorted waste, place orders, dispatch tricycles | | **City Admin** | `/dashboard` | View live heatmap, KPIs, flood-risk forecasts | | **Any visitor** | `/` | Landing page, /recycler info portal | --- ## Quick Start (Local Development) ### 1. Prerequisites ```bash node --version # need v18+ python --version # need v3.10+ ``` ### 2. Clone & set up all three repos ```bash mkdir greenpulse && cd greenpulse git clone github.com git clone github.com git clone github.com ``` ### 3. Backend setup ```bash cd greenpulse-backend npm install # Copy env file and fill in your values cp .env.example .env # Edit .env: add your Neon DATABASE_URL, Cloudinary keys npx prisma generate npx prisma db push npm run seed # loads test data including recyclers + tricycles npm run dev # starts on localhost ``` ### 4. Frontend setup ```bash cd ../greenpulse-frontend npm install cp .env.example .env # .env already points to localhost:3001 by default npm run dev # starts on localhost ``` ### 5. Routing service (optional — backend has fallback) ```bash cd ../greenpu …