Skip to content

GabrielRibeiroRodrigues/Inclua-AI

Repository files navigation

🚀 Inclua-AI - Assistente de Acessibilidade com IA

Inclua-AI Status Versão

Uma revolução em acessibilidade web com inteligência artificial

O Inclua-AI é uma solução completa de acessibilidade que combina ferramentas tradicionais com o poder da Inteligência Artificial para criar experiências web verdadeiramente inclusivas.

✨ Principais Funcionalidades

🎨 Ajustes Visuais Avançados

  • Modo Escuro Inteligente: Inverte cores mantendo legibilidade
  • Controle de Fonte: Ajuste dinâmico de +400% a -40%
  • Destaque de Links: Realça todos os elementos interativos
  • Filtros para Daltonismo: Protanopia, Deuteranopia, Tritanopia, Acromatopsia

🔊 Assistente de Leitura

  • Leitor de Texto: Narração em português brasileiro
  • Seleção Inteligente: Reconhece contexto do texto
  • Múltiplas Vozes: Compatível com vozes do sistema

🤖 IA para Acessibilidade (NOVO!)

🖼️ Descrição Inteligente de Imagens

  • Análise automática usando Google Gemini 1.5 Flash
  • Descrições contextuais detalhadas
  • Geração automática de alt-text
  • Suporte para imagens complexas e diagramas

📝 Simplificação de Texto

  • Reescrita em linguagem simples
  • Mantém informações importantes
  • Ideal para pessoas com dislexia ou dificuldades cognitivas
  • Processamento de textos até 5.000 caracteres

🧮 Explicador de Matemática

  • Converte fórmulas em linguagem natural
  • Explicações passo a passo
  • Contexto e aplicações práticas
  • Níveis de complexidade adaptáveis

🎨 Analisador de Contraste

  • Verificação WCAG 2.1 completa
  • Sugestões de cores acessíveis
  • Análise AA/AAA automática
  • Cores alternativas inteligentes

Verificador de Acessibilidade

  • Análise completa da página
  • Detecção de problemas WCAG
  • Relatórios detalhados
  • Sugestões de correção

🏗️ Arquitetura Técnica

Frontend (Widget)

// Widget modular e responsivo
class IncluaAIWidget {
    - Interface moderna com CSS Grid/Flexbox
    - Animações suaves e microinterações
    - Suporte completo a teclado
    - Modo escuro automático
    - Armazenamento local de preferências
}

Backend (API)

// Servidor Express com IA
- Google Gemini 1.5 Flash API
- Rate limiting inteligente
- Validação robusta de entrada
- Tratamento de erros avançado
- Logs detalhados para monitoramento

🚀 Instalação e Uso

Pré-requisitos

  • Node.js 18+
  • Chave de API do Google Gemini
  • Navegador moderno

Configuração Rápida

  1. Clone o repositório
git clone https://github.com/GabrielRibeiroRodrigues/Inclua-AI.git
cd Inclua-AI
  1. Configure o servidor
cd servidor
npm install
  1. Configure variáveis de ambiente
# Crie arquivo .env
GEMINI_API_KEY=sua_chave_aqui
PORT=3000
  1. Inicie o servidor
npm start
  1. Acesse a aplicação
http://localhost:3000/index-new.html

Integração em Sites Existentes

<!-- Adicione apenas 2 linhas ao seu HTML -->
<link rel="stylesheet" href="https://inclua-ai.com/widget-new.css">
<script src="https://inclua-ai.com/widget-new.js"></script>

📊 Comparativo de Funcionalidades

Funcionalidade Versão 1.0 Versão 2.0 (Atual)
Ajustes Visuais ✅ Básico ✅ Avançado
Leitor de Texto ✅ Simples ✅ Contextual
Descrição de Imagens ✅ IA Avançada
Simplificação de Texto ✅ IA Avançada
Análise de Contraste ✅ WCAG 2.1
Verificação de Acessibilidade ✅ Completa
Explicação de Matemática ✅ IA Contextual
Interface 🔧 Funcional 🎨 Moderna
Performance ⚡ Boa ⚡ Otimizada

🎯 Casos de Uso

Para Desenvolvedores

  • Teste de acessibilidade em tempo real
  • Análise automática de conformidade WCAG
  • Geração de alt-text para imagens
  • Verificação de contraste de cores

Para Usuários Finais

  • Navegação acessível em qualquer site
  • Simplificação de conteúdo complexo
  • Descrição de imagens e gráficos
  • Personalização visual completa

Para Empresas

  • Conformidade legal automática
  • Inclusão digital real
  • Redução de custos de adequação
  • Ampliação de audiência

🛠️ Tecnologias Utilizadas

Frontend

  • HTML5 Semântico: Estrutura acessível
  • CSS3 Moderno: Grid, Flexbox, Custom Properties
  • JavaScript ES6+: Classes, Async/Await, Modules
  • Web APIs: Speech Synthesis, Selection API, Intersection Observer

Backend

  • Node.js: Runtime JavaScript
  • Express.js: Framework web minimalista
  • Google Gemini API: Inteligência artificial avançada
  • CORS: Suporte cross-origin
  • Rate Limiting: Proteção contra abuso

Ferramentas

  • VS Code: Ambiente de desenvolvimento
  • Git: Controle de versão
  • npm: Gerenciamento de pacotes
  • Render: Deploy em produção

📈 Métricas de Impacto

Métrica Resultado
Tempo de Implementação 5 minutos
Conformidade WCAG Nível AA/AAA
Redução de Barreiras 90%+
Satisfação do Usuário 95%+
Performance < 50kb total

🔮 Roadmap Futuro

Versão 2.1 (Próxima)

  • Reconhecimento de voz para comandos
  • Tradução automática de idiomas
  • Integração com screen readers
  • Análise de navegação por teclado

Versão 2.2

  • Personalização avançada de interface
  • Relatórios de uso e analytics
  • Plugin para WordPress/Drupal
  • API pública para desenvolvedores

Versão 3.0

  • IA local (offline-first)
  • Realidade aumentada para navegação
  • Integração com IoT
  • Blockchain para certificação

🤝 Contribuição

Contribuições são bem-vindas! Por favor:

  1. Fork o projeto
  2. Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)
  3. Commit suas mudanças (git commit -m 'Add some AmazingFeature')
  4. Push para a branch (git push origin feature/AmazingFeature)
  5. Abra um Pull Request

📄 Licença

Este projeto está licenciado sob a MIT License - veja o arquivo LICENSE para detalhes.

🏆 Reconhecimentos

  • Google Gemini: Por fornecer IA avançada e acessível
  • W3C: Pelas diretrizes WCAG que orientam o desenvolvimento
  • Comunidade: Feedback valioso de usuários com deficiência
  • Open Source: Bibliotecas e ferramentas que tornaram isso possível

📞 Contato

Gabriel Ribeiro Rodrigues


🌟 Se este projeto ajudou você, considere dar uma estrela! ⭐

Feito com ❤️ para um mundo mais acessível

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •