📖 Manual do Usuário

Lumyny — Guia Completo

Aprenda a usar todas as funcionalidades do app para maximizar seus ganhos como motorista de aplicativo

Introdução
O que é o Lumyny?
Entenda a proposta do app antes de explorar as funcionalidades

O Lumyny é uma ferramenta de gestão financeira e estratégica para motoristas de aplicativo. Ele centraliza em um único app os cálculos que a maioria dos motoristas faz de forma dispersa — em planilhas, calculadoras e na cabeça.

O app é dividido em 9 seções, cada uma com uma função específica. Você pode usar somente as que fazem sentido para o seu momento, ou explorar tudo de uma vez:

⚙️
Parâmetros
Base de cálculo
📊
Resultado
Combustão vs Elétrico
🚦
Corrida
Comparador
📐
Planejamento
Custo da corrida
📋
Desempenho
Jornada diária
🔧
Manutenções
Histórico e alertas
Abast.
Histórico e eficiência
📁
Relatório
Visão consolidada
🎯
Simulador
Monte Carlo

💡 Por onde começar: Preencha os Parâmetros primeiro. Os outros módulos usam esses dados como base para todos os cálculos.

Seção 1
⚙️ Parâmetros
A base de todos os cálculos do app — configure uma vez, use em todo o app

Os Parâmetros são o coração do Lumyny. Eles definem sua jornada de trabalho, metas financeiras e os custos detalhados de cada veículo. Todos os outros módulos utilizam esses dados para calcular resultados precisos.

Jornada de Trabalho

CampoO que significa
Dias / mêsQuantos dias você trabalha por mês. Afeta metas mensais e cálculo de lucro mensal.
Horas / diaHoras totais na jornada — incluindo esperas e paradas. Use o slider para ajustar de 1 a 12 h.
KM rodados / diaQuilometragem diária planejada (incluindo km vazio).
Velocidade média (km/h)Velocidade média urbana. Afeta o cálculo de km efetivo possível dentro das horas de trabalho.
Meta lucro líquido / mêsQuanto você quer levar para casa por mês, já descontados todos os custos e impostos.
Faturamento bruto / horaQuanto você quer faturar em média por hora de trabalho. Usado como referência no resultado.
Margem de espera / paradaPorcentagem do tempo que você fica parado (esperando corrida, fazendo refeições etc.). Normalmente entre 20% e 30%.

💡 Margem de espera: Se você trabalha 10 horas mas fica efetivamente em movimento por 8 horas, sua margem é 20%. Esse valor é usado nos cálculos de estimativa da seção de Parâmetros. No Simulador de Estratégia, a pausa é configurada diretamente em horas (campo "Pausa / descanso").

Parâmetros Fiscais

Configure aqui os parâmetros tributários caso você contribua com INSS e/ou pague IR como MEI ou autônomo.

CampoO que significa
Limite isenção IR / mêsValor mensal abaixo do qual você está isento de Imposto de Renda. Padrão 2026: R$ 5.000.
Base de cálculo IR (%)Percentual do faturamento bruto que é considerado base tributável. Profissionais autônomos geralmente usam 60%.
Alíquota IR (%)Percentual de IR sobre a base de cálculo que superar a faixa de isenção. Varia conforme a faixa da tabela progressiva.
Dedução IR (R$)Valor fixo de dedução da tabela progressiva (conforme faixa de renda).
Alíquota INSS (%)Percentual de contribuição ao INSS. MEI: 5%, contribuinte individual: 20%.
Base INSS (% fat. bruto)Percentual do faturamento bruto que compõe a base de cálculo do INSS. Por padrão 25%.

Dica fiscal: Se você é MEI, o INSS já está incluído no DAS (5% do salário mínimo). Coloque 0% na alíquota caso não queira considerar esse custo separadamente nos cálculos — ou inclua o DAS como manutenção mensal.

Veículo Combustão

Configure todos os custos do seu veículo a combustão. O app calcula automaticamente o custo por km com base nessas informações.

