Pular para conteúdo

📊 Visão Geral Funcional - ecosif-angular

📋 Sobre o Projeto

ecosif-angular é a interface web responsiva do sistema eCosif. Uma Single Page Application (SPA) construída com Angular 14 que fornece todas as funcionalidades de gestão contábil, consultas, relatórios e administração através de uma interface moderna e intuitiva.


🎯 Objetivo da Aplicação

Fornecer uma interface web completa e responsiva para o sistema eCosif, permitindo que usuários:

  • ✅ Gerenciem dados contábeis de forma eficiente
  • ✅ Visualizem informações em dashboards interativos
  • ✅ Gerem relatórios contábeis
  • ✅ Administrem o sistema e usuários
  • ✅ Validem conformidade contábil

🏢 Contexto no Sistema eCosif

O ecosif-angular é o frontend do ecossistema eCosif, interagindo com todos os microserviços backend:

  • ecosif-auth (8080) - Autenticação e autorização
  • ecosif-masterdata (8081) - Dados mestres (empresas, planos de contas)
  • ecosif-moviments (8082) - Lançamentos contábeis
  • ecosif-querys (8083) - Consultas otimizadas
  • ecosif-reports (8084) - Geração de relatórios
  • ecosif-compliance (8021) - Validação de conformidade

📦 Funcionalidades Principais

1. Autenticação e Segurança

  • ✅ Login local - Usuário/senha com JWT
  • ✅ Login Azure AD - Integração MSAL
  • ✅ Renovação automática de tokens
  • ✅ Proteção de rotas com AuthGuard
  • ✅ Controle de acesso por rotinas

2. Dashboard Executivo

  • ✅ Dashboard interativo com gráficos
  • ✅ Indicadores principais (KPIs)
  • ✅ Cards de resumo de informações
  • ✅ Visualizações com Chart.js

3. Gestão de Cadastros

Empresas e Filiais

  • ✅ CRUD completo de empresas
  • ✅ CRUD completo de filiais
  • ✅ Integração com CNPJ/CEP
  • ✅ Configurações de empresas

Planos de Contas

  • ✅ Visualização hierárquica
  • ✅ Edição de contas
  • ✅ Plano de contas referencial
  • ✅ Cópia e importação de planos

Configurações

  • ✅ Históricos padrão
  • ✅ Tipos de fundo
  • ✅ Configurações de fundos
  • ✅ Calendário contábil

4. Lançamentos Contábeis

  • ✅ Criação manual de lançamentos
  • ✅ Validação de partida dobrada
  • ✅ Importação de arquivos IPL
  • ✅ Lotes contábeis
  • ✅ Lançamentos padrão
  • ✅ Consolidação contábil

5. Consultas e Análises

  • ✅ Consulta de saldos por conta
  • ✅ Razão geral de contas
  • ✅ Listagem de lançamentos com filtros
  • ✅ Filtros avançados por período, empresa, filial

6. Relatórios

  • ✅ Balancetes (geral, mensal, diário)
  • ✅ Balanço patrimonial
  • ✅ Razão contábil
  • ✅ Relatório 4010/16
  • ✅ Relatórios combinados
  • ✅ Download em PDF

7. Administração

  • ✅ Gestão de usuários (CRUD)
  • ✅ Gestão de grupos
  • ✅ Gestão de rotinas
  • ✅ Controle de acesso a rotinas
  • ✅ Configurações do sistema

8. Compliance

  • ✅ Validação de conformidade
  • ✅ Gestão de regras de validação
  • ✅ Visualização de resultados

9. Configuração Dinâmica

  • ✅ AppConfigService - Configuração em runtime
  • ✅ Um build para múltiplos ambientes
  • ✅ Docker configurável via .env
  • ✅ Zero rebuild necessário

📊 Estatísticas da Aplicação

  • ~200 componentes totais
  • ~87 páginas funcionais
  • 41 services HTTP
  • 60+ rotas configuradas
  • 27 modelos/interfaces TypeScript
  • 3 módulos lazy-loaded

🎓 Público-Alvo

Usuários Finais

  • Contadores - Gestão contábil diária
  • Analistas Contábeis - Lançamentos e consultas
  • Gestores Financeiros - Dashboards e relatórios
  • Auditores - Validação e compliance
  • Administradores - Configuração do sistema

Perfis de Acesso

  • Administrador - Acesso completo
  • Usuário - Acesso baseado em rotinas
  • Visualizador - Apenas consultas e relatórios

🔄 Fluxos Principais

Fluxo de Trabalho Contábil

1. Login no sistema
   ↓
2. Selecionar empresa/filial
   ↓
3. Abrir período contábil
   ↓
4. Criar/importar lançamentos
   ↓
5. Validar partida dobrada
   ↓
6. Processar consolidação
   ↓
7. Gerar relatórios
   ↓
8. Validar conformidade

📱 Plataformas Suportadas

  • ✅ Desktop - Chrome, Firefox, Edge, Safari
  • ✅ Tablet - Design responsivo
  • ✅ Mobile - Interface adaptável

🌟 Diferenciais

  1. Interface Moderna - CoreUI + Bootstrap 5
  2. Responsivo - Funciona em todos os dispositivos
  3. Performance - Lazy loading e otimizações
  4. Configurável - Um build para múltiplos ambientes
  5. Integração Azure - Autenticação via Azure AD
  6. Gráficos Interativos - Chart.js para visualizações

Última Atualização: 2025-12-01