Glossário da plataforma
Os nomes que são do Geohub: as peças, quem conversa com elas e os módulos. O vocabulário do ciclo operacional (chamado, ocorrência, despacho, guarnição, jornada) não está aqui: está no glossário nuclear do universo das forças emergenciais, e as páginas citam os dois com a definição na dica, como em
e .As peças
Geohub
O sistema. Existe como central, o servidor que o centro de operações, o app e os integradores acessam, e como local, no Geobox, que continua a operar sem conexão e sincroniza depois. Os dois servem o mesmo contrato, e o SDK fala com qualquer um deles. A central é a fonte da verdade do que acontece em campo e funciona sem nenhum integrador (como a integração funciona).
Geobox
O computador embarcado na viatura. Roda em borda a leitura de placas, as câmeras e a biometria, sem depender de conexão com a central.
Painel
A interface web do Geohub central, onde a central de operações registra, despacha e acompanha. A API de dados do painel não é porta de integração, porque escrita por ela não passa pelos hubs nem gera evento.
Hub
A interface de um módulo, com os verbos do domínio dele: IJornadaHub, IOcorrenciaHub, o hub de câmeras, o de LPR, o de biometria. O app, o painel e os integradores chamam os mesmos verbos (pelo SDK).
Plugin exposto
Um hub publicado por transportes gerados do próprio manifesto: a REST com a OpenAPI, o SDK TypeScript, o webhook e as coleções de comando do painel. Toda regra mora numa camada única de exposição: porteiro por verbo, autoria imposta pela sessão, idempotência, tradução de ids e outbox (referência).
Deployment
Uma instalação do Geohub para um cliente, com o catálogo dela: os papéis, as modalidades de serviço e as unidades que os verbos aceitam.
Quem conversa com a plataforma
App do policial
O aplicativo no smartphone do agente. Entra com matrícula e senha, pela sessão do próprio policial, e é por ele que a equipe aceita, desloca, chega, registra em campo e consulta placa.
CAD
Sistema de atendimento e despacho, o que a central de operações usa para registrar ocorrências e empenhar viaturas. Quando um CAD se liga ao Geohub, ele entra como integrador (guia do integrador).
Integrador
Um sistema externo cadastrado no Geohub, com usuário de serviço, papel próprio e token estático. Age em nome dele próprio pelos mesmos verbos do app, e recebe de volta o que aconteceu pelo webhook.
Webhook
O caminho de volta: cada mudança vira um envelope assinado, com sequência por agregado, entregue ao endereço de callback do integrador, com nova tentativa até dez vezes (o CAD recebe o que aconteceu).
Envelope
O formato único de todo evento: id, tipo, ocorridoEm, origem (plugin, versão, autoria e a solicitação que o causou) e payload. É o mesmo corpo no webhook, na fila por inscrição e nas coleções de comando.
AutorizaHub
O módulo de autenticação e autorização: o login online com matrícula e senha, a sessão renovada por refresh, e o alcance de cada papel sobre cada verbo.
Autoria
Quem causou cada comando, imposta pela sessão e gravada no evento: usuario, integrador, sistema. É pela autoria que o CAD reconhece o eco do que ele mesmo mandou.
Idempotência
Repetir o mesmo comando com a mesma chave (x-solicitacao-id, um UUID v7 cunhado antes da primeira tentativa) devolve o mesmo desfecho, marcado repetido, sem executar de novo. É o que torna o retry seguro.
Módulos
LPR
Leitura automática de placas na viatura, em borda. A leitura vira uma validação quando a equipe a confirma, e uma leitura validada de um veículo de interesse abre a ocorrência sozinha (caso 7).
Veículo de interesse
Uma placa com interesse ativo numa lista do deployment (furto e roubo, entre outras). É o que faz uma leitura de LPR virar alerta e, validada, ocorrência.
Consulta de placa
A consulta que o policial faz em campo às fontes externas do deployment, contabilizada por elas (caso 6).
Biometria
Identificação de pessoas pela impressão digital e pelo reconhecimento facial, em campo e no controle de acesso.
Azimute
A posição das viaturas e dos dispositivos: ingestão de telemetria AVL e rastreamento, adaptada ao domínio do Geohub.
Databerry
A sincronização e o armazenamento de dados entre o Geobox e a central, com ou sem conexão (módulo).
Como a documentação fala
RDT
Registro de Decisão Técnica: as decisões de arquitetura, numeradas (RDT-025, RDT-027), guardadas no repositório. As páginas as citam pelo número quando uma regra vem de uma decisão.
UC, RS, D e T
Os códigos do book do universo das forças emergenciais, que as páginas citam quando a regra vem de lá: UC-nn é um caso de uso, RS-nn uma regra semântica, D-nn uma distinção entre termos parecidos e T-nnn um termo do glossário nuclear. Cada código é uma âncora na página do capítulo.
Caso de uso
Nesta documentação, uma cena do ciclo operacional contada de ponta a ponta: o que acontece, quem chama o quê, e o mesmo contrato visto pelo SDK e pela REST (os sete casos).