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

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages