Biblioteca de provas

A biblioteca de provas é o acervo permanente da organização: um catálogo de provas com enunciado, resolução, passo a passo, prints, o arquivo original e tags que vive fora do ciclo das edições. Ela não pontua nada nem aparece para as equipes — é a memória da Comissão, para consultar o que já foi aplicado e reaproveitar ideias na hora de montar a próxima edição.

A prova da biblioteca é uma ficha, não uma prova em jogo. Enquanto a prova de uma edição tem janela, tentativas e placar, a ficha do acervo guarda a memória: como se resolvia, quantas equipes cumpriram, que bônus tinha, de qual edição veio.

O caminho é /organizations → a sua organização → o cartão Biblioteca de provas. Dentro dela, a barra lateral revela cinco seções:

• Acervo — a lista de todas as provas, com busca e filtros.
• Criar prova — o assistente guiado, em seis passos.
• Nova prova — o formulário de cadastro.
• Tags — o gestor do vocabulário de tags da organização.
• Como fazer provas — o guia com as mecânicas, o tempo e a calibragem.

O cadastro acontece em dois tempos, e isso é de propósito: passos e imagens só podem existir depois que a prova tem identidade. Você salva os dados, a prova nasce, e a tela seguinte já traz o editor de passo a passo e a galeria.

1. 1
   Clique em Nova prova e preencha o formulário. Só o Título é obrigatório — todo o resto pode entrar depois.
2. 2
   Clique em Salvar e continuar. A prova é criada e você cai na tela de edição.
3. 3
   Ali embaixo estão o passo a passo, a galeria de imagens e os arquivos, que salvam por conta própria, sem depender do botão do formulário.
4. 4
   Para revisar como a ficha ficou, use Ver a prova — é a mesma tela que você abre clicando num cartão do acervo.

O formulário é dividido em blocos:

• Identificação — Título, Tema, Autor e as tags.
• Conteúdo — Enunciado (o que a equipe leria) e Resolução (o texto corrido da solução). São campos de texto puro, sem formatação: as quebras de linha que você digitar são preservadas na exibição.
• Pontuação e dificuldade — a pontuação sugerida (PC, PG, PU ou PN, o mesmo vocabulário das provas de verdade), a dificuldade editorial e as notas livres de cada uma.
• Cumprimento em campo — quantas equipes cumpriram sobre quantas participaram.
• Origem e uso — se a prova é Nunca usada, Usada ou Cancelada, a edição de origem (ex.: Itajaí Challenge 2017), o código pelo qual ela era chamada (ex.: P3) e o rótulo de etapas.
• Aplicada em — quando a ficha está ligada à prova real de uma edição, ela mostra qual edição, qual prova (com o nome que a edição usou, e a trilha quando havia variante por equipe) e um atalho para abri-la no console. Se o vínculo existir mas a prova tiver sido removida, a ficha diz isso em vez de esconder; se o sistema não conseguir consultar naquele instante, diz que não conseguiu.
• Operação — janela, entrega, bônus e observações: o que a Comissão precisa lembrar se um dia for aplicar essa prova de novo.

Além da resolução corrida, a prova pode ter um passo a passo numerado — a receita da solução, um passo por vez, cada um com a possibilidade de carregar um print.

1. 1
   Na tela de edição, use Adicionar passo e escreva o texto de cada um.
2. 2
   Reordene com as setas ↑ ↓ e remova com a lixeira. Nada disso vale antes de salvar.
3. 3
   Clique em Salvar passos. Só depois de salvo é que cada passo ganha o slot para receber um print.

A galeria aceita três tipos de imagem: Enunciado, Resolução e Passo. As duas primeiras aparecem nas seções correspondentes da ficha; a de passo aparece embaixo do texto daquele passo específico.

• Escolha o tipo das próximas imagens, depois selecione vários arquivos de uma vez — ou simplesmente cole um print com Ctrl+V em qualquer lugar da página.
• As imagens entram numa fila com pré-visualização; você confere, ajusta o tipo e envia. O envio é um a um, com o estado de cada item à vista.
• Formatos aceitos: JPEG, PNG, WebP e GIF. Qualquer outro arquivo é recusado.
• Cada imagem pode ter uma legenda, e a ordem dentro de cada tipo se ajusta pelas setas.

