📋 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 <> LanInformadosó deve disparar quando os totais lógicos divergirem. - Validação: Título da lista usa
logicalEntryCountquando 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