SISTEMA DE AGENDAMENTO E GESTÃO AUTOMOTIVA (OFICINA + CLIENTE)

SISTEMA DE AGENDAMENTO E GESTÃO AUTOMOTIVA (OFICINA + CLIENTE)

**Objetivo do Projeto:**
Desenvolver uma plataforma Web/Micro-SaaS multi-tenant para agendamento, gestão de oficinas mecânicas e histórico unificado do proprietário do veículo. O sistema possui dois portais distintos com autenticação independente (Painel da Oficina e Portal do Cliente/Motorista).

—

### **1. REQUISITOS DE AUTENTICAÇÃO E PERFIS**

* **Portal do Cliente (Visão Centrada no Veículo):**
* **Autenticação:** Login via WhatsApp (Passwordless via OTP/Link), Google OAuth ou E-mail/Senha.
* **Conceito Central:** O histórico pertence ao cliente e ao veículo (pela placa/VIN), não a uma oficina específica.
* **Multi-oficina:** O cliente visualiza a linha do tempo de manutenção do seu carro, mesmo que tenha sido atendido por diferentes oficinas cadastradas na plataforma.

* **Portal da Oficina (Visão Multi-tenant de Gestão):**
* **Autenticação:** E-mail/Senha com 2FA e controle de acesso baseado em funções (RBAC): Administrador/Dono, Recepção/Consultor, Mecânico/Técnico e Financeiro/Contador.
* **Gestão Geral:** Painel completo para operação diária, estoque, equipe, orçamentos, agendamentos e módulo financeiro/contábil.

—

### **2. MÓDULO DO CLIENTE (PORTAL DO MOTORISTA)**

1. **Garagem Virtual & Histórico Unificado:**
* Cadastro de um ou mais veículos (Placa, Modelo, Ano, Quilometragem atual, VIN).
* **Prontuário do Veículo:** Exibição da linha do tempo com todas as revisões, peças trocadas, serviços executados, fotos das peças substituídas e notas fiscais de qualquer oficina da rede onde o carro já esteve.
* Alertas inteligentes de manutenção preventiva baseados no manual do proprietário e no uso estimado (troca de óleo, pastilhas, correia dentada, alinhamento).

2. **Agendamento Inteligente & Cotação:**
* **Busca & Escolha:** Localização de oficinas parceiras por proximidade (Geolocalização), avaliação, especialidade (ex: freios, injeção, ar-condicionado) ou histórico prévio.
* **Agendamento em Tempo Real:** Escolha de data e horário sincronizados com a agenda física real da oficina escolhida.
* **Triagem Inteligente (AI Assistant):** O cliente descreve o sintoma (“barulho ao frear”, “luz da Injeção acesa”) ou envia um áudio/vídeo, e o sistema sugere a categoria do serviço e o tempo estimado para diagnóstico.
* Opção de solicitar serviço de **Leva e Traz** ou **Carro Reserva**.

3. **Acompanhamento de Serviço em Tempo Real:**
* Status ao vivo do serviço: Aguardando Diagnóstico → Em Análise → Orçamento Pronto → Em Execução → Teste de Rodagem → Pronto para Retirada.
* Aprovação/Rejeição de orçamentos diretamente pelo painel ou WhatsApp com apenas um clique.
* Visualização de fotos e vídeos enviados pelos mecânicos evidenciando os problemas encontrados.
* Pagamento online (PIX com baixa automática, Cartão de Crédito parcelado ou Link de Pagamento).

—

### **3. MÓDULO DA OFICINA (PAINEL ADMINISTRATIVO E CONTÁBIL)**

1. **Gestão de Agendamentos & Agenda Dinâmica:**
* **Visão Kanban e Calendário:** Organização por elevador/box de atendimento e por mecânico responsável.
* Capacidade operacional configurável (ex: limite de X carros por período com base no tempo estimado de cada serviço).
* Notificações automáticas anti-no-show via WhatsApp API (Lembrete 24h e 2h antes, com botão de confirmação ou reagendamento).

2. **Check-in Digital & Orçamentos Rápidos:**
* Recebimento do veículo via tablet/smartphone com vistoria fotográfica inicial (riscos, nível de combustível, pertences).
* Geração de orçamentos com tabelas de tempos de serviço (Tabela Tempária/Sintática de Mão de Obra) e integração com catálogos de autopeças.
* Envio automático do orçamento interativo para o WhatsApp do cliente.

3. **Gestão Financeira & Contábil Completa:**
* **Fluxo de Caixa:** Entradas, saídas, contas a pagar e a receber, conciliação bancária (OFX e Open Finance).
* **Emissão de Notas Fiscais:** Emissão automatizada de NFS-e (Mão de obra) e NF-e (Peças/Mercadorias).
* **Contabilidade Integrada:**
* DRE (Demonstração do Resultado do Exercício) em tempo real.
* Apurador de impostos conforme o regime tributário (Simples Nacional, Lucro Presumido).
* Cálculo automático de comissões por mecânico ou consultor (sobre mão de obra e/ou peças).
* Exportação de relatórios em formato SPED, XMLs e relatórios prontos para o contador externo.

* **Gestão de Estoque:** Baixa automática de peças ao aprovar a Ordem de Serviço (OS), alerta de estoque mínimo e custo médio das peças.

—

### **4. DIFERENCIAIS TECNOLÓGICOS E RECURSOS ATUAIS (MODERN TECH STACK)**

* **WhatsApp API First:** Notificações de status, envio de links de aprovação de orçamento e lembretes tramitados nativamente via WhatsApp.
* **Inteligência Artificial Integrada:**
* Transcrição de áudio do cliente no agendamento para pré-ordem de serviço.
* Análise preditiva de peças que precisam ser substituídas no histórico do carro.

* **Segurança e Privacidade (LGPD):** Dados do cliente protegidos e controle de visibilidade das informações sensíveis entre oficinas parceiras.

—

### **5. ENTREGÁVEIS SOLICITADOS AO LLM**

1. **Arquitetura do Banco de Dados:** Modelagem das tabelas principais em PostgreSQL (Users, Vehicles, Workshops, Appointments, ServiceOrders, Inventory, Transactions) com relacionamento N:M entre Clientes e Veículos.
2. **Especificação dos Endpoints REST/GraphQL:** Rotas para Agendamento, Aprovação de Orçamento e Lançamento Financeiro.
3. **Wireframe do Fluxo Principal:** Descrição detalhada da jornada do usuário (Cliente agendando e Oficina processando a OS).