📊 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

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

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