CaraCore CSO — auditoria operacional de frota e lastro para 2027
O CSO é a camada de auditoria operacional e governança de ativos da frota: a Gestão de Frotas, no navegador, já comprova o consumo real de combustível e manutenção por veículo — placa única e histórico que dão lastro à apuração de CBS/IBS feita pela contabilidade. Ele não emite NF-e, NFC-e ou CT-e, não é ERP contábil e não substitui o emissor fiscal nem o contador. A Gestão de Transportes organizará clientes, entregas e equipe no computador da empresa; o Virtual Tracker será a capacidade integrada de acompanhar deslocamentos pelo celular do motorista, sem rastreador dedicado. Transportes + Virtual Tracker têm lançamento-alvo conjunto em 08/11/2028, sujeito à validação técnica e homologação. Não é um terceiro produto nem uma fusão dos bancos.
Blindar minha frota para 2027 Ver trilha de auditoria e requisitos Conhecer a proposta e conversar sobre minha operação
Gestão de Frotas (Web) — auditoria operacional
Em produção · cso.caracore.com.br
Camada de auditoria operacional da frota no navegador: placa única por veículo e histórico de abastecimento, manutenção, documentos, pneus, exame e custo por km. Dá lastro à apuração de CBS/IBS sem emitir nota fiscal nem substituir o ERP ou a contabilidade. Começa grátis com até 3 veículos.
- Oficina:
caracore-cso-quarkus - Stack: Java 21 · Quarkus · PostgreSQL 16 · Qute/HTMX
- i18n: pt, en, es, it, de
- Não emite NF-e/NFC-e/CT-e · não é rastreador GPS
Gestão de Transportes (Desktop)
Em desenvolvimento — alvo 08/11/2028
Organiza entregas, equipe, clientes e tabelas de preço com persistência local. Na integração planejada, recebe e valida as posições cifradas do celular e mantém mapa e histórico somente na empresa. Não está disponível para contratação.
- Oficina:
caracore-cso-transportes - Stack: Java 21 · Quarkus · JavaFX · Vue 3 · SQLite
- Trilha soberana (Protocolo Amarelinha) em evolução
O que muda para você e o detalhe opcional
O que muda para você
Pense no CSO como a prova da frota que deixa de ser planilha. No dia a dia a equipe entra no site, registra veículos, combustível, oficina, motoristas e viagens, e o gestor vê relatórios — cada veículo com uma placa única e um histórico que a contabilidade pode usar como lastro. Cada empresa vê só os próprios dados. O CSO não emite nota fiscal: a prova operacional apoia a apuração de CBS/IBS; o aproveitamento de créditos depende da legislação e da análise do contador.
- Placa única por veículo e histórico encadeado — a base do lastro para 2027
- Começar grátis (até 3 veículos), sem cartão no cadastro
- Planos pagos em reais, com Pix no Brasil
- Perfis claros: quem administra, quem gestiona, quem opera
- O desktop guarda a operação local na empresa; novas posições do celular exigem conexão e base disponível
Detalhe opcional
Não existe uma oficina única caracore-cso. São duas oficinas. A aplicação Frotas vive em cso.caracore.com.br; a loja única é caracore-cso-releases em cso-transp.caracore.com.br — a loja não substitui o produto no ar. A oficina Transportes não leva copy nem URL de loja.
- Frotas: SSR Qute + HTMX, sessão opaca no Postgres, RBAC, Flyway, multi-tenant
- Transportes: API REST + SPA Vue + cliente JavaFX, SQLite local, JWT na trilha desktop
- Regra de copy: separar Frotas disponível de Transportes + VT planejados; não anunciar GPS implementado, posição instantânea ou recuperação offline; não tratar o CSO como emissor de nota fiscal ou ERP contábil
- Credenciais de demo: só no README da oficina, e só no banco local — nunca em produção
O que a auditoria de frota já faz
Momento atual (produção em cso.caracore.com.br): o cliente organiza a frota, os custos e a equipe. Desde 06/10/2026 a versão inclui km/L, documentos do veículo, pneus, exame toxicológico, infrações e custo por km, além de filtros operacionais, regras para veículos inativos, atualização de quilometragem e termos LGPD v2.1. É essa trilha — placa única e histórico por veículo — que sustenta o lastro operacional para a apuração de CBS/IBS a partir de 2027. O CSO não emite nota fiscal.
| Área | O que o cliente usa hoje |
|---|---|
| Captação | Landing com planos, cadastro self-service (FREE_3), convites por chave, checkout Pix/ACH e recuperação de acesso |
| Onboarding | Aceite LGPD (termos v2.1, com controlador/operadora e bases legais do art. 7º) → primeiro veículo → dashboard; a nova versão exige novo aceite |
| Frota | Cadastro de veículos com categoria (automóvel, utilitário, van, caminhão, ônibus, motocicleta, implemento ou outro), limite por plano, placa única, filtro por status e estados ativo / manutenção / inativo |
| Auditoria operacional | Placa única por veículo e histórico encadeado de abastecimentos, manutenções, quilometragem e custo por km — o lastro operacional para a apuração de CBS/IBS. Não emite NF-e, NFC-e ou CT-e, não é ERP contábil e não substitui a contabilidade |
| Operação | Abastecimentos filtráveis por veículo, posto e período; manutenções por veículo, status, descrição e período. Veículos inativos não podem receber abastecimentos ou novas manutenções nem iniciar viagens; a quilometragem é atualizada por abastecimento e conclusão de viagem, e valores regressivos são rejeitados |
| Relatórios | Consumo, manutenção, status da frota, CNH, viagens, manutenção mensal, utilização mensal e custo por km (ADMIN/GESTOR). O custo por km soma combustível e manutenção do mês e divide pelos quilômetros; sem quilometragem, o relatório não divide. Imposto, seguro, depreciação e GPS ficam de fora |
| Economia e documentos | Km/L por veículo. Vencimentos de imposto do veículo, circulação e seguro no cadastro, com o rótulo conforme o país. Pneus com posição e alerta. Exame toxicológico e infrações do condutor, sem integração com o DETRAN |
| Equipe | O ADMIN gerencia usuários em uma tela e emite chaves de convite de uso único para ADMIN, GESTOR ou ENTREGADOR. GESTOR e ENTREGADOR não gerenciam a equipe; o ADMIN pode alterar perfis |
| Privacidade | Aceite versionado dos termos v2.1, bases legais do art. 7º e auditoria gerencial; cada organização isolada (multi-tenant) |
Planos e perfis (Frotas)
Limite de veículos
| Plano | Veículos | Preço |
|---|---|---|
| FREE_3 | até 3 | R$ 0 |
| P5 | até 5 | R$ 5,00/mês |
| P10 | até 10 | R$ 10,00/mês |
| CORPORATE | até 50 | R$ 49,00/mês |
Cobrança sempre em reais. No Brasil, Pix avulso; fora, transferência internacional equivalente. A operação libera o plano após o comprovante — não é PIX recorrente automático. A aplicação só sugere upgrade quando o uso alcança 80% do limite de veículos.
Quem acessa o quê
- ADMIN — administra a empresa: usuários, convites, frota, relatórios e auditoria LGPD
- GESTOR — opera a frota e vê relatórios; não gerencia usuários nem convites
- ENTREGADOR — telas operacionais do dia a dia, sem menu admin nem relatórios
Todos entram pelo mesmo /login. O ADMIN define o perfil ao emitir uma chave de convite, válida de 1 a 30 dias, e pode alterar o perfil depois em Usuários, sem recriar a conta. A chave é de uso único; o convite não depende de envio de e-mail. Há um operador interno da Cara Core (área discreta) que não mistura sessão com a frota do cliente.
Gestão de Transportes — o bunker de 2028
O que muda para você
É o CSO que mora no computador da empresa. Serve para quem precisa continuar operando entregas, equipe e clientes mesmo com internet instável, e para guardar uma cópia soberana dos dados críticos.
- Entregas, entregadores, clientes, equipes e tabelas de preço
- Banco local (SQLite) — o dado não depende só da nuvem
- Acoplado à Gestão de Frotas; não a substitui
Detalhe opcional
Oficina caracore-cso-transportes: API REST Quarkus com SQLite, SPA Vue 3 e cliente JavaFX 21 em cs-desktop-fx/. A trilha soberana segue o Protocolo Amarelinha (Geometria → Dinâmica → Sombra → Massa → Céu).
- Persistência local em SQLite; Flyway nas migrações
- Autenticação JWT na API da oficina; JavaFX consome a API
- Papel planejado no VT: descriptografar, validar e persistir posições antes de confirmar recebimento; mapa e histórico somente no desktop
Virtual Tracker — acompanhar sem aparelho dedicado
Como será: o motorista inicia uma viagem autorizada no celular; Frotas conecta os participantes e encaminha o conteúdo cifrado; o computador da empresa recebe as posições e mostra o mapa e o histórico. A coleta fica restrita à viagem autorizada. Permissões, encerramento e revogação serão validados antes do lançamento.
- Frotas não guarda trajetos: não lê nem persiste posições, rotas, trânsito ou envelopes cifrados, inclusive em logs, monitoramento técnico, caches e filas. O encaminhamento usa somente memória transitória limitada.
- Dados na empresa: chave privada de descriptografia, validação das coordenadas, mapa, histórico e retenção ficam no desktop. Frotas mantém apenas os metadados mínimos de autenticação, vínculo e presença; não é servidor de telemetria.
- Conexão necessária: sem rede ou base disponível, não há fila nem recuperação posterior de trechos. Falhas e posições antigas devem ser sinalizadas; timeout significa entrega não confirmada, não certeza de perda.
- Consumo regulado: perfil econômico de referência com presença a cada 120 segundos quando necessária e posição a cada 60 segundos em viagem. Tráfego autorizado pode substituir ping redundante; limites e reconexão progressiva evitam rajadas. Eventos de início, fim e revogação não aguardam o ping. Não é localização instantânea.
- Validação pendente: comportamento em Android/iPhone com tela bloqueada, bateria, banda nos dois trechos, protocolo criptográfico, endpoints e proteção das chaves ainda precisam de prova e aprovação. Criptografia não elimina o risco de código malicioso na origem que serve o cliente web.
O que vem depois (status honesto)
O acordo visível com o cliente: o que não está marcado como disponível ainda não faz parte do que se paga. Preferimos atrasar um recurso a prometer o que não entregamos.
| Quando | O quê | Status |
|---|---|---|
| Em produção desde 06/10/2026 | Auditoria operacional da frota no navegador: veículos e categorias, combustível, manutenções, motoristas, viagens, relatórios, planos e termos LGPD v2.1. Placa única e histórico por veículo como lastro para CBS/IBS, sem emitir nota fiscal. Inclui km/L, documentos do veículo, pneus, exame toxicológico, infrações e custo por km, além de filtros operacionais, convites por chave e bloqueios para veículos inativos. | Disponível |
| 08/11/2026 | Freeze do Momento 1: estabilização da Gestão de Frotas já publicada. Sem jornada, app offline nem GPS | Marco de estabilização |
| 08/11/2028 — alvo conjunto | Transportes Desktop + Virtual Tracker integrado à Frotas: jornada autorizada, localização pelo celular e mapa/histórico somente na empresa. Sem contratação antecipada | Condicionado à validação |
| Sem data adicional aprovada | Demais itens do epic MON, incluindo a porta de API de agentes, não entram automaticamente no escopo integrado | Roadmap |
| Cancelado em 15/10/2026 | PWA de gestão offline, armazenamento de negócio no celular e sincronização. Não fazem parte da proposta | Não implementar |
Plano de execução: 10 sprints locais estimadas de Transportes + 21 tarefas integradas (INT-01 a INT-21), organizadas em 6 etapas, não seis sprints. Backlog integrado: 0/21 concluídas. O total de sprints, capacidade e calendário dependem de INT-03, após baseline e prova móvel. MON permanece 0/53, com reaproveitamento seletivo; não somar como tarefas independentes.
Etapas: baseline/prova/capacidade; contratos/privacidade/canal; jornada/autorização; posições/cliente; mapa/histórico/proteção; homologação/publicação. O plano mestre fica na oficina Transportes, em docs/plano_organizado_execucao_cso.md, seção 7. A data-alvo não confirma disponibilidade automaticamente.
Gateway de versões — onde mora e como migra
O canal que avisa os aplicativos desktop sobre novas versões (PDV, CSO, Hub e Ink Agenda) tem uma fonte primária única: o repositório caracore-api, que guarda a especificação do Gateway (contrato, catálogo de aplicativos e rotas). O caracore-cso-quarkus apenas hospeda temporariamente uma réplica desse serviço, no mesmo deployment da Gestão de Frotas, e deve refletir exatamente o código do caracore-api.
- As rotas usam endereços neutros (
api.caracore.com.br/releases/{app}/latest.json), sem citar o produto que hospeda o serviço. Por isso o Gateway pode ir para um servidor dedicado sem mudar nada nos aplicativos instalados. - Mudanças de contrato começam no
caracore-apie são replicadas no CSO; o CSO não é editado direto. - Hoje a produção ainda roda a partir do CSO; a mudança para o
caracore-apinão tem data aprovada.
Mapa rápido para quem vai mexer no código
| Frotas (Web) | Transportes (Desktop) | |
|---|---|---|
| Oficina | caracore-cso-quarkus | caracore-cso-transportes |
| Runtime | Quarkus 3.8 · Java 21 | Quarkus 3 · Java 21 · JavaFX 21 |
| Interface | Qute + HTMX + Alpine.js | Vue 3 SPA + JavaFX |
| Banco | PostgreSQL 16 (produção) | SQLite local |
| Sessão | Cookie opaco (estado no Postgres) | JWT na API da oficina |
| Subir local | docker compose up -d e mvn quarkus:dev | mvn quarkus:dev / cs-desktop-fx |
| URL pública | cso.caracore.com.br (aplicação) | GA 08/11/2028 · vitrine cso-transp.caracore.com.br |
http://localhost:8080. Testes automatizados usam H2 e não exigem Docker. Não copie senhas de desenvolvimento para produção.