Setor

Documentação Técnica Setor — Gestão de Documentos (Portal Easypac) A tela de Setor, no módulo de Gestão de Documentos, é onde o usuário cadastra e mantém a lista de setores da empresa que serão usados para classificar os documentos do processo de gestão da qualidade. 01. VISÃO GERAL Visão Geral A tela de Setor, no módulo de Gestão de Documentos, é onde o usuário cadastra e mantém a lista de setores da empresa que serão usados para classificar os documentos do processo de gestão da qualidade. Ela não trata documentos diretamente: parametriza um dos atributos usados mais tarde pela Criação de Documento, que consulta os setores cadastrados aqui através de uma seleção (lookup) para vincular cada documento ao setor responsável. Sem um setor cadastrado e ativo, a tela de Criação de Documento não tem o que oferecer nesse campo. 02. PRÉ-REQUISITOS Pré-requisitos Não há cadastro obrigatório anterior para criar um setor: Nome, Sigla e Situação são informados livremente pelo próprio usuário no formulário, sem vínculo com empresa, local, turno ou qualquer outro cadastro. O único pré-requisito é de permissão: o usuário precisa ter o perfil de acesso adequado (ver Permissões e Perfis de Acesso) para abrir a listagem, cadastrar ou editar um setor. Para que um setor apareça como opção na seleção (lookup) da tela de Criação de Documento, ele precisa estar com a Situação Ativo — o lookup padrão dessa integração não traz setores Inativos (ver Regras de Negócio). 03. PERMISSÕES E PERFIS DE ACESSO Permissões e Perfis de Acesso A tela de Setor é controlada por permissões de papel, uma para cada operação: abrir a listagem exige o perfil de permissão de listar setores; abrir o formulário de novo cadastro e gravá-lo exige o perfil de permissão de cadastrar setores; abrir o formulário de edição de um setor existente e gravar a alteração exige o perfil de permissão de editar setores. A listagem de setores também não é filtrada por empresa, local ou grupo: todos os setores cadastrados no sistema aparecem para qualquer usuário com permissão de listar, independentemente da empresa à qual o usuário está vinculado. Perfil fiscal: não tem acesso à tela, ou seja, não pode adicionar novo, editar e nem excluir. 04. FLUXO OPERACIONAL Fluxo Operacional O usuário acessa Gestão de Documentos > Setor no menu do portal e abre a listagem de setores. Opcionalmente, ajusta o filtro de Situação (por padrão, já vem com “Ativo” marcado) e confirma no botão Filtrar, ou digita um termo na busca textual da grid. Para cadastrar, clica em Novo; para editar, seleciona um registro na grid e clica em Editar, ou dá duplo clique diretamente na linha. No formulário, preenche ou altera Nome, Sigla e Situação e clica em Salvar — ou clica em Cancelar para desistir sem gravar. Ao salvar com sucesso, o portal retorna para a listagem de setores com o filtro de Situação anterior preservado. 05. INTERFACE E COMPORTAMENTOS DA TELA Interface e Comportamentos da Tela Grid de listagem de setores A grid de setores exibe 30 registros por página, com ordenação inicial pela coluna Id em ordem decrescente. As colunas exibidas são Id, Nome (descrição), Sigla e Situação; a coluna Situação mostra o texto “Ativo” ou “Inativo” conforme a situação gravada do setor. O botão Novo da listagem leva direto para o formulário de cadastro de um novo setor. O botão Editar exige que ao menos um registro esteja selecionado na grid. Se mais de um registro estiver selecionado, o botão Editar considera apenas o primeiro registro selecionado — os demais são ignorados silenciosamente, sem aviso ao usuário. Um duplo clique em qualquer linha da grid abre diretamente o formulário de edição daquele registro. Filtro de Situação na listagem de setores O painel de filtros da listagem de setores tem apenas o campo Situação, de múltipla escolha entre Ativo e Inativo; ao abrir a tela, a opção “Ativo” já vem pré-selecionada. O filtro começa recolhido e só é aplicado à grid quando o usuário confirma no botão Filtrar. Ao sair da tela de edição de um setor, salvando ou cancelando, e retornar para a listagem, o portal recupera automaticamente o último valor de filtro de Situação aplicado antes de sair, sem exigir que o usuário refiltre. Busca textual na listagem de setores A caixa de busca por texto da grid, padrão de toda listagem deste portal, só dispara a pesquisa automaticamente a partir de 3 caracteres digitados; com menos que isso, a busca só ocorre se o campo for esvaziado ou se o usuário pressionar Enter. Formulário de cadastro e edição de setor O formulário de setor exige o preenchimento de Nome (até 100 caracteres), Sigla (até 10 caracteres) e Situação. O preenchimento é validado antes de salvar; se algum campo obrigatório estiver inválido, o salvamento é interrompido e nada é gravado. Quando é um cadastro novo, o campo Situação já vem marcado como Ativo; quando é edição, o campo vem com a situação atualmente gravada do registro. O botão Cancelar volta para a listagem imediatamente, sem confirmar e sem gravar nada. 06. FEEDBACKS AO USUÁRIO Feedbacks ao Usuário Situação Feedback Texto exato Salvamento de setor (cadastro ou edição) concluído com sucesso Notificação de sucesso “Operação efetuada com sucesso.” Falha ao salvar setor (cadastro ou edição) Notificação de erro texto exato devolvido pelo servidor para a falha ocorrida — varia conforme a causa da rejeição Setor solicitado para edição não existe mais no momento da consulta Resposta de erro do servidor “não encontrado” Setor solicitado na seleção (lookup) da Criação de Documento não existe Resposta de erro do servidor “não encontrado” Consulta de sigla de setor para um Id que não existe Resposta de erro do servidor “não encontrado” 07. REGRAS DE NEGÓCIO Regras de Negócio Situação do setor A situação de um setor tem apenas dois valores possíveis: Ativo e Inativo. Normalização de Nome e Sigla do setor ao gravar Tanto no cadastro quanto na edição de um setor, o Nome e a Sigla são gravados sem espaços nas extremidades, mesmo que