CampoO que significa
Nome / ModeloIdentificação do veículo. Ex: "HB20 2023".
Consumo (km/litro)Quantos km o veículo faz por litro de combustível. Use dados reais do seu cotidiano urbano.
Preço (R$/litro)Preço médio do combustível no seu posto habitual.
Pneus — valor e duraçãoCusto total de uma troca de pneus e a quilometragem que eles duram. O app distribui esse custo por km.
Fluídos e Filtros — valor e intervaloCusto de troca de óleo e filtros e o intervalo em km. Para combustão, tipicamente a cada 10.000 km.
Manutenção periódica / mêsValor médio mensal de manutenções preventivas (revisões programadas).
Manutenção corretiva / mêsValor médio mensal de reparos inesperados. Use a média dos últimos 12 meses.
IPVA / anoValor anual do IPVA. O app divide por 12 meses e por dias de trabalho para incluir no custo/km.
Seguro / anoValor anual do seguro do veículo.
Multas estimadas / mêsMédia mensal de multas de trânsito. Deixe 0 se não tiver histórico.
Valor do veículoValor atual de mercado do veículo. Base para o cálculo de depreciação.
% depreciação / anoQuanto o veículo perde de valor por ano. Carros de app depreciam mais rápido — entre 15% e 25% ao ano.
Período de depreciação (anos)Por quantos anos você planeja usar o veículo para trabalho.
Parcela mensal (financiamento)Valor da prestação mensal caso o veículo seja financiado ou alugado.

Veículo Elétrico

Configuração similar ao combustão, com diferenças nos campos de energia:

  • Consumo (km/kWh): eficiência elétrica do veículo. Consulte o manual ou use dados reais.
  • Preço (R$/kWh): custo da energia na tomada ou no carregador que você usa habitualmente.
  • Fluídos e Filtros: em elétricos, refere-se principalmente à troca de fluido de freio e filtro de cabine — intervalos maiores.

⚠️ Foto do veículo: Clique na área de imagem para adicionar uma foto do seu veículo. A foto é armazenada apenas no seu dispositivo — nunca sai do app.

Seção 2
📊 Resultado Comparativo
Combustão vs Elétrico — qual veículo é mais lucrativo para o seu perfil?

O Resultado é gerado automaticamente após preencher os Parâmetros. Ele compara lado a lado os dois veículos e indica qual oferece o maior lucro líquido, considerando todos os custos configurados.

Banner de Vencedor

No topo da seção aparece o banner de vencedor, que indica qual veículo tem menor custo operacional e quanto você economizaria por mês em custos usando um em vez do outro. O critério de comparação é o custo total por mês — não o faturamento, que é idêntico para ambos.

Toggle Diário / Mensal

Use os botões Diário e Mensal para alternar a visualização entre os valores de um dia de trabalho e os totais mensais. O toggle não altera os cálculos — apenas a escala de exibição.

Valor Mínimo por KM

O app calcula o valor mínimo de R$/km que você precisa cobrar para atingir sua meta de lucro líquido, considerando os dias de trabalho configurados. Esse indicador é a referência central do Lumyny — é com base nele que o Simulador monta as estratégias.

Cards de Cada Veículo

Cada veículo tem seu card com:

  • Custo/km — custo operacional por quilômetro rodado
  • Faturamento necessário/dia e /mês — quanto precisar faturar para cobrir custos e atingir a meta
  • Lucro líquido projetado — após custos operacionais e impostos
  • Faturamento/hora — o que você precisa gerar por hora de trabalho

Gráficos de Custos

A seção inclui quatro gráficos: composição de custos de cada veículo (pizza) e comparativo faturamento vs custos (barras). Eles ajudam a identificar quais categorias pesam mais no seu custo operacional.

Sua Estratégia

Na parte inferior, o app exibe a análise baseada nos seus limites de km/dia e horas/dia, mostrando se a meta configurada é alcançável com o perfil de jornada atual.

💡 Baixar PDF: Clique em 🖨️ Baixar PDF para gerar um relatório completo da comparação. Útil para guardar registro ou apresentar para consultor financeiro.

Seção 3
🚦 Comparador de Corridas
A corrida valeu a pena? Compare o que o app ofereceu com o que aconteceu de verdade

