Skip to content

Marlos001/tech-challenge

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 

Repository files navigation

🚗 CarFinder AI - Buscador Inteligente de Carros

Uma aplicação web moderna que utiliza Inteligência Artificial conversacional para ajudar usuários a encontrar o carro perfeito. Desenvolvida com Next.js 15, TypeScript e integração com OpenAI GPT-4.

🌐 Disponível e Funcionando

🚀 Acesse a aplicação em produção

A aplicação está 100% funcional e disponível online. Teste todas as funcionalidades de busca conversacional com IA, navegue pela galeria de carros e experimente a interface moderna e responsiva.

🎯 Visão Geral

O CarFinder AI é uma demonstração de como a IA conversacional pode revolucionar a experiência de busca de produtos. A aplicação permite que usuários descrevam suas necessidades em linguagem natural e recebam recomendações inteligentes e personalizadas.

✨ Funcionalidades Principais

  • 🤖 Chat Inteligente: Interface conversacional powered by OpenAI GPT-4
  • 🔍 Busca Semântica: Entende intenções complexas e contexto do usuário
  • 💰 Filtros Dinâmicos: Busca por preço, localização, tipo de veículo
  • 📱 Design Responsivo: Interface moderna e otimizada para todos os dispositivos
  • 🎨 Galeria de Imagens: Visualização completa dos veículos com múltiplas fotos
  • ⚡ Performance: Carregamento rápido e experiência fluida

🛠️ Tecnologias Utilizadas

  • Frontend: Next.js 15, React 19, TypeScript
  • Styling: Tailwind CSS 4, CSS Modules
  • IA: OpenAI GPT-4, LangChain
  • Icons: Lucide React
  • Deployment: Vercel (recomendado)

🚀 Como Executar o Projeto

Pré-requisitos

  • Node.js 18+
  • npm ou yarn
  • Chave da API OpenAI

Instalação

  1. Clone o repositório

    git clone https://github.com/seu-usuario/carfinder-ai.git
    cd carfinder-ai/next-project-klubi
  2. Instale as dependências

    npm install
    # ou
    yarn install
  3. Configure as variáveis de ambiente

    Crie um arquivo .env.local na raiz do projeto:

    OPENAI_API_KEY=sua_chave_da_api_openai_aqui
  4. Execute o projeto

    npm run dev
    # ou
    yarn dev
  5. Acesse a aplicação

    Abra http://localhost:3000 no seu navegador.

📱 Demonstração

Interface Principal

  • Landing Page: Apresentação moderna com glassmorphism e animações
  • Chat Interface: Conversação natural com IA para busca de carros
  • Galeria de Carros: Visualização completa dos veículos disponíveis

Casos de Uso Demonstrados

  1. ✅ Busca por carro existente: "Quero um Honda Civic"
  2. 🪙 Busca com orçamento limitado: "SUV até R$ 80.000"
  3. 🌎 Busca por localização: "Carros em São Paulo"
  4. ⚡ Busca inteligente: "Carro elétrico familiar para cidade"

🎨 Decisões de Design e UX

Experiência do Usuário

  • Interface Conversacional: Elimina a necessidade de filtros complexos
  • Feedback Visual: Animações e estados de loading para melhor percepção
  • Responsividade: Funciona perfeitamente em mobile, tablet e desktop
  • Acessibilidade: Contraste adequado e navegação por teclado

Decisões Técnicas

  • Next.js 15: Aproveitamento das últimas funcionalidades do React
  • TypeScript: Tipagem forte para maior confiabilidade
  • Tailwind CSS: Desenvolvimento rápido com design system consistente
  • Arquitetura Modular: Componentes reutilizáveis e bem organizados

📊 Estrutura do Projeto

src/
├── app/                    # Páginas da aplicação
│   ├── api/chat/          # API route para chat com IA
│   ├── cars/              # Páginas de listagem e detalhes
│   └── chat/              # Interface de chat
├── components/            # Componentes reutilizáveis
│   ├── cars/              # Componentes específicos de carros
│   ├── chat/              # Componentes do chat
│   ├── layout/            # Componentes de layout
│   └── ui/                # Componentes base da UI
├── data/                  # Dados estáticos (cars.json)
├── lib/                   # Utilitários
└── types/                 # Definições TypeScript