Além dos prints, a ficha guarda o arquivo — o .docx ou .pdf de onde saíram enunciado, resolução e imagens. É o que salva a prova de envelhecer: daqui a três anos o texto recortado pode não bastar, mas o documento de origem reabre inteiro, com formatação, tabelas e anexos.

Na tela de edição, o bloco Arquivos fica logo abaixo da galeria. Escolha um ou vários arquivos, ajuste o papel de cada um e envie — o envio é sequencial, com o estado de cada item à vista, igual ao das imagens.

• Arquivo original — o documento de onde a prova veio. Cada prova tem no máximo um.
• Complementar — todo o resto: gabarito, planilha de correção, material de apoio. Quantos você quiser.
• Cada arquivo aceita uma legenda e mostra tipo e tamanho na lista.

Formatos aceitos: PDF, Word (.doc, .docx), PowerPoint (.ppt, .pptx), Excel (.xlsx), OpenDocument (.odt), texto (.txt, .md) e ZIP — até 25 MB por arquivo (o limite é configurável pelo administrador do sistema, e a tela sempre mostra o valor em vigor). Qualquer outro formato é recusado antes de o envio começar.

Na ficha da prova, os arquivos aparecem na seção Arquivos, com o original em destaque e um botão Baixar por linha.

As tags são o vocabulário da organização — o que dá liga ao acervo. Cada tag pode pertencer a uma família, que é só um agrupamento de texto livre (Criptografia, Lógica, Campo…). A família serve para as telas listarem as tags em blocos em vez de uma sopa alfabética.

• No formulário da prova, o campo de tags busca no vocabulário existente e, se nada casar, oferece criar a tag na hora — sem sair do cadastro.
• Tag criada assim nasce sem família e cai no grupo Sem família, que fica sempre por último nas listas. Dar família a ela é trabalho do gestor de tags.
• Cada tag tem um identificador derivado do nome (minúsculas, sem acento, com hífens). É por ele que o sistema evita tags duplicadas na mesma organização — Cifra de César e cifra de cesar são a mesma tag.
• Na ficha da prova, clicar numa tag abre o acervo já filtrado por ela.

A biblioteca mede dificuldade por duas réguas independentes, e é importante não confundir uma com a outra.

• Dificuldade editorial — o julgamento de quem catalogou: Fácil, Média, Difícil, Brutal ou Não avaliada. É opinião, e você a escolhe à mão.
• Cumprimento em campo — o fato histórico: quantas equipes cumpriram a prova sobre quantas participaram. Você registra a fração (ex.: 2/6) e o sistema calcula a faixa sozinho.

O acervo carrega inteiro e filtra na hora, sem recarregar a página. A busca por texto varre título, tema, código de origem, edição e nomes de tags, e ignora acentos: digitar cifra de cesar acha Cifra de César. Vários termos separados por espaço reduzem juntos — todos precisam casar.

Além da busca, seis filtros combinam livremente:

• Dificuldade — a régua editorial.
• Cumprimento — a faixa calculada.
• Uso — nunca usada, usada ou cancelada. É o filtro para achar material inédito.
• Pontuação sugerida — PC, PG, PU ou PN.
• Edição de origem — as edições que aparecem no acervo, montadas a partir das próprias fichas.
• Tags — clique nos chips para escolher quantas quiser. O par Qualquer uma / Todas decide se a prova precisa ter ao menos uma das tags marcadas ou todas elas.

No celular, os filtros ficam num painel que sobe pela base da tela pelo botão Filtros — com o número de filtros ativos no próprio botão e o total de resultados no rodapé do painel.

A tela Tags lista o vocabulário inteiro agrupado por família, com o número de provas de cada tag ao lado. É onde o vocabulário é curado — principalmente depois de uma importação, quando muita tag entra crua e sem família.

• Nova tag cria uma entrada direto no vocabulário, com nome e família.
• Renomear ou definir família ajusta uma tag existente. Renomear regenera o identificador da tag; as provas ligadas a ela continuam ligadas.
• Mesclar em outra tag é a ferramenta principal — a seguir.
• Excluir só funciona com zero provas. Tag em uso não é excluída; o caminho é mesclar.