Geohub

Appearance

06 — Casos de uso ​

← Índice · Prefixo de citação: UFE-06#UC-nn

✅ Consolidado. 41 casos de uso cobrindo o ciclo completo, da elaboração da escala à liberação do policial. A numeração UC-01…UC-41 é a da conversa de origem, preservada para conferência linha a linha com o export.

Atores referenciados por ID de UFE-03.

Mapa rápido ​

FaseUCsAtor predominante
1 — Planejamento da escalaUC-01–UC-05Escalante (A-02)
2 — Apresentação ao serviçoUC-06–UC-09Supervisor (A-04)
3 — Assunção de recursosUC-10–UC-13Policial (A-01)
4 — Início da operaçãoUC-14–UC-16Policial / guarnição
5 — Atendimento de ocorrênciaUC-17–UC-25Equipe operacional
6 — PausasUC-26–UC-31Policial / despachante
7 — Encerramento do turnoUC-32–UC-41Guarnição / supervisor

Fase 1 — Planejamento da escala ​

UC-01 — Elaborar escala ​

Ator principal: Escalante (A-02) Objetivo: Planejar o emprego do efetivo.

Fluxo principal:

  1. O escalante seleciona a unidade e o período.
  2. O sistema apresenta o efetivo disponível.
  3. O escalante cria os turnos.
  4. O escalante define postos, equipes e áreas.
  5. O escalante vincula os policiais.
  6. O sistema identifica conflitos.
  7. O escalante conclui a elaboração.

UC-02 — Validar disponibilidade do policial ​

Ator principal: Sistema de escalas (AS-01) Objetivo: Impedir designações incompatíveis.

O sistema verifica:

  • vínculo ativo;
  • lotação;
  • afastamento;
  • férias;
  • licença;
  • restrição operacional;
  • habilitação exigida;
  • descanso mínimo;
  • sobreposição de horários;
  • convocação anterior.

Metade dessa lista mora no RH (AS-03), não no sistema de escala. UC-02 é, na prática, o principal ponto de integração da fase 1.

UC-03 — Publicar escala ​

Ator principal: Comandante da unidade (A-03) Objetivo: Tornar a escala oficialmente válida.

A publicação registra:

  • autor;
  • data e hora;
  • versão;
  • vigência;
  • policiais alcançados;
  • alterações posteriores.

Publicação é ato versionado. É ela que dispara a reserva de recursos (UFE-05) e que torna a escala oponível ao policial. Antes dela, a escala é rascunho.

UC-04 — Consultar escala individual ​

Ator principal: Policial (A-01) Objetivo: Conhecer seus próximos serviços.

O policial consulta:

  • data;
  • turno;
  • unidade;
  • posto;
  • equipe prevista;
  • horário de apresentação;
  • orientações;
  • situação da escala.

É aqui que os três níveis de recurso ("a definir" / "prevista" / "confirmada") aparecem para o policial — ver UFE-05.

UC-05 — Alterar escala ​

Ator principal: Escalante (A-02) Objetivo: Modificar uma designação publicada.

Toda alteração deve preservar:

  • valor anterior;
  • valor novo;
  • justificativa;
  • responsável;
  • data e hora;
  • ciência do policial, quando exigida.

Fase 2 — Apresentação ao serviço ​

UC-06 — Registrar apresentação ​

Ator principal: Policial (A-01) Objetivo: Informar que compareceu à unidade.

O registro pode ocorrer por:

  • terminal da unidade;
  • aplicativo institucional;
  • identificação funcional;
  • biometria;
  • registro por supervisor.

🏛️ Geohub. Biometria e identificação funcional já têm superfície: packages/geobox-biometria, packages/fingerprint-converter, e os modos de login da task-053 — inclusive o login agendado, que é literalmente "apresentação validada contra a agenda".

UC-07 — Tratar divergência de apresentação ​

Ator principal: Supervisor operacional (A-04) Objetivo: Resolver ausência, atraso ou apresentação indevida.

Possíveis situações:

  • apresentação pontual;
  • atraso;
  • ausência;
  • apresentação antecipada;
  • unidade incorreta;
  • policial não escalado;
  • substituição;
  • convocação emergencial.

UC-08 — Confirmar composição da equipe ​

Ator principal: Supervisor operacional (A-04) Objetivo: Definir quem efetivamente trabalhará em conjunto.

A equipe real pode ser diferente da equipe prevista. O sistema deve preservar as duas composições. É D-12 na sua forma mais concreta — e a razão pela qual T-106 (equipe prevista) e T-121 (equipe operacional) são termos distintos.

