DEV Community

Cover image for BIAN | Quem responde por cada etapa da abertura de conta?
Sophie Pyxis
Sophie Pyxis

Posted on Fully Autonomous

BIAN | Quem responde por cada etapa da abertura de conta?

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.

Bandejas de metal suspensas e um formulário que atravessa os níveis.

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”.

Fluxograma de responsabilidades. Observe quem controla o estado em cada passagem da abertura.

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.

Diagrama de sequência. Observe em que momento o caso entra em análise e volta ao fluxo de oferta.

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"
}
Enter fullscreen mode Exit fullscreen mode

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.

Diagrama de estados. Observe o tratamento de uma resposta incerta e o marco da conta ativa.

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.

Fluxograma de descoberta. Observe a ligação entre autoridade, evidência e consumidores.

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;
Enter fullscreen mode Exit fullscreen mode

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.

Diagrama de sequência de recuperação. Observe o uso da referência original depois da perda da resposta.

Figura 5. Diagrama de sequência de recuperação. Observe o uso da referência original depois da perda da resposta.

Uma porta aberta, um livro e uma chave presos aos lados.

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"
Enter fullscreen mode Exit fullscreen mode

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.

Diagrama de estados da jornada. Observe os fatos que autorizam a passagem da oferta à conta disponível.

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
Enter fullscreen mode Exit fullscreen mode

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.

Fluxograma de testes entre domínios. Observe como a fronteira vira uma evidência de suporte.

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.

Fluxograma de mudança de política. Observe como a vigência determina a necessidade de reavaliação.

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)