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.

• 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).

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.

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).

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 de não conformidade

Aberto a partir de um campo de lookup em outra tela, o popup exige apenas o preenchimento da Descrição. Ao ser aberto, ele pré-preenche (de forma oculta, sem exibir o campo) o valor de “Exige a seleção de ação” com a configuração global; se a não conformidade for salva com sucesso, ela é atribuída automaticamente ao campo de lookup que originou o popup, e o popup se fecha.

Ao gravar uma não conformidade, o servidor recebe o Id enviado pelo Portal e decide entre inserir e editar por esse valor: Id igual a 0 significa inserção; qualquer outro valor significa edição de um registro existente. Tanto o cadastro quanto a edição, no Portal, chamam o mesmo método de serviço e enviam os dados ao mesmo ponto do servidor, que decide internamente qual caminho seguir.

Na inserção, o servidor valida a duplicidade de descrição contra as não conformidades já existentes. Após inserir, o servidor reconsulta o banco filtrando pela mesma descrição para obter o Id gerado, em vez de usar diretamente o Id retornado pela camada de acesso a dados.

Na edição, o servidor busca a não conformidade pelo Id recebido, verifica se ela está associada a algum item de planilha e, em caso positivo, só bloqueia a gravação se a descrição enviada for diferente da descrição atual — os demais campos (exigir plano de ação, exigir seleção de ação, ações padrão) continuam editáveis mesmo quando a não conformidade já está em uso. A edição também valida duplicidade de descrição contra as demais não conformidades cadastradas.

Na exclusão, o servidor verifica primeiro se a não conformidade existe e, em seguida, se ela está associada a algum item de planilha, antes de efetivamente remover o registro.

Na busca da listagem, o servidor decide o filtro pelo conteúdo digitado: se o texto for numérico, filtra por Id igual ao número; caso contrário, filtra por Descrição contendo o texto. No lookup usado pela pesquisa de ações padrão, a mesma lógica se aplica — texto numérico filtra por Id; texto não numérico busca por descrição resumida, descrição completa, pela palavra “produto” ou “processo” conforme o tipo da ação, ou pela sigla do tipo (começando com o texto digitado). Para montar a lista de ações já associadas a uma não conformidade, o servidor lê a lista de identificadores gravada com a não conformidade, converte cada valor válido para número inteiro e retorna apenas as ações corretivas cujo identificador conste dessa lista; valores não numéricos na lista são ignorados silenciosamente.

No lookup de não conformidades usado pelas telas de Registros e Planilhas, o servidor restringe o resultado às não conformidades associadas a registros dentro das Planilhas para os quais o usuário logado tem permissão de consulta, filtra ainda pela empresa e pelo intervalo de datas informado e, quando uma lista de códigos de planilha é informada, restringe o resultado a esses códigos; adicionalmente é possível buscar por Id ou por Descrição. Esse lookup pagina manualmente em memória, conforme início e tamanho enviados, e ordena o resultado pela Descrição.

• Ao inserir uma não conformidade, se já existir outra com a mesma descrição — comparação feita após remover espaços das pontas — a inserção é rejeitada. A mesma verificação de duplicidade se aplica à edição, comparando com as demais não conformidades cadastradas.
• Uma não conformidade associada a algum item de planilha não pode mais ter a descrição alterada; os demais campos (exigir plano de ação, exigir seleção de ação, ações padrão) continuam editáveis normalmente.
• Uma não conformidade não pode ser excluída se já existir algum registro (item de planilha) atribuído a ela.
• O campo “Exige a seleção de ação” aceita três valores com o seguinte significado de negócio: “Não” — nenhuma validação de seleção de ação é exigida no app; “Pelo menos uma ação” — exige ao menos uma ação selecionada, desde que existam ações cadastradas para a não conformidade; “Uma ação de cada tipo” — exige uma ação de cada tipo disponível (Imediata, Corretiva e Preventiva), considerando somente os tipos configurados para o item.
• Quando a configuração global “exigir plano de ação padrão” está ativa para o cliente, toda não conformidade cadastrada ou editada nesta tela tem o campo “Exige Plano Ação” fixado como verdadeiro, sem possibilidade de alteração pelo usuário. Quando a configuração global equivalente para “exigir seleção de ação” está definida com valor diferente de “Não”, toda não conformidade tem o campo “Exige a seleção de ação” fixado nesse mesmo valor, também sem possibilidade de alteração pelo usuário.
• O campo “Ações Padrão” aceita no máximo 20 ações selecionadas por não conformidade; essa validação ocorre no navegador, antes de qualquer chamada ao servidor.
• Antes de enviar o formulário ao servidor, o Portal converte o campo “Exige Plano Ação” de caixa de marcação para verdadeiro ou falso, converte “Exige a seleção de ação” para número inteiro (assumindo 0, equivalente a “Não”, quando vazio) e converte as ações padrão selecionadas em uma lista de identificadores separada por vírgula.
• Na listagem de ações do lookup “Ações Padrão”, a sigla do tipo de ação só é exibida se o tipo de ação correspondente estiver ativo; caso contrário, a sigla vem em branco.

T-01 — Não é possível salvar a não conformidade: descrição já cadastrada

Cenário: o usuário tenta cadastrar ou editar uma não conformidade com uma descrição igual à de outra já existente (após remover espaços das pontas).

Mensagem exibida: “400 >> Já existe uma não conformidade com a descrição \”{descrição}”.

O que fazer: usar uma descrição diferente ou localizar e reaproveitar a não conformidade já cadastrada com essa descrição.

T-02 — Não é possível alterar a descrição de uma não conformidade já utilizada em planilha

