Sistema completo de diagnóstico e gerenciamento de headsets USB
Desenvolvido pela TSI Telecom para profissionais de suporte e usuários finais
O HeadsetManager é um programa que ajuda você a testar e diagnosticar problemas com fones de ouvido USB (headsets). Ele é como um "médico" para o seu headset: grava áudio, mostra gráficos de som e te avisa se algo não está funcionando direito.
Ideal para:
- ✅ Testar qualidade do microfone antes de reuniões importantes
- ✅ Diagnosticar problemas de áudio sem conhecimento técnico
- ✅ Verificar se o cancelamento de ruído está funcionando
- ✅ Equipes de suporte técnico que atendem remotamente
- Grave áudio com um clique e veja gráficos coloridos das frequências de som
- Medidores visuais de nível de áudio (0-100) e qualidade (0-100)
- Modo fullscreen para análise detalhada durante testes prolongados
- Baixe as gravações para compartilhar com o suporte
- O sistema toca um "chiado" (ruído branco)
- Você fala normalmente
- O programa mostra se o cancelamento de ruído está funcionando
- 10 comandos prontos para resolver problemas comuns
- Exemplos: verificar drivers, testar latência, resetar configurações
- Basta clicar e deixar o sistema fazer o trabalho
- Logs ao vivo do sistema via WebSockets
- Painel de terminal integrado com exportação de logs
- Notificações de execução de scripts e alertas
- Filtros de status (online/offline) para dispositivos
- Análise inteligente de logs com OpenAI GPT-4, Anthropic Claude ou Google Gemini
- Sugestões automáticas de correção com nível de severidade
- Diagnóstico com confiança (0-100%)
- Registro completo de todas as gravações com metadados
- Métricas de qualidade ao longo do tempo
- Consulta para manutenção preventiva
- Baixe o instalador: HeadsetManager-Setup.msi
- Clique duas vezes no arquivo baixado
- Siga as instruções na tela
- Pronto! Procure por "HeadsetManager" no menu Iniciar
# Baixar instalador
wget https://github.com/B0yZ4kr14/HeadsetManager/releases/latest/download/headset-manager-installer.bin
# Dar permissão
chmod +x headset-manager-installer.bin
# Instalar
sudo ./headset-manager-installer.bin
# Abrir
headset-managerRequisitos: Node.js 22+, PostgreSQL 14+, pnpm 9+
# Clone o repositório
git clone https://github.com/B0yZ4kr14/HeadsetManager.git
cd HeadsetManager
# Instale dependências
pnpm install
# Configure o banco de dados (edite .env)
pnpm db:push
# Popule scripts de troubleshooting
pnpm seed
# Inicie o servidor
pnpm dev
# Acesse: http://localhost:3000Guia completo: Instalação Detalhada
| Item | Requisito |
|---|---|
| Sistema | Windows 10+ ou Linux (Ubuntu 20.04+) |
| Navegador | Chrome 90+, Firefox 88+, Edge 90+ |
| RAM | 4 GB |
| Espaço | 500 MB livres |
| Headset | Qualquer modelo USB |
- Abra o HeadsetManager
- O navegador vai pedir permissão para usar o microfone
- Clique em "Permitir" (seus dados ficam apenas no seu computador!)
- Pronto! Você já pode começar a usar
- Clique em "Dashboard" no menu lateral
- Clique no botão "Iniciar Gravação" (ícone de microfone)
- Fale normalmente
- Clique em "Parar Gravação"
- A gravação aparece na lista abaixo
- Vá em "Diagnósticos" no menu
- Clique em "Teste de Cancelamento de Ruído"
- O sistema toca um ruído branco
- Fale normalmente
- Veja o resultado na tela
- Acesse "Diagnósticos" no menu lateral
- Escolha um script (ex: "Verificar Drivers USB")
- Clique em "Executar"
- Aguarde a conclusão e visualize os resultados
- Acesse "Configurações" no menu
- Escolha o provedor (OpenAI/Anthropic/Gemini)
- Insira sua API Key
- Clique em "Salvar"
- Use o chat de IA no canto inferior direito
Mais detalhes: Guia de Primeiro Uso
✅ Sim! Completamente gratuito e open-source.
✅ Sim, em qualquer headset USB que funcione no seu computador.
❌ Não para as funções básicas. Apenas para integração com IA.
❌ Não! Tudo fica armazenado localmente no seu computador.
✅ Sim! O código é open-source e pode ser auditado por qualquer pessoa.
Mais perguntas: FAQ Completo
| Camada | Tecnologia | Versão |
|---|---|---|
| Frontend | React | 19.0 |
| Linguagem | TypeScript | 5.9 |
| Estilização | Tailwind CSS | 4.0 |
| Componentes | shadcn/ui | Latest |
| Backend | Next.js | 14.0 |
| API | tRPC | 11.0 |
| Banco de Dados | PostgreSQL | 15+ |
| ORM | Drizzle | Latest |
| Real-time | Socket.IO | 4.0 |
| Gráficos | Chart.js | 4.0 |
| Testes | Vitest | Latest |
HeadsetManager/
├── client/ # Frontend React
│ ├── public/ # Assets estáticos (logo, ícones)
│ └── src/
│ ├── pages/ # Páginas (Home, Diagnostics, Histórico)
│ ├── components/ # Componentes reutilizáveis
│ └── lib/ # Utilitários e tRPC client
├── server/ # Backend Node.js
│ ├── _core/ # Infraestrutura (OAuth, tRPC, LLM)
│ ├── routers/ # Rotas tRPC
│ └── services/ # Serviços (OpenAI, Socket.IO)
├── drizzle/ # Schema e migrações do banco
├── shared/ # Tipos compartilhados
├── scripts/ # Build scripts para instaladores
└── wiki/ # Documentação completa
- devices: Dispositivos de áudio detectados
- audio_tests: Gravações e metadados
- system_logs: Logs do sistema
- troubleshooting_scripts: Scripts de diagnóstico
- script_executions: Histórico de execuções
- ai_diagnostics: Análises de IA
- user_settings: Configurações do usuário (API Keys)
# Executar todos os testes
pnpm test
# Testes com cobertura
pnpm test:coverage
# Testes em modo watch
pnpm test:watchCobertura atual: 8 testes passando
- Autenticação (logout)
- Integração com OpenAI (3 testes)
- Troubleshooting scripts (4 testes)
pnpm dev # Inicia servidor de desenvolvimento (porta 3000)
pnpm db:push # Sincroniza schema do banco
pnpm seed # Popula scripts de troubleshootingpnpm build # Build otimizado para produção
pnpm start # Inicia servidor de produção# Windows (.msi)
pnpm build:windows
# Linux (.bin)
pnpm build:linux
# Ambos
pnpm build:installers- 📖 Wiki Oficial - Documentação completa
- 🚀 Guia de Instalação - Passo a passo detalhado
- ❓ FAQ - Perguntas frequentes
- 🔧 Solução de Problemas - Erros comuns
- 💻 API para Desenvolvedores - Documentação técnica
- 🤝 Guia de Contribuição - Como contribuir
Se algo não está funcionando:
- Consulte o FAQ: Perguntas Frequentes
- Veja os Guias: Solução de Problemas
- Reporte um Bug: Abrir Issue
- Entre em Contato: suporte@tsitelecom.com.br
O HeadsetManager é open-source! Você pode ajudar de várias formas:
- 🐛 Reportar bugs - Abrir Issue
- 💡 Sugerir funcionalidades - Discussions
- 🌍 Traduzir - Ajude a traduzir para outros idiomas
- 💻 Contribuir com código - Veja o Guia de Contribuição
- Fork o projeto
- Crie uma branch para sua feature (
git checkout -b feature/AmazingFeature) - Commit suas mudanças (
git commit -m 'Add some AmazingFeature') - Push para a branch (
git push origin feature/AmazingFeature) - Abra um Pull Request
Este projeto está licenciado sob a MIT License - veja o arquivo LICENSE para detalhes.
Isso significa que você pode:
- ✅ Usar comercialmente
- ✅ Modificar o código
- ✅ Distribuir
- ✅ Uso privado
Desenvolvido com ❤️ pela TSI Telecom para profissionais que precisam de ferramentas confiáveis de diagnóstico de áudio.
Agradecimentos especiais:
- shadcn/ui - Componentes UI
- Chart.js - Visualização de dados
- tRPC - Type-safe APIs
- Drizzle ORM - Database toolkit
- Vitest - Testing framework
- Comunidade open-source por bibliotecas incríveis
- Usuários que reportam bugs e sugerem melhorias
- Website: tsitelecom.com.br
- Email: suporte@tsitelecom.com.br
- GitHub: B0yZ4kr14/HeadsetManager
- Issues: Reportar Problema
- Discussions: Fórum da Comunidade
Se o HeadsetManager te ajudou, considere:
- ⭐ Dar uma estrela no GitHub
- 🐦 Compartilhar nas redes sociais
- 💬 Recomendar para colegas
- 🤝 Contribuir com código ou documentação
HeadsetManager v1.0.0
© 2024 TSI Telecom. Todos os direitos reservados.