Skip to main content

​
📌 Visão Geral

  • Nome da funcionalidade: Login e Gestão de Empresas (OmniDom)
  • Objetivo principal: Autenticação de usuários no painel BackOffice e administração completa de unidades de negócio (empresas).
  • Perfil de usuário: Administradores do sistema e gestores de BackOffice.
  • Pré-requisitos de acesso: Credenciais cadastradas (E-mail e Senha) e permissão de acesso ao módulo BackOffice.

​
🔢 Passo a Passo

​
Fluxo 1: Login no Sistema

Passo 1: Identificação
  • O usuário vê os campos de E-mail e Senha.
  • O usuário deve preencher suas credenciais.
  • Observação: Se a senha for menor que 8 caracteres, uma mensagem de erro vermelha aparece abaixo do campo: “A senha deve ter no mínimo 8 caracteres”.
  • Resultado esperado: Acesso ao Dashboard “Visão Geral Operacional” ao clicar em “Entrar na Plataforma”.

​
Fluxo 2: Gestão de Empresas (Listagem e Navegação)

Passo 1: Acesso ao Módulo
  • O usuário acessa a tela “Gestão de Empresas” através do menu lateral.
  • O sistema exibe quatro abas principais:
    • Lista Geral: Visualização em cartões das empresas cadastradas.
    • Dados Fiscais: Status do regime tributário e certificados.
    • Contatos: Tabela com responsáveis e dados de comunicação.
    • Logística: Configurações de malha logística e vínculos de estoque.
  • Resultado esperado: Exibição detalhada das unidades de negócio.
Passo 2: Gestão de Status (Ativar/Desativar)
  • No cartão da empresa, o usuário clica no toggle de status (canto superior direito).
  • O sistema solicita confirmação para desativar ou ativar a unidade.
  • Resultado esperado: Alteração imediata da disponibilidade da empresa no sistema.

​
Fluxo 3: Cadastro de Nova Empresa

Passo 1: Dados Básicos
  • Clique no botão ”+ Nova Empresa”.
  • Preencha: Nome da Empresa (mínimo 3 caracteres), CNPJ e E-mail de Contato.
  • Clique em “Próximo”.
Passo 2: Endereço (Localização)
  • Informe o CEP para preenchimento automático de Logradouro, Bairro e Cidade.
  • Insira o Número e Complemento.
  • Clique em “Próximo”.
Passo 3: Configurações Tributárias e Responsável
  • Selecione o Regime Tributário (ex: Simples Nacional) e o Método de Custo.
  • Preencha os dados do Responsável Direto (Nome Completo, Telefone e Cargo).
  • Clique em “Próximo”.
Passo 4: Certificado Digital
  • Área destinada ao upload do certificado tipo A1 (extensões .pfx ou .p12).
  • Esta etapa pode ser ignorada clicando em “Próximo” se o certificado não estiver disponível no momento.
Passo 5: Revisão e Finalização
  • Resumo visual de todas as etapas anteriores para conferência.
  • Clique em “Finalizar Cadastro” para salvar no banco de dados.
  • Atenção: Se houver falha de validação no servidor, uma mensagem “BAD Request” será exibida.

​
📋 Regras de Negócio

  • RN01: Formato de Senha
    • Descrição: Validação de segurança básica na entrada.
    • Condição: No momento do login.
    • Comportamento: Impede o login e exibe alerta se a senha tiver menos de 8 caracteres.
  • RN02: Nome Comercial Obrigatório
    • Descrição: Garantia de identificação da empresa.
    • Condição: No cadastro ou edição de dados básicos.
    • Comportamento: Bloqueia o avanço com erro “Nome deve ter pelo menos 3 caracteres”.
  • RN03: Certificado Digital Tipo A1
    • Descrição: Requisito para integração fiscal (NF-e/SEFAZ).
    • Condição: Necessário para operação completa, mas opcional no fluxo inicial de cadastro.
  • RN04: Vinculação de Estoque (Malha Logística)
    • Descrição: Permite que empresas compartilhem o mesmo estoque físico.
    • Condição: Na aba de Logística, clicando em “Vínculos”.
    • Comportamento: Abre modal para seleção de outras unidades de negócio vinculadas.
  • RN05: Configuração de ICMS
    • Descrição: Definição de regras tributárias para o motor de cálculos.
    • Condição: Visualizado em “Dados Fiscais” -> “ICMS”.
    • Comportamento: Quando em Simples Nacional, os cálculos de substituição tributária são ajustados automaticamente.

​
✅ Critérios de Aceitação

  • CA01: Login Exitoso
    • Dado que: o usuário preenche e-mail e senha corretos.
    • Quando: clica em “Entrar na Plataforma”.
    • Então: o sistema carrega o Dashboard de Visão Geral.
    • Status: Visível nas telas.
  • CA02: Validação de Erro no Servidor
    • Dado que: o usuário preenche dados inconsistentes no cadastro.
    • When: clica em “Finalizar Cadastro”.
    • Então: o sistema deve exibir o erro retornado pelo servidor (ex: “BAD Request”).
    • Status: Visível nas telas.
  • CA03: Atualização de Dados da Empresa
    • Dado que: o usuário editou informações de uma empresa existente.
    • Quando: clica em “Gravar Alterações” (ou similar na revisão).
    • Then: a mensagem “Empresa atualizada com sucesso!” deve ser exibida.
    • Status: Visível nas telas.
  • CA04: Busca por Cadastro
    • Dado que: o usuário está na listagem de empresas.
    • Quando: digita o nome parcial ou CNPJ no campo de busca.
    • Então: a lista deve filtrar em tempo real as empresas correspondentes.
    • Status: Inferido/Visível (campo de busca presente).

​
⚠️ Pontos de Atenção

  • Campos Obrigatórios (*): Nome, CNPJ, E-mail, CEP e Telefone do Responsável são essenciais.
  • Mensagens de Status: Sempre observe as notificações no canto inferior direito para verificar se as operações de gravação ou desativação foram concluídas.

​
💡 Dicas para o Usuário

  • Economia de Tempo: Ao inserir o CEP, espere o sistema carregar o endereço automaticamente antes de digitar o número.
  • Gestão Fiscal: Mantenha os certificados A1 sempre atualizados para evitar interrupções na emissão de notas fiscais.