🔒 Sessão protegida · Autenticação segura
➕ Nova OS
⚡ MECÂNICA TROVÃO
☁️
🔎
🔔
🤖
⚙️
🚪 Sair
📊 Dashboard
🔧 Últimas OS
🎂 Aniversariantes
🔧 Ordens de Serviço
👥 Clientes
📅 Agenda

🔔 Central de Alertas
📢 Novo Alerta
📋 Histórico de Alertas
💬 Central WhatsApp
📲 Mensagens Rápidas 30 modelos
👥 Envio por Cliente
🛡️ Manutenção Preventiva por KM

🔍 Buscar Serviços por Faixa de Kilometragem

Informe a kilometragem atual do veículo para ver quais serviços estão vencidos, próximos ou futuros.

Vencido / Urgente
Próximo (até 3.000km)
Em dia
Futuro (+10.000km)
🛡️

Informe a kilometragem acima para ver os serviços preventivos.

⏰ Lembretes Automáticos
⚙️Configuração
📋 Orçamentos
💰 Financeiro
⬤ Caixa Fechado

Faturamento — Últimos 6 meses

Top 5 Serviços (por faturamento)

💵 Entradas
R$ 0,00

Nenhuma entrada

💸 Saídas
R$ 0,00

Nenhuma saída

Saldo do Dia
R$ 0,00
📊 Saldo por Forma de Pagamento

Entradas vs Saídas — últimos 30 dias

OS por status — este mês

Mecânico mais produtivo (OS concluídas)

Parcelas em aberto
🚗 Meu Portal
👤
Portal Cliente
🔧 Minhas Ordens de Serviço

Nenhuma ordem encontrada.

🚘 Meus Veículos

Nenhum veículo cadastrado.

💰 Minhas Parcelas

Nenhuma parcela encontrada.

📋 Histórico de Atendimento

Sem histórico registrado.

❓ Ajuda & Manual
⚡ Progresso de Configuração
0%
1

🌟 Criar usuário SuperAdmin

Vá em Usuários → Novo Usuário, selecione perfil 🌟 Super Administrador e use uma senha forte (mínimo 8 caracteres, letras + números). Esse será o único com acesso total ao sistema.

2

⚙️ Configurar dados da oficina

Acesse Configurações e preencha o nome da oficina, CNPJ, endereço e telefone. Essas informações aparecem nos relatórios e recibos gerados pelo sistema.

3

👷 Cadastrar equipe (mecânicos e recepção)

Crie os usuários da equipe com os perfis corretos: 🔧 Mecânico para técnicos, 📞 Recepção para atendentes, 🏦 Caixa para quem opera o financeiro. Use e-mails reais para facilitar a recuperação de acesso.

4

📦 Popular o estoque inicial

Cadastre as peças e fluidos mais usados em Estoque → Novo Item. Defina sempre o Estoque Mínimo para receber alertas automáticos. Comece pelas peças de maior giro (óleo, filtros, pastilhas).

5

🔧 Criar a primeira Ordem de Serviço

Clique no botão (FAB) ou vá em Ordens → Nova OS. Preencha o cliente (ou cadastre um novo), o veículo, o tipo de serviço, o mecânico responsável e o valor. Isso valida o fluxo completo do sistema.

6

💾 Exportar primeiro backup

Vá em Configurações → Exportar Backup e salve o arquivo JSON no Google Drive ou pendrive. Faça isso diariamente às 18h — o sistema usa localStorage e os dados ficam apenas no navegador local.

7

🚗 Criar login para um cliente

No cadastro do cliente, defina um e-mail e senha. Ao fazer login, ele será direcionado automaticamente ao Portal do Cliente — onde vê suas OS, veículos e parcelas, sem acesso a nenhum dado interno da oficina.

🖱️ Navegação
Abrir menu lateral
Nova OS (botão FAB)
🔎 Consultar placa
🔔 Notificações
🤖 Assistente IA
Ajuda (esta página)
🚪 Encerrar sessão
🛡️ Auditoria (Admin+)
💰 Módulo Financeiro — 8 Abas
Aba 1 KPIs Financeiros
Aba 2 Caixa do Dia
Aba 3 Gráficos
Aba 4 Parcelamentos
Aba 5 Contas a Pagar
Aba 6 Fluxo de Caixa
Aba 7 DRE
Aba 8 Histórico Pgto
📊 Fluxo de uma OS do início ao fim
1️⃣
Abertura — Cliente chega, recepção cria a OS com cliente, veículo, queixa e mecânico responsável
2️⃣
Diagnóstico — Mecânico acessa no seu login, analisa e atualiza status para "Em Andamento"
3️⃣
Orçamento — Financeiro ou Gerente gera orçamento, cliente aprova (pode ver no portal)
4️⃣
Execução — Mecânico usa peças do estoque (baixa automática), atualiza progresso
5️⃣
Conclusão — Status "Concluído", avaliação de satisfação enviada ao cliente
6️⃣
Pagamento — Caixa registra o pagamento (à vista, cartão ou parcelado), DRE atualizado
📦 Estoque
🛡️ Log de Auditoria
🛒 PDV — Caixa Fiscal
🏷️ Consulta de Preço
Digite para buscar produtos ou serviços
🧮 Calculadora teclado ativo

