Jobs e caches

Jobs

A fila mantém histórico e claims em background_jobs. Cada worker adquire jobs por claim condicionado a status/lease, registra worker_id, lease_until e heartbeat_at, ordena prioridade/data, deduplica por chave e persiste tentativas. O agendamento e alguns caches continuam locais ao processo.

stateDiagram-v2
  [*] --> queued
  queued --> running
  queued --> cancelled
  running --> completed
  running --> queued: retry automático
  running --> failed: tentativas esgotadas
  failed --> queued: retry manual
  cancelled --> queued: retry manual

Jobs em execução dependem de timeout/lease; cancelamento cooperativo de processos externos ainda deve ser tratado pelo handler específico.

Caches

Cache	Local	Política/limite	Invalidação
catálogo/capas em memória	backend Map	CACHE_TTL	refresh, login/logout, restore
metadata API	Redis	60 dias positivo/3 negativo por padrão	TTL, refresh e manutenção
capas derivadas	disco + cache_entries	CACHE_MAX_GB, LRU	fingerprint, versão, cleanup
índices de comics	memória do reader service	fingerprint	mudança/reinício
TanStack Query	navegador	stale 60s, gc 15min	mutations/refetch
PWA shell/catalog/capas/assets	Cache Storage	versões e até 100/200/80 entradas	versão do SW
offline books	Cache Storage + IndexedDB	explícito/quota do navegador	remoção do usuário
páginas PDF/comic	memória do reader	atual e vizinhas	navegação/cleanup

Nenhum cache substitui PostgreSQL ou arquivo fonte.