Cenário: o usuário edita uma não conformidade que já está associada a algum item de planilha e tenta gravar uma descrição diferente da atual.

Mensagem exibida: “Não foi possivel alterar a não conformidade pois já se encontra atribuida”

O que fazer: manter a descrição original; os demais campos (exigir plano de ação, exigir seleção de ação, ações padrão) podem ser alterados normalmente. Para mudar a descrição, é necessário cadastrar uma nova não conformidade.

T-03 — Não é possível excluir a não conformidade: já existem registros atribuídos

Mensagem exibida: “500 >> Não é possível excluir esta não conformidade, pois já existem registros atribuídos para ela.”

O que fazer: informar ao responsável que a não conformidade está em uso em planilhas e não pode ser removida; se necessário, apenas desativar o uso futuro (ex.: não selecioná-la como ação padrão) em vez de excluir.

T-04 — Erro ao excluir uma não conformidade que não existe mais

Cenário: o usuário tenta excluir uma não conformidade cujo Id não é encontrado no momento da exclusão (por exemplo, já removida por outro usuário).

Mensagem exibida: “401 >> Não confomidade não encontrado.”

O que fazer: atualizar a listagem e confirmar se o registro ainda existe antes de tentar novamente.

T-05 — Alerta ao selecionar mais de 20 ações padrão

Mensagem exibida: “Não foi possível concluir a operação. O campo \”Ações Padrão\” permite a seleção de até 20 ações. Quantidade selecionada: {n}. Remova uma ou mais ações e tente novamente.”

O que fazer: remover ações da seleção até restarem no máximo 20 e salvar novamente.

T-06 — Campo “Exige Plano Ação” aparece marcado e não pode ser desmarcado

Cenário: o cliente tem a configuração global “exigir plano de ação padrão” ativa.

Mensagem exibida: “Não é possível alterar este parâmetro pois ele se encontra ativo nas configurações globais.”

O que fazer: explicar que o comportamento é esperado; para liberar o campo, a configuração global precisa ser desativada por quem administra as configurações do cliente.

T-07 — Campo “Exige a seleção de ação” vem fixado e não pode ser alterado

Cenário: o cliente tem a configuração global de exigência de seleção de ação (padrão para novas não conformidades de planilhas) definida com um valor diferente de “Não”.

Mensagem exibida: “Não é possível alterar este parâmetro pois ele se encontra ativo nas configurações globais.”

O que fazer: mesmo tratamento do campo “Exige Plano Ação” — o valor só muda por não conformidade se a configuração global for ajustada.

T-08 — Opção de Não Conformidade não aparece no menu ou não abre

Cenário: o usuário não enxerga a listagem de não conformidades, ou a tela abre em branco.

Mensagem exibida: Nenhuma — o item de menu simplesmente não é exibido, ou a listagem retorna vazia.

O que fazer: confirmar se o usuário tem a permissão de visualizar não conformidades; sem ela, tanto o menu quanto os dados da grid ficam indisponíveis.

T-09 — Botão “Novo” não aparece ou o cadastro não é permitido

Mensagem exibida: Nenhuma — o botão de inclusão fica indisponível ou a tela de cadastro não abre.

O que fazer: confirmar se o usuário tem a permissão específica de inclusão de não conformidades.

T-10 — Botão “Editar” não aparece ou a edição não é permitida

Mensagem exibida: Nenhuma — o botão de edição fica indisponível ou a tela de edição não abre, mesmo com uma linha selecionada.

O que fazer: confirmar se o usuário tem a permissão específica de edição de não conformidades.

T-11 — Botão “Excluir” não aparece ou a exclusão não é permitida

Mensagem exibida: Nenhuma — o botão de exclusão fica indisponível.

O que fazer: confirmar se o usuário tem a permissão específica de exclusão de não conformidades.

Caso 1 — Cadastro de não conformidade com plano de ação obrigatório

Um usuário com permissão de inclusão cadastra a não conformidade “Produto fora da temperatura ideal”, vinculando duas ações padrão de tipo Corretiva. Como o cliente tem a configuração global “exigir plano de ação padrão” ativa, o campo “Exige Plano Ação” já vem marcado e desabilitado. O usuário salva e recebe “Operação efetuada com sucesso.”, sendo redirecionado à listagem, que agora mostra a não conformidade recém-criada.

Caso 2 — Tentativa de alterar a descrição de uma não conformidade já usada em planilha

Um usuário edita a não conformidade “Embalagem danificada”, já associada a registros de planilha, e tenta mudar a descrição para “Embalagem violada”. Ao salvar, o sistema rejeita a alteração com “Não foi possivel alterar a não conformidade pois já se encontra atribuida”. O usuário desfaz a mudança de descrição, ajusta apenas o campo “Exige a seleção de ação” para “Pelo menos uma ação” e salva com sucesso.

Caso 3 — Cadastro rápido de não conformidade a partir da tela de Planilhas

Durante o cadastro de itens da planilha, o usuário não encontra a não conformidade desejada no lookup e abre o popup de cadastro rápido, informando apenas a descrição “Ausência de identificação do lote”. Ao confirmar, a não conformidade é criada, atribuída automaticamente ao campo de lookup de origem, e o popup se fecha — sem que o usuário precise sair da tela de Planilhas.

Caso 4 — Exclusão bloqueada por não conformidade em uso

Um usuário com permissão de exclusão tenta remover a não conformidade, mas ela já está associada a itens de planilha. O sistema exibe “500 >> Não é possível excluir esta não conformidade, pois já existem registros atribuídos para ela.” e a exclusão não é realizada; a não conformidade permanece na listagem.