Navegação

Este guia explica a estrutura de navegação do sistema Trevo e como encontrar rapidamente as funcionalidades que você precisa.

Estrutura Geral

O sistema Trevo utiliza uma navegação hierárquica com:

• Menu Principal (Header): Acesso rápido às seções principais
• Breadcrumbs: Indicam sua localização atual na hierarquia
• Menu Lateral (quando aplicável): Navegação contextual dentro de cada seção
• Cards de Navegação: Links visuais para subseções

Menu Principal

O menu principal está localizado no topo da página e contém os principais módulos do sistema:

Instalações (Facilities)

• Lista de todas as instalações cadastradas
• Acesso ao detalhe de cada instalação
• Opções de criação e edição (conforme permissões)

Usuários

• Lista de usuários do sistema
• Cadastro de novos usuários (admin)
• Visualização e edição de perfis

Documentos

• Lista de documentos
• Filtros por status (Falta corrigir, Falta assinar, Liberado)
• Upload de novos documentos (RAD)

Equipamentos

• Acessível através da página de cada instalação
• Lista de equipamentos por tipo
• Registro e gerenciamento de equipamentos

Breadcrumbs

Os breadcrumbs mostram o caminho atual na hierarquia do sistema:

Home > Instalação > Equipamentos > Gamma Camera > Testes > Daily Tests

Você pode clicar em qualquer nível do breadcrumb para voltar àquela seção.

Navegação por Instalação

Ao acessar uma instalação específica (/facility/:id), você terá acesso a:

Cards de Navegação

• Documentos: Documentos relacionados à instalação
• Equipamentos: Equipamentos cadastrados na instalação
• Rotinas: Rotinas operacionais da instalação
• Informações: Dados detalhados da instalação

Botões de Ação

• Editar: Modifica dados da instalação (requer permissão)
• Excluir: Remove a instalação (requer confirmação e permissão)

Navegação por Equipamento

Na página de equipamentos de uma instalação (/facility/:id/equipments):

1. Visualização em Grid: Cards organizados por tipo de equipamento
2. Busca: Campo de busca por nome do equipamento
3. Adicionar Equipamento: Botão para cadastrar novo equipamento

Ao clicar em um tipo de equipamento, você acessa a lista de equipamentos daquele tipo.

Navegação de Testes

Para acessar testes de um equipamento:

1. Acesse a instalação
2. Clique em "Equipamentos"
3. Selecione o tipo de equipamento
4. Clique no equipamento específico
5. Visualize os tipos de testes disponíveis
6. Clique no tipo de teste para ver o histórico

Caminho completo: /equipments/:typeId/:equipmentId/test/:testId

Navegação de Documentos

A seção de documentos (/document) oferece:

Filtros Rápidos

Acessíveis via query params:

• Falta corrigir: /document?status=corrigir
• Falta assinar: /document?status=assinar
• Assinado: /document?status=liberar

Busca

Campo de busca com debounce para filtrar documentos por nome

Ações por Documento

Cada linha da tabela possui ações específicas baseadas em permissões:

• Visualizar
• Comentar (solicitar correções)
• Assinar
• Liberar
• Agendar email
• Excluir

Filtros e Paginação

Filtros Comuns

• Status: Ativo/Inativo (usuários, documentos)
• Busca: Filtro de texto em tempo real
• Tipo: Tipo de usuário, tipo de equipamento, etc.

Paginação

A maioria das listas possui paginação:

• Opções de itens por página: 10, 20, 50
• Navegação entre páginas
• Indicador de página atual

Modos de Visualização

Lista de Usuários

Dois modos de visualização:

• Cards: Visualização em grade com informações resumidas
• Tabela: Visualização em lista com mais detalhes

Botões de alternância disponíveis no topo da lista.

Atalhos e Acesso Rápido

Acesso Direto via URL

Você pode acessar diretamente páginas específicas se souber o ID:

• Instalação: /facility/:id
• Usuário: /user/:id
• Equipamento: /equipments/:typeId/:equipmentId
• Edição de instalação: /facility/:id/edit
• Edição de usuário: /user/:id/edit

Navegação Contextual

Dentro de cada seção, links contextuais facilitam a navegação:

• Da instalação para seus equipamentos
• Do equipamento para seus testes
• Do teste para edição ou visualização detalhada

Permissões e Navegação

A navegação se adapta às suas permissões:

Usuários Cliente

• Veem apenas documentos "Liberado"
• Não têm acesso a opções de edição
• Navegação simplificada

Usuários RAD

• Acesso a todas as seções de gerenciamento
• Opções de criação, edição e exclusão
• Ações de assinatura e liberação

Administradores

• Acesso completo a todas as funcionalidades
• Gerenciamento de usuários e permissões
• Configurações do sistema

Menu de Usuário

No canto superior direito, o menu de usuário oferece:

• Perfil: Acesso às suas informações
• Configurações: Preferências pessoais (se disponível)
• Sair: Logout do sistema

Navegação Responsiva

O sistema é responsivo e se adapta a diferentes tamanhos de tela:

Desktop

• Menu principal completo no topo
• Sidebars quando aplicável
• Tabelas com todas as colunas

Tablet/Mobile

• Menu hamburger para navegação principal
• Tabelas adaptadas com colunas prioritárias
• Cards em vez de tabelas quando apropriado

Dicas de Navegação

1. Use Breadcrumbs: Para voltar rapidamente a níveis anteriores
2. Aproveite Filtros: Para encontrar rapidamente o que procura
3. Salve URLs: URLs diretas podem ser salvas como favoritos
4. Atalhos de Teclado: (se disponíveis) para navegação mais rápida
5. Busca Global: Use o campo de busca quando disponível

Exemplo de Fluxo Completo

Para cadastrar um teste de equipamento:

1. Home → Clique em "Instalações"
2. Lista de Instalações → Selecione a instalação desejada
3. Detalhe da Instalação → Clique no card "Equipamentos"
4. Lista de Equipamentos → Selecione o tipo de equipamento
5. Lista por Tipo → Clique no equipamento específico
6. Detalhe do Equipamento → Clique no tipo de teste
7. Histórico de Testes → Clique em "Adicionar Teste"
8. Formulário de Registro → Preencha e salve

Próximos Passos

Agora que você entende a navegação:

• Guia do Usuário - Aprenda a usar cada funcionalidade
• Gerenciamento de Instalações - Comece com instalações
• Gerenciamento de Documentos - Trabalhe com documentos