2FinanceDocs
ArquiteturaVisão geral

Como a 2Finance executa automações

Da intenção do usuário à execução observada, sem esconder os estados intermediários.

Fluxo de execução

ClienteSolicita uma automação
APIValida e registra
Operação + OutboxPersiste e emite evento
SchedulerAgenda ocorrências
OcorrênciaTorna a execução elegível
WorkerProcessa a ocorrência
ProviderExecuta no sistema externo

Princípios do sistema

A arquitetura da 2Finance favorece rastreabilidade, retomada segura e estados observáveis em todo o ciclo de uma automação.

Fonte canônica

Definição, versão, deployment, ocorrência e tentativa permanecem separados e auditáveis.

Pelo menos uma vez

Retries mantêm a mesma ocorrência lógica e usam idempotência e reconciliação contra duplicação de efeito.

Estado observado

A intenção só aparece como ativa depois da confirmação do deployment e da versão realmente publicada.

Fonte canônica

A definição da automação e suas versões vivem no plano de controle. A versão é imutável; uma alteração cria outra versão. O provider informa o estado observado, mas não substitui a fonte canônica.

Pelo menos uma vez

O scheduler garante uma ocorrência lógica por vencimento. Falhas de worker ou lease podem criar novas tentativas para essa ocorrência. Por isso, providers precisam respeitar idempotência ou permitir consulta por receipt.

Estado observado

“Ativa” não é apenas intenção. A UI exige deployment confirmado, checksum observado correto e próxima execução calculável. Divergência e indisponibilidade permanecem visíveis.

Próximos passos

Nesta página

Ver OpenAPI