🔌 Services HTTP - ecosif-angular

📋 Visão Geral

Este documento lista todos os services HTTP da aplicação ecosif-angular, organizados por funcionalidade.


📊 Estatísticas


🔧 Services por Categoria

Autenticação e Segurança

Service Descrição Endpoints Principais
AuthService Autenticação e gerenciamento de usuário /api/auth/signin, /user
TokenService Gerenciamento de tokens JWT -
AccessControlService Controle de acesso a rotinas /useraccess/:id

Cadastros Mestres

Service Descrição Backend
CompanyService Gestão de empresas ecosif-masterdata
ChartOfAccountService Plano de contas ecosif-masterdata
ReferenceChartOfAccountService Plano de contas referencial ecosif-masterdata
HistoryService Históricos padrão ecosif-masterdata
FundTypeService Tipos de fundo ecosif-masterdata
FundSettingService Configurações de fundos ecosif-masterdata
CompanyOptionService Opções da empresa ecosif-masterdata

Movimentações Contábeis

Service Descrição Backend
CreateEntriesService Criar lançamentos ecosif-moviments
BatchEntryService Lotes contábeis ecosif-moviments
ConsolidationCalendarService Calendário de consolidação ecosif-moviments
StandardReleaseService Lançamentos padrão ecosif-moviments
SendReturnHistoricalDataService Enviar/retornar dados históricos ecosif-moviments

Consultas e Relatórios

Service Descrição Backend
BalanceInquiryService Consulta saldo/razão ecosif-querys
RelatoriosService Geração de relatórios ecosif-reports
DailyReportService Relatório diário ecosif-reports
TermReportService Relatórios de termos ecosif-reports

Calendário e Períodos

Service Descrição Backend
CalendarService Calendário contábil ecosif-masterdata
MonthOpeningService Abertura de mês ecosif-masterdata
DailyClosingService Encerramento diário ecosif-moviments
ClosureService Encerramentos ecosif-masterdata
ClosureSettingsService Configuração de encerramento ecosif-masterdata

Administração

Service Descrição Backend
UserService Gestão de usuários ecosif-masterdata
UserSettingService Configurações de usuário ecosif-masterdata
GroupService Gestão de grupos ecosif-masterdata
RoutineService Rotinas do sistema ecosif-masterdata
RoutineAccessControlService Controle de acesso ecosif-masterdata

Compliance

Service Descrição Backend
ComplianceService Compliance (legado) ecosif-compliance
ComplianceService (feature) Compliance (novo módulo) ecosif-compliance

Utilidades

Service Descrição Backend
AutoCompleteService Autocomplete -
AddressService Consulta de endereços (CEP) ViaCEP API
ValidateCPFService Validação de CPF -
ValidateCNPJService Validação de CNPJ -
HeaderService Configurações de cabeçalho -
DockerLogsService Visualização de logs Docker -

Cálculos

Service Descrição Backend
QuotaCalculationService Cálculo de cotas ecosif-masterdata
TaxQuotaCalculationService Cálculo de cota/taxa ecosif-masterdata

🔧 Padrão de Service

Exemplo: CompanyService

import { Injectable } from '@angular/core';
import { HttpClient } from '@angular/common/http';
import { Observable } from 'rxjs';
import { AppConfigService } from '../core/config/app-config.service';

@Injectable({
  providedIn: 'root'
})
export class CompanyService {
  private apiUrl: string;

  constructor(
    private http: HttpClient,
    private appConfig: AppConfigService
  ) {
    this.apiUrl = this.appConfig.apiMasterdata;
  }

  getCompanies(): Observable<Company[]> {
    return this.http.get<Company[]>(`${this.apiUrl}/api/v1/companies`);
  }

  getCompanyById(id: number): Observable<Company> {
    return this.http.get<Company>(`${this.apiUrl}/api/v1/companies/${id}`);
  }

  createCompany(company: Company): Observable<Company> {
    return this.http.post<Company>(`${this.apiUrl}/api/v1/companies`, company);
  }

  updateCompany(id: number, company: Company): Observable<Company> {
    return this.http.put<Company>(`${this.apiUrl}/api/v1/companies/${id}`, company);
  }

  deleteCompany(id: number): Observable<void> {
    return this.http.delete<void>(`${this.apiUrl}/api/v1/companies/${id}`);
  }
}

📡 Integração com Backend

Mapeamento de Services → Backends

Services → Backends
├── AuthService → ecosif-auth (8080)
├── CompanyService → ecosif-masterdata (8081)
├── CreateEntriesService → ecosif-moviments (8082)
├── BalanceInquiryService → ecosif-querys (8083)
├── RelatoriosService → ecosif-reports (8084)
└── ComplianceService → ecosif-compliance (8021)

🔐 Autenticação em Services

Todos os services HTTP utilizam AuthInterceptor que adiciona automaticamente o token JWT:

// Interceptor adiciona token automaticamente
Authorization: Bearer <token>

📊 Resumo por Backend

Backend Services que Utilizam
ecosif-auth 2 (AuthService, AccessControlService)
ecosif-masterdata ~20 services
ecosif-moviments ~8 services
ecosif-querys ~3 services
ecosif-reports ~4 services
ecosif-compliance ~2 services
Externos ~2 (AddressService via ViaCEP)

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