Tipo de Documento

Documentação Técnica Tipo de Documento — Gestão de Documentos (Portal Easypac) O cadastro de Tipo de Documento parametriza as categorias de documento do módulo de Gestão de Documentos (por exemplo, Procedimento Operacional Padrão, Instrução de Trabalho) e define, para cada categoria, quem participa do ciclo de vida do documento. 01. VISÃO GERAL Visão Geral O cadastro de Tipo de Documento parametriza as categorias de documento do módulo de Gestão de Documentos (por exemplo, Procedimento Operacional Padrão, Instrução de Trabalho) e define, para cada categoria, quem participa do ciclo de vida do documento — quem pode criar, revisar, aprovar, publicar e visualizar um documento daquele tipo — além do padrão de numeração automática que os documentos daquele tipo vão receber e o prazo padrão em dias para a revisão periódica. É uma tela de parametrização: os documentos em si (criação, revisão, aprovação, publicação) são tratados nas demais telas do ciclo de vida do módulo, que consultam o Tipo de Documento para saber quem é responsável por cada etapa e qual numeração aplicar. 02. PRÉ-REQUISITOS Pré-requisitos Para que um Tipo de Documento cumpra sua função no fluxo de aprovação, cada uma das cinco etapas (Criado por, Revisado por, Aprovado por, Publicado por, Visualizado por) precisa ter ao menos um responsável configurado — o formulário bloqueia a gravação enquanto algum desses campos estiver vazio (ver Interface e Comportamentos da Tela). Para vincular um responsável, os usuários ou grupos precisam já existir nos cadastros de Usuários ou de Grupos do portal — o campo de busca de responsável consulta esses cadastros para oferecer as opções de seleção. 03. PERMISSÕES E PERFIS DE ACESSO Permissões e Perfis de Acesso O acesso à tela de Tipo de Documento é controlado por permissões específicas, uma por operação: consultar a listagem dos tipos cadastrados exige a permissão de visualização de Tipo de Documento; consultar um registro específico e os responsáveis por cada etapa ou até mesmo editar alguma informação exigem a permissão de edição de Tipo de Documento; criar um novo Tipo de Documento exige a permissão de inclusão de Tipo de Documento. O Tipo de Documento não tem campo de empresa nem de local: ao contrário da maioria dos cadastros do portal, é único para o cliente inteiro — não existe recorte multiempresa na consulta nem nas gravações relacionadas a este cadastro. A única exceção é a busca de responsável por Grupo dentro do popup de seleção: essa busca específica é recortada pelo contexto de acesso do usuário logado no momento da chamada, mas isso afeta apenas a origem de onde os grupos pesquisáveis vêm — o registro do Tipo de Documento continua sem vínculo de empresa. Perfil fiscal: não tem acesso à tela, ou seja, não pode adicionar novo ou editar. 04. FLUXO OPERACIONAL Fluxo Operacional O usuário acessa Gestão de Documentos e escolhe Tipo de Documento. A listagem abre com os tipos de documento já cadastrados, filtrada pelo filtro de Situação pré-selecionado em “Ativo”. Para criar, o usuário aciona o botão Novo, preenche Descrição, Dias para Revisão, Sigla, monta o padrão de numeração automática e define, para cada uma das cinco etapas do ciclo de vida, a origem (Usuário ou Grupo) e ao menos um responsável; em seguida grava. Para alterar, o usuário seleciona uma linha e aciona Editar, ou dá duplo clique na linha. O formulário abre preenchido com os dados gerais, a máscara de numeração e os responsáveis já configurados de cada etapa. Após gravar com sucesso (criação ou edição), o sistema exibe a confirmação e, ao ser confirmada pelo usuário, redireciona para a tela de edição do próprio registro salvo — não retorna à listagem. Para desistir sem gravar, o usuário aciona Cancelar, que sempre volta para a listagem descartando qualquer alteração feita, sem pedir confirmação. 05. INTERFACE E COMPORTAMENTOS DA TELA Interface e Comportamentos da Tela Listagem de tipos de documento A grade de Tipo de Documento exibe 30 registros por página e ordena por padrão pela coluna Id em ordem decrescente. As colunas exibidas são Id, Descrição, Dias para Revisão e Situação, sempre com o texto Inativo ou Ativo. O usuário pode ordenar a grade clicando nas colunas Id, Descrição, Dias para Revisão ou Situação; em qualquer situação não reconhecida, a grade ordena por Id. O botão Editar da grade só age se houver uma linha selecionada. O botão Novo navega para o formulário de cadastro; o botão Editar e o duplo clique numa linha navegam para o formulário de edição do registro selecionado ou clicado. A busca livre da grade segue o comportamento genérico de toda listagem do portal: só dispara a consulta a partir de 3 caracteres digitados, ao esvaziar o campo, ou ao pressionar Enter (que ignora o mínimo de caracteres); a consulta é adiada 500ms após o usuário parar de digitar. Se o texto digitado for numérico, a busca filtra por Id exato ou por Dias para Revisão igual a esse número; se não for numérico, filtra por Descrição contendo o texto, sem diferenciar maiúsculas de minúsculas. Painel de filtros da listagem O painel de filtros tem apenas o campo Situação, em multisseleção, e inicia recolhido. Ao abrir a tela, o filtro já vem com a opção “Ativo” pré-selecionada; a cada consulta da grade, o valor do filtro de Situação é aplicado junto. Os valores de filtro aplicados ficam salvos localmente, mas só são recuperados automaticamente quando a tela é reaberta a partir de um link que carrega esse estado; abrindo a tela normalmente, o filtro sempre reinicia com “Ativo” selecionado, mesmo que o usuário tenha aplicado outro filtro na visita anterior. Ao clicar em Filtrar, o painel verifica a validade do formulário de filtros; se algum campo for inválido, a submissão é interrompida e o painel permanece aberto destacando o campo inválido. Formulário — dados gerais e numeração automática Em um novo cadastro, o campo “Próxima Sequência” vem com valor padrão 1 e permite alteração. Quando o cadastro já existe, o campo fica desabilitado, é utilizado somente para leitura, não pode ser alterado na

