Skip to content

Web Workers — Cálculos Fora da Thread Principal ​

Cálculos previdenciários são computacionalmente intensivos (varredura de histórico, apuração de grupos, concomitâncias). Para manter a UI responsiva, todas as calculadoras executam a lógica de domínio em Web Workers separados da thread principal.

Infraestrutura: criarWorkerScope ​

criarWorkerScope(ctx, opcoesLogger, trabalho) recebe o contexto do worker, a configuração do logger (fixa ou derivada da mensagem) e a função de trabalho. Ela instala os handlers e responde com um envelope tipado: sucesso, erro ou progresso. O retorno do motor está em dados, não na raiz da mensagem.

O caminho usado em prev-tc é:

  1. a interface monta dados serializáveis e as tabelas necessárias;
  2. o worker instala as tabelas e reconstrói as entidades;
  3. o pacote RGPS executa a análise;
  4. o worker devolve o resultado para a interface.

Trecho representativo de apps/prev-tc/app/composables/workers/calculoTempo.ts:

ts
import type { MensagemWorker } from '@fc/utils/etc/worker/tipos'
import type { DadosInputWeb } from '../tipos'
import { AnaliseBeneficiosRgps } from '@fc/calculos-rgps/analise-beneficios/AnaliseBeneficiosRgps'
import { instalarTabelasCalculo } from '@fc/indices/instalarTabelasCalculo'
import { criarWorkerScope } from '@fc/utils/etc/worker/criarWorkerScope'
import { desserializar } from './desserializar'

// eslint-disable-next-line no-restricted-globals
const ctx = self as DedicatedWorkerGlobalScope

criarWorkerScope(ctx, mensagem => mensagem.loggerOptions, (mensagem: MensagemWorker<DadosInputWeb>) => {
  instalarTabelasCalculo(mensagem.dados)
  const dadosCalculo = desserializar(mensagem.dados)
  return new AnaliseBeneficiosRgps(dadosCalculo).apurarGrupos(true)
})

Uma mensagem atravessa uma fronteira de serialização: não envie uma instância de entidade supondo que seus métodos e protótipos estarão disponíveis do outro lado. Use os adaptadores de entrada do domínio.

Estrutura de referência ​

text
apps/prev-tc/app/composables/
├── workers/
│   ├── calculoTempo.ts
│   ├── calculoRmi.ts
│   └── desserializar.ts
├── useCalculoTempo.ts
└── useCalculoRmi.ts

Os composables consumidores coordenam execução, progresso, erro, cancelamento e invalidação do resultado quando as entradas mudam. Reutilize essa infraestrutura em vez de tratar toda mensagem recebida como sucesso.

Iteração de RMI ​

CalculoRmi.calcular é um gerador síncrono de etapas de descarte. Rodar esse percurso em um Web Worker torna o trabalho independente da thread da interface; não transforma o contrato do motor em gerador assíncrono. Nas APIs, a entrega por job ou streaming também pertence ao consumidor.

Testes ​

Confira separadamente o motor, o adaptador que reconstrói suas entradas e o consumidor das mensagens. Os testes de worker precisam preparar o ambiente e o suporte de Web Worker usados pela aplicação; apenas selecionar happy-dom não instala essa comunicação.

Use apps/prev-tc/test/nuxt/ e a configuração Vitest da aplicação como referência para exercitar o percurso real. Inclua erro e cancelamento quando alterar a orquestração.