Repository navigation
Releases: darioreisjr/TechCompass
Releases · darioreisjr/TechCompass
Release list
v1.1.2
Changelog
🔧 Other Changes
- 34dff72 docs: adiciona workflow de auto-release e guia completo - Adiciona workflow do GitHub Actions para versionamento e releases automáticos - Inclui documentação completa com exemplos e solução de problemas - Workflow dispara em pushes na branch main com versionamento semântico - Suporta conventional commits (feat, fix, breaking changes) - Gera changelogs automáticos agrupados por tipo de commit
Compare: v1.1.1...v1.1.2
v1.1.1
Changelog
🔧 Other Changes
- 20f107a docs: adiciona workflow de auto-release e guia completo
Compare: v1.1.0...v1.1.1
v1.1.0
Tech Compass v1.0.0 - Primeira Versão
🧭 Tech Compass v1.0.0 - Primeira Versão
Data de Lançamento: Setembro 2025
Apresentamos o Tech Compass, uma aplicação React moderna para descobrir carreiras em tecnologia através de um questionário interativo inteligente! 🚀
🎯 O que é o Tech Compass?
O Tech Compass é uma ferramenta inovadora que ajuda pessoas a descobrirem qual carreira em tecnologia mais combina com seu perfil, usando um questionário cientificamente projetado de 30 perguntas e inteligência artificial para gerar insights personalizados.
✨ Funcionalidades Principais
🔍 Sistema de Descoberta Inteligente
- 30 perguntas otimizadas que analisam preferências, aptidões e interesses
- Algoritmo de pontuação avançado que considera múltiplas variáveis
- 7 carreiras de TI mapeadas com descrições detalhadas e atividades do dia a dia
🤖 Integração com IA (Gemini)
- Plano de estudos personalizado gerado por IA com base no resultado
- Simulação de "Um Dia na Vida" na carreira escolhida
- Conteúdo dinâmico adaptado ao perfil do usuário
👤 Personalização com GitHub
- Login opcional com GitHub para experiência personalizada
- Avatar e nome integrados automaticamente
- Persistência de progresso usando IndexedDB
📱 Experiência de Usuário Premium
- Interface responsiva que funciona perfeitamente em mobile, tablet e desktop
- Animações suaves e transições modernas
- Tema dark otimizado para longas sessões
- Progresso visual em tempo real durante o questionário
🎯 Carreiras Mapeadas
- 🎨 Desenvolvimento Front-End - Criação de interfaces visuais e UX
- ⚙️ Desenvolvimento Back-End - Lógica e infraestrutura de servidores
- 📊 Ciência de Dados & IA - Análise de dados e machine learning
- 🔒 Segurança da Informação - Proteção de sistemas e dados
- ☁️ Infraestrutura & DevOps - Automação e operações em nuvem
- 🎮 Desenvolvimento de Jogos - Criação de experiências interativas
- 🎯 Design de UI/UX - Experiência e interface do usuário
🛠️ Tecnologias de Ponta
Frontend Moderno
- React 19.1.1 - Nova versão com React Compiler e melhorias de performance
- Vite 7.1.2 - Build tool de última geração com otimizações avançadas
- CSS Puro - Estilização moderna sem dependências externas
- ESLint 9.15 - Linter moderno com flat config
Integrações Avançadas
- Gemini AI API - Geração de conteúdo personalizado
- GitHub API - Integração perfeita com perfis do GitHub
- Vercel Analytics - Monitoramento de uso e performance
Performance & UX
- IndexedDB - Persistência local de dados
- Service Workers - Cache inteligente (preparado para futuras versões)
- Code Splitting - Carregamento otimizado
- Tree Shaking - Bundles menores
🚀 Como Usar
Método 1: Deploy Pronto (Recomendado)
# Acesse diretamente (link será disponibilizado)
https://tech-compass.vercel.appMétodo 2: Execução Local
# Clone o repositório
git clone https://github.com/seu-usuario/tech-compass.git
cd tech-compass
# Instale as dependências
npm install
# Configure a API Key do Gemini (opcional)
cp .env.example .env
# Edite o .env com sua chave: VITE_GEMINI_API_KEY=sua_chave_aqui
# Execute o projeto
npm run devMétodo 3: Build para Produção
npm run build
npm run preview📋 Pré-requisitos
- Node.js 20+ (recomendado)
- npm, yarn ou pnpm
- API Key do Gemini (opcional, para funcionalidades de IA)
🎪 Experiência do Usuário
Fluxo Principal
- 🏠 Tela Inicial - Login opcional com GitHub ou continuar como visitante
- ❓ Questionário - 30 perguntas inteligentes com barra de progresso
- 🎯 Resultado - Carreira ideal com descrição detalhada
- 🤖 IA Insights - Plano de estudos e simulação de carreira gerados por IA
Funcionalidades Especiais
- 💾 Auto-save - Progresso salvo automaticamente
- 🔄 Estado persistente - Continue de onde parou
- 📱 Mobile-first - Otimizado para todos os dispositivos
- ⚡ Performance - Carregamento instantâneo
📊 Estatísticas desta Versão
- 30 perguntas cuidadosamente elaboradas
- 7 carreiras mapeadas em detalhes
- 4 componentes React principais
- 1 arquivo de dados com 200+ linhas de conteúdo
- 500+ linhas de CSS customizado
- Zero dependências externas desnecessárias
🔮 Próximas Versões (Roadmap)
v1.1.0 - Melhorias de UX
- Mais opções de personalização
- Sistema de compartilhamento de resultados
- Modo claro/escuro toggle
v1.2.0 - Expansão de Conteúdo
- Mais carreiras (Mobile Dev, Product Manager, etc.)
- Perguntas avançadas opcionais
- Sistema de recomendações de cursos
v2.0.0 - Funcionalidades Avançadas
- Sistema de usuários completo
- Histórico de testes
- Comparação de resultados
- API própria
- Dashboard administrativo
🐛 Problemas Conhecidos
⚠️ A API do Gemini pode ter latência em horários de pico⚠️ IndexedDB não é suportado em navegadores muito antigos⚠️ Algumas animações podem não funcionar no Safari mais antigo
🤝 Como Contribuir
- Fork este repositório
- Clone sua fork localmente
- Crie uma branch para sua feature:
git checkout -b feature/nova-funcionalidade - Commit suas mudanças:
git commit -m 'Adiciona nova funcionalidade' - Push para a branch:
git push origin feature/nova-funcionalidade - Abra um Pull Request
Áreas que Precisam de Ajuda
- 🌍 Internacionalização (i18n) para outros idiomas
- 📝 Mais perguntas para questionário
- 🎨 Melhorias no design e animações
- 🧪 Testes automatizados
- 📚 Documentação adicional
📄 Licença
Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.
🙏 Créditos e Agradecimentos
- React Team - Pela incrível nova versão 19.1.1
- Vite Team - Pela ferramenta de build mais rápida que existe
- Google AI - Pela API do Gemini que tornou a IA possível
- GitHub - Pela API que permite integração perfeita
- Vercel - Pelo hosting e analytics fantásticos
📞 Suporte e Feedback
- 🐛 Bugs: Abra uma [issue](https://github.com/darioreisjr/TechCompass/issues)
- 💡 Sugestões: Use as [Discussions](https://github.com/darioreisjr/TechCompass/discussions)
- 📧 Contato direto: [dev.darioreis@gmail.com]
- 💬 Chat: Entre no nosso Discord [(https://discord.gg/M7TK4mHf)]
📈 Métricas de Desenvolvimento
- ⏱️ Tempo de desenvolvimento: ~40 horas
- 📦 Tamanho do bundle: <500KB (gzipped)
- ⚡ Lighthouse Score: 95+ em todas as métricas
- 🧪 Compatibilidade: Chrome 90+, Firefox 88+, Safari 14+
Desenvolvido com ❤️ usando as tecnologias mais modernas do ecossistema React.
"O Tech Compass não é apenas um teste vocacional - é o primeiro passo na sua jornada rumo a uma carreira de sucesso em tecnologia."
📦 Assets desta Release
tech-compass-v1.0.0-source.zip- Código fonte completotech-compass-v1.0.0-build.zip- Build otimizado para produçãotech-compass-v1.0.0-docs.pdf- Documentação técnica completa
Download total estimado: ~2MB
Testado em: Windows 11, macOS Monterey, Ubuntu 22.04, iOS 15+, Android 11+