Exports

Uma exportação começa no catálogo de recursos exportáveis e termina em um arquivo gerado em storage.

Fluxo imediato

Etapa	Ator	Momento	Efeito
Configurar catálogo	BKO ou plataforma	Antes de liberar o recurso	Define recurso, permissão, formatos, colunas, filtros e limites.
Solicitar exportação	Usuário autorizado	Quando precisa baixar dados	Informa recurso, formato, colunas, filtros e escopo.
Validar solicitação	Sistema	Antes de criar job ou agendamento	Confere permissão, escopo, colunas e filtros contra o catálogo.
Criar job	Sistema	Exportação imediata ou execução de agendamento	Cria ExportJob com status inicial.
Processar	Worker	Quando o job entra na fila	Gera arquivo, conta linhas e preenche metadados.
Baixar	Usuário solicitante	Depois de concluído	Recebe URL assinada derivada do `fileKey`.
Expirar ou cancelar	Sistema ou usuário autorizado	Quando arquivo ou solicitação não deve seguir ativa	Bloqueia download ou nova execução.

O recurso precisa existir como ExportResource ativo.
A permissão exigida pelo catálogo precisa estar no escopo do usuário.
As colunas solicitadas precisam ser subconjunto das colunas permitidas.
Os filtros precisam usar campos e operadores permitidos.
Colunas sensíveis exigem tratamento explícito no catálogo.
URL assinada é derivada no momento do download e não deve ser persistida.
ExportScheduled precisa ter scheduledAt futuro.
ExportScheduled executado cria um ExportJob com mesmo escopo, recurso, formato, colunas e filtros.
Jobs e agendamentos cancelados, expirados, concluídos ou removidos logicamente não executam novamente.

Modelo	Status principais
ExportJob	`PENDING`, `QUEUED`, `RUNNING`, `COMPLETED`, `FAILED`, `EXPIRED`, `CANCELED`
ExportScheduled	`SCHEDULED`, `COMPLETED`, `FAILED`, `CANCELED`

Veja a modelagem em ExportJob.