02 — Distinções e modelo conceitual
← Índice · Prefixo de citação: UFE-02#D-nn
✅ Consolidado. Este é o capítulo mais denso em valor do book. Cada distinção abaixo corresponde a um erro de modelagem concreto que se paga caro depois: entidades colapsadas que precisam ser separadas com dados em produção.
As distinções
| ID | Não confundir | Porque são entidades diferentes |
|---|---|---|
D-01 | Chamado × Ocorrência | O chamado é a comunicação recebida; a ocorrência é o registro administrativo/operacional criado a partir dela |
D-02 | Ocorrência × Incidente | A ocorrência é a ficha; o incidente é o fato no mundo real. Vários chamados podem convergir para o mesmo incidente |
D-03 | Despacho × Atendimento | Despacho é a designação de um recurso; atendimento é o conjunto de ações executadas |
D-04 | Recurso × Viatura | Recurso é o gênero (algo mobilizável); viatura é uma espécie. Modelar viatura como raiz fecha a porta para aeronave, embarcação, cão, drone |
D-05 | Equipe × Guarnição | Guarnição é a equipe vinculada a uma viatura ou missão. Nem toda equipe é guarnição |
D-06 | Prioridade × urgência × gravidade × risco | Quatro dimensões independentes: ordem de fila, rapidez exigida, intensidade do dano observado, chance de agravamento |
D-07 | Estado da ocorrência × do despacho × do recurso | Três ciclos de vida separados, que avançam em ritmos diferentes |
D-08 | Protocolo (T-009) × protocolo operacional (T-030) | Um é o número dado ao cidadão; o outro é o procedimento a executar. Mesmo nome, entidades sem relação |
D-09 | Escala × turno × jornada | Planejamento × período previsto × período efetivamente trabalhado |
D-10 | Necessidade × reserva × designação × cautela | Quatro vínculos entre serviço e recurso, em quatro momentos. Ver UFE-05 |
D-11 | Apresentação × início da jornada × prontidão | Estar na unidade, estar trabalhando e poder receber despacho são três coisas |
D-12 | Previsto × realizado | Equipe prevista × equipe real, posto de serviço × posto ocupado, recurso reservado × recurso entregue. Ambos preservados, nunca sobrescritos |
D-01/D-02 em uma frase
É como separar a notícia do incêndio, o incêndio real, a ficha criada pela central e os bombeiros enviados.
E a cardinalidade que decorre disso:
- Um chamado pode gerar uma ocorrência (pode também não gerar — trote, engano).
- Diversos chamados podem convergir para o mesmo incidente.
- Uma ocorrência pode gerar vários despachos.
- Cada despacho pode mobilizar diferentes recursos.
Estrutura central recomendada
⚠️ Leia a seta
Ocorrência → Incidentecomo "refere-se a", não como "contém". Pela cardinalidade acima, o incidente é que agrega ocorrências — N ocorrências para 1 incidente. O diagrama da conversa de origem é um fluxo de descoberta, não um diagrama de composição. Se ele virar schema literalmente,D-02se perde. VerQ-03em UFE-11.
Modelo conceitual completo — ocorrência + jornada
Junta o fluxo de atendimento com o ciclo do policial. É o mapa mental do book inteiro em um diagrama:
Três braços saem da jornada, e é isso que o modelo precisa suportar simultaneamente:
- Braço operacional — jornada → equipe → despacho → ocorrência.
- Braço patrimonial — jornada → cautela → recurso.
- Braço de tempo — jornada → atividade/pausa (o que ocupou cada minuto).
Os três correm em paralelo e não se sincronizam: a pausa de um policial (braço 3) não encerra a cautela da viatura (braço 2) nem tira a guarnição de prontidão (braço 1), a menos que uma regra explícita diga o contrário. Ver RS-05.
A espinha dorsal que ninguém conecta
O valor identificado não é "mais um sistema de escala". É a continuidade de ponta a ponta, hoje quebrada entre sistemas diferentes:
policial escalado → equipe formada → recurso reservado → jornada iniciada
→ equipe disponível → ocorrência atendida → recurso devolvidoCada seta dessa cadeia costuma ser uma fronteira entre sistemas distintos, e a informação se perde em cada travessia. Ver UFE-09 para o porquê dessa fragmentação, e UFE-10 para o que isso significa aqui.
Próximo passo natural da modelagem
A conversa de origem termina apontando o passo seguinte: transformar esta especificação em um dicionário ontológico formal, definindo para cada conceito:
- nome canônico;
- definição;
- sinônimos;
- relações;
- atributos;
- cardinalidades;
- estados;
- eventos;
- regras de negócio;
- campos que devem ou não ser auditados.
Este book cobre os cinco primeiros itens de forma parcial e os três seguintes (estados, eventos) nos capítulos 07 e 06. Atributos, cardinalidades formais e política de auditoria por campo continuam em aberto — são entregável de task, não de book.