Pular para conteúdo

📋 Regras de Negócio - ecosif-angular

📋 Visão Geral

Este documento descreve as principais regras de negócio implementadas no frontend ecosif-angular.


🔐 Regras de Autenticação

Login

  • Regra: Usuário deve estar autenticado para acessar rotas protegidas
  • Validação: AuthGuard verifica token antes de permitir acesso
  • Regra: Token expira após período definido
  • Validação: Interceptor renova token automaticamente

Controle de Acesso

  • Regra: Usuário só vê rotinas permitidas
  • Validação: Verificação de acesso baseada em grupos/rotinas
  • Regra: Menu dinâmico baseado em permissões
  • Validação: Carregamento de rotinas permitidas

💰 Regras de Lançamentos Contábeis

Validação de Partida Dobrada

  • Regra: Débito = Crédito (obrigatório)
  • Validação: Validação em tempo real no formulário
  • Regra: Pelo menos 2 movimentações (débito e crédito)
  • Validação: Validação antes de salvar

Contagem lógica vs linhas D/C (MOV-01 / MOV-03)

  • Regra: "Lançamentos (N)", "Lanç. Informados" e "Lanç. Digitados" usam códigos distintos (lancamento), não o número de linhas físicas D/C.
  • Regra: Tipo 2 (contrapartida) = 1 lançamento lógico = 2 linhas na grade detalhada.
  • Regra: Alerta de consolidação LanDigitado <> LanInformado só deve disparar quando os totais lógicos divergirem.
  • Validação: Título da lista usa logicalEntryCount quando a API envia o campo (fallback: totalElements).

Datas

  • Regra: Data de lançamento dentro do período aberto
  • Validação: Verificação de calendário contábil
  • Regra: Data não pode ser futura
  • Validação: Validação de data máxima

📊 Regras de Consultas

Período

  • Regra: Período obrigatório para consultas
  • Validação: Validação de campos de data
  • Regra: Data início <= Data fim
  • Validação: Validação de intervalo

Filtros

  • Regra: Pelo menos um filtro aplicado
  • Validação: Validação antes de consultar
  • Regra: Empresa/Filial obrigatória em algumas consultas
  • Validação: Validação de campos obrigatórios

📄 Regras de Relatórios

Parâmetros

  • Regra: Parâmetros obrigatórios devem ser preenchidos
  • Validação: Validação de formulário antes de gerar
  • Regra: Período válido para relatórios
  • Validação: Verificação de datas

🏢 Regras de Empresa

Mês/Ano Abertura (criação com opções automáticas)

  • Regra: Com “Criar automaticamente filial e Opções da Empresa”, o Mês/Ano Abertura (MM/AAAA) é obrigatório.
  • Efeito (backend masterdata):
  • Mes/Ano Base = abertura
  • Mes/Ano Atual (competência) = abertura
  • Mes/Ano Balanço e Encerramento = 12/{ano corrente}
  • Calendários abertos da abertura até o encerramento
  • Validação: formato MM/AAAA; campo exigido só com o checkbox ativo

👥 Regras de Usuários

Validação

  • Regra: CPF/CNPJ válidos quando aplicável
  • Validação: Validação via services especializados
  • Regra: Email único
  • Validação: Verificação de duplicidade

Última Atualização: 2026-08-21