Relevo art déco em cobre, com três portais ligados por uma linha contínua. Os portais representam responsabilidades diferentes na mesma jornada bancária.
Parte 1 de 9 da série BIAN e arquitetura bancária. Nesta série, vamos seguir jornadas bancárias para entender onde cada responsabilidade começa, termina e passa para outra equipe.
O aplicativo diz que a conta foi aprovada. Você tenta usar a conta e ela ainda não existe para você. Quem, no banco, consegue explicar o que aconteceu?
Imagine que você solicita uma conta pelo celular. O aplicativo aceita os documentos, informa que o pedido está em análise e depois mostra uma oferta para aceitar. Você aceita. No dia seguinte, o atendimento enxerga um pedido aprovado, mas a conta ainda está indisponível. A pessoa que atende precisa descobrir se falta uma verificação, se a oferta perdeu a validade ou se o sistema bancário central ainda está processando a abertura.
Esse é o caso hipotético deste capítulo. Um banco de varejo quer reduzir de cinco dias úteis para um o prazo de abertura de contas correntes elegíveis. Eu começaria pela responsabilidade por cada decisão, porque isso determina o que os sistemas podem comunicar e como recuperar um caso que para entre duas etapas.
Natureza-morta construída com bandejas de metal suspensas e um formulário que atravessa os níveis. A passagem representa a transferência da solicitação entre domínios.
Use o Service Landscape para conversar sobre responsabilidades
BIAN, a Banking Industry Architecture Network, organiza domínios de serviço bancário em um Service Landscape. A edição 14.0 traz, entre outros artefatos, cenários de negócio e referências para APIs semânticas. O domínio Customer Offer aparece associado ao cenário de solicitação de abertura de conta corrente de varejo. A referência também descreve uma operação para iniciar uma nova conta corrente em Current Account. Service Landscape do BIAN · Customer Offer e cenários na edição 14.0 · Operação de iniciação em Current Account
Eu levaria esses exemplos para uma conversa com Produto, Operações, Riscos e as equipes que mantêm o canal e o sistema bancário central. Usaria os domínios como referência para perguntar onde começa e termina cada responsabilidade. A divisão abaixo é uma escolha para o banco hipotético. Ela pode ser implementada com componentes existentes e contratos explícitos, inclusive quando o mesmo sistema atende a mais de uma responsabilidade.
- Canal digital. Recebe a solicitação, confirma o recebimento e apresenta ao cliente o estado que o banco consegue sustentar.
- Elegibilidade. Registra a decisão, a versão da política, as referências às evidências e o motivo de um encaminhamento para análise.
- Oferta. Registra os termos apresentados, a validade e a aceitação da versão oferecida.
- Abertura de conta. Cria a conta no sistema bancário central e confirma quando ela está disponível para uso.
Eu daria à jornada um identificador estável. Cada responsabilidade pode manter os seus identificadores, com uma referência que permita correlacioná-los quando um caso precisar ser investigado. O atendimento ganha uma forma de localizar a solicitação sem depender de um estado genérico como “aprovado”.
Figura 1. Fluxograma de responsabilidades. Observe quem controla o estado em cada passagem da abertura.
Siga um caso que passa por análise
Considere uma cliente que envia a documentação completa na terça-feira às 10h. O banco usa um calendário de dias úteis e um evento definido para iniciar a medição. A elegibilidade fica temporariamente em análise porque dois registros trazem informações divergentes. A operação resolve a divergência, registra a evidência e devolve o caso ao fluxo de oferta. A cliente recebe os termos, aceita a versão vigente e vê que a abertura está em andamento.
Nesse ponto, eu verificaria duas perguntas com o time. A primeira é se o caso continua no grupo usado para medir a meta de um dia útil. A resposta precisa vir da política aprovada, com a justificativa de qualquer mudança de classificação. A segunda é se o tempo para o cliente inclui a espera pela aceitação da oferta. O banco pode medir o tempo total e os intervalos de cada etapa em separado. As duas medidas ajudam a explicar o que foi observado e onde a operação tem capacidade de agir.
A pessoa de atendimento consegue acompanhar a passagem entre as etapas se cada equipe publicar o estado que controla. A oferta registra a aceitação. A abertura registra o resultado no sistema central. O canal projeta esses sinais em estados que a cliente consegue entender.
Figura 2. Diagrama de sequência. Observe em que momento o caso entra em análise e volta ao fluxo de oferta.
Desenhe o contrato para o momento em que a resposta se perde
Imagine que o sistema central recebe a instrução e cria a conta, mas a resposta se perde. A aplicação do canal repete a solicitação. Eu faria essa repetição encontrar o pedido existente. Se a criação ainda estiver em andamento, o serviço retorna a referência original e o estado pendente. Se a conta já estiver disponível, ele retorna o mesmo resultado. Se o pedido repetido traz informação incompatível com a referência original, o serviço sinaliza conflito e encaminha a divergência para tratamento.
Este exemplo usa um contrato local ilustrativo. A referência BIAN ajuda a orientar o significado de iniciar uma conta corrente. A rota, os campos e o comportamento diante de repetição abaixo são escolhas do banco para este caso. Guia de APIs semânticas do BIAN
POST /solicitacoes-abertura
Idempotency-Key: req-80271-conta-corrente
Content-Type: application/json
{
"solicitacaoId": "req-80271",
"ofertaAceitaId": "of-314",
"versaoTermos": 4,
"decisaoElegibilidadeId": "el-659"
}
O serviço registra a chave e os dados relevantes do pedido em uma operação local antes de enviar o trabalho ao sistema central. Uma restrição de unicidade evita que dois recebimentos concorrentes criem registros locais separados. Para fechar a janela de falha entre o envio externo e a gravação do resultado, eu verificaria se o sistema central aceita uma referência única de origem ou oferece uma consulta confiável por essa referência. Se o resultado continuar incerto e a consulta for inconclusiva, a operação reconcilia o caso antes de reenviar. Testaria esse caminho com a equipe responsável pelo sistema central durante o piloto.
Figura 3. Diagrama de estados. Observe o tratamento de uma resposta incerta e o marco da conta ativa.
O estado acima pertence à abertura. A elegibilidade e a aceitação da oferta têm seus próprios registros. Eu guardaria referências a essas decisões com acesso restrito, de acordo com a classificação dos dados. O painel de suporte pode mostrar motivo operacional e estado do processamento sem copiar todos os documentos de origem.
Eu separaria também a mensagem que confirma o recebimento daquela que comunica a disponibilidade. A primeira pode sair assim que a solicitação estiver registrada. A segunda depende de a conta estar de fato disponível para o uso prometido. Se houver uma etapa adicional entre a criação no sistema central e a habilitação no canal, eu pediria às áreas que combinem qual evento confirma a conclusão dessa etapa. Essa diferença evita que a operação comemore um prazo cumprido enquanto a cliente ainda tenta acessar a conta.
Em uma revisão de contrato, eu pediria para desenhar na tela de atendimento os dois estados recentes, com horário e origem. Isso permite discutir uma dúvida concreta. Se o sistema central confirma a criação às 11h e o canal ainda não recebeu a atualização às 11h30, quem consegue detectar o atraso e corrigir a projeção?
Valide a fronteira antes de aumentar o volume
Eu começaria com um tipo de conta, capacidade de atendimento definida e exemplos que forcem a conversa entre as equipes. Além do caso elegível, incluiria uma oferta expirada, uma solicitação sujeita a análise e uma confirmação de ativação recebida com atraso. Em cada teste, pediria a alguém do atendimento que encontre o caso, explique o estado para o cliente e indique qual equipe deve agir.
Na revisão do piloto, eu levaria o prazo observado para contas elegíveis, a quantidade de ativações ainda em conciliação e a evidência de que tentativas repetidas convergiram para uma única conta. Pediria também uma amostra dos casos retirados da coorte para confirmar que o resultado não melhorou apenas porque o banco mudou quem entra na medição.
A conversa fica mais simples quando cada área consegue demonstrar a decisão que tomou e a próxima equipe sabe em que evidência pode confiar. É essa clareza que eu buscaria com BIAN, do desenho do serviço até a revisão de um pedido real no atendimento.
Descubra onde o banco já assumiu cada responsabilidade
Eu começaria com uma oficina curta em que cada participante traz um exemplo. Produto mostra o texto que aparece após o envio. Operações traz o procedimento para revisar uma evidência inconclusiva. A equipe do core demonstra qual registro permite confirmar que a conta foi criada. Quem responde pela política indica como recuperar a versão da regra usada em um caso anterior. Peço que o grupo percorra os exemplos com o mesmo identificador de solicitação. Se as referências mudarem no caminho, anotamos onde ocorre a tradução e quem consegue explicar a correspondência.
Em um banco com canais diferentes, a oferta pode ser registrada em uma plataforma que atende várias jornadas. A capacidade de decidir elegibilidade também pode apoiar produtos que têm exigências diferentes. Eu usaria o Service Landscape para discutir a divisão funcional e depois confirmaria como essa divisão se materializa localmente. Uma função de negócio pode ser implementada por mais de uma aplicação ou conviver com outra em um sistema existente. O mapa precisa expor qual equipe tem autoridade sobre o resultado e quais aplicações consomem esse resultado.
A pergunta fica mais específica quando pedimos para alterar um caso. Se a oferta vencer antes da aceitação, o canal consulta a situação vigente e pede ao domínio de oferta uma alternativa permitida. Se a evidência usada na triagem for corrigida, a área com autoridade sobre elegibilidade decide se exige reavaliação e registra o desfecho. Se a conta já tiver sido ativada, a regra de tratamento do caso depende do que foi aprovado para aquele estágio. Eu escreveria as três situações em uma página e compararia a resposta de cada equipe antes de escolher o contrato.
Figura 4. Fluxograma de descoberta. Observe a ligação entre autoridade, evidência e consumidores.
Registre a instrução de abertura de modo que a concorrência tenha tratamento conhecido
Eu manteria o identificador da instrução e um resumo dos dados imutáveis necessários para decidir se um reenvio corresponde ao pedido anterior. Este exemplo de PostgreSQL mostra uma restrição de unicidade para o pedido e uma segunda para a solicitação, assumindo que o banco fictício permite uma instrução para cada solicitação. Produtos que permitem mais de uma conta podem usar um identificador distinto por item. A operação usa parâmetros do driver. Uma transação sob o isolamento padrão pode buscar o registro por chave em um segundo comando e devolver o resultado conhecido ou identificar um conflito nos dados. A validação aplica as regras de negócio antes de encaminhar a instrução ao core. Restrições de unicidade no PostgreSQL
CREATE TABLE instrucao_abertura (
chave text PRIMARY KEY,
solicitacao_id text NOT NULL UNIQUE,
oferta_id text NOT NULL,
versao_termos integer NOT NULL CHECK (versao_termos > 0),
elegibilidade_id text NOT NULL,
estado text NOT NULL
CHECK (estado IN ('registrada', 'pendente', 'ativa', 'em_conciliacao')),
conta_ref text UNIQUE,
CHECK (estado <> 'ativa' OR conta_ref IS NOT NULL)
);
INSERT INTO instrucao_abertura
(chave, solicitacao_id, oferta_id, versao_termos, elegibilidade_id, estado)
VALUES ($1, $2, $3, $4, $5, 'registrada')
ON CONFLICT DO NOTHING
RETURNING chave, solicitacao_id, estado;
Se a inserção não retornar uma linha, a aplicação consulta o registro pela chave e pela solicitação. Um reenvio com os mesmos dados recupera o estado conhecido. Se os dois identificadores indicarem registros diferentes, a aplicação encaminha o conflito para investigação. Uma nova chave com a mesma solicitação pode significar que o cliente repetiu uma operação cuja resposta expirou. Eu registraria quais campos podem variar sem modificar a intenção do pedido e quais precisam de nova autorização. O exemplo usa os termos, a oferta e a decisão de elegibilidade como campos relevantes que devem corresponder à solicitação registrada.
A restrição local mantém um registro por solicitação nas condições do exemplo. Depois do envio, a conclusão depende da capacidade do core de reconhecer a referência ou de informar o resultado de forma confiável. Por isso eu testaria a falha com a conta criada e o estado local pendente. A equipe busca primeiro a confirmação, registra o resultado e preserva a origem. Se a resposta for incerta, a recuperação entra no procedimento de conciliação. Automatizar a nova tentativa exige evidência de que a fronteira externa entende o identificador e preserva a intenção original.
Figura 5. Diagrama de sequência de recuperação. Observe o uso da referência original depois da perda da resposta.
Xilogravura em roxo e dourado com uma porta aberta, um livro e uma chave presos aos lados. O livro representa o registro da decisão, e a chave representa a capacidade de executar a abertura.
Valide a projeção de status sem reavaliar a política
Eu separaria o estado apresentado no canal das decisões registradas pelos domínios. A projeção pode resolver qual texto exibir com os fatos que cada responsável publicou. Quando a elegibilidade está em análise, o canal pode informar que há uma verificação em andamento. Quando uma oferta foi apresentada e aguarda aceite, mostra a ação correspondente. Quando a oferta foi aceita e o core ainda precisa confirmar, mostra a abertura em andamento. A configuração real também precisa definir estados de recusa, cancelamento e expiração. O exemplo abaixo cobre um recorte dos caminhos que estamos discutindo.
from dataclasses import dataclass
from typing import Literal
Elegibilidade = Literal["em_analise", "aprovada", "recusada"]
Oferta = Literal["a_emitir", "apresentada", "aceita", "expirada"]
Abertura = Literal["nao_iniciada", "pendente", "ativa"]
@dataclass(frozen=True)
class Fatos:
elegibilidade: Elegibilidade
oferta: Oferta
abertura: Abertura
confirmacao_core: str | None = None
def status_no_canal(fatos: Fatos) -> str:
if fatos.abertura == "ativa":
if not fatos.confirmacao_core:
return "verificar_status"
return "conta_disponivel"
if fatos.abertura == "pendente":
return "abertura_em_andamento"
if fatos.elegibilidade == "recusada":
return "consultar_desfecho"
if fatos.elegibilidade == "em_analise":
return "verificacao_em_andamento"
if fatos.oferta == "expirada":
return "solicitar_nova_oferta"
if fatos.oferta == "apresentada":
return "revisar_termos"
if fatos.oferta == "aceita":
return "abertura_em_andamento"
return "preparando_oferta"
assert status_no_canal(Fatos("aprovada", "aceita", "pendente")) == "abertura_em_andamento"
assert status_no_canal(Fatos("aprovada", "aceita", "ativa")) == "verificar_status"
assert status_no_canal(Fatos("aprovada", "aceita", "ativa", "core-42")) == "conta_disponivel"
O último teste pressupõe que a confirmação já foi validada e pertence ao pedido. Uma aplicação real precisa rejeitar ou encaminhar uma associação inesperada antes de aplicar a projeção. Eu perguntaria à equipe se a palavra disponível exige ativação no core e uma condição adicional no canal. Se houver uma segunda condição, a projeção precisa esperar pelos dois fatos. O leitor consegue verificar no código onde essa decisão entra e discutir qual domínio fornece o fato adicional.
Figura 6. Diagrama de estados da jornada. Observe os fatos que autorizam a passagem da oferta à conta disponível.
Prepare um teste que mostre qual contrato falhou
Quando a equipe diz que precisa testar a integração, eu tento converter essa frase em perguntas observáveis. O domínio de elegibilidade consegue devolver uma decisão com a referência e a versão correta? A oferta emitida pode ser recuperada pelo seu próprio identificador? O reenvio encontra a mesma instrução e usa o termo aceito no primeiro pedido? A mensagem do canal muda somente quando a condição de disponibilidade foi comprovada? Cada teste pode apontar qual fronteira teve problema e quem responde pela correção.
Funcionalidade: Recuperar instrução após perda de confirmação
Cenário: A conta é ativada sem que a primeira confirmação chegue
Dado que a solicitação "req-80271" tem decisão "el-659" aprovada
E a cliente aceitou a versão 4 da oferta "of-314"
Quando a instrução "req-80271-conta-corrente" é registrada
E o core ativa a conta e a resposta se perde
Então o canal mantém o estado "abertura_em_andamento"
Quando o serviço recupera a confirmação pela referência original
Então a solicitação aponta para uma única conta confirmada
E o canal apresenta a conta como disponível
Cenário: Um reenvio altera a oferta já registrada
Dado que a instrução foi registrada com a versão 4 da oferta
Quando um reenvio traz a mesma chave com outra versão
Então o serviço registra conflito para tratamento
E nenhuma nova instrução é encaminhada ao core
Eu usaria a linguagem de teste para discutir os resultados com Produto e Operações. Para a equipe de desenvolvimento, acrescentaria os detalhes de origem, resposta e estado persistido. Uma aprovação dos cenários deveria apontar qual evidência foi produzida. Isso permite refazer o teste com a próxima versão do contrato, inclusive se outro sistema assumir a oferta ou a verificação de identidade.
Figura 7. Fluxograma de testes entre domínios. Observe como a fronteira vira uma evidência de suporte.
Revise a responsabilidade antes de copiar o modelo para outro produto
O banco pode usar a experiência da conta-corrente para investigar outro produto. Antes de reaproveitar a interface, eu compararia as evidências aceitas, as regras de oferta e o significado da disponibilidade. Uma conta empresarial pode depender da confirmação de representantes e direitos de uso. O contrato de abertura do piloto pode continuar útil para tratar repetição de instrução, enquanto a decisão de elegibilidade exige outros registros. A arquitetura precisa deixar claro o que a equipe consegue reutilizar e em que condições uma nova decisão se torna necessária.
Eu fecharia a revisão com uma demonstração curta para quem atende a cliente. Ela recebe uma referência de caso, procura a decisão vigente e explica o estado com base no que o banco já confirmou. Em seguida, Engenharia segue a referência até os contratos e mostra como o desenho reage a uma falha. Essa passagem entre as duas perspectivas me ajuda a reconhecer se o recorte BIAN está útil. Consigo localizar a responsabilidade e consigo testá-la no fluxo real, com a evidência necessária para orientar a próxima pessoa.
Acompanhe o estado da decisão durante a mudança de política
Imagine que, no meio do piloto, a área responsável pela política de elegibilidade exija uma evidência de identidade mais recente. Uma cliente teve a análise aprovada na terça-feira, recebeu a oferta na quarta e aceitou os termos na quinta, depois da entrada em vigor da nova regra. A mudança pode ter efeito no caso se a política determinar que a validade da evidência precisa ser verificada de novo antes da abertura. Eu pediria à área responsável que indique em qual evento a regra passa a valer e que comportamento se espera para solicitações que atravessam a alteração.
A arquitetura precisa conseguir aplicar a decisão sem fazer cada participante interpretar prazos por conta própria. Elegibilidade registra a versão da regra, o estado da análise e a referência da evidência. Oferta registra quando os termos foram apresentados e aceitos. Abertura verifica quais fatos a execução exige e preserva as referências usadas. Se a condição de abertura incluir uma avaliação atualizada, o responsável pela política define como solicitar ou obter a nova avaliação. O canal prepara uma mensagem para explicar qual verificação está em andamento e o que a cliente pode fazer.
Eu levaria um exemplo em que a regra anterior continua válida para pedidos já iniciados e outro em que a política exige reavaliação. As áreas mostram como cada caso é identificado e como seus resultados podem ser recuperados. Um teste de transição verifica a hora de vigência, os casos que chegam atrasados e as solicitações iniciadas com uma oferta que depois expira. Dessa forma, a mudança pode entrar no fluxo com uma condição de implantação e uma responsabilidade claros.
Figura 8. Fluxograma de mudança de política. Observe como a vigência determina a necessidade de reavaliação.
Faça a revisão do piloto com a perspectiva da cliente
Eu escolheria o prazo entre solicitação completa e conta utilizável como uma medida da jornada. A operação também precisa de medidas para explicar a diferença entre casos que cumpriram o prazo e casos que ficaram pendentes. Para o piloto, eu acompanharia o volume de elegíveis, o volume de pedidos devolvidos para documentação, o tempo entre oferta e aceite e os casos que aguardam confirmação de abertura. A análise pode separar esses intervalos com eventos e referências definidos no desenho.
Suponha que 160 solicitações completem a documentação e sejam avaliadas segundo a regra do piloto. Destas, 120 entram no grupo elegível. Ao fim do prazo, 96 contas estão disponíveis, 14 ofertas ainda aguardam aceitação e dez casos aguardam confirmação de abertura. A taxa observada de disponibilidade dentro do prazo é 80% se os 120 casos elegíveis compõem o denominador acordado. Eu manteria as outras contagens visíveis para conversar com Produto e Operações sobre a próxima ação. A espera por aceite pode pedir uma mudança na forma de comunicar a oferta. A espera por confirmação pode pedir uma intervenção no processamento ou na conciliação.
Se a diretoria quiser divulgar também uma medida contada a partir do aceite da oferta, eu daria a ela um nome próprio e uma regra de medição. Os dois indicadores respondem a perguntas diferentes e a diferença pode ser importante para a experiência da cliente. Para comparar ciclos, eu registraria a versão de elegibilidade, o período observado e como os casos pendentes foram incluídos. Sem esse contexto, um aumento de velocidade pode refletir uma alteração do grupo acompanhado.
Eu encerraria com a decisão que o comitê precisa tomar diante desses resultados. Aumentar o volume quando a fila de confirmação já demora pode elevar o trabalho de conciliação. Ajustar somente a mensagem da oferta pode reduzir dúvidas e manter a mesma restrição de processamento. Com dados por estado, cada responsável recebe um problema que consegue observar. A arquitetura deixa claras as dependências da próxima entrega, e a operação consegue testar se o efeito chegou à pessoa que pediu a conta.
Para o próximo ciclo, eu guardaria os casos representativos ao lado da decisão de ampliação e das condições que a operação ainda precisa demonstrar.
Eu guardaria também uma medida do custo de investigar cada estado. Um pedido em análise pode ser localizado em minutos se a referência da decisão estiver associada ao caso. Uma confirmação de abertura desconhecida pode exigir consulta ao core e disponibilidade da operação que a executa. Suponha que a fila tenha oito casos desse segundo grupo ao fim de um turno. A equipe precisa saber quais ainda podem cumprir o prazo e quem assume os demais na passagem. Antes de ampliar o piloto, eu ensaiaria essa transferência com os dados que realmente estarão disponíveis. A documentação do domínio ganha valor quando a pessoa responsável consegue usar essas referências com o acesso que já tem.
Pergunte o que cada fronteira consegue esclarecer sem transferir o caso
Em uma revisão do nosso banco hipotético, eu entregaria um protocolo à primeira pessoa de atendimento e pediria uma resposta que ela tenha autorização para comunicar. O domínio de ativação sabe quando a conta ficou utilizável. A jornada sabe qual mensagem já foi enviada. Se cada ocorrência exige passar a conversa inteira para quem opera a outra fronteira, a interface talvez tenha omitido uma consulta que faz parte do trabalho cotidiano. É o tipo de lacuna que eu prefiro descobrir numa simulação curta, antes de pedir que duas equipes sustentem o contrato em produção.
A preparação do texto e a criação das ilustrações tiveram apoio de IA generativa.










Top comments (0)