Rahma-tullah/solar-calculator-nigeria

# Solar Calculator - Nigeria A comprehensive solar energy calculator web application designed for the Nigerian market. Helps users estimate solar system requirements, costs, and connect with verified installers across Nigeria. ## 🌟 Features ### For Customers - **AI-Powered Calculator**: Analyze equipment lists and calculate precise power requirements - **Cost Estimation**: Get detailed cost breakdowns with realistic Nigerian market pricing - **Financial Planning**: Compare installment plans vs grid+fuel costs - **Installer Directory**: Find and connect with verified solar installers by location - **Calculation History**: Save and review past calculations (requires login) - **Lead Submission**: Submit inquiries directly to installers - **AI Chatbot**: Get instant answers about solar energy in Nigeria ### For Installers - **Business Accounts**: Create professional installer profiles - **Lead Management**: Receive and manage customer inquiries - **Profile Visibility**: Get discovered by potential customers in your area ### Technical Features - JWT-based authentication - AI integration (Google Gemini) for equipment analysis and chatbot - Email notifications via Nodemailer - Secure password hashing with bcrypt - Role-based access control - RESTful API architecture ## 🛠️ Tech Stack ### Backend - **Runtime**: Node.js - **Framework**: Express.js - **Database**: MySQL - **Authentication**: JSON Web Tokens (JWT) - **Password Security**: bcryptjs - **AI Integration**: Google Generative AI (Gemini) - **Email**: Nodemailer ### Frontend - **HTML5** - **CSS3** (custom styling) - **Vanilla JavaScript** - **Responsive Design** ## 📋 Prerequisites Before you begin, ensure you have: - Node.js (v14 or higher) - MySQL (v5.7 or higher) - Google AI API key (from Google AI Studio) - Gmail account with App Password (for email functionality) ## 🚀 Installation ### 1. Clone the repository ```bash git clone cd solcal ``` ### 2. Install dependencies ```bash npm install ``` # …