edson152/Twin-Angels-International

Twin Angels International Development will operate as a professional online marketplace focused initially on: • Building Materials • Fabric Rolls • Printing Machines • Office Furniture • House Furniture The system will later scale into a full African marketplace platform. # 🦋 Twin Angels International Development — E-Commerce Platform Zimbabwe's premier online marketplace for Building Materials, Fabric Rolls, Printing Machines, Office & House Furniture. > **Inspired by Takealot · Built for Zimbabwe · Scales across Africa** --- ## 📋 Table of Contents 1. Project Overview 2. Tech Stack 3. Folder Structure 4. Getting Started (Local Dev) 5. Environment Variables 6. Database Setup 7. Deployment Guide 8. Admin Panel 9. Warehouse & Dispatch TVs 10. WhatsApp Notifications 11. Payment Methods 12. URL Reference 13. Roadmap --- ## 🏢 Project Overview ### What It Does - Full online ordering system with mobile-responsive design - Product management across 5 categories with FIFO warehouse processing - Multi-currency support (USD & ZiG) - Offline payment confirmation with manual admin verification - WhatsApp automated notifications at every order milestone - Dedicated TV dashboards for Warehouse and Dispatch operations - Delivery zone management with auto fee calculation - Admin panel for full site management ### Who Uses It | Role | Access | |------|--------| | **Customers** | Browse, order, track, WhatsApp support | | **Admin / IT Support** | Full site + order + content management | | **Warehouse Staff** | TV dashboard at `/warehouse` | | **Dispatch Staff** | TV dashboard at `/dispatch` | --- ## 🛠 Tech Stack | Layer | Technology | |-------|-----------| | Frontend | Next.js 14 (App Router) + TypeScript | | Styling | TailwindCSS + Google Fonts | | State | Zustand (cart + currency) | | Backend | Next.js API Routes (Node.js) | | Database | PostgreSQL | | Auth | JWT + bcrypt (httpOnly cookies) | | Hosting | Vercel (frontend) + Render or Railway (DB) | | Images | Cloudinary | | Notifications | WhatsApp Business API | | Payments | EcoCash · OneMoney · InnBucks · Bank Transfer · Visa/Mastercard | --- ## 📁 Folder Structure ``` twin-angels/ ├── src/ │ ├── app/ # Next.js App Router pages │ │ ├── page.tsx # Ho …