O Comparador de Corridas resolve uma dúvida frequente dos motoristas: a corrida que aceitei foi realmente vantajosa? Ele coloca lado a lado a corrida que o aplicativo ofertou e a corrida que você efetivamente realizou.

Como usar

  1. Na coluna Corrida Realizada, preencha o km vazio (do ponto de partida até o passageiro), km com passageiro, tempo total e valor recebido.
  2. Na coluna Corrida Ofertada, preencha os dados que o app mostrou antes de você aceitar — km estimado, tempo e valor oferecido.
  3. O app calcula automaticamente os indicadores de cada corrida e mostra as diferenças no painel central.

Indicadores calculados

IndicadorO que representa
R$/kmValor recebido dividido pelo km total percorrido (incluindo vazio).
R$/minValor recebido por minuto de trabalho — mede eficiência de tempo.
R$/horaProjeção do faturamento horário com base nessa corrida.
Custo operacionalCusto que você teve para realizar a corrida (combustível, desgaste, depreciação) com base no custo/km configurado nos Parâmetros.
Lucro brutoValor recebido menos o custo operacional da corrida.
LucratividadePorcentagem do valor recebido que sobrou como lucro.

Veredicto

O app emite um veredicto automático comparando as duas corridas. Se você recebeu menos do que o esperado — ou se o km real foi maior que o estimado —, o veredicto indicará prejuízo em relação à oferta e mostrará qual seria o valor ideal para essa corrida.

Uso prático: Use o Comparador para calibrar seu senso de corrida boa vs corrida ruim. Com o tempo, você terá referências claras de R$/km mínimo aceitável para o seu custo operacional.

Seção 4
📐 Planejamento de Corrida
Qual o valor justo para uma corrida específica? Calcule antes de aceitar

O Planejamento responde uma pergunta diferente do Comparador: quanto deveria custar essa corrida para que valha a pena? Você informa os dados da corrida e o app calcula o valor mínimo que garante uma margem de lucro saudável.

Dados da corrida

CampoO que informar
Distância estimada (km)Total de km da corrida, incluindo o deslocamento vazio até o passageiro.
Tempo no trajeto (minutos)Tempo estimado de condução.
Tempo de espera (minutos)Tempo que o passageiro pode demorar para embarcar.
Valor cobrado por espera (R$/min)Valor que o app cobra por minuto de espera após o período gratuito.
Valor por disponibilidade (R$/min)Se o app remunera por tempo disponível durante a viagem, informe aqui.
Pedágios (R$)Custo de pedágios no trajeto.
Estacionamento (R$)Custo de estacionamento no destino, se aplicável.
Margem de lucro desejada (%)Qual porcentagem do valor da corrida você quer que sobre como lucro. Use o slider (5% a 80%).
Veículo baseCombustão ou Elétrico — define qual custo/km será usado no cálculo.

Resultado do Planejamento

O app exibe:

  • Valor sugerido — preço mínimo que garante a margem de lucro configurada
  • Custo operacional total — quanto a corrida vai custar considerando km, tempo e extras
  • Ganhos por km e por tempo — bruto e líquido, para comparar rapidamente com outras corridas

💡 Dica de uso: Se o aplicativo ofertou um valor menor que o sugerido pelo Lumyny, a corrida tem margem abaixo da sua meta. Você pode aceitar mesmo assim — mas com consciência do impacto no lucro do dia.

Seção 5
📋 Desempenho Diário
Registre cada jornada e acompanhe se está no ritmo certo para bater a meta

O Desempenho é o diário de bordo do Lumyny. Registre ao final de cada dia de trabalho os dados da jornada — o app cruza com seus Parâmetros e mostra se você está no caminho certo para atingir a meta mensal.

Como registrar uma jornada

  1. Selecione a data da jornada.
  2. Informe os km rodados no dia.
  3. Preencha os horários de início e fim da jornada — o app calcula as horas trabalhadas automaticamente.
  4. Selecione o veículo utilizado (combustão ou elétrico).
  5. Marque os aplicativos usados no dia (Uber, 99, InDrive, etc.).
  6. Informe o faturamento por aplicativo e o total do dia.
  7. Clique em Salvar Jornada.

