Documentação

Reparou — Blueprint da Plataforma (50 módulos)

Mapa completo "enterprise-ready" da plataforma — do nível conceitual de Shopify (varejo), Salesforce (vendas) e Clinicorp (clínicas). Atende de uma oficina de 2 boxes a redes com centenas de unidades. Este documento é a north star de arquitetura, não o plano de construção. O plano faseado está em visao-produto.md; aqui cada módulo recebe um tag de fase: F1, F2 (profundidade operacional), F3 (diferencial/premium), F4 (ecossistema/escala).


Princípio de leitura

Isto não é um MVP — cada fase entrega produto final produtivo, completo do começo ao fim; o faseamento é ordem de construção, nunca licença para entregar raso. A armadilha de um mapa de 50 módulos é construir horizontalmente (todos os módulos rasos) em vez de verticalmente (a cunha funda primeiro). O blueprint existe para responder duas perguntas:

  1. O que precisa estar certo no dia 1 mesmo sem ser construído → as decisões de arquitetura da seção A.
  2. Onde cada feature futura vai morar → para que o F1 não pinte a plataforma num canto.

A. Core Platform — decisões de dia 1

Nada disso é visível ao cliente, e tudo isso é impossível de retrofitar barato. A F1 implementa o núcleo de cada um — completo, produtivo e definitivo — e o modelo de dados nasce certo.

MóduloConteúdoFaseDecisão de dia 1
1. Gestão de EmpresasMultiempresa, multiunidade, franquias, holdings, filiais, compartilhamento de dados, centralização financeira, consolidação de indicadoresF1 (1 unidade) / F3 (rede)Multi-tenant com hierarquia de organização (holding → empresa → unidade) no schema desde o início, mesmo que a UI só exponha 1 unidade
Usuários e SegurançaUsuários ilimitados, perfis, grupos, permissões granulares, MFA, SSO, auditoria completa, histórico de alterações, LGPD, gestão de sessõesF1 (RBAC básico + audit log) / F2 (MFA) / F4 (SSO)RBAC granular e audit log desde o dia 1 — auditoria não se adiciona retroativamente
ConfiguraçõesParametrizações, templates, regras de negócio, fluxos personalizados, campos customizados, formulários customizadosF1 (templates) / F2 (campos customizados) / F3 (fluxos)Entidades centrais (OS, orçamento, checklist) já nascem com suporte a campos customizados
36. Gestão DocumentalContratos, laudos, PDFs, assinaturasF2Storage de mídia/documentos atrelado a qualquer entidade desde o F1 (fotos de check-in já exigem isso)
37. Workflow EngineBPM, aprovações, regras, automaçõesF3 (engine genérico)F1 usa automações hard-coded, mas disparadas por eventos de domínio — o event bus é a fundação do engine futuro
38. Central de ComunicaçãoWhatsApp, email, SMS, push, vozF1 (WhatsApp) / F2 (email, push) / F4 (SMS, voz)Camada de mensageria abstraída por canal desde o início
39. IntegraçõesERP, bancos, marketplaces, seguradoras, catálogos, APIs públicasF2+
46. Open PlatformAPI pública, webhooks, SDK, marketplace de appsF4API-first desde o F1: a API pública futura é a mesma API que o frontend consome

B. Clientes & Veículos

MóduloConteúdoFase
2. CRM de ClientesPF, PJ, frotistas, seguradoras, locadoras; timeline completa (financeiro, técnico, comercial); segmentação (VIP, inativos, potenciais, corporativos); campanhas e jornadasF1 (cadastro + timeline + segmentação) / F2 (jornadas)
3. CRM de VeículosPlaca, chassi, Renavam, motor, câmbio, versão; histórico (serviços, garantias, revisões, pneus, baterias, peças); documentação (CRLV, apólices, fotos, contratos); timeline da vida útilF1 (cadastro + timeline) / F2 (documentação)

C. Operação da Oficina

MóduloConteúdoFase
4. Recepção e Check-in DigitalFotos, vídeos, assinatura digital; checklist visual (carroceria, rodas, pneus, vidros, combustível); danos pré-existentes com marcação em imagemF1 (fotos + checklist) / F2 (marcação em imagem)
5. Diagnóstico e InspeçãoChecklists personalizados por categoria; inspeção digital (fotos, vídeos, áudios); diagnóstico assistido por IA; relatórios técnicos (PDF, portal, WhatsApp)F2 (DVI) / F3 (IA)
6. OrçamentaçãoPeças, serviços, pacotes; aprovação via portal/WhatsApp/assinatura digital; simulação de cenários; conversão orçamento → OSF1 (núcleo da cunha) / F2 (simulações)
7. Ordem de ServiçoAbertura → planejamento → execução → entrega; controle de peças, serviços, mão de obra, custos; fluxos customizáveis; timeline completaF1 / F3 (fluxos customizáveis)
8. Planejamento OperacionalAgenda (serviços, boxes, técnicos); capacidade e ocupação; previsão de gargalosF1 (agenda) / F2 (capacidade) / F3 (previsão)
9. Gestão de BoxesMapa visual (boxes, elevadores, equipamentos); monitoramento de ocupação e tempo paradoF2
10. Gestão de TécnicosEspecialidades, certificações; produtividade (horas apontadas × vendidas); performance (eficiência, retrabalho)F2
11. Apontamento de Mão de ObraCronômetro, check-in/check-out; produtividade e ociosidadeF2

D. Suprimentos

