Filas e revisão

Espaços de trabalho do Guida incluem filas persistentes para automação apoiada por navegador. A interface de filas agora tem três papéis distintos:

• Painel Queues — uma superfície leve de abertura e status dentro da janela principal.
• Queue Console — a superfície principal do operador para gerenciamento de filas, controle de processos de trabalho, inspeção de itens, triagem em massa e links para o registro.
• Modo de revisão — um fluxo de revisão humana orientado por visões para itens de fila que precisam de aprovação ou rejeição em guias do navegador.

Painel Queues

O painel Queues é intencionalmente compacto. Use-o para verificar rapidamente uma fila e abrir o console completo quando precisar operar trabalho real.

O painel compacto é uma superfície de status e abertura, não o local principal para limpeza de grandes filas.

Queue Console

O Queue Console é a interface de operador para filas. Ele mostra contagens de fila, itens pendentes e rejeitados, estado dos processos de trabalho, detalhes do conteúdo selecionado e ações como executar uma vez, iniciar processo, parar processo, tentar novamente, mover para a fila de rejeitos, excluir e navegar para o registro.

O Queue Console mantém trabalho executável em fila visível e separado da verdade durável do registro de rastreabilidade.

Use o Queue Console quando precisar:

• Ver todas as filas e suas contagens de itens pendentes e rejeitados.
• Inspecionar conteúdos de itens pendentes sem abrir arquivos brutos de banco.
• Executar um item ou iniciar/parar um processo configurado.
• Tentar novamente itens rejeitados.
• Mover para a fila de rejeitos ou excluir itens pendentes selecionados.
• Fazer triagem em massa de itens ruins de fila.
• Abrir o item do registro vinculado quando o conteúdo da fila contém metadados do registro.

Linhas de fila mostram o melhor rótulo humano disponível a partir de campos do conteúdo como title, linkText, label ou jobTitle, com alternativa para URL ou chave do item. Se conteúdos antigos não têm esses rótulos, o caminho recomendado é limpeza e regeneração a partir de processos corrigidos, não esconder o problema com adivinhação só na interface.

Modo de revisão do Queue Processor

O modo de revisão continua útil quando cada item de fila precisa de julgamento humano. Defina colunas, botões de ação e atalhos de teclado em um arquivo de visão JSON; depois revise itens em uma grade ou em várias guias do navegador.

Crie um arquivo JSON em workspace/views/, como views/review.json:

{
  "defaultQueue": "pending-reviews",
  "onSelect": "scripts/on-select.js",
  "columns": [
    { "field": "title", "header": "Título" },
    { "field": "url", "header": "URL" },
    { "field": "date", "header": "Data", "type": "date", "format": "yyyy-MM-dd" }
  ],
  "actions": [
    { "label": "Aprovar", "key": "A", "color": "#4CAF50", "script": "scripts/approve.js", "effect": "next" },
    { "label": "Rejeitar", "key": "R", "color": "#F44336", "script": "scripts/reject.js", "effect": "remove" },
    { "label": "Pular", "key": "S", "effect": "next" }
  ]
}

Propriedades de coluna

Propriedade	Obrigatória	Descrição
field	Sim	Nome do campo JSON nos dados do item de fila
header	Não	Texto do cabeçalho da coluna, padrão igual ao nome do campo
type	Não	text (padrão), date ou checkbox
format	Não	String de formato de data quando o tipo é date

Propriedades de ação

Propriedade	Obrigatória	Descrição
label	Sim	Texto do botão
key	Não	Atalho de teclado, como A, Enter ou Space
color	Não	Cor do botão como hex ou nome CSS
script	Não	Script executado no clique, relativo à raiz do espaço de trabalho ou ao arquivo de visão
effect	Não	next, remove ou stay

Modo grade

O modo grade é útil para revisão item a item:

