Thanks to visit codestin.com
Credit goes to github.com

Skip to content

English: Smart and interactive AI-powered web app for the Mercado Libre and Mercado Pago ecosystem support teams, featuring chat, feedback, and responsive design. Português: Aplicação web inteligente com IA para suporte das equipes do Ecossistema Mercado Livre e Mercado Pago, com chat, feedback e design responsivo.

License

boltreskh/Almail

Repository files navigation

Almail+ Official 1.0.0 - MELI Ecosystem Support

📘 This section is in English. For the Portuguese version, scroll down to the section marked "Versão em Português".

Almail+ is an intelligent web application designed to empower Mercado Libre and Mercado Pago support teams with AI-powered assistance. Built specifically for the MELI ecosystem, it provides specialized guidance for customer service representatives across multiple channels and business units.

🚀 Key Features

🤖 Ecosystem Intelligence

  • Smart Ecosystem Recognition: Automatically adapts responses based on Mercado Pago, Mercado Libre, or SOS contexts
  • Specialized AI Responses: Context-aware assistance tailored to each business unit's specific needs
  • SOS Restricted Mode: Secure, limited-scope responses for emergency support channels

💬 Advanced Chat Interface

  • Modern, responsive chat interface optimized for customer support workflows
  • Persistent Conversation History: All conversations securely stored in Firebase Firestore
  • Smart Conversation Management: Create, edit, delete, and organize support conversations
  • Real-time Response Generation: Dynamic AI responses with typing animations

🎨 Enhanced User Experience

  • Welcome Modal: Interactive onboarding experience showcasing new features
  • Modern Credits System: Beautiful team recognition with GitHub integration
  • Dark/Light Theme Toggle: Seamless theme switching with system preference detection
  • Responsive Design: Optimized for desktop, tablet, and mobile devices

🔒 Security & Performance

  • Anonymous Authentication: Secure Firebase authentication without personal data collection
  • Performance Optimized: Fast loading times and efficient resource management
  • Production Ready: Built with Vite for optimal performance and modern web standards

🆕 What's New in Official 1.0.0

Major Upgrades from Beta 1.4.0:

  • 🔄 Complete Architecture Rewrite: Migrated from vanilla JS to React with modern tooling
  • 🏢 Ecosystem Intelligence: AI now recognizes and adapts to MP, ML, and SOS environments
  • 🛡️ SOS Security Mode: Restricted AI responses for emergency support channels
  • ⚡ Performance Boost: 3x faster loading times with optimized bundling
  • 🎨 Modern UI/UX: Complete visual overhaul with consistent design language
  • 📱 Enhanced Responsiveness: Better mobile and tablet support
  • 🔐 Improved Security: Enhanced authentication and data protection
  • 🌟 Welcome Experience: Interactive onboarding for new users
  • 👥 Team Recognition: Beautiful credits system with developer profiles

Technical Improvements:

  • React 18 with modern hooks and state management
  • Vite build system for lightning-fast development
  • Tailwind CSS for consistent styling
  • Firebase 10 with improved security rules
  • ESLint integration for code quality
  • Modern browser compatibility

🏢 Technologies

Frontend Stack

  • React 18 - Modern component-based architecture
  • Vite - Lightning-fast build tool and development server
  • Tailwind CSS - Utility-first CSS framework
  • Lucide React - Beautiful, consistent icons

Backend & Services

  • Firebase 10 - Authentication, Firestore database, and hosting
  • Google Gemini AI - Advanced language model for intelligent responses
  • Anonymous Authentication - Secure user sessions without personal data

Development Tools

  • ESLint - Code quality and consistency
  • PostCSS - Advanced CSS processing
  • Modern ES Modules - Optimized JavaScript bundling

📁 Project Structure

almail/
├── public/
│   └── favicon.svg          # Application icon
├── src/
│   ├── App.jsx              # Main application component
│   ├── main.jsx             # Application entry point
│   └── index.css            # Global styles and Tailwind imports
├── index.html               # HTML template
├── package.json             # Dependencies and scripts
├── vite.config.js          # Vite configuration
├── tailwind.config.js      # Tailwind CSS configuration
└── eslint.config.js        # ESLint configuration

⚙️ Setup and Development

Prerequisites

  • Node.js 18+ and npm
  • Modern web browser
  • Firebase project (for production deployment)

Installation

git clone https://github.com/boltreskh/almail.git
cd almail
npm install

Development

npm run dev
# Opens development server at http://localhost:5173

Production Build

npm run build
npm run preview  # Preview production build

Code Quality

npm run lint     # Run ESLint

🌟 Team

Development Team

  • Lucas de Sousa Carneiro - Prompt Developer
  • Lucas Candido Luiz - Fullstack Developer (GitHub)
  • Vitória de Freitas Pinheiro - Prompt Developer

Collaboration

  • Mercado Libre & Mercado Pago Teams
  • Concentrix

📄 License

MIT License. See LICENSE file for details.


🛠️ Built with ❤️ for the MELI Ecosystem - Official Version 1.0.0


Almail+ Oficial 1.0.0 - Suporte Ecossistema MELI

📘 Esta seção está em português. Para a versão em inglês, volte para o topo ou procure pela seção "English Version".

Almail+ é uma aplicação web inteligente projetada para capacitar as equipes de suporte do Mercado Livre e Mercado Pago com assistência baseada em IA. Construído especificamente para o ecossistema MELI, fornece orientações especializadas para representantes de atendimento ao cliente em múltiplos canais e unidades de negócio.

🚀 Principais Funcionalidades