UC-09 — Registrar instrução inicial ​

Ator principal: Supervisor operacional (A-04) Objetivo: Comunicar orientações do turno.

Pode incluir:

  • área de atuação;
  • operações em andamento;
  • riscos conhecidos;
  • pessoas ou veículos procurados;
  • ordens específicas;
  • condições dos recursos;
  • mudanças de procedimento.

🏛️ "Pessoas ou veículos procurados" conecta com packages/pessoa-interesse, packages/furto-roubo-veiculo e o ecossistema LPR — a instrução inicial é um ponto natural de entrega de listas de interesse para a guarnição.

Fase 3 — Assunção de recursos ​

UC-10 — Receber arma e munição ​

Atores: Policial (A-01) e responsável pelo armamento (A-07) Objetivo: Formalizar a cautela individual.

O sistema registra:

  • identificação da arma;
  • tipo;
  • número de série;
  • quantidade de carregadores;
  • quantidade e tipo de munição;
  • estado aparente;
  • entregador;
  • recebedor;
  • data e hora.

UC-11 — Receber equipamentos individuais ​

Ator principal: Policial (A-01) Objetivo: Assumir equipamentos necessários.

Exemplos: rádio, câmera corporal, colete, algemas, dispositivo elétrico, chaves, telefone institucional.

UC-12 — Receber e vistoriar viatura ​

Atores: Motorista (T-125) e responsável pela frota (A-08) Objetivo: Formalizar o recebimento da viatura.

A vistoria pode registrar:

  • quilometragem;
  • combustível ou carga;
  • avarias existentes;
  • pneus;
  • iluminação;
  • sinalização;
  • documentação;
  • equipamentos embarcados;
  • limpeza;
  • imagens da vistoria.

🏛️ "Imagens da vistoria" é interface multifotos — há tasks recentes exatamente sobre isso no repositório, e packages/missao-fotografica-hub já resolve captura estruturada de fotos com metadados.

UC-13 — Registrar divergência inicial ​

Ator principal: Policial (A-01) Objetivo: Evitar que o novo responsável assuma uma divergência preexistente.

A divergência pode resultar em:

  • aceite com ressalva;
  • substituição do recurso;
  • bloqueio do recurso;
  • encaminhamento para manutenção;
  • avaliação pelo supervisor.

Sem UC-13, o dano acumulado do turno anterior recai sobre quem pegou a viatura depois. É o caso de uso que torna a cadeia de responsabilidade defensável.

Fase 4 — Início da operação ​

UC-14 — Iniciar jornada ​

Ator principal: Policial (A-01) Objetivo: Abrir formalmente o período trabalhado.

Pré-condições recomendadas:

  • apresentação confirmada;
  • equipe constituída;
  • recursos essenciais recebidos;
  • instrução inicial concluída, quando aplicável.

UC-15 — Declarar equipe em prontidão ​

Ator principal: Comandante da guarnição (T-124) Objetivo: Informar ao CAD que a equipe pode receber ocorrências.

Esse evento é diferente do início da jornada. Um policial pode estar trabalhando sem que sua equipe esteja disponível para despacho — RS-03.

UC-16 — Iniciar patrulhamento ou atividade programada ​

Ator principal: Equipe operacional (T-121) Objetivo: Registrar a atividade corrente.

Exemplos: patrulhamento, ponto-base, policiamento a pé, fiscalização, escolta, apoio, operação planejada, deslocamento administrativo.

É UC-16 que impede a jornada de virar uma lista de ocorrências com buracos. A atividade corrente é sempre alguma coisa.

Fase 5 — Atendimento de ocorrência ​

UC-17 — Receber despacho ​

Ator principal: Equipe operacional (T-121) Ator iniciador: Despachante (A-05) ou CAD (AS-02)

O despacho deve informar:

  • ocorrência;
  • natureza;
  • prioridade;
  • endereço;
  • referência;
  • riscos conhecidos;
  • pessoas envolvidas;
  • instruções;
  • recursos já designados.

🏛️ Geohub. Este é exatamente o payload que a task-179 ("API externa para envio de ocorrência para o smartphone app") precisa entregar, e a lista de campos que a task-077 marca como a maior lacuna ("definir o que é uma ocorrência"). Ver UFE-10.

UC-18 — Aceitar despacho ​

Ator principal: Comandante da guarnição (T-124) Objetivo: Confirmar que a missão foi recebida.

O sistema registra o momento do aceite e altera a situação da equipe para designada.