🔧 Configuração da API

A aplicação utiliza a API do OpenAI para processamento de linguagem natural. A integração é feita através do endpoint /api/chat que:

  1. Recebe a mensagem do usuário
  2. Processa o contexto da conversa
  3. Busca carros relevantes no JSON
  4. Gera resposta natural com recomendações

📈 Melhorias Futuras

  • Integração com APIs de concessionárias reais
  • Sistema de favoritos e histórico
  • Notificações push para novos carros
  • Integração com mapas para localização
  • Sistema de avaliações e reviews

💼 Plano de Negócios

1. Modelo de Negócios

API-First B2B para Desenvolvedores

  • Tier Developer (Gratuito): 1.000 requests/mês, documentação completa
  • Tier Startup (R$ 0,10/request): 10.000 requests/mês, suporte por email
  • Tier Business (R$ 0,08/request): 100.000 requests/mês, suporte prioritário, SLA
  • Tier Enterprise (R$ 0,05/request): Volume customizado, suporte dedicado, customizações

2. Estratégia de Aquisição de Desenvolvedores

Fase 1 - Developer Community (0-100 devs)

  • Publicação em GitHub, npm, PyPI
  • Artigos técnicos em dev.to, Medium
  • Demonstrações em meetups e conferências de tecnologia
  • Open source com documentação exemplar

Fase 2 - B2B Growth (100-1.000 devs)

  • Parcerias com plataformas de desenvolvimento (Vercel, Netlify)
  • Integração com frameworks populares (React, Vue, Angular)
  • Webinars técnicos sobre IA conversacional
  • Programa de afiliados para desenvolvedores

3. CAC (Custo de Aquisição de Cliente)

Estimativa por canal:

  • Developer Communities: R$ 5-15 por desenvolvedor
  • Content Marketing: R$ 20-40 por desenvolvedor
  • Partnerships: R$ 10-25 por desenvolvedor
  • Referrals: R$ 5-10 por desenvolvedor

CAC Médio Estimado: R$ 15-25 por desenvolvedor

4. LTV (Lifetime Value) e Maximização

LTV Estimado por segmento:

  • Developer: R$ 50-200 (6-12 meses de uso)
  • Startup: R$ 500-2.000 (12-24 meses de uso)
  • Business: R$ 2.000-8.000 (24+ meses de uso)
  • Enterprise: R$ 10.000+ (contratos anuais)

Estratégias de Maximização:

  • Upselling para tiers superiores conforme crescimento
  • Cross-selling de APIs complementares (análise de sentimento, tradução)
  • Programa de parceiros para integradores
  • Customizações e consultoria técnica

5. Monetização

Receitas Principais:

  1. API Usage Fees (80% da receita)
  2. Consultoria e Customizações (15% da receita)
  3. Parcerias e Integrações (5% da receita)

Receita Projetada (Ano 2):

  • 500 desenvolvedores ativos
  • 50 empresas pagantes
  • ARPU de R$ 2.500/mês (empresas)
  • Receita mensal: R$ 125.000
  • Receita anual: R$ 1.500.000

6. Estratégias de Retenção

Developer Experience:

  • SDKs para múltiplas linguagens (JavaScript, Python, Go, PHP)
  • Documentação interativa com playground
  • Webhooks para integração em tempo real
  • Métricas detalhadas de uso e performance

Suporte Técnico:

  • Discord/Slack para comunidade
  • Stack Overflow presence
  • Tutoriais em vídeo e documentação
  • Code examples e templates

Programa de Parceiros:

  • Revenue sharing para integradores
  • Certificação técnica
  • Acesso antecipado a novos recursos
  • Co-marketing opportunities

About

Desafio técnico para vagas de tecnologia

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 93.2%
  • CSS 6.4%
  • JavaScript 0.4%