🧾 Carrinho

0 itens
Carrinho vazio
SubtotalR$ 0,00
Desconto– R$ 0,00
ImpostosR$ 0,00
TOTALR$ 0,00
📄 Emitir NF-e
⚠️ Configure os dados da empresa em
— gerar ao emitir —
📦 Itens da NF-e
Cód.DescriçãoNCMCFOPQtd.Vl.Unit (R$)
Nenhum item. Clique em "+ Adicionar Item"
⚙️ Tributação padrão dos itens
💰 Totais da NF-e
Vl. Total ProdutosR$ 0,00
Base Cálc. ICMSR$ 0,00
Vl. ICMSR$ 0,00
Vl. PISR$ 0,00
Vl. COFINSR$ 0,00
FreteR$ 0,00
SeguroR$ 0,00
DescontoR$ 0,00
TOTAL NF-eR$ 0,00
📋 XML NF-e Gerado
— clique em "Emitir" para gerar o XML —
📋 Emitir NFS-e
🏛️ ISS
📋 Retenções Federais
Valor ServiçoR$ 0,00
DeduçõesR$ 0,00
ISSR$ 0,00
IRR$ 0,00
CSLLR$ 0,00
PISR$ 0,00
COFINSR$ 0,00
Líquido ReceberR$ 0,00
📋 XML NFS-e
— clique em "Emitir" para gerar —
📁 Notas Emitidas
TipoData EmissãoDestinatário / TomadorCNPJ/CPFVl. TotalStatusAções
Nenhuma nota emitida
⚙️ Configurações Fiscais
🏢 Dados da Empresa (Emitente)
📄 Configurações NF-e
Ambiente de homologação: notas não têm validade jurídica
📋 Configurações NFS-e
💰 Alíquotas — Legislação Vigente 2025/2026
📌 Simples Nacional (Regime 1): use campo ISS como alíquota efetiva do DAS (Anexo III · LC 123/2006). Faixa 1 até R$180k = 6,00% · Faixa 2 até R$360k = 11,20% · Faixa 3 até R$720k = 13,50%.
📌 Lucro Presumido (Regime 2): PIS 0,65% · COFINS 3% · ISS conforme município (2–5%) · IRPJ/CSLL sobre base presumida 32%.
📌 Lucro Real (Regime 3): PIS 1,65% · COFINS 7,6% (não-cumulativo) · ISS conforme município.
Reforma Tributária EC 132/2023 (Lei 214/2024): CBS+IBS em transição gradual 2026–2032. Alíquotas atuais vigentes até 2033.
🔐 Certificado Digital A1
ℹ️ Para transmissão real ao SEFAZ, é necessário certificado digital A1 (.pfx). Em homologação, o XML é gerado mas não transmitido automaticamente.
🔑 API Keys — Consulta de Placa
Consulta real de placa — retorna marca, modelo, ano, cor e UF direto no formulário de OS e Cliente.
Cadastre-se grátis: placafipe.com.br (50 consultas grátis) · wsconsulta.com.br (R$0,09/consulta) · apiveiculo.com.br (R$0,08/consulta)
📡 APIs Gratuitas Brasileiras
Brasil API — CNPJ, CEP (sem chave)
IBGE API — Municípios, UFs (sem chave)
ReceitaWS — CNPJ fallback (limitado)
FIPE API — Tabela de veículos (sem chave)
⚡ Chave PIX — Pagamento no PDV
Configure sua chave PIX para gerar QR Code automático no checkout do PDV quando o cliente escolher pagar via PIX. O QR Code segue o padrão BRCode / EMVCo do Banco Central.
🏢 Multi-Empresa — Alternar Emitente
Salve perfis de diferentes empresas (CNPJs) e alterne com 1 clique. Útil para grupos com mais de uma razão social. A empresa ativa é usada em todos os documentos fiscais.
➕ Salvar Empresa Atual como Perfil
☁️ Sincronização em Nuvem — Supabase
Backup automático e permanente — seus dados são sincronizados com o Supabase em background sempre que houver alterações. Funciona 100% offline; sincroniza automaticamente ao reconectar.