🏛️ É o passo 4 do cenário canônico da task-077 — a mudança que nasce fora do originador e precisa chegar nele. O caso de uso que prova o modelo de integração.

UC-19 — Iniciar deslocamento ​

Ator principal: Equipe operacional (T-121) Objetivo: Informar que o recurso segue para o local.

UC-20 — Registrar chegada ​

Ator principal: Equipe operacional (T-121) Objetivo: Marcar a presença no local da ocorrência.

UC-19 e UC-20 são os marcos que definem T-097 (tempo de deslocamento). Se forem derivados de telemetria AVL em vez de ação humana, a semântica muda — ver Q-05 em UFE-11.

UC-21 — Atualizar situação da ocorrência ​

Ator principal: Equipe operacional (T-121) Objetivo: Informar o que foi encontrado.

Exemplos:

  • fato confirmado;
  • fato não localizado;
  • endereço incorreto;
  • vítima localizada;
  • risco em andamento;
  • necessidade de reforço;
  • necessidade de atendimento médico.

UC-22 — Solicitar apoio ​

Ator principal: Equipe operacional (T-121) Objetivo: Mobilizar recursos adicionais.

O apoio pode ser: policial, médico, bombeiro, especializado, trânsito, perícia, assistência social, concessionária, defesa civil.

UC-23 — Registrar ações realizadas ​

Ator principal: Equipe operacional (T-121) Objetivo: Construir a narrativa operacional estruturada.

UC-24 — Encerrar participação da equipe ​

Ator principal: Comandante da guarnição (T-124) Objetivo: Finalizar a atuação daquela equipe na ocorrência.

Uma ocorrência pode continuar aberta mesmo depois da liberação de uma equipe — RS-08.

UC-25 — Retornar à prontidão ​

Ator principal: Equipe operacional (T-121) Objetivo: Informar que está novamente disponível para despacho.

Fase 6 — Pausas, refeições e necessidades pessoais ​

✅ Decisão semântica e de privacidade, tomada explicitamente na conversa de origem:

O sistema não deve registrar "foi ao banheiro" como atividade nominal. O conceito adequado é pausa pessoal. O sistema precisa conhecer a indisponibilidade temporária; não precisa registrar detalhes íntimos.

É RS-11, e vale como princípio geral: registrar o efeito operacional, não a causa privada.

Tipos recomendados de pausa ​

TipoUso
Refeição principalAlmoço ou jantar
LancheIntervalo curto para alimentação
Descanso regulamentarRepouso previsto pela organização
Pausa pessoalNecessidade pessoal sem detalhamento
Pausa médicaAtendimento ou indisposição de saúde
Pausa técnicaAjuste de equipamento ou sistema
Pausa administrativaAtividade interna temporária
AbastecimentoReposição de combustível ou carga
Manutenção emergencialCorreção de problema no recurso

Note que as três últimas são pausas do recurso, não da pessoa — e por isso o escopo da pausa (UC-28) é um campo, não uma constante.

UC-26 — Solicitar pausa ​

Ator principal: Policial (A-01) ou comandante da guarnição (T-124) Objetivo: Interromper temporariamente a disponibilidade.

UC-27 — Autorizar pausa ​

Ator principal: Supervisor (A-04) ou despachante (A-05) Objetivo: Preservar a cobertura operacional.

A autorização pode ser automática ou manual conforme:

  • prioridade;
  • quantidade de equipes disponíveis;
  • área descoberta;
  • ocorrência em andamento;
  • duração prevista;
  • regras da instituição.

🔶 Uma pausa médica ou pessoal que dependa de autorização discricionária é um problema trabalhista e humano, não apenas de cobertura. A política de quais tipos exigem autorização é decisão institucional — ver Q-07.

UC-28 — Iniciar pausa ​

Ator principal: Equipe (T-121) ou policial (A-01) Objetivo: Registrar o início da indisponibilidade.

A pausa pode afetar:

  • apenas um policial;
  • toda a guarnição;
  • somente um recurso;
  • parte da capacidade da equipe.

Os quatro escopos são a razão de RS-05: pausa do policial não é pausa da equipe. Uma guarnição de três com um em pausa pessoal continua despachável para parte das naturezas.

UC-29 — Interromper pausa para atendimento ​

Ator principal: Despachante (A-05) ou equipe (T-121) Objetivo: Restabelecer a prontidão diante de necessidade operacional.

A pausa fica registrada como interrompida, e não como concluída normalmente. É a diferença entre "almoçou" e "não almoçou" — dado de gestão de pessoal, não detalhe de log.