gestaodedocumento

Tipo de Ação

Documentação Técnica Tipo De Acao — Cadastros (Portal Easypac) O cadastro de Tipo de Ação define as categorias de ação que ficam disponíveis quando alguém registra o tratamento de uma não conformidade (Corretiva, Preventiva, Imediata). 01. VISÃO GERAL Visão Geral O cadastro de Tipo de Ação define as categorias de ação que ficam disponíveis quando alguém registra o tratamento de uma não conformidade (Corretiva, Preventiva, Imediata). Cada tipo de ação tem um nome, uma sigla curta e duas situações independentes: se está ativo no portal e se está disponível no aplicativo. É um cadastro de apoio: ele não registra nada sobre a qualidade em si — ele alimenta as listas de escolha das telas que registram. Por isso a exclusão de um tipo de ação já utilizado é bloqueada, e por isso a lista de seleção oferecida às outras telas mostra apenas os tipos ativos. 02. PRÉ-REQUISITOS Pré-requisitos Para usar a tela de Tipo de Ação, o usuário precisa estar autenticado no Portal Easypac e ter a permissão correspondente à operação que pretende executar (ver Permissões e Perfis de Acesso). Não há cadastro anterior obrigatório: o tipo de ação é um cadastro de primeiro nível, que não depende de empresa, local ou programa de qualidade previamente cadastrados. Para que um tipo de ação apareça como opção no aplicativo, além de existir ele precisa estar com a marcação Aplicativo ligada. 03. PERMISSÕES E PERFIS DE ACESSO Permissões e Perfis de Acesso O acesso à tela de Tipo de Ação é controlado por quatro permissões independentes, uma por operação: Operação O que a permissão libera Visualizar abrir a listagem de tipos de ação Incluir abrir o formulário em branco e gravar um tipo de ação novo Editar abrir o formulário preenchido e gravar alterações Excluir remover um tipo de ação da listagem As permissões são verificadas tanto ao abrir a tela quanto na operação enviada ao servidor — não basta esconder o botão. Um usuário com permissão apenas de visualizar consegue abrir a listagem, mas qualquer tentativa de gravar ou excluir é recusada pelo servidor. O cadastro de Tipo de Ação não depende de módulo contratado: ele faz parte do núcleo de cadastros do portal e está disponível para todos os clientes. A listagem também não é filtrada por empresa ou local: os tipos de ação são compartilhados por toda a base do cliente. Um tipo de ação cadastrado vale para todas as empresas e locais. 04. FLUXO OPERACIONAL Fluxo Operacional O usuário acessa Cadastros e escolhe Tipos de Ações. A listagem abre com os tipos de ação já cadastrados, do mais recente para o mais antigo. Para criar, o usuário aciona o botão de novo registro, preenche Nome e Sigla, define as marcações Ativo e Aplicativo e grava. Para alterar, o usuário seleciona uma linha e aciona o botão de editar — ou dá um duplo clique na linha. O formulário abre preenchido. Para remover, o usuário seleciona a linha e aciona o botão de excluir. O sistema pede confirmação antes de remover. Após gravar ou excluir, o sistema informa o resultado e retorna à listagem. 05. INTERFACE E COMPORTAMENTOS DA TELA Interface e Comportamentos da Tela Listagem de tipos de ação A listagem de Tipos de Ação exibe cinco colunas: identificador, Nome, Sigla, Ativo e Aplicativo. Nas colunas Ativo e Aplicativo, o valor gravado como 1 é exibido como “Sim” e qualquer outro valor como “Não”. A listagem abre ordenada pelo identificador, do maior para o menor, com 20 registros por página. A ordenação, a paginação e a busca são resolvidas no servidor — a tela nunca carrega a base inteira. A busca da grid tem dois comportamentos: quando o texto pesquisado é um número, a busca é feita pelo identificador exato; quando é texto, o sistema retorna os tipos de ação cujo Nome ou cuja Sigla contenham o termo. Além dos botões de novo, editar e excluir, a grid oferece recarregar. O duplo clique numa linha abre a edição daquele tipo de ação. Formulário de cadastro e edição O formulário de Tipo de Ação tem quatro campos. Nome é obrigatório e aceita no máximo 75 caracteres. Sigla é obrigatória e aceita no máximo 2 caracteres. Ativo e Aplicativo são duas marcações independentes, que iniciam conforme o valor gravado do tipo de ação. O botão Salvar só envia os dados quando Nome e Sigla estão preenchidos; caso contrário a tela destaca os campos pendentes e não chama o servidor. O botão Cancelar retorna à listagem sem gravar. O cabeçalho da tela de edição exibe “Tipo de Ação:” seguido do nome do tipo de ação em edição, o que permite confirmar qual registro está aberto. A mesma tela atende inclusão e edição: se o identificador for informado, o sistema busca o tipo de ação no servidor e preenche o formulário; se não for, abre um formulário vazio. 06. FEEDBACKS AO USUÁRIO Feedbacks ao Usuário Situação Feedback Texto exato Gravação concluída Aviso de sucesso, seguido de retorno à listagem “Operação efetuada com sucesso.” Exclusão concluída Aviso de sucesso e recarga da listagem “Operação efetuada com sucesso.” Confirmação de exclusão Diálogo com opção de cancelar — título “Tem certeza?” Confirmação de exclusão Diálogo com opção de cancelar — texto “Você está prestes a remover o tipo de ação: {identificador} – {nome}” Nome não preenchido Destaque do campo na própria tela, sem chamar o servidor Nenhum texto — o campo obrigatório é marcado e o envio é bloqueado Sigla não preenchida Destaque do campo na própria tela, sem chamar o servidor Nenhum texto — o campo obrigatório é marcado e o envio é bloqueado Nome ausente na gravação Aviso de erro “É necessário informar o campo descricao” Sigla repetida Aviso de erro “Já existe um tipo de ação com a sigla {sigla}” Tipo de ação já utilizado Aviso de erro, exclusão não ocorre “Tipo de ação aplicada aos registros. Não pode ser Apagada!” Exclusão sem identificador Aviso de erro “É necessário informar o id para efetuar a exclusão.” Tipo de ação inexistente na

