Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt

Use this file to discover all available pages before exploring further.

O Flowker é a plataforma de orquestração de workflows financeiros da Lerian. Ele automatiza os passos que acontecem antes, durante e após uma transação — verificações antifraude, aprovações manuais, roteamento de pagamentos, onboarding de clientes, e muito mais. Em vez de construir lógica personalizada para cada fluxo de aprovação ou etapa de validação, você define os workflows uma vez e o Flowker os executa de forma consistente, com rastreabilidade completa e visibilidade em tempo real.

Por que usar o Flowker?


Operações financeiras envolvem múltiplos passos, aprovações e verificações externas. Gerenciá-las manualmente gera erros, atrasos e falhas de conformidade. O Flowker centraliza essa orquestração para que cada passo fique registrado, auditável e repetível. Para o caso de negócio completo, veja Por que o Flowker?.

Conceitos fundamentais


Em seu núcleo, o Flowker trabalha com dois conceitos:
  • Workflows: O processo geral — uma sequência de passos que definem o que acontece para uma operação específica (ex: “processar um pagamento Pix” ou “onboarding de um novo cliente”). Workflows podem se ramificar e se recuperar de falhas automaticamente.
  • Tasks: Os passos individuais dentro de um workflow — como verificar um score de fraude, aguardar a aprovação de um gerente, chamar um serviço externo ou fazer um lançamento no ledger.
Na API do Flowker, tasks são representadas como nodes. Ambos os termos referem-se ao mesmo conceito e são usados de forma intercambiável nesta documentação. O resultado de cada tarefa determina o próximo passo, permitindo que seus fluxos se adaptem dinamicamente e permaneçam confiáveis.

O que torna o Flowker diferente?


Construído especificamente para o domínio financeiro

Diferente de ferramentas genéricas de workflow, o Flowker é modelado especificamente para o ecossistema transacional. Sua arquitetura reflete as realidades operacionais e regulatórias de bancos, pagamentos, Pix e orquestração financeira.

Validação pré-ledger

O Flowker aplica todas as validações antes de qualquer lançamento chegar ao ledger. Isso previne estados inconsistentes, erros operacionais e violações de compliance — garantindo que apenas transações válidas, autorizadas e bem formadas sejam registradas.

Contextos delimitados por design

A plataforma é estruturada em torno de contextos delimitados claros, separando responsabilidades como onboarding, pagamentos, liquidação, risco e conciliação. Essa segmentação melhora a escalabilidade, governança e clareza de domínio em operações financeiras complexas.

Integrações com APIs, Webhooks, SDKs e Conectores pré-construídos

O Flowker se conecta perfeitamente com qualquer sistema externo — cores bancários, engines de fraude, PSPs, ERPs ou APIs de terceiros. Desde que as expectativas de entrada/saída estejam definidas, o Flowker pode orquestrar, transformar, enriquecer e rotear dados em todo o seu ecossistema.

Trilhas de auditoria completas

Cada passo dentro de um workflow gera logs de auditoria detalhados que podem ser consultados, revisados e exportados. Isso proporciona rastreabilidade e visibilidade em nível de compliance em todo o ciclo de vida da orquestração.

Observabilidade de ponta a ponta

Suporte nativo para tracing distribuído, métricas e logging estruturado, permitindo monitoramento em tempo real de workflows e interações externas.

Segurança de nível enterprise

Autenticação por API Key para todos os endpoints. Canais de dados criptografados via HTTPS.

Experiência developer-first

O Flowker inclui definições OpenAPI, templates reutilizáveis e um ambiente de desenvolvimento local com Docker — permitindo que equipes construam, testem e implantem fluxos com confiança e velocidade.

Principais funcionalidades


Orquestração de workflows

  • Execute tarefas sequencialmente.
  • Aplique lógica condicional baseada em códigos de status HTTP e campos de resposta.
  • Persista o estado do workflow para auditoria e recuperação.
  • Gerencie versões com controle completo de ciclo de vida, incluindo rascunho, ativação, desativação e iteração baseada em clonagem.

Integração e conectividade

  • Envie requisições HTTP (POST, GET, PUT).
  • Receba e processe webhooks de sistemas externos.
  • Conecte-se a múltiplos provedores de serviços financeiros.

Motor DSL

  • Defina workflows com uma .
  • Valide definições de workflow antes da implantação.
  • Transforme dados entre etapas e reutilize templates para configuração mais rápida.
  • Templates de workflow reutilizáveis para configuração mais rápida e consistência entre ambientes.

Autenticação e segurança

  • Autenticação por API Key (header X-API-Key) para todos os endpoints.
  • Trilha de auditoria completa com logs estruturados e criptografia em repouso.

Observabilidade

O Flowker inclui observabilidade integrada alimentada por OpenTelemetry, Jaeger, Prometheus e Grafana. Você pode rastrear cada execução de workflow, monitorar métricas e revisar logs detalhados para debugging e compliance.

Casos de uso comuns


Operações antifraude

  • Envie dados de transação e conta para serviços externos de prevenção a fraudes.
  • Colete e processe respostas de múltiplos provedores, e aplique regras configuráveis para decidir se deve prosseguir.
  • Cada etapa é registrada e armazenada para auditoria.

Aprovações manuais

  • Pause um workflow até que uma pessoa valide a operação.
  • Você pode suportar múltiplos níveis de aprovação, enviar notificações e integrar com sistemas de aprovação.
  • Uma vez aprovado ou rejeitado, o workflow continua ou para automaticamente.

Orquestração de pagamentos

  • Coordene fluxos de pagamento multi-etapas que abrangem múltiplos provedores ou trilhos.
  • O Flowker lida com retentativas, conciliação com seu ledger e recuperação automática de falhas.

Onboarding de clientes

  • Automatize processos de KYC e AML, integre com bureaus de crédito e serviços de validação, e configure regras de onboarding condicionais baseadas em perfis de risco.

Arquitetura da API


A API do Flowker é dividida em três categorias principais: Autoria, Runtime e Administrativa. Cada categoria tem um propósito claro para ajudar desenvolvedores a construir, executar e gerenciar workflows.
  • Rotas de autoria: criar, atualizar e gerenciar definições de workflow, versões e templates.
  • Rotas de runtime: iniciar, monitorar e controlar execuções de workflow em tempo real.
  • Rotas administrativas: gerenciar tenants, API keys, provedores e saúde do sistema.

Status atual


O Flowker está em desenvolvimento ativo. Para informações adicionais sobre integrações específicas ou detalhes de implementação, entre em contato.