UC-30 — Encerrar pausa ​

Ator principal: Policial (A-01) ou equipe (T-121) Objetivo: Retornar à atividade.

UC-31 — Retornar à prontidão ​

Ator principal: Comandante da guarnição (T-124) Objetivo: Confirmar disponibilidade para novo despacho.

UC-30 e UC-31 são separados de propósito: encerrar a pausa devolve o policial à atividade; declarar prontidão devolve a equipe ao pool de despacho. Mesmo par de UC-14/UC-15.

Fase 7 — Encerramento do turno ​

UC-32 — Solicitar desmobilização ​

Ator principal: Comandante da guarnição (T-124) Objetivo: Iniciar o encerramento operacional.

O sistema verifica:

  • ocorrências abertas;
  • despachos ativos;
  • pessoas sob responsabilidade;
  • recursos pendentes;
  • registros obrigatórios;
  • transferência de serviço.

"Pessoas sob responsabilidade" é o item mais sério da lista e o mais fácil de omitir num schema: uma guarnição não encerra o turno com um custodiado no banco de trás.

UC-33 — Transferir ocorrência em andamento ​

Ator principal: Supervisor operacional (A-04) Objetivo: Permitir troca de turno sem perder continuidade.

A transferência registra:

  • equipe anterior;
  • equipe sucessora;
  • situação atual;
  • pendências;
  • recursos envolvidos;
  • momento da passagem;
  • aceite da nova equipe.

O aceite da nova equipe é o que fecha a transferência. Sem ele, existe um intervalo em que a ocorrência não tem dono — e é justamente aí que ela se perde. É a materialização de RS-07.

UC-34 — Retornar à unidade ​

Ator principal: Equipe operacional (T-121) Objetivo: Registrar o deslocamento para desmobilização.

UC-35 — Realizar vistoria final da viatura ​

Atores: Motorista (T-125) e responsável pela frota (A-08) Objetivo: Comparar as condições inicial e final.

O sistema registra:

  • quilometragem final;
  • combustível ou carga;
  • avarias;
  • limpeza;
  • carga embarcada;
  • multas ou intercorrências;
  • imagens;
  • necessidade de manutenção.

Comparar com UC-12: os campos são deliberadamente os mesmos, porque a vistoria final só tem sentido como diferença contra a inicial.

UC-36 — Devolver viatura ​

Ator principal: Motorista (T-125) Objetivo: Encerrar a cautela do veículo.

A devolução pode resultar em:

  • devolução regular;
  • devolução com ressalva;
  • recurso indisponível;
  • encaminhamento para manutenção;
  • apuração de divergência.

UC-37 — Devolver arma e munição ​

Atores: Policial (A-01) e responsável pelo armamento (A-07) Objetivo: Encerrar a cautela do armamento.

Devem ser conferidos:

  • arma;
  • número de série;
  • carregadores;
  • munições entregues;
  • munições consumidas;
  • justificativa de consumo;
  • estado do armamento.

"Munições consumidas" com justificativa é o campo de maior consequência do book inteiro: ele é o gatilho administrativo de qualquer apuração de uso de arma de fogo. Tratar como conferência de estoque subestima o que ele é.

UC-38 — Devolver equipamentos ​

Ator principal: Policial (A-01) Objetivo: Encerrar as demais cautelas.

UC-39 — Registrar pendência de devolução ​

Ator principal: Responsável pelo recurso (A-07/A-08/A-09) Objetivo: Tratar recurso ausente, danificado ou não conferido.

UC-40 — Encerrar jornada ​

Ator principal: Policial (A-01) ou supervisor (A-04) Objetivo: Formalizar o término do trabalho.

Pós-condições recomendadas:

  • equipe fora de prontidão;
  • despachos encerrados ou transferidos;
  • recursos devolvidos ou com pendência formal;
  • cautelas baixadas;
  • registros obrigatórios concluídos.

Note "ou com pendência formal": a jornada pode terminar com pendência, desde que ela esteja formalizada (RS-10). Um sistema que bloqueia o encerramento até tudo estar regular obriga o policial a mentir ou o supervisor a burlar.

UC-41 — Liberar policial ​

Ator principal: Supervisor operacional (A-04) Objetivo: Declarar que o policial não possui mais obrigação operacional naquele turno.

A liberação encerra o escopo do sistema. O retorno para casa pertence à vida privada do policial, não ao ciclo operacional. Ver UFE-04 e RS-12.

← 05 — Necessidade, reserva e cautela · Índice · Próximo: 07 — Máquinas de estado →