📌 Como configurar: Acesse supabase.com → seu projeto → Project Settings → API → copie a Project URL e a chave anon (public).
Verificando...
🔐 Acesso à Nuvem

Primeiro acesso? Informe um e-mail e senha para criar sua conta na nuvem.
Já tem conta? Use o mesmo e-mail e senha para entrar.

💡 Dica: Se for seu primeiro acesso, clique em Criar Conta com seu e-mail e uma senha forte. Na próxima vez, use Entrar com as mesmas credenciais.
⏰ Backup Automático Agendado
O sistema verifica diariamente se chegou o horário configurado e dispara o backup JSON automaticamente. Combine com uma pasta sincronizada (Google Drive, Dropbox, OneDrive) para backup em nuvem sem configuração extra.
🔵 Google Drive — Upload Direto
Envia o backup JSON direto para sua pasta Mecânica Trovão no Google Drive com 1 clique.
📌 Como configurar: console.cloud.google.com → Criar projeto → Ativar Drive APIOAuth 2.0 Client ID (tipo Web) → adicione ${location.origin} como origem autorizada → copie o Client ID.
🛡️ Camadas de Segurança Ativas
RLS (Row Level Security) — cada usuário só acessa seus próprios dados
TLS 1.3 — criptografia total em trânsito
AES-256 — criptografia em repouso no servidor
Audit Log imutável — histórico de todas as sincronizações
JWT + refresh token — autenticação stateless segura
Offline-first — dados locais independentes da nuvem
Auto-prune — mantém apenas os últimos 30 backups
📂 Importar Dados do Sistema Antigo (MDB / Access)

Migre clientes, veículos, OS, estoque, fornecedores, trocas de óleo, pagamentos e funcionários do seu sistema anterior para o Trovão em um clique.
Os dados existentes não são apagados — apenas mesclados.

📋 Como gerar o trovao-import.json
1. Abra migrar-mdb.html (está na pasta do aplicativo)
2. Carregue o arquivo migracao-mdb.json (gerado pelo PowerShell, ~13 MB)
3. Clique em "⚡ Processar e Gerar JSON"
4. Baixe o trovao-import.json gerado
5. Volte aqui e selecione o arquivo abaixo ↓

⚠️ Necessário nível Admin ou SuperAdmin para importar.

📦 O que é importado
👤
Clientes
Nome, CPF/CNPJ, endereço, telefone
🚗
Veículos
Vinculados aos clientes por nome
📋
Ordens de Serviço
Histórico completo de 12.056 OS
📦
Estoque
Peças e produtos com preços
🏭
Fornecedores
CNPJ, contatos, endereço
🛢️
Trocas de Óleo
571 registros → Preventivas
💰
Pagamentos
4.297 histórico → Financeiro
👷
Funcionários
3 registros → Usuários (mecânico)
🔐 Autenticação em 2 Fatores (2FA)
Após senha correta, o usuário recebe um código OTP de 6 dígitos no e-mail antes de acessar o sistema.

📌 Como configurar: emailjs.com → conta gratuita (200 emails/mês) → Email Services → Add ServiceEmail Templates → New Template.
Variáveis do template: {{to_name}} · {{otp_code}} · {{expires_in}}
Ativar 2FA no Login da Equipe
Requer configuração do EmailJS abaixo
🚨 Alertas de Segurança por E-mail
Receba alertas instantâneos quando ocorrerem eventos críticos: bloqueio de login, exclusão de usuário, importação de backup e outros.

📌 Usa o mesmo EmailJS configurado acima. Pode usar o mesmo Service ID + um template dedicado para alertas, ou reutilizar o template de 2FA (os campos {{otp_code}} e {{expires_in}} exibem o evento).
Ativar Alertas de Segurança
Requer EmailJS configurado + e-mail do admin abaixo
🔴 Eventos que disparam alerta: Login Bloqueado · Usuário Deletado · Importação de Backup · Falha 2FA · Troca de Senha Obrigatória
⏱️ Throttle automático: máximo 1 alerta por tipo a cada 10 minutos (evita spam).
⏱️ Política de Sessão
ℹ️ Alterações na política de sessão são aplicadas imediatamente e persistem entre recarregamentos.
🛡️ Camadas de Segurança Ativas
AES-256-GCM — dados em repouso criptografados (localStorage)
PBKDF2-SHA256 · 100.000 iterações · salt 128-bit — senhas
IndexedDB isolado — chave AES separada dos dados
Rate limiting — bloqueio após 5 tentativas por 5 min
Session timeout — expiração por inatividade (30 min)
Audit log — registro imutável de todos os eventos de segurança
2FA por e-mail — não configurado
Alertas de segurança — não configurados