🤖 Inteligência de Ecossistema

  • Reconhecimento Inteligente: Adapta automaticamente as respostas baseado nos contextos Mercado Pago, Mercado Livre ou SOS
  • Respostas IA Especializadas: Assistência contextual personalizada para as necessidades específicas de cada unidade de negócio
  • Modo SOS Restrito: Respostas seguras e limitadas para canais de suporte de emergência

💬 Interface de Chat Avançada

  • Interface de chat moderna e responsiva otimizada para fluxos de trabalho de suporte ao cliente
  • Histórico Persistente: Todas as conversas armazenadas com segurança no Firebase Firestore
  • Gerenciamento Inteligente: Criar, editar, excluir e organizar conversas de suporte
  • Geração de Respostas em Tempo Real: Respostas dinâmicas de IA com animações de digitação

🎨 Experiência do Usuário Aprimorada

  • Modal de Boas-Vindas: Experiência interativa de onboarding apresentando novas funcionalidades
  • Sistema de Créditos Moderno: Belo reconhecimento da equipe com integração GitHub
  • Alternância de Tema Claro/Escuro: Troca suave de temas com detecção de preferência do sistema
  • Design Responsivo: Otimizado para desktop, tablet e dispositivos móveis

🔒 Segurança e Performance

  • Autenticação Anônima: Autenticação Firebase segura sem coleta de dados pessoais
  • Performance Otimizada: Tempos de carregamento rápidos e gerenciamento eficiente de recursos
  • Pronto para Produção: Construído com Vite para performance otimizada e padrões web modernos

🆕 Novidades na Versão Oficial 1.0.0

Principais Atualizações da Beta 1.4.0:

  • 🔄 Reescrita Completa da Arquitetura: Migração de JS vanilla para React com ferramentas modernas
  • 🏢 Inteligência de Ecossistema: IA agora reconhece e adapta aos ambientes MP, ML e SOS
  • 🛡️ Modo de Segurança SOS: Respostas IA restritas para canais de suporte de emergência
  • ⚡ Aumento de Performance: Tempos de carregamento 3x mais rápidos com bundling otimizado
  • 🎨 UI/UX Moderna: Reformulação visual completa com linguagem de design consistente
  • 📱 Responsividade Aprimorada: Melhor suporte para mobile e tablet
  • 🔐 Segurança Melhorada: Autenticação aprimorada e proteção de dados
  • 🌟 Experiência de Boas-Vindas: Onboarding interativo para novos usuários
  • 👥 Reconhecimento da Equipe: Belo sistema de créditos com perfis dos desenvolvedores

Melhorias Técnicas:

  • React 18 com hooks modernos e gerenciamento de estado
  • Sistema de build Vite para desenvolvimento ultra-rápido
  • Tailwind CSS para estilização consistente
  • Firebase 10 com regras de segurança melhoradas
  • Integração ESLint para qualidade de código
  • Compatibilidade com navegadores modernos

🏢 Tecnologias

Stack Frontend

  • React 18 - Arquitetura moderna baseada em componentes
  • Vite - Ferramenta de build e servidor de desenvolvimento ultra-rápido
  • Tailwind CSS - Framework CSS utility-first
  • Lucide React - Ícones bonitos e consistentes

Backend e Serviços

  • Firebase 10 - Autenticação, banco Firestore e hospedagem
  • Google Gemini AI - Modelo de linguagem avançado para respostas inteligentes
  • Autenticação Anônima - Sessões de usuário seguras sem dados pessoais

Ferramentas de Desenvolvimento

  • ESLint - Qualidade e consistência de código
  • PostCSS - Processamento CSS avançado
  • Módulos ES Modernos - Bundling JavaScript otimizado

📁 Estrutura do Projeto

almail/
├── public/
│   └── favicon.svg          # Ícone da aplicação
├── src/
│   ├── App.jsx              # Componente principal da aplicação
│   ├── main.jsx             # Ponto de entrada da aplicação
│   └── index.css            # Estilos globais e imports do Tailwind
├── index.html               # Template HTML
├── package.json             # Dependências e scripts
├── vite.config.js          # Configuração do Vite
├── tailwind.config.js      # Configuração do Tailwind CSS
└── eslint.config.js        # Configuração do ESLint

⚙️ Configuração e Desenvolvimento

Pré-requisitos

  • Node.js 18+ e npm
  • Navegador web moderno
  • Projeto Firebase (para deploy em produção)

Instalação

git clone https://github.com/boltreskh/almail.git
cd almail
npm install

Desenvolvimento

npm run dev
# Abre o servidor de desenvolvimento em http://localhost:5173

Build de Produção

npm run build
npm run preview  # Visualizar build de produção

Qualidade de Código

npm run lint     # Executar ESLint

🌟 Equipe

Time de Desenvolvimento

  • Lucas de Sousa Carneiro - Desenvolvedor do Prompt
  • Lucas Candido Luiz - Desenvolvedor Fullstack (GitHub)
  • Vitória de Freitas Pinheiro - Desenvolvedora do Prompt

Colaboração

  • Times do Mercado Livre & Mercado Pago
  • Concentrix

📄 Licença

Licença MIT. Veja o arquivo LICENSE para detalhes.


🛠️ Construído com ❤️ para o Ecossistema MELI - Versão Oficial 1.0.0

About

English: Smart and interactive AI-powered web app for the Mercado Libre and Mercado Pago ecosystem support teams, featuring chat, feedback, and responsive design. Português: Aplicação web inteligente com IA para suporte das equipes do Ecossistema Mercado Livre e Mercado Pago, com chat, feedback e design responsivo.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published