Muigaihacks/SIMplify-HomeFaiba

Catering for the transparent and automated process of selling of wifi packages from telcos to individual clients across the sub-saharan Africa space. # SIMplify HomeFaiba - WiFi Sales Management System A React-based frontend application for managing Home Fiber/WiFi sales for SIMplify, a Kenyan telco dealer management platform. This system allows field agents to digitize application forms and enables dealers to manage teams, track sales, and handle commission reconciliation. ## 🎯 Project Overview SIMplify HomeFaiba is a new vertical for the SIMplify platform that automates the sales and tracking process for Home Fiber/WiFi services. The system helps: - **Field Agents**: Digitize application forms, track installations, and view package information - **Dealers**: Manage sales teams, track sales records, calculate commissions, and reconcile with telcos ## 🛠️ Tech Stack - **Framework**: React 19 with TypeScript - **Build Tool**: Vite - **Styling**: Bootstrap 5.3.3 - **Icons**: FontAwesome 7.1.0 - **Routing**: React Router DOM 6.30.3 - **Mock API**: JSON-Server (for development) ## 📋 Features ### For Field Agents: 1. **Digital Application Form** - Multi-step form for customer enrollment 2. **Package Comparison Tool** - Visual comparison of WiFi packages 3. **Installation Tracker** - Track installation progress for customers 4. **Dashboard** - Overview of personal sales statistics ### For Dealers: 1. **Salesmen Directory** - Manage and view all field agents 2. **Sales Records** - Searchable dashboard of all applications 3. **Commission Dashboard** - Calculate and track commissions per agent 4. **Performance Leaderboard** - Rank agents by sales and commission 5. **Dashboard** - Overview of dealer statistics ## 🚀 Getting Started ### Prerequisites - Node.js 18+ (or 20+ recommended) - npm or yarn ### Installation 1. **Clone the repository** ```bash git clone github.com cd SIMplify-HomeFaiba ``` 2. **Install dependencies** ```bash cd frontend npm install ``` 3. **Start the mock API server** (in a separate terminal) ```bash # From the root directory npm install -g jso …