1. Selecione uma visão e uma fila.
2. Clique em Start.
3. Selecione um item na grade.
4. Clique em um botão de ação ou pressione seu atalho.
5. O script de ação roda e o efeito configurado avança, remove ou mantém o item.

Scripts de ação recebem contexto por g.worker.getContext():

// @require-context
async function main() {
  const ctx = g.worker.getContext();
  const item = ctx.item;

  g.store.put("approved", item.id, item.data);
  g.log("Aprovado: " + item.data.title);
}

Modo de revisão multi-guia

O modo de revisão pode abrir vários itens de fila em guias do navegador simultaneamente. Quando você age sobre um item, o próximo item carrega na mesma guia.

O modo de revisão quad mantém vários itens de fila visíveis enquanto scripts de ação tratam a decisão selecionada.

Adicione um bloco review à configuração da visão:

{
  "defaultQueue": "pending-reviews",
  "review": {
    "tabs": 4,
    "layout": "quad",
    "viewport": "Full HD",
    "urlField": "url",
    "tabName": "{companyName}: {title}",
    "buttons": [
      { "label": "Aprovar", "color": "#4CAF50", "script": "scripts/approve.js" },
      { "label": "Rejeitar", "color": "#F44336", "script": "scripts/reject.js" }
    ]
  },
  "columns": [
    { "field": "title", "header": "Título" },
    { "field": "companyName", "header": "Empresa" }
  ]
}

Propriedades de revisão

Propriedade	Padrão	Descrição
tabs	4	Número de guias de navegador abertas simultaneamente
layout	"quad"	Arranjo das guias: quad, horizontal ou vertical
viewport	—	Nome de predefinição de área de visualização, como 720p ou Full HD
urlField	"url"	Campo dos dados do item que contém a URL para navegação
tabName	—	Modelo de nome da guia com marcadores {fieldName}
buttons	—	Botões de ação exibidos na barra de ações de cada guia

Vínculo entre fila e registro

Itens de fila são trabalho executável. Itens do registro de rastreabilidade são a verdade durável do fluxo de trabalho. Quando o conteúdo de uma fila inclui um envelope de fluxo de trabalho com IDs de execução e item, o Guida pode vincular o item de fila ao Workflow Ledger Console.

Isso importa para recuperação. Tentar novamente apenas um item do registro não necessariamente cria trabalho executável em fila. Quando metadados de fila suficientes foram registrados, Requeue and Retry pode criar trabalho em fila e mover o item do registro de volta para um estado reivindicável. Se os metadados estiverem ausentes, o Guida deve mostrar uma mensagem clara de recuperação em vez de criar silenciosamente trabalho condenado a falhar.

Quando a pergunta é mais ampla do que uma fila, use o Workflow Control Console. Ele pode agrupar filas relacionadas, grupos de processos de trabalho, estágios do registro, módulos e passagens sob a operação a que pertencem, depois abrir este console na evidência de fila que exige ação.

O pragma @require-context

Scripts que chamam g.worker.getContext() devem usar // @require-context no início. Se o script for executado fora de um contexto de processo de trabalho ou revisão, ele falha imediatamente com erro claro.

// @require-context

async function main() {
  const ctx = g.worker.getContext();
  // ...
}

Visões com escopo de fluxo

Visões podem ter escopo de fluxo de trabalho ao serem colocadas em workflows/my-workflow/views/ em vez da pasta views/ na raiz do espaço de trabalho. Visões com escopo de fluxo aparecem apenas quando esse fluxo está ativo.

Próximos passos

• Processos de trabalho das filas — processe itens em paralelo com guias de navegador concorrentes
• Registro de rastreabilidade dos fluxos de trabalho — inspecione estado durável do fluxo de trabalho e histórico de recuperação
• Fluxos de trabalho — agrupe filas, processos de trabalho, módulos e passagens em operações no nível do operador
• Referência da API — g.queue.* — operações de fila
• Espaços de trabalho — configuração de espaço de trabalho para visões e scripts