Programa de Qualidade

Documentação Técnica Programa De Qualidade — Cadastros (Portal Easypac) A tela de Programa De Qualidade é um menu do módulo Cadastros que define os programas de qualidade usados para agrupar planilhas da gestão da qualidade e para parametrizar o envio automático de relatório quando uma planilha vinculada a esse programa tem sua assinatura fechada. 01. VISÃO GERAL Visão Geral A tela de Programa De Qualidade é um menu do módulo Cadastros que define os programas de qualidade usados para agrupar planilhas da gestão da qualidade e para parametrizar o envio automático de relatório quando uma planilha vinculada a esse programa tem sua assinatura fechada. Ela não gera nem envia o relatório em si: apenas cadastra o programa (código, descrição, situação) e configura, num modal próprio, para quais destinos — e-mail, Google Drive ou Azure Blob Storage — o relatório deve ser enviado quando o fechamento da planilha acontecer. O processo de fechamento da planilha, onde o relatório é efetivamente gerado e enviado, ocorre fora desta tela. 02. PRÉ-REQUISITOS Pré-requisitos Não há cadastro anterior obrigatório para criar um programa de qualidade em si — é um cadastro-base que pode ser criado isoladamente. As planilhas que serão vinculadas a este programa e contadas na coluna de quantidade de planilhas são cadastradas em telas próprias, fora deste acervo. Para habilitar o envio automático de relatório, cada tipo de destino tem um pré-requisito próprio, verificado apenas no momento de adicionar o destino no modal de configuração: E-mail: nenhum pré-requisito externo; basta informar ao menos um endereço. Google Drive: exige que a conexão OAuth com o Google já tenha sido concluída nesta tela (upload do arquivo de credenciais) antes de informar o ID da pasta; sem essa conexão, o destino não é adicionado. Azure Blob Storage: exige que a URL do container já exista e esteja disponível para ser informada; sem ela, o destino não é adicionado. 03. PERMISSÕES E PERFIS DE ACESSO Permissões e Perfis de Acesso Não há dependência de módulo contratado específico para esta tela — ela integra o cadastro padrão do módulo Cadastros, sem checagem de contrato adicional. Quanto ao papel do usuário, cada operação exige uma permissão própria, traduzida para linguagem de negócio: visualizar a listagem exige a permissão de visualizar programa de qualidade; abrir o formulário de novo cadastro e gravar um programa novo exigem a permissão de cadastrar programa de qualidade; abrir o formulário de edição, consultar um programa específico por Id e gravar uma edição exigem a permissão de editar programa de qualidade; excluir um programa exige a permissão de excluir programa de qualidade. Já a lista de seleção de programas de qualidade (usada por outras telas para vincular um programa), o salvamento e a desativação da configuração de envio automático de relatório e a conexão com o Google Drive não exigem nenhuma permissão específica de papel além da autenticação padrão do Portal — ou seja, qualquer usuário autenticado pode alterar a configuração de envio de um programa, mesmo sem a permissão de editar programa de qualidade. Perfil fiscal: não tem acesso à tela, ou seja, não pode realizar nenhuma das ações mencionadas acima. Quanto ao recorte de dados: ao contrário de algumas telas do sistema, a listagem de Programas de Qualidade não aplica filtro por empresa — programas de qualidade de todas as empresas aparecem juntos na mesma listagem, sem isolamento multiempresa. 04. FLUXO OPERACIONAL Fluxo Operacional O usuário acessa a tela de Programa De Qualidade pelo menu Cadastros. Na listagem, pode pesquisar, ordenar e paginar os programas já cadastrados, abrir o formulário de um novo programa pelo botão Novo, abrir a edição de um programa existente pelo botão Editar ou por duplo clique na linha, ou excluir um programa pelo botão Excluir mediante confirmação. Dentro do formulário de edição, o usuário pode ainda abrir o modal de Configuração de Envio de Relatório para definir se o envio automático fica habilitado e para quais destinos ele deve ocorrer. Ao concluir o cadastro ou a edição, a tela retorna para a listagem. 05. INTERFACE E COMPORTAMENTOS DA TELA Interface e Comportamentos da Tela Listagem de programas de qualidade A grade pagina e ordena no servidor, com 20 registros por página e ordenação inicial pelo Id em ordem decrescente. A coluna Status é calculada no navegador a partir do campo ativo do programa: exibe Ativo quando o valor é 1, e Inativo em qualquer outro caso. A coluna de quantidade de planilhas não é ordenável nem pesquisável. A pesquisa livre só dispara uma nova busca ao servidor a partir de 3 caracteres digitados, ao apertar Enter, ou ao limpar o campo; as requisições são adiadas em 500ms após o usuário parar de digitar, para evitar uma chamada a cada tecla. O botão Novo leva ao formulário de cadastro; o botão Editar (ou duplo clique na linha) leva ao formulário de edição do programa selecionado; o botão Excluir aciona a confirmação de remoção. Formulário de cadastro e edição de programa de qualidade Quando um Id é informado na rota de edição, a tela carrega os dados do programa (código, descrição, status e configuração de envio de relatório) e marca o valor de status atual como selecionado; quando nenhum Id é informado, a tela abre em branco para um novo cadastro, com o status inicial não pré-selecionado nas opções (assume o padrão do controle). O campo Código é obrigatório, com até 40 caracteres; a Descrição é opcional, com até 150 caracteres; o Status é um controle de seleção única e obrigatório, pré-selecionado com o valor atual do programa — o padrão é Ativo. A validação de preenchimento ocorre no navegador antes do envio. O botão Configuração de Envio de Relatório só aparece no cabeçalho quando o programa já foi salvo pelo menos uma vez (edição); no cadastro de um programa novo esse botão não é exibido, então a configuração de envio só pode ser feita depois de o programa existir. O botão Cancelar sempre volta para a listagem, sem pedir confirmação e sem salvar alterações. Modal de configuração de

