03 — Atores

← Índice · Prefixo de citação: UFE-03#A-nn (humanos) e UFE-03#AS-nn (sistêmicos)

✅ Consolidado. Atores do ciclo completo — da elaboração da escala à liberação do policial. Cada caso de uso em UFE-06 referencia um ator principal desta lista.

Atores humanos

ID	Ator	Responsabilidade
A-01	Policial	Apresenta-se, assume recursos, executa atividades, atende ocorrências e encerra a jornada
A-02	Escalante	Planeja e publica as escalas
A-03	Comandante da unidade	Aprova escalas, alterações e exceções
A-04	Supervisor operacional	Coordena as equipes durante o turno
A-05	Despachante	Designa ocorrências para equipes ou recursos
A-06	Operador de rádio	Mantém a comunicação operacional
A-07	Responsável pela reserva de armamento	Entrega, registra e recebe armas e munições
A-08	Responsável pela frota	Entrega, vistoria e recebe viaturas
A-09	Responsável pelo almoxarifado	Controla rádios, coletes e outros equipamentos
A-10	Substituto	Assume posto, equipe ou recurso em substituição a outro policial
A-11	Auditor	Consulta eventos, divergências e responsabilidades
A-12	Administrador do sistema	Mantém cadastros, perfis e parâmetros

Papéis vs. pessoas

A-01…A-12 são papéis, não pessoas nem cargos. A mesma pessoa pode ser A-01 numa jornada e A-04 na seguinte; um comandante de guarnição é A-01 com atribuição adicional. A modelagem que trata "escalante" como um tipo de usuário — em vez de uma permissão sobre um contexto — não sobrevive à primeira substituição.

🏛️ Geohub. A infraestrutura de papéis já existe: IPapel no domínio, roles do Directus na persistência. A task-053 estabeleceu que conceitos policiais são dados/config do deployment, não tipos — o que se aplica diretamente aqui: A-07 "responsável pela reserva de armamento" é uma permissão configurada, não um enum no código do núcleo. Ver UFE-10.

Atores ausentes na conversa de origem

Vazios reconhecidos, não cobertos pela fonte — registrados para não passarem por "decisão tomada":

• Cidadão / solicitante (T-011) não aparece como ator do ciclo, porque a conversa tratou do lado interno. Num sistema com app do cidadão ou canal de denúncia, ele é ator de primeira classe.
• Encarregado da manutenção (destino de UC-13 e UC-36 quando há avaria) é mencionado como destino, mas não modelado como ator.
• Agências externas (T-050) aparecem em UC-22 (solicitar apoio) sem ator correspondente do lado de lá.

Atores sistêmicos

ID	Sistema	Participação
AS-01	Sistema de escalas	Fornece escalas planejadas
AS-02	Sistema CAD	Gerencia ocorrências e despachos
AS-03	Sistema de recursos humanos	Fornece vínculos, lotações e afastamentos
AS-04	Sistema de armamento	Controla cautela de armas e munições
AS-05	Sistema de frota	Controla viaturas, disponibilidade e manutenção
AS-06	Sistema de rastreamento	Informa a posição de recursos autorizados
AS-07	Sistema de identidade	Autentica policiais e operadores
AS-08	Sistema de comunicação	Integra rádio, telefonia e mensagens
AS-09	Sistema de auditoria	Preserva eventos e alterações relevantes

Onde o Geohub já é cada um deles

🏛️ Geohub. Mapeamento do que existe hoje no monorepo, para deixar claro o que seria integração e o que seria construção:

Ator sistêmico	Situação no monorepo
AS-01 Sistema de escalas	Parcial — IItemAgenda (task-053) cobre a agenda abstrata; não há elaboração nem publicação de escala
AS-02 Sistema CAD	Em modelagem — task-077 (OcorrenciaHub) e task-179; o ECOPS é CAD externo hoje
AS-03 RH	Ausente — integração externa
AS-04 Armamento	Ausente
AS-05 Frota	Ausente como cautela; há telemetria de veículo
AS-06 Rastreamento	Existe — @geocontrol/avl-mensageria + @geocontrol/azimutehub
AS-07 Identidade	Existe — autoriza / Directus, com os quatro modos de login da task-053
AS-08 Comunicação	Parcial — packages/notifica, app do smartphone
AS-09 Auditoria	Existe — directus-extension-access-report, RDT-006

A leitura útil dessa tabela: o Geohub já é AS-06 e AS-07 com solidez, está construindo AS-02, e a oportunidade da espinha dorsal (UFE-02) exige tocar em AS-01, AS-04 e AS-05 — que hoje são zero.

Iniciador vs. ator principal

Vários casos de uso têm ator principal diferente do iniciador. UC-17 (receber despacho) tem a equipe como ator principal e o despachante ou o CAD como iniciador. A distinção importa para permissão e para auditoria: quem foi afetado e quem causou.

🏛️ Isso é o mesmo origem que a task-077 já exige em cada evento de webhook (ecops, smartphone-app, geohub-despacho, …) — e pelo mesmo motivo: reconstituir quem causou a mudança.

---

← 02 — Distinções · Índice · Próximo: 04 — Ciclo de vida da jornada →