Locais
Cadastros – Locais (Portal Easypac)
A tela de Locais, no módulo de Cadastros, mantém o cadastro dos locais físicos (unidades de inspeção, pontos de coleta) que o Easypac usa para organizar e restringir informações por localização; cada local pode ficar vinculado a uma ou mais empresas, cada vínculo com sua própria posição geográfica (latitude, longitude e raio) e status ativo/inativo.
Visão Geral
A tela de Locais, no módulo de Cadastros, mantém o cadastro dos locais físicos (unidades de inspeção, pontos de coleta) que o Easypac usa para organizar e restringir informações por localização; cada local pode ficar vinculado a uma ou mais empresas, cada vínculo com sua própria posição geográfica (latitude, longitude e raio) e status ativo/inativo. Um local cadastrado aqui é o que outras áreas do sistema — como as Planilhas e a associação automática de usuários “sem restrição por local” — usam para restringir onde cada usuário ou processo pode atuar. Esta tela apenas parametriza os locais e seus vínculos com as empresas; nenhuma coleta de dados em campo é feita por aqui.
Pré-requisitos
- Cadastrar um local exige que o usuário tenha uma empresa ativa na sessão: essa é a empresa vinculada automaticamente ao local no momento da criação; sem uma empresa ativa reconhecível, o vínculo inicial é gravado como “nenhuma empresa”.
- Vincular um local a empresas adicionais (painel Empresas) exige que o local já esteja salvo — o painel só é exibido depois que o local tem identificador; um local recém-aberto para cadastro (ainda sem salvar) não oferece essa opção.
- Vincular uma empresa a um local exige que essa empresa já esteja cadastrada e disponível na lista de empresas do usuário logado.
- Excluir um local exige que ele não esteja referenciado por outros cadastros (por exemplo, itens de Planilha que o utilizem); havendo referência, a exclusão é bloqueada.
- Excluir um vínculo entre empresa e local exige que esse vínculo não esteja em uso por nenhum item de Planilha daquela empresa associado àquele local; havendo uso, a exclusão é bloqueada.
Permissões e Perfis de Acesso
A tela de Locais não depende de nenhum módulo contratado opcional identificado na análise: o cadastro de locais integra a base do sistema, liberada a todos os clientes, dependendo apenas das permissões de papel descritas a seguir.
Papel — cadastro de local: visualizar a listagem de locais exige a permissão de visualizar local; abrir o cadastro de um local novo exige a permissão de novo local; abrir e salvar a edição de um local existente exige a permissão de editar local; excluir um local exige a permissão de excluir local.
Papel — vínculo Empresa x Local (painel Empresas do cadastro de um local): visualizar a grade de empresas vinculadas exige a permissão de visualizar vínculo empresa-local; criar um novo vínculo exige a permissão de novo vínculo empresa-local; excluir um vínculo exige a permissão de excluir vínculo empresa-local; alterar o status (ativo/inativo) de um vínculo exige a permissão de alterar status de vínculo empresa-local. Existe ainda uma consulta de locais vinculados a uma empresa, em sentido inverso, usada por outra tela do sistema (a tela de Empresas), que exige essa mesma permissão de visualizar vínculo empresa-local, mas não é chamada pelas telas de Locais.
Perfil fiscal: não tem acesso à tela, ou seja, não pode realizar nenhuma das ações citadas anteriormente.
Recorte de dados: o filtro de Empresa da listagem é composto por todas as empresas vinculadas ao usuário logado, mais a opção “Sem empresa vinculada” (representando os locais sem nenhuma empresa associada), inserida no início da lista. No servidor de aplicação (API), a listagem de locais exige apenas que o usuário esteja autenticado, sem checagem de papel nessa camada — todo o controle por permissão de tela (visualizar, incluir, editar, excluir) é feito inteiramente no Portal. A consulta de um local específico usada em telas de seleção (lookup) também não exige nenhuma permissão de papel, apenas autenticação — diferente das demais operações de Locais.
Fluxo Operacional
O usuário chega à tela de Locais pelo menu Cadastro > Locais. Ao abrir, o portal monta a lista de empresas do filtro (empresas do usuário logado, mais a opção “Sem empresa vinculada” no início) e carrega a grade de locais, paginada e ordenada no servidor. A partir daí o usuário pode:
- Abrir o painel de filtros (recolhido por padrão), selecionar uma ou mais empresas e clicar em “Filtrar”, ou navegar pelas páginas e pesquisar por texto na grade.
- Clicar em Novo para abrir o cadastro de um local novo, informar o nome e salvar; o local é automaticamente vinculado à empresa ativa da sessão no momento do cadastro.
- Clicar em Editar (ou dar duplo clique na linha) para abrir um local existente, alterar o nome e salvar.
- Dentro da edição de um local já existente, usar o painel Empresas para vincular o local a empresas adicionais, informando localização (latitude, longitude, raio – opcional) pelo modal com mapa, ou para alterar o status ou excluir um vínculo já existente.
- Clicar em Excluir para remover um local pela grade, confirmando a exclusão quando solicitado.
- Clicar em Cancelar a qualquer momento, no formulário, para voltar à listagem sem gravar nada, preservando os filtros aplicados anteriormente.
Interface e Comportamentos da Tela
Listagem de locais — grade, filtro e ações
A grade de locais desta tela exibe as colunas ID e Nome, com 20 registros por página e ordenação inicial pela coluna ID em ordem decrescente; a busca livre da grade só dispara uma nova consulta ao servidor a partir de 3 caracteres digitados (ou imediatamente ao apertar Enter ou ao limpar o campo), com um atraso de 500ms após o usuário parar de digitar. O painel de filtros (recolhido por padrão) tem apenas o campo Empresa, de seleção múltipla; as opções são todas as empresas do usuário logado, mais a opção “Sem empresa vinculada” inserida no início da lista. O filtro selecionado é enviado ao servidor a cada atualização da grade, mas só passa a valer, recarregando os resultados, quando o usuário clica no botão “Filtrar”. Os valores aplicados no filtro ficam guardados no navegador, por sessão, sob uma chave própria desta tela; esse cache só é reaproveitado quando a listagem é reaberta com o indicador “?ss” na URL — por exemplo, ao voltar do cadastro ou da edição de um local para a listagem.
A grade oferece os botões Novo (abre o cadastro de um local novo) e Editar (abre o local selecionado); o duplo clique em uma linha também abre a edição. Antes de excluir um local pela grade, é exibido o diálogo de confirmação com o id e o nome do local (ver Feedbacks ao Usuário); a exclusão só é enviada ao servidor se o usuário confirmar.
Formulário de cadastro e edição de local
O mesmo formulário de Locais atende tanto o cadastro de um local novo quanto a edição de um existente. O título da tela exibe o nome do local ao lado do rótulo “Local:”. O campo Nome é de preenchimento obrigatório, limitado a 100 caracteres, validado no navegador antes do envio — como em qualquer formulário do Portal, o envio só ocorre se passar na validação nativa do navegador; o formulário de Locais não tem campo de data, mas segue a mesma regra geral de bloquear o envio quando a validação falhar.
No cadastro de um local novo, o painel de empresas vinculadas não é exibido, porque o local ainda não tem identificador. Ao abrir a edição de um local existente, o portal busca o nome atual do local, monta a lista de empresas do usuário logado com uma opção “Selecione” em branco inserida no início, e passa a exibir o painel de empresas vinculadas, já que o identificador existe.
O botão Cancelar sempre retorna à listagem sem gravar nada, reaproveitando os filtros aplicados anteriormente (pelo mesmo indicador “?ss” na URL de retorno). Ao salvar, se o local ainda não tem identificador, a gravação segue pelo fluxo de “novo local”; se já tem identificador, segue pelo fluxo de “editar local” (que, no servidor, é a mesma rotina de criação — ver Regras de Negócio).
Grade de Empresas vinculadas ao local
Exibida somente na edição de um local já salvo, esta grade mostra as colunas ID, Empresa, Latitude, Longitude, Raio e Status, paginada e ordenada no servidor, com 20 registros por página e ordenação inicial pela coluna ID em ordem decrescente. A busca livre desta grade filtra apenas pelo nome da empresa; a ordenação aceita as colunas Status e Nome da Empresa, com Nome da Empresa como ordenação padrão. Na coluna Status: um vínculo inativo mostra um ícone de bloqueio, com destaque de alerta, e a dica “Clique para ativar”; um vínculo ativo mostra um ícone de confirmação, com destaque de sucesso, e a dica “Clique para desativar” — clicar no ícone alterna o status imediatamente, mediante confirmação (ver Feedbacks ao Usuário). O botão Novo desta grade abre o modal de vínculo em branco, com o mapa centralizado na posição padrão; selecionar um registro e clicar em Editar (ou dar duplo clique) abre o modal preenchido com os dados daquele vínculo.
Modal de vínculo Empresa x Local
O campo Empresa do modal é obrigatório, de seleção única com busca; os campos Latitude e Longitude são numéricos livres; o campo Raio (em metros) é texto, limitado a 6 caracteres, com máscara que aceita apenas dígitos e aplica automaticamente 2 casas decimais separadas por vírgula enquanto o usuário digita (por exemplo, digitar “12345” vira “123,45”). O modal exibe um mapa que inicia centralizado numa posição padrão fixa do sistema, com o zoom bem afastado, quando nenhuma posição prévia é informada; ao digitar latitude e longitude, ou ao arrastar e soltar o marcador no mapa, ou ao clicar diretamente no mapa, a posição do marcador é atualizada em tempo real e o zoom passa a um nível mais próximo. Ao salvar, o valor do Raio é convertido de vírgula para ponto antes do envio; latitude e longitude vazias são enviadas como nulas; se o vínculo é novo, o identificador enviado ao servidor é 0. Ao fechar o modal por qualquer meio, os campos do formulário (empresa, latitude, longitude, raio) são limpos.
Feedbacks ao Usuário
Nas operações de Locais e de vínculo Empresa x Local, quando a falha não trouxer uma mensagem estruturada do servidor, o portal exibe o texto bruto da resposta em vez de um texto de negócio.
Feedbacks — listagem e exclusão de local
| Situação | Feedback | Texto exato |
|---|---|---|
| Confirmar exclusão de um local pela grade | Confirmação antes de enviar | “Você está prestes a remover o local: {id} – {nome}” |
| Exclusão concluída com sucesso | Notificação, grade atualizada | “Operação efetuada com sucesso.” |
| Excluir um local referenciado por outros cadastros | Notificação de erro | “Não é possível deletar este local devido a ligação com alguns itens….” |
Feedbacks — cadastro e edição de local
| Situação | Feedback | Texto exato |
|---|---|---|
| Salvar (cadastro ou edição) concluído com sucesso | Notificação, redireciona para a edição do local salvo | “Operação efetuada com sucesso.” |
| Salvar com um nome já usado por outro local | Notificação de erro, formulário permanece aberto | “Já existe um local cadastrado com o nome {nome}” |
Feedbacks — vínculo Empresa x Local
| Situação | Feedback | Texto exato |
|---|---|---|
| Confirmar alteração de status do vínculo | Confirmação antes de enviar | “Você está prestes a alterar o status de um relacionamento entre Empresa e Local.” |
| Confirmar exclusão do vínculo | Confirmação antes de enviar | “Você está prestes a remover um relacionamento entre Empresa e Local.” |
| Salvar vínculo (novo ou edição) com sucesso | Notificação, grade atualizada, modal fechado | “Operação efetuada com sucesso.” |
| Vincular a mesma empresa duas vezes ao mesmo local | Notificação de erro, modal permanece aberto | “Já existe um local \”{nome do local}\” para a empresa \”{nome da empresa}\”” |
| Excluir vínculo em uso por item de Planilha | Notificação de erro | “Não foi possível efetuar a exclusão, pois o Empresa x Local está sendo utilizado” |
| Alterar status de vínculo que já não existe mais | Notificação de erro | “EmpresaxTurno não encontrado.” |
| Ícone de status inativo na grade de Empresas do local | Dica ao passar o mouse (tooltip) | “Clique para ativar” |
| Ícone de status ativo na grade de Empresas do local | Dica ao passar o mouse (tooltip) | “Clique para desativar” |
Processamento pelo Backend
Ao carregar a listagem de locais, o servidor recebe a busca textual, o filtro de empresa, a ordenação e a paginação exatamente como enviados pela grade. Aplica a busca textual e o filtro de empresa (ver Regras de Negócio), remove as repetições que apareceriam quando o filtro seleciona mais de uma empresa vinculada ao mesmo local, ordena pela coluna pedida — respeitando o limite de colunas ordenáveis — e só então pagina o resultado.
Ao abrir a edição de um local, o portal busca o local diretamente pelo identificador informado na rota, trazendo apenas identificador e nome (ver Regras de Negócio), e monta a lista de empresas do usuário logado para o painel de vínculos.
Ao salvar (cadastro ou edição), o portal envia os dados ao mesmo ponto de gravação em ambos os casos; o servidor decide entre inserir e atualizar exclusivamente pelo identificador recebido (ver Regras de Negócio). Antes de gravar, valida a unicidade do nome do local; se a validação falhar, a operação é interrompida com a mensagem correspondente e nada é alterado. Se for um cadastro novo, o servidor grava o local, cria o vínculo com a empresa ativa da sessão e dispara a associação automática dos usuários sem restrição por local (ver Regras de Negócio); se for uma edição, apenas atualiza o nome, sem tocar nos vínculos de empresa.
Ao excluir um local, o servidor verifica se existem outros cadastros que o referenciem; havendo referência, interrompe a exclusão sem remover nada (ver Regras de Negócio).
Ao vincular uma empresa a um local pelo modal, o servidor valida antes se o mesmo vínculo já existe; se não existir, calcula o código do vínculo (ver Etiquetas e QR Code), grava com status inicial ativo e dispara a mesma associação automática de usuários sem restrição por local. Ao alterar o status de um vínculo, apenas grava o novo valor, validando antes que o vínculo exista. Ao excluir um vínculo, verifica antes se ele está em uso por algum item de Planilha daquela empresa; havendo uso, interrompe a exclusão sem remover nada (ver Regras de Negócio, para as mensagens de cada validação).
A consulta de locais por Planilha substitui a lista de empresas eventualmente recebida do cliente da chamada pelas empresas vinculadas a planilha informada, antes de aplicar os mesmos filtros da listagem comum (ver Regras de Negócio). A consulta de locais para lookup, usada por outras telas do sistema, restringe o resultado às Planilhas que o usuário logado tem permissão de consultar, podendo ainda ser restrita por empresa.
Regras de Negócio
Nome do local é único no sistema inteiro
Ao gravar um local, o servidor rejeita a operação com a mensagem “Já existe um local cadastrado com o nome {nome}” quando já existir qualquer outro local com o mesmo nome, independentemente da empresa vinculada a ele — a unicidade vale para o sistema inteiro, não apenas dentro de uma empresa.
Vínculo automático com a empresa ativa na criação de um novo local
Ao cadastrar um novo local, o local é criado apenas com o nome informado no formulário; em seguida, o servidor cria automaticamente um vínculo entre esse local e a empresa que estiver ativa na sessão do usuário que está cadastrando. Essa empresa nunca é escolhida em nenhum campo do formulário de novo local — ela vem de um dado de contexto da sessão, lido de um cabeçalho da requisição; se esse dado não puder ser interpretado como um número, a empresa considerada para o vínculo é “nenhuma empresa”.
Associação automática de usuários sem restrição por local
Toda vez que um local é criado, ou que um vínculo entre Empresa e Local é criado ou editado, o sistema associa automaticamente a esse local todos os usuários marcados como “sem restrição por local”, sem nenhuma ação manual — esses usuários passam a enxergar o local desde esse momento. Essa associação nunca gera vínculos duplicados: um usuário que já estava associado ao local é ignorado nessa rotina.
Decisão entre cadastrar e editar um local
O servidor decide entre cadastrar e editar um local exclusivamente pelo identificador recebido: identificador ausente ou igual a zero significa um local novo; qualquer outro valor significa a edição do local com aquele identificador. O Portal chama exatamente a mesma rotina de gravação tanto para o cadastro quanto para a edição, cabendo ao servidor essa decisão — não existe, em uso, uma rotina de atualização separada; existe uma rotina de edição alternativa no sistema, mas ela nunca é acionada por nenhuma tela ou ponto de entrada. Ao editar um local existente, apenas o nome é alterado; nenhum vínculo de empresa é criado, alterado ou removido nessa operação — vínculos de empresa são geridos separadamente, pelo painel Empresas do local.
Exclusão de local e suas restrições
A exclusão de um local é definitiva, removendo o registro; se o local estiver referenciado por outros cadastros que o utilizem (por exemplo, itens de Planilha), a exclusão é rejeitada com a mensagem “Não é possível deletar este local devido a ligação com alguns itens….”.
Filtro de empresa e locais sem empresa vinculada
O filtro de empresa da listagem de locais aceita várias empresas ao mesmo tempo; se o valor que representa “nenhuma empresa” estiver entre as empresas selecionadas, a listagem passa a incluir também os locais que não têm nenhuma empresa vinculada. Quando o filtro seleciona mais de uma empresa vinculada ao mesmo local, esse local apareceria repetido na listagem; o sistema remove essas repetições antes de paginar, mantendo uma única linha por local.
Busca textual, ordenação e paginação da listagem principal de locais
A busca livre da listagem de locais filtra pelo identificador exato quando o texto digitado é inteiramente numérico, ou pelo nome do local contendo o texto em qualquer posição, ignorando espaços nas pontas e maiúsculas/minúsculas, caso contrário. As únicas colunas ordenáveis são o identificador e o nome; qualquer outra coluna informada é ignorada e a ordenação anterior é mantida. A paginação é aplicada em memória, por último, depois de todos os filtros e da ordenação.
Consulta de locais por Planilha
Existe uma consulta de locais filtrada automaticamente pelas empresas de uma Planilha informada, que recebe filtros extras em formato livre — as empresas usadas no filtro não vêm de nenhuma seleção manual: são obtidas a partir de todas as empresas vinculadas à Planilha informada, substituindo qualquer lista de empresas eventualmente enviada pelo cliente da chamada. Essa consulta exige a mesma permissão de visualizar local da listagem comum, mas não é utilizada pelas telas de Locais — está disponível para outras áreas do sistema que precisem restringir locais por Planilha.
Consulta de um local para edição e para seleção (lookup)
A consulta de um local específico usada para preencher o formulário de edição devolve apenas o identificador e o nome do local — nenhuma outra informação, como empresas vinculadas, é trazida por essa consulta. Já a consulta de locais usada em componentes de busca e seleção (lookup) por outras telas do sistema restringe o resultado aos locais vinculados a Planilhas que o usuário logado tem permissão de consultar, podendo ainda ser restrita a uma empresa específica ou a uma lista de empresas; essa consulta também aceita filtrar por um usuário específico, restringindo aos locais das empresas às quais aquele usuário está vinculado — filtro não utilizado pela tela de Locais, que só oferece filtro por empresa.
Consulta de locais vinculados a uma empresa (usada por outra tela do sistema)
Existe uma consulta que lista os locais vinculados a uma empresa específica — sentido inverso da grade de Empresas do local, usada por outra tela do sistema, não pela tela de Locais. Ela aceita busca tanto pelo nome do local (contendo o texto) quanto pelo identificador exato do local; as colunas ordenáveis são o identificador do local, o nome do local, a longitude, a latitude e o raio, com o identificador do local como ordenação padrão.
Vínculo entre Empresa e Local: unicidade e status inicial
Não é permitido vincular a mesma empresa ao mesmo local mais de uma vez: ao tentar criar um vínculo já existente (desconsiderando o próprio registro, em caso de edição), a gravação é rejeitada com a mensagem “Já existe um local \”{nome do local}\” para a empresa \”{nome da empresa}\””. Ao criar um novo vínculo Empresa x Local, o status inicial é sempre ativo.
Exclusão e alteração de status do vínculo Empresa x Local
Um vínculo Empresa x Local não pode ser excluído se estiver em uso: se existir algum item de Planilha daquela empresa associado àquele local, a exclusão é rejeitada com a mensagem “Não foi possível efetuar a exclusão, pois o Empresa x Local está sendo utilizado”. Alterar o status de um vínculo apenas grava o novo status; se o vínculo não for encontrado, a operação é rejeitada com a mensagem “EmpresaxTurno não encontrado.” — mensagem reaproveitada de outra funcionalidade de vínculo do sistema, exibida também para o vínculo empresa-local.
Lista de empresas oferecida nos filtros e formulários de Locais
A lista de empresas oferecida no filtro da listagem e nos formulários de Locais é composta apenas pelas empresas às quais o usuário logado está vinculado, vindo ordenada por nome da empresa; a empresa marcada como selecionada por padrão é a empresa configurada como padrão para aquele usuário, e cada empresa da lista indica se é essa empresa padrão.
QR Code
O vínculo entre Empresa e Local tem um código de QR Code associado, mas ele não é gerado a partir de nenhum campo digitado pelo usuário: a cada criação ou edição de um vínculo Empresa x Local, o servidor recalcula esse código como a concatenação do identificador da empresa, o caractere “|” e o identificador do local. A tela de Locais não exibe nem imprime esse código, a geração e impressão do QR Code fica disponível em outra tela do sistema (Empresas).
Troubleshooting
A opção Locais não aparece no menu Cadastro ou a listagem não carrega
Mensagem exibida: Nenhuma — a opção simplesmente não aparece, ou a tela não carrega a grade.
O que fazer: confirmar se o usuário tem a permissão de visualizar local atribuída ao seu perfil de acesso.
O botão Novo não aparece ou não abre o cadastro de um local novo
Mensagem exibida: Nenhuma — o botão simplesmente não aparece, ou a ação não responde.
O que fazer: confirmar se o usuário tem a permissão de novo local atribuída ao seu perfil de acesso.
Não é possível abrir ou salvar a edição de um local existente
Mensagem exibida: Nenhuma — a ação de abrir o formulário ou de salvar não responde ou é bloqueada.
O que fazer: confirmar se o usuário tem a permissão de editar local atribuída ao seu perfil de acesso.
O botão Excluir não remove o local selecionado
Mensagem exibida: Nenhuma — a ação não responde, ou o diálogo de confirmação não avança.
O que fazer: confirmar se o usuário tem a permissão de excluir local atribuída ao seu perfil de acesso.
O painel de Empresas vinculadas não aparece no cadastro de um local
Cenário: o usuário espera ver o painel de empresas vinculadas logo ao abrir o cadastro de um local novo.
Mensagem exibida: Nenhuma — o painel simplesmente não é exibido.
O que fazer: explicar que esse comportamento é esperado — o painel só aparece depois que o local é salvo pela primeira vez e passa a ter identificador; salvar o cadastro do local antes de tentar vincular empresas a ele.
A grade de Empresas do local aparece vazia, ou o botão Novo (vínculo) não responde
Mensagem exibida: Nenhuma — a grade não carrega, ou o botão não abre o modal.
O que fazer: confirmar se o usuário tem a permissão de visualizar vínculo empresa-local (para ver a grade) e a permissão de novo vínculo empresa-local (para abrir o modal de cadastro).
Erro ao salvar um local com nome já usado
Cenário: o usuário cadastra ou renomeia um local para um nome já utilizado por outro local, mesmo de outra empresa.
Mensagem exibida: “Já existe um local cadastrado com o nome {nome}”
O que fazer: escolher outro nome; a verificação de nome duplicado considera todos os locais do sistema, não apenas os da empresa selecionada.
Erro ao excluir um local referenciado por outros cadastros
Mensagem exibida: “Não é possível deletar este local devido a ligação com alguns itens….”
O que fazer: informar ao suporte que o local está em uso por outro cadastro (por exemplo, um item de Planilha); a exclusão exige remover antes essas referências.
Erro ao vincular a mesma empresa duas vezes ao mesmo local
Mensagem exibida: “Já existe um local \”{nome do local}\” para a empresa \”{nome da empresa}\””
O que fazer: verificar na grade de Empresas do local se o vínculo já existe antes de cadastrar novamente; se necessário, editar o vínculo existente em vez de criar um novo.
Erro ao excluir um vínculo Empresa x Local em uso
Mensagem exibida: “Não foi possível efetuar a exclusão, pois o Empresa x Local está sendo utilizado”
O que fazer: informar que o vínculo está em uso por um item de Planilha daquela empresa associado àquele local; a exclusão exige remover antes essa referência.
Erro ao alterar o status de um vínculo que já não existe mais
Cenário: o usuário tenta ativar ou desativar um vínculo Empresa x Local que foi removido por outra sessão antes da ação.
Mensagem exibida: “EmpresaxTurno não encontrado.”
O que fazer: atualizar a grade de Empresas do local antes de tentar novamente; a mensagem exibida é reaproveitada de outra funcionalidade de vínculo do sistema, mas o efeito é o mesmo — o vínculo não foi encontrado.
A listagem de Locais aparece vazia ou sem o local esperado, mesmo havendo locais cadastrados
Cenário: o usuário espera ver um local específico na listagem, mas ele não aparece.
Mensagem exibida: Nenhuma — a grade simplesmente não traz o registro esperado.
O que fazer: confirmar o filtro de Empresa aplicado no painel — com uma empresa específica selecionada, só aparecem locais vinculados a ela; com a opção “Sem empresa vinculada” selecionada, só aparecem locais sem nenhuma empresa vinculada. Confirmar também se o filtro guardado da sessão anterior (reaproveitado ao voltar de um cadastro) não está restringindo além do esperado.
Cliques repetidos no botão Salvar do modal de vínculo Empresa x Local gravam o mesmo vínculo mais de uma vez
Cenário: o usuário clica várias vezes no botão Salvar do modal antes de a primeira gravação terminar.
Mensagem exibida: Nenhuma — cada clique dispara uma gravação, sem impedimento visível.
O que fazer: orientar o usuário a clicar uma única vez e aguardar a confirmação; se vínculos duplicados já tiverem sido gravados, excluir os registros repetidos pela grade de Empresas do local. Encaminhar ao responsável técnico (ver registro técnico de bugs desta feature).
A tela de Locais é redirecionada de repente para a página de erro 403
Cenário: enquanto qualquer chamada ao servidor está em andamento, a tela exibe a sobreposição “Processando”; se a resposta vier com o status de acesso proibido, o portal redireciona automaticamente para a página de erro correspondente.
Mensagem exibida: Nenhuma mensagem própria da tela — a página de erro 403 é exibida no lugar da tela de Locais.
O que fazer: confirmar se a permissão necessária para aquela ação (visualizar, novo, editar ou excluir local; ou os vínculos de Empresa x Local) ainda está atribuída ao usuário — o acesso pode ter sido revogado durante a própria sessão.
Casos de Uso
Caso 1 — Cadastro de um novo local vinculado automaticamente à empresa ativa
Um usuário com permissão de novo local, com a empresa “Frigorífico Modelo Ltda” ativa na sessão, abre a listagem de Locais, clica em Novo, informa o nome “Unidade Industrial Sul” e salva. O portal exibe “Operação efetuada com sucesso.” e redireciona para a edição do local recém-criado, já com o identificador atribuído pelo servidor; o local fica automaticamente vinculado à empresa “Frigorífico Modelo Ltda”, sem que o usuário tenha escolhido essa empresa em nenhum campo do formulário.
Caso 2 — Vínculo de um local a uma segunda empresa com posição geográfica
Dentro da edição do local “Unidade Industrial Sul”, o usuário abre o painel Empresas, clica em Novo e vincula a empresa “Distribuidora Sul Ltda”, digitando de forma opcional, a latitude e longitude (ou ajustando a posição no mapa) e informando um raio de 150,00 metros. Ao salvar, o portal exibe “Operação efetuada com sucesso.”, fecha o modal e atualiza a grade de empresas vinculadas, agora com duas linhas — uma para cada empresa — cada uma com seu próprio status, ativo por padrão.
Caso 3 — Tentativa de excluir um local em uso por uma Planilha
Um usuário tenta excluir o local “Unidade Industrial Sul”, que está associado a um item de Planilha vigente. O portal exibe “Não é possível deletar este local devido a ligação com alguns itens….” e o local permanece na listagem, sem nenhuma alteração.
Caso 4 — Filtrar a listagem pela opção “Sem empresa vinculada”
Um usuário abre o painel de filtros, seleciona a opção “Sem empresa vinculada” no campo Empresa e clica em “Filtrar”. A grade recarrega mostrando apenas os locais que ainda não têm nenhuma empresa associada, mesmo que o usuário tenha acesso a várias empresas com locais próprios cadastrados.