Editar Instalação

Este guia explica como modificar os dados de uma instalação existente no sistema Trevo.

Permissões Necessárias

Para editar instalações, você deve ser:

• RAD Laudos
• RAD Físico
• RAD Admin
• Administrador

Acessando a Edição

A partir do detalhe da instalação

1. Acesse a instalação que deseja editar
2. Clique no botão "Editar"
3. Você será redirecionado para /facility/:id/edit

Acesso direto via URL

/facility/:id/edit

Arquivo de Código

pages/facility/[id]/edit.vue

Seções do Formulário

Seção 1: Informações Básicas

Todos os campos desta seção podem ser modificados:

Departamento

• Medicina Nuclear
• Radiodiagnóstico

Grupo

• Seleção do grupo de instalações

Nome

• Nome da instalação
• Campo obrigatório

Razão Social (Company Name)

• Nome empresarial legal
• Campo obrigatório

CNPJ

• Apenas números, sem formatação
• Campo obrigatório
• Não pode ser alterado se já vinculado a registros

Telefone

• Com DDD
• Campo obrigatório

Endereço

• Rua: Logradouro completo (obrigatório)
• Cidade: Nome da cidade (obrigatório)
• Estado: UF ou nome completo (obrigatório)

Seção 2: Gerenciamento de Usuários

Esta seção permite gerenciar os usuários associados à instalação e suas responsabilidades.

Papéis Principais

Defina os usuários responsáveis por funções-chave:

Titular

• Responsável legal pela instalação
• Busca e seleção de usuário
• Exibe licenças AN e FM se disponíveis

Responsável Técnico (RT)

• Profissional responsável tecnicamente
• Busca e seleção de usuário
• Exibe licenças AN e FM

Substituto

• Substituto do Responsável Técnico
• Busca e seleção de usuário
• Exibe licenças AN e FM

Supervisor

• Supervisor de radioproteção
• Busca e seleção de usuário
• Exibe licenças AN e FM

Outros Usuários

Além dos papéis principais, você pode associar outros usuários:

1. Use o campo de busca para encontrar usuários
2. Selecione o usuário desejado
3. Defina as responsabilidades
4. Clique em "Adicionar"

Os usuários adicionados aparecem em uma tabela com:

• Nome
• Responsabilidades
• Opção de remover

Gerenciamento de Responsabilidades

Para cada usuário, você pode atribuir múltiplas responsabilidades:

• Titular
• Responsável Técnico
• Substituto
• Supervisor
• Outras responsabilidades customizadas (se configurado)

Seção 3: Configurações CNEN

Matrícula CNEN

• Número de registro na CNEN
• Campo de texto livre
• Opcional

Práticas Autorizadas

Marque as práticas que a instalação está autorizada a realizar:

• ☐ Terapia com Internação: Tratamento com internação do paciente
• ☐ Terapia Ambulatorial: Tratamento ambulatorial
• ☐ Diagnóstico: Procedimentos diagnósticos

Radioisótopos Autorizados

Para cada radioisótopo, você pode:

1. Marcar o checkbox para autorizar
2. Informar a quantidade semanal autorizada em mCi (millicuries)

Lista completa de radioisótopos:

Radioisótopo	Nome	Usos Comuns
C(11)	Carbono-11	PET scan
Cr(51)	Cromo-51	Testes hematológicos
F(18)	Flúor-18	PET scan oncológico
Ga(67)	Gálio-67	Detecção de infecções
Ga(68)	Gálio-68	PET scan
I(123)	Iodo-123	Tireoide
I(125)	Iodo-125	Braquiterapia
I(131)	Iodo-131	Terapia de tireoide
In(111)	Índio-111	Imagem de infecções
Lu(177)	Lutécio-177	Terapia tumoral
Ra(233)	Rádio-233	Terapia
Sm(153)	Samário-153	Paliação óssea
Tc(99m)	Tecnécio-99m	Diagnóstico geral
Tl(201)	Tálio-201	Cardiologia
Y(90)	Ítrio-90	Terapia tumoral

Validações

O formulário valida:

• ✓ Nome não pode estar vazio
• ✓ Razão social obrigatória
• ✓ CNPJ obrigatório e formato válido
• ✓ Telefone obrigatório
• ✓ Endereço completo (rua, cidade, estado)
• ✓ Quantidades de radioisótopos devem ser números positivos
• ✓ Usuários selecionados devem estar ativos no sistema

Passo a Passo

1. Acessar o Formulário