Indicadores calculados

Após o registro, o app exibe para aquele dia:

  • Faturamento bruto real vs meta proporcional (quanto você deveria ter faturado naquele dia)
  • R$/km e R$/hora efetivos do dia
  • Lucro líquido estimado do dia (após custos operacionais)
  • Status da meta: se no ritmo, acima ou abaixo

Histórico e Gráficos

O app mantém o histórico dos últimos 365 dias e exibe:

  • Gráfico de faturamento diário (barras)
  • Médias por mês e média anual
  • Tabela completa de dias, com filtro por período

Indicadores por período

Acima dos KPIs há um seletor de período com quatro abas — Hoje, Esta semana, Este mês e Este ano. Os indicadores (faturamento, lucro bruto, lucro líquido, km etc.) mostram os valores acumulados do período selecionado, não apenas do lançamento atual. Troque a aba para comparar seu desempenho em diferentes janelas de tempo.

⚠️ Dados locais: Todo o histórico é armazenado no seu dispositivo via localStorage. Para não perder os dados ao limpar o navegador, use a função de backup disponível na seção Relatório.

Seção 6
🔧 Manutenções
Registre e acompanhe toda a vida de manutenção do seu veículo

O módulo de Manutenções resolve um problema comum dos motoristas: perder o controle de quando foi feita a última troca de óleo, o último alinhamento ou quando vence a revisão. Com o histórico organizado, você evita custos mais altos por negligência e tem documentação do estado do veículo.

Registrar uma manutenção

Clique em + Nova Manutenção e preencha:

CampoO que informar
DataData em que a manutenção foi realizada.
TipoPreventiva, Corretiva, Revisão, Pneu/Freio ou Outro.
Descrição do serviçoO que foi feito. Ex: "Troca de óleo sintético 5W30 + filtro de óleo".
KM atualQuilometragem do veículo no momento da manutenção.
Próximo KMKM previsto para a próxima manutenção do mesmo tipo.
Custo (R$)Valor total pago pela manutenção.
Oficina / LocalOnde foi feita. Útil para comparar preços e qualidade ao longo do tempo.
ObservaçõesQualquer detalhe relevante — marca do produto, situação encontrada etc.

Alertas de Manutenção

Quando você configura o campo Próximo KM, o app monitora e exibe um alerta quando você se aproximar desse ponto. Configure também lembretes na seção Configurar Lembretes para receber avisos preventivos antes de atingir o limite.

Filtros

Filtre o histórico por tipo de manutenção e por período (este mês, 3 meses, 6 meses, este ano ou tudo). Útil para calcular quanto você gastou com pneus no ano, por exemplo.

Seção 7
⛽ Abastecimentos
Controle cada abastecimento e monitore a eficiência real do seu veículo

O módulo de Abastecimentos vai além de registrar gastos com combustível — ele calcula o consumo real do seu veículo em cada ciclo e mostra a evolução da eficiência ao longo do tempo. Com esses dados, você percebe quando o consumo sobe (sinal de manutenção necessária) e sabe exatamente quanto gasta por km rodado.

Registrar um abastecimento

Clique em + Novo Abastecimento e preencha:

CampoO que informar
DataData do abastecimento.
KM atualQuilometragem do veículo no momento do abastecimento.
Litros / kWhQuantidade de combustível ou energia adicionada.
Preço por litro / kWhPreço unitário pago.
Valor total (R$)Gasto total. Pode ser calculado automaticamente ou preenchido manualmente.
Posto / LocalOnde abasteceu. Permite comparar preços ao longo do tempo.
Tanque cheio?Marque se encheu o tanque completamente — necessário para calcular o consumo km/litro com precisão.

Análise de Eficiência

Com pelo menos dois abastecimentos com tanque cheio registrados, o app calcula:

  • Consumo médio (km/L ou km/kWh) — eficiência real em cada intervalo
  • Evolução do consumo — gráfico que mostra se está subindo ou caindo
  • Gasto por abastecimento — para controle de fluxo de caixa

💡 Por que registrar sempre com tanque cheio: O cálculo de km/L só é preciso quando o ponto de partida e chegada são tanques cheios. Abastecimentos parciais entram no histórico de gastos mas não entram no cálculo de consumo.

Seção 8
📁 Relatório Geral
Visão consolidada de tudo — faturamento, custos, km e margens em um único lugar

O Relatório Geral cruza todas as informações do histórico de desempenho, manutenções e abastecimentos para dar uma visão financeira completa do seu trabalho como motorista.

Períodos disponíveis

Selecione o período de análise nas abas no topo: Este Mês, 3 Meses, 6 Meses, Este Ano ou Tudo. Os KPIs e gráficos atualizam automaticamente.

KPIs principais

💰
Fat. Bruto
Total do período
Lucro Líq.
Após custos
🗓️
Dias
Trabalhados
📍
KM Total
Rodados
Combustível
Gasto total
🔧
Manutenções
Gasto total
📊
Custo/km
Custo operacional/km
🏆
Margem
Lucro líquido %

Gráficos

  • Faturamento vs Custos Mensais — barras empilhadas mostrando a evolução mês a mês
  • Composição de Custos — gráfico pizza com a participação de combustível, manutenções e outros
  • Desempenho Mensal Detalhado — tabela com todos os meses do período

Exportar e Backup

Use os botões no topo do Relatório para:

  • 🖨️ Salvar PDF — gera um PDF completo do relatório para o período selecionado
  • 📥 Exportar CSV — exporta todos os dados em planilha para abrir no Excel ou Google Sheets

⚠️ Backup obrigatório: Na seção inferior do Relatório, clique em Fazer Backup periodicamente para salvar todos os seus dados em um arquivo JSON. Se o localStorage do navegador for limpo, você perderá todo o histórico sem esse backup.

Restaurar dados

Para restaurar um backup salvo anteriormente, role até a seção Restaurar Histórico na parte inferior do Relatório, selecione o arquivo JSON e confirme. O app substituirá todos os dados atuais pelo conteúdo do backup.

Seção 9
🎯 Simulador de Estratégia
Descubra o valor/km ideal e a probabilidade de atingir sua meta — com Monte Carlo

O Simulador de Estratégia é o módulo mais avançado do Lumyny. Ele usa seus parâmetros de jornada para calcular qual valor por km você precisa praticar para atingir a meta — e vai além: usa simulação de Monte Carlo para estimar a probabilidade real de você conseguir isso na prática, considerando as variações naturais do dia a dia.

Parâmetros do simulador

CampoO que configurar
Horas de trabalho / diaJornada total diária planejada, incluindo pausas.
Km máximo / diaTeto de km que você aceita rodar por dia. O simulador usa o menor entre esse valor e o km fisicamente possível.
Velocidade média (km/h)Velocidade média urbana — usada para calcular o km fisicamente possível dentro das horas efetivas.
Pausa / descanso (horas/dia)Tempo fixo de pausa por dia (refeições, esperas longas, descanso). Subtraído das horas totais para obter as horas efetivas de corrida. Padrão: 1,5 h.
Tempo médio por corrida (min)Duração média de cada corrida, do aceite até o desembarque, incluindo deslocamento até o passageiro. Padrão: 20 min (~3 corridas/hora). Usado para calcular automaticamente o número de corridas/dia.
Corridas / diaCalculado automaticamente: horas efetivas × 60 / tempo por corrida. Serve como referência para o valor médio por corrida exibido nos cards.
Dias trabalhados / mêsDias de trabalho para projetar o resultado mensal. A meta líquida mensal (dos Parâmetros) é dividida por esse número para definir o lucro-alvo diário.
Veículo baseDefine qual custo/km usar no cálculo (combustão ou elétrico).
INSS (% do faturamento)Percentual de INSS sobre o faturamento bruto. Pré-preenchido pelos Parâmetros.
IR (% do faturamento)Percentual de IR sobre o faturamento bruto. Pré-preenchido pelos Parâmetros.

Pré-preenchimento: Os campos são pré-preenchidos automaticamente com base nos seus Parâmetros. Ajuste livremente para simular cenários diferentes sem alterar os Parâmetros originais. A meta líquida mensal vem sempre dos Parâmetros e é exibida no resumo acima dos cards.

Os dois cenários

O simulador gera dois cenários lado a lado, ambos calculados para atingir exatamente a mesma meta líquida diária:

  • 🚗 Cenário do Motorista — calcula o valor/km mínimo necessário para atingir a meta rodando o km configurado. É o ponto de equilíbrio: abaixo desse valor, você não fecha a meta.
  • ⚡ Estratégia Lumyny (recomendado) — recomenda um valor/km 25% maior, o que permite atingir a mesma meta rodando menos km. Com menos km necessário do que o limite físico, o motorista tem folga para os dias de baixa demanda — e isso eleva significativamente a probabilidade de fechar a meta no mês.

Análise de Monte Carlo

Para cada cenário, o app roda 1.000 simulações variando aleatoriamente os principais fatores do dia:

  • Horas totais disponíveis: ± 5% (dias mais curtos ou mais longos que o planejado)
  • Valor/km recebido: ± 10% (variação de demanda, surge e tipo de corrida)
  • Custo/km: ± 7,5% (oscilação de combustível e desgaste)

O resultado é uma probabilidade de atingir a meta para cada cenário, além dos percentis P10 (pior 10% dos dias), P50 (mediana) e P90 (melhor 10% dos dias).

A Estratégia Lumyny usa um modelo adaptativo na simulação: nos dias com tarifa abaixo do esperado, o motorista pode rodar mais km (até o limite físico) para compensar. Isso reflete uma vantagem real — quem já opera com folga de km consegue se recuperar em dias ruins sem ultrapassar o tempo disponível.

💡 Como interpretar: Uma probabilidade de 85% significa que em 850 dos 1.000 dias simulados você atingiria ou superaria a meta. A Estratégia Lumyny é projetada para probabilidade significativamente mais alta do que o cenário mínimo — use-a como referência para decidir qual valor/km praticar.

Quando a estratégia é inviável

Se o km máximo configurado superar o km fisicamente possível (horas efetivas × velocidade), o app sinaliza a estratégia do Motorista como inviável e recalcula com o km real máximo. Nesse caso, a Estratégia Lumyny oferece a solução: com valor/km mais alto, o motorista atinge a meta com menos km — sempre dentro do limite físico.

Conclusão
💡 Dicas Gerais de Uso
Tire o máximo do Lumyny com estes hábitos

Rotina recomendada

  1. Configure os Parâmetros uma vez com cuidado — eles definem a qualidade de todos os outros cálculos.
  2. Ao final de cada dia de trabalho, registre a jornada no Desempenho.
  3. A cada abastecimento, registre no módulo Abastecimentos.
  4. Após qualquer manutenção no veículo, registre no módulo Manutenções.
  5. Uma vez por mês, acesse o Relatório para uma visão completa e faça um backup dos dados.
  6. Use o Simulador sempre que quiser testar um novo cenário — mais horas, menos dias, meta diferente.

Sobre o armazenamento dos dados

O Lumyny funciona 100% offline e todos os dados ficam armazenados no seu dispositivo (localStorage do navegador). Isso significa:

  • Seus dados não vão para nenhum servidor — total privacidade
  • Limpar os dados do navegador apaga seu histórico — faça backup regularmente
  • Os dados não sincronizam entre dispositivos automaticamente — use o backup JSON para migrar

Instalação como app (PWA)

O Lumyny pode ser instalado no celular como um aplicativo nativo — sem precisar baixar da loja. No navegador, toque no ícone de compartilhar (iOS) ou nos três pontos (Android) e selecione "Adicionar à tela inicial". O app abre sem barra de endereços, como qualquer outro aplicativo.

Lumyny na Play Store: O app também está disponível na Google Play Store como TWA (Trusted Web Activity). A versão da loja e a versão web são idênticas.

Tema visual

Use os três pontos coloridos no canto superior direito para alternar entre os temas Escuro, Intermediário e Claro. A preferência é salva automaticamente e mantida entre sessões.

💡 Suporte: Encontrou algum problema ou tem sugestão? Entre em contato pelo e-mail marcelowatson@gmail.com ou acesse github.com/MarceloWatson/lumyny.