Visão Geral da Solução
Cenários de Caso de Uso
| # | Cenário | Descrição | DAS | DATI | Data Map | C2 | Fluxo |
|---|---|---|---|---|---|---|---|
| 1 | Pagamento | Envio de fatura por email | DAS | DATI | DM | ✓ | ✓ |
| 2 | Contestação | Ajuste de fatura com backoffice (SAGA) | DAS | DATI | DM | ✓ | ✓ |
| 3 | Negociação | Renegociação de dívida via Legacy Debt Collection | DAS | DATI | DM | ✓ | ✓ |
| 4 | 2ª Via | Geração e envio de 2ª via (boleto + PIX) | DAS | DATI | DM | ✓ | ✓ |
Stack Tecnológica
Guidelines e Documentação Técnica
Arquitetura de Referência
Princípios, stack tecnológica, sistemas legados, padrões de integração.
GuidelineDAS — Observabilidade
Elastic Cloud, Langfuse self-hosted, SLIs/SLOs, alertas, dashboards, distributed tracing.
DASArchitecture Decision Records (ADRs)
| ADR | Decisão | Escopo | Status |
|---|---|---|---|
| ADR-0001 | BFF Pattern para orquestração | Transversal | Aceito |
| ADR-0002 | SAGA Orquestrada para Contestação | Cenário 2 | Aceito |
| ADR-0003 | Arquitetura Hexagonal nos Microserviços | Transversal | Aceito |
| ADR-0004 | Event-Driven com Azure Event Hub | Transversal | Aceito |
| ADR-0005 | Anti-Corruption Layer para Legacy Debt Collection | Cenário 3 | Aceito |
| ADR-0006 | Observabilidade — OpenTelemetry + Elastic | Transversal | Aceito |
| ADR-0007 | Segurança — OAuth2/OIDC + mTLS + RBAC | Transversal | Aceito |
| ADR-0008 | Agente IA de Voz — ElevenLabs + LiveKit | URA/IA | Aceito |
.temp/rfp-integracao/adr/ADR-XXXX-*.md — Template corporativo: templates/development/architecture/adr/adr-template.md
Diagramas C4 Disponíveis
| Nível | Diagrama | Arquivo |
|---|---|---|
| C1 Context | Visão geral do sistema | c1-contexto-geral.c4 |
| C2 Container | Cenário 1 — Pagamento | c2-cenario-1-pagamento.c4 |
| C2 Container | Cenário 2 — Contestação | c2-cenario-2-contestacao.c4 |
| C2 Container | Cenário 3 — Negociação | c2-cenario-3-negociacao.c4 |
| C2 Container | Cenário 4 — 2ª Via | c2-cenario-4-segunda-via.c4 |
| C3 Component | BFF Financial Support | c3-bff-financial-support.c4 |
| C4 Code | MS Billing Inquiry | c4-classes-billing-inquiry.c4 |
Cenário 1: Pagamento (Envio de Fatura por Email)
DAS — Pagamento
Documento de Arquitetura de Solução com visão do escopo, jornada, impactos e recursos.
DASDATI — Pagamento
Detalhamento técnico de integração: BFF, MS Billing Inquiry, MS Payment Notification.
DATIData Mapping
4 fluxos mapeados: consulta cliente, consulta faturas via MS Informação do Cliente, resposta faturas, envio email.
Data MappingADRs Aplicáveis
Fluxo de Sequência — Envio de Fatura por Email
sequenceDiagram
autonumber
participant CLI as Cliente
participant URA as URA (ElevenLabs)
participant ATD as Atendente
participant BFF as BFF Financial Support
participant MCI as MS Customer Interaction (Interação com Cliente)
participant MCEP as Event Processor (Interação com Cliente)
participant BIQ as MS Billing Inquiry
participant Informação do Cliente as MS Customer Billing Info (Informação do Cliente)
participant FP as Legacy Billing System (Legado)
participant MPN as MS Payment Notification
participant COM as Customer Communication
participant VNX as Legacy Service Desk (Legado)
participant AMD as Legacy CRM (Legado)
CLI->>URA: Liga para URA
rect rgb(232, 245, 233)
Note over URA,MCI: Abertura de Protocolo (início do atendimento)
URA->>MCI: POST /customers/protocols
MCI->>VNX: SOAP: registra protocolo (Legacy Service Desk)
MCI->>AMD: SOAP: registra protocolo (Legacy CRM)
MCI-->>URA: protocolNumber #12345678
end
URA->>ATD: Transfere (ou resolve via IA) + protocolNumber
ATD->>BFF: GET /billing/invoices
BFF->>BIQ: Consulta faturas
BIQ->>INFO: GET /customers/{id}/invoices
INFO->>FP: REST: consulta faturas + PDF (4P)
FP-->>INFO: Lista de faturas + PDF Base64
INFO-->>BIQ: Lista de faturas
BIQ-->>BFF: Faturas
BFF-->>ATD: Exibe faturas
BFF->>MCI: POST /protocols/{num}/items (palitagem: consulta_faturas)
MCI-->>MCEVP: Evento tpc-csit-protocol-item-topic
MCEP->>VNX: SOAP: palitagem (Legacy Service Desk)
MCEP->>AMD: SOAP: palitagem (Legacy CRM)
ATD->>BFF: POST /billing/invoices/{id}/send
BFF->>MPN: Envia fatura por email
MPN->>COM: POST /communications/email (PDF Base64)
COM-->>MPN: 202 Accepted
MPN-->>BFF: Fatura enviada
BFF->>MCI: POST /protocols/{num}/items (palitagem: envio_fatura_email)
MCI-->>MCEVP: Evento tpc-csit-protocol-item-topic
MCEP->>VNX: SOAP: palitagem (Legacy Service Desk)
MCEP->>AMD: SOAP: palitagem (Legacy CRM)
BFF-->>ATD: Protocolo #12345678 + confirmação
Cenário 2: Contestação de Fatura (SAGA Pattern)
DATI — Contestação
MS Billing Dispute, eventos assíncronos, integração billing via MS Informação do Cliente (crédito).
DATIADRs Aplicáveis
Fluxo de Sequência — Contestação (SAGA)
sequenceDiagram
autonumber
participant ATD as Atendente
participant URA as URA (ElevenLabs)
participant BFF as BFF Financial Support
participant MCI as MS Customer Interaction (Interação com Cliente)
participant MCEP as Event Processor (Interação com Cliente)
participant MBD as MS Billing Dispute
participant Informação do Cliente as MS Customer Billing Info (Informação do Cliente)
participant FP as Legacy Billing System (Legado)
participant BO as Backoffice
participant COM as Customer Communication
participant VNX as Legacy Service Desk (Legado)
participant AMD as Legacy CRM (Legado)
rect rgb(232, 245, 233)
Note over URA,MCI: Abertura de Protocolo (início do atendimento)
URA->>MCI: POST /customers/protocols
MCI->>VNX: SOAP: registra protocolo (Legacy Service Desk)
MCI->>AMD: SOAP: registra protocolo (Legacy CRM)
MCI-->>URA: protocolNumber
end
ATD->>BFF: GET /billing/invoices (protocolNumber no header)
BFF->>MBD: Consulta débitos
MBD->>INFO: GET /tlf/invoices
INFO->>FP: REST: consulta faturas e cobranças (4P)
FP-->>INFO: Lista de faturas
INFO-->>MBD: Débitos do cliente
MBD-->>BFF: Débitos
BFF-->>ATD: Exibe débitos
ATD->>BFF: POST /disputes (protocolNumber no header)
BFF->>MBD: Abre contestação
MBD-->>BFF: DSP-001 (PENDING)
BFF->>MCI: POST /protocols/{num}/items (palitagem: abertura_contestacao)
MCI-->>MCEVP: Evento tpc-csit-protocol-item-topic
MCEP->>VNX: SOAP: palitagem (Legacy Service Desk)
MCEP->>AMD: SOAP: palitagem (Legacy CRM)
BFF-->>ATD: DSP-001 + Protocolo
BO->>BFF: PUT /disputes/DSP-001/approve
BFF->>MBD: Aprovar
MBD->>INFO: POST /adjustments (crédito)
INFO->>FP: REST: POST /tlf/adjustments (crédito negativo, 4P)
FP-->>INFO: Crédito aplicado (adjustmentId)
INFO-->>MBD: Crédito aplicado
MBD-->>BFF: CREDIT_APPLIED
BFF->>MCI: POST /protocols/{num}/items (palitagem: credito_aplicado)
MCI-->>MCEVP: Evento tpc-csit-protocol-item-topic
MCEP->>VNX: SOAP: palitagem (Legacy Service Desk)
MCEP->>AMD: SOAP: palitagem (Legacy CRM)
BFF->>COM: Notifica cliente
COM-->>BFF: 202 Accepted
Cenário 3: Negociação/Cobrança (Renegociação via Legacy Debt Collection)
DAS — Negociação
Integração com Legacy Debt Collection, simulação de parcelamento, timeout de 30min.
DASADRs Aplicáveis
Fluxo de Sequência — Negociação
sequenceDiagram
autonumber
participant ATD as Atendente
participant URA as URA (ElevenLabs)
participant BFF as BFF Financial Support
participant MCI as MS Customer Interaction (Interação com Cliente)
participant MCEP as Event Processor (Interação com Cliente)
participant MDN as MS Debt Negotiation
participant DCL as Legacy Debt Collection
participant BIQ as MS Billing Inquiry
participant Informação do Cliente as MS Customer Billing Info (Informação do Cliente)
participant FP as Legacy Billing System (Legado)
participant AI as Azure OpenAI
participant COM as Customer Communication
participant VNX as Legacy Service Desk (Legado)
participant AMD as Legacy CRM (Legado)
rect rgb(232, 245, 233)
Note over URA,MCI: Abertura de Protocolo (início do atendimento)
URA->>MCI: POST /customers/protocols
MCI->>VNX: SOAP: registra protocolo (Legacy Service Desk)
MCI->>AMD: SOAP: registra protocolo (Legacy CRM)
MCI-->>URA: protocolNumber
end
ATD->>BFF: GET /negotiations/eligible-debts (protocolNumber no header)
BFF->>BIQ: Consulta faturas vencidas
BIQ->>INFO: GET /tlf/invoices (vencidas)
INFO->>FP: REST: consulta faturas vencidas (4P)
FP-->>INFO: Faturas vencidas
INFO-->>BIQ: Débitos pendentes
BIQ-->>BFF: Débitos pendentes
BFF->>MDN: Consulta dívidas elegíveis (Legacy Debt Collection)
MDN->>DCL: GET /debt-collection/debts
DCL-->>MDN: Dívidas ativas
MDN-->>BFF: Dívidas elegíveis
BFF->>MCI: POST /protocols/{num}/items (palitagem: consulta_dividas)
MCI-->>MCEVP: Evento tpc-csit-protocol-item-topic
MCEP->>VNX: SOAP: palitagem (Legacy Service Desk)
MCEP->>AMD: SOAP: palitagem (Legacy CRM)
ATD->>BFF: POST /negotiations/simulate
BFF->>MDN: Simula acordo
MDN->>DCL: POST /debt-collection/simulations
DCL-->>MDN: Opções de parcelamento
BFF->>AI: Qual melhor opção?
AI-->>BFF: Recomenda opção 2
BFF-->>ATD: Opções + recomendação IA
BFF->>MCI: POST /protocols/{num}/items (palitagem: simulacao_acordo)
MCI-->>MCEVP: Evento tpc-csit-protocol-item-topic
MCEP->>VNX: SOAP: palitagem (Legacy Service Desk)
MCEP->>AMD: SOAP: palitagem (Legacy CRM)
ATD->>BFF: POST /negotiations (aceita opção 2)
BFF->>MDN: Formaliza acordo
MDN->>DCL: POST /debt-collection/agreements
DCL-->>MDN: Acordo formalizado
BFF->>MCI: POST /protocols/{num}/items (palitagem: acordo_formalizado)
MCI-->>MCEVP: Evento tpc-csit-protocol-item-topic
MCEP->>VNX: SOAP: palitagem (Legacy Service Desk)
MCEP->>AMD: SOAP: palitagem (Legacy CRM)
BFF->>COM: Confirmação por email
BFF-->>ATD: Protocolo + acordo
Cenário 4: 2ª Via de Fatura (Boleto + PIX)
Data Mapping
Geração 2ª via via MS Informação do Cliente (boleto+PIX), envio multi-canal.
Data MappingADRs Aplicáveis
Fluxo de Sequência — 2ª Via
sequenceDiagram
autonumber
participant ATD as Atendente
participant URA as URA (ElevenLabs)
participant BFF as BFF Financial Support
participant MCI as MS Customer Interaction (Interação com Cliente)
participant MCEP as Event Processor (Interação com Cliente)
participant BIQ as MS Billing Inquiry
participant Informação do Cliente as MS Customer Billing Info (Informação do Cliente)
participant CIMV2 as MS Customer Invoice Mgmt v2
participant FP as Legacy Billing System (Legado)
participant BLOB as Azure Blob Storage
participant COM as Customer Communication
participant VNX as Legacy Service Desk (Legado)
participant AMD as Legacy CRM (Legado)
rect rgb(232, 245, 233)
Note over URA,MCI: Abertura de Protocolo (início do atendimento)
URA->>MCI: POST /customers/protocols
MCI->>VNX: SOAP: registra protocolo (Legacy Service Desk)
MCI->>AMD: SOAP: registra protocolo (Legacy CRM)
MCI-->>URA: protocolNumber
end
ATD->>BFF: GET /billing/invoices (protocolNumber no header)
BFF->>BIQ: Consulta faturas
BIQ->>INFO: GET /customers/{id}/invoices
INFO->>FP: REST: consulta fatura + status (4P)
FP-->>INFO: Fatura + status
INFO-->>BIQ: Faturas + payment_code + download_url
BIQ-->>BFF: Faturas
BFF-->>ATD: Exibe faturas
BFF->>MCI: POST /protocols/{num}/items (palitagem: consulta_faturas)
MCI-->>MCEVP: Evento tpc-csit-protocol-item-topic
MCEP->>VNX: SOAP: palitagem (Legacy Service Desk)
MCEP->>AMD: SOAP: palitagem (Legacy CRM)
ATD->>BFF: POST /invoices/{id}/duplicate
BFF->>CIMV2: GET /invoiceDetails/{type}/{id}?responseContent=pdf
CIMV2->>FP: REST: POST /tlf/invoices/{id}/payment-slip + PIX (4P)
FP-->>CIMV2: Novo boleto + BRCode PIX
CIMV2-->>BFF: PDF Base64 (gzip)
BFF->>BLOB: Upload PDF (TTL 24h)
BLOB-->>BFF: URL temporária (SAS token)
BFF-->>ATD: PDF pronto
BFF->>MCI: POST /protocols/{num}/items (palitagem: geracao_segunda_via)
MCI-->>MCEVP: Evento tpc-csit-protocol-item-topic
MCEP->>VNX: SOAP: palitagem (Legacy Service Desk)
MCEP->>AMD: SOAP: palitagem (Legacy CRM)
ATD->>BFF: POST /invoices/{id}/deliver (EMAIL)
BFF->>COM: POST /communications/email
COM-->>BFF: 202 Accepted
BFF->>MCI: POST /protocols/{num}/items (palitagem: envio_segunda_via_email)
MCI-->>MCEVP: Evento tpc-csit-protocol-item-topic
MCEP->>VNX: SOAP: palitagem (Legacy Service Desk)
MCEP->>AMD: SOAP: palitagem (Legacy CRM)
BFF-->>ATD: Protocolo + confirmação
Diagramas C4 (LikeC4 DSL)
https://docs-c4.acntechlab.com. Para iniciar: npx likec4 serve -w diagrams/
| Nível | Diagrama | Arquivo | Escopo |
|---|---|---|---|
| C1 | Context — Visão Geral | c1-contexto-geral.c4 | Todos os cenários |
| C2 | Container — Pagamento | c2-cenario-1-pagamento.c4 | Cenário 1 |
| C2 | Container — Contestação | c2-cenario-2-contestacao.c4 | Cenário 2 |
| C2 | Container — Negociação | c2-cenario-3-negociacao.c4 | Cenário 3 |
| C2 | Container — 2ª Via | c2-cenario-4-segunda-via.c4 | Cenário 4 |
| C2 | Container — Observabilidade | c2-observabilidade.c4 | Transversal |
| C3 | Component — BFF | c3-bff-financial-support.c4 | Transversal |
| C3 | Component — MS Billing Dispute | c3-ms-billing-dispute.c4 | Cenário 2 |
| C3 | Component — MS Debt Negotiation | c3-ms-debt-negotiation.c4 | Cenário 3 |
| C3 | Component — URA Agent Service | c3-ura-agent-service.c4 | URA/IA |
| C4 | Code — MS Billing Inquiry | c4-classes-billing-inquiry.c4 | Cenário 1 |
C1 — Context: Visão Geral
C2 — Container: Cenário 1 (Pagamento)
C2 — Container: Cenário 2 (Contestação)
C2 — Container: Cenário 3 (Negociação)
C2 — Container: Cenário 4 (2ª Via)
C2 — Container: Observabilidade (Elastic Cloud + Langfuse)
C3 — Component: BFF Financial Support
C3 — Component: MS Billing Dispute (SAGA)
C3 — Component: MS Debt Negotiation (ACL Legacy Debt Collection)
C3 — Component: URA Agent Service (AI Pipeline)
C4 — Code: MS Billing Inquiry (Hexagonal)
Specification Corporativa
specs.c4
Cores, shapes e relationships padrão Vivo para LikeC4 DSL.
Specexternals.c4
Sistemas externos compartilhados: Legacy Billing System (via MS Informação do Cliente), Legacy Debt Collection, API Gateway, IdP, etc.
ExternalsObservabilidade — Stack Transversal
Contratos OpenAPI — Por Serviço
| Serviço | Contrato | Tipo | Autenticação | Endpoints |
|---|---|---|---|---|
| BFF Financial Support | api-crm-financial-support-bff-v1.yaml | BFF (externo) | OAuth2 JWT | 16 |
| MS Billing Inquiry | api-crm-billing-inquiry-ms-v1.yaml | MS (interno) | mTLS | 5 |
| MS Billing Dispute | api-crm-billing-dispute-ms-v1.yaml | MS (interno) | mTLS | 5 |
| MS Debt Negotiation | api-crm-debt-negotiation-ms-v1.yaml | MS (interno) | mTLS | 6 |
| MS Invoice Delivery | api-crm-invoice-delivery-ms-v1.yaml | MS (interno) | mTLS | 5 |
| MS Payment Notification | api-crm-payment-notification-ms-v1.yaml | MS (interno) | mTLS | 3 |
Swagger UI — Por Serviço
BFF Financial Support
Contrato externo consumido pelo CRM+ Frontend — agrega todos os cenários (OAuth2 JWT)
BFFMS Billing Dispute
Contestação SAGA — abertura, aprovação backoffice, crédito via Informação do Cliente (mTLS)
MSArchitecture Decision Records (ADRs)
| ID | Decisão | Status | Tema |
|---|---|---|---|
| ADR-0001 | Adoção do padrão BFF para orquestração | Aceito | Integração |
| ADR-0002 | SAGA Orquestrada para fluxo de Contestação | Aceito | Resiliência |
| ADR-0003 | Arquitetura Hexagonal para Microserviços | Aceito | Design |
| ADR-0004 | Event-Driven Architecture com Azure Event Hub | Aceito | Eventos |
| ADR-0005 | Anti-Corruption Layer para Legacy Debt Collection | Aceito | DDD |
| ADR-0006 | Stack de Observabilidade — OpenTelemetry + Elastic | Aceito | Observabilidade |
| ADR-0007 | Segurança — OAuth2/OIDC + mTLS + RBAC | Aceito | Segurança |
| ADR-0008 | Agente IA de Voz — ElevenLabs + LiveKit + Azure OpenAI | Aceito | IA/URA |
| ADR-0009 | MCP Servers para desacoplamento Microsserviços ↔ Agentes IA | Aceito | IA/MCP |
ADRs por Tema
ADR-0001: BFF Pattern
Camada de orquestração dedicada ao CRM+ — contrato único, agregação server-side, circuit breaker.
IntegraçãoADR-0002: SAGA Orquestrada
State machine para contestação — compensações, outbox pattern, timeout 72h.
ResiliênciaADR-0003: Arq. Hexagonal
Ports & Adapters em todos os microserviços — isolamento do domain, substituição de legados.
DesignADR-0004: Event-Driven
Azure Event Hub com protocolo Kafka — CloudEvents, schema registry, outbox pattern.
EventosADR-0005: ACL Legacy Debt Collection
Anti-Corruption Layer para Legacy Debt Collection — tradução de modelo, idempotência, circuit breaker.
DDDADR-0006: Observabilidade
OpenTelemetry + Elastic Cloud + Langfuse — traces, logs, métricas, SLOs.
ObservabilidadeADR-0007: Segurança
3 camadas — Edge (API Gateway), Service Mesh (mTLS), Aplicação (RBAC). LGPD, SOX, PCI DSS.
SegurançaADR-0008: Agente IA Voz
ElevenLabs TTS + LiveKit WebRTC + Azure OpenAI GPT-4o — latência < 2s, guardrails.
IA/URAADR-0009: MCP Servers
Model Context Protocol — desacoplamento, descoberta dinâmica de tools, reutilização multi-agente.
IA/MCPCódigo Fonte — Repositórios Azure DevOps
MS Debt Negotiation v1
Microsserviço de negociação de dívida — ACL para Legacy Debt Collection, simulação e formalização de acordos.
MicrosserviçoAzure DevOps ↗BFF Financial Support v1
Backend for Frontend — orquestração de todos os cenários (pagamento, contestação, negociação, 2ª via).
BFFAzure DevOps ↗MS Billing Inquiry v1
Consulta de faturas e débitos via Informação do Cliente — cache Redis, integração 4P.
MicrosserviçoAzure DevOps ↗MS Invoice Delivery v1
Geração de 2ª via de fatura — PDF, boleto, PIX BRCode, Blob Storage com TTL 24h.
MicrosserviçoAzure DevOps ↗MS Payment Notification v1
Envio de fatura por email via Customer Communication SN — notificações multi-canal.
MicrosserviçoAzure DevOps ↗Mapeamento Serviço → Repositório
| Serviço | Repositório Azure DevOps | Download ZIP | Cenários |
|---|---|---|---|
| BFF Financial Support | bff-financial-support-v1 ↗ | ⬇ ZIP (136 KB) | 1, 2, 3, 4 |
| MS Billing Inquiry | ms-billing-inquiry-v1 ↗ | ⬇ ZIP (81 KB) | 1, 3, 4 |
| MS Billing Dispute | Azure DevOps | ⬇ ZIP (50 KB) | 2 |
| MS Debt Negotiation | ms-debt-negotiation-v1 ↗ | ⬇ ZIP (56 KB) | 3 |
| MS Invoice Delivery | ms-invoice-delivery-v1 ↗ | ⬇ ZIP (57 KB) | 4 |
| MS Payment Notification | ms-payment-notification-v1 ↗ | ⬇ ZIP (59 KB) | 1 |
Estrutura dos Arquivos ZIP
| Diretório/Arquivo | Descrição |
|---|---|
src/main/java/ | Código fonte Java — arquitetura hexagonal (domain, application, infrastructure) |
src/main/resources/ | Configurações (application.yml, logback.xml) |
src/test/java/ | Testes unitários e de integração |
pom.xml | Dependências Maven (Spring Boot 3.x, OpenTelemetry, etc.) |
Dockerfile | Imagem Docker multi-stage build |
README.md | Documentação do microsserviço |
Stack Tecnológica
MCP Servers — Model Context Protocol
Endpoints MCP Disponíveis
| Microsserviço | Endpoint SSE | Status |
|---|---|---|
| MS Billing Dispute | https://cl0.acntechlab.com/billing-dispute/sse |
Ativo |
| MS Billing Inquiry | https://cl0.acntechlab.com/billing-inquiry/sse |
Ativo |
| MS Debt Negotiation | https://cl0.acntechlab.com/debt-negotiation/sse |
Ativo |
| MS Invoice Delivery | https://cl0.acntechlab.com/invoice-delivery/sse |
Ativo |
| MS Payment Notification | https://cl0.acntechlab.com/payment-notification/sse |
Ativo |
Operações por Microsserviço
MS Billing Dispute — Contestação de Faturas
create_dispute
Abre uma nova contestação de fatura. Inicia o fluxo SAGA de contestação.
POST SAGAget_dispute
Consulta detalhes de uma contestação específica pelo seu ID.
GETlist_disputes
Lista contestações de um cliente com filtro opcional por status.
GETapprove_dispute
Aprova uma contestação (backoffice). Aplica crédito na fatura do cliente.
BACKOFFICEreject_dispute
Rejeita uma contestação (backoffice). Informa o motivo da rejeição.
BACKOFFICEMS Billing Inquiry — Consulta de Faturas
getInvoices
Lista faturas de um cliente com filtros opcionais (período, status).
GETgetInvoiceDetail
Retorna o detalhe de uma fatura específica, incluindo cobranças e PDF em Base64.
GETgetInvoicePdf
Obtém o PDF de uma fatura codificado em Base64.
GET PDFgetDebts
Consulta débitos pendentes de um cliente com valor original, atual, vencimento e dias de atraso.
GETMS Debt Negotiation — Negociação de Dívidas
query_eligible_debts
Consulta as dívidas elegíveis para negociação de um cliente.
GETsimulate_negotiation
Simula opções de negociação para uma dívida específica com parcelas, valores e descontos.
POSTformalize_agreement
Formaliza um acordo de negociação selecionando uma das opções da simulação.
POST AcordoMS Invoice Delivery — Geração de 2ª Via
previewInvoice
Preview dos dados da fatura do cliente antes de gerar a 2ª via.
GETgenerateDuplicate
Gera 2ª via de fatura com nova data de vencimento.
POST 2ª ViadeliverInvoice
Entrega fatura via canal (EMAIL, SMS, DOWNLOAD_LINK).
POST Multi-canalgetDownloadLink
Obtém link temporário de download da fatura com expiração configurável.
GET TTLMS Payment Notification — Notificações de Pagamento
sendInvoiceByEmail
Envia uma fatura por email para o cliente. Retorna ID da notificação, status e protocolo.
POST EmailRecursos e Benefícios
Integração Nativa com IA
Agentes de IA podem invocar operações de negócio diretamente via MCP, sem necessidade de código customizado.
Zero CodeServer-Sent Events (SSE)
Comunicação bidirecional em tempo real entre agente e microsserviços.
Real-timeDescoberta Automática
Agentes descobrem automaticamente as operações disponíveis via protocolo MCP.
Auto-discoveryObservabilidade Integrada
Todas as chamadas MCP são rastreadas via OpenTelemetry com correlation ID.
TracingArgo CD — Continuous Deployment
Dashboard Principal
Argo CD Dashboard ↗
Console web para visualização de aplicações, histórico de deployments, sincronização manual/automática e logs de pods.
GitOps KubernetesCredenciais de Acesso
Solicitar credenciais ao time de DevOps/SRE. Autenticação via SSO corporativo (Azure AD).
SSOAplicações Monitoradas
| Aplicação | Namespace | Repositório Git | Sync Policy |
|---|---|---|---|
| bff-financial-support-v1 | crm-financial-poc | Azure DevOps ↗ | Automated |
| ms-billing-inquiry-v1 | crm-financial-poc | Azure DevOps ↗ | Automated |
| ms-billing-dispute-v1 | crm-financial-poc | Azure DevOps | Automated |
| ms-debt-negotiation-v1 | crm-financial-poc | Azure DevOps ↗ | Automated |
| ms-invoice-delivery-v1 | crm-financial-poc | Azure DevOps ↗ | Automated |
| ms-payment-notification-v1 | crm-financial-poc | Azure DevOps ↗ | Automated |
Recursos e Funcionalidades
Sync Status
Visualização em tempo real do status de sincronização entre Git e cluster Kubernetes (Synced, OutOfSync, Unknown).
Real-timeHealth Status
Monitoramento de saúde das aplicações (Healthy, Progressing, Degraded, Suspended, Missing).
Health CheckRollback
Capacidade de rollback para versões anteriores via histórico de revisões Git.
RollbackLogs & Events
Acesso a logs de pods e eventos Kubernetes diretamente pelo dashboard.
LogsPipeline GitOps
graph LR
A[Developer Push] --> B[Azure DevOps Git]
B --> C[Argo CD Sync]
C --> D{Sync Policy}
D -->|Automated| E[Auto Deploy]
D -->|Manual| F[Manual Approval]
E --> G[AKS Cluster]
F --> G
G --> H[Health Check]
H -->|Healthy| I[Deployment OK]
H -->|Degraded| J[Rollback]
J --> B