Arquitetura

    Headless Telematics: backend pronto, sua interface

    Headless Telematics é uma abordagem de arquitetura em que as funções do backend de telemática ficam acessíveis por APIs documentadas e a interface do fornecedor é opcional: a equipe constrói a própria interface sobre um núcleo pronto. Interface web ou móvel, fluxo embarcado no processo de negócio, integração com o sistema de operação — a escolha é sua, e o backend continua o mesmo.

    Ver a documentação Ir para Composable Telematics
    API documentadaIoT Query — acesso de leituraInterface — sob seu controle
    Consulta · SQL
    SELECT device_id, device_time, lat, lng
    FROM raw_telematics_data.tracking_data_core
    WHERE device_id = 104
    ORDER BY device_time DESC
    LIMIT 1;
    Resposta · linha de resultado
    { "device_id": 104,
    "device_time": "2026-07-21T14:02:11Z",
    "lat": 43.238, "lng": 76.889 }
    200 · raw_telematics_data · acesso de leitura
    Definição

    O que é Headless Telematics

    Headless Telematics divide o produto em duas partes: o backend de telemática, com os dados e a lógica, exposto por APIs documentadas, e a interface, projetada pela equipe que constrói o produto. O núcleo é único, e sobre ele você constrói qualquer interface. A Navixy segue esse princípio: as capacidades do backend de telemática ficam acessíveis por APIs documentadas, e a documentação descreve exatamente quais operações compõem cada cenário.

    • Construa um portal, um aplicativo móvel, um fluxo embarcado no processo de negócio ou uma integração com o sistema de operação — a escolha da interface não se limita a uma única opção.
    • A experiência do usuário, a acessibilidade, a segurança da aplicação, o suporte e os lançamentos da sua interface ficam a cargo da sua equipe.
    • A API documentada é a base da arquitetura: um único contrato serve para a interface web, a móvel e o fluxo embarcado — e, adiante, também para um agente via MCP. Navixy MCP
    O caminho da telemática

    Headless — o degrau entre white label e Composable Telematics

    A telemática percorre um caminho que vai da interface pronta, passa pela arquitetura headless, chega à plataforma composable — e segue até a infraestrutura agent-ready, em que dados e lógica são usados não só por pessoas, mas também por agentes de IA. Headless é o degrau em que o backend já está exposto por APIs e a interface se torna o seu campo de diferenciação.

    • White label e Headless são degraus vizinhos e equivalentes: escolha a interface pronta onde ela compensa, e a própria onde a interface se torna a sua vantagem.
    • Headless já lhe dá uma interface própria sobre um backend documentado — o passo para Composable Telematics pode ser dado à parte, quando a independência de dados e lógica for necessária. Composable Telematics
    Como funciona

    A camada de aplicação liga a sua interface ao backend de telemática

    Garante o backend de telemática

    API documentada e esquema de dados estável — por exemplo, a tabela raw_telematics_data.tracking_data_core no IoT Query.

    Esquema de dados
    Responde a sua interface

    A camada de aplicação chama as operações e busca apenas os campos necessários; o navegador não se conecta ao backend diretamente.

    Garante o backend de telemática

    Acesso de leitura à telemetria pela conexão compatível com PostgreSQL do IoT Query.

    Configuração da conexão
    Responde a sua interface

    Identificação de usuários, guarda de segredos e limites de consulta ficam a cargo da sua solução.

    Garante o backend de telemática

    Credenciais de conexão por instância — isolamento de tenants no nível do backend.

    Responde a sua interface

    A equipe define o mapeamento do usuário ao tenant e a rotação de chaves com a Navixy antes do lançamento.

    Garante o backend de telemática

    Lógica operacional no IoT Logic: ingestão de dados, transformações, ações e roteamento.

    Operações de lógica
    Responde a sua interface

    Interface, acessibilidade, tratamento de erros e suporte aos usuários são a sua zona de responsabilidade.

    Entre a interface e o backend trabalha a camada de aplicação da sua equipe: ela chama as operações documentadas, conduz a lógica de negócio e mantém as credenciais do fornecedor no servidor, não no navegador.

    • A camada de aplicação verifica as permissões de acesso, considera o contexto do tenant e faz cache das consultas ao backend.
    • Logs, identificadores de requisição e verificações de versão conectam as camadas — uma falha se diagnostica em minutos.

    Três operações que definem a sua arquitetura headless

    Cada uma se verifica separadamente: leitura de telemetria, identificação do tenant e ciclo de vida dos lançamentos.

    SQL sobre os dados ao vivo

    Configuração da conexãoEsquema de dados
    01SELECT *
    02FROM raw_telematics_data.tracking_data_core
    03LIMIT 10;
    raw_business_dataraw_telematics_data
    tracking_data_core

    Acesso documentado e compatível com PostgreSQL à tabela raw_telematics_data.tracking_data_core — você lê os campos necessários diretamente.

    A lógica de aplicação — ingestão de dados, transformações JEXL e roteamento — é o IoT Logic na camada de aplicação, não o contrato do backend. Operações de lógica

      Ver a documentação
      Redistribuição de responsabilidade

      Você fica com a sua interface — e com a responsabilidade por ela

      Essa troca compensa quando a interface diferencia o seu produto no mercado e a equipe está pronta para operá-la: autenticação, lançamentos, incidentes, suporte ao cliente. Se as diferenças de interface não geram valor perceptível para os clientes, o white label continua sendo a escolha rápida e econômica — equivalente, não um plano B.

      • A sua equipe projeta a interação e responde pela acessibilidade, pela segurança do frontend, pelos lançamentos e pelo suporte ao cliente.
      • Os donos do backend e da aplicação fixam autenticação, autorização, limites de consulta, versionamento e a ordem de escalonamento antes do lançamento.
      • Um cenário de usuário é percorrido por inteiro — acesso negado, dados desatualizados, falha parcial, mudança de API do lado do fornecedor: é assim que se verifica o limite de responsabilidade, e não uma única consulta bem-sucedida.
      • O white label continua sendo a escolha rápida e econômica quando uma interface própria não cria valor perceptível para o cliente. White-label
      Limites do backend
      A sua equipe responde por
      • Autenticação dos usuários do portal e sessões
      • Exibição dos dados, acessibilidade, tratamento de erros
      A plataforma fornece
      • API documentada do backend de telemática
      • Credenciais de conexão por instância
      Verificação em um cenário

      Percorra um cenário — da conexão ao suporte

      É assim que o limite de responsabilidade fica visível na prática, antes mesmo da primeira linha da interface.

      1. 01Identificação do usuário
      2. 02Conexão pela documentação
      3. 03Consulta à tabela de dados
      4. 04Exibição e suporte
      5. 05Monitoramento e mudanças
      Ver a documentação
      Perguntas sobre arquitetura

      Perguntas sobre Headless Telematics

      O que é Headless Telematics?
      É uma abordagem de arquitetura em que o backend fica exposto por APIs documentadas e a interface do fornecedor é opcional. As funções do backend de telemática ficam acessíveis por APIs documentadas, e a equipe constrói a própria interface sobre um núcleo pronto. Rastreador, câmera, TCU ou veículo sem tela são um tema à parte, de hardware; não têm relação com este termo.
      Então toda função do backend fica disponível via API?
      Não automaticamente. O conjunto de operações e permissões disponíveis varia por superfície de produto — verifique-o na documentação atual de cada cenário antes de projetar a interface.
      Quem responde pela segurança no modelo Headless Telematics?
      A responsabilidade é dividida no limite do backend. A Navixy responde pela proteção do backend de telemática dentro dos limites acordados; a sua equipe, pela própria interface, pelas sessões, pelas integrações e pelos processos operacionais em torno dela.
      Quando é melhor escolher white label em vez de Headless?
      Quando a interface própria não cria valor perceptível para os clientes. Uma interface pronta com a sua marca entra em operação sem desenvolvimento de frontend. White label e Headless são degraus equivalentes: escolha pelo ponto em que a diferença de interface realmente importa para o mercado. White-label
      O navegador deve acessar a API de telemática diretamente?
      Em geral é mais robusto acessar por uma camada de aplicação gerenciada pela sua equipe. A camada de aplicação centraliza autorização, contexto de tenant, segredos, limites de consulta e o tratamento de mudanças do lado do fornecedor — uma vez, e não em cada aplicação cliente separadamente.
      Como verificar a arquitetura headless antes do lançamento?
      Percorra por inteiro um cenário real de usuário. Para o cenário de leitura das últimas coordenadas, verifique não só a consulta bem-sucedida, mas também acesso negado, dados desatualizados ou ausentes, tempos limite, falha parcial, mudança de esquema e o caminho de escalonamento ao suporte. Configuração da conexãoEsquema de dados
      Dá para manter a interface pronta como alternativa ao lado da solução headless?
      Sim, se o produto e as condições comerciais permitirem. Headless Telematics torna a interface do fornecedor uma opção, não uma exigência — confirme com a Navixy à parte a compatibilidade entre os cenários prontos e os próprios específicos da sua forma de implantação. White-label
      Quando Headless Telematics começa a compensar?
      Quando um processo de negócio importante para o cliente justifica o desenvolvimento de uma interface própria. O prazo depende do preparo das interfaces, do projeto de identidade e tenants, do desenvolvimento da aplicação, dos testes de integração, da análise de segurança, da observabilidade e do volume de migração — não há um prazo único para todos os cenários.
      Um agente de IA ou uma ferramenta de desenvolvedor pode trabalhar com o backend headless?
      Sim, pelo mesmo acesso documentado de uma integração comum. A Navixy publica MCP para contas de usuário e do Admin Panel, além de um MCP público sobre a documentação. O agente passa pela mesma autenticação e trabalha nos mesmos limites de acesso que qualquer aplicação. Navixy MCP

      Construa a sua interface sobre o backend documentado da Navixy

      Comece por um cenário de usuário: defina as operações de backend necessárias, as zonas de responsabilidade e o ciclo de vida — antes de a equipe escrever a primeira linha da interface.

      Ver a documentação Ir para Composable Telematics

      Headless Telematics expõe o backend por APIs — verifique na documentação quais operações compõem o seu cenário.