1. Navegue até a instalação que deseja editar
2. Clique no botão "Editar"
3. O formulário será carregado com os dados atuais

2. Modificar Informações Básicas

1. Altere os campos desejados na Seção 1
2. Todos os campos são editáveis
3. Mantenha os campos obrigatórios preenchidos

3. Atualizar Usuários e Responsabilidades

1. Para alterar um papel principal (Titular, RT, etc):

   • Busque o novo usuário
   • Selecione-o
   • Ele substituirá o usuário anterior naquele papel

2. Para adicionar novos usuários:

   • Use a busca de usuários
   • Selecione o usuário
   • Defina suas responsabilidades
   • Clique em "Adicionar"

3. Para remover usuários:

   • Clique no botão de remover na tabela de usuários
   • Confirme a remoção

4. Atualizar Configurações CNEN

1. Modifique a Matrícula CNEN se necessário
2. Marque/desmarque as Práticas Autorizadas
3. Para radioisótopos:
   • Marque os autorizados
   • Informe as quantidades semanais
   • Desmarque os não autorizados

5. Salvar Alterações

1. Revise todas as modificações
2. Certifique-se de que não há erros de validação
3. Clique em "Salvar" ou "Atualizar"
4. Aguarde a confirmação

6. Confirmação

• Após salvar com sucesso, você será redirecionado
• As alterações serão imediatamente refletidas no sistema
• Uma mensagem de confirmação será exibida

Dados Técnicos

Endpoint da API

PUT /facility/:id/edit

Endpoint Adicional (Usuários)

POST /facility/users/edit

Utilizado para gerenciar associações de usuários.

Serviços

services/auth/facilities.js
- editFacility(facility)
- editFacilityUsers(facilityId, users)
- removeFacilityBackgroundImage(facilityId)
- removeFacilityLogo(facilityId)

Exemplo de Payload

{
  "_id": "507f1f77bcf86cd799439011",
  "name": "Clínica RAD Centro - Atualizado",
  "companyName": "RAD Medicina Nuclear LTDA",
  "cnpj": "12345678000190",
  "telephone": "(11) 3000-0001",
  "department": "Medicina Nuclear",
  "address": [{
    "street": "Rua Nova, 456",
    "city": "São Paulo",
    "state": "SP"
  }],
  "CNENregistry": "MN-12345-2024",
  "users": [
    {
      "_id": "userId1",
      "responsabilities": ["Titular", "Responsável Técnico"]
    },
    {
      "_id": "userId2",
      "responsabilities": ["Substituto"]
    }
  ],
  "radioisotopes": [
    {
      "name": "Tc(99m)",
      "quantity": 6000
    },
    {
      "name": "I(131)",
      "quantity": 250
    },
    {
      "name": "F(18)",
      "quantity": 1000
    }
  ]
}

Recursos Adicionais

Remover Imagens

Se a instalação possui imagens (logo ou background), você pode removê-las:

Remover Logo

services/auth/facilities.js → removeFacilityLogo(facilityId)

Remover Background

services/auth/facilities.js → removeFacilityBackgroundImage(facilityId)

Erros Comuns

Permissão Negada

• Verifique se você tem permissões para editar instalações
• Apenas RAD Laudos, RAD Físico, RAD Admin e Administradores podem editar

Campos Obrigatórios Vazios

• Certifique-se de que Nome, Razão Social, CNPJ, Telefone e Endereço estejam preenchidos

CNPJ Inválido

• Use apenas números
• Verifique se o CNPJ é válido
• Não use pontos, traços ou barras

Usuário não Encontrado

• O usuário deve estar cadastrado e ativo no sistema
• Verifique o nome ou email na busca

Quantidade Inválida de Radioisótopo

• Informe apenas números positivos
• Use ponto (.) para decimais se necessário
• Não use vírgulas ou outros caracteres

Boas Práticas

1. Revise antes de salvar: Confira todas as alterações antes de salvar
2. Mantenha dados CNEN atualizados: Informações CNEN devem refletir autorizações vigentes
3. Documente mudanças importantes: Se alterar responsáveis técnicos, documente a mudança
4. Verifique licenças: Ao atribuir papéis, confirme que os usuários possuem licenças CNEN válidas
5. Atualize quantidades regularmente: Revise quantidades de radioisótopos periodicamente

Próximos Passos

Após editar a instalação:

• Visualizar Instalação - Conferir as alterações
• Gerenciar Equipamentos - Atualizar equipamentos
• Documentos - Verificar documentação relacionada