zamtelsd-max/zamgrow-exchange

🌾 Zambia's #1 Intelligent Agricultural Marketplace — React PWA + Node.js API + Python AI Pricing Engine + Docker + GitHub Actions CI # 🌾 Zamgrow Exchange ### Zambia's #1 Intelligent Agricultural Marketplace **Connect. Trade. Grow.** --- ## 📋 Overview Zamgrow Exchange is a full-stack agricultural marketplace built specifically for Zambia, connecting **12,000+ farmers**, buyers, and agro-dealers across all 10 provinces. The platform features AI-powered price intelligence, mobile money integration, and real-time market data. ## ✨ Features - 🤖 **AI Price Intelligence** — ML-powered price suggestions with confidence scores - 📱 **Mobile Money Integration** — MTN, Airtel, and Zamtel payment support - 🗺️ **Province Heatmap** — Interactive price visualization across Zambia's 10 provinces - 💬 **Offer Negotiation** — Real-time chat-style offer/counter-offer system - 🔔 **Price Alerts** — SMS notifications when target prices are reached - 🛡️ **Verified Traders** — NRC and business registration verification - 📊 **Market Dashboard** — 6-month price history charts with trend analysis - 🌐 **PWA Support** — Works offline on any phone - 👤 **Role-based Access** — Farmer, Buyer, Dealer, Admin roles - 💎 **Subscription Tiers** — Free, Basic (K99), Pro (K249), Premium (K599) ## 🏗️ Architecture ``` ┌─────────────────────────────────────────────────────┐ │ Frontend (PWA) │ │ React 18 + TypeScript + TailwindCSS │ │ Vite · Redux Toolkit · Port 3000 │ └──────────────────────┬──────────────────────────────┘ │ HTTP / WebSocket ┌──────────────────────▼──────────────────────────────┐ │ Backend API │ │ Node.js + Express + TypeScript │ │ Prisma ORM · Socket.IO · Port 3001 │ └───────┬──────────────────────────┬──────────────────┘ │ Prisma │ HTTP ┌───────▼──────┐ ┌────────▼──────────────────┐ │ PostgreSQL │ │ Pricing Engine │ │ (Port 5432) │ │ Python FastAPI + NumPy │ │ + Redis │ │ Por …