Não Conformidade

Documentação Técnica Não Conformidade — Cadastros (Portal Easypac) A tela de Não Conformidade, no módulo de Cadastros, mantém o catálogo dos tipos de não conformidade que a operação de qualidade usa para classificar ocorrências. 01. VISÃO GERAL Visão Geral A tela de Não Conformidade, no módulo de Cadastros, mantém o catálogo dos tipos de não conformidade que a operação de qualidade usa para classificar ocorrências. Cada não conformidade cadastrada aqui define, para quem for registrar uma ocorrência desse tipo, se um plano de ação é obrigatório e se — e como — a seleção de uma ação corretiva, preventiva ou imediata é exigida. Esta tela apenas parametriza essas regras; o registro em campo das ocorrências de não conformidade é feito no APP, fora deste acervo. As não conformidades cadastradas aqui alimentam a listagem e a associação usadas pelas telas de Registros e de Planilhas do Portal. 02. PRÉ-REQUISITOS Pré-requisitos Se as configurações globais do cliente “exigir plano de ação padrão” e “exigir seleção de ação por padrão em nova não conformidade e planilhas” estiverem habilitadas os campos correspondentes ficam bloqueados; se as configurações globais estiverem desabilitadas, os campos de parâmetro são exibidos, inicialmente, desabilitados ou com valor “Não” (nenhuma exigência). Para vincular ações padrão a uma não conformidade, as ações correspondentes (Imediata, Corretiva ou Preventiva) precisam estar previamente cadastradas — sem ações cadastradas, o lookup “Ações Padrão” não retorna resultados para seleção. Uma não conformidade só pode ter a descrição alterada enquanto não estiver associada a nenhum item de planilha; uma vez utilizada em uma planilha, a descrição fica congelada (ver Regras de Negócio). 03. PERMISSÕES E PERFIS DE ACESSO Permissões e Perfis de Acesso A listagem de não conformidades só é exibida para usuários com permissão de visualizar não conformidades; sem essa permissão, tanto a tela de listagem quanto a grid retornada pelo servidor ficam indisponíveis. A abertura do formulário de cadastro de uma nova não conformidade exige permissão própria de inclusão; a edição de uma não conformidade existente — tanto a abertura da tela quanto a gravação — exige permissão própria de edição; a exclusão exige permissão própria de exclusão. Essas três permissões são independentes entre si: um usuário pode, por exemplo, visualizar e editar sem poder excluir. Perfil fiscal: não tem acesso à tela, ou seja, não pode realizar nenhuma das ações citadas anteriormente. A tela é liberada a todos os clientes conforme as permissões de papel acima, sem depender de um módulo opcional do contrato. A listagem principal de não conformidades não é filtrada por empresa: o filtro aplicado é apenas pelo texto pesquisado (Id ou Descrição). O lookup do cadastro de itens das Planilhas, exibe todas as não conformidades cadastradas para a base como um todo, independentemente da empresa. Já o lookup de não conformidades usado no filtro da tela de Registros é restrito às não conformidades associadas a registros dentro das Planilhas para os quais o usuário logado tem permissão de consulta. 04. FLUXO OPERACIONAL Fluxo Operacional A partir do menu Cadastros, o usuário acessa Não Conformidade e chega à listagem paginada. Para incluir, clica em “Novo” e é levado ao formulário de cadastro; para editar, seleciona uma linha e clica em “Editar” (ou dá duplo clique na linha) e é levado ao formulário já preenchido com os dados atuais. Após preencher os campos obrigatórios e salvar, o usuário é redirecionado de volta à listagem, que é recarregada. Para excluir, seleciona uma linha e clica em “Excluir”, confirma a remoção em um diálogo e, em caso de sucesso, a listagem é recarregada automaticamente. A não conformidade também pode ser cadastrada rapidamente, sem sair da tela de origem, por um popup acionado a partir de um campo de lookup em outra tela (Planilhas). 05. INTERFACE E COMPORTAMENTOS DA TELA Interface e Comportamentos da Tela Listagem de não conformidades com paginação no servidor A grid de não conformidades exibe as colunas Id e Descrição, com paginação e ordenação processadas no servidor. O tamanho de página padrão é de 20 registros, e a ordenação inicial é pela coluna Id em ordem decrescente. Apenas as colunas Id e Descrição são reconhecidas para ordenação; qualquer outro identificador de coluna enviado não altera a ordenação aplicada. Formulário de cadastro e edição de não conformidade O campo Descrição é de preenchimento obrigatório, tanto no formulário completo quanto no popup de cadastro rápido. O botão “Cancelar” retorna à listagem sem gravar nada. O envio do formulário só ocorre se a validação nativa do navegador for aprovada; os dados são então enviados ao servidor como JSON. Campo “Exige Plano Ação” bloqueado por configuração global Quando a configuração global “exigir plano de ação padrão” está ativa no menu Configurações, o campo “Exige Plano Ação” da não conformidade aparece marcado e fica desabilitado nesta tela — não pode ser desmarcado — com um aviso explicando que o parâmetro está ativo nas configurações globais. Campo “Exige a seleção de ação” (enumeração e bloqueio por configuração global) O campo “Exige a seleção de ação” tem três opções, com um texto de ajuda disponível em popup ao lado do campo: “Não” (nenhuma validação de seleção de ação é feita no app), “Pelo menos uma ação” (exige ao menos uma ação selecionada, quando existirem ações cadastradas para a não conformidade) e “Uma ação de cada tipo” (exige uma ação de cada tipo disponível — Imediata, Corretiva e Preventiva —, considerando apenas os tipos configurados para o item). Quando a configuração global equivalente (padrão para novas não conformidades de planilhas) está definida com um valor diferente de “Não”, este campo vem fixado nesse valor e fica desabilitado, com o mesmo aviso de bloqueio por configuração global usado no campo “Exige Plano Ação”. Lookup “Ações Padrão” na não conformidade O campo “Ações Padrão” é um lookup de múltipla seleção: a pesquisa busca ações corretivas por texto, e os valores já associados à não conformidade em edição são carregados automaticamente a partir do Id da não conformidade aberta. O campo aceita no máximo 20 ações selecionadas simultaneamente. Popup de cadastro rápido

