NJ258/mpesa-smartinfo

Plataforma inteligente para localização de agentes M-Pesa e apoio a zonas com alta procura. # M-Pesa SmartInfo Plataforma web moderna para conectar clientes a agentes M-Pesa em Moçambique. ## 🎯 Visão Geral M-Pesa SmartInfo resolve o problema de clientes que viajam longas distâncias para encontrar agentes M-Pesa que estão fechados ou sem fundos. Com geolocalização automática, mapa interativo e comunicação em tempo real, o acesso a serviços M-Pesa fica mais fácil e confiável. ## 🚀 Features Principais ### 🎨 Interface Consolidada - ✅ **Cores M-Pesa** (Vermelho #E60000, Verde #00A818, Branco) - ✅ **Responsivo** (Mobile, Tablet, Desktop) - ✅ **Performance** (< 3s load time com Vite) - ✅ **Acessível** (WCAG compliant) ### 🗺️ Geolocalização - ✅ **Automática** ao abrir o mapa - ✅ **Tempo real** com GPS do dispositivo - ✅ **Fallback** para localização padrão - ✅ **Compatível** com iOS, Android, Desktop ### ⏱️ Seletor de Tempo Inteligente - ✅ **1-30 minutos** (sem "+15 genérico") - ✅ **Botões rápidos** (5, 10, 15, 20, 25, 30 min) - ✅ **Input personalizado** para qualquer tempo - ✅ **Validação** automática e feedback visual ### 📡 API Centralizada - ✅ **Cliente axios** único ponto de entrada - ✅ **Interceptadores** para auth/erros - ✅ **Tratamento robusto** de erros - ✅ **Bearer tokens** JWT automáticos - ✅ **Variáveis de ambiente** para dev/prod ### 👥 Tipos de Usuários 1. **Cliente** - Procura agentes e faz pedidos 2. **Agente** - Recebe pedidos e atualiza status 3. **Admin** - Gerencia agentes e sistema ## 📋 Pré-requisitos ```bash Node.js 16+ npm ou yarn Backend rodando em localhost HTTPS (produção) ``` ## 📦 Instalação ### 1. Clonar ```bash git clone github.com cd mpesa-smartinfo ``` ### 2. Frontend ```bash cd frontend npm install cp .env.example .env.local npm run dev ``` ### 3. Backend ```bash cd ../backend npm install npm run dev ``` Acesse: `localhost` ## 🏗️ Estrutura ``` mpesa-smartinfo/ ├── frontend/ # React + Vite + Tailwind │ ├── src/ │ │ ├── components/ …