Pular para o conteúdo principal

Bingo Pedagógico com Next.js

Bingo Pedagógico com Next.js

De onde veio o bingo

O pedido veio da psicóloga clínica Tathiane Galvão (CRP 01/27841): um bingo visual para usar na estimulação cognitiva de idosos durante sessões terapêuticas. A ideia é a do bingo tradicional, com imagens no lugar dos números. Tudo funciona no navegador, sem cadastro ou backend para processar as partidas.

Gerar cartelas, sortear imagens e imprimir eram as tarefas principais. Para entender como isso deveria funcionar, também era preciso considerar quem usaria o bingo e onde:

  • Os participantes podem ter limitações visuais ou motoras
  • Os profissionais que conduzem a atividade nem sempre têm familiaridade com tecnologia
  • Ambientes de aplicação (clínicas, centros de convivência) podem ter conectividade limitada

O trabalho que o aplicativo precisava resolver

Antes do aplicativo, o trabalho era manual: recortar imagens, colar em cartolina e fazer o sorteio físico. Funcionava, mas levava tempo. Para trocar o tema, por exemplo usando fotos familiares do paciente, era preciso refazer todo o material.

O aplicativo precisava permitir quatro coisas:

  1. Gerar automaticamente cartelas com imagens únicas
  2. Sortear imagens com legendas para exibir ao grupo
  3. Imprimir as cartelas em A4
  4. Criar temas personalizados com upload de imagens

Os dados ficam no navegador

O processamento acontece no navegador, sem autenticação ou banco de dados no servidor.

Nesse contexto, o profissional precisa abrir o bingo e começar a atividade. Um cadastro acrescentaria uma etapa, e depender da conexão durante a partida poderia interromper a sessão.

As cartelas geradas e o progresso do sorteio ficam no localStorage. Já as imagens personalizadas ficam no IndexedDB, em base64. O localStorage tem um limite de cerca de 5 MiB por origem; o IndexedDB permite armazenar volumes maiores, mas também está sujeito à cota definida pelo navegador. Depois do carregamento inicial, o bingo funciona offline.

Persistência com localStorage

Para salvar e recuperar as cartelas, o código usa localStorage:

export function saveGeneratedCards(key: string, cards: BingoCard[]) {
  localStorage.setItem(key, JSON.stringify(cards));
}

export function getGeneratedCards(key: string): BingoCard[] {
  const data = localStorage.getItem(key);
  return data ? JSON.parse(data) : [];
}

Persistência com IndexedDB

Os bingos com imagens personalizadas são salvos no IndexedDB:

const db = await openDB('bingo-store', 1, {
  upgrade(db) {
    db.createObjectStore('custom-bingos');
  },
});

await db.put('custom-bingos', bingoData, bingoId);
const bingo = await db.get('custom-bingos', bingoId);

Como os dados ficam no navegador, o aplicativo também permite exportar e importar os bingos personalizados em arquivos JSON. Assim, é possível levar um bingo para outro dispositivo ou compartilhar o arquivo com educadores e outros profissionais.

Imagens prontas ou um tema próprio

Modo padrão

O modo padrão vem com 16 imagens, divididas em quatro categorias: emoções, autocuidado, socialização e geral. Ao montar as cartelas 3×3, o algoritmo distribui as imagens de cada categoria proporcionalmente. Isso dá variedade às cartelas sem depender apenas de uma seleção aleatória.

Modo personalizado

Neste modo, o profissional pode enviar imagens próprias em PNG, JPG ou WebP, com limite de 5 MB por arquivo. O aplicativo converte as imagens para base64 e as guarda no IndexedDB. A versão inicial usava localStorage, e as imagens ultrapassavam facilmente o espaço disponível. A mudança para IndexedDB deu mais espaço, mantendo o armazenamento local.

São necessárias pelo menos 9 imagens para preencher a cartela 3×3. A recomendação é usar 16 para ter mais variedade. Depois de criar um bingo, dá para mudar o nome ou adicionar imagens sem refazer tudo.

Como evitar cartelas repetidas

Escolher as imagens aleatoriamente pode produzir cartelas idênticas. Com 16 imagens e 9 espaços por cartela, existem C(16,9) = 11.440 combinações possíveis. Ainda assim, é preciso conferir se uma combinação já foi usada.

O aplicativo calcula quantas cartelas únicas o conjunto de imagens permite e compara cada nova cartela com as que já existem. Este trecho faz o cálculo do limite:

function combination(n: number, k: number): number {
  if (k > n || k < 0) return 0;
  if (k === 0 || k === n) return 1;
  if (k > n - k) k = n - k;
  let result = 1;
  for (let i = 0; i < k; i++) {
    result = (result * (n - i)) / (i + 1);
  }
  return Math.floor(result);
}

export function getMaxUniqueCards(availableImages: BingoImage[]): number {
  return combination(availableImages.length, CARD_SIZE);
}

A interface mostra esse limite conforme a quantidade de imagens:

  • 9 imagens: 1 cartela única
  • 10 imagens: 10 cartelas únicas
  • 16 imagens: 11.440 cartelas únicas

Também dá para adicionar cartelas a um conjunto sem invalidar as que já foram impressas. As cartelas podem ser exportadas e importadas para usar em outras sessões.

O sorteio na TV ou no projetor

O sorteio foi pensado para exibição em um projetor ou TV. A imagem sorteada ocupa a tela inteira para que o grupo consiga vê-la. Um toque ou clique em qualquer área volta ao painel de controle.

Os IDs das imagens já sorteadas ficam no localStorage. Isso permite retomar a partida se alguém recarregar a página ou fechar o navegador por acidente:

const { currentImage, drawnImages, remainingCount, canDraw, draw, reset } =
  useLottery(images, "bingo-standard-lottery");

Perguntas para quem conduz a atividade

Um painel lateral sugere perguntas para o profissional usar durante a atividade. Esse recurso foi solicitado porque nem todos os mediadores têm experiência com dinâmicas de estimulação cognitiva.

As cartelas continuam no papel

A impressão faz parte do uso do bingo. As cartelas continuam físicas para que os participantes possam manuseá-las e jogar no formato tradicional que já conhecem.

Na impressão, o layout usa:

  • Bordas pontilhadas que indicam onde recortar
  • Cantos retos para facilitar o corte com tesoura
  • Elementos de navegação ocultos
  • Formatação A4 padrão
@media print {
  @page {
    size: A4;
    margin: 1cm;
  }
}

Na tela, as cartelas têm sombras e bordas arredondadas. No papel, o estilo fica mais simples, com bordas tracejadas. A propriedade printMode do componente alterna entre essas duas versões.

Tecnologias usadas

Next.js 16, React 19, Tailwind CSS v4, Vitest, Cypress, Biome, lucide-react, shadcn/ui.

Acesso

O bingo está disponível em bingo.rafikmoreira.dev.br, com acesso gratuito e sem restrições.

Voltar