Grupos

Documentação Técnica Grupos — Cadastros (Portal Easypac) A tela de Grupos, no módulo de Cadastros, mantém o cadastro de grupos de usuários, cada um podendo ficar vinculado a uma ou mais empresas ou permanecer sem nenhum vínculo (grupo “Geral”, visível a todos os usuários independentemente da empresa). 01. VISÃO GERAL Visão Geral A tela de Grupos, no módulo de Cadastros, mantém o cadastro de grupos de usuários, cada um podendo ficar vinculado a uma ou mais empresas ou permanecer sem nenhum vínculo (grupo “Geral”, visível a todos os usuários independentemente da empresa). A partir do cadastro salvo aqui, o próprio formulário de um grupo já existente permite vincular e desvincular usuários àquele grupo. Um grupo também pode estar associado à planos de ação do módulo de Melhoria Contínua. Cadastrar corretamente o vínculo de empresas de cada grupo é o que garante que apenas os usuários certos o enxerguem na listagem e possam vinculá-lo a si mesmos. 02. PRÉ-REQUISITOS Pré-requisitos Para que a tela de Grupos funcione plenamente, as seguintes condições precisam estar atendidas: Vincular um grupo a uma empresa exige que essa empresa já esteja cadastrada e vinculada ao usuário logado: a lista de empresas do filtro e do formulário vem desse vínculo; sem nenhuma empresa vinculada ao usuário logado, essas listas aparecem vazias. Não é obrigatório vincular o grupo a nenhuma empresa: um grupo pode ser salvo sem nenhum vínculo, tornando-se um grupo “Geral”, visível a todos os usuários. Vincular um usuário a um grupo (feito dentro do próprio formulário de edição do grupo) exige que o grupo já esteja salvo — o vínculo só fica disponível depois que o grupo existe — e que o usuário buscado pertença a pelo menos uma das empresas vinculadas ao grupo (ou a qualquer empresa, se o grupo for “Geral”). Excluir um grupo exige que não existam usuários vinculados a ele; havendo vínculo de usuário, a exclusão é bloqueada. 03. PERMISSÕES E PERFIS DE ACESSO Permissões e Perfis de Acesso A tela de Grupos não depende de nenhum módulo contratado opcional identificado na análise: ela integra o cadastro básico do sistema, liberado a todos os clientes, dependendo apenas das permissões de papel descritas a seguir. Papel: visualizar a listagem de grupos exige a permissão de visualizar grupo; abrir o formulário de cadastro de um grupo novo exige a permissão de novo grupo; abrir e salvar a edição de um grupo existente exige a permissão de editar grupo; excluir um grupo exige a permissão de excluir grupo. Perfil fiscal: não tem acesso à tela, ou seja, não pode adicionar novo, editar e nem excluir. Recorte de dados: a listagem só mostra um grupo quando ele é “Geral” (sem nenhuma empresa vinculada) ou quando TODAS as empresas vinculadas a ele estão entre as empresas às quais o usuário logado tem acesso; um grupo com pelo menos uma empresa vinculada fora do conjunto de empresas do usuário não aparece na listagem dele. O filtro de Empresa do painel só restringe ainda mais a listagem quando uma opção específica é selecionada. 04. FLUXO OPERACIONAL Fluxo Operacional O usuário chega à tela de Grupos pelo menu Cadastro > Grupos. Ao abrir, o portal monta a lista de empresas do filtro (empresas do usuário logado, mais a opção “Geral” no início, representando os grupos sem empresa) e carrega a grade, que busca os dados por uma chamada própria ao servidor. A partir daí o usuário pode: Pesquisar por empresa no painel de filtros (clicando em “Filtrar”), ou navegar pelas páginas da grade. Clicar em Novo para abrir o formulário de cadastro de um grupo novo, informar nome e descrição e, opcionalmente, vincular uma ou mais empresas, e salvar. Clicar em Editar (ou dar duplo clique na linha) para abrir um grupo existente, alterar nome, descrição e/ou as empresas vinculadas, e salvar. Dentro da edição de um grupo já existente, clicar em “Usuários” para abrir o modal de vínculo, buscar um usuário e vinculá-lo ao grupo, ou remover um vínculo já existente. Clicar em Excluir para remover um grupo, confirmando a exclusão quando solicitado. Clicar em Cancelar a qualquer momento, no formulário, para voltar à listagem sem gravar nada, preservando os filtros que estavam aplicados antes de abrir o formulário. 05. INTERFACE E COMPORTAMENTOS DA TELA Interface e Comportamentos da Tela Listagem de grupos — grade, filtro e ações A grade de grupos desta tela exibe as colunas ID, Nome e Descrição, com 20 registros por página e ordenação inicial pela coluna ID em ordem decrescente; a coluna Empresa não é exibida nesta grade. O painel de filtros (recolhido por padrão) tem apenas o campo Empresa, de seleção múltipla e sem busca por texto dentro da própria lista; as opções são todas as empresas do usuário logado, mais a opção “Geral” (representando os grupos sem empresa vinculada) inserida no início da lista. O filtro só passa a valer, recarregando a grade, quando o usuário clica no botão “Filtrar”. A grade oferece os botões Novo (abre o cadastro de um grupo novo) e Editar (abre o grupo selecionado); o duplo clique em uma linha também abre a edição. Antes de excluir um grupo pela grade, é exibido o diálogo de confirmação “Você está prestes a remover o grupo: {id} – {nome}”; a exclusão só é enviada ao servidor se o usuário confirmar. Após a exclusão bem-sucedida, a grade é recarregada e é exibida a notificação “Operação efetuada com sucesso.”; em caso de falha, é exibido o texto de erro devolvido pelo servidor ou, se esse texto não vier no formato esperado, o texto puro da resposta de erro. Formulário de cadastro e edição de grupo O mesmo formulário de Grupos atende tanto o cadastro de um grupo novo quanto a edição de um existente: se um identificador for informado na rota, o portal busca o grupo no servidor e preenche nome, descrição e empresas vinculadas; se não for informado, o formulário abre vazio. Os campos Nome (até 200 caracteres) e Descrição são de preenchimento obrigatório, validados no navegador antes

