> ## Documentation Index
> Fetch the complete documentation index at: https://docs.domsoftware.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Login e Empresas (Funcional)

> Login e Cadastro de Empresas

# 📌 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.