Skip to content

Repository files navigation

Cotaê

Comparador de VET (Valor Efetivo de Troca) entre ofertas de câmbio — descubra em segundos qual oferta vale mais na hora de trocar moeda.

Status: alpha. Em desenvolvimento ativo, sujeito a mudanças.

O que é

Quem recebe em moeda estrangeira (freelancers, PJs, quem viaja) frequentemente compara mais de uma plataforma de câmbio antes de decidir onde trocar. Cada plataforma cobra uma taxa (spread) diferente sobre a cotação — o Cotaê calcula o valor efetivo de cada oferta e mostra qual é a mais vantajosa, na hora.

Fórmula usada: o valor efetivo é a cotação informada, descontada a taxa da oferta.

Como usar

  1. Cadastre uma oferta: nome (opcional), cotação e spread do momento.
  2. Adicione quantas ofertas quiser comparar. Sugere-se ao menos duas.
  3. Clique em "Calcular VET" — a melhor oferta é destacada automaticamente.
  4. Cada cálculo fica num card de histórico, com data e hora — dá pra excluir uma consulta específica ou limpar tudo de uma vez.

Uso sem conta

Não é necessário criar conta pra usar o Cotaê. Sem login, nada é salvo nem enviado a nenhum servidor — os dados ficam só no seu navegador durante a sessão (sobrevivem a um recarregamento de página, mas somem ao fechar a aba). Veja o aviso de privacidade para detalhes.

Conta gratuita (opcional)

Quem quiser manter ofertas e histórico entre sessões e dispositivos pode criar uma conta gratuita (login com Google):

  • Ofertas salvas — cada oferta pode ser salva (💾) pra aparecer automaticamente da próxima vez, sem precisar recadastrar nome e spread. A cotação continua sendo digitada a cada consulta.
  • Histórico sincronizado na nuvem — cada cálculo é salvo automaticamente na conta, acessível em qualquer dispositivo onde você fizer login.
  • Indicador de sincronização — mostra se os dados estão sincronizados, sincronizando, ou se algo falhou (com opção de tentar novamente).
  • Migração automática — se você já tinha ofertas ou histórico numa sessão sem conta, eles são somados à sua conta assim que você faz login (nada é perdido nem sobrescrito).
  • No desktop, o login abre um popup; no celular, redireciona e volta automaticamente após concluir.

Instalar como app (PWA)

O Cotaê pode ser instalado como aplicativo, direto do navegador:

  • No Mac (Safari): menu Arquivo → "Adicionar ao Dock".
  • No iPhone/Android: botão de compartilhar/menu → "Adicionar à Tela de Início".

Uma vez instalado, abre em janela própria (sem barra de navegador) e o cálculo funciona mesmo offline — a sincronização com a conta, claro, exige internet.

Feedback

Qualquer pessoa pode dar feedback pelo link "Feedback" no rodapé: uma nota de 1 a 5 estrelas e um comentário livre opcional. O envio é sempre anônimo, inclusive para quem está logado -- o feedback nunca é associado à conta, e-mail ou qualquer identificador, e fica guardado numa coleção separada no Firestore (feedback), sem permissão de leitura pública.

O modal de feedback também pode aparecer automaticamente, no máximo uma vez até a pessoa responder ou dispensar (com um cooldown de 7 dias após dispensar):

  • Depois da segunda comparação bem-sucedida da sessão (nunca na primeira -- a pessoa ainda não teria visto o resultado direito).
  • Pouco depois de criar/entrar numa conta com sucesso.

Nunca aparece automaticamente ao mesmo tempo que o card de upsell de conta.

Eventos rastreados (GoatCounter)

Evento Quando dispara
oferta_adicionada Clique em "+ Nova oferta"
oferta_duplicada Clique no botão de duplicar uma oferta
oferta_removida Clique no botão de remover uma oferta da tela
oferta_salva Oferta salva/atualizada com sucesso na conta (💾)
erro_sem_oferta Clicou em "Calcular VET" sem nenhuma oferta cadastrada
erro_validacao Clicou em "Calcular VET" com ofertas incompletas ou inválidas
calculo_sucesso_1_oferta Cálculo bem-sucedido com 1 oferta
calculo_sucesso_2_ofertas Cálculo bem-sucedido com 2 ofertas
calculo_sucesso_3_ofertas Cálculo bem-sucedido com 3 ofertas
calculo_sucesso_4mais_ofertas Cálculo bem-sucedido com 4 ou mais ofertas
historico_limpo Clique em "Limpar histórico" (todo o histórico)
historico_excluido_individual Uma consulta específica excluída com sucesso
conta_criar_clicado Clique em "Criar conta gratuita" no card de upsell
conta_login_sucesso Login concluído com sucesso (só na transição de deslogado pra logado)
conta_sair_clicado Clique em "Sair"
sync_retry_clicado Clique em "Tentar novamente" após falha de sincronização
privacidade_upsell Clique em "leia nosso termo" dentro do card de upsell
privacidade_rodape Clique em "Privacidade" no rodapé
feedback_rodape Clique em "Feedback" no rodapé
stats_filtro_hoje Clique no chip de período "Hoje" na aba Consistência histórica
stats_filtro_7d Clique no chip de período "7 dias" na aba Consistência histórica
stats_filtro_15d Clique no chip de período "15 dias" na aba Consistência histórica
stats_filtro_30d Clique no chip de período "30 dias" na aba Consistência histórica
stats_filtro_all Clique no chip de período "Sempre" na aba Consistência histórica
oferta_dessalva Oferta removida da conta pelo botão de salvar (des-salvar)

Todos os eventos são contagens agregadas e anônimas -- nenhum contém dado sobre o conteúdo das ofertas (nome, cotação, spread) ou identidade da conta.

Por que "alpha"

O app está em desenvolvimento contínuo — o modelo de dados, o design e as funcionalidades ainda podem mudar bastante. Feedback é bem-vindo por meio do contato na própria página.

Stack

HTML, CSS e JavaScript puro — sem frameworks, sem build step. Firebase (Authentication + Firestore) pra conta e sincronização, GoatCounter pra estatísticas de uso, service worker pra instalação como PWA.


Desenvolvido por Ser Multimídia Soluções Digitais.

About

App para comparação de cotações entre plataformas de câmbio.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages