Suporte & FAQ

O TruckerMaster é uma PWA (Progressive Web App) — não precisas de APK nem da Play Store, a instalação faz-se diretamente a partir do teu navegador.

No Android (Chrome / Edge / Brave):

1. Abre app.truckermaster.fr
2. Toca no menu ⋮ (3 pontos no canto superior direito)
3. Escolhe «Instalar aplicação» ou «Adicionar ao ecrã principal»
4. O ícone aparece junto das tuas outras apps. Abre — é ecrã inteiro, como uma app nativa.

No iPhone (Safari):

1. Abre app.truckermaster.fr no Safari
2. Toca no ícone Partilhar ⬆️ em baixo
3. Escolhe «Adicionar ao ecrã principal»

Vantagens: permissões nativas de microfone/câmara/notificações, funciona offline após a 1.ª abertura, atualizações automáticas sem reinstalação.

Na primeira abertura, a app mostra um ecrã de boas-vindas em 3 passos que propõe duas opções:

• Ver a auditoria de exemplo — carrega um mês fictício (maio de 2025, MARTIN J-P, 22 dias trabalhados) com um recibo de vencimento ligeiramente subdeclarado. A auditoria revela uma diferença de cerca de 300 € — calibrada para se manter credível (um mês normal para um motorista de longo curso) em vez de um número de choque.
• Começar com os meus próprios dados — salta o exemplo e deixa-te importar o teu cartão real ou digitalizar o teu recibo.

Se escolheres a demonstração, chegas diretamente à auditoria com o resultado. Quando voltas ao Dashboard, uma visita guiada em 5 passos arranca automaticamente para te apresentar os elementos-chave (auditoria, temporizador, dossier, botão central).

Para apagar a demonstração e usar os teus dados reais: botão «Apagar» na faixa laranja no topo do Dashboard, OU Definições → Ferramentas → «Limpar a cache completa».

Para rever a introdução ou a visita guiada: Definições → secção Ferramentas → botões «Rever a introdução» / «Refazer a visita guiada».

Três botões predefinidos (15 / 30 / 45 min) cobrem os casos clássicos (pausa para refeição, pausa obrigatória RSE de 45 min após 4h30 de condução, espera no cais). Um quarto botão "+ pessoal" abre um campo para uma duração livre em minutos.

A contagem decrescente é persistente: se fechares a app, puseres o ecrã em suspensão ou mudares para outra app, o temporizador retoma exatamente onde estava quando a reabres. Sem desvios.

No fim: som de alarme (configurável em Definições → Temporizador de pausa) + notificação de sistema + notificação efémera (toast) na app.

Sons disponíveis: Sirene (predefinido), Bips secos, Buzina, Apenas vibração (Android), Silencioso. Toca num som para o ouvir em pré-visualização e o selecionar.

No iOS, a notificação de sistema só funciona se a PWA estiver instalada no ecrã principal (limitação do Safari). O som e a vibração continuam a funcionar.

Caso típico: tinhas instalado a app, desinstalaste-a, e agora o Chrome só te propõe «Adicionar ao ecrã principal» (que cria apenas um atalho para o navegador, não uma app a sério).

O Chrome bloqueia a verdadeira proposta de instalação durante vários dias após uma desinstalação, para evitar o spam de instalações. A solução é repor os dados do site:

1. Escreve na barra de URL: chrome://settings/content/all
2. Procura app.truckermaster.fr na lista
3. Toca nele e depois em «Limpar e repor»
4. Volta a app.truckermaster.fr, espera 10-15 s
5. Menu ⋮ → deves agora ver «Instalar aplicação» com um ícone 📱

Alternativa: apagar os dados de navegação das últimas 24 h no Chrome (Definições → Privacidade → Limpar dados de navegação) — isso também repõe o contador PWA a zero.

Recomendado: CR USB Type A ou Tachogram (15-25 € na Amazon). Leitores CCID básicos, sem hub USB intermédio, que funcionam de imediato em Mac, Windows e Linux.

A evitar no macOS: Cherry GmbH XX44 — bug recorrente em que o cartão é marcado como «mudo» pelo driver da Apple. A app deteta este caso e mostra uma ajuda, mas o contorno não é garantido.

A leitura do cartão exige um leitor USB físico ligado a um computador. A maioria dos telemóveis não tem porta USB para este tipo de equipamento (e a API Web USB é restrita nos navegadores móveis).

Solução atual: lê o teu cartão no computador e usa depois a função «Exportar os meus dados» em Definições → Ferramentas. Recebes um ficheiro .json para enviares a ti próprio por email/AirDrop/Drive para o telemóvel. A app móvel tem um botão «Importar uma exportação JSON» que carrega tudo em poucos segundos.

Uma leitura USB-OTG nativa (leitor ligado diretamente ao telemóvel) está prevista a mais longo prazo — exigiria um desenvolvimento Android nativo que a versão PWA atual não permite.

Não. Todos os teus dados ficam guardados localmente no teu dispositivo. Nem a leitura do cartão, nem a digitalização OCR, nem qualquer cálculo recorre a um servidor remoto.

Uma opção de cópia de segurança na nuvem cifrada chegará mais tarde, mas será sempre opcional (interruptor nas Definições).

Vê a Política de privacidade para os detalhes.

O motor de cálculo baseia-se na Convenção Coletiva Nacional dos Transportes Rodoviários (CCNTR — IDCC 16, o número identificador da convenção) e no Código do Trabalho francês (artigos L3121-22 para as horas extraordinárias, L3245-1 para a prescrição, etc.).

O código-fonte que calcula (horas normais/equivalência/extra a 50%, horas noturnas, prémios de fim de semana, ajudas de custo) está coberto por 14 testes unitários automatizados que validam cada caso. Podes consultar a página Metodologia na app (Definições → FAQ) para o detalhe das fórmulas e referências legais.

Limite: isto é uma estimativa. Para uma reclamação oficial, manda validar por um defensor sindical ou por um advogado de direito do trabalho.

Atualmente: CCNTR Mercadorias (IDCC 16), em especial o perfil motorista de longo curso, coeficiente 150M.

Os limiares CCNTR (152 h normais, 186 h de equivalência, 50% para além), as horas noturnas e as tarifas unitárias são todos configuráveis nas Definições, o que permite adaptar a outros perfis (curta distância, passageiros, acordos de empresa específicos).

O OCR (Tesseract.js) depende da qualidade da foto e do formato do recibo. Conselhos:

• Boa luz, foto nítida, tirada de frente (não inclinada).
• Digitaliza página a página se o teu recibo tiver 2 páginas.
• Verifica cada campo extraído na lista «Detalhe extraído» e corrige à mão com o ícone do lápis antes de guardar.

Se certos campos saírem sistematicamente errados para o teu empregador, comunica-o por email com um recibo anonimizado — nunca envies o teu recibo de vencimento nem o ficheiro do teu cartão sem os anonimizar — e adaptaremos os padrões OCR.

Sim, 100 % gratuita. Todas as funcionalidades (leitura do cartão, auditoria, geração de PDF, vista anual…) estão desbloqueadas.

A prazo, algumas funções avançadas (PDF ilimitados, sincronização na nuvem, alertas automáticos) passarão a assinatura, mas o essencial (auditoria + reclamação simples) continuará sempre gratuito.