Locais

Documentação Técnica Locais — Cadastros (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. 01. VISÃO GERAL Visão Geral 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. 02. PRÉ-REQUISITOS 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. 03. PERMISSÕES E PERFIS DE ACESSO 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. 04. FLUXO OPERACIONAL 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. 05. INTERFACE E COMPORTAMENTOS DA TELA 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,

Funções

Documentação Técnica Funcoes — Cadastros (Portal Easypac) A tela de Funções, no módulo de Cadastros, mantém o cadastro das funções (papéis ou cargos) que podem ser atribuídas aos usuários do sistema, cada uma podendo ficar vinculada a uma ou mais empresas ou permanecer sem nenhum vínculo (função “geral”, visível a todos os usuários independentemente da empresa). 01. VISÃO GERAL Visão Geral A tela de Funções, no módulo de Cadastros, mantém o cadastro das funções (papéis ou cargos) que podem ser atribuídas aos usuários do sistema, cada uma podendo ficar vinculada a uma ou mais empresas ou permanecer sem nenhum vínculo (função “geral”, visível a todos os usuários independentemente da empresa). É a partir do cadastro salvo aqui que outras telas do sistema localizam funções para vincular a um usuário, seja consultando o identificador e o nome de uma função específica, seja obtendo a lista de funções disponíveis para um usuário determinado. Cadastrar corretamente o vínculo de empresas de cada função é o que garante que apenas os usuários certos a enxerguem na listagem e a tenham disponível nesses vínculos. 02. PRÉ-REQUISITOS Pré-requisitos Para que a tela de Funções funcione plenamente, as seguintes condições precisam estar atendidas: Vincular uma função a uma empresa exige que essa empresa já esteja cadastrada: a lista de empresas do formulário e do filtro vem do vínculo entre o usuário logado e as empresas já existentes; sem nenhuma empresa vinculada ao usuário logado, essas listas aparecem vazias. Não é obrigatório vincular a função a nenhuma empresa: uma função pode ser salva sem nenhum vínculo, tornando-se uma função “geral”, visível a todos os usuários. Vincular uma função a um usuário (feito em outra tela do sistema) exige que a função já esteja cadastrada aqui; este cadastro é, portanto, pré-requisito para qualquer tela que atribua função a usuário. 03. PERMISSÕES E PERFIS DE ACESSO Permissões e Perfis de Acesso A tela de Funções não depende de nenhum módulo contratado opcional identificado na análise: ela integra o cadastro básico do sistema, liberado a todos os clientes, dependendo apenas das permissões de papel descritas a seguir. Papel: visualizar a listagem de funções exige a permissão de visualizar função; abrir o formulário de cadastro de uma função nova exige a permissão de nova função; abrir e salvar a edição de uma função existente exige a permissão de editar função; excluir uma função exige a permissão de excluir função. Perfil fiscal: não tem acesso à tela, ou seja, não pode adicionar novo, editar e nem excluir. Recorte de dados: a listagem só mostra uma função quando TODAS as empresas vinculadas a ela estão entre as empresas às quais o usuário logado tem acesso; funções sem nenhuma empresa vinculada (funções “gerais”) aparecem para qualquer usuário, independentemente das empresas dele. O filtro de Empresa do painel só restringe ainda mais a listagem quando uma empresa específica (diferente da opção “Geral”) é selecionada. No servidor de aplicação (API), tanto o cadastro quanto a edição de uma função exigem apenas que o usuário esteja autenticado, sem exigência de papel específico nessa camada — o controle por permissão de negócio (nova função, editar função) é feito somente no Portal. Dois pontos de consulta desta tela — o que devolve identificador e nome de uma função pelo seu identificador, e o que lista as funções vinculáveis a um usuário — não exigem nenhuma permissão nem autenticação, diferente de todos os demais pontos de entrada desta função (ver o registro técnico de bugs desta feature). 04. FLUXO OPERACIONAL Fluxo Operacional O usuário chega à tela de Funções pelo menu Cadastro > Funções. Ao abrir, o portal monta a lista de empresas do filtro (empresas do usuário logado, mais a opção “Geral” no início) e carrega a grade, que busca os dados por uma chamada própria ao servidor. A partir daí o usuário pode: Pesquisar por texto livre ou por empresa no painel de filtros (clicando em “Filtrar”), ou navegar pelas páginas da grade. Clicar em Novo para abrir o formulário de cadastro de uma função nova, informar o nome e, opcionalmente, vincular uma ou mais empresas, e salvar. Clicar em Editar (ou dar duplo clique na linha) para abrir uma função existente, alterar o nome e/ou as empresas vinculadas, e salvar. Clicar em Excluir para remover uma função, confirmando a exclusão quando solicitado. Clicar em Cancelar a qualquer momento, no formulário, para voltar à listagem sem gravar nada. 05. INTERFACE E COMPORTAMENTOS DA TELA Interface e Comportamentos da Tela Listagem de funções — grade, filtro e ações A grade de funções desta tela exibe as colunas Identificador e Nome, com 20 registros por página e ordenação inicial pela coluna Identificador em ordem decrescente; as únicas colunas que aceitam ordenação por clique são Identificador e Nome — qualquer outro valor de coluna não altera a ordenação atual, e sem nenhuma coluna informada a consulta não aplica ordenação explícita. A busca livre da grade filtra pelo identificador exato quando o texto digitado é um número inteiro; caso contrário, filtra pelas funções cujo nome contém o texto digitado. Essa busca só dispara uma nova consulta ao servidor a partir de 3 caracteres digitados, ao apertar Enter ou ao limpar o campo, com uma espera de 500ms após o usuário parar de digitar. O painel de filtros desta tela tem apenas o campo Empresa, de seleção múltipla, com busca habilitada dentro da própria lista (ignorando acentuação e diferença entre maiúsculas e minúsculas) e inicia recolhido. As alterações no campo Empresa só passam a valer, recarregando a grade, quando o usuário clica no botão “Filtrar” — mudar o campo sem clicar em “Filtrar” não afeta a listagem. Os valores aplicados ficam guardados no navegador durante a sessão e são restaurados automaticamente ao voltar para a listagem vindo do cadastro ou da edição. A grade oferece os botões Novo (abre o cadastro de uma função nova), Editar (abre a função selecionada) e Excluir (remove a função selecionada); o duplo clique em uma linha também abre a edição. Antes de excluir, a tela pede a

Atualização Aplicativo EasyPAC – 11.0.0

Versão com otimização da câmera, validação de evidências obrigatórias, marcação em massa de itens “NA” e novo layout informações do dispositivo.