MóduloConteúdoFase
12. EstoqueEntradas, saídas; inventário rotativo e geral; lotes e rastreabilidade; curva ABCF2
13. Catálogo de PeçasBase centralizada; compatibilidade marca/modelo/motor; aplicações; equivalênciasF2 (básico) / F3 (base centralizada cross-tenant — alimenta o data lake)
14. ComprasSolicitação, cotação, pedido, recebimento, conferênciaF2
15. FornecedoresCadastro, performance, SLA, históricoF2
40. Marketplace de PeçasBusca, comparação, compra, tracking — sem sair da OSF3 (depende de API de peças no BR — questão aberta)
41. Marketplace de ServiçosTerceirização: guinchos, funilarias, especialistasF4

E. Financeiro

MóduloConteúdoFase
16. FinanceiroContas a receber/pagar, fluxo de caixa, conciliação, centros de custo, rateiosF1 (contas + caixa) / F2 (conciliação, rateios)
17. FaturamentoNFS-e, NFC-e, boletos, PIX, cartões, recorrênciaF1 (NFS-e/NF-e + PIX manual) / F2 (conciliação PIX, cartões, boletos) / F3 (recorrência)
18. ControladoriaDRE, demonstrativos, orçamento empresarial, forecastF2 (DRE) / F3 (forecast)
19. ComissõesMecânicos, consultores, gestores, equipesF2

F. Verticais e Especializações

MóduloConteúdoFase
20. GarantiasControle, acionamentos, custos, históricoF2
21. Gestão de PneusVida útil, rodízio, desgaste, históricoF3 (vertical)
22. Gestão de FrotasEmpresas, contratos, veículos, motoristas, custo por veículoF3 (módulo premium)
23. Sinistros e SeguradorasOrçamentos, aprovações, integrações, históricoF3 (vertical funilaria)
24. Lavação e EstéticaAgendamentos, pacotes, recorrênciasF3 (vertical)
25. Centro AutomotivoAlinhamento, balanceamento, geometria, suspensãoF3 (vertical)

G. Experiência do Cliente & Growth

MóduloConteúdoFase
26. Portal do ClienteAcompanhamento (OS, fotos, vídeos), aprovação, pagamentos, garantias — web por magic-link, sem app (o dono do veículo não instala nada)F1 (link web)
28. WhatsApp OmnichannelInbox, chatbot, IA, templates, campanhas (modelo Ogmma)F1 (inbox + templates) / F2 (chatbot) / F3 (IA)
29. CRM ComercialLeads, funil, oportunidades, propostasF2
30. MarketingAutomações, campanhas, remarketing, fidelizaçãoF2 (automações básicas no F1)
31. Pesquisa de SatisfaçãoNPS, CSAT, avaliaçõesF2

H. Inteligência

MóduloConteúdoFase
32. Business IntelligenceDashboards, indicadores, metas, benchmarkingF2
33. IA OperacionalDiagnóstico assistido, consulta técnica, manual técnico, sugestão de serviços/peças, precificaçãoF3
34. IA ComercialUpsell, cross-sell, recuperação de clientes, campanhasF3
35. IA FinanceiraPrevisão de caixa, inadimplência, recomendaçõesF3
45. Data PlatformData lake, data warehouse, machine learning, benchmark nacionalF3/F4 — o moat de longo prazo; eventos de domínio do F1 já alimentam a base
50. Central de Comando (CEO Dashboard)Hoje (carros, receita, ticket médio), operação (boxes, gargalos), financeiro (caixa, margem), comercial (conversão, retenção) + IA Copilot ("por que o faturamento caiu?", "quais clientes devo contatar?")F2 (dashboard) / F3 (copilot) — o módulo mais importante para o dono

I. Rede & Ecossistema

MóduloConteúdoFase
42. Rede de OficinasCompartilhamento, benchmarking, compras coletivasF4
43. Universidade CorporativaTreinamentos, certificações, trilhasF4
44. Central de FranquiasGovernança, auditoria, padrões operacionaisF4

J. App da Oficina (único e multipapel)

MóduloConteúdoFase
47. App da OficinaUm app único cuja experiência se adapta ao papel logado — Mecânico (agenda, OS, checklist/DVI, fotos, apontamento, modo pátio), Consultor (recepção/check-in, orçamentos, aprovações, CRM), Gestor/Owner (KPIs, alertas, financeiro de leitura). Não há app do cliente — o dono do veículo usa só o Portal web.F2 (o DVI móvel vive aqui)

No F1, todas as personas usam o web app responsivo. O app único da oficina chega no F2, com a experiência montada por papel (RBAC) — um binário, não três apps. O dono do veículo nunca tem app: acompanha tudo pelo Portal web por magic-link.


Resumo do faseamento

FaseTeseMódulos (nº)
F1Cunha: aprova orçamento pelo WhatsApp + fiscal transparente1*, 2, 3, 4, 6, 7, 8*, 16*, 17*, 26, 28*, 30* (núcleo completo e produtivo)
F2Profundidade operacional + experiência (DVI, estoque/compras, BI, app único da oficina)5, 9–15, 18–20, 29, 31, 32, 36, 47, 50*
F3Diferencial defensável (IA em 3 camadas, marketplace de peças, verticais, copilot, data platform)21–25, 33–35, 37, 40, 45, 50
F4Ecossistema e escala (open platform, rede, franquias, marketplace de serviços)41–44, 46

* = núcleo do módulo entregue completo e acabado na fase indicada; as fases seguintes adicionam capacidades novas, nunca consertam o que já saiu.

O que diferencia este blueprint dos líderes mundiais

IA nativa (não acoplada), WhatsApp nativo (vantagem local que Tekmetric/Shopmonkey não têm), portal do cliente (web por magic-link, sem app) como cidadão de primeira classe, marketplace integrado e arquitetura de plataforma aberta — sobre um mercado brasileiro que ainda vende "OS + financeiro + estoque" (ver analise-mercado.md).