Modo bolso

Novo na v2.7.0

O Potato permite anotar por celulares e tablets. Habilite o Modo bolso e os dispositivos de toque que abrirem sua tarefa passam a ser encaminhados automaticamente para uma interface móvel: uma pilha de cartões com botões de rótulo na zona do polegar, navegação por deslize, anotação offline com sincronização automática e instalação na tela inicial como PWA. Quem usa desktop continua vendo a interface normal, sem nenhuma mudança.

Nem todo tipo de anotação cabe em um celular. Destaque de spans e caixas delimitadoras são tarefas de desktop. O Potato é explícito quanto a isso: tarefas compatíveis com toque recebem a interface móvel, as que não são recebem um aviso claro em vez de uma interface degradada, e o painel do administrador mostra quem está anotando a partir de qual tipo de dispositivo nos dois casos.

Configuração

pocket:
  enabled: true        # master switch for the mobile interface (default: false)
  auto_redirect: true  # send phones/tablets to /pocket automatically (default: true)
  batch_size: 25       # items fetched per batch; also the offline queue depth (1-200)

Quais tipos de anotação funcionam bem no celular

Uma tarefa só é compatível com toque se todos os seus esquemas estiverem na coluna da esquerda. Uma tarefa que misture ao menos um esquema exclusivo de desktop não é degradada para o toque: os celulares não são redirecionados e veem um aviso dispensável de que a tarefa não é otimizada para dispositivos móveis.

Se você espera anotadores no celular, projete pensando nisso. Uma tarefa com um único esquema radio é o caso ideal, em que um toque equivale a um item rotulado.

Como funciona o encaminhamento por dispositivo

A detecção acontece em duas camadas.

1. No servidor (User-Agent). Celulares e a maioria dos tablets se identificam e são redirecionados antes que a página de desktop chegue a ser renderizada. Clientes de API e agentes não reconhecidos contam como desktop, então scripts e integrações nunca são redirecionados.
2. No cliente (verificação de ponteiro). Alguns tablets se passam por desktops. O Safari do iPadOS, por exemplo, se declara um Mac. Um script na página de anotação verifica se o ponteiro primário do dispositivo é grosseiro (um dedo) e redireciona esses casos também. Notebooks com tela sensível ao toque não são afetados, porque o ponteiro primário deles é o trackpad.

O encaminhamento vale apenas para anotadores na fase de anotação. Páginas de consentimento, instruções e questionário ficam intactas.

Quem usa desktop pode aderir: em tarefas compatíveis com o modo bolso, a barra de navegação mostra um link Visualização compacta para /pocket, onde a pilha de cartões vira uma visão de rotulagem rápida, de um clique por item. Quem está no celular pode sair pelo link Site para desktop, e a escolha vale para a sessão inteira.

A interface móvel

• Pilha de cartões — um item por cartão. Deslize para a esquerda para avançar, para a direita para voltar, com botões de seta para uso sem toque. Um tique háptico confirma cada gravação nos aparelhos que oferecem suporte a isso.
• Controles na zona do polegar — os botões de rótulo ficam no terço inferior da tela, onde o polegar de fato alcança. Os alvos de toque têm 48px ou mais, as margens de área segura são respeitadas em celulares com entalhe e prefers-reduced-motion é honrado.
• Renderização dos esquemas — tarefas com um único radio ou likert avançam sozinhas ao toque. Cartões com vários esquemas mostram todos os controles mais um Salvar e avançar explícito.
• Anotação offline — o lote atual é pré-carregado e espelhado no localStorage. Se a conexão cair, a anotação continua, um chip mostra "Offline — N saves queued" e a fila é esvaziada automaticamente na reconexão. Um service worker guarda o app shell em cache depois da primeira visita, então a página carrega sem conexão nenhuma. Pré-carregue um lote no wi-fi e anote em qualquer lugar, depois sincronize quando o aparelho voltar à área de cobertura.
• Instalar como aplicativo — a página traz um web manifest, então "Add to Home Screen" entrega um aplicativo autônomo com ícone próprio.

As gravações usam o mesmo endpoint /updateinstance e o mesmo payload da página de desktop. O Modo bolso não acrescenta nenhum caminho de escrita novo, então exportações, estatísticas de concordância, painel do administrador e controle de qualidade enxergam anotações comuns.

A aba Dispositivos

O painel do administrador ganha uma aba Dispositivos que mostra, por anotador: último dispositivo visto, contagem de visitas por classe de dispositivo, quantas vezes a pessoa usou a interface móvel e quando foi vista pela última vez. Uma linha de resumo dá o número principal (“3 de 12 usuários já acessaram de um celular ou tablet”).

Isso importa em duas direções. Se sua tarefa não é compatível com toque e a aba Dispositivos mostra anotadores em celulares mesmo assim, essas pessoas viram o aviso e seguiram em frente, então vale olhar o que produziram. E como as visitas são registradas com o Modo bolso habilitado ou não, a aba responde “habilitar o Modo bolso ajudaria?” antes de você ligá-lo.

Os dados ficam em <output_annotation_dir>/pocket/device_visits.json apenas como agregados por usuário. Não há rastreamento por item.

Solução de problemas

• Um celular não está sendo redirecionado. Verifique se pocket.enabled e pocket.auto_redirect estão como true, se a tarefa é compatível com toque (GET /pocket/api/routing mostra capable: true) e se o usuário não escolheu “Site para desktop” nesta sessão.
• Um iPad recebe a página de desktop no primeiro carregamento. O Safari do iPadOS se identifica como um Mac, então o servidor não tem como pegá-lo. A verificação de ponteiro no cliente o redireciona assim que os scripts da página rodam.
• Um usuário aparece como “concluído” no celular, mas a página de desktop mostra itens restantes. Ele pode ter gravações offline ainda não sincronizadas. O chip de sincronização mostra a fila, que é esvaziada quando o aparelho volta a ficar online.

Leitura adicional

• Atribuição de Tarefas — quem anota pelo celular puxa da mesma fila que todo mundo
• Painel do Administrador — onde fica a aba Dispositivos
• Conduzindo um Estudo no Prolific e no MTurk
• Documentação de origem