/oficios/recipients · "Destinatários"destinatarios.visualizar. "Novo Destinatário" exige destinatarios.criar; editar e a estrela de favorito exigem destinatarios.editar; excluir exige destinatarios.excluir (o banco confere as três).Para que serve
Cadastro de para quem os ofícios são endereçados (departamento, secretaria, município, endereço, e-mail e telefone). O e-mail cadastrado já vem preenchido no envio do ofício, e o município é usado para ligar ofícios recebidos aos enviados. Destinatário digitado à mão em "Novo Ofício" entra aqui sozinho.
A tela, marcação por marcação
As figuras abaixo mostram a tela como ela aparece para quem usa. Os números em vermelho marcam os botões e campos; logo abaixo de cada figura, cada número é explicado: onde fica, o que faz e o que acontece depois.
Visão geral da tela

- Aparece quando: "Novo Destinatário" só com
destinatarios.criar; "Cadastrar primeiro destinatário" aparece sempre (sem a chave, o banco recusa ao salvar). - O que faz: abre a janela "Novo Destinatário".
Como a tela está organizada (de cima para baixo)
- Cabeçalho — "Destinatários" e "Gerencie os destinatários dos ofícios"; à direita, "Novo Destinatário".
- Cartão "Lista de Destinatários" com o campo "Buscar..." (departamento, município ou e-mail).
- Tabela — estrela (favorito) · "Departamento" · "Secretaria" (tela média) · "Município" (tela grande) · "Email" e "Telefone" (tela bem larga) · "Ações" (lápis e lixeira). Os favoritos vêm primeiro.
Situações
| Situação | Como aparece | O que se pode fazer |
|---|---|---|
| Carregando | Círculo girando | Esperar |
| Lista vazia ou busca sem resultado | "Nenhum destinatário encontrado" e "Cadastrar primeiro destinatário" | Cadastrar |
Botões
Os botões marcados nas figuras estão explicados junto de cada figura (seção “A tela, marcação por marcação”). A seguir, os demais botões desta tela — os que só aparecem em outras situações —, com o que fazem e onde ficam.
Estrela (favorito)
- Onde fica: primeira coluna.
- O que faz: marca/desmarca como favorito (estrela amarela). Favoritos sobem para o topo da lista.
- Se der errado: "Erro — <motivo>" (sem
destinatarios.editar).
Lápis (editar)
- Aparece quando:
destinatarios.editar. - O que faz: abre "Editar Destinatário".
Lixeira (excluir)
- Aparece quando:
destinatarios.excluir. - O que faz: abre "Excluir Destinatário".
Janelas
"Novo Destinatário" / "Editar Destinatário"

Fecha a janela sem gravar nada; a tela de trás continua como estava.
Grava o que foi preenchido na janela e a fecha; o sistema mostra a mensagem de sucesso ou, se faltar algo, o aviso no campo.
- Texto: "Preencha os dados do destinatário".
- Campos: "Departamento *" ("Ex: Departamento de Vigilância Epidemiológica") · "Secretaria" ("Ex: Secretaria Municipal de Saúde") · "Município" ("Nome do município") · "Endereço" · "Email" · "Telefone" (com máscara).
- Botões: "Cancelar" · "Salvar".
- Mensagens: "Departamento é obrigatório." · "Sucesso! — Destinatário cadastrado." / "Destinatário atualizado." · "Erro — <motivo>".
- Regra: o lápis e a estrela de favorito aparecem só com
destinatarios.editar; se o banco não gravar, a mensagem é "O destinatário não foi alterado: falta a permissão "Editar Destinatário"." (ou "O favorito não mudou: …"). "Cadastrar primeiro destinatário" aparece só comdestinatarios.criar.
"Excluir Destinatário"
- Texto: "Deseja realmente excluir o destinatário <departamento>? Esta ação não pode ser desfeita."
- Botões: "Cancelar" · "Excluir".
- Mensagens: "Este destinatário já foi usado em N ofício(s) e não pode ser excluído." · "O destinatário não foi excluído (sem permissão ou já removido)." · "Sucesso! — Destinatário excluído."
Perguntas que as pessoas fazem
- Por que "Departamento" é o nome principal? → o ofício é endereçado ao departamento; é o que aparece em "Para:".
- Para que serve o "Município"? → aparece no endereçamento e é usado para achar os ofícios enviados a um município quando chega a resposta dele.
- Não consigo excluir. → destinatário já usado em ofício não sai: o ofício perderia a quem foi endereçado.
Ligações com outros módulos e telas
- Novo Ofício / Editar ofício — lista "Para (Destinatário)".
- Enviar Ofício por E-mail — o e-mail do destinatário vem preenchido.
- Ofícios Recebidos — vínculo de resposta pelo município do destinatário.