Excluir Instalação

Este guia explica como remover uma instalação do sistema Trevo.

⚠️ Atenção

A exclusão de uma instalação é uma ação irreversível que pode ter impactos significativos:

• Todos os equipamentos associados podem ser afetados
• Documentos relacionados podem perder a associação
• Testes de equipamentos podem ser afetados
• Histórico de operações será perdido

Recomendação: Considere desativar a instalação em vez de excluí-la, se essa opção estiver disponível.

Permissões Necessárias

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

• RAD Admin
• Administrador

Nota: RAD Laudos e RAD Físico NÃO podem excluir instalações.

Como Excluir

Passo a Passo

1. Acesse a Instalação

   • Navegue até a instalação que deseja excluir
   • Você deve estar na página de detalhe (/facility/:id)

2. Clique em Excluir

   • Localize o botão "Excluir" na página
   • Geralmente está próximo ao botão "Editar"

3. Confirme a Ação

   • Um diálogo de confirmação será exibido
   • Mensagem: "Tem certeza que deseja excluir esta instalação?"
   • Leia atentamente o aviso antes de confirmar

4. Confirmação Final

   • Clique em "OK" ou "Confirmar" para prosseguir
   • Clique em "Cancelar" para abortar a operação

5. Redirecionamento

   • Após a exclusão bem-sucedida, você será redirecionado para /facilities
   • Uma mensagem de confirmação será exibida
   • A instalação não aparecerá mais na lista

Dados Técnicos

Endpoint da API

POST /facility/exclude

Serviço

services/auth/facilities.js → excludeFacility(facility)

Payload

{
  "_id": "507f1f77bcf86cd799439011"
}

Resposta de Sucesso

{
  "success": true,
  "message": "Instalação excluída com sucesso"
}

Impactos da Exclusão

Equipamentos

• Equipamentos cadastrados na instalação podem:
  • Ficar órfãos (sem instalação associada)
  • Ser excluídos em cascata (dependendo da implementação)
  • Precisar ser realocados para outra instalação

Recomendação: Antes de excluir, verifique os equipamentos associados.

Documentos

• Documentos vinculados à instalação podem:
  • Perder a referência de instalação
  • Precisar ser reclassificados
  • Ficar inacessíveis para usuários clientes

Recomendação: Exporte ou transfira documentos importantes antes da exclusão.

Usuários

• Associações de usuários com a instalação serão removidas
• Usuários não serão excluídos do sistema
• Apenas o vínculo com a instalação será removido
• Responsabilidades específicas da instalação serão perdidas

Testes de Equipamentos

• Testes de equipamentos da instalação podem:
  • Ficar sem referência
  • Precisar ser migrados
  • Perder contexto histórico

Checklist Antes de Excluir

Antes de excluir uma instalação, verifique:

• [ ] Você tem permissão adequada (RAD Admin ou Administrador)?
• [ ] Todos os documentos importantes foram salvos/exportados?
• [ ] Equipamentos foram realocados ou não são mais necessários?
• [ ] Não há processos pendentes (assinaturas, aprovações)?
• [ ] A exclusão foi autorizada pela administração?
• [ ] Não há dependências em outros sistemas?
• [ ] Um backup foi realizado (se aplicável)?

Alternativas à Exclusão

Considere estas alternativas antes de excluir:

1. Desativação (se disponível)

• Mantém os dados no sistema
• Remove da visualização ativa
• Permite reativação futura
• Preserva histórico

2. Arquivamento

• Move para uma categoria de "arquivados"
• Mantém acessibilidade para consulta
• Reduz poluição visual

3. Transferência de Dados

• Migre equipamentos para outra instalação
• Transfira documentos
• Reatribua responsabilidades

Procedimento Recomendado

Para uma exclusão segura:

1. Preparação

# Liste todos os equipamentos
GET /facility/:id/equipments

# Liste todos os documentos
GET /documents?facility=:id

# Exporte dados importantes
# (implementação dependente do sistema)

2. Migração de Dados

• Realoque equipamentos para outra instalação
• Transfira documentos relevantes
• Atualize referências em outros sistemas

3. Notificação

• Avise usuários afetados
• Informe administradores
• Documente o motivo da exclusão

4. Exclusão

• Execute a exclusão conforme descrito acima
• Verifique que não há erros
• Confirme que os dados foram removidos

5. Pós-Exclusão

• Verifique que equipamentos foram tratados
• Confirme que documentos estão acessíveis
• Valide que usuários não foram impactados negativamente

Recuperação

Importante: Não há funcionalidade de "desfazer" após a exclusão.

Se você excluiu uma instalação por engano:

1. Contate imediatamente o administrador do sistema
2. Verifique backups do banco de dados (se disponíveis)
3. Documente o que foi perdido
4. Recadastre a instalação se necessário
5. Restaure dados de backup se possível

Erros Comuns

Permissão Negada

Erro: Usuário não tem permissão para excluir instalações

Solução: Apenas RAD Admin e Administradores podem excluir.

Instalação em Uso

Erro: Instalação não pode ser excluída pois possui dependências

Solução: Remova ou transfira equipamentos, documentos e outras dependências primeiro.

Instalação não Encontrada

Erro: Instalação não existe

Solução: Verifique se a instalação não foi já excluída ou se o ID está correto.

Logs e Auditoria

A exclusão de instalações deve ser registrada em logs de auditoria com:

• Timestamp da exclusão
• Usuário que executou a ação
• ID da instalação excluída
• Nome da instalação
• Motivo (se solicitado)

Consulte a administração para acessar logs de auditoria.

Boas Práticas

1. Documente o motivo: Anote por que a instalação está sendo excluída
2. Comunique com antecedência: Avise usuários afetados
3. Faça backup: Se possível, exporte dados antes da exclusão
4. Verifique dependências: Certifique-se de que não há dados críticos vinculados
5. Use permissões adequadas: Restrinja a exclusão a usuários autorizados
6. Considere alternativas: Avalie se desativação seria mais apropriada
7. Teste em staging: Se possível, teste o impacto em ambiente de teste primeiro

Código de Referência

Arquivo

pages/facility/[id]/index.vue

Lógica de Exclusão

const handleDelete = async () => {
  const confirmed = confirm('Tem certeza que deseja excluir esta instalação?')

  if (!confirmed) return

  const result = await excludeFacility(facility.value)

  if (result.success) {
    navigateTo('/facilities')
  }
}

Próximos Passos

Após excluir uma instalação:

• Listar Instalações - Verificar que foi removida
• Criar Instalação - Cadastrar nova se necessário
• Documentação - Verificar impacto em documentos