📐 Camadas - ecosif-angular

📋 Visão Geral

Este documento detalha a arquitetura em camadas do ecosif-angular, explicando responsabilidades e interações entre as camadas.

🏗️ Camadas da Aplicação

1. Camada de Apresentação (Presentation Layer)

Responsabilidades

• ✅ Renderização da interface do usuário
• ✅ Captura de interações do usuário
• ✅ Validação de formulários (template-driven e reactive)
• ✅ Exibição de dados formatados

Componentes

src/app/
├── pages/                    # ~87 componentes de páginas
│   ├── login/
│   ├── dashboard/
│   ├── companydetails/
│   └── ...
├── views/                    # Views lazy-loaded
│   ├── dashboard/
│   ├── base/
│   └── notifications/
├── containers/               # Layout containers
│   └── default-layout/
└── shared/components/        # Componentes reutilizáveis

Padrões

• Smart/Dumb Components - Separação de lógica e apresentação
• Component Communication - @Input/@Output, Services
• Change Detection - OnPush onde possível

2. Camada de Aplicação (Application Layer)

Responsabilidades

• ✅ Lógica de negócio da aplicação
• ✅ Comunicação HTTP com backends
• ✅ Transformação de dados (DTO ↔ Model)
• ✅ Gerenciamento de estado
• ✅ Validações de negócio

Services

src/app/service/
├── auth.service.ts           # Autenticação
├── company.service.ts        # Empresas
├── chartofaccount.service.ts # Planos de contas
├── entries.service.ts        # Lançamentos
├── balanceinquiry.service.ts # Consultas
├── relatorios.service.ts     # Relatórios
└── ... (41 services)

Padrões

• Injectable Root - providedIn: 'root'
• Observable-based - RxJS para assíncrono
• Error Handling - Try/catch + error callbacks

3. Camada de Infraestrutura (Infrastructure Layer)

Responsabilidades

• ✅ Configuração da aplicação
• ✅ Interceptação de requisições HTTP
• ✅ Proteção de rotas
• ✅ Gerenciamento de erros globais
• ✅ Logging e monitoramento

Componentes

src/app/
├── core/
│   ├── config/               # AppConfigService
│   ├── services/             # Core services
│   └── validators/           # Validadores customizados
├── guard/
│   └── auth.guard.ts         # Route guard
├── interceptor/
│   └── auth.interceptor.ts   # HTTP interceptor
└── custom_exception/         # Exception handling

4. Camada de Dados (Data Layer)

Responsabilidades

• ✅ Definição de modelos/interfaces
• ✅ Tipagem TypeScript
• ✅ Validação de estruturas de dados

Models

src/app/model/
├── user.ts
├── company.detail.ts
├── chartofaccount.ts
├── entries.ts
└── ... (27 models)

🔄 Fluxo de Dados entre Camadas

Exemplo: Buscar Empresas

┌─────────────────────────────────────────┐
│  1. Presentation Layer                  │
│     CompanydetailsComponent             │
│     • ngOnInit()                        │
│     • Template chama service            │
└──────────────────┬──────────────────────┘
                   │
                   │ this.companyService.getCompanies()
                   ▼
┌─────────────────────────────────────────┐
│  2. Application Layer                   │
│     CompanyService                      │
│     • getCompanies(): Observable        │
│     • Faz requisição HTTP               │
└──────────────────┬──────────────────────┘
                   │
                   │ this.http.get<Company[]>(url)
                   ▼
┌─────────────────────────────────────────┐
│  3. Infrastructure Layer                │
│     AuthInterceptor                     │
│     • Adiciona token JWT                │
│     • Adiciona headers                  │
└──────────────────┬──────────────────────┘
                   │
                   │ HTTP Request
                   ▼
┌─────────────────────────────────────────┐
│  4. Backend Service                     │
│     ecosif-masterdata                   │
│     • Processa requisição               │
│     • Retorna dados                     │
└──────────────────┬──────────────────────┘
                   │
                   │ HTTP Response
                   ▼
┌─────────────────────────────────────────┐
│  3. Infrastructure Layer (retorno)      │
│     • Interceptor processa response     │
│     • Error handling se necessário      │
└──────────────────┬──────────────────────┘
                   │
                   │ Observable<Company[]>
                   ▼
┌─────────────────────────────────────────┐
│  2. Application Layer (retorno)         │
│     CompanyService                      │
│     • Transforma dados se necessário    │
│     • Retorna Observable                │
└──────────────────┬──────────────────────┘
                   │
                   │ Observable<Company[]>
                   ▼
┌─────────────────────────────────────────┐
│  1. Presentation Layer (retorno)        │
│     CompanydetailsComponent             │
│     • Atualiza propriedades             │
│     • UI atualiza via bindings          │
└─────────────────────────────────────────┘

🎯 Princípios de Separação

Single Responsibility

Cada camada tem uma responsabilidade única:

• Presentation: UI e interação
• Application: Lógica de negócio
• Infrastructure: Configuração e infraestrutura
• Data: Estruturas de dados

Dependency Inversion

Camadas superiores dependem de abstrações:

// Component depende de Service (abstração)
constructor(private service: CompanyService) {}

// Service depende de HttpClient (abstração)
constructor(private http: HttpClient) {}

📊 Resumo de Camadas

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